Method: accessPolicies.servicePerimeters.replaceAll

Replace all existing Service Perimeters in an Access Policy with the Service Perimeters provided. This is done atomically. The longrunning operation from this RPC will have a successful status once all replacements have propagated to long-lasting storage. Replacements containing errors will result in an error response for the first error encountered. Replacement will be cancelled on error, existing Service Perimeters will not be affected. Operation.response field will contain ReplaceServicePerimetersResponse.

HTTP request

POST https://accesscontextmanager.googleapis.com/v1alpha/{parent=accessPolicies/*}/servicePerimeters:replaceAll

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Resource name for the access policy which owns these Service Perimeters.

Format: accessPolicies/{policy_id}

Request body

The request body contains data with the following structure:

JSON representation
{
  "servicePerimeters": [
    {
      object (ServicePerimeter)
    }
  ],
  "etag": string
}
Fields
servicePerimeters[]

object (ServicePerimeter)

Required. The desired Service Perimeters that should replace all existing Service Perimeters in the Access Policy.

etag

string

Optional. The etag for the version of the Access Policy that this replace operation is to be performed on. If, at the time of replace, the etag for the Access Policy stored in Access Context Manager is different from the specified etag, then the replace operation will not be performed and the call will fail. This field is not required. If etag is not provided, the operation will be performed as if a valid etag is provided.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

Try it!