services

Changed on

Service producers can use this method to retrieve a DNS zone in the shared producer host project and the matching peering zones in consumer project

get/v1/{+name}

Request

  • Base URL: https://servicenetworking.googleapis.com
  • URL: https://servicenetworking.googleapis.com/v1/{+name}
  • Auth: one of:
    • OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/cloud-platform) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/cloud-platform)
    • OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/service.management) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/service.management)

Path parameters

namestring required

Required. The network that the consumer is using to connect with services. Must be in the form of services/{service}/projects/{project}/global/networks/{network}/dnsZones/{zoneName} Where {service} is the peering service that is managing connectivity for the service producer's organization. For Google services that support this {project} is the project number, as in '12345' {network} is the network name. {zoneName} is the DNS zone name

Query parameters

includeUsedIpRangesboolean

Optional. When true, include the used IP ranges as part of the GetConsumerConfig output. This includes routes created inside the service networking network, consumer network, peers of the consumer network, and reserved ranges inside the service networking network. By default, this is false

pageSizeinteger

The standard list page size.

pageTokenstring

The standard list page token.

returnPartialSuccessboolean

When set to true, operations that are reachable are returned as normal, and those that are unreachable are returned in the ListOperationsResponse.unreachable field. This can only be true when reading across collections. For example, when parent is set to "projects/example/locations/-". This field is not supported by default and will result in an UNIMPLEMENTED error if set unless explicitly documented otherwise in service or product specific documentation.

Response

Successful response

Changes

  • 063a4a5b960fRevision changes
    • breaking

      removed the media type */* for the response with the status

    • info

      api operation id servicenetworking.operations.get removed and replaced with servicenetworking.services.projects.global.networks.dnsZones.get

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/service.management was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/service.management was removed from the endpoint's security scheme Oauth2c

    • info

      api tag services added

    • info

      api tag operations removed

    • info

      added the new optional query request parameter pageSize

    • info

      added the new optional query request parameter pageToken

    • info

      added the new optional query request parameter returnPartialSuccess

  • 26b44b7bd42cRevision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      api operation id servicenetworking.services.projects.global.networks.dnsZones.get removed and replaced with servicenetworking.operations.get

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/service.management was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/service.management was removed from the endpoint's security scheme Oauth2c

    • info

      api tag operations added

    • info

      api tag services removed

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status