REST Resource: outages

  • An Outage resource defines an outage event with details such as name, type, start and end times, and a descriptive message.

  • OutageType categorizes outages into specific types like inaccessible UI, query service down, or data transfer issues.

  • Outages can be retrieved using the list method, which returns outages within a 130-day window, sorted by start time in descending order.

  • Outage details are represented in JSON format including fields like name, type, startTime, endTime, and details.

Resource: Outage

Defines an outage and its information.

JSON representation 
{
  "name": string,
  "type": enum (OutageType),
  "startTime": string,
  "endTime": string,
  "details": string
}
Fields
name

string

Name that uniquely identifies an outage. It has the form outages/[outage_id], e.g. 'outages/1234'.
type

enum (OutageType)

The type of this outage.
startTime

string (Timestamp format)

The absolute point in time when the outage started.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

The absolute point in time when the outage ended or will end. If empty or in the future, then it means the outage is still on going.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
details

string

Message describing this outage.

OutageType

Defines the outage type.

Enums
OUTAGE_TYPE_UNSPECIFIED The outage type is not specified.
OUTAGE_TYPE_INACCESSIBLE_UI Certain Ads Data Hub UI is not accessible.
OUTAGE_TYPE_QUERY_SERVICE_DOWN Ads Data Hub query related service is down.
OUTAGE_TYPE_OUT_OF_SLA_DT Ads Data Hub data-transfer is out of service layer agreement (SLA).
OUTAGE_TYPE_FIELD_NOT_POPULATING Certain fields are not populating in Ads Data Hub.
OUTAGE_TYPE_ACCOUNT_LINKING_DOWN Ads Data Hub account linking related service is down.
OUTAGE_TYPE_OUT_OF_SLA_NON_DT Ads Data Hub non-data-transfer is out of service layer agreement (SLA).

Methods

list

 Lists the outages in descending order of outage start timestamp, and the look back window is 130 days.