Google Cloud Compute Engine Cloud Compute Engine Regions API

openapi: 3.2.0
info:
  title: Compute Engine Regions API
  version: v1
  description: Generated from Google's published Discovery document for Compute Engine API (compute v1, revision 20261106). 2 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://compute.googleapis.com
tags:
- name: Regions
paths:
  /compute/v1/projects/{project}/regions:
    get:
      operationId: compute.regions.list
      summary: List regions
      description: 'Retrieves the list of region resources available to the specified project.


        To decrease latency for this method, you can optionally omit any unneeded

        information from the response by using a field mask. This practice is

        especially recommended for unused quota information

        (the `items.quotas` field).

        To exclude one or more fields, set your request''s `fields` query parameter

        to only include the fields you need. For example, to only include the `id`

        and `selfLink` fields, add the query parameter `?fields=id,selfLink` to

        your request.


        This method fails if the quota information is unavailable for the region

        and if the organization policy constraint

        compute.requireBasicQuotaInResponse is enforced. This

        constraint, when enforced, disables the fail-open behaviour when quota

        information (the `items.quotas` field) is unavailable for the region.

        It is recommended to use the default setting

        for the constraint unless your application requires the fail-closed

        behaviour for this method.'
      parameters:
      - name: project
        in: path
        required: true
        description: Project ID for this request.
        schema:
          type: string
          pattern: (?:(?:[-a-z0-9]{1,63}\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))
      - name: filter
        in: query
        required: false
        description: 'A filter expression that filters resources listed in the response. Most

          Compute resources support two types of filter expressions:

          expressions that support regular expressions and expressions that follow

          API improvement proposal AIP-160.

          These two types of filter expressions cannot be mixed in one request.


          If you want to use AIP-160, your expression must specify the field name, an

          operator, and the value that you want to use for filtering. The value

          must be a string, a number, or a boolean. The operator

          must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`.


          For example, if you are filtering Compute Engine instances, you can

          exclude instances named `example-instance` by specifying

          `name != example-instance`.


          The `:*` comparison can be used to test whether a key has been defined.

          For example, to find all objects with `owner` label use:

          ```

          labels.owner:*

          ```


          You can also filter nested fields. For example, you could specify

          `scheduling.automaticRestart = false` to include instances only

          if they are not scheduled for automatic restarts. You can use filtering

          on nested fields to filter based onresource labels.


          To filter on multiple expressions, provide each separate expression within

          parentheses. For example:

          ```

          (scheduling.automaticRestart = true)

          (cpuPlatform = "Intel Skylake")

          ```

          By default, each expression is an `AND` expression. However, you

          can include `AND` and `OR` expressions explicitly.

          For example:

          ```

          (cpuPlatform = "Intel Skylake") OR

          (cpuPlatform = "Intel Broadwell") AND

          (scheduling.automaticRestart = true)

          ```


          If you want to use a regular expression, use the `eq` (equal) or `ne`

          (not equal) operator against a single un-parenthesized expression with or

          without quotes or against multiple parenthesized expressions. Examples:


          `fieldname eq unquoted literal`

          `fieldname eq ''single quoted literal''`

          `fieldname eq "double quoted literal"`

          `(fieldname1 eq literal) (fieldname2 ne "literal")`


          The literal value is interpreted as a regular expression using GoogleRE2 library syntax.

          The literal value must match the entire field.


          For example, to filter for instances that do not end with name "instance",

          you would use `name ne .*instance`.


          You cannot combine constraints on multiple fields using regular

          expressions.'
        schema:
          type: string
      - name: maxResults
        in: query
        required: false
        description: 'The maximum number of results per page that should be returned.

          If the number of available results is larger than `maxResults`,

          Compute Engine returns a `nextPageToken` that can be used to get

          the next page of results in subsequent list requests. Acceptable values are

          `0` to `500`, inclusive. (Default: `500`)'
        schema:
          type: integer
          default: '500'
          format: uint32
          minimum: 0
      - name: orderBy
        in: query
        required: false
        description: 'Sorts list results by a certain order. By default, results

          are returned in alphanumerical order based on the resource name.


          You can also sort results in descending order based on the creation

          timestamp using `orderBy="creationTimestamp desc"`. This sorts

          results based on the `creationTimestamp` field in

          reverse chronological order (newest result first). Use this to sort

          resources like operations so that the newest operation is returned first.


          Currently, only sorting by `name` or

          `creationTimestamp desc` is supported.'
        schema:
          type: string
      - name: pageToken
        in: query
        required: false
        description: 'Specifies a page token to use. Set `pageToken` to the

          `nextPageToken` returned by a previous list request to get

          the next page of results.'
        schema:
          type: string
      - name: returnPartialSuccess
        in: query
        required: false
        description: 'Opt-in for partial success behavior which provides partial results in case

          of failure. The default value is false.


          For example, when partial success behavior is enabled, aggregatedList for a

          single zone scope either returns all resources in the zone or no resources,

          with an error code.'
        schema:
          type: boolean
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegionList'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/compute
        - https://www.googleapis.com/auth/compute.readonly
      - apiKey: []
      tags:
      - Regions
  /compute/v1/projects/{project}/regions/{region}:
    get:
      operationId: compute.regions.get
      summary: Get regions
      description: 'Returns the specified Region resource.


        To decrease latency for this method, you can optionally omit any unneeded

        information from the response by using a field mask. This practice is

        especially recommended for unused quota information (the `quotas` field).

        To exclude one or more fields, set your request''s `fields` query parameter

        to only include the fields you need. For example, to only include the `id`

        and `selfLink` fields, add the query parameter `?fields=id,selfLink` to

        your request.


        This method fails if the quota information is unavailable for the region

        and if the organization policy constraint

        compute.requireBasicQuotaInResponse is enforced. This

        constraint, when enforced, disables the fail-open behaviour when quota

        information (the `items.quotas` field) is unavailable for the region.

        It is recommended to use the default setting

        for the constraint unless your application requires the fail-closed

        behaviour for this method.'
      parameters:
      - name: project
        in: path
        required: true
        description: Project ID for this request.
        schema:
          type: string
          pattern: (?:(?:[-a-z0-9]{1,63}\.)*(?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?):)?(?:[0-9]{1,19}|(?:[a-z0-9](?:[-a-z0-9]{0,61}[a-z0-9])?))
      - name: region
        in: path
        required: true
        description: Name of the region resource to return.
        schema:
          type: string
          pattern: '[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?|[1-9][0-9]{0,19}'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Region'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/cloud-platform
        - https://www.googleapis.com/auth/compute
        - https://www.googleapis.com/auth/compute.readonly
      - apiKey: []
      tags:
      - Regions
components:
  schemas:
    Quota:
      type: object
      properties:
        limit:
          type: number
          format: double
          description: '[Output Only] Quota limit for this metric.'
        owner:
          description: '[Output Only] Owning resource. This is the resource on which this quota

            is applied.'
          type: string
        metric:
          type: string
          enum:
          - A2_CPUS
          - AFFINITY_GROUPS
          - AUTOSCALERS
          - BACKEND_BUCKETS
          - BACKEND_SERVICES
          - C2D_CPUS
          - C2_CPUS
          - C3_CPUS
          - COMMITMENTS
          - COMMITTED_A2_CPUS
          - COMMITTED_C2D_CPUS
          - COMMITTED_C2_CPUS
          - COMMITTED_C3_CPUS
          - COMMITTED_CPUS
          - COMMITTED_E2_CPUS
          - COMMITTED_LICENSES
          - COMMITTED_LOCAL_SSD_TOTAL_GB
          - COMMITTED_M3_CPUS
          - COMMITTED_MEMORY_OPTIMIZED_CPUS
          - COMMITTED_N2A_CPUS
          - COMMITTED_N2D_CPUS
          - COMMITTED_N2_CPUS
          - COMMITTED_NVIDIA_A100_80GB_GPUS
          - COMMITTED_NVIDIA_A100_GPUS
          - COMMITTED_NVIDIA_H100_GPUS
          - COMMITTED_NVIDIA_K80_GPUS
          - COMMITTED_NVIDIA_L4_GPUS
          - COMMITTED_NVIDIA_P100_GPUS
          - COMMITTED_NVIDIA_P4_GPUS
          - COMMITTED_NVIDIA_T4_GPUS
          - COMMITTED_NVIDIA_V100_GPUS
          - COMMITTED_T2A_CPUS
          - COMMITTED_T2D_CPUS
          - COMMITTED_Z3_CPUS
          - CPUS
          - CPUS_ALL_REGIONS
          - DISKS_TOTAL_GB
          - E2_CPUS
          - EXTERNAL_MANAGED_FORWARDING_RULES
          - EXTERNAL_NETWORK_LB_FORWARDING_RULES
          - EXTERNAL_PROTOCOL_FORWARDING_RULES
          - EXTERNAL_VPN_GATEWAYS
          - FIREWALLS
          - FORWARDING_RULES
          - GLOBAL_EXTERNAL_MANAGED_BACKEND_SERVICES
          - GLOBAL_EXTERNAL_MANAGED_FORWARDING_RULES
          - GLOBAL_EXTERNAL_PROXY_LB_BACKEND_SERVICES
          - GLOBAL_INTERNAL_ADDRESSES
          - GLOBAL_INTERNAL_MANAGED_BACKEND_SERVICES
          - GLOBAL_INTERNAL_TRAFFIC_DIRECTOR_BACKEND_SERVICES
          - GPUS_ALL_REGIONS
          - HDB_TOTAL_GB
          - HDB_TOTAL_IOPS
          - HDB_TOTAL_THROUGHPUT
          - HEALTH_CHECKS
          - IMAGES
          - INSTANCES
          - INSTANCE_GROUPS
          - INSTANCE_GROUP_MANAGERS
          - INSTANCE_TEMPLATES
          - INTERCONNECTS
          - INTERCONNECT_ATTACHMENTS_PER_REGION
          - INTERCONNECT_ATTACHMENTS_TOTAL_MBPS
          - INTERCONNECT_TOTAL_GBPS
          - INTERNAL_ADDRESSES
          - INTERNAL_TRAFFIC_DIRECTOR_FORWARDING_RULES
          - IN_PLACE_SNAPSHOTS
          - IN_USE_ADDRESSES
          - IN_USE_BACKUP_SCHEDULES
          - IN_USE_SNAPSHOT_SCHEDULES
          - LOCAL_SSD_TOTAL_GB
          - M1_CPUS
          - M2_CPUS
          - M3_CPUS
          - MACHINE_IMAGES
          - N2A_CPUS
          - N2D_CPUS
          - N2_CPUS
          - NETWORKS
          - NETWORK_ATTACHMENTS
          - NETWORK_ENDPOINT_GROUPS
          - NETWORK_FIREWALL_POLICIES
          - NET_LB_SECURITY_POLICIES_PER_REGION
          - NET_LB_SECURITY_POLICY_RULES_PER_REGION
          - NET_LB_SECURITY_POLICY_RULE_ATTRIBUTES_PER_REGION
          - NODE_GROUPS
          - NODE_TEMPLATES
          - NVIDIA_A100_80GB_GPUS
          - NVIDIA_A100_GPUS
          - NVIDIA_K80_GPUS
          - NVIDIA_L4_GPUS
          - NVIDIA_P100_GPUS
          - NVIDIA_P100_VWS_GPUS
          - NVIDIA_P4_GPUS
          - NVIDIA_P4_VWS_GPUS
          - NVIDIA_T4_GPUS
          - NVIDIA_T4_VWS_GPUS
          - NVIDIA_V100_GPUS
          - PACKET_MIRRORINGS
          - PD_EXTREME_TOTAL_PROVISIONED_IOPS
          - PREEMPTIBLE_CPUS
          - PREEMPTIBLE_LOCAL_SSD_GB
          - PREEMPTIBLE_NVIDIA_A100_80GB_GPUS
          - PREEMPTIBLE_NVIDIA_A100_GPUS
          - PREEMPTIBLE_NVIDIA_H100_GPUS
          - PREEMPTIBLE_NVIDIA_K80_GPUS
          - PREEMPTIBLE_NVIDIA_L4_GPUS
          - PREEMPTIBLE_NVIDIA_P100_GPUS
          - PREEMPTIBLE_NVIDIA_P100_VWS_GPUS
          - PREEMPTIBLE_NVIDIA_P4_GPUS
          - PREEMPTIBLE_NVIDIA_P4_VWS_GPUS
          - PREEMPTIBLE_NVIDIA_T4_GPUS
          - PREEMPTIBLE_NVIDIA_T4_VWS_GPUS
          - PREEMPTIBLE_NVIDIA_V100_GPUS
          - PREEMPTIBLE_TPU_LITE_DEVICE_V5
          - PREEMPTIBLE_TPU_LITE_PODSLICE_V5
          - PREEMPTIBLE_TPU_PODSLICE_V4
          - PSC_ILB_CONSUMER_FORWARDING_RULES_PER_PRODUCER_NETWORK
          - PSC_INTERNAL_LB_FORWARDING_RULES
          - PUBLIC_ADVERTISED_PREFIXES
          - PUBLIC_DELEGATED_PREFIXES
          - REGIONAL_AUTOSCALERS
          - REGIONAL_EXTERNAL_MANAGED_BACKEND_SERVICES
          - REGIONAL_EXTERNAL_NETWORK_LB_BACKEND_SERVICES
          - REGIONAL_INSTANCE_GROUP_MANAGERS
          - REGIONAL_INTERNAL_LB_BACKEND_SERVICES
          - REGIONAL_INTERNAL_MANAGED_BACKEND_SERVICES
          - REGIONAL_INTERNAL_TRAFFIC_DIRECTOR_BACKEND_SERVICES
          - RESERVATIONS
          - RESOURCE_POLICIES
          - ROUTERS
          - ROUTES
          - SECURITY_POLICIES
          - SECURITY_POLICIES_PER_REGION
          - SECURITY_POLICY_ADVANCED_RULES_PER_REGION
          - SECURITY_POLICY_CEVAL_RULES
          - SECURITY_POLICY_RULES
          - SECURITY_POLICY_RULES_PER_REGION
          - SERVICE_ATTACHMENTS
          - SNAPSHOTS
          - SSD_TOTAL_GB
          - SSL_CERTIFICATES
          - SSL_POLICIES
          - STATIC_ADDRESSES
          - STATIC_BYOIP_ADDRESSES
          - STATIC_EXTERNAL_IPV6_ADDRESS_RANGES
          - SUBNETWORKS
          - T2A_CPUS
          - T2D_CPUS
          - TARGET_HTTPS_PROXIES
          - TARGET_HTTP_PROXIES
          - TARGET_INSTANCES
          - TARGET_POOLS
          - TARGET_SSL_PROXIES
          - TARGET_TCP_PROXIES
          - TARGET_VPN_GATEWAYS
          - TPU_LITE_DEVICE_V5
          - TPU_LITE_PODSLICE_V5
          - TPU_PODSLICE_V4
          - URL_MAPS
          - VARIABLE_IPV6_PUBLIC_DELEGATED_PREFIXES
          - VPN_GATEWAYS
          - VPN_TUNNELS
          - XPN_SERVICE_PROJECTS
          description: '[Output Only] Name of the quota metric.'
        usage:
          format: double
          type: number
          description: '[Output Only] Current usage of this metric.'
      description: A quotas entry.
    RegionList:
      properties:
        id:
          description: '[Output Only] Unique identifier for the resource; defined by the server.'
          type: string
        items:
          description: A list of Region resources.
          type: array
          items:
            $ref: '#/components/schemas/Region'
        kind:
          default: compute#regionList
          type: string
          description: 'Output only. [Output Only] Type of resource. Always compute#regionList for

            lists of regions.'
          readOnly: true
        warning:
          description: '[Output Only] Informational warning message.'
          type: object
          properties:
            data:
              type: array
              description: "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n  {\n   \"key\": \"scope\",\n   \"value\": \"zones/us-east1-d\"\n  }]"
              items:
                properties:
                  value:
                    type: string
                    description: '[Output Only] A warning data value corresponding to the key.'
                  key:
                    description: '[Output Only] A key that provides more detail on the warning being

                      returned. For example, for warnings where there are no results in a list

                      request for a particular zone, this key might be scope and

                      the key value might be the zone name. Other examples might be a key

                      indicating a deprecated resource and a suggested replacement, or a

                      warning about invalid network settings (for example, if an instance

                      attempts to perform IP forwarding but is not enabled for IP forwarding).'
                    type: string
                type: object
            code:
              enum:
              - CLEANUP_FAILED
              - DEPRECATED_RESOURCE_USED
              - DEPRECATED_TYPE_USED
              - DISK_SIZE_LARGER_THAN_IMAGE_SIZE
              - EXPERIMENTAL_TYPE_USED
              - EXTERNAL_API_WARNING
              - FIELD_VALUE_OVERRIDEN
              - INJECTED_KERNELS_DEPRECATED
              - INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB
              - LARGE_DEPLOYMENT_WARNING
              - LIST_OVERHEAD_QUOTA_EXCEED
              - MISSING_TYPE_DEPENDENCY
              - NEXT_HOP_ADDRESS_NOT_ASSIGNED
              - NEXT_HOP_CANNOT_IP_FORWARD
              - NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE
              - NEXT_HOP_INSTANCE_NOT_FOUND
              - NEXT_HOP_INSTANCE_NOT_ON_NETWORK
              - NEXT_HOP_NOT_RUNNING
              - NOT_CRITICAL_ERROR
              - NO_RESULTS_ON_PAGE
              - PARTIAL_SUCCESS
              - QUOTA_INFO_UNAVAILABLE
              - REQUIRED_TOS_AGREEMENT
              - RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING
              - RESOURCE_NOT_DELETED
              - SCHEMA_VALIDATION_IGNORED
              - SINGLE_INSTANCE_PROPERTY_TEMPLATE
              - UNDECLARED_PROPERTIES
              - UNREACHABLE
              description: '[Output Only] A warning code, if applicable. For example, Compute

                Engine returns NO_RESULTS_ON_PAGE if there

                are no results in the response.'
              type: string
            message:
              description: '[Output Only] A human-readable description of the warning code.'
              type: string
        nextPageToken:
          type: string
          description: '[Output Only] This token allows you to get the next page of results for

            list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for

            the query parameter pageToken in the next list request.

            Subsequent list requests will have their own nextPageToken to

            continue paging through the results.'
        selfLink:
          description: Output only. [Output Only] Server-defined URL for this resource.
          readOnly: true
          type: string
      type: object
      description: Contains a list of region resources.
    DeprecationStatus:
      description: Deprecation status for a public resource.
      type: object
      properties:
        deleted:
          description: 'An optional RFC3339 timestamp on or after which the state of this

            resource is intended to change to DELETED. This is only

            informational and the status will not change unless the client explicitly

            changes it.'
          type: string
        obsolete:
          description: 'An optional RFC3339 timestamp on or after which the state of this

            resource is intended to change to OBSOLETE. This is only

            informational and the status will not change unless the client explicitly

            changes it.'
          type: string
        deprecated:
          description: 'An optional RFC3339 timestamp on or after which the state of this

            resource is intended to change to DEPRECATED. This is only

            informational and the status will not change unless the client explicitly

            changes it.'
          type: string
        state:
          type: string
          description: 'The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.

            Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a

            warning indicating the deprecated resource and recommending its

            replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.'
          enum:
          - ACTIVE
          - DELETED
          - DEPRECATED
          - OBSOLETE
        replacement:
          description: 'The URL of the suggested replacement for a deprecated resource.

            The suggested replacement resource must be the same kind of resource as the

            deprecated resource.'
          type: string
    GoogleRpcError:
      type: object
      description: The error envelope every Google API returns.
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            status:
              type: string
            details:
              type: array
              items:
                type: object
    Region:
      properties:
        selfLink:
          description: '[Output Only] Server-defined URL for the resource.'
          type: string
        status:
          type: string
          description: '[Output Only] Status of the region, either UP orDOWN.'
          enum:
          - DOWN
          - UP
        kind:
          default: compute#region
          description: 'Output only. [Output Only] Type of the resource. Always compute#region for

            regions.'
          type: string
          readOnly: true
        quotaStatusWarning:
          properties:
            data:
              type: array
              description: "[Output Only] Metadata about this warning in key:\nvalue format. For example:\n\n\"data\": [\n  {\n   \"key\": \"scope\",\n   \"value\": \"zones/us-east1-d\"\n  }]"
              items:
                type: object
                properties:
                  key:
                    type: string
                    description: '[Output Only] A key that provides more detail on the warning being

                      returned. For example, for warnings where there are no results in a list

                      request for a particular zone, this key might be scope and

                      the key value might be the zone name. Other examples might be a key

                      indicating a deprecated resource and a suggested replacement, or a

                      warning about invalid network settings (for example, if an instance

                      attempts to perform IP forwarding but is not enabled for IP forwarding).'
                  value:
                    description: '[Output Only] A warning data value corresponding to the key.'
                    type: string
            code:
              type: string
              description: '[Output Only] A warning code, if applicable. For example, Compute

                Engine returns NO_RESULTS_ON_PAGE if there

                are no results in the response.'
              enum:
              - CLEANUP_FAILED
              - DEPRECATED_RESOURCE_USED
              - DEPRECATED_TYPE_USED
              - DISK_SIZE_LARGER_THAN_IMAGE_SIZE
              - EXPERIMENTAL_TYPE_USED
              - EXTERNAL_API_WARNING
              - FIELD_VALUE_OVERRIDEN
              - INJECTED_KERNELS_DEPRECATED
              - INVALID_HEALTH_CHECK_FOR_DYNAMIC_WIEGHTED_LB
              - LARGE_DEPLOYMENT_WARNING
              - LIST_OVERHEAD_QUOTA_EXCEED
              - MISSING_TYPE_DEPENDENCY
              - NEXT_HOP_ADDRESS_NOT_ASSIGNED
              - NEXT_HOP_CANNOT_IP_FORWARD
              - NEXT_HOP_INSTANCE_HAS_NO_IPV6_INTERFACE
              - NEXT_HOP_INSTANCE_NOT_FOUND
              - NEXT_HOP_INSTANCE_NOT_ON_NETWORK
              - NEXT_HOP_NOT_RUNNING
              - NOT_CRITICAL_ERROR
              - NO_RESULTS_ON_PAGE
              - PARTIAL_SUCCESS
              - QUOTA_INFO_UNAVAILABLE
              - REQUIRED_TOS_AGREEMENT
              - RESOURCE_IN_USE_BY_OTHER_RESOURCE_WARNING
              - RESOURCE_NOT_DELETED
              - SCHEMA_VALIDATION_IGNORED
              - SINGLE_INSTANCE_PROPERTY_TEMPLATE
              - UNDECLARED_PROPERTIES
              - UNREACHABLE
            message:
              description: '[Output Only] A human-readable description of the warning code.'
              type: string
          description: 'Output only. [Output Only] Warning of fetching the `quotas` field for this region. This

            field is populated only if fetching of the `quotas` field fails.'
          type: object
          readOnly: true
        quotas:
          items:
            $ref: '#/components/schemas/Quota'
          description: '[Output Only] Quotas assigned to this region.'
          type: array
        zones:
          description: '[Output Only] A list of zones available in this region, in the form of

            resource URLs.'
          type: array
          items:
            type: string
        deprecated:
          $ref: '#/components/schemas/DeprecationStatus'
          description: '[Output Only] The deprecation status associated with this region.'
        id:
          type: string
          format: uint64
          description: '[Output Only] The unique identifier for the resource. This identifier is

            defined by the server.'
        creationTimestamp:
          description: '[Output Only] Creation timestamp inRFC3339

            text format.'
          type: string
        supportsPzs:
          readOnly: true
          type: boolean
          description: Output only. [Output Only] Reserved for future use.
        name:
          description: '[Output Only] Name of the resource.'
          type: string
        description:
          description: '[Output Only] Textual description of the resource.'
          type: string
      description: 'Represents a Region resource.


        A region is a geographical area where a resource is located. For more

        information, readRegions

        and Zones.'
      type: object
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: API key; accepted by methods that do not need user data.
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/devstorage.read_only: View your data in Google Cloud Storage
            https://www.googleapis.com/auth/compute: View and manage your Google Compute Engine resources
            https://www.googleapis.com/auth/devstorage.read_write: Manage your data in Cloud Storage and see the email address of your Google Account
            https://www.googleapis.com/auth/cloud-platform: See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
            https://www.googleapis.com/auth/compute.readonly: View your Google Compute Engine resources
            https://www.googleapis.com/auth/devstorage.full_control: Manage your data and permissions in Cloud Storage and see the email address for your Google Account
externalDocs:
  url: https://cloud.google.com/compute/
x-provenance:
  method: harvested
  publisher: Google
  source: https://www.googleapis.com/discovery/v1/apis/compute/v1/rest
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261106)