Method: accessPolicies.servicePerimeters.commit

Commit the dry-run spec for all the Service Perimeters in an Access Policy. A commit operation on a Service Perimeter involves copying its spec field to that Service Perimeter's status field. Only Service Perimeters with useExplicitDryRunSpec field set to true are affected by a commit operation. The longrunning operation from this RPC will have a successful status once the dry-run specs for all the Service Perimeters have been committed. If a commit fails, it will cause the longrunning operation to return an error response and the entire commit operation will be cancelled. When successful, Operation.response field will contain CommitServicePerimetersResponse. The dryRun and the spec fields will be cleared after a successful commit operation.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Resource name for the parent Access Policy which owns all Service Perimeters in scope for the commit operation.

Format: accessPolicies/{policy_id}

Request body

The request body contains data with the following structure:

JSON representation
{
  "etag": string
}
Fields
etag

string

Optional. The etag for the version of the Access Policy that this commit operation is to be performed on. If, at the time of commit, the etag for the Access Policy stored in Access Context Manager is different from the specified etag, then the commit 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.