{ "batchPath": "batch", "documentationLink": "https://cloud.google.com/service-health/", "discoveryVersion": "v1", "fullyEncodeReservedExpansion": true, "baseUrl": "https://servicehealth.googleapis.com/", "servicePath": "", "canonicalName": "Personalized Service Health", "version_module": true, "ownerName": "Google", "version": "v1", "id": "servicehealth:v1", "kind": "discovery#restDescription", "schemas": { "ListOrganizationImpactsResponse": { "type": "object", "id": "ListOrganizationImpactsResponse", "description": "Response to request for listing projects under an organization affected by an event.", "properties": { "organizationImpacts": { "readOnly": true, "description": "Output only. List of [impacts](/service-health/docs/reference/rest/v1beta/organizations.locations.organizationImpacts#OrganizationImpact) for an organization affected by service health events.", "type": "array", "items": { "$ref": "OrganizationImpact" } }, "unreachable": { "description": "Output only. Locations that could not be reached.", "type": "array", "items": { "type": "string" }, "readOnly": true }, "nextPageToken": { "readOnly": true, "description": "Output only. The continuation token, used to page through large result sets. Provide this value in a subsequent request as `page_token` to retrieve the next page. If this field is not present, there are no subsequent results.", "type": "string" } } }, "ListOrganizationEventsResponse": { "properties": { "nextPageToken": { "readOnly": true, "type": "string", "description": "Output only. The continuation token, used to page through large result sets. Provide this value in a subsequent request as `page_token` to retrieve the next page. If this field is not present, there are no subsequent results." }, "unreachable": { "type": "array", "items": { "type": "string" }, "description": "Output only. Locations that could not be reached.", "readOnly": true }, "organizationEvents": { "readOnly": true, "description": "Output only. List of organization events affecting an organization.", "type": "array", "items": { "$ref": "OrganizationEvent" } } }, "type": "object", "id": "ListOrganizationEventsResponse", "description": "Response to request for listing organization events." }, "Asset": { "type": "object", "id": "Asset", "description": "Represents the asset impacted by the events.", "properties": { "assetName": { "type": "string", "description": "Output only. Full name of the resource as defined in [Resource Names](https://cloud.google.com/apis/design/resource_names#full_resource_name).", "readOnly": true }, "assetType": { "type": "string", "description": "Output only. Type of the asset. Example: `\"cloudresourcemanager.googleapis.com/Project\"`", "readOnly": true } } }, "EventImpact": { "type": "object", "id": "EventImpact", "description": "Represents the Google Cloud products and locations impacted by the event.", "properties": { "product": { "description": "Google Cloud product impacted by the event.", "$ref": "Product" }, "location": { "description": "Location impacted by the event.", "$ref": "Location" } } }, "ListEventsResponse": { "type": "object", "id": "ListEventsResponse", "description": "Response to request for listing events.", "properties": { "events": { "type": "array", "items": { "$ref": "Event" }, "description": "Output only. List of events.", "readOnly": true }, "nextPageToken": { "readOnly": true, "type": "string", "description": "Output only. The continuation token, used to page through large result sets. Provide this value in a subsequent request as page_token to retrieve the next page. If this field is not present, there are no subsequent results." }, "unreachable": { "description": "Output only. Locations that could not be reached.", "type": "array", "items": { "type": "string" }, "readOnly": true } } }, "Event": { "properties": { "category": { "type": "string", "readOnly": true, "enumDescriptions": [ "Unspecified category.", "Event category for service outage or degradation." ], "enum": [ "EVENT_CATEGORY_UNSPECIFIED", "INCIDENT" ], "description": "Output only. The category of the event." }, "endTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The end time of the event, if applicable.", "type": "string" }, "eventImpacts": { "description": "Google Cloud products and locations impacted by the event.", "type": "array", "items": { "$ref": "EventImpact" } }, "startTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The start time of the event, if applicable.", "type": "string" }, "updates": { "type": "array", "items": { "$ref": "EventUpdate" }, "description": "Output only. Event updates are correspondence from Google.", "readOnly": true }, "name": { "description": "Output only. Identifier. Name of the event. Unique name of the event in this scope including project and location using the form `projects/{project_id}/locations/{location}/events/{event_id}`.", "type": "string", "readOnly": true }, "description": { "type": "string", "description": "Output only. Free-form, human-readable description.", "readOnly": true }, "state": { "description": "Output only. The current state of the event.", "readOnly": true, "enumDescriptions": [ "Unspecified state.", "Event is actively affecting a Google Cloud product and will continue to receive updates.", "Event is no longer affecting the Google Cloud product or has been merged with another event." ], "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CLOSED" ], "type": "string" }, "nextUpdateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The time when the next update can be expected." }, "detailedCategory": { "type": "string", "readOnly": true, "enumDescriptions": [ "Unspecified detailed category.", "Indicates an event with category INCIDENT has a confirmed impact to at least one Google Cloud product.", "Indicates an event with category INCIDENT is under investigation to determine if it has a confirmed impact on any Google Cloud products." ], "enum": [ "DETAILED_CATEGORY_UNSPECIFIED", "CONFIRMED_INCIDENT", "EMERGING_INCIDENT" ], "description": "Output only. The detailed category of the event." }, "relevance": { "description": "Output only. Communicates why a given event is deemed relevant in the context of a given project.", "readOnly": true, "enumDescriptions": [ "Unspecified relevance.", "The relevance of the incident to the project is unknown.", "The incident does not impact the project.", "The incident is associated with a Google Cloud product your project uses, but the incident may not be impacting your project. For example, the incident may be impacting a Google Cloud product that your project uses, but in a location that your project does not use.", "The incident has a direct connection with your project and impacts a Google Cloud product in a location your project uses.", "The incident is verified to be impacting your project." ], "enum": [ "RELEVANCE_UNSPECIFIED", "UNKNOWN", "NOT_IMPACTED", "PARTIALLY_RELATED", "RELATED", "IMPACTED" ], "type": "string" }, "parentEvent": { "readOnly": true, "description": "Output only. When `detailed_state`=`MERGED`, `parent_event` contains the name of the parent event. All further updates will be published to the parent event.", "type": "string" }, "title": { "description": "Output only. Brief description for the event.", "type": "string", "readOnly": true }, "detailedState": { "type": "string", "description": "Output only. The current detailed state of the incident.", "readOnly": true, "enumDescriptions": [ "Unspecified detail state.", "Google engineers are actively investigating the event to determine the impact.", "The incident is confirmed and impacting at least one Google Cloud product. Ongoing status updates will be provided until it is resolved.", "The incident is no longer affecting any Google Cloud product, and there will be no further updates.", "The incident was merged into a parent incident. All further updates will be published to the parent only. The `parent_event` field contains the name of the parent.", "The incident was automatically closed because of the following reasons: * The impact of the incident could not be confirmed. * The incident was intermittent or resolved itself. The incident does not have a resolution because no action or investigation happened. If it is intermittent, the incident may reopen.", "Upon investigation, Google engineers concluded that the incident is not affecting a Google Cloud product. This state can change if the incident is reviewed again." ], "enum": [ "DETAILED_STATE_UNSPECIFIED", "EMERGING", "CONFIRMED", "RESOLVED", "MERGED", "AUTO_CLOSED", "FALSE_POSITIVE" ] }, "updateTime": { "description": "Output only. The time when the event was last modified.", "type": "string", "readOnly": true, "format": "google-datetime" } }, "type": "object", "id": "Event", "description": "Represents service health events that may affect Google Cloud products. Event resource is a read-only view and does not allow any modifications. All fields are output only." }, "ListLocationsResponse": { "properties": { "locations": { "description": "A list of locations that matches the specified filter in the request.", "type": "array", "items": { "$ref": "GoogleCloudLocationLocation" } }, "nextPageToken": { "description": "The standard List next-page token.", "type": "string" } }, "type": "object", "id": "ListLocationsResponse", "description": "The response message for Locations.ListLocations." }, "Product": { "properties": { "productName": { "type": "string", "description": "Google Cloud product impacted by the event. Example: `\"Google Cloud SQL\"`" }, "id": { "description": "Unique identifier for the product.", "type": "string" } }, "id": "Product", "description": "Represents the Google Cloud product impacted by the event.", "type": "object" }, "OrganizationEvent": { "id": "OrganizationEvent", "description": "Represents service health events that may affect Google Cloud products used across the organization. It is a read-only view and does not allow any modifications.", "type": "object", "properties": { "eventImpacts": { "readOnly": true, "description": "Output only. Represents the Google Cloud products and locations impacted by the event.", "type": "array", "items": { "$ref": "EventImpact" } }, "startTime": { "description": "Output only. The start time of the event, if applicable.", "type": "string", "readOnly": true, "format": "google-datetime" }, "category": { "type": "string", "readOnly": true, "enumDescriptions": [ "Unspecified category.", "Event category for service outage or degradation." ], "enum": [ "EVENT_CATEGORY_UNSPECIFIED", "INCIDENT" ], "description": "Output only. The category of the event." }, "endTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The end time of the event, if applicable.", "type": "string" }, "parentEvent": { "description": "Output only. When `detailed_state`=`MERGED`, `parent_event` contains the name of the parent event. All further updates will be published to the parent event.", "type": "string", "readOnly": true }, "detailedState": { "description": "Output only. The current detailed state of the incident.", "readOnly": true, "enumDescriptions": [ "Unspecified detail state.", "Google engineers are actively investigating the incident to determine the impact.", "The incident is confirmed and impacting at least one Google Cloud product. Ongoing status updates will be provided until it is resolved.", "The incident is no longer affecting any Google Cloud product, and there will be no further updates.", "The incident was merged into a parent event. All further updates will be published to the parent only. The `parent_event` contains the name of the parent.", "The incident was automatically closed because of the following reasons: * The impact of the incident could not be confirmed. * The incident was intermittent or resolved itself. The incident does not have a resolution because no action or investigation happened. If it is intermittent, the incident may reopen.", "Upon investigation, Google engineers concluded that the incident is not affecting a Google Cloud product. This state can change if the incident is reviewed again." ], "enum": [ "DETAILED_STATE_UNSPECIFIED", "EMERGING", "CONFIRMED", "RESOLVED", "MERGED", "AUTO_CLOSED", "FALSE_POSITIVE" ], "type": "string" }, "updateTime": { "description": "Output only. The time the update was posted.", "type": "string", "readOnly": true, "format": "google-datetime" }, "title": { "readOnly": true, "type": "string", "description": "Output only. Brief description for the event." }, "description": { "readOnly": true, "description": "Output only. Free-form, human-readable description.", "type": "string" }, "state": { "readOnly": true, "enumDescriptions": [ "Unspecified state.", "Event is actively affecting a Google Cloud product and will continue to receive updates.", "Event is no longer affecting the Google Cloud product or has been merged with another event." ], "enum": [ "STATE_UNSPECIFIED", "ACTIVE", "CLOSED" ], "description": "Output only. The current state of the event.", "type": "string" }, "updates": { "description": "Output only. Incident-only field. Event updates are correspondence from Google.", "type": "array", "items": { "$ref": "EventUpdate" }, "readOnly": true }, "name": { "type": "string", "description": "Output only. Identifier. Name of the event. Unique name of the event in this scope including organization ID and location using the form `organizations/{organization_id}/locations/{location}/organizationEvents/{event_id}`. `organization_id` - see [Getting your organization resource ID](https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id). `location` - The location of the organization event. `event_id` - Organization event ID to retrieve.", "readOnly": true }, "nextUpdateTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. Incident-only field. The time when the next update can be expected.", "type": "string" }, "detailedCategory": { "type": "string", "description": "Output only. The detailed category of the event.", "readOnly": true, "enumDescriptions": [ "Unspecified detailed category.", "Indicates an event with category INCIDENT has a confirmed impact to at least one Google Cloud product.", "Indicates an event with category INCIDENT is under investigation to determine if it has a confirmed impact on any Google Cloud products." ], "enum": [ "DETAILED_CATEGORY_UNSPECIFIED", "CONFIRMED_INCIDENT", "EMERGING_INCIDENT" ] } } }, "GoogleCloudLocationLocation": { "properties": { "displayName": { "type": "string", "description": "The friendly name for this location, typically a nearby city name. For example, \"Tokyo\"." }, "metadata": { "type": "object", "additionalProperties": { "type": "any", "description": "Properties of the object. Contains field @type with type URL." }, "description": "Service-specific metadata. For example the available capacity at the given location." }, "name": { "type": "string", "description": "Resource name for the location, which may vary between implementations. For example: `\"projects/example-project/locations/us-east1\"`" }, "labels": { "description": "Cross-service attributes for the location. For example {\"cloud.googleapis.com/region\": \"us-east1\"}", "type": "object", "additionalProperties": { "type": "string" } }, "locationId": { "type": "string", "description": "The canonical id for this location. For example: `\"us-east1\"`." } }, "id": "GoogleCloudLocationLocation", "description": "A resource that represents a Google Cloud location.", "type": "object" }, "OrganizationImpact": { "id": "OrganizationImpact", "description": "Represents impact to assets at organizational level. It is a read-only view and does not allow any modifications.", "type": "object", "properties": { "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The time when the affected project was last modified." }, "asset": { "readOnly": true, "description": "Output only. Google Cloud asset possibly impacted by the specified events.", "$ref": "Asset" }, "name": { "readOnly": true, "description": "Output only. Identifier. Unique name of the organization impact in this scope including organization and location using the form `organizations/{organization_id}/locations/{location}/organizationImpacts/{organization_impact_id}`. `organization_id` - ID (number) of the organization that contains the event. To get your `organization_id`, see [Getting your organization resource ID](https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id). `location` - The location of the organization impact. `organization_impact_id` - ID of the [OrganizationImpact resource](/service-health/docs/reference/rest/v1beta/organizations.locations.organizationImpacts#OrganizationImpact).", "type": "string" }, "events": { "description": "Output only. A list of event names impacting the asset.", "type": "array", "items": { "type": "string" }, "readOnly": true } } }, "Location": { "type": "object", "id": "Location", "description": "Represents the locations impacted by the event.", "properties": { "locationName": { "description": "Location impacted by the event. Example: `\"us-central1\"`", "type": "string" } } }, "EventUpdate": { "properties": { "updateTime": { "readOnly": true, "format": "google-datetime", "type": "string", "description": "Output only. The time the update was posted." }, "title": { "readOnly": true, "type": "string", "description": "Output only. Brief title for the event." }, "description": { "readOnly": true, "type": "string", "description": "Output only. Free-form, human-readable description." }, "symptom": { "description": "Output only. Symptoms of the event, if available.", "type": "string", "readOnly": true }, "workaround": { "readOnly": true, "description": "Output only. Workaround steps to remediate the event impact, if available.", "type": "string" } }, "id": "EventUpdate", "description": "Records an update made to the event.", "type": "object" }, "OperationMetadata": { "type": "object", "id": "OperationMetadata", "description": "Represents the metadata of the long-running operation.", "properties": { "createTime": { "type": "string", "description": "Output only. The time the operation was created.", "readOnly": true, "format": "google-datetime" }, "target": { "readOnly": true, "type": "string", "description": "Output only. Server-defined resource path for the target of the operation." }, "verb": { "readOnly": true, "description": "Output only. Name of the verb executed by the operation.", "type": "string" }, "statusDetail": { "readOnly": true, "description": "Output only. Human-readable status of the operation, if any.", "type": "string" }, "cancelRequested": { "description": "Output only. Identifies whether the user has requested cancellation of the operation. Operations that have been cancelled successfully have google.longrunning.Operation.error value with a google.rpc.Status.code of `1`, corresponding to `Code.CANCELLED`.", "type": "boolean", "readOnly": true }, "endTime": { "readOnly": true, "format": "google-datetime", "description": "Output only. The time the operation finished running.", "type": "string" }, "apiVersion": { "readOnly": true, "description": "Output only. API version used to start the operation.", "type": "string" } } } }, "title": "Service Health API", "protocol": "rest", "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/cloud-platform": { "description": "See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account." } } } }, "icons": { "x16": "http://www.google.com/images/icons/product/search-16.gif", "x32": "http://www.google.com/images/icons/product/search-32.gif" }, "revision": "20260422", "rootUrl": "https://servicehealth.googleapis.com/", "basePath": "", "name": "servicehealth", "description": "Personalized Service Health helps you gain visibility into disruptive events impacting Google Cloud products. ", "ownerDomain": "google.com", "resources": { "projects": { "resources": { "locations": { "resources": { "events": { "methods": { "list": { "parameters": { "filter": { "type": "string", "description": "Optional. A filter expression that filters resources listed in the response. The expression takes the following forms: * field=value for `category` and `state` * field \u003c, \u003e, \u003c=, or \u003e= value for `update_time` Examples: `category=INCIDENT`, `update_time\u003e=\"2000-01-01T11:30:00-04:00\"`, `event_impacts.product.product_name:\"Eventarc\"` Multiple filter queries are separated by spaces. Example: `category=INCIDENT state=ACTIVE`. By default, each expression is an AND expression. However, you can include AND and OR expressions explicitly. Filter is supported for the following fields: `category`, `state`, `update_time`, `event_impacts.product.product_name`", "location": "query" }, "pageToken": { "type": "string", "description": "Optional. A token identifying a page of results the server should return. Provide Page token returned by a previous `ListEvents` call to retrieve the next page of results. When paginating, all other parameters provided to `ListEvents` must match the call that provided the page token.", "location": "query" }, "view": { "enumDescriptions": [ "Unspecified event view. Default to `EVENT_VIEW_BASIC`.", "Includes all fields except `updates`. This view is the default for ListEvents API.", "Includes all event fields." ], "enum": [ "EVENT_VIEW_UNSPECIFIED", "EVENT_VIEW_BASIC", "EVENT_VIEW_FULL" ], "description": "Optional. Event fields to include in response.", "location": "query", "type": "string" }, "parent": { "type": "string", "required": true, "description": "Required. Parent value using the form `projects/{project_id}/locations/{location}/events`. `project_id` - ID of the project for which to list service health events. `location` - The location to get the service health events from. Set this field to `global`.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$" }, "pageSize": { "description": "Optional. The maximum number of events that should be returned. Acceptable values are 1 to 100, inclusive. (The default value is 10.) If more results are available, the service returns a next_page_token that you can use to get the next page of results in subsequent list requests. The service may return fewer events than the requested page_size.", "location": "query", "type": "integer", "format": "int32" } }, "httpMethod": "GET", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/events", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/events", "id": "servicehealth.projects.locations.events.list", "parameterOrder": [ "parent" ], "description": "Lists events under a given project and location.", "response": { "$ref": "ListEventsResponse" } }, "get": { "httpMethod": "GET", "parameters": { "name": { "pattern": "^projects/[^/]+/locations/[^/]+/events/[^/]+$", "description": "Required. Unique name of the event in this scope including project and location using the form `projects/{project_id}/locations/{location}/events/{event_id}`. `project_id` - Project ID of the project that contains the event. `location` - The location to get the service health events from. Set this field to `global`. `event_id` - Event ID to retrieve.", "location": "path", "required": true, "type": "string" } }, "id": "servicehealth.projects.locations.events.get", "parameterOrder": [ "name" ], "description": "Retrieves a resource containing information about an event.", "response": { "$ref": "Event" }, "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/events/{eventsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+name}" } } } }, "methods": { "list": { "parameters": { "pageToken": { "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.", "location": "query", "type": "string" }, "name": { "type": "string", "required": true, "description": "The resource that owns the locations collection, if applicable.", "location": "path", "pattern": "^projects/[^/]+$" }, "filter": { "type": "string", "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like `\"displayName=tokyo\"`, and is documented in more detail in [AIP-160](https://google.aip.dev/160).", "location": "query" }, "pageSize": { "type": "integer", "description": "The maximum number of results to return. If not set, the service selects a default.", "location": "query", "format": "int32" }, "extraLocationTypes": { "type": "string", "description": "Optional. Do not use this field unless explicitly documented otherwise. This is primarily for internal usage.", "location": "query", "repeated": true } }, "httpMethod": "GET", "path": "v1/{+name}/locations", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/projects/{projectsId}/locations", "response": { "$ref": "ListLocationsResponse" }, "id": "servicehealth.projects.locations.list", "parameterOrder": [ "name" ], "description": "Lists information about the supported locations for this service. This method lists locations based on the resource scope provided in the ListLocationsRequest.name field: * **Global locations**: If `name` is empty, the method lists the public locations available to all projects. * **Project-specific locations**: If `name` follows the format `projects/{project}`, the method lists locations visible to that specific project. This includes public, private, or other project-specific locations enabled for the project. For gRPC and client library implementations, the resource name is passed as the `name` field. For direct service calls, the resource name is incorporated into the request path based on the specific service implementation and version." }, "get": { "response": { "$ref": "GoogleCloudLocationLocation" }, "id": "servicehealth.projects.locations.get", "parameterOrder": [ "name" ], "description": "Gets information about a location.", "path": "v1/{+name}", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "httpMethod": "GET", "parameters": { "name": { "type": "string", "required": true, "description": "Resource name for the location.", "location": "path", "pattern": "^projects/[^/]+/locations/[^/]+$" } } } } } } }, "organizations": { "resources": { "locations": { "resources": { "organizationEvents": { "methods": { "list": { "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/organizationEvents", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "path": "v1/{+parent}/organizationEvents", "id": "servicehealth.organizations.locations.organizationEvents.list", "parameterOrder": [ "parent" ], "description": "Lists organization events under a given organization and location.", "response": { "$ref": "ListOrganizationEventsResponse" }, "parameters": { "parent": { "description": "Required. Parent value using the form `organizations/{organization_id}/locations/{location}/organizationEvents`. `organization_id` - ID (number) of the organization that contains the event. To get your `organization_id`, see [Getting your organization resource ID](https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id). `location` - The location to get the organization events from. Set this field to `global`.", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$", "type": "string", "required": true }, "pageSize": { "type": "integer", "description": "Optional. The maximum number of events that should be returned. Acceptable values are `1` to `100`, inclusive. (The default value is `10`.) If more results are available, the service returns a `next_page_token` that you can use to get the next page of results in subsequent list requests. The service may return fewer events than the requested `page_size`.", "location": "query", "format": "int32" }, "view": { "type": "string", "description": "Optional. OrganizationEvent fields to include in response.", "location": "query", "enumDescriptions": [ "Unspecified event view. Default to `ORGANIZATION_EVENT_VIEW_BASIC`.", "Includes all organization event fields except `updates`. This view is the default for ListOrganizationEvents API.", "Includes all organization event fields." ], "enum": [ "ORGANIZATION_EVENT_VIEW_UNSPECIFIED", "ORGANIZATION_EVENT_VIEW_BASIC", "ORGANIZATION_EVENT_VIEW_FULL" ] }, "pageToken": { "type": "string", "description": "Optional. A token identifying a page of results the server should return. Provide Page token returned by a previous `ListOrganizationEvents` call to retrieve the next page of results. When paginating, all other parameters provided to `ListOrganizationEvents` must match the call that provided the page token.", "location": "query" }, "filter": { "description": "Optional. A filter expression that filters resources listed in the response. The expression takes the following forms: * field=value for `category` and `state` * field \u003c, \u003e, \u003c=, or \u003e= value for `update_time` Examples: `category=INCIDENT`, `update_time\u003e=\"2000-01-01T11:30:00-04:00\"` Multiple filter queries are space-separated. Example: `category=INCIDENT state=ACTIVE`. By default, each expression is an AND expression. However, you can include AND and OR expressions explicitly. Filter is supported for the following fields: `category`, `state`, `update_time`", "location": "query", "type": "string" } }, "httpMethod": "GET" }, "get": { "parameters": { "name": { "description": "Required. Unique name of the event in this scope including organization and event ID using the form `organizations/{organization_id}/locations/locations/global/organizationEvents/{event_id}`. `organization_id` - ID (number) of the organization that contains the event. To get your `organization_id`, see [Getting your organization resource ID](https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id). `event_id` - Organization event ID to retrieve.", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+/organizationEvents/[^/]+$", "type": "string", "required": true } }, "httpMethod": "GET", "path": "v1/{+name}", "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/organizationEvents/{organizationEventsId}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "response": { "$ref": "OrganizationEvent" }, "id": "servicehealth.organizations.locations.organizationEvents.get", "parameterOrder": [ "name" ], "description": "Retrieves a resource containing information about an event affecting an organization." } } }, "organizationImpacts": { "methods": { "list": { "httpMethod": "GET", "parameters": { "pageToken": { "type": "string", "description": "Optional. A token identifying a page of results the server should return. Provide `page_token` returned by a previous `ListOrganizationImpacts` call to retrieve the next page of results. When paginating, all other parameters provided to `ListOrganizationImpacts` must match the call that provided the page token.", "location": "query" }, "parent": { "type": "string", "required": true, "description": "Required. Parent value using the form `organizations/{organization_id}/locations/{location}/organizationImpacts`. `location` - The location to get organization impacts from. Set this field to `global`. `organization_id` - ID (number) of the organization that contains the event. To get your `organization_id`, see [Getting your organization resource ID](https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id).", "location": "path", "pattern": "^organizations/[^/]+/locations/[^/]+$" }, "pageSize": { "type": "integer", "description": "Optional. The maximum number of events that should be returned. Acceptable values are `1` to `100`, inclusive. The default value is `10`. If more results are available, the service returns a `next_page_token` that can be used to get the next page of results in subsequent list requests. The service may return fewer [impacts](/service-health/docs/reference/rest/v1beta/organizations.locations.organizationImpacts#OrganizationImpact) than the requested `page_size`.", "location": "query", "format": "int32" }, "filter": { "type": "string", "description": "Optional. A filter expression that filters resources listed in the response. The expression is in the form of `field:value` for checking if a repeated field contains a value. Example: `events:organizations%2F{organization_id}%2Flocations%2Fglobal%2ForganizationEvents%2Fevent-id` To get your `{organization_id}`, see [Getting your organization resource ID](https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id). Multiple filter queries are separated by spaces. By default, each expression is an AND expression. However, you can include AND and OR expressions explicitly. Filter is supported for the following fields: `events`.", "location": "query" } }, "response": { "$ref": "ListOrganizationImpactsResponse" }, "id": "servicehealth.organizations.locations.organizationImpacts.list", "parameterOrder": [ "parent" ], "description": "Lists assets impacted by organization events under a given organization and location.", "path": "v1/{+parent}/organizationImpacts", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/organizationImpacts" }, "get": { "path": "v1/{+name}", "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ], "flatPath": "v1/organizations/{organizationsId}/locations/{locationsId}/organizationImpacts/{organizationImpactsId}", "response": { "$ref": "OrganizationImpact" }, "id": "servicehealth.organizations.locations.organizationImpacts.get", "parameterOrder": [ "name" ], "description": "Retrieves a resource containing information about impact to an asset under an organization affected by a service health event.", "parameters": { "name": { "pattern": "^organizations/[^/]+/locations/[^/]+/organizationImpacts/[^/]+$", "description": "Required. Name of the resource using the form `organizations/{organization_id}/locations/global/organizationImpacts/{organization_impact_id}`. `organization_id` - ID (number) of the organization that contains the event. To get your `organization_id`, see [Getting your organization resource ID](https://cloud.google.com/resource-manager/docs/creating-managing-organization#retrieving_your_organization_id). `organization_impact_id` - ID of the [OrganizationImpact resource](/service-health/docs/reference/rest/v1beta/organizations.locations.organizationImpacts#OrganizationImpact).", "location": "path", "required": true, "type": "string" } }, "httpMethod": "GET" } } } } } } } }, "parameters": { "callback": { "description": "JSONP", "location": "query", "type": "string" }, "access_token": { "description": "OAuth access token.", "location": "query", "type": "string" }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "location": "query", "type": "string" }, "uploadType": { "type": "string", "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "location": "query" }, "$.xgafv": { "type": "string", "enum": [ "1", "2" ], "enumDescriptions": [ "v1 error format", "v2 error format" ], "description": "V1 error format.", "location": "query" }, "fields": { "type": "string", "description": "Selector specifying which fields to include in a partial response.", "location": "query" }, "key": { "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.", "location": "query", "type": "string" }, "alt": { "type": "string", "default": "json", "description": "Data format for response.", "location": "query", "enum": [ "json", "media", "proto" ], "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ] }, "quotaUser": { "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query", "type": "string" }, "oauth_token": { "type": "string", "description": "OAuth 2.0 token for the current user.", "location": "query" }, "prettyPrint": { "description": "Returns response with indentations and line breaks.", "default": "true", "location": "query", "type": "boolean" } }, "mtlsRootUrl": "https://servicehealth.mtls.googleapis.com/" }