BedrockAgentCoreControl / Client / delete_policy_engine

delete_policy_engine¶

BedrockAgentCoreControl.Client.delete_policy_engine(**kwargs)¶

Deletes an existing policy engine from the AgentCore Policy system. The policy engine must not have any associated policies before deletion. Once deleted, the policy engine and all its configurations become unavailable for policy management and evaluation. This is an asynchronous operation. Use the GetPolicyEngine operation to poll the status field to track completion.

Request Syntax

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

Parameters:

policyEngineId (string) –

[REQUIRED]

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

Return type:

dict

Returns:

Response Syntax

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

Response Structure

(dict) –
- policyEngineId (string) –
  
  The unique identifier of the policy engine being deleted. This confirms which policy engine the deletion operation targets.
- name (string) –
  
  The customer-assigned name of the deleted policy engine.
- description (string) –
  
  The human-readable description of the deleted policy engine.
- createdAt (datetime) –
  
  The timestamp when the deleted policy engine was originally created.
- updatedAt (datetime) –
  
  The timestamp when the deleted policy engine was last modified before deletion. This tracks the final state of the policy engine before it was removed from the system.
- policyEngineArn (string) –
  
  The Amazon Resource Name (ARN) of the deleted policy engine. This globally unique identifier confirms which policy engine resource was successfully removed.
- status (string) –
  
  The status of the policy engine deletion operation. This provides status about any issues that occurred during the deletion process.
- statusReasons (list) –
  
  Additional information about the deletion status. This provides details about the deletion process or any issues that may have occurred.
  - (string) –

Exceptions

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