services

Changed on

Service producers use this method to validate if the consumer provided network, project and requested range are valid. This allows them to use a fail-fast mechanism for consumer requests, and not have to wait for AddSubnetwork operation completion to determine if user request is invalid.

post/v1/{+parent}:validate

Request

  • Base URL: https://servicenetworking.googleapis.com
  • URL: https://servicenetworking.googleapis.com/v1/{+parent}:validate
  • 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

parentstring required

Required. This is in a form services/{service} where {service} is the name of the private access management service. For example 'service-peering.example.com'.

Request body

checkServiceNetworkingUsePermissionboolean

Optional. The IAM permission check determines whether the consumer project has 'servicenetworking.services.use' permission or not.

consumerNetworkstring

Required. The network that the consumer is using to connect with services. Must be in the form of projects/{project}/global/networks/{network} {project} is a project number, as in '12345' {network} is network name.

validateNetworkboolean

The validations will be performed in the order listed in the ValidationError enum. The first failure will return. If a validation is not requested, then the next one will be performed. SERVICE_NETWORKING_NOT_ENABLED and NETWORK_NOT_PEERED checks are performed for all requests where validation is requested. NETWORK_NOT_FOUND and NETWORK_DISCONNECTED checks are done for requests that have validate_network set to true.

Response

Successful response

Changes

  • 063a4a5b960fRevision changes
    • breaking

      removed the request body

    • breaking

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

    • 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

  • 26b44b7bd42cRevision changes
    • 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