Method: projects.locations.appGateways.setIamPolicy
Stay organized with collections
Save and categorize content based on your preferences.
Sets the access control policy on the specified resource. Replaces any existing policy.
Can return NOT_FOUND
, INVALID_ARGUMENT
, and PERMISSION_DENIED
errors.
HTTP request
POST https://beyondcorp.googleapis.com/v1/{resource=projects/*/locations/*/appGateways/*}:setIamPolicy
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
resource |
string
REQUIRED: The resource for which the policy is being specified. See Resource names for the appropriate value for this field.
|
Request body
The request body contains data with the following structure:
JSON representation |
{
"policy": {
object (Policy )
},
"updateMask": string
} |
Fields |
policy |
object (Policy )
REQUIRED: The complete policy to be applied to the resource . The size of the policy is limited to a few 10s of KB. An empty policy is a valid policy but certain Google Cloud services (such as Projects) might reject them.
|
updateMask |
string (FieldMask format)
OPTIONAL: A FieldMask specifying which fields of the policy to modify. Only the fields in the mask will be modified. If no mask is provided, the following default mask is used: paths: "bindings, etag"
This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo" .
|
Response body
If successful, the response body contains an instance of Policy
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
For more information, see the Authentication Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-20 UTC.
[[["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-20 UTC."],[[["\u003cp\u003eThis endpoint sets the access control policy for a specified resource, replacing any existing policy, and it requires specifying the resource in the request path.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include a complete policy object and optionally an \u003ccode\u003eupdateMask\u003c/code\u003e to modify specific policy fields.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ePOST\u003c/code\u003e request uses gRPC Transcoding with the format \u003ccode\u003ehttps://beyondcorp.googleapis.com/v1/{resource=projects/*/locations/*/appGateways/*}:setIamPolicy\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return a \u003ccode\u003ePolicy\u003c/code\u003e object in the response body, and unsuccessful request may return \u003ccode\u003eNOT_FOUND\u003c/code\u003e, \u003ccode\u003eINVALID_ARGUMENT\u003c/code\u003e, and \u003ccode\u003ePERMISSION_DENIED\u003c/code\u003e errors.\u003c/p\u003e\n"],["\u003cp\u003eThis method requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.appGateways.setIamPolicy\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nSets the access control policy on the specified resource. Replaces any existing policy.\n\nCan return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors.\n\n### HTTP request\n\n`POST https://beyondcorp.googleapis.com/v1/{resource=projects/*/locations/*/appGateways/*}:setIamPolicy`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Policy](/beyondcorp/docs/reference/rest/v1/Policy).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]