Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141531,219979.8 KB

Retrieves detailed information about a specific policy within the AgentCore Policy system. This operation returns the complete policy definition, metadata, and current status, allowing administrators to review and manage policy configurations.

get/policy-engines/{policyEngineId}/policies/{policyId}

Path parameters

policyEngineIdstring required

The identifier of the policy engine that manages the policy to be retrieved.

policyIdstring required

The unique identifier of the policy to be retrieved. This must be a valid policy ID that exists within the specified policy engine.

Response

Success

policyIdstring required

The unique identifier of the retrieved policy. This matches the policy ID provided in the request and serves as the system identifier for the policy.

namestring required

The customer-assigned name of the policy. This is the human-readable identifier that was specified when the policy was created.

policyEngineIdstring required

The identifier of the policy engine that manages this policy. This confirms the policy engine context for the retrieved policy.

createdAtstring date-time required

The timestamp when the policy was originally created.

updatedAtstring date-time required

The timestamp when the policy was last modified. This tracks the most recent changes to the policy configuration.

policyArnstring required

The Amazon Resource Name (ARN) of the policy. This globally unique identifier can be used for cross-service references and IAM policy statements.

status'CREATING' | 'ACTIVE' | 'UPDATING' | 'DELETING' | 'CREATE_FAILED' | 'UPDATE_FAILED' | 'DELETE_FAILED' required

The current status of the policy.

enforcementMode'ACTIVE' | 'LOG_ONLY'

The current enforcement mode of the policy.

descriptionstring password

The human-readable description of the policy's purpose and functionality. This helps administrators understand and manage the policy.

statusReasonsString[] required

Additional information about the policy status. This provides details about any failures or the current state of the policy.