BedrockAgentCoreControl / Client / get_policy_engine_summary

get_policy_engine_summary¶

BedrockAgentCoreControl.Client.get_policy_engine_summary(**kwargs)¶

Retrieves a metadata-only summary of a specific policy engine without decrypting customer content. This lightweight read operation returns resource identifiers, status, timestamps, and the encryption key ARN, but does not include the 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.

Request Syntax

response = client.get_policy_engine_summary(
    policyEngineId='string'
)

Parameters:

policyEngineId (string) –

[REQUIRED]

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

Return type:

dict

Returns:

Response Syntax

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

Response Structure

(dict) –
- policyEngineId (string) –
  
  The unique identifier of the policy engine.
- name (string) –
  
  The customer-assigned name of the policy engine.
- createdAt (datetime) –
  
  The timestamp when the policy engine was originally created.
- updatedAt (datetime) –
  
  The timestamp when the policy engine was last modified.
- policyEngineArn (string) –
  
  The Amazon Resource Name (ARN) of the policy engine.
- status (string) –
  
  The current status of the policy engine.
- encryptionKeyArn (string) –
  
  The Amazon Resource Name (ARN) of the KMS key used to encrypt the policy engine data.

Exceptions

BedrockAgentCoreControl.Client.exceptions.AccessDeniedException
BedrockAgentCoreControl.Client.exceptions.ValidationException
BedrockAgentCoreControl.Client.exceptions.ThrottlingException
BedrockAgentCoreControl.Client.exceptions.ResourceNotFoundException
BedrockAgentCoreControl.Client.exceptions.InternalServerException