---
title: "Get a Access Control Policy"
method: GET
path: "/access_control_policies/{uuid}"
tags: ["access_control_policies"]
---

# Get a Access Control Policy

`GET /access_control_policies/{uuid}`

This operation gets a Access Control Policy.

## Path parameters

- `uuid` string, UUID, required

## Response `200`

Success

- AccessControlPolicyIntentResponse — Response object for intentful operations on a access_control_policy
  - `status` AccessControlPolicyDefStatus — Access Control Policy status definition.
    - `state` string — The state of the Access Control Policy entity.
    - `message_list` MessageResource[]
      - `message` string, required — If state is ERROR, a message describing the error.
      - `reason` string, required — If state is ERROR, a machine-readable snake-cased string.
      - `details` object — Custom key-value details relevant to the status.
    - `name` string — Name of the Access Control Policy.
    - `resources` object, required
      - `role_reference` RoleReference — The reference to a role
        - `kind` string, required — The kind name
        - `name` string
        - `uuid` string, UUID, required
      - `user_reference_list` UserReference[] — The User(s) being assigned a given role.
        - `kind` string, required — The kind name
        - `name` string
        - `uuid` string, UUID, required
      - `filter_list` object — The list of filters, which define the entities.
        - `context_list` Filter[] — The list of context filters. These are OR filters. The scope-expression-list defines the context, and the filter works in conjunction with the entity-expression-list. Note - the absence of a scope expression in a filter implies global context.
          - `entity_filter_expression_list` EntityFilterExpression[], required — A list of Entity filter expressions.
            - `operator` string, required — The operator in the filter expression.
            - `left_hand_side` object, required — The LHS of the filter expression - the entity type.
              - …
            - `right_hand_side` RightHandSide, required — The right hand side of an expression.
              - …
          - `scope_filter_expression_list` ScopeFilterExpression[] — A list of Scope filter expressions.
            - `operator` string, required — The operator of the filter expression.
            - `left_hand_side` string, required — The LHS of the filter expression - the scope type.
            - `right_hand_side` RightHandSide, required — The right hand side of an expression.
              - …
    - `description` string — The description of the association of a role to a user in a given context.
  - `api_version` string, required
  - `metadata` AccessControlPolicyMetadata, required — The access_control_policy kind metadata
    - `last_update_time` string, date-time — UTC date and time in RFC-3339 format when access_control_policy was last updated
    - `kind` string, required — The kind name
    - `uuid` string, UUID — access_control_policy uuid
    - `spec_version` integer — Version number of the latest spec.
    - `creation_time` string, date-time — UTC date and time in RFC-3339 format when access_control_policy was created
    - `spec_hash` string — Hash of the spec. This will be returned from server.
    - `should_force_translate` boolean — Applied on Prism Central only. Indicate whether force to translate the spec of the fanout request to fit the target cluster API schema.
    - `owner_reference` UserReference — The reference to a user
      - `kind` string, required — The kind name
      - `name` string
      - `uuid` string, UUID, required
    - `categories` object — Categories for the access_control_policy
    - `name` string — access_control_policy name

## Other responses

- `404` — Invalid UUID provided
- `default` — Internal Error

---

[API](https://skmtc.net/nutanix/apis/nutanix-intentful-api.md) · [All operations](https://skmtc.net/nutanix/apis/nutanix-intentful-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nutanix/nutanix-intentful-api/revisions/40395083ab31/schema)