BedrockAgentCoreControlPlaneFrontingLayer ***************************************** Client ====== class BedrockAgentCoreControlPlaneFrontingLayer.Client A low-level client representing Amazon Bedrock Agent Core Control Plane Fronting Layer Note: Amazon Bedrock AgentCore is in preview release and is subject to change. Amazon Bedrock Agent Core Control is a service that enables you to manage memory resources for your Amazon Bedrock agents. Use this API to create, retrieve, update, and delete memory resources and their associated memory strategies. Memory resources enable your agents to store and retrieve information from conversations and interactions. import boto3 client = boto3.client('bedrock-agentcore-control') These are the available methods: * can_paginate * close * create_agent_runtime * create_agent_runtime_endpoint * create_api_key_credential_provider * create_browser * create_code_interpreter * create_gateway * create_gateway_target * create_memory * create_oauth2_credential_provider * create_workload_identity * delete_agent_runtime * delete_agent_runtime_endpoint * delete_api_key_credential_provider * delete_browser * delete_code_interpreter * delete_gateway * delete_gateway_target * delete_memory * delete_oauth2_credential_provider * delete_workload_identity * get_agent_runtime * get_agent_runtime_endpoint * get_api_key_credential_provider * get_browser * get_code_interpreter * get_gateway * get_gateway_target * get_memory * get_oauth2_credential_provider * get_paginator * get_token_vault * get_waiter * get_workload_identity * list_agent_runtime_endpoints * list_agent_runtime_versions * list_agent_runtimes * list_api_key_credential_providers * list_browsers * list_code_interpreters * list_gateway_targets * list_gateways * list_memories * list_oauth2_credential_providers * list_workload_identities * set_token_vault_cmk * update_agent_runtime * update_agent_runtime_endpoint * update_api_key_credential_provider * update_gateway * update_gateway_target * update_memory * update_oauth2_credential_provider * update_workload_identity Paginators ========== Paginators are available on a client instance via the "get_paginator" method. For more detailed instructions and examples on the usage of paginators, see the paginators user guide. The available paginators are: * ListAgentRuntimeEndpoints * ListAgentRuntimeVersions * ListAgentRuntimes * ListApiKeyCredentialProviders * ListBrowsers * ListCodeInterpreters * ListGatewayTargets * ListGateways * ListMemories * ListOauth2CredentialProviders * ListWorkloadIdentities Waiters ======= Waiters are available on a client instance via the "get_waiter" method. For more detailed instructions and examples on the usage or waiters, see the waiters user guide. The available waiters are: * MemoryCreated BedrockAgentCoreControlPlaneFrontingLayer / Waiter / MemoryCreated MemoryCreated ************* class BedrockAgentCoreControlPlaneFrontingLayer.Waiter.MemoryCreated waiter = client.get_waiter('memory_created') wait(**kwargs) Polls "BedrockAgentCoreControlPlaneFrontingLayer.Client.get_memory()" every 2 seconds until a successful state is reached. An error is raised after 60 failed checks. See also: AWS API Documentation **Request Syntax** waiter.wait( memoryId='string', WaiterConfig={ 'Delay': 123, 'MaxAttempts': 123 } ) Parameters: * **memoryId** (*string*) -- **[REQUIRED]** The unique identifier of the memory to retrieve. * **WaiterConfig** (*dict*) -- A dictionary that provides parameters to control waiting behavior. * **Delay** *(integer) --* The amount of time in seconds to wait between attempts. Default: 2 * **MaxAttempts** *(integer) --* The maximum number of attempts to be made. Default: 60 Returns: None BedrockAgentCoreControlPlaneFrontingLayer / Paginator / ListAgentRuntimeVersions ListAgentRuntimeVersions ************************ class BedrockAgentCoreControlPlaneFrontingLayer.Paginator.ListAgentRuntimeVersions paginator = client.get_paginator('list_agent_runtime_versions') paginate(**kwargs) Creates an iterator that will paginate through responses from " BedrockAgentCoreControlPlaneFrontingLayer.Client.list_agent_run time_versions()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( agentRuntimeId='string', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **agentRuntimeId** (*string*) -- **[REQUIRED]** The unique identifier of the agent runtime to list versions for. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'agentRuntimes': [ { 'agentRuntimeArn': 'string', 'agentRuntimeId': 'string', 'agentRuntimeVersion': 'string', 'agentRuntimeName': 'string', 'description': 'string', 'lastUpdatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **agentRuntimes** *(list) --* The list of agent runtime versions. * *(dict) --* Contains information about an agent runtime. An agent runtime is the execution environment for a Amazon Bedrock Agent. * **agentRuntimeArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime. * **agentRuntimeId** *(string) --* The unique identifier of the agent runtime. * **agentRuntimeVersion** *(string) --* The version of the agent runtime. * **agentRuntimeName** *(string) --* The name of the agent runtime. * **description** *(string) --* The description of the agent runtime. * **lastUpdatedAt** *(datetime) --* The timestamp when the agent runtime was last updated. * **status** *(string) --* The current status of the agent runtime. * **NextToken** *(string) --* A token to resume pagination. BedrockAgentCoreControlPlaneFrontingLayer / Paginator / ListAgentRuntimeEndpoints ListAgentRuntimeEndpoints ************************* class BedrockAgentCoreControlPlaneFrontingLayer.Paginator.ListAgentRuntimeEndpoints paginator = client.get_paginator('list_agent_runtime_endpoints') paginate(**kwargs) Creates an iterator that will paginate through responses from " BedrockAgentCoreControlPlaneFrontingLayer.Client.list_agent_run time_endpoints()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( agentRuntimeId='string', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **agentRuntimeId** (*string*) -- **[REQUIRED]** The unique identifier of the agent runtime to list endpoints for. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'runtimeEndpoints': [ { 'name': 'string', 'liveVersion': 'string', 'targetVersion': 'string', 'agentRuntimeEndpointArn': 'string', 'agentRuntimeArn': 'string', 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING', 'id': 'string', 'description': 'string', 'createdAt': datetime(2015, 1, 1), 'lastUpdatedAt': datetime(2015, 1, 1) }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **runtimeEndpoints** *(list) --* The list of agent runtime endpoints. * *(dict) --* Contains information about an agent runtime endpoint. An endpoint provides a way to connect to and interact with an agent runtime. * **name** *(string) --* The name of the agent runtime endpoint. * **liveVersion** *(string) --* The live version of the agent runtime endpoint. This is the version that is currently serving requests. * **targetVersion** *(string) --* The target version of the agent runtime endpoint. This is the version that the endpoint is being updated to. * **agentRuntimeEndpointArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime endpoint. * **agentRuntimeArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime associated with the endpoint. * **status** *(string) --* The current status of the agent runtime endpoint. * **id** *(string) --* The unique identifier of the agent runtime endpoint. * **description** *(string) --* The description of the agent runtime endpoint. * **createdAt** *(datetime) --* The timestamp when the agent runtime endpoint was created. * **lastUpdatedAt** *(datetime) --* The timestamp when the agent runtime endpoint was last updated. * **NextToken** *(string) --* A token to resume pagination. BedrockAgentCoreControlPlaneFrontingLayer / Paginator / ListGatewayTargets ListGatewayTargets ****************** class BedrockAgentCoreControlPlaneFrontingLayer.Paginator.ListGatewayTargets paginator = client.get_paginator('list_gateway_targets') paginate(**kwargs) Creates an iterator that will paginate through responses from " BedrockAgentCoreControlPlaneFrontingLayer.Client.list_gateway_t argets()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( gatewayIdentifier='string', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **gatewayIdentifier** (*string*) -- **[REQUIRED]** The identifier of the gateway to list targets for. This can be either the gateway ID or the gateway ARN. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'items': [ { 'targetId': 'string', 'name': 'string', 'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED', 'description': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1) }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **items** *(list) --* The list of Gateway Target summaries. * *(dict) --* Contains summary information about a gateway target. A target represents an endpoint that the gateway can connect to. * **targetId** *(string) --* The unique identifier of the target. * **name** *(string) --* The name of the target. * **status** *(string) --* The current status of the target. * **description** *(string) --* The description of the target. * **createdAt** *(datetime) --* The timestamp when the target was created. * **updatedAt** *(datetime) --* The timestamp when the target was last updated. * **NextToken** *(string) --* A token to resume pagination. BedrockAgentCoreControlPlaneFrontingLayer / Paginator / ListAgentRuntimes ListAgentRuntimes ***************** class BedrockAgentCoreControlPlaneFrontingLayer.Paginator.ListAgentRuntimes paginator = client.get_paginator('list_agent_runtimes') paginate(**kwargs) Creates an iterator that will paginate through responses from " BedrockAgentCoreControlPlaneFrontingLayer.Client.list_agent_run times()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max- items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'agentRuntimes': [ { 'agentRuntimeArn': 'string', 'agentRuntimeId': 'string', 'agentRuntimeVersion': 'string', 'agentRuntimeName': 'string', 'description': 'string', 'lastUpdatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **agentRuntimes** *(list) --* The list of agent runtimes. * *(dict) --* Contains information about an agent runtime. An agent runtime is the execution environment for a Amazon Bedrock Agent. * **agentRuntimeArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime. * **agentRuntimeId** *(string) --* The unique identifier of the agent runtime. * **agentRuntimeVersion** *(string) --* The version of the agent runtime. * **agentRuntimeName** *(string) --* The name of the agent runtime. * **description** *(string) --* The description of the agent runtime. * **lastUpdatedAt** *(datetime) --* The timestamp when the agent runtime was last updated. * **status** *(string) --* The current status of the agent runtime. * **NextToken** *(string) --* A token to resume pagination. BedrockAgentCoreControlPlaneFrontingLayer / Paginator / ListWorkloadIdentities ListWorkloadIdentities ********************** class BedrockAgentCoreControlPlaneFrontingLayer.Paginator.ListWorkloadIdentities paginator = client.get_paginator('list_workload_identities') paginate(**kwargs) Creates an iterator that will paginate through responses from " BedrockAgentCoreControlPlaneFrontingLayer.Client.list_workload_ identities()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max- items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'workloadIdentities': [ { 'name': 'string', 'workloadIdentityArn': 'string' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **workloadIdentities** *(list) --* The list of workload identities. * *(dict) --* Contains information about a workload identity. * **name** *(string) --* The name of the workload identity. * **workloadIdentityArn** *(string) --* The Amazon Resource Name (ARN) of the workload identity. * **NextToken** *(string) --* A token to resume pagination. BedrockAgentCoreControlPlaneFrontingLayer / Paginator / ListCodeInterpreters ListCodeInterpreters ******************** class BedrockAgentCoreControlPlaneFrontingLayer.Paginator.ListCodeInterpreters paginator = client.get_paginator('list_code_interpreters') paginate(**kwargs) Creates an iterator that will paginate through responses from " BedrockAgentCoreControlPlaneFrontingLayer.Client.list_code_inte rpreters()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( type='SYSTEM'|'CUSTOM', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **type** (*string*) -- The type of code interpreters to list. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'codeInterpreterSummaries': [ { 'codeInterpreterId': 'string', 'codeInterpreterArn': 'string', 'name': 'string', 'description': 'string', 'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED', 'createdAt': datetime(2015, 1, 1), 'lastUpdatedAt': datetime(2015, 1, 1) }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **codeInterpreterSummaries** *(list) --* The list of code interpreter summaries. * *(dict) --* Contains summary information about a code interpreter. A code interpreter enables Amazon Bedrock Agent to execute code. * **codeInterpreterId** *(string) --* The unique identifier of the code interpreter. * **codeInterpreterArn** *(string) --* The Amazon Resource Name (ARN) of the code interpreter. * **name** *(string) --* The name of the code interpreter. * **description** *(string) --* The description of the code interpreter. * **status** *(string) --* The current status of the code interpreter. * **createdAt** *(datetime) --* The timestamp when the code interpreter was created. * **lastUpdatedAt** *(datetime) --* The timestamp when the code interpreter was last updated. * **NextToken** *(string) --* A token to resume pagination. BedrockAgentCoreControlPlaneFrontingLayer / Paginator / ListApiKeyCredentialProviders ListApiKeyCredentialProviders ***************************** class BedrockAgentCoreControlPlaneFrontingLayer.Paginator.ListApiKeyCredentialProviders paginator = client.get_paginator('list_api_key_credential_providers') paginate(**kwargs) Creates an iterator that will paginate through responses from " BedrockAgentCoreControlPlaneFrontingLayer.Client.list_api_key_c redential_providers()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max- items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'credentialProviders': [ { 'name': 'string', 'credentialProviderArn': 'string', 'createdTime': datetime(2015, 1, 1), 'lastUpdatedTime': datetime(2015, 1, 1) }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **credentialProviders** *(list) --* The list of API key credential providers. * *(dict) --* Contains information about an API key credential provider. * **name** *(string) --* The name of the API key credential provider. * **credentialProviderArn** *(string) --* The Amazon Resource Name (ARN) of the API key credential provider. * **createdTime** *(datetime) --* The timestamp when the API key credential provider was created. * **lastUpdatedTime** *(datetime) --* The timestamp when the API key credential provider was last updated. * **NextToken** *(string) --* A token to resume pagination. BedrockAgentCoreControlPlaneFrontingLayer / Paginator / ListGateways ListGateways ************ class BedrockAgentCoreControlPlaneFrontingLayer.Paginator.ListGateways paginator = client.get_paginator('list_gateways') paginate(**kwargs) Creates an iterator that will paginate through responses from " BedrockAgentCoreControlPlaneFrontingLayer.Client.list_gateways( )". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max- items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'items': [ { 'gatewayId': 'string', 'name': 'string', 'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED', 'description': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'authorizerType': 'CUSTOM_JWT', 'protocolType': 'MCP' }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **items** *(list) --* The list of Gateway summaries. * *(dict) --* Contains summary information about a gateway. * **gatewayId** *(string) --* The unique identifier of the gateway. * **name** *(string) --* The name of the gateway. * **status** *(string) --* The current status of the gateway. * **description** *(string) --* The description of the gateway. * **createdAt** *(datetime) --* The timestamp when the gateway was created. * **updatedAt** *(datetime) --* The timestamp when the gateway was last updated. * **authorizerType** *(string) --* The type of authorizer used by the gateway. * **protocolType** *(string) --* The protocol type used by the gateway. * **NextToken** *(string) --* A token to resume pagination. BedrockAgentCoreControlPlaneFrontingLayer / Paginator / ListOauth2CredentialProviders ListOauth2CredentialProviders ***************************** class BedrockAgentCoreControlPlaneFrontingLayer.Paginator.ListOauth2CredentialProviders paginator = client.get_paginator('list_oauth2_credential_providers') paginate(**kwargs) Creates an iterator that will paginate through responses from " BedrockAgentCoreControlPlaneFrontingLayer.Client.list_oauth2_cr edential_providers()". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max- items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'credentialProviders': [ { 'name': 'string', 'credentialProviderVendor': 'GoogleOauth2'|'GithubOauth2'|'SlackOauth2'|'SalesforceOauth2'|'MicrosoftOauth2'|'CustomOauth2', 'credentialProviderArn': 'string', 'createdTime': datetime(2015, 1, 1), 'lastUpdatedTime': datetime(2015, 1, 1) }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **credentialProviders** *(list) --* The list of OAuth2 credential providers. * *(dict) --* Contains information about an OAuth2 credential provider. * **name** *(string) --* The name of the OAuth2 credential provider. * **credentialProviderVendor** *(string) --* The vendor of the OAuth2 credential provider. * **credentialProviderArn** *(string) --* The Amazon Resource Name (ARN) of the OAuth2 credential provider. * **createdTime** *(datetime) --* The timestamp when the OAuth2 credential provider was created. * **lastUpdatedTime** *(datetime) --* The timestamp when the OAuth2 credential provider was last updated. * **NextToken** *(string) --* A token to resume pagination. BedrockAgentCoreControlPlaneFrontingLayer / Paginator / ListBrowsers ListBrowsers ************ class BedrockAgentCoreControlPlaneFrontingLayer.Paginator.ListBrowsers paginator = client.get_paginator('list_browsers') paginate(**kwargs) Creates an iterator that will paginate through responses from " BedrockAgentCoreControlPlaneFrontingLayer.Client.list_browsers( )". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( type='SYSTEM'|'CUSTOM', PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: * **type** (*string*) -- The type of browsers to list. If not specified, all browser types are returned. * **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max-items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'browserSummaries': [ { 'browserId': 'string', 'browserArn': 'string', 'name': 'string', 'description': 'string', 'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED', 'createdAt': datetime(2015, 1, 1), 'lastUpdatedAt': datetime(2015, 1, 1) }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **browserSummaries** *(list) --* The list of browser summaries. * *(dict) --* Contains summary information about a browser. A browser enables Amazon Bedrock Agent to interact with web content. * **browserId** *(string) --* The unique identifier of the browser. * **browserArn** *(string) --* The Amazon Resource Name (ARN) of the browser. * **name** *(string) --* The name of the browser. * **description** *(string) --* The description of the browser. * **status** *(string) --* The current status of the browser. * **createdAt** *(datetime) --* The timestamp when the browser was created. * **lastUpdatedAt** *(datetime) --* The timestamp when the browser was last updated. * **NextToken** *(string) --* A token to resume pagination. BedrockAgentCoreControlPlaneFrontingLayer / Paginator / ListMemories ListMemories ************ class BedrockAgentCoreControlPlaneFrontingLayer.Paginator.ListMemories paginator = client.get_paginator('list_memories') paginate(**kwargs) Creates an iterator that will paginate through responses from " BedrockAgentCoreControlPlaneFrontingLayer.Client.list_memories( )". See also: AWS API Documentation **Request Syntax** response_iterator = paginator.paginate( PaginationConfig={ 'MaxItems': 123, 'PageSize': 123, 'StartingToken': 'string' } ) Parameters: **PaginationConfig** (*dict*) -- A dictionary that provides parameters to control pagination. * **MaxItems** *(integer) --* The total number of items to return. If the total number of items available is more than the value specified in max- items then a "NextToken" will be provided in the output that you can use to resume pagination. * **PageSize** *(integer) --* The size of each page. * **StartingToken** *(string) --* A token to specify where to start paginating. This is the "NextToken" from a previous response. Return type: dict Returns: **Response Syntax** { 'memories': [ { 'arn': 'string', 'id': 'string', 'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1) }, ], 'NextToken': 'string' } **Response Structure** * *(dict) --* * **memories** *(list) --* The list of memory summaries. * *(dict) --* Contains summary information about a memory resource. * **arn** *(string) --* The Amazon Resource Name (ARN) of the memory. * **id** *(string) --* The unique identifier of the memory. * **status** *(string) --* The current status of the memory. * **createdAt** *(datetime) --* The timestamp when the memory was created. * **updatedAt** *(datetime) --* The timestamp when the memory was last updated. * **NextToken** *(string) --* A token to resume pagination. BedrockAgentCoreControlPlaneFrontingLayer / Client / list_oauth2_credential_providers list_oauth2_credential_providers ******************************** BedrockAgentCoreControlPlaneFrontingLayer.Client.list_oauth2_credential_providers(**kwargs) Lists all OAuth2 credential providers in your account. See also: AWS API Documentation **Request Syntax** response = client.list_oauth2_credential_providers( nextToken='string', maxResults=123 ) Parameters: * **nextToken** (*string*) -- Pagination token. * **maxResults** (*integer*) -- Maximum number of results to return. Return type: dict Returns: **Response Syntax** { 'credentialProviders': [ { 'name': 'string', 'credentialProviderVendor': 'GoogleOauth2'|'GithubOauth2'|'SlackOauth2'|'SalesforceOauth2'|'MicrosoftOauth2'|'CustomOauth2', 'credentialProviderArn': 'string', 'createdTime': datetime(2015, 1, 1), 'lastUpdatedTime': datetime(2015, 1, 1) }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **credentialProviders** *(list) --* The list of OAuth2 credential providers. * *(dict) --* Contains information about an OAuth2 credential provider. * **name** *(string) --* The name of the OAuth2 credential provider. * **credentialProviderVendor** *(string) --* The vendor of the OAuth2 credential provider. * **credentialProviderArn** *(string) --* The Amazon Resource Name (ARN) of the OAuth2 credential provider. * **createdTime** *(datetime) --* The timestamp when the OAuth2 credential provider was created. * **lastUpdatedTime** *(datetime) --* The timestamp when the OAuth2 credential provider was last updated. * **nextToken** *(string) --* Pagination token for the next page of results. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / get_api_key_credential_provider get_api_key_credential_provider ******************************* BedrockAgentCoreControlPlaneFrontingLayer.Client.get_api_key_credential_provider(**kwargs) Retrieves information about an API key credential provider. See also: AWS API Documentation **Request Syntax** response = client.get_api_key_credential_provider( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the API key credential provider to retrieve. Return type: dict Returns: **Response Syntax** { 'apiKeySecretArn': { 'secretArn': 'string' }, 'name': 'string', 'credentialProviderArn': 'string', 'createdTime': datetime(2015, 1, 1), 'lastUpdatedTime': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **apiKeySecretArn** *(dict) --* The Amazon Resource Name (ARN) of the API key secret in AWS Secrets Manager. * **secretArn** *(string) --* The Amazon Resource Name (ARN) of the secret in AWS Secrets Manager. * **name** *(string) --* The name of the API key credential provider. * **credentialProviderArn** *(string) --* The Amazon Resource Name (ARN) of the API key credential provider. * **createdTime** *(datetime) --* The timestamp when the API key credential provider was created. * **lastUpdatedTime** *(datetime) --* The timestamp when the API key credential provider was last updated. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Dec ryptionFailure" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / get_paginator get_paginator ************* BedrockAgentCoreControlPlaneFrontingLayer.Client.get_paginator(operation_name) Create a paginator for an operation. Parameters: **operation_name** (*string*) -- The operation name. This is the same name as the method name on the client. For example, if the method name is "create_foo", and you'd normally invoke the operation as "client.create_foo(**kwargs)", if the "create_foo" operation can be paginated, you can use the call "client.get_paginator("create_foo")". Raises: **OperationNotPageableError** -- Raised if the operation is not pageable. You can use the "client.can_paginate" method to check if an operation is pageable. Return type: "botocore.paginate.Paginator" Returns: A paginator object. BedrockAgentCoreControlPlaneFrontingLayer / Client / get_gateway get_gateway *********** BedrockAgentCoreControlPlaneFrontingLayer.Client.get_gateway(**kwargs) Retrieves information about a specific Gateway. See also: AWS API Documentation **Request Syntax** response = client.get_gateway( gatewayIdentifier='string' ) Parameters: **gatewayIdentifier** (*string*) -- **[REQUIRED]** The identifier of the gateway to retrieve. This can be either the gateway ID or the gateway ARN. Return type: dict Returns: **Response Syntax** { 'gatewayArn': 'string', 'gatewayId': 'string', 'gatewayUrl': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED', 'statusReasons': [ 'string', ], 'name': 'string', 'description': 'string', 'roleArn': 'string', 'protocolType': 'MCP', 'protocolConfiguration': { 'mcp': { 'supportedVersions': [ 'string', ], 'instructions': 'string', 'searchType': 'SEMANTIC' } }, 'authorizerType': 'CUSTOM_JWT', 'authorizerConfiguration': { 'customJWTAuthorizer': { 'discoveryUrl': 'string', 'allowedAudience': [ 'string', ], 'allowedClients': [ 'string', ] } }, 'kmsKeyArn': 'string', 'workloadIdentityDetails': { 'workloadIdentityArn': 'string' }, 'exceptionLevel': 'DEBUG' } **Response Structure** * *(dict) --* * **gatewayArn** *(string) --* The Amazon Resource Name (ARN) of the Gateway. * **gatewayId** *(string) --* The unique identifier of the Gateway. * **gatewayUrl** *(string) --* An endpoint for invoking Gateway. * **createdAt** *(datetime) --* The timestamp when the Gateway was created. * **updatedAt** *(datetime) --* The timestamp when the Gateway was last updated. * **status** *(string) --* The current status of the Gateway. * **statusReasons** *(list) --* The reasons for the current status of the Gateway. * *(string) --* * **name** *(string) --* The name of the Gateway. * **description** *(string) --* The description of the Gateway. * **roleArn** *(string) --* The IAM role ARN that provides permissions for the Gateway. * **protocolType** *(string) --* Protocol applied to a Gateway. * **protocolConfiguration** *(dict) --* The configuration for a gateway protocol. This structure defines how the gateway communicates with external services. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "mcp". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **mcp** *(dict) --* The configuration for the Model Context Protocol (MCP). This protocol enables communication between Amazon Bedrock Agent and external tools. * **supportedVersions** *(list) --* The supported versions of the Model Context Protocol. This field specifies which versions of the protocol the gateway can use. * *(string) --* * **instructions** *(string) --* The instructions for using the Model Context Protocol gateway. These instructions provide guidance on how to interact with the gateway. * **searchType** *(string) --* The search type for the Model Context Protocol gateway. This field specifies how the gateway handles search operations. * **authorizerType** *(string) --* Authorizer type for the gateway. * **authorizerConfiguration** *(dict) --* The authorizer configuration for the Gateway. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "customJWTAuthorizer". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **customJWTAuthorizer** *(dict) --* The inbound JWT-based authorization, specifying how incoming requests should be authenticated. * **discoveryUrl** *(string) --* This URL is used to fetch OpenID Connect configuration or authorization server metadata for validating incoming tokens. * **allowedAudience** *(list) --* Represents individual audience values that are validated in the incoming JWT token validation process. * *(string) --* * **allowedClients** *(list) --* Represents individual client IDs that are validated in the incoming JWT token validation process. * *(string) --* * **kmsKeyArn** *(string) --* The ARN of the KMS key used to encrypt the Gateway. * **workloadIdentityDetails** *(dict) --* The workload identity details for the Gateway. * **workloadIdentityArn** *(string) --* The ARN associated with the workload identity. * **exceptionLevel** *(string) --* The verbosity of exception messages. Use DEBUG mode to see granular exception messages from a Gateway. If this parameter is not set, exception messages are by default sanitized for presentation to end users. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / create_gateway_target create_gateway_target ********************* BedrockAgentCoreControlPlaneFrontingLayer.Client.create_gateway_target(**kwargs) Creates a target for a gateway. A target defines an endpoint that the gateway can connect to. To create a target, you must specify the gateway identifier and target configuration. See also: AWS API Documentation **Request Syntax** response = client.create_gateway_target( gatewayIdentifier='string', name='string', description='string', clientToken='string', targetConfiguration={ 'mcp': { 'openApiSchema': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': 'string' }, 'smithyModel': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': 'string' }, 'lambda': { 'lambdaArn': 'string', 'toolSchema': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': [ { 'name': 'string', 'description': 'string', 'inputSchema': { 'type': 'string'|'number'|'object'|'array'|'boolean'|'integer', 'properties': { 'string': {'... recursive ...'} }, 'required': [ 'string', ], 'items': {'... recursive ...'}, 'description': 'string' }, 'outputSchema': { 'type': 'string'|'number'|'object'|'array'|'boolean'|'integer', 'properties': { 'string': {'... recursive ...'} }, 'required': [ 'string', ], 'items': {'... recursive ...'}, 'description': 'string' } }, ] } } } }, credentialProviderConfigurations=[ { 'credentialProviderType': 'GATEWAY_IAM_ROLE'|'OAUTH'|'API_KEY', 'credentialProvider': { 'oauthCredentialProvider': { 'providerArn': 'string', 'scopes': [ 'string', ], 'customParameters': { 'string': 'string' } }, 'apiKeyCredentialProvider': { 'providerArn': 'string', 'credentialParameterName': 'string', 'credentialPrefix': 'string', 'credentialLocation': 'HEADER'|'QUERY_PARAMETER' } } }, ] ) Parameters: * **gatewayIdentifier** (*string*) -- **[REQUIRED]** The identifier of the gateway to create a target for. This can be either the gateway ID or the gateway ARN. * **name** (*string*) -- **[REQUIRED]** The name of the gateway target. The name must be unique within the gateway. * **description** (*string*) -- The description of the gateway target. * **clientToken** (*string*) -- A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request but does not return an error. This field is autopopulated if not provided. * **targetConfiguration** (*dict*) -- **[REQUIRED]** The configuration settings for the target, including endpoint information and schema definitions. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "mcp". * **mcp** *(dict) --* The Model Context Protocol (MCP) configuration for the target. This configuration defines how the gateway uses MCP to communicate with the target. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "openApiSchema", "smithyModel", "lambda". * **openApiSchema** *(dict) --* The OpenAPI schema for the Model Context Protocol target. This schema defines the API structure of the target. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "s3", "inlinePayload". * **s3** *(dict) --* The Amazon S3 configuration for a gateway. This structure defines how the gateway accesses files in Amazon S3. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(string) --* The inline payload containing the API schema definition. * **smithyModel** *(dict) --* The Smithy model for the Model Context Protocol target. This model defines the API structure of the target using the Smithy specification. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "s3", "inlinePayload". * **s3** *(dict) --* The Amazon S3 configuration for a gateway. This structure defines how the gateway accesses files in Amazon S3. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(string) --* The inline payload containing the API schema definition. * **lambda** *(dict) --* The Lambda configuration for the Model Context Protocol target. This configuration defines how the gateway uses a Lambda function to communicate with the target. * **lambdaArn** *(string) --* **[REQUIRED]** The Amazon Resource Name (ARN) of the Lambda function. This function is invoked by the gateway to communicate with the target. * **toolSchema** *(dict) --* **[REQUIRED]** The tool schema for the Lambda function. This schema defines the structure of the tools that the Lambda function provides. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "s3", "inlinePayload". * **s3** *(dict) --* The Amazon S3 location of the tool schema. This location contains the schema definition file. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(list) --* The inline payload of the tool schema. This payload contains the schema definition directly in the request. * *(dict) --* A tool definition for a gateway target. This structure defines a tool that the target exposes through the Model Context Protocol. * **name** *(string) --* **[REQUIRED]** The name of the tool. This name identifies the tool in the Model Context Protocol. * **description** *(string) --* **[REQUIRED]** The description of the tool. This description provides information about the purpose and usage of the tool. * **inputSchema** *(dict) --* **[REQUIRED]** The input schema for the tool. This schema defines the structure of the input that the tool accepts. * **type** *(string) --* **[REQUIRED]** The type of the schema definition. This field specifies the data type of the schema. * **properties** *(dict) --* The properties of the schema definition. These properties define the fields in the schema. * *(string) --* * *(dict) --* A schema definition for a gateway target. This structure defines the structure of the API that the target exposes. * **required** *(list) --* The required fields in the schema definition. These fields must be provided when using the schema. * *(string) --* * **items** *(dict) --* The items in the schema definition. This field is used for array types to define the structure of the array elements. * **description** *(string) --* The description of the schema definition. This description provides information about the purpose and usage of the schema. * **outputSchema** *(dict) --* The output schema for the tool. This schema defines the structure of the output that the tool produces. * **type** *(string) --* **[REQUIRED]** The type of the schema definition. This field specifies the data type of the schema. * **properties** *(dict) --* The properties of the schema definition. These properties define the fields in the schema. * *(string) --* * *(dict) --* A schema definition for a gateway target. This structure defines the structure of the API that the target exposes. * **required** *(list) --* The required fields in the schema definition. These fields must be provided when using the schema. * *(string) --* * **items** *(dict) --* The items in the schema definition. This field is used for array types to define the structure of the array elements. * **description** *(string) --* The description of the schema definition. This description provides information about the purpose and usage of the schema. * **credentialProviderConfigurations** (*list*) -- **[REQUIRED]** The credential provider configurations for the target. These configurations specify how the gateway authenticates with the target endpoint. * *(dict) --* The configuration for a credential provider. This structure defines how the gateway authenticates with the target endpoint. * **credentialProviderType** *(string) --* **[REQUIRED]** The type of credential provider. This field specifies which authentication method the gateway uses. * **credentialProvider** *(dict) --* The credential provider. This field contains the specific configuration for the credential provider type. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "oauthCredentialProvider", "apiKeyCredentialProvider". * **oauthCredentialProvider** *(dict) --* The OAuth credential provider. This provider uses OAuth authentication to access the target endpoint. * **providerArn** *(string) --* **[REQUIRED]** The Amazon Resource Name (ARN) of the OAuth credential provider. This ARN identifies the provider in Amazon Web Services. * **scopes** *(list) --* **[REQUIRED]** The OAuth scopes for the credential provider. These scopes define the level of access requested from the OAuth provider. * *(string) --* * **customParameters** *(dict) --* The custom parameters for the OAuth credential provider. These parameters provide additional configuration for the OAuth authentication process. * *(string) --* * *(string) --* * **apiKeyCredentialProvider** *(dict) --* The API key credential provider. This provider uses an API key to authenticate with the target endpoint. * **providerArn** *(string) --* **[REQUIRED]** The Amazon Resource Name (ARN) of the API key credential provider. This ARN identifies the provider in Amazon Web Services. * **credentialParameterName** *(string) --* The name of the credential parameter for the API key. This parameter name is used when sending the API key to the target endpoint. * **credentialPrefix** *(string) --* The prefix for the API key credential. This prefix is added to the API key when sending it to the target endpoint. * **credentialLocation** *(string) --* The location of the API key credential. This field specifies where in the request the API key should be placed. Return type: dict Returns: **Response Syntax** { 'gatewayArn': 'string', 'targetId': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED', 'statusReasons': [ 'string', ], 'name': 'string', 'description': 'string', 'targetConfiguration': { 'mcp': { 'openApiSchema': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': 'string' }, 'smithyModel': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': 'string' }, 'lambda': { 'lambdaArn': 'string', 'toolSchema': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': [ { 'name': 'string', 'description': 'string', 'inputSchema': { 'type': 'string'|'number'|'object'|'array'|'boolean'|'integer', 'properties': { 'string': {'... recursive ...'} }, 'required': [ 'string', ], 'items': {'... recursive ...'}, 'description': 'string' }, 'outputSchema': { 'type': 'string'|'number'|'object'|'array'|'boolean'|'integer', 'properties': { 'string': {'... recursive ...'} }, 'required': [ 'string', ], 'items': {'... recursive ...'}, 'description': 'string' } }, ] } } } }, 'credentialProviderConfigurations': [ { 'credentialProviderType': 'GATEWAY_IAM_ROLE'|'OAUTH'|'API_KEY', 'credentialProvider': { 'oauthCredentialProvider': { 'providerArn': 'string', 'scopes': [ 'string', ], 'customParameters': { 'string': 'string' } }, 'apiKeyCredentialProvider': { 'providerArn': 'string', 'credentialParameterName': 'string', 'credentialPrefix': 'string', 'credentialLocation': 'HEADER'|'QUERY_PARAMETER' } } }, ] } **Response Structure** * *(dict) --* * **gatewayArn** *(string) --* The Amazon Resource Name (ARN) of the gateway. * **targetId** *(string) --* The unique identifier of the created target. * **createdAt** *(datetime) --* The timestamp when the target was created. * **updatedAt** *(datetime) --* The timestamp when the target was last updated. * **status** *(string) --* The current status of the target. * **statusReasons** *(list) --* The reasons for the current status of the target. * *(string) --* * **name** *(string) --* The name of the target. * **description** *(string) --* The description of the target. * **targetConfiguration** *(dict) --* The configuration settings for the target. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "mcp". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **mcp** *(dict) --* The Model Context Protocol (MCP) configuration for the target. This configuration defines how the gateway uses MCP to communicate with the target. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "openApiSchema", "smithyModel", "lambda". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **openApiSchema** *(dict) --* The OpenAPI schema for the Model Context Protocol target. This schema defines the API structure of the target. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "s3", "inlinePayload". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **s3** *(dict) --* The Amazon S3 configuration for a gateway. This structure defines how the gateway accesses files in Amazon S3. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(string) --* The inline payload containing the API schema definition. * **smithyModel** *(dict) --* The Smithy model for the Model Context Protocol target. This model defines the API structure of the target using the Smithy specification. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "s3", "inlinePayload". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **s3** *(dict) --* The Amazon S3 configuration for a gateway. This structure defines how the gateway accesses files in Amazon S3. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(string) --* The inline payload containing the API schema definition. * **lambda** *(dict) --* The Lambda configuration for the Model Context Protocol target. This configuration defines how the gateway uses a Lambda function to communicate with the target. * **lambdaArn** *(string) --* The Amazon Resource Name (ARN) of the Lambda function. This function is invoked by the gateway to communicate with the target. * **toolSchema** *(dict) --* The tool schema for the Lambda function. This schema defines the structure of the tools that the Lambda function provides. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "s3", "inlinePayload". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **s3** *(dict) --* The Amazon S3 location of the tool schema. This location contains the schema definition file. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(list) --* The inline payload of the tool schema. This payload contains the schema definition directly in the request. * *(dict) --* A tool definition for a gateway target. This structure defines a tool that the target exposes through the Model Context Protocol. * **name** *(string) --* The name of the tool. This name identifies the tool in the Model Context Protocol. * **description** *(string) --* The description of the tool. This description provides information about the purpose and usage of the tool. * **inputSchema** *(dict) --* The input schema for the tool. This schema defines the structure of the input that the tool accepts. * **type** *(string) --* The type of the schema definition. This field specifies the data type of the schema. * **properties** *(dict) --* The properties of the schema definition. These properties define the fields in the schema. * *(string) --* * *(dict) --* A schema definition for a gateway target. This structure defines the structure of the API that the target exposes. * **required** *(list) --* The required fields in the schema definition. These fields must be provided when using the schema. * *(string) --* * **items** *(dict) --* The items in the schema definition. This field is used for array types to define the structure of the array elements. * **description** *(string) --* The description of the schema definition. This description provides information about the purpose and usage of the schema. * **outputSchema** *(dict) --* The output schema for the tool. This schema defines the structure of the output that the tool produces. * **type** *(string) --* The type of the schema definition. This field specifies the data type of the schema. * **properties** *(dict) --* The properties of the schema definition. These properties define the fields in the schema. * *(string) --* * *(dict) --* A schema definition for a gateway target. This structure defines the structure of the API that the target exposes. * **required** *(list) --* The required fields in the schema definition. These fields must be provided when using the schema. * *(string) --* * **items** *(dict) --* The items in the schema definition. This field is used for array types to define the structure of the array elements. * **description** *(string) --* The description of the schema definition. This description provides information about the purpose and usage of the schema. * **credentialProviderConfigurations** *(list) --* The credential provider configurations for the target. * *(dict) --* The configuration for a credential provider. This structure defines how the gateway authenticates with the target endpoint. * **credentialProviderType** *(string) --* The type of credential provider. This field specifies which authentication method the gateway uses. * **credentialProvider** *(dict) --* The credential provider. This field contains the specific configuration for the credential provider type. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "oauthCredentialProvider", "apiKeyCredentialProvider". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **oauthCredentialProvider** *(dict) --* The OAuth credential provider. This provider uses OAuth authentication to access the target endpoint. * **providerArn** *(string) --* The Amazon Resource Name (ARN) of the OAuth credential provider. This ARN identifies the provider in Amazon Web Services. * **scopes** *(list) --* The OAuth scopes for the credential provider. These scopes define the level of access requested from the OAuth provider. * *(string) --* * **customParameters** *(dict) --* The custom parameters for the OAuth credential provider. These parameters provide additional configuration for the OAuth authentication process. * *(string) --* * *(string) --* * **apiKeyCredentialProvider** *(dict) --* The API key credential provider. This provider uses an API key to authenticate with the target endpoint. * **providerArn** *(string) --* The Amazon Resource Name (ARN) of the API key credential provider. This ARN identifies the provider in Amazon Web Services. * **credentialParameterName** *(string) --* The name of the credential parameter for the API key. This parameter name is used when sending the API key to the target endpoint. * **credentialPrefix** *(string) --* The prefix for the API key credential. This prefix is added to the API key when sending it to the target endpoint. * **credentialLocation** *(string) --* The location of the API key credential. This field specifies where in the request the API key should be placed. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / update_agent_runtime update_agent_runtime ******************** BedrockAgentCoreControlPlaneFrontingLayer.Client.update_agent_runtime(**kwargs) Updates an existing Amazon Secure Agent. See also: AWS API Documentation **Request Syntax** response = client.update_agent_runtime( agentRuntimeId='string', description='string', agentRuntimeArtifact={ 'containerConfiguration': { 'containerUri': 'string' } }, roleArn='string', networkConfiguration={ 'networkMode': 'PUBLIC' }, protocolConfiguration={ 'serverProtocol': 'MCP'|'HTTP' }, clientToken='string', environmentVariables={ 'string': 'string' }, authorizerConfiguration={ 'customJWTAuthorizer': { 'discoveryUrl': 'string', 'allowedAudience': [ 'string', ], 'allowedClients': [ 'string', ] } } ) Parameters: * **agentRuntimeId** (*string*) -- **[REQUIRED]** The unique identifier of the agent runtime to update. * **description** (*string*) -- The updated description of the agent runtime. * **agentRuntimeArtifact** (*dict*) -- **[REQUIRED]** The updated artifact of the agent runtime. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "containerConfiguration". * **containerConfiguration** *(dict) --* The container configuration for the agent artifact. * **containerUri** *(string) --* **[REQUIRED]** The ECR URI of the container. * **roleArn** (*string*) -- **[REQUIRED]** The updated IAM role ARN that provides permissions for the agent runtime. * **networkConfiguration** (*dict*) -- **[REQUIRED]** The updated network configuration for the agent runtime. * **networkMode** *(string) --* **[REQUIRED]** The network mode for the agent runtime. * **protocolConfiguration** (*dict*) -- The protocol configuration for an agent runtime. This structure defines how the agent runtime communicates with clients. * **serverProtocol** *(string) --* **[REQUIRED]** The server protocol for the agent runtime. This field specifies which protocol the agent runtime uses to communicate with clients. * **clientToken** (*string*) -- A unique, case-sensitive identifier to ensure idempotency of the request. This field is autopopulated if not provided. * **environmentVariables** (*dict*) -- Updated environment variables to set in the agent runtime environment. * *(string) --* * *(string) --* * **authorizerConfiguration** (*dict*) -- The updated authorizer configuration for the agent runtime. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "customJWTAuthorizer". * **customJWTAuthorizer** *(dict) --* The inbound JWT-based authorization, specifying how incoming requests should be authenticated. * **discoveryUrl** *(string) --* **[REQUIRED]** This URL is used to fetch OpenID Connect configuration or authorization server metadata for validating incoming tokens. * **allowedAudience** *(list) --* Represents individual audience values that are validated in the incoming JWT token validation process. * *(string) --* * **allowedClients** *(list) --* Represents individual client IDs that are validated in the incoming JWT token validation process. * *(string) --* Return type: dict Returns: **Response Syntax** { 'agentRuntimeArn': 'string', 'agentRuntimeId': 'string', 'workloadIdentityDetails': { 'workloadIdentityArn': 'string' }, 'agentRuntimeVersion': 'string', 'createdAt': datetime(2015, 1, 1), 'lastUpdatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING' } **Response Structure** * *(dict) --* * **agentRuntimeArn** *(string) --* The Amazon Resource Name (ARN) of the updated agent runtime. * **agentRuntimeId** *(string) --* The unique identifier of the updated agent runtime. * **workloadIdentityDetails** *(dict) --* The workload identity details for the updated agent runtime. * **workloadIdentityArn** *(string) --* The ARN associated with the workload identity. * **agentRuntimeVersion** *(string) --* The version of the updated agent runtime. * **createdAt** *(datetime) --* The timestamp when the agent runtime was created. * **lastUpdatedAt** *(datetime) --* The timestamp when the agent runtime was last updated. * **status** *(string) --* The current status of the updated agent runtime. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / delete_gateway_target delete_gateway_target ********************* BedrockAgentCoreControlPlaneFrontingLayer.Client.delete_gateway_target(**kwargs) Deletes a Gateway Target. See also: AWS API Documentation **Request Syntax** response = client.delete_gateway_target( gatewayIdentifier='string', targetId='string' ) Parameters: * **gatewayIdentifier** (*string*) -- **[REQUIRED]** The unique identifier of the Gateway associated with the target. * **targetId** (*string*) -- **[REQUIRED]** The unique identifier of the Gateway Target to delete. Return type: dict Returns: **Response Syntax** { 'gatewayArn': 'string', 'targetId': 'string', 'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED', 'statusReasons': [ 'string', ] } **Response Structure** * *(dict) --* * **gatewayArn** *(string) --* The Amazon Resource Name (ARN) of the Gateway. * **targetId** *(string) --* The unique identifier of the deleted Gateway Target. * **status** *(string) --* The current status of the Gateway Target deletion. * **statusReasons** *(list) --* The reasons for the current status of the Gateway Target deletion. * *(string) --* **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / get_browser get_browser *********** BedrockAgentCoreControlPlaneFrontingLayer.Client.get_browser(**kwargs) Gets information about a custom browser. See also: AWS API Documentation **Request Syntax** response = client.get_browser( browserId='string' ) Parameters: **browserId** (*string*) -- **[REQUIRED]** The unique identifier of the browser to retrieve. Return type: dict Returns: **Response Syntax** { 'browserId': 'string', 'browserArn': 'string', 'name': 'string', 'description': 'string', 'executionRoleArn': 'string', 'networkConfiguration': { 'networkMode': 'PUBLIC' }, 'recording': { 'enabled': True|False, 's3Location': { 'bucket': 'string', 'prefix': 'string' } }, 'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED', 'createdAt': datetime(2015, 1, 1), 'lastUpdatedAt': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **browserId** *(string) --* The unique identifier of the browser. * **browserArn** *(string) --* The Amazon Resource Name (ARN) of the browser. * **name** *(string) --* The name of the browser. * **description** *(string) --* The description of the browser. * **executionRoleArn** *(string) --* The IAM role ARN that provides permissions for the browser. * **networkConfiguration** *(dict) --* The network configuration for a browser. This structure defines how the browser connects to the network. * **networkMode** *(string) --* The network mode for the browser. This field specifies how the browser connects to the network. * **recording** *(dict) --* The recording configuration for a browser. This structure defines how browser sessions are recorded. * **enabled** *(boolean) --* Indicates whether recording is enabled for the browser. When set to true, browser sessions are recorded. * **s3Location** *(dict) --* The Amazon S3 location where browser recordings are stored. This location contains the recorded browser sessions. * **bucket** *(string) --* The name of the Amazon S3 bucket. This bucket contains the stored data. * **prefix** *(string) --* The prefix for objects in the Amazon S3 bucket. This prefix is added to the object keys to organize the data. * **status** *(string) --* The current status of the browser. * **createdAt** *(datetime) --* The timestamp when the browser was created. * **lastUpdatedAt** *(datetime) --* The timestamp when the browser was last updated. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / list_gateway_targets list_gateway_targets ******************** BedrockAgentCoreControlPlaneFrontingLayer.Client.list_gateway_targets(**kwargs) Lists all targets for a specific Gateway. See also: AWS API Documentation **Request Syntax** response = client.list_gateway_targets( gatewayIdentifier='string', maxResults=123, nextToken='string' ) Parameters: * **gatewayIdentifier** (*string*) -- **[REQUIRED]** The identifier of the gateway to list targets for. This can be either the gateway ID or the gateway ARN. * **maxResults** (*integer*) -- The maximum number of results to return in a single call. The default value is 10. The maximum value is 50. * **nextToken** (*string*) -- The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results. Return type: dict Returns: **Response Syntax** { 'items': [ { 'targetId': 'string', 'name': 'string', 'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED', 'description': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1) }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **items** *(list) --* The list of Gateway Target summaries. * *(dict) --* Contains summary information about a gateway target. A target represents an endpoint that the gateway can connect to. * **targetId** *(string) --* The unique identifier of the target. * **name** *(string) --* The name of the target. * **status** *(string) --* The current status of the target. * **description** *(string) --* The description of the target. * **createdAt** *(datetime) --* The timestamp when the target was created. * **updatedAt** *(datetime) --* The timestamp when the target was last updated. * **nextToken** *(string) --* Opaque continuation token for the next paginated response. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / get_agent_runtime_endpoint get_agent_runtime_endpoint ************************** BedrockAgentCoreControlPlaneFrontingLayer.Client.get_agent_runtime_endpoint(**kwargs) Gets information about an Amazon Secure AgentEndpoint. See also: AWS API Documentation **Request Syntax** response = client.get_agent_runtime_endpoint( agentRuntimeId='string', endpointName='string' ) Parameters: * **agentRuntimeId** (*string*) -- **[REQUIRED]** The unique identifier of the agent runtime associated with the endpoint. * **endpointName** (*string*) -- **[REQUIRED]** The name of the agent runtime endpoint to retrieve. Return type: dict Returns: **Response Syntax** { 'liveVersion': 'string', 'targetVersion': 'string', 'agentRuntimeEndpointArn': 'string', 'agentRuntimeArn': 'string', 'description': 'string', 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING', 'createdAt': datetime(2015, 1, 1), 'lastUpdatedAt': datetime(2015, 1, 1), 'failureReason': 'string', 'name': 'string', 'id': 'string' } **Response Structure** * *(dict) --* * **liveVersion** *(string) --* The currently deployed version of the agent runtime on the endpoint. * **targetVersion** *(string) --* The target version of the agent runtime for the endpoint. * **agentRuntimeEndpointArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime endpoint. * **agentRuntimeArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime. * **description** *(string) --* The description of the agent runtime endpoint. * **status** *(string) --* The current status of the agent runtime endpoint. * **createdAt** *(datetime) --* The timestamp when the agent runtime endpoint was created. * **lastUpdatedAt** *(datetime) --* The timestamp when the agent runtime endpoint was last updated. * **failureReason** *(string) --* The reason for failure if the agent runtime endpoint is in a failed state. * **name** *(string) --* The name of the agent runtime endpoint. * **id** *(string) --* The unique identifier of the agent runtime endpoint. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / delete_workload_identity delete_workload_identity ************************ BedrockAgentCoreControlPlaneFrontingLayer.Client.delete_workload_identity(**kwargs) Deletes a workload identity. See also: AWS API Documentation **Request Syntax** response = client.delete_workload_identity( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the workload identity to delete. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / can_paginate can_paginate ************ BedrockAgentCoreControlPlaneFrontingLayer.Client.can_paginate(operation_name) Check if an operation can be paginated. Parameters: **operation_name** (*string*) -- The operation name. This is the same name as the method name on the client. For example, if the method name is "create_foo", and you'd normally invoke the operation as "client.create_foo(**kwargs)", if the "create_foo" operation can be paginated, you can use the call "client.get_paginator("create_foo")". Returns: "True" if the operation can be paginated, "False" otherwise. BedrockAgentCoreControlPlaneFrontingLayer / Client / list_workload_identities list_workload_identities ************************ BedrockAgentCoreControlPlaneFrontingLayer.Client.list_workload_identities(**kwargs) Lists all workload identities in your account. See also: AWS API Documentation **Request Syntax** response = client.list_workload_identities( nextToken='string', maxResults=123 ) Parameters: * **nextToken** (*string*) -- Pagination token. * **maxResults** (*integer*) -- Maximum number of results to return. Return type: dict Returns: **Response Syntax** { 'workloadIdentities': [ { 'name': 'string', 'workloadIdentityArn': 'string' }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **workloadIdentities** *(list) --* The list of workload identities. * *(dict) --* Contains information about a workload identity. * **name** *(string) --* The name of the workload identity. * **workloadIdentityArn** *(string) --* The Amazon Resource Name (ARN) of the workload identity. * **nextToken** *(string) --* Pagination token for the next page of results. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / get_workload_identity get_workload_identity ********************* BedrockAgentCoreControlPlaneFrontingLayer.Client.get_workload_identity(**kwargs) Retrieves information about a workload identity. See also: AWS API Documentation **Request Syntax** response = client.get_workload_identity( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the workload identity to retrieve. Return type: dict Returns: **Response Syntax** { 'name': 'string', 'workloadIdentityArn': 'string', 'allowedResourceOauth2ReturnUrls': [ 'string', ], 'createdTime': datetime(2015, 1, 1), 'lastUpdatedTime': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **name** *(string) --* The name of the workload identity. * **workloadIdentityArn** *(string) --* The Amazon Resource Name (ARN) of the workload identity. * **allowedResourceOauth2ReturnUrls** *(list) --* The list of allowed OAuth2 return URLs for resources associated with this workload identity. * *(string) --* * **createdTime** *(datetime) --* The timestamp when the workload identity was created. * **lastUpdatedTime** *(datetime) --* The timestamp when the workload identity was last updated. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / get_memory get_memory ********** BedrockAgentCoreControlPlaneFrontingLayer.Client.get_memory(**kwargs) Retrieve an existing memory. See also: AWS API Documentation **Request Syntax** response = client.get_memory( memoryId='string' ) Parameters: **memoryId** (*string*) -- **[REQUIRED]** The unique identifier of the memory to retrieve. Return type: dict Returns: **Response Syntax** { 'memory': { 'arn': 'string', 'id': 'string', 'name': 'string', 'description': 'string', 'encryptionKeyArn': 'string', 'memoryExecutionRoleArn': 'string', 'eventExpiryDuration': 123, 'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING', 'failureReason': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'strategies': [ { 'strategyId': 'string', 'name': 'string', 'description': 'string', 'configuration': { 'type': 'SEMANTIC_OVERRIDE'|'SUMMARY_OVERRIDE'|'USER_PREFERENCE_OVERRIDE', 'extraction': { 'customExtractionConfiguration': { 'semanticExtractionOverride': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'userPreferenceExtractionOverride': { 'appendToPrompt': 'string', 'modelId': 'string' } } }, 'consolidation': { 'customConsolidationConfiguration': { 'semanticConsolidationOverride': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'summaryConsolidationOverride': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'userPreferenceConsolidationOverride': { 'appendToPrompt': 'string', 'modelId': 'string' } } } }, 'type': 'SEMANTIC'|'SUMMARIZATION'|'USER_PREFERENCE'|'CUSTOM', 'namespaces': [ 'string', ], 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'ACTIVE'|'DELETING'|'FAILED' }, ] } } **Response Structure** * *(dict) --* * **memory** *(dict) --* The retrieved memory details. * **arn** *(string) --* The Amazon Resource Name (ARN) of the memory. * **id** *(string) --* The unique identifier of the memory. * **name** *(string) --* The name of the memory. * **description** *(string) --* The description of the memory. * **encryptionKeyArn** *(string) --* The ARN of the KMS key used to encrypt the memory. * **memoryExecutionRoleArn** *(string) --* The ARN of the IAM role that provides permissions for the memory. * **eventExpiryDuration** *(integer) --* The number of days after which memory events will expire. * **status** *(string) --* The current status of the memory. * **failureReason** *(string) --* The reason for failure if the memory is in a failed state. * **createdAt** *(datetime) --* The timestamp when the memory was created. * **updatedAt** *(datetime) --* The timestamp when the memory was last updated. * **strategies** *(list) --* The list of memory strategies associated with this memory. * *(dict) --* Contains information about a memory strategy. * **strategyId** *(string) --* The unique identifier of the memory strategy. * **name** *(string) --* The name of the memory strategy. * **description** *(string) --* The description of the memory strategy. * **configuration** *(dict) --* The configuration of the memory strategy. * **type** *(string) --* The type of override for the strategy configuration. * **extraction** *(dict) --* The extraction configuration for the memory strategy. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "customExtractionConfiguration". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **customExtractionConfiguration** *(dict) --* The custom extraction configuration. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "semanticExtractionOverride", "userPreferenceExtractionOverride". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **semanticExtractionOverride** *(dict) --* The semantic extraction override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for semantic extraction. * **modelId** *(string) --* The model ID to use for semantic extraction. * **userPreferenceExtractionOverride** *(dict) --* The user preference extraction override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for user preference extraction. * **modelId** *(string) --* The model ID to use for user preference extraction. * **consolidation** *(dict) --* The consolidation configuration for the memory strategy. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "customConsolidationConfiguration". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **customConsolidationConfiguration** *(dict) --* The custom consolidation configuration. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "semanticConsolidationOverride", "summaryConsolidationOverride", "userPreferenceConsolidationOverride". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **semanticConsolidationOverride** *(dict) --* The semantic consolidation override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for semantic consolidation. * **modelId** *(string) --* The model ID to use for semantic consolidation. * **summaryConsolidationOverride** *(dict) --* The summary consolidation override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for summary consolidation. * **modelId** *(string) --* The model ID to use for summary consolidation. * **userPreferenceConsolidationOverride** *(dict) --* The user preference consolidation override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for user preference consolidation. * **modelId** *(string) --* The model ID to use for user preference consolidation. * **type** *(string) --* The type of the memory strategy. * **namespaces** *(list) --* The namespaces associated with the memory strategy. * *(string) --* * **createdAt** *(datetime) --* The timestamp when the memory strategy was created. * **updatedAt** *(datetime) --* The timestamp when the memory strategy was last updated. * **status** *(string) --* The current status of the memory strategy. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottledException" BedrockAgentCoreControlPlaneFrontingLayer / Client / delete_agent_runtime delete_agent_runtime ******************** BedrockAgentCoreControlPlaneFrontingLayer.Client.delete_agent_runtime(**kwargs) Deletes an Amazon Secure Agent. See also: AWS API Documentation **Request Syntax** response = client.delete_agent_runtime( agentRuntimeId='string' ) Parameters: **agentRuntimeId** (*string*) -- **[REQUIRED]** The unique identifier of the agent runtime to delete. Return type: dict Returns: **Response Syntax** { 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING' } **Response Structure** * *(dict) --* * **status** *(string) --* The current status of the agent runtime deletion. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / list_agent_runtime_endpoints list_agent_runtime_endpoints **************************** BedrockAgentCoreControlPlaneFrontingLayer.Client.list_agent_runtime_endpoints(**kwargs) Lists all endpoints for a specific Amazon Secure Agent. See also: AWS API Documentation **Request Syntax** response = client.list_agent_runtime_endpoints( agentRuntimeId='string', maxResults=123, nextToken='string' ) Parameters: * **agentRuntimeId** (*string*) -- **[REQUIRED]** The unique identifier of the agent runtime to list endpoints for. * **maxResults** (*integer*) -- The maximum number of results to return in the response. * **nextToken** (*string*) -- A token to retrieve the next page of results. Return type: dict Returns: **Response Syntax** { 'runtimeEndpoints': [ { 'name': 'string', 'liveVersion': 'string', 'targetVersion': 'string', 'agentRuntimeEndpointArn': 'string', 'agentRuntimeArn': 'string', 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING', 'id': 'string', 'description': 'string', 'createdAt': datetime(2015, 1, 1), 'lastUpdatedAt': datetime(2015, 1, 1) }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **runtimeEndpoints** *(list) --* The list of agent runtime endpoints. * *(dict) --* Contains information about an agent runtime endpoint. An endpoint provides a way to connect to and interact with an agent runtime. * **name** *(string) --* The name of the agent runtime endpoint. * **liveVersion** *(string) --* The live version of the agent runtime endpoint. This is the version that is currently serving requests. * **targetVersion** *(string) --* The target version of the agent runtime endpoint. This is the version that the endpoint is being updated to. * **agentRuntimeEndpointArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime endpoint. * **agentRuntimeArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime associated with the endpoint. * **status** *(string) --* The current status of the agent runtime endpoint. * **id** *(string) --* The unique identifier of the agent runtime endpoint. * **description** *(string) --* The description of the agent runtime endpoint. * **createdAt** *(datetime) --* The timestamp when the agent runtime endpoint was created. * **lastUpdatedAt** *(datetime) --* The timestamp when the agent runtime endpoint was last updated. * **nextToken** *(string) --* A token to retrieve the next page of results. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / delete_api_key_credential_provider delete_api_key_credential_provider ********************************** BedrockAgentCoreControlPlaneFrontingLayer.Client.delete_api_key_credential_provider(**kwargs) Deletes an API key credential provider. See also: AWS API Documentation **Request Syntax** response = client.delete_api_key_credential_provider( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the API key credential provider to delete. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / list_code_interpreters list_code_interpreters ********************** BedrockAgentCoreControlPlaneFrontingLayer.Client.list_code_interpreters(**kwargs) Lists all custom code interpreters in your account. See also: AWS API Documentation **Request Syntax** response = client.list_code_interpreters( maxResults=123, nextToken='string', type='SYSTEM'|'CUSTOM' ) Parameters: * **maxResults** (*integer*) -- The maximum number of results to return in the response. * **nextToken** (*string*) -- A token to retrieve the next page of results. * **type** (*string*) -- The type of code interpreters to list. Return type: dict Returns: **Response Syntax** { 'codeInterpreterSummaries': [ { 'codeInterpreterId': 'string', 'codeInterpreterArn': 'string', 'name': 'string', 'description': 'string', 'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED', 'createdAt': datetime(2015, 1, 1), 'lastUpdatedAt': datetime(2015, 1, 1) }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **codeInterpreterSummaries** *(list) --* The list of code interpreter summaries. * *(dict) --* Contains summary information about a code interpreter. A code interpreter enables Amazon Bedrock Agent to execute code. * **codeInterpreterId** *(string) --* The unique identifier of the code interpreter. * **codeInterpreterArn** *(string) --* The Amazon Resource Name (ARN) of the code interpreter. * **name** *(string) --* The name of the code interpreter. * **description** *(string) --* The description of the code interpreter. * **status** *(string) --* The current status of the code interpreter. * **createdAt** *(datetime) --* The timestamp when the code interpreter was created. * **lastUpdatedAt** *(datetime) --* The timestamp when the code interpreter was last updated. * **nextToken** *(string) --* A token to retrieve the next page of results. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / list_api_key_credential_providers list_api_key_credential_providers ********************************* BedrockAgentCoreControlPlaneFrontingLayer.Client.list_api_key_credential_providers(**kwargs) Lists all API key credential providers in your account. See also: AWS API Documentation **Request Syntax** response = client.list_api_key_credential_providers( nextToken='string', maxResults=123 ) Parameters: * **nextToken** (*string*) -- Pagination token. * **maxResults** (*integer*) -- Maximum number of results to return. Return type: dict Returns: **Response Syntax** { 'credentialProviders': [ { 'name': 'string', 'credentialProviderArn': 'string', 'createdTime': datetime(2015, 1, 1), 'lastUpdatedTime': datetime(2015, 1, 1) }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **credentialProviders** *(list) --* The list of API key credential providers. * *(dict) --* Contains information about an API key credential provider. * **name** *(string) --* The name of the API key credential provider. * **credentialProviderArn** *(string) --* The Amazon Resource Name (ARN) of the API key credential provider. * **createdTime** *(datetime) --* The timestamp when the API key credential provider was created. * **lastUpdatedTime** *(datetime) --* The timestamp when the API key credential provider was last updated. * **nextToken** *(string) --* Pagination token for the next page of results. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / get_oauth2_credential_provider get_oauth2_credential_provider ****************************** BedrockAgentCoreControlPlaneFrontingLayer.Client.get_oauth2_credential_provider(**kwargs) Retrieves information about an OAuth2 credential provider. See also: AWS API Documentation **Request Syntax** response = client.get_oauth2_credential_provider( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the OAuth2 credential provider to retrieve. Return type: dict Returns: **Response Syntax** { 'clientSecretArn': { 'secretArn': 'string' }, 'name': 'string', 'credentialProviderArn': 'string', 'credentialProviderVendor': 'GoogleOauth2'|'GithubOauth2'|'SlackOauth2'|'SalesforceOauth2'|'MicrosoftOauth2'|'CustomOauth2', 'oauth2ProviderConfigOutput': { 'customOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } } }, 'googleOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } } }, 'githubOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } } }, 'slackOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } } }, 'salesforceOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } } }, 'microsoftOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } } } }, 'createdTime': datetime(2015, 1, 1), 'lastUpdatedTime': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **clientSecretArn** *(dict) --* The Amazon Resource Name (ARN) of the client secret in AWS Secrets Manager. * **secretArn** *(string) --* The Amazon Resource Name (ARN) of the secret in AWS Secrets Manager. * **name** *(string) --* The name of the OAuth2 credential provider. * **credentialProviderArn** *(string) --* ARN of the credential provider requested. * **credentialProviderVendor** *(string) --* The vendor of the OAuth2 credential provider. * **oauth2ProviderConfigOutput** *(dict) --* The configuration output for the OAuth2 provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "customOauth2ProviderConfig", "googleOauth2ProviderConfig", "githubOauth2ProviderConfig", "slackOauth2ProviderConfig", "salesforceOauth2ProviderConfig", "microsoftOauth2ProviderConfig". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **customOauth2ProviderConfig** *(dict) --* The output configuration for a custom OAuth2 provider. * **oauthDiscovery** *(dict) --* The OAuth2 discovery information for the custom provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "discoveryUrl", "authorizationServerMetadata". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **googleOauth2ProviderConfig** *(dict) --* The output configuration for a Google OAuth2 provider. * **oauthDiscovery** *(dict) --* The OAuth2 discovery information for the Google provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "discoveryUrl", "authorizationServerMetadata". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **githubOauth2ProviderConfig** *(dict) --* The output configuration for a GitHub OAuth2 provider. * **oauthDiscovery** *(dict) --* The OAuth2 discovery information for the GitHub provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "discoveryUrl", "authorizationServerMetadata". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **slackOauth2ProviderConfig** *(dict) --* The output configuration for a Slack OAuth2 provider. * **oauthDiscovery** *(dict) --* The OAuth2 discovery information for the Slack provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "discoveryUrl", "authorizationServerMetadata". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **salesforceOauth2ProviderConfig** *(dict) --* The output configuration for a Salesforce OAuth2 provider. * **oauthDiscovery** *(dict) --* The OAuth2 discovery information for the Salesforce provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "discoveryUrl", "authorizationServerMetadata". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **microsoftOauth2ProviderConfig** *(dict) --* The output configuration for a Microsoft OAuth2 provider. * **oauthDiscovery** *(dict) --* The OAuth2 discovery information for the Microsoft provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "discoveryUrl", "authorizationServerMetadata". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **createdTime** *(datetime) --* The timestamp when the OAuth2 credential provider was created. * **lastUpdatedTime** *(datetime) --* The timestamp when the OAuth2 credential provider was last updated. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Dec ryptionFailure" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / create_api_key_credential_provider create_api_key_credential_provider ********************************** BedrockAgentCoreControlPlaneFrontingLayer.Client.create_api_key_credential_provider(**kwargs) Creates a new API key credential provider. See also: AWS API Documentation **Request Syntax** response = client.create_api_key_credential_provider( name='string', apiKey='string' ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the API key credential provider. The name must be unique within your account. * **apiKey** (*string*) -- **[REQUIRED]** The API key to use for authentication. This value is encrypted and stored securely. Return type: dict Returns: **Response Syntax** { 'apiKeySecretArn': { 'secretArn': 'string' }, 'name': 'string', 'credentialProviderArn': 'string' } **Response Structure** * *(dict) --* * **apiKeySecretArn** *(dict) --* The Amazon Resource Name (ARN) of the secret containing the API key. * **secretArn** *(string) --* The Amazon Resource Name (ARN) of the secret in AWS Secrets Manager. * **name** *(string) --* The name of the created API key credential provider. * **credentialProviderArn** *(string) --* The Amazon Resource Name (ARN) of the created API key credential provider. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceLimitExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Dec ryptionFailure" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Enc ryptionFailure" BedrockAgentCoreControlPlaneFrontingLayer / Client / get_waiter get_waiter ********** BedrockAgentCoreControlPlaneFrontingLayer.Client.get_waiter(waiter_name) Returns an object that can wait for some condition. Parameters: **waiter_name** (*str*) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters. Returns: The specified waiter object. Return type: "botocore.waiter.Waiter" BedrockAgentCoreControlPlaneFrontingLayer / Client / update_agent_runtime_endpoint update_agent_runtime_endpoint ***************************** BedrockAgentCoreControlPlaneFrontingLayer.Client.update_agent_runtime_endpoint(**kwargs) Updates an existing Amazon Secure AgentEndpoint. See also: AWS API Documentation **Request Syntax** response = client.update_agent_runtime_endpoint( agentRuntimeId='string', endpointName='string', agentRuntimeVersion='string', description='string', clientToken='string' ) Parameters: * **agentRuntimeId** (*string*) -- **[REQUIRED]** The unique identifier of the agent runtime associated with the endpoint. * **endpointName** (*string*) -- **[REQUIRED]** The name of the agent runtime endpoint to update. * **agentRuntimeVersion** (*string*) -- The updated version of the agent runtime for the endpoint. * **description** (*string*) -- The updated description of the agent runtime endpoint. * **clientToken** (*string*) -- A unique, case-sensitive identifier to ensure idempotency of the request. This field is autopopulated if not provided. Return type: dict Returns: **Response Syntax** { 'liveVersion': 'string', 'targetVersion': 'string', 'agentRuntimeEndpointArn': 'string', 'agentRuntimeArn': 'string', 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING', 'createdAt': datetime(2015, 1, 1), 'lastUpdatedAt': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **liveVersion** *(string) --* The currently deployed version of the agent runtime on the endpoint. * **targetVersion** *(string) --* The target version of the agent runtime for the endpoint. * **agentRuntimeEndpointArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime endpoint. * **agentRuntimeArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime. * **status** *(string) --* The current status of the updated agent runtime endpoint. * **createdAt** *(datetime) --* The timestamp when the agent runtime endpoint was created. * **lastUpdatedAt** *(datetime) --* The timestamp when the agent runtime endpoint was last updated. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / list_agent_runtimes list_agent_runtimes ******************* BedrockAgentCoreControlPlaneFrontingLayer.Client.list_agent_runtimes(**kwargs) Lists all Amazon Secure Agents in your account. See also: AWS API Documentation **Request Syntax** response = client.list_agent_runtimes( maxResults=123, nextToken='string' ) Parameters: * **maxResults** (*integer*) -- The maximum number of results to return in the response. * **nextToken** (*string*) -- A token to retrieve the next page of results. Return type: dict Returns: **Response Syntax** { 'agentRuntimes': [ { 'agentRuntimeArn': 'string', 'agentRuntimeId': 'string', 'agentRuntimeVersion': 'string', 'agentRuntimeName': 'string', 'description': 'string', 'lastUpdatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING' }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **agentRuntimes** *(list) --* The list of agent runtimes. * *(dict) --* Contains information about an agent runtime. An agent runtime is the execution environment for a Amazon Bedrock Agent. * **agentRuntimeArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime. * **agentRuntimeId** *(string) --* The unique identifier of the agent runtime. * **agentRuntimeVersion** *(string) --* The version of the agent runtime. * **agentRuntimeName** *(string) --* The name of the agent runtime. * **description** *(string) --* The description of the agent runtime. * **lastUpdatedAt** *(datetime) --* The timestamp when the agent runtime was last updated. * **status** *(string) --* The current status of the agent runtime. * **nextToken** *(string) --* A token to retrieve the next page of results. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / get_agent_runtime get_agent_runtime ***************** BedrockAgentCoreControlPlaneFrontingLayer.Client.get_agent_runtime(**kwargs) Gets an Amazon Secure Agent. See also: AWS API Documentation **Request Syntax** response = client.get_agent_runtime( agentRuntimeId='string', agentRuntimeVersion='string' ) Parameters: * **agentRuntimeId** (*string*) -- **[REQUIRED]** The unique identifier of the agent runtime to retrieve. * **agentRuntimeVersion** (*string*) -- The version of the agent runtime to retrieve. Return type: dict Returns: **Response Syntax** { 'agentRuntimeArn': 'string', 'workloadIdentityDetails': { 'workloadIdentityArn': 'string' }, 'agentRuntimeName': 'string', 'description': 'string', 'agentRuntimeId': 'string', 'agentRuntimeVersion': 'string', 'createdAt': datetime(2015, 1, 1), 'lastUpdatedAt': datetime(2015, 1, 1), 'roleArn': 'string', 'agentRuntimeArtifact': { 'containerConfiguration': { 'containerUri': 'string' } }, 'networkConfiguration': { 'networkMode': 'PUBLIC' }, 'protocolConfiguration': { 'serverProtocol': 'MCP'|'HTTP' }, 'environmentVariables': { 'string': 'string' }, 'authorizerConfiguration': { 'customJWTAuthorizer': { 'discoveryUrl': 'string', 'allowedAudience': [ 'string', ], 'allowedClients': [ 'string', ] } }, 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING' } **Response Structure** * *(dict) --* * **agentRuntimeArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime. * **workloadIdentityDetails** *(dict) --* The workload identity details for the agent runtime. * **workloadIdentityArn** *(string) --* The ARN associated with the workload identity. * **agentRuntimeName** *(string) --* The name of the agent runtime. * **description** *(string) --* The description of the agent runtime. * **agentRuntimeId** *(string) --* The unique identifier of the agent runtime. * **agentRuntimeVersion** *(string) --* The version of the agent runtime. * **createdAt** *(datetime) --* The timestamp when the agent runtime was created. * **lastUpdatedAt** *(datetime) --* The timestamp when the agent runtime was last updated. * **roleArn** *(string) --* The IAM role ARN that provides permissions for the agent runtime. * **agentRuntimeArtifact** *(dict) --* The artifact of the agent runtime. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "containerConfiguration". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **containerConfiguration** *(dict) --* The container configuration for the agent artifact. * **containerUri** *(string) --* The ECR URI of the container. * **networkConfiguration** *(dict) --* The network configuration for the agent runtime. * **networkMode** *(string) --* The network mode for the agent runtime. * **protocolConfiguration** *(dict) --* The protocol configuration for an agent runtime. This structure defines how the agent runtime communicates with clients. * **serverProtocol** *(string) --* The server protocol for the agent runtime. This field specifies which protocol the agent runtime uses to communicate with clients. * **environmentVariables** *(dict) --* Environment variables set in the agent runtime environment. * *(string) --* * *(string) --* * **authorizerConfiguration** *(dict) --* The authorizer configuration for the agent runtime. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "customJWTAuthorizer". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **customJWTAuthorizer** *(dict) --* The inbound JWT-based authorization, specifying how incoming requests should be authenticated. * **discoveryUrl** *(string) --* This URL is used to fetch OpenID Connect configuration or authorization server metadata for validating incoming tokens. * **allowedAudience** *(list) --* Represents individual audience values that are validated in the incoming JWT token validation process. * *(string) --* * **allowedClients** *(list) --* Represents individual client IDs that are validated in the incoming JWT token validation process. * *(string) --* * **status** *(string) --* The current status of the agent runtime. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / list_agent_runtime_versions list_agent_runtime_versions *************************** BedrockAgentCoreControlPlaneFrontingLayer.Client.list_agent_runtime_versions(**kwargs) Lists all versions of a specific Amazon Secure Agent. See also: AWS API Documentation **Request Syntax** response = client.list_agent_runtime_versions( agentRuntimeId='string', maxResults=123, nextToken='string' ) Parameters: * **agentRuntimeId** (*string*) -- **[REQUIRED]** The unique identifier of the agent runtime to list versions for. * **maxResults** (*integer*) -- The maximum number of results to return in the response. * **nextToken** (*string*) -- A token to retrieve the next page of results. Return type: dict Returns: **Response Syntax** { 'agentRuntimes': [ { 'agentRuntimeArn': 'string', 'agentRuntimeId': 'string', 'agentRuntimeVersion': 'string', 'agentRuntimeName': 'string', 'description': 'string', 'lastUpdatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING' }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **agentRuntimes** *(list) --* The list of agent runtime versions. * *(dict) --* Contains information about an agent runtime. An agent runtime is the execution environment for a Amazon Bedrock Agent. * **agentRuntimeArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime. * **agentRuntimeId** *(string) --* The unique identifier of the agent runtime. * **agentRuntimeVersion** *(string) --* The version of the agent runtime. * **agentRuntimeName** *(string) --* The name of the agent runtime. * **description** *(string) --* The description of the agent runtime. * **lastUpdatedAt** *(datetime) --* The timestamp when the agent runtime was last updated. * **status** *(string) --* The current status of the agent runtime. * **nextToken** *(string) --* A token to retrieve the next page of results. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / update_workload_identity update_workload_identity ************************ BedrockAgentCoreControlPlaneFrontingLayer.Client.update_workload_identity(**kwargs) Updates an existing workload identity. See also: AWS API Documentation **Request Syntax** response = client.update_workload_identity( name='string', allowedResourceOauth2ReturnUrls=[ 'string', ] ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the workload identity to update. * **allowedResourceOauth2ReturnUrls** (*list*) -- The new list of allowed OAuth2 return URLs for resources associated with this workload identity. This list replaces the existing list. * *(string) --* Return type: dict Returns: **Response Syntax** { 'name': 'string', 'workloadIdentityArn': 'string', 'allowedResourceOauth2ReturnUrls': [ 'string', ], 'createdTime': datetime(2015, 1, 1), 'lastUpdatedTime': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **name** *(string) --* The name of the workload identity. * **workloadIdentityArn** *(string) --* The Amazon Resource Name (ARN) of the workload identity. * **allowedResourceOauth2ReturnUrls** *(list) --* The list of allowed OAuth2 return URLs for resources associated with this workload identity. * *(string) --* * **createdTime** *(datetime) --* The timestamp when the workload identity was created. * **lastUpdatedTime** *(datetime) --* The timestamp when the workload identity was last updated. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / update_gateway_target update_gateway_target ********************* BedrockAgentCoreControlPlaneFrontingLayer.Client.update_gateway_target(**kwargs) Updates an existing Gateway Target. See also: AWS API Documentation **Request Syntax** response = client.update_gateway_target( gatewayIdentifier='string', targetId='string', name='string', description='string', targetConfiguration={ 'mcp': { 'openApiSchema': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': 'string' }, 'smithyModel': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': 'string' }, 'lambda': { 'lambdaArn': 'string', 'toolSchema': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': [ { 'name': 'string', 'description': 'string', 'inputSchema': { 'type': 'string'|'number'|'object'|'array'|'boolean'|'integer', 'properties': { 'string': {'... recursive ...'} }, 'required': [ 'string', ], 'items': {'... recursive ...'}, 'description': 'string' }, 'outputSchema': { 'type': 'string'|'number'|'object'|'array'|'boolean'|'integer', 'properties': { 'string': {'... recursive ...'} }, 'required': [ 'string', ], 'items': {'... recursive ...'}, 'description': 'string' } }, ] } } } }, credentialProviderConfigurations=[ { 'credentialProviderType': 'GATEWAY_IAM_ROLE'|'OAUTH'|'API_KEY', 'credentialProvider': { 'oauthCredentialProvider': { 'providerArn': 'string', 'scopes': [ 'string', ], 'customParameters': { 'string': 'string' } }, 'apiKeyCredentialProvider': { 'providerArn': 'string', 'credentialParameterName': 'string', 'credentialPrefix': 'string', 'credentialLocation': 'HEADER'|'QUERY_PARAMETER' } } }, ] ) Parameters: * **gatewayIdentifier** (*string*) -- **[REQUIRED]** The unique identifier of the Gateway associated with the target. * **targetId** (*string*) -- **[REQUIRED]** The unique identifier of the Gateway Target to update. * **name** (*string*) -- **[REQUIRED]** The updated name for the Gateway Target. * **description** (*string*) -- The updated description for the Gateway Target. * **targetConfiguration** (*dict*) -- **[REQUIRED]** The configuration for a gateway target. This structure defines how the gateway connects to and interacts with the target endpoint. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "mcp". * **mcp** *(dict) --* The Model Context Protocol (MCP) configuration for the target. This configuration defines how the gateway uses MCP to communicate with the target. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "openApiSchema", "smithyModel", "lambda". * **openApiSchema** *(dict) --* The OpenAPI schema for the Model Context Protocol target. This schema defines the API structure of the target. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "s3", "inlinePayload". * **s3** *(dict) --* The Amazon S3 configuration for a gateway. This structure defines how the gateway accesses files in Amazon S3. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(string) --* The inline payload containing the API schema definition. * **smithyModel** *(dict) --* The Smithy model for the Model Context Protocol target. This model defines the API structure of the target using the Smithy specification. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "s3", "inlinePayload". * **s3** *(dict) --* The Amazon S3 configuration for a gateway. This structure defines how the gateway accesses files in Amazon S3. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(string) --* The inline payload containing the API schema definition. * **lambda** *(dict) --* The Lambda configuration for the Model Context Protocol target. This configuration defines how the gateway uses a Lambda function to communicate with the target. * **lambdaArn** *(string) --* **[REQUIRED]** The Amazon Resource Name (ARN) of the Lambda function. This function is invoked by the gateway to communicate with the target. * **toolSchema** *(dict) --* **[REQUIRED]** The tool schema for the Lambda function. This schema defines the structure of the tools that the Lambda function provides. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "s3", "inlinePayload". * **s3** *(dict) --* The Amazon S3 location of the tool schema. This location contains the schema definition file. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(list) --* The inline payload of the tool schema. This payload contains the schema definition directly in the request. * *(dict) --* A tool definition for a gateway target. This structure defines a tool that the target exposes through the Model Context Protocol. * **name** *(string) --* **[REQUIRED]** The name of the tool. This name identifies the tool in the Model Context Protocol. * **description** *(string) --* **[REQUIRED]** The description of the tool. This description provides information about the purpose and usage of the tool. * **inputSchema** *(dict) --* **[REQUIRED]** The input schema for the tool. This schema defines the structure of the input that the tool accepts. * **type** *(string) --* **[REQUIRED]** The type of the schema definition. This field specifies the data type of the schema. * **properties** *(dict) --* The properties of the schema definition. These properties define the fields in the schema. * *(string) --* * *(dict) --* A schema definition for a gateway target. This structure defines the structure of the API that the target exposes. * **required** *(list) --* The required fields in the schema definition. These fields must be provided when using the schema. * *(string) --* * **items** *(dict) --* The items in the schema definition. This field is used for array types to define the structure of the array elements. * **description** *(string) --* The description of the schema definition. This description provides information about the purpose and usage of the schema. * **outputSchema** *(dict) --* The output schema for the tool. This schema defines the structure of the output that the tool produces. * **type** *(string) --* **[REQUIRED]** The type of the schema definition. This field specifies the data type of the schema. * **properties** *(dict) --* The properties of the schema definition. These properties define the fields in the schema. * *(string) --* * *(dict) --* A schema definition for a gateway target. This structure defines the structure of the API that the target exposes. * **required** *(list) --* The required fields in the schema definition. These fields must be provided when using the schema. * *(string) --* * **items** *(dict) --* The items in the schema definition. This field is used for array types to define the structure of the array elements. * **description** *(string) --* The description of the schema definition. This description provides information about the purpose and usage of the schema. * **credentialProviderConfigurations** (*list*) -- **[REQUIRED]** The updated credential provider configurations for the Gateway Target. * *(dict) --* The configuration for a credential provider. This structure defines how the gateway authenticates with the target endpoint. * **credentialProviderType** *(string) --* **[REQUIRED]** The type of credential provider. This field specifies which authentication method the gateway uses. * **credentialProvider** *(dict) --* The credential provider. This field contains the specific configuration for the credential provider type. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "oauthCredentialProvider", "apiKeyCredentialProvider". * **oauthCredentialProvider** *(dict) --* The OAuth credential provider. This provider uses OAuth authentication to access the target endpoint. * **providerArn** *(string) --* **[REQUIRED]** The Amazon Resource Name (ARN) of the OAuth credential provider. This ARN identifies the provider in Amazon Web Services. * **scopes** *(list) --* **[REQUIRED]** The OAuth scopes for the credential provider. These scopes define the level of access requested from the OAuth provider. * *(string) --* * **customParameters** *(dict) --* The custom parameters for the OAuth credential provider. These parameters provide additional configuration for the OAuth authentication process. * *(string) --* * *(string) --* * **apiKeyCredentialProvider** *(dict) --* The API key credential provider. This provider uses an API key to authenticate with the target endpoint. * **providerArn** *(string) --* **[REQUIRED]** The Amazon Resource Name (ARN) of the API key credential provider. This ARN identifies the provider in Amazon Web Services. * **credentialParameterName** *(string) --* The name of the credential parameter for the API key. This parameter name is used when sending the API key to the target endpoint. * **credentialPrefix** *(string) --* The prefix for the API key credential. This prefix is added to the API key when sending it to the target endpoint. * **credentialLocation** *(string) --* The location of the API key credential. This field specifies where in the request the API key should be placed. Return type: dict Returns: **Response Syntax** { 'gatewayArn': 'string', 'targetId': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED', 'statusReasons': [ 'string', ], 'name': 'string', 'description': 'string', 'targetConfiguration': { 'mcp': { 'openApiSchema': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': 'string' }, 'smithyModel': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': 'string' }, 'lambda': { 'lambdaArn': 'string', 'toolSchema': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': [ { 'name': 'string', 'description': 'string', 'inputSchema': { 'type': 'string'|'number'|'object'|'array'|'boolean'|'integer', 'properties': { 'string': {'... recursive ...'} }, 'required': [ 'string', ], 'items': {'... recursive ...'}, 'description': 'string' }, 'outputSchema': { 'type': 'string'|'number'|'object'|'array'|'boolean'|'integer', 'properties': { 'string': {'... recursive ...'} }, 'required': [ 'string', ], 'items': {'... recursive ...'}, 'description': 'string' } }, ] } } } }, 'credentialProviderConfigurations': [ { 'credentialProviderType': 'GATEWAY_IAM_ROLE'|'OAUTH'|'API_KEY', 'credentialProvider': { 'oauthCredentialProvider': { 'providerArn': 'string', 'scopes': [ 'string', ], 'customParameters': { 'string': 'string' } }, 'apiKeyCredentialProvider': { 'providerArn': 'string', 'credentialParameterName': 'string', 'credentialPrefix': 'string', 'credentialLocation': 'HEADER'|'QUERY_PARAMETER' } } }, ] } **Response Structure** * *(dict) --* * **gatewayArn** *(string) --* The Amazon Resource Name (ARN) of the Gateway. * **targetId** *(string) --* The unique identifier of the updated Gateway Target. * **createdAt** *(datetime) --* The timestamp when the Gateway Target was created. * **updatedAt** *(datetime) --* The timestamp when the Gateway Target was last updated. * **status** *(string) --* The current status of the updated Gateway Target. * **statusReasons** *(list) --* The reasons for the current status of the updated Gateway Target. * *(string) --* * **name** *(string) --* The updated name of the Gateway Target. * **description** *(string) --* The updated description of the Gateway Target. * **targetConfiguration** *(dict) --* The configuration for a gateway target. This structure defines how the gateway connects to and interacts with the target endpoint. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "mcp". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **mcp** *(dict) --* The Model Context Protocol (MCP) configuration for the target. This configuration defines how the gateway uses MCP to communicate with the target. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "openApiSchema", "smithyModel", "lambda". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **openApiSchema** *(dict) --* The OpenAPI schema for the Model Context Protocol target. This schema defines the API structure of the target. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "s3", "inlinePayload". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **s3** *(dict) --* The Amazon S3 configuration for a gateway. This structure defines how the gateway accesses files in Amazon S3. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(string) --* The inline payload containing the API schema definition. * **smithyModel** *(dict) --* The Smithy model for the Model Context Protocol target. This model defines the API structure of the target using the Smithy specification. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "s3", "inlinePayload". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **s3** *(dict) --* The Amazon S3 configuration for a gateway. This structure defines how the gateway accesses files in Amazon S3. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(string) --* The inline payload containing the API schema definition. * **lambda** *(dict) --* The Lambda configuration for the Model Context Protocol target. This configuration defines how the gateway uses a Lambda function to communicate with the target. * **lambdaArn** *(string) --* The Amazon Resource Name (ARN) of the Lambda function. This function is invoked by the gateway to communicate with the target. * **toolSchema** *(dict) --* The tool schema for the Lambda function. This schema defines the structure of the tools that the Lambda function provides. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "s3", "inlinePayload". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **s3** *(dict) --* The Amazon S3 location of the tool schema. This location contains the schema definition file. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(list) --* The inline payload of the tool schema. This payload contains the schema definition directly in the request. * *(dict) --* A tool definition for a gateway target. This structure defines a tool that the target exposes through the Model Context Protocol. * **name** *(string) --* The name of the tool. This name identifies the tool in the Model Context Protocol. * **description** *(string) --* The description of the tool. This description provides information about the purpose and usage of the tool. * **inputSchema** *(dict) --* The input schema for the tool. This schema defines the structure of the input that the tool accepts. * **type** *(string) --* The type of the schema definition. This field specifies the data type of the schema. * **properties** *(dict) --* The properties of the schema definition. These properties define the fields in the schema. * *(string) --* * *(dict) --* A schema definition for a gateway target. This structure defines the structure of the API that the target exposes. * **required** *(list) --* The required fields in the schema definition. These fields must be provided when using the schema. * *(string) --* * **items** *(dict) --* The items in the schema definition. This field is used for array types to define the structure of the array elements. * **description** *(string) --* The description of the schema definition. This description provides information about the purpose and usage of the schema. * **outputSchema** *(dict) --* The output schema for the tool. This schema defines the structure of the output that the tool produces. * **type** *(string) --* The type of the schema definition. This field specifies the data type of the schema. * **properties** *(dict) --* The properties of the schema definition. These properties define the fields in the schema. * *(string) --* * *(dict) --* A schema definition for a gateway target. This structure defines the structure of the API that the target exposes. * **required** *(list) --* The required fields in the schema definition. These fields must be provided when using the schema. * *(string) --* * **items** *(dict) --* The items in the schema definition. This field is used for array types to define the structure of the array elements. * **description** *(string) --* The description of the schema definition. This description provides information about the purpose and usage of the schema. * **credentialProviderConfigurations** *(list) --* The updated credential provider configurations for the Gateway Target. * *(dict) --* The configuration for a credential provider. This structure defines how the gateway authenticates with the target endpoint. * **credentialProviderType** *(string) --* The type of credential provider. This field specifies which authentication method the gateway uses. * **credentialProvider** *(dict) --* The credential provider. This field contains the specific configuration for the credential provider type. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "oauthCredentialProvider", "apiKeyCredentialProvider". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **oauthCredentialProvider** *(dict) --* The OAuth credential provider. This provider uses OAuth authentication to access the target endpoint. * **providerArn** *(string) --* The Amazon Resource Name (ARN) of the OAuth credential provider. This ARN identifies the provider in Amazon Web Services. * **scopes** *(list) --* The OAuth scopes for the credential provider. These scopes define the level of access requested from the OAuth provider. * *(string) --* * **customParameters** *(dict) --* The custom parameters for the OAuth credential provider. These parameters provide additional configuration for the OAuth authentication process. * *(string) --* * *(string) --* * **apiKeyCredentialProvider** *(dict) --* The API key credential provider. This provider uses an API key to authenticate with the target endpoint. * **providerArn** *(string) --* The Amazon Resource Name (ARN) of the API key credential provider. This ARN identifies the provider in Amazon Web Services. * **credentialParameterName** *(string) --* The name of the credential parameter for the API key. This parameter name is used when sending the API key to the target endpoint. * **credentialPrefix** *(string) --* The prefix for the API key credential. This prefix is added to the API key when sending it to the target endpoint. * **credentialLocation** *(string) --* The location of the API key credential. This field specifies where in the request the API key should be placed. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / delete_memory delete_memory ************* BedrockAgentCoreControlPlaneFrontingLayer.Client.delete_memory(**kwargs) Deletes a memory. See also: AWS API Documentation **Request Syntax** response = client.delete_memory( clientToken='string', memoryId='string' ) Parameters: * **clientToken** (*string*) -- A client token is used for keeping track of idempotent requests. It can contain a session id which can be around 250 chars, combined with a unique AWS identifier. This field is autopopulated if not provided. * **memoryId** (*string*) -- **[REQUIRED]** The unique identifier of the memory to delete. Return type: dict Returns: **Response Syntax** { 'memoryId': 'string', 'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING' } **Response Structure** * *(dict) --* * **memoryId** *(string) --* The unique identifier of the deleted memory. * **status** *(string) --* The current status of the memory deletion. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottledException" BedrockAgentCoreControlPlaneFrontingLayer / Client / list_browsers list_browsers ************* BedrockAgentCoreControlPlaneFrontingLayer.Client.list_browsers(**kwargs) Lists all custom browsers in your account. See also: AWS API Documentation **Request Syntax** response = client.list_browsers( maxResults=123, nextToken='string', type='SYSTEM'|'CUSTOM' ) Parameters: * **maxResults** (*integer*) -- The maximum number of results to return in a single call. The default value is 10. The maximum value is 50. * **nextToken** (*string*) -- The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results. * **type** (*string*) -- The type of browsers to list. If not specified, all browser types are returned. Return type: dict Returns: **Response Syntax** { 'browserSummaries': [ { 'browserId': 'string', 'browserArn': 'string', 'name': 'string', 'description': 'string', 'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED', 'createdAt': datetime(2015, 1, 1), 'lastUpdatedAt': datetime(2015, 1, 1) }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **browserSummaries** *(list) --* The list of browser summaries. * *(dict) --* Contains summary information about a browser. A browser enables Amazon Bedrock Agent to interact with web content. * **browserId** *(string) --* The unique identifier of the browser. * **browserArn** *(string) --* The Amazon Resource Name (ARN) of the browser. * **name** *(string) --* The name of the browser. * **description** *(string) --* The description of the browser. * **status** *(string) --* The current status of the browser. * **createdAt** *(datetime) --* The timestamp when the browser was created. * **lastUpdatedAt** *(datetime) --* The timestamp when the browser was last updated. * **nextToken** *(string) --* A token to retrieve the next page of results. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / update_api_key_credential_provider update_api_key_credential_provider ********************************** BedrockAgentCoreControlPlaneFrontingLayer.Client.update_api_key_credential_provider(**kwargs) Updates an existing API key credential provider. See also: AWS API Documentation **Request Syntax** response = client.update_api_key_credential_provider( name='string', apiKey='string' ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the API key credential provider to update. * **apiKey** (*string*) -- **[REQUIRED]** The new API key to use for authentication. This value replaces the existing API key and is encrypted and stored securely. Return type: dict Returns: **Response Syntax** { 'apiKeySecretArn': { 'secretArn': 'string' }, 'name': 'string', 'credentialProviderArn': 'string', 'createdTime': datetime(2015, 1, 1), 'lastUpdatedTime': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **apiKeySecretArn** *(dict) --* The Amazon Resource Name (ARN) of the API key secret in AWS Secrets Manager. * **secretArn** *(string) --* The Amazon Resource Name (ARN) of the secret in AWS Secrets Manager. * **name** *(string) --* The name of the API key credential provider. * **credentialProviderArn** *(string) --* The Amazon Resource Name (ARN) of the API key credential provider. * **createdTime** *(datetime) --* The timestamp when the API key credential provider was created. * **lastUpdatedTime** *(datetime) --* The timestamp when the API key credential provider was last updated. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Dec ryptionFailure" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Enc ryptionFailure" BedrockAgentCoreControlPlaneFrontingLayer / Client / create_oauth2_credential_provider create_oauth2_credential_provider ********************************* BedrockAgentCoreControlPlaneFrontingLayer.Client.create_oauth2_credential_provider(**kwargs) Creates a new OAuth2 credential provider. See also: AWS API Documentation **Request Syntax** response = client.create_oauth2_credential_provider( name='string', credentialProviderVendor='GoogleOauth2'|'GithubOauth2'|'SlackOauth2'|'SalesforceOauth2'|'MicrosoftOauth2'|'CustomOauth2', oauth2ProviderConfigInput={ 'customOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } }, 'clientId': 'string', 'clientSecret': 'string' }, 'googleOauth2ProviderConfig': { 'clientId': 'string', 'clientSecret': 'string' }, 'githubOauth2ProviderConfig': { 'clientId': 'string', 'clientSecret': 'string' }, 'slackOauth2ProviderConfig': { 'clientId': 'string', 'clientSecret': 'string' }, 'salesforceOauth2ProviderConfig': { 'clientId': 'string', 'clientSecret': 'string' }, 'microsoftOauth2ProviderConfig': { 'clientId': 'string', 'clientSecret': 'string' } } ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the OAuth2 credential provider. The name must be unique within your account. * **credentialProviderVendor** (*string*) -- **[REQUIRED]** The vendor of the OAuth2 credential provider. This specifies which OAuth2 implementation to use. * **oauth2ProviderConfigInput** (*dict*) -- **[REQUIRED]** The configuration settings for the OAuth2 provider, including client ID, client secret, and other vendor-specific settings. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "customOauth2ProviderConfig", "googleOauth2ProviderConfig", "githubOauth2ProviderConfig", "slackOauth2ProviderConfig", "salesforceOauth2ProviderConfig", "microsoftOauth2ProviderConfig". * **customOauth2ProviderConfig** *(dict) --* The configuration for a custom OAuth2 provider. * **oauthDiscovery** *(dict) --* **[REQUIRED]** The OAuth2 discovery information for the custom provider. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "discoveryUrl", "authorizationServerMetadata". * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* **[REQUIRED]** The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* **[REQUIRED]** The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* **[REQUIRED]** The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **clientId** *(string) --* **[REQUIRED]** The client ID for the custom OAuth2 provider. * **clientSecret** *(string) --* **[REQUIRED]** The client secret for the custom OAuth2 provider. * **googleOauth2ProviderConfig** *(dict) --* The configuration for a Google OAuth2 provider. * **clientId** *(string) --* **[REQUIRED]** The client ID for the Google OAuth2 provider. * **clientSecret** *(string) --* **[REQUIRED]** The client secret for the Google OAuth2 provider. * **githubOauth2ProviderConfig** *(dict) --* The configuration for a GitHub OAuth2 provider. * **clientId** *(string) --* **[REQUIRED]** The client ID for the GitHub OAuth2 provider. * **clientSecret** *(string) --* **[REQUIRED]** The client secret for the GitHub OAuth2 provider. * **slackOauth2ProviderConfig** *(dict) --* The configuration for a Slack OAuth2 provider. * **clientId** *(string) --* **[REQUIRED]** The client ID for the Slack OAuth2 provider. * **clientSecret** *(string) --* **[REQUIRED]** The client secret for the Slack OAuth2 provider. * **salesforceOauth2ProviderConfig** *(dict) --* The configuration for a Salesforce OAuth2 provider. * **clientId** *(string) --* **[REQUIRED]** The client ID for the Salesforce OAuth2 provider. * **clientSecret** *(string) --* **[REQUIRED]** The client secret for the Salesforce OAuth2 provider. * **microsoftOauth2ProviderConfig** *(dict) --* The configuration for a Microsoft OAuth2 provider. * **clientId** *(string) --* **[REQUIRED]** The client ID for the Microsoft OAuth2 provider. * **clientSecret** *(string) --* **[REQUIRED]** The client secret for the Microsoft OAuth2 provider. Return type: dict Returns: **Response Syntax** { 'clientSecretArn': { 'secretArn': 'string' }, 'name': 'string', 'credentialProviderArn': 'string' } **Response Structure** * *(dict) --* * **clientSecretArn** *(dict) --* The Amazon Resource Name (ARN) of the client secret in AWS Secrets Manager. * **secretArn** *(string) --* The Amazon Resource Name (ARN) of the secret in AWS Secrets Manager. * **name** *(string) --* The name of the OAuth2 credential provider. * **credentialProviderArn** *(string) --* The Amazon Resource Name (ARN) of the OAuth2 credential provider. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceLimitExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Dec ryptionFailure" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Enc ryptionFailure" BedrockAgentCoreControlPlaneFrontingLayer / Client / create_memory create_memory ************* BedrockAgentCoreControlPlaneFrontingLayer.Client.create_memory(**kwargs) Creates a new memory. See also: AWS API Documentation **Request Syntax** response = client.create_memory( clientToken='string', name='string', description='string', encryptionKeyArn='string', memoryExecutionRoleArn='string', eventExpiryDuration=123, memoryStrategies=[ { 'semanticMemoryStrategy': { 'name': 'string', 'description': 'string', 'namespaces': [ 'string', ] }, 'summaryMemoryStrategy': { 'name': 'string', 'description': 'string', 'namespaces': [ 'string', ] }, 'userPreferenceMemoryStrategy': { 'name': 'string', 'description': 'string', 'namespaces': [ 'string', ] }, 'customMemoryStrategy': { 'name': 'string', 'description': 'string', 'namespaces': [ 'string', ], 'configuration': { 'semanticOverride': { 'extraction': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'consolidation': { 'appendToPrompt': 'string', 'modelId': 'string' } }, 'summaryOverride': { 'consolidation': { 'appendToPrompt': 'string', 'modelId': 'string' } }, 'userPreferenceOverride': { 'extraction': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'consolidation': { 'appendToPrompt': 'string', 'modelId': 'string' } } } } }, ] ) Parameters: * **clientToken** (*string*) -- A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request but does not return an error. This field is autopopulated if not provided. * **name** (*string*) -- **[REQUIRED]** The name of the memory. The name must be unique within your account. * **description** (*string*) -- The description of the memory. * **encryptionKeyArn** (*string*) -- The Amazon Resource Name (ARN) of the KMS key used to encrypt the memory data. * **memoryExecutionRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the IAM role that provides permissions for the memory to access Amazon Web Services services. * **eventExpiryDuration** (*integer*) -- **[REQUIRED]** The duration after which memory events expire. Specified as an ISO 8601 duration. * **memoryStrategies** (*list*) -- The memory strategies to use for this memory. Strategies define how information is extracted, processed, and consolidated. * *(dict) --* Contains input information for creating a memory strategy. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "semanticMemoryStrategy", "summaryMemoryStrategy", "userPreferenceMemoryStrategy", "customMemoryStrategy". * **semanticMemoryStrategy** *(dict) --* Input for creating a semantic memory strategy. * **name** *(string) --* **[REQUIRED]** The name of the semantic memory strategy. * **description** *(string) --* The description of the semantic memory strategy. * **namespaces** *(list) --* The namespaces associated with the semantic memory strategy. * *(string) --* * **summaryMemoryStrategy** *(dict) --* Input for creating a summary memory strategy. * **name** *(string) --* **[REQUIRED]** The name of the summary memory strategy. * **description** *(string) --* The description of the summary memory strategy. * **namespaces** *(list) --* The namespaces associated with the summary memory strategy. * *(string) --* * **userPreferenceMemoryStrategy** *(dict) --* Input for creating a user preference memory strategy. * **name** *(string) --* **[REQUIRED]** The name of the user preference memory strategy. * **description** *(string) --* The description of the user preference memory strategy. * **namespaces** *(list) --* The namespaces associated with the user preference memory strategy. * *(string) --* * **customMemoryStrategy** *(dict) --* Input for creating a custom memory strategy. * **name** *(string) --* **[REQUIRED]** The name of the custom memory strategy. * **description** *(string) --* The description of the custom memory strategy. * **namespaces** *(list) --* The namespaces associated with the custom memory strategy. * *(string) --* * **configuration** *(dict) --* The configuration for the custom memory strategy. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "semanticOverride", "summaryOverride", "userPreferenceOverride". * **semanticOverride** *(dict) --* The semantic override configuration for a custom memory strategy. * **extraction** *(dict) --* The extraction configuration for a semantic override. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for semantic extraction. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for semantic extraction. * **consolidation** *(dict) --* The consolidation configuration for a semantic override. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for semantic consolidation. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for semantic consolidation. * **summaryOverride** *(dict) --* The summary override configuration for a custom memory strategy. * **consolidation** *(dict) --* The consolidation configuration for a summary override. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for summary consolidation. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for summary consolidation. * **userPreferenceOverride** *(dict) --* The user preference override configuration for a custom memory strategy. * **extraction** *(dict) --* The extraction configuration for a user preference override. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for user preference extraction. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for user preference extraction. * **consolidation** *(dict) --* The consolidation configuration for a user preference override. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for user preference consolidation. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for user preference consolidation. Return type: dict Returns: **Response Syntax** { 'memory': { 'arn': 'string', 'id': 'string', 'name': 'string', 'description': 'string', 'encryptionKeyArn': 'string', 'memoryExecutionRoleArn': 'string', 'eventExpiryDuration': 123, 'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING', 'failureReason': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'strategies': [ { 'strategyId': 'string', 'name': 'string', 'description': 'string', 'configuration': { 'type': 'SEMANTIC_OVERRIDE'|'SUMMARY_OVERRIDE'|'USER_PREFERENCE_OVERRIDE', 'extraction': { 'customExtractionConfiguration': { 'semanticExtractionOverride': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'userPreferenceExtractionOverride': { 'appendToPrompt': 'string', 'modelId': 'string' } } }, 'consolidation': { 'customConsolidationConfiguration': { 'semanticConsolidationOverride': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'summaryConsolidationOverride': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'userPreferenceConsolidationOverride': { 'appendToPrompt': 'string', 'modelId': 'string' } } } }, 'type': 'SEMANTIC'|'SUMMARIZATION'|'USER_PREFERENCE'|'CUSTOM', 'namespaces': [ 'string', ], 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'ACTIVE'|'DELETING'|'FAILED' }, ] } } **Response Structure** * *(dict) --* * **memory** *(dict) --* The details of the created memory, including its ID, ARN, name, description, and configuration settings. * **arn** *(string) --* The Amazon Resource Name (ARN) of the memory. * **id** *(string) --* The unique identifier of the memory. * **name** *(string) --* The name of the memory. * **description** *(string) --* The description of the memory. * **encryptionKeyArn** *(string) --* The ARN of the KMS key used to encrypt the memory. * **memoryExecutionRoleArn** *(string) --* The ARN of the IAM role that provides permissions for the memory. * **eventExpiryDuration** *(integer) --* The number of days after which memory events will expire. * **status** *(string) --* The current status of the memory. * **failureReason** *(string) --* The reason for failure if the memory is in a failed state. * **createdAt** *(datetime) --* The timestamp when the memory was created. * **updatedAt** *(datetime) --* The timestamp when the memory was last updated. * **strategies** *(list) --* The list of memory strategies associated with this memory. * *(dict) --* Contains information about a memory strategy. * **strategyId** *(string) --* The unique identifier of the memory strategy. * **name** *(string) --* The name of the memory strategy. * **description** *(string) --* The description of the memory strategy. * **configuration** *(dict) --* The configuration of the memory strategy. * **type** *(string) --* The type of override for the strategy configuration. * **extraction** *(dict) --* The extraction configuration for the memory strategy. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "customExtractionConfiguration". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **customExtractionConfiguration** *(dict) --* The custom extraction configuration. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "semanticExtractionOverride", "userPreferenceExtractionOverride". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **semanticExtractionOverride** *(dict) --* The semantic extraction override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for semantic extraction. * **modelId** *(string) --* The model ID to use for semantic extraction. * **userPreferenceExtractionOverride** *(dict) --* The user preference extraction override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for user preference extraction. * **modelId** *(string) --* The model ID to use for user preference extraction. * **consolidation** *(dict) --* The consolidation configuration for the memory strategy. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "customConsolidationConfiguration". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **customConsolidationConfiguration** *(dict) --* The custom consolidation configuration. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "semanticConsolidationOverride", "summaryConsolidationOverride", "userPreferenceConsolidationOverride". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **semanticConsolidationOverride** *(dict) --* The semantic consolidation override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for semantic consolidation. * **modelId** *(string) --* The model ID to use for semantic consolidation. * **summaryConsolidationOverride** *(dict) --* The summary consolidation override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for summary consolidation. * **modelId** *(string) --* The model ID to use for summary consolidation. * **userPreferenceConsolidationOverride** *(dict) --* The user preference consolidation override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for user preference consolidation. * **modelId** *(string) --* The model ID to use for user preference consolidation. * **type** *(string) --* The type of the memory strategy. * **namespaces** *(list) --* The namespaces associated with the memory strategy. * *(string) --* * **createdAt** *(datetime) --* The timestamp when the memory strategy was created. * **updatedAt** *(datetime) --* The timestamp when the memory strategy was last updated. * **status** *(string) --* The current status of the memory strategy. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottledException" BedrockAgentCoreControlPlaneFrontingLayer / Client / set_token_vault_cmk set_token_vault_cmk ******************* BedrockAgentCoreControlPlaneFrontingLayer.Client.set_token_vault_cmk(**kwargs) Sets the customer master key (CMK) for a token vault. See also: AWS API Documentation **Request Syntax** response = client.set_token_vault_cmk( tokenVaultId='string', kmsConfiguration={ 'keyType': 'CustomerManagedKey'|'ServiceManagedKey', 'kmsKeyArn': 'string' } ) Parameters: * **tokenVaultId** (*string*) -- The unique identifier of the token vault to update. * **kmsConfiguration** (*dict*) -- **[REQUIRED]** The KMS configuration for the token vault, including the key type and KMS key ARN. * **keyType** *(string) --* **[REQUIRED]** The type of KMS key (CustomerManagedKey or ServiceManagedKey). * **kmsKeyArn** *(string) --* The Amazon Resource Name (ARN) of the KMS key. Return type: dict Returns: **Response Syntax** { 'tokenVaultId': 'string', 'kmsConfiguration': { 'keyType': 'CustomerManagedKey'|'ServiceManagedKey', 'kmsKeyArn': 'string' }, 'lastModifiedDate': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **tokenVaultId** *(string) --* The ID of the token vault. * **kmsConfiguration** *(dict) --* The KMS configuration for the token vault. * **keyType** *(string) --* The type of KMS key (CustomerManagedKey or ServiceManagedKey). * **kmsKeyArn** *(string) --* The Amazon Resource Name (ARN) of the KMS key. * **lastModifiedDate** *(datetime) --* The timestamp when the token vault was last modified. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con currentModificationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / list_memories list_memories ************* BedrockAgentCoreControlPlaneFrontingLayer.Client.list_memories(**kwargs) Lists the memory present. See also: AWS API Documentation **Request Syntax** response = client.list_memories( maxResults=123, nextToken='string' ) Parameters: * **maxResults** (*integer*) -- The maximum number of results to return in a single call. The default value is 10. The maximum value is 50. * **nextToken** (*string*) -- The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results. Return type: dict Returns: **Response Syntax** { 'memories': [ { 'arn': 'string', 'id': 'string', 'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1) }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **memories** *(list) --* The list of memory summaries. * *(dict) --* Contains summary information about a memory resource. * **arn** *(string) --* The Amazon Resource Name (ARN) of the memory. * **id** *(string) --* The unique identifier of the memory. * **status** *(string) --* The current status of the memory. * **createdAt** *(datetime) --* The timestamp when the memory was created. * **updatedAt** *(datetime) --* The timestamp when the memory was last updated. * **nextToken** *(string) --* A token to retrieve the next page of results. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottledException" BedrockAgentCoreControlPlaneFrontingLayer / Client / create_agent_runtime_endpoint create_agent_runtime_endpoint ***************************** BedrockAgentCoreControlPlaneFrontingLayer.Client.create_agent_runtime_endpoint(**kwargs) Creates an Amazon Secure AgentEndpoint. See also: AWS API Documentation **Request Syntax** response = client.create_agent_runtime_endpoint( agentRuntimeId='string', name='string', agentRuntimeVersion='string', description='string', clientToken='string' ) Parameters: * **agentRuntimeId** (*string*) -- **[REQUIRED]** The unique identifier of the agent runtime to create an endpoint for. * **name** (*string*) -- **[REQUIRED]** The name of the agent runtime endpoint. * **agentRuntimeVersion** (*string*) -- The version of the agent runtime to use for the endpoint. * **description** (*string*) -- The description of the agent runtime endpoint. * **clientToken** (*string*) -- A unique, case-sensitive identifier to ensure idempotency of the request. This field is autopopulated if not provided. Return type: dict Returns: **Response Syntax** { 'targetVersion': 'string', 'agentRuntimeEndpointArn': 'string', 'agentRuntimeArn': 'string', 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING', 'createdAt': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **targetVersion** *(string) --* The target version of the agent runtime for the endpoint. * **agentRuntimeEndpointArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime endpoint. * **agentRuntimeArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime. * **status** *(string) --* The current status of the agent runtime endpoint. * **createdAt** *(datetime) --* The timestamp when the agent runtime endpoint was created. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / create_agent_runtime create_agent_runtime ******************** BedrockAgentCoreControlPlaneFrontingLayer.Client.create_agent_runtime(**kwargs) Creates an Amazon Secure Agent. See also: AWS API Documentation **Request Syntax** response = client.create_agent_runtime( agentRuntimeName='string', description='string', agentRuntimeArtifact={ 'containerConfiguration': { 'containerUri': 'string' } }, roleArn='string', networkConfiguration={ 'networkMode': 'PUBLIC' }, protocolConfiguration={ 'serverProtocol': 'MCP'|'HTTP' }, clientToken='string', environmentVariables={ 'string': 'string' }, authorizerConfiguration={ 'customJWTAuthorizer': { 'discoveryUrl': 'string', 'allowedAudience': [ 'string', ], 'allowedClients': [ 'string', ] } } ) Parameters: * **agentRuntimeName** (*string*) -- **[REQUIRED]** The name of the secure agent. * **description** (*string*) -- The description of the agent runtime. * **agentRuntimeArtifact** (*dict*) -- **[REQUIRED]** The artifact of the agent. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "containerConfiguration". * **containerConfiguration** *(dict) --* The container configuration for the agent artifact. * **containerUri** *(string) --* **[REQUIRED]** The ECR URI of the container. * **roleArn** (*string*) -- **[REQUIRED]** The IAM role ARN that provides permissions for the agent runtime. * **networkConfiguration** (*dict*) -- **[REQUIRED]** The network configuration for the agent runtime. * **networkMode** *(string) --* **[REQUIRED]** The network mode for the agent runtime. * **protocolConfiguration** (*dict*) -- The protocol configuration for an agent runtime. This structure defines how the agent runtime communicates with clients. * **serverProtocol** *(string) --* **[REQUIRED]** The server protocol for the agent runtime. This field specifies which protocol the agent runtime uses to communicate with clients. * **clientToken** (*string*) -- A unique, case-sensitive identifier to ensure idempotency of the request. This field is autopopulated if not provided. * **environmentVariables** (*dict*) -- Environment variables to set in the agent runtime environment. * *(string) --* * *(string) --* * **authorizerConfiguration** (*dict*) -- The authorizer configuration for the agent runtime. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "customJWTAuthorizer". * **customJWTAuthorizer** *(dict) --* The inbound JWT-based authorization, specifying how incoming requests should be authenticated. * **discoveryUrl** *(string) --* **[REQUIRED]** This URL is used to fetch OpenID Connect configuration or authorization server metadata for validating incoming tokens. * **allowedAudience** *(list) --* Represents individual audience values that are validated in the incoming JWT token validation process. * *(string) --* * **allowedClients** *(list) --* Represents individual client IDs that are validated in the incoming JWT token validation process. * *(string) --* Return type: dict Returns: **Response Syntax** { 'agentRuntimeArn': 'string', 'workloadIdentityDetails': { 'workloadIdentityArn': 'string' }, 'agentRuntimeId': 'string', 'agentRuntimeVersion': 'string', 'createdAt': datetime(2015, 1, 1), 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING' } **Response Structure** * *(dict) --* * **agentRuntimeArn** *(string) --* The Amazon Resource Name (ARN) of the agent runtime. * **workloadIdentityDetails** *(dict) --* The workload identity details for the agent runtime. * **workloadIdentityArn** *(string) --* The ARN associated with the workload identity. * **agentRuntimeId** *(string) --* The unique identifier of the agent runtime. * **agentRuntimeVersion** *(string) --* The version of the agent runtime. * **createdAt** *(datetime) --* The timestamp when the agent runtime was created. * **status** *(string) --* The current status of the agent runtime. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / create_code_interpreter create_code_interpreter *********************** BedrockAgentCoreControlPlaneFrontingLayer.Client.create_code_interpreter(**kwargs) Creates a custom code interpreter. See also: AWS API Documentation **Request Syntax** response = client.create_code_interpreter( name='string', description='string', executionRoleArn='string', networkConfiguration={ 'networkMode': 'PUBLIC'|'SANDBOX' }, clientToken='string' ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the code interpreter. The name must be unique within your account. * **description** (*string*) -- The description of the code interpreter. * **executionRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the IAM role that provides permissions for the code interpreter to access Amazon Web Services services. * **networkConfiguration** (*dict*) -- **[REQUIRED]** The network configuration for the code interpreter. This configuration specifies the network mode for the code interpreter. * **networkMode** *(string) --* **[REQUIRED]** The network mode for the code interpreter. This field specifies how the code interpreter connects to the network. * **clientToken** (*string*) -- A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request but does not return an error. This field is autopopulated if not provided. Return type: dict Returns: **Response Syntax** { 'codeInterpreterId': 'string', 'codeInterpreterArn': 'string', 'createdAt': datetime(2015, 1, 1), 'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED' } **Response Structure** * *(dict) --* * **codeInterpreterId** *(string) --* The unique identifier of the created code interpreter. * **codeInterpreterArn** *(string) --* The Amazon Resource Name (ARN) of the created code interpreter. * **createdAt** *(datetime) --* The timestamp when the code interpreter was created. * **status** *(string) --* The current status of the code interpreter. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / update_oauth2_credential_provider update_oauth2_credential_provider ********************************* BedrockAgentCoreControlPlaneFrontingLayer.Client.update_oauth2_credential_provider(**kwargs) Updates an existing OAuth2 credential provider. See also: AWS API Documentation **Request Syntax** response = client.update_oauth2_credential_provider( name='string', credentialProviderVendor='GoogleOauth2'|'GithubOauth2'|'SlackOauth2'|'SalesforceOauth2'|'MicrosoftOauth2'|'CustomOauth2', oauth2ProviderConfigInput={ 'customOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } }, 'clientId': 'string', 'clientSecret': 'string' }, 'googleOauth2ProviderConfig': { 'clientId': 'string', 'clientSecret': 'string' }, 'githubOauth2ProviderConfig': { 'clientId': 'string', 'clientSecret': 'string' }, 'slackOauth2ProviderConfig': { 'clientId': 'string', 'clientSecret': 'string' }, 'salesforceOauth2ProviderConfig': { 'clientId': 'string', 'clientSecret': 'string' }, 'microsoftOauth2ProviderConfig': { 'clientId': 'string', 'clientSecret': 'string' } } ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the OAuth2 credential provider to update. * **credentialProviderVendor** (*string*) -- **[REQUIRED]** The vendor of the OAuth2 credential provider. * **oauth2ProviderConfigInput** (*dict*) -- **[REQUIRED]** The configuration input for the OAuth2 provider. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "customOauth2ProviderConfig", "googleOauth2ProviderConfig", "githubOauth2ProviderConfig", "slackOauth2ProviderConfig", "salesforceOauth2ProviderConfig", "microsoftOauth2ProviderConfig". * **customOauth2ProviderConfig** *(dict) --* The configuration for a custom OAuth2 provider. * **oauthDiscovery** *(dict) --* **[REQUIRED]** The OAuth2 discovery information for the custom provider. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "discoveryUrl", "authorizationServerMetadata". * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* **[REQUIRED]** The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* **[REQUIRED]** The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* **[REQUIRED]** The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **clientId** *(string) --* **[REQUIRED]** The client ID for the custom OAuth2 provider. * **clientSecret** *(string) --* **[REQUIRED]** The client secret for the custom OAuth2 provider. * **googleOauth2ProviderConfig** *(dict) --* The configuration for a Google OAuth2 provider. * **clientId** *(string) --* **[REQUIRED]** The client ID for the Google OAuth2 provider. * **clientSecret** *(string) --* **[REQUIRED]** The client secret for the Google OAuth2 provider. * **githubOauth2ProviderConfig** *(dict) --* The configuration for a GitHub OAuth2 provider. * **clientId** *(string) --* **[REQUIRED]** The client ID for the GitHub OAuth2 provider. * **clientSecret** *(string) --* **[REQUIRED]** The client secret for the GitHub OAuth2 provider. * **slackOauth2ProviderConfig** *(dict) --* The configuration for a Slack OAuth2 provider. * **clientId** *(string) --* **[REQUIRED]** The client ID for the Slack OAuth2 provider. * **clientSecret** *(string) --* **[REQUIRED]** The client secret for the Slack OAuth2 provider. * **salesforceOauth2ProviderConfig** *(dict) --* The configuration for a Salesforce OAuth2 provider. * **clientId** *(string) --* **[REQUIRED]** The client ID for the Salesforce OAuth2 provider. * **clientSecret** *(string) --* **[REQUIRED]** The client secret for the Salesforce OAuth2 provider. * **microsoftOauth2ProviderConfig** *(dict) --* The configuration for a Microsoft OAuth2 provider. * **clientId** *(string) --* **[REQUIRED]** The client ID for the Microsoft OAuth2 provider. * **clientSecret** *(string) --* **[REQUIRED]** The client secret for the Microsoft OAuth2 provider. Return type: dict Returns: **Response Syntax** { 'clientSecretArn': { 'secretArn': 'string' }, 'name': 'string', 'credentialProviderVendor': 'GoogleOauth2'|'GithubOauth2'|'SlackOauth2'|'SalesforceOauth2'|'MicrosoftOauth2'|'CustomOauth2', 'credentialProviderArn': 'string', 'oauth2ProviderConfigOutput': { 'customOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } } }, 'googleOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } } }, 'githubOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } } }, 'slackOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } } }, 'salesforceOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } } }, 'microsoftOauth2ProviderConfig': { 'oauthDiscovery': { 'discoveryUrl': 'string', 'authorizationServerMetadata': { 'issuer': 'string', 'authorizationEndpoint': 'string', 'tokenEndpoint': 'string', 'responseTypes': [ 'string', ] } } } }, 'createdTime': datetime(2015, 1, 1), 'lastUpdatedTime': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **clientSecretArn** *(dict) --* The Amazon Resource Name (ARN) of the client secret in AWS Secrets Manager. * **secretArn** *(string) --* The Amazon Resource Name (ARN) of the secret in AWS Secrets Manager. * **name** *(string) --* The name of the OAuth2 credential provider. * **credentialProviderVendor** *(string) --* The vendor of the OAuth2 credential provider. * **credentialProviderArn** *(string) --* The Amazon Resource Name (ARN) of the OAuth2 credential provider. * **oauth2ProviderConfigOutput** *(dict) --* The configuration output for the OAuth2 provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "customOauth2ProviderConfig", "googleOauth2ProviderConfig", "githubOauth2ProviderConfig", "slackOauth2ProviderConfig", "salesforceOauth2ProviderConfig", "microsoftOauth2ProviderConfig". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **customOauth2ProviderConfig** *(dict) --* The output configuration for a custom OAuth2 provider. * **oauthDiscovery** *(dict) --* The OAuth2 discovery information for the custom provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "discoveryUrl", "authorizationServerMetadata". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **googleOauth2ProviderConfig** *(dict) --* The output configuration for a Google OAuth2 provider. * **oauthDiscovery** *(dict) --* The OAuth2 discovery information for the Google provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "discoveryUrl", "authorizationServerMetadata". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **githubOauth2ProviderConfig** *(dict) --* The output configuration for a GitHub OAuth2 provider. * **oauthDiscovery** *(dict) --* The OAuth2 discovery information for the GitHub provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "discoveryUrl", "authorizationServerMetadata". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **slackOauth2ProviderConfig** *(dict) --* The output configuration for a Slack OAuth2 provider. * **oauthDiscovery** *(dict) --* The OAuth2 discovery information for the Slack provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "discoveryUrl", "authorizationServerMetadata". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **salesforceOauth2ProviderConfig** *(dict) --* The output configuration for a Salesforce OAuth2 provider. * **oauthDiscovery** *(dict) --* The OAuth2 discovery information for the Salesforce provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "discoveryUrl", "authorizationServerMetadata". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **microsoftOauth2ProviderConfig** *(dict) --* The output configuration for a Microsoft OAuth2 provider. * **oauthDiscovery** *(dict) --* The OAuth2 discovery information for the Microsoft provider. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "discoveryUrl", "authorizationServerMetadata". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **discoveryUrl** *(string) --* The discovery URL for the OAuth2 provider. * **authorizationServerMetadata** *(dict) --* The authorization server metadata for the OAuth2 provider. * **issuer** *(string) --* The issuer URL for the OAuth2 authorization server. * **authorizationEndpoint** *(string) --* The authorization endpoint URL for the OAuth2 authorization server. * **tokenEndpoint** *(string) --* The token endpoint URL for the OAuth2 authorization server. * **responseTypes** *(list) --* The supported response types for the OAuth2 authorization server. * *(string) --* * **createdTime** *(datetime) --* The timestamp when the OAuth2 credential provider was created. * **lastUpdatedTime** *(datetime) --* The timestamp when the OAuth2 credential provider was last updated. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Dec ryptionFailure" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Enc ryptionFailure" BedrockAgentCoreControlPlaneFrontingLayer / Client / update_gateway update_gateway ************** BedrockAgentCoreControlPlaneFrontingLayer.Client.update_gateway(**kwargs) Updates an existing Gateway. See also: AWS API Documentation **Request Syntax** response = client.update_gateway( gatewayIdentifier='string', name='string', description='string', roleArn='string', protocolType='MCP', protocolConfiguration={ 'mcp': { 'supportedVersions': [ 'string', ], 'instructions': 'string', 'searchType': 'SEMANTIC' } }, authorizerType='CUSTOM_JWT', authorizerConfiguration={ 'customJWTAuthorizer': { 'discoveryUrl': 'string', 'allowedAudience': [ 'string', ], 'allowedClients': [ 'string', ] } }, kmsKeyArn='string', exceptionLevel='DEBUG' ) Parameters: * **gatewayIdentifier** (*string*) -- **[REQUIRED]** The identifier of the gateway to update. This can be either the gateway ID or the gateway ARN. * **name** (*string*) -- **[REQUIRED]** The updated name for the Gateway. * **description** (*string*) -- The updated description for the Gateway. * **roleArn** (*string*) -- **[REQUIRED]** The updated IAM role ARN that provides permissions for the Gateway. * **protocolType** (*string*) -- **[REQUIRED]** The updated protocol type for the Gateway. * **protocolConfiguration** (*dict*) -- The configuration for a gateway protocol. This structure defines how the gateway communicates with external services. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "mcp". * **mcp** *(dict) --* The configuration for the Model Context Protocol (MCP). This protocol enables communication between Amazon Bedrock Agent and external tools. * **supportedVersions** *(list) --* The supported versions of the Model Context Protocol. This field specifies which versions of the protocol the gateway can use. * *(string) --* * **instructions** *(string) --* The instructions for using the Model Context Protocol gateway. These instructions provide guidance on how to interact with the gateway. * **searchType** *(string) --* The search type for the Model Context Protocol gateway. This field specifies how the gateway handles search operations. * **authorizerType** (*string*) -- **[REQUIRED]** The updated authorizer type for the Gateway. * **authorizerConfiguration** (*dict*) -- **[REQUIRED]** The updated authorizer configuration for the Gateway. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "customJWTAuthorizer". * **customJWTAuthorizer** *(dict) --* The inbound JWT-based authorization, specifying how incoming requests should be authenticated. * **discoveryUrl** *(string) --* **[REQUIRED]** This URL is used to fetch OpenID Connect configuration or authorization server metadata for validating incoming tokens. * **allowedAudience** *(list) --* Represents individual audience values that are validated in the incoming JWT token validation process. * *(string) --* * **allowedClients** *(list) --* Represents individual client IDs that are validated in the incoming JWT token validation process. * *(string) --* * **kmsKeyArn** (*string*) -- The updated ARN of the KMS key used to encrypt the Gateway. * **exceptionLevel** (*string*) -- The verbosity of exception messages. Use DEBUG mode to see granular exception messages from a Gateway. If this parameter is not set, exception messages are by default sanitized for presentation to end users. Return type: dict Returns: **Response Syntax** { 'gatewayArn': 'string', 'gatewayId': 'string', 'gatewayUrl': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED', 'statusReasons': [ 'string', ], 'name': 'string', 'description': 'string', 'roleArn': 'string', 'protocolType': 'MCP', 'protocolConfiguration': { 'mcp': { 'supportedVersions': [ 'string', ], 'instructions': 'string', 'searchType': 'SEMANTIC' } }, 'authorizerType': 'CUSTOM_JWT', 'authorizerConfiguration': { 'customJWTAuthorizer': { 'discoveryUrl': 'string', 'allowedAudience': [ 'string', ], 'allowedClients': [ 'string', ] } }, 'kmsKeyArn': 'string', 'workloadIdentityDetails': { 'workloadIdentityArn': 'string' }, 'exceptionLevel': 'DEBUG' } **Response Structure** * *(dict) --* * **gatewayArn** *(string) --* The Amazon Resource Name (ARN) of the updated Gateway. * **gatewayId** *(string) --* The unique identifier of the updated Gateway. * **gatewayUrl** *(string) --* An endpoint for invoking the updated Gateway. * **createdAt** *(datetime) --* The timestamp when the Gateway was created. * **updatedAt** *(datetime) --* The timestamp when the Gateway was last updated. * **status** *(string) --* The current status of the updated Gateway. * **statusReasons** *(list) --* The reasons for the current status of the updated Gateway. * *(string) --* * **name** *(string) --* The updated name of the Gateway. * **description** *(string) --* The updated description of the Gateway. * **roleArn** *(string) --* The updated IAM role ARN that provides permissions for the Gateway. * **protocolType** *(string) --* The updated protocol type for the Gateway. * **protocolConfiguration** *(dict) --* The configuration for a gateway protocol. This structure defines how the gateway communicates with external services. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "mcp". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **mcp** *(dict) --* The configuration for the Model Context Protocol (MCP). This protocol enables communication between Amazon Bedrock Agent and external tools. * **supportedVersions** *(list) --* The supported versions of the Model Context Protocol. This field specifies which versions of the protocol the gateway can use. * *(string) --* * **instructions** *(string) --* The instructions for using the Model Context Protocol gateway. These instructions provide guidance on how to interact with the gateway. * **searchType** *(string) --* The search type for the Model Context Protocol gateway. This field specifies how the gateway handles search operations. * **authorizerType** *(string) --* The updated authorizer type for the Gateway. * **authorizerConfiguration** *(dict) --* The updated authorizer configuration for the Gateway. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "customJWTAuthorizer". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **customJWTAuthorizer** *(dict) --* The inbound JWT-based authorization, specifying how incoming requests should be authenticated. * **discoveryUrl** *(string) --* This URL is used to fetch OpenID Connect configuration or authorization server metadata for validating incoming tokens. * **allowedAudience** *(list) --* Represents individual audience values that are validated in the incoming JWT token validation process. * *(string) --* * **allowedClients** *(list) --* Represents individual client IDs that are validated in the incoming JWT token validation process. * *(string) --* * **kmsKeyArn** *(string) --* The updated ARN of the KMS key used to encrypt the Gateway. * **workloadIdentityDetails** *(dict) --* The workload identity details for the updated Gateway. * **workloadIdentityArn** *(string) --* The ARN associated with the workload identity. * **exceptionLevel** *(string) --* The verbosity of exception messages. Use DEBUG mode to see granular exception messages from a Gateway. If this parameter is not set, exception messages are by default sanitized for presentation to end users. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / close close ***** BedrockAgentCoreControlPlaneFrontingLayer.Client.close() Closes underlying endpoint connections. BedrockAgentCoreControlPlaneFrontingLayer / Client / update_memory update_memory ************* BedrockAgentCoreControlPlaneFrontingLayer.Client.update_memory(**kwargs) Update memory. See also: AWS API Documentation **Request Syntax** response = client.update_memory( clientToken='string', memoryId='string', description='string', eventExpiryDuration=123, memoryExecutionRoleArn='string', memoryStrategies={ 'addMemoryStrategies': [ { 'semanticMemoryStrategy': { 'name': 'string', 'description': 'string', 'namespaces': [ 'string', ] }, 'summaryMemoryStrategy': { 'name': 'string', 'description': 'string', 'namespaces': [ 'string', ] }, 'userPreferenceMemoryStrategy': { 'name': 'string', 'description': 'string', 'namespaces': [ 'string', ] }, 'customMemoryStrategy': { 'name': 'string', 'description': 'string', 'namespaces': [ 'string', ], 'configuration': { 'semanticOverride': { 'extraction': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'consolidation': { 'appendToPrompt': 'string', 'modelId': 'string' } }, 'summaryOverride': { 'consolidation': { 'appendToPrompt': 'string', 'modelId': 'string' } }, 'userPreferenceOverride': { 'extraction': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'consolidation': { 'appendToPrompt': 'string', 'modelId': 'string' } } } } }, ], 'modifyMemoryStrategies': [ { 'memoryStrategyId': 'string', 'description': 'string', 'namespaces': [ 'string', ], 'configuration': { 'extraction': { 'customExtractionConfiguration': { 'semanticExtractionOverride': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'userPreferenceExtractionOverride': { 'appendToPrompt': 'string', 'modelId': 'string' } } }, 'consolidation': { 'customConsolidationConfiguration': { 'semanticConsolidationOverride': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'summaryConsolidationOverride': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'userPreferenceConsolidationOverride': { 'appendToPrompt': 'string', 'modelId': 'string' } } } } }, ], 'deleteMemoryStrategies': [ { 'memoryStrategyId': 'string' }, ] } ) Parameters: * **clientToken** (*string*) -- A client token is used for keeping track of idempotent requests. It can contain a session id which can be around 250 chars, combined with a unique AWS identifier. This field is autopopulated if not provided. * **memoryId** (*string*) -- **[REQUIRED]** The unique identifier of the memory to update. * **description** (*string*) -- The updated description of the memory. * **eventExpiryDuration** (*integer*) -- The number of days after which memory events will expire, between 7 and 365 days. * **memoryExecutionRoleArn** (*string*) -- The ARN of the IAM role that provides permissions for the memory. * **memoryStrategies** (*dict*) -- The memory strategies to add, modify, or delete. * **addMemoryStrategies** *(list) --* The list of memory strategies to add. * *(dict) --* Contains input information for creating a memory strategy. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "semanticMemoryStrategy", "summaryMemoryStrategy", "userPreferenceMemoryStrategy", "customMemoryStrategy". * **semanticMemoryStrategy** *(dict) --* Input for creating a semantic memory strategy. * **name** *(string) --* **[REQUIRED]** The name of the semantic memory strategy. * **description** *(string) --* The description of the semantic memory strategy. * **namespaces** *(list) --* The namespaces associated with the semantic memory strategy. * *(string) --* * **summaryMemoryStrategy** *(dict) --* Input for creating a summary memory strategy. * **name** *(string) --* **[REQUIRED]** The name of the summary memory strategy. * **description** *(string) --* The description of the summary memory strategy. * **namespaces** *(list) --* The namespaces associated with the summary memory strategy. * *(string) --* * **userPreferenceMemoryStrategy** *(dict) --* Input for creating a user preference memory strategy. * **name** *(string) --* **[REQUIRED]** The name of the user preference memory strategy. * **description** *(string) --* The description of the user preference memory strategy. * **namespaces** *(list) --* The namespaces associated with the user preference memory strategy. * *(string) --* * **customMemoryStrategy** *(dict) --* Input for creating a custom memory strategy. * **name** *(string) --* **[REQUIRED]** The name of the custom memory strategy. * **description** *(string) --* The description of the custom memory strategy. * **namespaces** *(list) --* The namespaces associated with the custom memory strategy. * *(string) --* * **configuration** *(dict) --* The configuration for the custom memory strategy. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "semanticOverride", "summaryOverride", "userPreferenceOverride". * **semanticOverride** *(dict) --* The semantic override configuration for a custom memory strategy. * **extraction** *(dict) --* The extraction configuration for a semantic override. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for semantic extraction. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for semantic extraction. * **consolidation** *(dict) --* The consolidation configuration for a semantic override. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for semantic consolidation. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for semantic consolidation. * **summaryOverride** *(dict) --* The summary override configuration for a custom memory strategy. * **consolidation** *(dict) --* The consolidation configuration for a summary override. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for summary consolidation. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for summary consolidation. * **userPreferenceOverride** *(dict) --* The user preference override configuration for a custom memory strategy. * **extraction** *(dict) --* The extraction configuration for a user preference override. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for user preference extraction. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for user preference extraction. * **consolidation** *(dict) --* The consolidation configuration for a user preference override. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for user preference consolidation. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for user preference consolidation. * **modifyMemoryStrategies** *(list) --* The list of memory strategies to modify. * *(dict) --* Input for modifying a memory strategy. * **memoryStrategyId** *(string) --* **[REQUIRED]** The unique identifier of the memory strategy to modify. * **description** *(string) --* The updated description of the memory strategy. * **namespaces** *(list) --* The updated namespaces for the memory strategy. * *(string) --* * **configuration** *(dict) --* The updated configuration for the memory strategy. * **extraction** *(dict) --* The updated extraction configuration. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "customExtractionConfiguration". * **customExtractionConfiguration** *(dict) --* The updated custom extraction configuration. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "semanticExtractionOverride", "userPreferenceExtractionOverride". * **semanticExtractionOverride** *(dict) --* The semantic extraction override configuration input. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for semantic extraction. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for semantic extraction. * **userPreferenceExtractionOverride** *(dict) --* The user preference extraction override configuration input. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for user preference extraction. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for user preference extraction. * **consolidation** *(dict) --* The updated consolidation configuration. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "customConsolidationConfiguration". * **customConsolidationConfiguration** *(dict) --* The updated custom consolidation configuration. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "semanticConsolidationOverride", "summaryConsolidationOverride", "userPreferenceConsolidationOverride". * **semanticConsolidationOverride** *(dict) --* The semantic consolidation override configuration input. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for semantic consolidation. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for semantic consolidation. * **summaryConsolidationOverride** *(dict) --* The summary consolidation override configuration input. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for summary consolidation. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for summary consolidation. * **userPreferenceConsolidationOverride** *(dict) --* The user preference consolidation override configuration input. * **appendToPrompt** *(string) --* **[REQUIRED]** The text to append to the prompt for user preference consolidation. * **modelId** *(string) --* **[REQUIRED]** The model ID to use for user preference consolidation. * **deleteMemoryStrategies** *(list) --* The list of memory strategies to delete. * *(dict) --* Input for deleting a memory strategy. * **memoryStrategyId** *(string) --* **[REQUIRED]** The unique identifier of the memory strategy to delete. Return type: dict Returns: **Response Syntax** { 'memory': { 'arn': 'string', 'id': 'string', 'name': 'string', 'description': 'string', 'encryptionKeyArn': 'string', 'memoryExecutionRoleArn': 'string', 'eventExpiryDuration': 123, 'status': 'CREATING'|'ACTIVE'|'FAILED'|'DELETING', 'failureReason': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'strategies': [ { 'strategyId': 'string', 'name': 'string', 'description': 'string', 'configuration': { 'type': 'SEMANTIC_OVERRIDE'|'SUMMARY_OVERRIDE'|'USER_PREFERENCE_OVERRIDE', 'extraction': { 'customExtractionConfiguration': { 'semanticExtractionOverride': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'userPreferenceExtractionOverride': { 'appendToPrompt': 'string', 'modelId': 'string' } } }, 'consolidation': { 'customConsolidationConfiguration': { 'semanticConsolidationOverride': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'summaryConsolidationOverride': { 'appendToPrompt': 'string', 'modelId': 'string' }, 'userPreferenceConsolidationOverride': { 'appendToPrompt': 'string', 'modelId': 'string' } } } }, 'type': 'SEMANTIC'|'SUMMARIZATION'|'USER_PREFERENCE'|'CUSTOM', 'namespaces': [ 'string', ], 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'ACTIVE'|'DELETING'|'FAILED' }, ] } } **Response Structure** * *(dict) --* * **memory** *(dict) --* The updated memory details. * **arn** *(string) --* The Amazon Resource Name (ARN) of the memory. * **id** *(string) --* The unique identifier of the memory. * **name** *(string) --* The name of the memory. * **description** *(string) --* The description of the memory. * **encryptionKeyArn** *(string) --* The ARN of the KMS key used to encrypt the memory. * **memoryExecutionRoleArn** *(string) --* The ARN of the IAM role that provides permissions for the memory. * **eventExpiryDuration** *(integer) --* The number of days after which memory events will expire. * **status** *(string) --* The current status of the memory. * **failureReason** *(string) --* The reason for failure if the memory is in a failed state. * **createdAt** *(datetime) --* The timestamp when the memory was created. * **updatedAt** *(datetime) --* The timestamp when the memory was last updated. * **strategies** *(list) --* The list of memory strategies associated with this memory. * *(dict) --* Contains information about a memory strategy. * **strategyId** *(string) --* The unique identifier of the memory strategy. * **name** *(string) --* The name of the memory strategy. * **description** *(string) --* The description of the memory strategy. * **configuration** *(dict) --* The configuration of the memory strategy. * **type** *(string) --* The type of override for the strategy configuration. * **extraction** *(dict) --* The extraction configuration for the memory strategy. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "customExtractionConfiguration". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **customExtractionConfiguration** *(dict) --* The custom extraction configuration. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "semanticExtractionOverride", "userPreferenceExtractionOverride". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **semanticExtractionOverride** *(dict) --* The semantic extraction override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for semantic extraction. * **modelId** *(string) --* The model ID to use for semantic extraction. * **userPreferenceExtractionOverride** *(dict) --* The user preference extraction override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for user preference extraction. * **modelId** *(string) --* The model ID to use for user preference extraction. * **consolidation** *(dict) --* The consolidation configuration for the memory strategy. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "customConsolidationConfiguration". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **customConsolidationConfiguration** *(dict) --* The custom consolidation configuration. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "semanticConsolidationOverride", "summaryConsolidationOverride", "userPreferenceConsolidationOverride". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **semanticConsolidationOverride** *(dict) --* The semantic consolidation override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for semantic consolidation. * **modelId** *(string) --* The model ID to use for semantic consolidation. * **summaryConsolidationOverride** *(dict) --* The summary consolidation override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for summary consolidation. * **modelId** *(string) --* The model ID to use for summary consolidation. * **userPreferenceConsolidationOverride** *(dict) --* The user preference consolidation override configuration. * **appendToPrompt** *(string) --* The text to append to the prompt for user preference consolidation. * **modelId** *(string) --* The model ID to use for user preference consolidation. * **type** *(string) --* The type of the memory strategy. * **namespaces** *(list) --* The namespaces associated with the memory strategy. * *(string) --* * **createdAt** *(datetime) --* The timestamp when the memory strategy was created. * **updatedAt** *(datetime) --* The timestamp when the memory strategy was last updated. * **status** *(string) --* The current status of the memory strategy. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottledException" BedrockAgentCoreControlPlaneFrontingLayer / Client / delete_agent_runtime_endpoint delete_agent_runtime_endpoint ***************************** BedrockAgentCoreControlPlaneFrontingLayer.Client.delete_agent_runtime_endpoint(**kwargs) Deletes an Amazon Secure AgentEndpoint. See also: AWS API Documentation **Request Syntax** response = client.delete_agent_runtime_endpoint( agentRuntimeId='string', endpointName='string', clientToken='string' ) Parameters: * **agentRuntimeId** (*string*) -- **[REQUIRED]** The unique identifier of the agent runtime associated with the endpoint. * **endpointName** (*string*) -- **[REQUIRED]** The name of the agent runtime endpoint to delete. * **clientToken** (*string*) -- A unique, case-sensitive identifier to ensure idempotency of the request. This field is autopopulated if not provided. Return type: dict Returns: **Response Syntax** { 'status': 'CREATING'|'CREATE_FAILED'|'UPDATING'|'UPDATE_FAILED'|'READY'|'DELETING' } **Response Structure** * *(dict) --* * **status** *(string) --* The current status of the agent runtime endpoint deletion. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / delete_oauth2_credential_provider delete_oauth2_credential_provider ********************************* BedrockAgentCoreControlPlaneFrontingLayer.Client.delete_oauth2_credential_provider(**kwargs) Deletes an OAuth2 credential provider. See also: AWS API Documentation **Request Syntax** response = client.delete_oauth2_credential_provider( name='string' ) Parameters: **name** (*string*) -- **[REQUIRED]** The name of the OAuth2 credential provider to delete. Return type: dict Returns: **Response Syntax** {} **Response Structure** * *(dict) --* **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / delete_browser delete_browser ************** BedrockAgentCoreControlPlaneFrontingLayer.Client.delete_browser(**kwargs) Deletes a custom browser. See also: AWS API Documentation **Request Syntax** response = client.delete_browser( browserId='string', clientToken='string' ) Parameters: * **browserId** (*string*) -- **[REQUIRED]** The unique identifier of the browser to delete. * **clientToken** (*string*) -- A unique, case-sensitive identifier to ensure idempotency of the request. This field is autopopulated if not provided. Return type: dict Returns: **Response Syntax** { 'browserId': 'string', 'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED', 'lastUpdatedAt': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **browserId** *(string) --* The unique identifier of the deleted browser. * **status** *(string) --* The current status of the browser deletion. * **lastUpdatedAt** *(datetime) --* The timestamp when the browser was last updated. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / list_gateways list_gateways ************* BedrockAgentCoreControlPlaneFrontingLayer.Client.list_gateways(**kwargs) Lists all Gateways in the account. See also: AWS API Documentation **Request Syntax** response = client.list_gateways( maxResults=123, nextToken='string' ) Parameters: * **maxResults** (*integer*) -- The maximum number of results to return in a single call. The default value is 10. The maximum value is 50. * **nextToken** (*string*) -- The token for the next set of results. Use the value returned in the previous response in the next request to retrieve the next set of results. Return type: dict Returns: **Response Syntax** { 'items': [ { 'gatewayId': 'string', 'name': 'string', 'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED', 'description': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'authorizerType': 'CUSTOM_JWT', 'protocolType': 'MCP' }, ], 'nextToken': 'string' } **Response Structure** * *(dict) --* * **items** *(list) --* The list of Gateway summaries. * *(dict) --* Contains summary information about a gateway. * **gatewayId** *(string) --* The unique identifier of the gateway. * **name** *(string) --* The name of the gateway. * **status** *(string) --* The current status of the gateway. * **description** *(string) --* The description of the gateway. * **createdAt** *(datetime) --* The timestamp when the gateway was created. * **updatedAt** *(datetime) --* The timestamp when the gateway was last updated. * **authorizerType** *(string) --* The type of authorizer used by the gateway. * **protocolType** *(string) --* The protocol type used by the gateway. * **nextToken** *(string) --* Opaque continuation token for the next paginated response. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / delete_code_interpreter delete_code_interpreter *********************** BedrockAgentCoreControlPlaneFrontingLayer.Client.delete_code_interpreter(**kwargs) Deletes a custom code interpreter. See also: AWS API Documentation **Request Syntax** response = client.delete_code_interpreter( codeInterpreterId='string', clientToken='string' ) Parameters: * **codeInterpreterId** (*string*) -- **[REQUIRED]** The unique identifier of the code interpreter to delete. * **clientToken** (*string*) -- A unique, case-sensitive identifier to ensure idempotency of the request. This field is autopopulated if not provided. Return type: dict Returns: **Response Syntax** { 'codeInterpreterId': 'string', 'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED', 'lastUpdatedAt': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **codeInterpreterId** *(string) --* The unique identifier of the deleted code interpreter. * **status** *(string) --* The current status of the code interpreter deletion. * **lastUpdatedAt** *(datetime) --* The timestamp when the code interpreter was last updated. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / delete_gateway delete_gateway ************** BedrockAgentCoreControlPlaneFrontingLayer.Client.delete_gateway(**kwargs) Deletes a Gateway. See also: AWS API Documentation **Request Syntax** response = client.delete_gateway( gatewayIdentifier='string' ) Parameters: **gatewayIdentifier** (*string*) -- **[REQUIRED]** The identifier of the gateway to delete. This can be either the gateway ID or the gateway ARN. Return type: dict Returns: **Response Syntax** { 'gatewayId': 'string', 'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED', 'statusReasons': [ 'string', ] } **Response Structure** * *(dict) --* * **gatewayId** *(string) --* The unique identifier of the deleted Gateway. * **status** *(string) --* The current status of the Gateway deletion. * **statusReasons** *(list) --* The reasons for the current status of the Gateway deletion. * *(string) --* **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / create_browser create_browser ************** BedrockAgentCoreControlPlaneFrontingLayer.Client.create_browser(**kwargs) Creates a custom browser. See also: AWS API Documentation **Request Syntax** response = client.create_browser( name='string', description='string', executionRoleArn='string', networkConfiguration={ 'networkMode': 'PUBLIC' }, recording={ 'enabled': True|False, 's3Location': { 'bucket': 'string', 'prefix': 'string' } }, clientToken='string' ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the browser. The name must be unique within your account. * **description** (*string*) -- The description of the browser. * **executionRoleArn** (*string*) -- The Amazon Resource Name (ARN) of the IAM role that provides permissions for the browser to access Amazon Web Services services. * **networkConfiguration** (*dict*) -- **[REQUIRED]** The network configuration for the browser. This configuration specifies the network mode for the browser. * **networkMode** *(string) --* **[REQUIRED]** The network mode for the browser. This field specifies how the browser connects to the network. * **recording** (*dict*) -- The recording configuration for the browser. When enabled, browser sessions are recorded and stored in the specified Amazon S3 location. * **enabled** *(boolean) --* Indicates whether recording is enabled for the browser. When set to true, browser sessions are recorded. * **s3Location** *(dict) --* The Amazon S3 location where browser recordings are stored. This location contains the recorded browser sessions. * **bucket** *(string) --* **[REQUIRED]** The name of the Amazon S3 bucket. This bucket contains the stored data. * **prefix** *(string) --* **[REQUIRED]** The prefix for objects in the Amazon S3 bucket. This prefix is added to the object keys to organize the data. * **clientToken** (*string*) -- A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request but does not return an error. This field is autopopulated if not provided. Return type: dict Returns: **Response Syntax** { 'browserId': 'string', 'browserArn': 'string', 'createdAt': datetime(2015, 1, 1), 'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED' } **Response Structure** * *(dict) --* * **browserId** *(string) --* The unique identifier of the created browser. * **browserArn** *(string) --* The Amazon Resource Name (ARN) of the created browser. * **createdAt** *(datetime) --* The timestamp when the browser was created. * **status** *(string) --* The current status of the browser. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / create_workload_identity create_workload_identity ************************ BedrockAgentCoreControlPlaneFrontingLayer.Client.create_workload_identity(**kwargs) Creates a new workload identity. See also: AWS API Documentation **Request Syntax** response = client.create_workload_identity( name='string', allowedResourceOauth2ReturnUrls=[ 'string', ] ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the workload identity. The name must be unique within your account. * **allowedResourceOauth2ReturnUrls** (*list*) -- The list of allowed OAuth2 return URLs for resources associated with this workload identity. * *(string) --* Return type: dict Returns: **Response Syntax** { 'name': 'string', 'workloadIdentityArn': 'string', 'allowedResourceOauth2ReturnUrls': [ 'string', ] } **Response Structure** * *(dict) --* * **name** *(string) --* The name of the workload identity. * **workloadIdentityArn** *(string) --* The Amazon Resource Name (ARN) of the workload identity. * **allowedResourceOauth2ReturnUrls** *(list) --* The list of allowed OAuth2 return URLs for resources associated with this workload identity. * *(string) --* **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / get_code_interpreter get_code_interpreter ******************** BedrockAgentCoreControlPlaneFrontingLayer.Client.get_code_interpreter(**kwargs) Gets information about a custom code interpreter. See also: AWS API Documentation **Request Syntax** response = client.get_code_interpreter( codeInterpreterId='string' ) Parameters: **codeInterpreterId** (*string*) -- **[REQUIRED]** The unique identifier of the code interpreter to retrieve. Return type: dict Returns: **Response Syntax** { 'codeInterpreterId': 'string', 'codeInterpreterArn': 'string', 'name': 'string', 'description': 'string', 'executionRoleArn': 'string', 'networkConfiguration': { 'networkMode': 'PUBLIC'|'SANDBOX' }, 'status': 'CREATING'|'CREATE_FAILED'|'READY'|'DELETING'|'DELETE_FAILED'|'DELETED', 'createdAt': datetime(2015, 1, 1), 'lastUpdatedAt': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **codeInterpreterId** *(string) --* The unique identifier of the code interpreter. * **codeInterpreterArn** *(string) --* The Amazon Resource Name (ARN) of the code interpreter. * **name** *(string) --* The name of the code interpreter. * **description** *(string) --* The description of the code interpreter. * **executionRoleArn** *(string) --* The IAM role ARN that provides permissions for the code interpreter. * **networkConfiguration** *(dict) --* The network configuration for a code interpreter. This structure defines how the code interpreter connects to the network. * **networkMode** *(string) --* The network mode for the code interpreter. This field specifies how the code interpreter connects to the network. * **status** *(string) --* The current status of the code interpreter. * **createdAt** *(datetime) --* The timestamp when the code interpreter was created. * **lastUpdatedAt** *(datetime) --* The timestamp when the code interpreter was last updated. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / get_token_vault get_token_vault *************** BedrockAgentCoreControlPlaneFrontingLayer.Client.get_token_vault(**kwargs) Retrieves information about a token vault. See also: AWS API Documentation **Request Syntax** response = client.get_token_vault( tokenVaultId='string' ) Parameters: **tokenVaultId** (*string*) -- The unique identifier of the token vault to retrieve. Return type: dict Returns: **Response Syntax** { 'tokenVaultId': 'string', 'kmsConfiguration': { 'keyType': 'CustomerManagedKey'|'ServiceManagedKey', 'kmsKeyArn': 'string' }, 'lastModifiedDate': datetime(2015, 1, 1) } **Response Structure** * *(dict) --* * **tokenVaultId** *(string) --* The ID of the token vault. * **kmsConfiguration** *(dict) --* The KMS configuration for the token vault. * **keyType** *(string) --* The type of KMS key (CustomerManagedKey or ServiceManagedKey). * **kmsKeyArn** *(string) --* The Amazon Resource Name (ARN) of the KMS key. * **lastModifiedDate** *(datetime) --* The timestamp when the token vault was last modified. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Una uthorizedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / create_gateway create_gateway ************** BedrockAgentCoreControlPlaneFrontingLayer.Client.create_gateway(**kwargs) Creates a gateway for Amazon Bedrock Agent. A gateway serves as an integration point between your agent and external services. To create a gateway, you must specify a name, protocol type, and IAM role. The role grants the gateway permission to access Amazon Web Services services and resources. See also: AWS API Documentation **Request Syntax** response = client.create_gateway( name='string', description='string', clientToken='string', roleArn='string', protocolType='MCP', protocolConfiguration={ 'mcp': { 'supportedVersions': [ 'string', ], 'instructions': 'string', 'searchType': 'SEMANTIC' } }, authorizerType='CUSTOM_JWT', authorizerConfiguration={ 'customJWTAuthorizer': { 'discoveryUrl': 'string', 'allowedAudience': [ 'string', ], 'allowedClients': [ 'string', ] } }, kmsKeyArn='string', exceptionLevel='DEBUG' ) Parameters: * **name** (*string*) -- **[REQUIRED]** The name of the gateway. The name must be unique within your account. * **description** (*string*) -- The description of the gateway. * **clientToken** (*string*) -- A unique, case-sensitive identifier to ensure that the operation completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request but does not return an error. This field is autopopulated if not provided. * **roleArn** (*string*) -- **[REQUIRED]** The Amazon Resource Name (ARN) of the IAM role that provides permissions for the gateway to access Amazon Web Services services. * **protocolType** (*string*) -- **[REQUIRED]** The protocol type for the gateway. Currently supports MCP (Model Context Protocol). * **protocolConfiguration** (*dict*) -- The configuration settings for the protocol specified in the protocolType parameter. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "mcp". * **mcp** *(dict) --* The configuration for the Model Context Protocol (MCP). This protocol enables communication between Amazon Bedrock Agent and external tools. * **supportedVersions** *(list) --* The supported versions of the Model Context Protocol. This field specifies which versions of the protocol the gateway can use. * *(string) --* * **instructions** *(string) --* The instructions for using the Model Context Protocol gateway. These instructions provide guidance on how to interact with the gateway. * **searchType** *(string) --* The search type for the Model Context Protocol gateway. This field specifies how the gateway handles search operations. * **authorizerType** (*string*) -- **[REQUIRED]** The type of authorizer to use for the gateway. * **authorizerConfiguration** (*dict*) -- **[REQUIRED]** The authorizer configuration for the Gateway. Note: This is a Tagged Union structure. Only one of the following top level keys can be set: "customJWTAuthorizer". * **customJWTAuthorizer** *(dict) --* The inbound JWT-based authorization, specifying how incoming requests should be authenticated. * **discoveryUrl** *(string) --* **[REQUIRED]** This URL is used to fetch OpenID Connect configuration or authorization server metadata for validating incoming tokens. * **allowedAudience** *(list) --* Represents individual audience values that are validated in the incoming JWT token validation process. * *(string) --* * **allowedClients** *(list) --* Represents individual client IDs that are validated in the incoming JWT token validation process. * *(string) --* * **kmsKeyArn** (*string*) -- The Amazon Resource Name (ARN) of the KMS key used to encrypt data associated with the gateway. * **exceptionLevel** (*string*) -- The verbosity of exception messages. Use DEBUG mode to see granular exception messages from a Gateway. If this parameter is not set, exception messages are by default sanitized for presentation to end users. Return type: dict Returns: **Response Syntax** { 'gatewayArn': 'string', 'gatewayId': 'string', 'gatewayUrl': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED', 'statusReasons': [ 'string', ], 'name': 'string', 'description': 'string', 'roleArn': 'string', 'protocolType': 'MCP', 'protocolConfiguration': { 'mcp': { 'supportedVersions': [ 'string', ], 'instructions': 'string', 'searchType': 'SEMANTIC' } }, 'authorizerType': 'CUSTOM_JWT', 'authorizerConfiguration': { 'customJWTAuthorizer': { 'discoveryUrl': 'string', 'allowedAudience': [ 'string', ], 'allowedClients': [ 'string', ] } }, 'kmsKeyArn': 'string', 'workloadIdentityDetails': { 'workloadIdentityArn': 'string' }, 'exceptionLevel': 'DEBUG' } **Response Structure** * *(dict) --* * **gatewayArn** *(string) --* The Amazon Resource Name (ARN) of the created gateway. * **gatewayId** *(string) --* The unique identifier of the created gateway. * **gatewayUrl** *(string) --* The URL endpoint for the created gateway. * **createdAt** *(datetime) --* The timestamp when the gateway was created. * **updatedAt** *(datetime) --* The timestamp when the gateway was last updated. * **status** *(string) --* The current status of the gateway. * **statusReasons** *(list) --* The reasons for the current status of the gateway. * *(string) --* * **name** *(string) --* The name of the gateway. * **description** *(string) --* The description of the gateway. * **roleArn** *(string) --* The Amazon Resource Name (ARN) of the IAM role associated with the gateway. * **protocolType** *(string) --* The protocol type of the gateway. * **protocolConfiguration** *(dict) --* The configuration settings for the protocol used by the gateway. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "mcp". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **mcp** *(dict) --* The configuration for the Model Context Protocol (MCP). This protocol enables communication between Amazon Bedrock Agent and external tools. * **supportedVersions** *(list) --* The supported versions of the Model Context Protocol. This field specifies which versions of the protocol the gateway can use. * *(string) --* * **instructions** *(string) --* The instructions for using the Model Context Protocol gateway. These instructions provide guidance on how to interact with the gateway. * **searchType** *(string) --* The search type for the Model Context Protocol gateway. This field specifies how the gateway handles search operations. * **authorizerType** *(string) --* The type of authorizer used by the gateway. * **authorizerConfiguration** *(dict) --* The authorizer configuration for the created Gateway. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "customJWTAuthorizer". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **customJWTAuthorizer** *(dict) --* The inbound JWT-based authorization, specifying how incoming requests should be authenticated. * **discoveryUrl** *(string) --* This URL is used to fetch OpenID Connect configuration or authorization server metadata for validating incoming tokens. * **allowedAudience** *(list) --* Represents individual audience values that are validated in the incoming JWT token validation process. * *(string) --* * **allowedClients** *(list) --* Represents individual client IDs that are validated in the incoming JWT token validation process. * *(string) --* * **kmsKeyArn** *(string) --* The Amazon Resource Name (ARN) of the KMS key used to encrypt data associated with the gateway. * **workloadIdentityDetails** *(dict) --* The workload identity details for the created Gateway. * **workloadIdentityArn** *(string) --* The ARN associated with the workload identity. * **exceptionLevel** *(string) --* The verbosity of exception messages. Use DEBUG mode to see granular exception messages from a Gateway. If this parameter is not set, exception messages are by default sanitized for presentation to end users. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Ser viceQuotaExceededException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Con flictException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException" BedrockAgentCoreControlPlaneFrontingLayer / Client / get_gateway_target get_gateway_target ****************** BedrockAgentCoreControlPlaneFrontingLayer.Client.get_gateway_target(**kwargs) Retrieves information about a specific Gateway Target. See also: AWS API Documentation **Request Syntax** response = client.get_gateway_target( gatewayIdentifier='string', targetId='string' ) Parameters: * **gatewayIdentifier** (*string*) -- **[REQUIRED]** The identifier of the gateway that contains the target. This can be either the gateway ID or the gateway ARN. * **targetId** (*string*) -- **[REQUIRED]** The unique identifier of the target to retrieve. Return type: dict Returns: **Response Syntax** { 'gatewayArn': 'string', 'targetId': 'string', 'createdAt': datetime(2015, 1, 1), 'updatedAt': datetime(2015, 1, 1), 'status': 'CREATING'|'UPDATING'|'UPDATE_UNSUCCESSFUL'|'DELETING'|'READY'|'FAILED', 'statusReasons': [ 'string', ], 'name': 'string', 'description': 'string', 'targetConfiguration': { 'mcp': { 'openApiSchema': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': 'string' }, 'smithyModel': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': 'string' }, 'lambda': { 'lambdaArn': 'string', 'toolSchema': { 's3': { 'uri': 'string', 'bucketOwnerAccountId': 'string' }, 'inlinePayload': [ { 'name': 'string', 'description': 'string', 'inputSchema': { 'type': 'string'|'number'|'object'|'array'|'boolean'|'integer', 'properties': { 'string': {'... recursive ...'} }, 'required': [ 'string', ], 'items': {'... recursive ...'}, 'description': 'string' }, 'outputSchema': { 'type': 'string'|'number'|'object'|'array'|'boolean'|'integer', 'properties': { 'string': {'... recursive ...'} }, 'required': [ 'string', ], 'items': {'... recursive ...'}, 'description': 'string' } }, ] } } } }, 'credentialProviderConfigurations': [ { 'credentialProviderType': 'GATEWAY_IAM_ROLE'|'OAUTH'|'API_KEY', 'credentialProvider': { 'oauthCredentialProvider': { 'providerArn': 'string', 'scopes': [ 'string', ], 'customParameters': { 'string': 'string' } }, 'apiKeyCredentialProvider': { 'providerArn': 'string', 'credentialParameterName': 'string', 'credentialPrefix': 'string', 'credentialLocation': 'HEADER'|'QUERY_PARAMETER' } } }, ] } **Response Structure** * *(dict) --* * **gatewayArn** *(string) --* The Amazon Resource Name (ARN) of the Gateway. * **targetId** *(string) --* The unique identifier of the Gateway Target. * **createdAt** *(datetime) --* The timestamp when the Gateway Target was created. * **updatedAt** *(datetime) --* The timestamp when the Gateway Target was last updated. * **status** *(string) --* The current status of the Gateway Target. * **statusReasons** *(list) --* The reasons for the current status of the Gateway Target. * *(string) --* * **name** *(string) --* The name of the Gateway Target. * **description** *(string) --* The description of the Gateway Target. * **targetConfiguration** *(dict) --* The configuration for a gateway target. This structure defines how the gateway connects to and interacts with the target endpoint. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "mcp". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **mcp** *(dict) --* The Model Context Protocol (MCP) configuration for the target. This configuration defines how the gateway uses MCP to communicate with the target. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "openApiSchema", "smithyModel", "lambda". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **openApiSchema** *(dict) --* The OpenAPI schema for the Model Context Protocol target. This schema defines the API structure of the target. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "s3", "inlinePayload". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **s3** *(dict) --* The Amazon S3 configuration for a gateway. This structure defines how the gateway accesses files in Amazon S3. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(string) --* The inline payload containing the API schema definition. * **smithyModel** *(dict) --* The Smithy model for the Model Context Protocol target. This model defines the API structure of the target using the Smithy specification. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "s3", "inlinePayload". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **s3** *(dict) --* The Amazon S3 configuration for a gateway. This structure defines how the gateway accesses files in Amazon S3. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(string) --* The inline payload containing the API schema definition. * **lambda** *(dict) --* The Lambda configuration for the Model Context Protocol target. This configuration defines how the gateway uses a Lambda function to communicate with the target. * **lambdaArn** *(string) --* The Amazon Resource Name (ARN) of the Lambda function. This function is invoked by the gateway to communicate with the target. * **toolSchema** *(dict) --* The tool schema for the Lambda function. This schema defines the structure of the tools that the Lambda function provides. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "s3", "inlinePayload". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **s3** *(dict) --* The Amazon S3 location of the tool schema. This location contains the schema definition file. * **uri** *(string) --* The URI of the Amazon S3 object. This URI specifies the location of the object in Amazon S3. * **bucketOwnerAccountId** *(string) --* The account ID of the Amazon S3 bucket owner. This ID is used for cross-account access to the bucket. * **inlinePayload** *(list) --* The inline payload of the tool schema. This payload contains the schema definition directly in the request. * *(dict) --* A tool definition for a gateway target. This structure defines a tool that the target exposes through the Model Context Protocol. * **name** *(string) --* The name of the tool. This name identifies the tool in the Model Context Protocol. * **description** *(string) --* The description of the tool. This description provides information about the purpose and usage of the tool. * **inputSchema** *(dict) --* The input schema for the tool. This schema defines the structure of the input that the tool accepts. * **type** *(string) --* The type of the schema definition. This field specifies the data type of the schema. * **properties** *(dict) --* The properties of the schema definition. These properties define the fields in the schema. * *(string) --* * *(dict) --* A schema definition for a gateway target. This structure defines the structure of the API that the target exposes. * **required** *(list) --* The required fields in the schema definition. These fields must be provided when using the schema. * *(string) --* * **items** *(dict) --* The items in the schema definition. This field is used for array types to define the structure of the array elements. * **description** *(string) --* The description of the schema definition. This description provides information about the purpose and usage of the schema. * **outputSchema** *(dict) --* The output schema for the tool. This schema defines the structure of the output that the tool produces. * **type** *(string) --* The type of the schema definition. This field specifies the data type of the schema. * **properties** *(dict) --* The properties of the schema definition. These properties define the fields in the schema. * *(string) --* * *(dict) --* A schema definition for a gateway target. This structure defines the structure of the API that the target exposes. * **required** *(list) --* The required fields in the schema definition. These fields must be provided when using the schema. * *(string) --* * **items** *(dict) --* The items in the schema definition. This field is used for array types to define the structure of the array elements. * **description** *(string) --* The description of the schema definition. This description provides information about the purpose and usage of the schema. * **credentialProviderConfigurations** *(list) --* The credential provider configurations for the Gateway Target. * *(dict) --* The configuration for a credential provider. This structure defines how the gateway authenticates with the target endpoint. * **credentialProviderType** *(string) --* The type of credential provider. This field specifies which authentication method the gateway uses. * **credentialProvider** *(dict) --* The credential provider. This field contains the specific configuration for the credential provider type. Note: This is a Tagged Union structure. Only one of the following top level keys will be set: "oauthCredentialProvider", "apiKeyCredentialProvider". If a client receives an unknown member it will set "SDK_UNKNOWN_MEMBER" as the top level key, which maps to the name or tag of the unknown member. The structure of "SDK_UNKNOWN_MEMBER" is as follows: 'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'} * **oauthCredentialProvider** *(dict) --* The OAuth credential provider. This provider uses OAuth authentication to access the target endpoint. * **providerArn** *(string) --* The Amazon Resource Name (ARN) of the OAuth credential provider. This ARN identifies the provider in Amazon Web Services. * **scopes** *(list) --* The OAuth scopes for the credential provider. These scopes define the level of access requested from the OAuth provider. * *(string) --* * **customParameters** *(dict) --* The custom parameters for the OAuth credential provider. These parameters provide additional configuration for the OAuth authentication process. * *(string) --* * *(string) --* * **apiKeyCredentialProvider** *(dict) --* The API key credential provider. This provider uses an API key to authenticate with the target endpoint. * **providerArn** *(string) --* The Amazon Resource Name (ARN) of the API key credential provider. This ARN identifies the provider in Amazon Web Services. * **credentialParameterName** *(string) --* The name of the credential parameter for the API key. This parameter name is used when sending the API key to the target endpoint. * **credentialPrefix** *(string) --* The prefix for the API key credential. This prefix is added to the API key when sending it to the target endpoint. * **credentialLocation** *(string) --* The location of the API key credential. This field specifies where in the request the API key should be placed. **Exceptions** * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Val idationException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Acc essDeniedException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Res ourceNotFoundException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Thr ottlingException" * "BedrockAgentCoreControlPlaneFrontingLayer.Client.exceptions.Int ernalServerException"