- [Resource: AccessPolicy](https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies#AccessPolicy)
  - [JSON representation](https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies#AccessPolicy.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies#METHODS_SUMMARY)

## Resource: AccessPolicy

`AccessPolicy` is a container for `AccessLevels` (which define the necessary attributes to use Google Cloud services) and `ServicePerimeters` (which define regions of services able to freely pass data within a perimeter). An access policy is globally visible within an organization, and the restrictions it specifies apply to all projects within an organization.

| JSON representation |
|---|
| ``` { "name": string, "parent": string, "title": string, "scopes": [ string ], "etag": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. Resource name of the `AccessPolicy`. Format: `accessPolicies/{access_policy}` |
| `parent` | `string` Immutable. The parent of this `AccessPolicy` in the Cloud Resource Hierarchy. Format: `organizations/{organizationId}` |
| `title` | `string` Required. Human-readable title. Does not affect behavior. |
| `scopes[]` | `string` The scopes of the `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies#AccessPolicy`. Scopes define which resources a policy can restrict and where its resources can be referenced. For example, policy A with `scopes=["folders/123"]` has the following behavior: - `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies.servicePerimeters#ServicePerimeter` can only restrict projects within `folders/123`. - `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies.servicePerimeters#ServicePerimeter` within policy A can only reference access levels defined within policy A. - Only one policy can include a given scope; thus, attempting to create a second policy that includes `folders/123` will result in an error. If no scopes are provided, then any resource within the organization can be restricted. Scopes cannot be modified after a policy is created. Policies can only have a single scope. Format: list of `folders/{folder_number}` or `projects/{projectNumber}` |
| `etag` | `string` Output only. An opaque identifier for the current version of the `AccessPolicy`. This will always be a strongly validated etag, meaning that two access policies will be identical if and only if their etags are identical. Clients should not expect this to be in any specific format. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies/create` | Creates an access policy. |
| ### `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies/delete` | Deletes an `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies#AccessPolicy` based on the resource name. |
| ### `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies/get` | Returns an `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies#AccessPolicy` based on the name. |
| ### `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies/getIamPolicy` | Gets the IAM policy for the specified Access Context Manager `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies#AccessPolicy`. |
| ### `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies/list` | Lists all `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies#AccessPolicy` in an organization. |
| ### `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies/patch` | Updates an `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies#AccessPolicy`. |
| ### `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies/setIamPolicy` | Sets the IAM policy for the specified Access Context Manager `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies#AccessPolicy`. |
| ### `https://docs.cloud.google.com/access-context-manager/docs/reference/rest/v1alpha/accessPolicies/testIamPermissions` | Returns the IAM permissions that the caller has on the specified Access Context Manager resource. |