v1

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

Retrieves a metadata-only summary of a specific policy without decrypting customer content. This lightweight read operation returns resource identifiers, status, and timestamps, but does not include the policy definition, description, or status reasons. Because this operation does not require access to the customer's KMS key, it is suitable for resource discovery, inventory, and integration scenarios where only metadata is needed.

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

Path parameters

policyEngineIdstring required

The identifier of the policy engine that manages the policy to retrieve the summary for.

policyIdstring required

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

Response

Success

policyIdstring required

The unique identifier of the policy.

namestring required

The customer-assigned name of the policy.

policyEngineIdstring required

The identifier of the policy engine that manages this 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.

policyArnstring required

The Amazon Resource Name (ARN) of the policy.

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.