Check a permission of the calling credential
POST/api/v1/iam/check
Evaluates the calling credential's own policies (its owner's and, for an API key or OAuth token, its boundary and project scope) for an action the deployment registered (IAM_REGISTRATIONS_CONFIG) or any built-in action, such as one a resource the deployment stores will perform later, on an SRN, with the engine the runtime's own routes use. A denial is 200 with allowed: false, never 403. Only policies are evaluated: the answer says nothing about whether the resource exists.
Request
Responses
- 200
- 400
- 401
- 413
- 429
- 500
The policy decision
Invalid request — a query parameter or body field the operation does not declare, or a value that fails validation
Unauthorized
REQUEST_REJECTED — the request body is over the size the body parser accepts
QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens
Response Headers
Seconds until the quota window admits a request again
Unexpected server error — INTERNAL_ERROR, with the raw message never forwarded