Commits the dry-run specification for all the service perimeters in an access policy. A commit operation on a service perimeter involves copying its spec field to the status field of the service perimeter. Only service perimeters with useExplicitDryRunSpec field set to true are affected by a commit operation. The long-running operation from this RPC has a successful status after the dry-run specifications for all the service perimeters have been committed. If a commit fails, it causes the long-running operation to return an error response and the entire commit operation is cancelled. When successful, the Operation.response field contains CommitServicePerimetersResponse. The dry_run and the spec fields are cleared after a successful commit operation.
HTTP request
POST https://accesscontextmanager.googleapis.com/v1alpha/{parent=accessPolicies/*}/servicePerimeters:commit
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-17 UTC."],[[["\u003cp\u003eThis document describes how to commit dry-run specifications for service perimeters within an access policy, involving copying the \u003ccode\u003espec\u003c/code\u003e field to the \u003ccode\u003estatus\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eThe operation is performed via an HTTP \u003ccode\u003ePOST\u003c/code\u003e request to a specific URL, which includes a \u003ccode\u003eparent\u003c/code\u003e path parameter specifying the access policy.\u003c/p\u003e\n"],["\u003cp\u003eThe request body optionally includes an \u003ccode\u003eetag\u003c/code\u003e for the access policy to ensure the commit is performed on the intended version, with the request body containing a JSON representation with the \u003ccode\u003eetag\u003c/code\u003e field.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful commit operations result in an \u003ccode\u003eOperation\u003c/code\u003e response, and the \u003ccode\u003edry_run\u003c/code\u003e and \u003ccode\u003espec\u003c/code\u003e fields are cleared, while failures result in an error response and the entire commit is canceled.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization for this operation requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,[]]
