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.
Parameters:
-
policy_engine_id
(ResourceId)
–
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.
Raises:
Source code in docs_src/capo_bedrock_agentcore_control/_services/bedrock_agent_core_control.py
| def get_policy_engine_summary(
self,
policy_engine_id: "capo_bedrock_agentcore_control.types.resource_id.ResourceId",
*,
config_overrides: Optional[BedrockAgentCoreControlClientConfig] = None,
) -> "capo_bedrock_agentcore_control.types.get_policy_engine_summary_response.GetPolicyEngineSummaryResponse":
"""<p>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.</p>
Args:
policy_engine_id: <p>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.</p>
Raises:
capo_bedrock_agentcore_control.errors.access_denied_exception.AccessDeniedException: <p>This exception is thrown when a request is denied per access permissions</p>
capo_bedrock_agentcore_control.errors.internal_server_exception.InternalServerException: <p>This exception is thrown if there was an unexpected error during processing of request</p>
capo_bedrock_agentcore_control.errors.resource_not_found_exception.ResourceNotFoundException: <p>This exception is thrown when a resource referenced by the operation does not exist</p>
capo_bedrock_agentcore_control.errors.throttling_exception.ThrottlingException: <p>This exception is thrown when the number of requests exceeds the limit</p>
capo_bedrock_agentcore_control.errors.validation_exception.ValidationException: <p>The input fails to satisfy the constraints specified by the service.</p>
capo_bedrock_agentcore_control.errors.UnknownServiceError: The service returned an error code this client does not model.
"""
def _handler(
req: "OperationRequest[capo_bedrock_agentcore_control.types.get_policy_engine_summary_request.GetPolicyEngineSummaryRequest]",
) -> OperationResponse[
"capo_bedrock_agentcore_control.types.get_policy_engine_summary_response.GetPolicyEngineSummaryResponse"
]:
import capo_bedrock_agentcore_control._operations.amazon_bedrock_agent_core_control.get_policy_engine_summary
output, http_response = (
capo_bedrock_agentcore_control._operations.amazon_bedrock_agent_core_control.get_policy_engine_summary.get_policy_engine_summary(
req.options, req.input
)
)
return OperationResponse(output=output, response=http_response)
interceptors_, options_ = self.operation_options(
config_overrides, OperationLogging("GetPolicyEngineSummary")
)
input_: capo_bedrock_agentcore_control.types.get_policy_engine_summary_request.GetPolicyEngineSummaryRequest = {
"policy_engine_id": policy_engine_id
}
response = execute_pipeline(
OperationRequest(input=input_, options=options_),
handler=_handler,
interceptors=list(interceptors_),
)
response.response.close()
return response.output
|