BedrockAgentCoreControl / Client / get_policy_summary

get_policy_summary

BedrockAgentCoreControl.Client.get_policy_summary(**kwargs)

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.

See also: AWS API Documentation

Request Syntax

response = client.get_policy_summary(
    policyEngineId='string',
    policyId='string'
)

Parameters:

• policyEngineId (string) –

  [REQUIRED]

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

• policyId (string) –

  [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.

Return type:

dict

Returns:

Response Syntax

{
    'policyId': 'string',
    'name': 'string',
    'policyEngineId': 'string',
    'createdAt': datetime(2015, 1, 1),
    'updatedAt': datetime(2015, 1, 1),
    'policyArn': 'string',
    'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'CREATE_FAILED'|'UPDATE_FAILED'|'DELETE_FAILED'
}

Response Structure

• (dict) –

  • policyId (string) –

    The unique identifier of the policy.

  • name (string) –

    The customer-assigned name of the policy.

  • policyEngineId (string) –

    The identifier of the policy engine that manages this policy.

  • createdAt (datetime) –

    The timestamp when the policy was originally created.

  • updatedAt (datetime) –

    The timestamp when the policy was last modified.

  • policyArn (string) –

    The Amazon Resource Name (ARN) of the policy.

  • status (string) –

    The current status of the policy.

Exceptions

• BedrockAgentCoreControl.Client.exceptions.AccessDeniedException

• BedrockAgentCoreControl.Client.exceptions.ValidationException

• BedrockAgentCoreControl.Client.exceptions.ThrottlingException

• BedrockAgentCoreControl.Client.exceptions.ResourceNotFoundException

• BedrockAgentCoreControl.Client.exceptions.InternalServerException