feat(client-bedrock-agentcore-control): Add tagging and VPC support to AgentCore Runtime, Code Interpreter, and Browser resources. Add support for configuring request headers in Runtime. Fix AgentCore Runtime shape names.

Author: awstools

clients/client-bedrock-agentcore-control/README.md

@@ -6,7 +6,7 @@
 
 AWS SDK for JavaScript BedrockAgentCoreControl Client for Node.js, Browser and React Native.
 
-<note> <p>Amazon Bedrock AgentCore is in preview release and is subject to change.</p> </note> <p>Amazon Bedrock Agent Core Control is a service that enables you to manage memory resources for your Amazon Bedrock agents.</p> <p>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.</p>
+<note> <p> is in preview release and is subject to change.</p> </note> <p>Welcome to the Amazon Bedrock AgentCore Control plane API reference. Control plane actions configure, create, modify, and monitor Amazon Web Services resources.</p>
 
 ## Installing
 
@@ -533,6 +533,14 @@ ListOauth2CredentialProviders
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/bedrock-agentcore-control/command/ListOauth2CredentialProvidersCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-bedrock-agentcore-control/Interface/ListOauth2CredentialProvidersCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-bedrock-agentcore-control/Interface/ListOauth2CredentialProvidersCommandOutput/)
 
+</details>
+<details>
+<summary>
+ListTagsForResource
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/bedrock-agentcore-control/command/ListTagsForResourceCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-bedrock-agentcore-control/Interface/ListTagsForResourceCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-bedrock-agentcore-control/Interface/ListTagsForResourceCommandOutput/)
+
 </details>
 <details>
 <summary>
@@ -549,6 +557,22 @@ SetTokenVaultCMK
 
 [Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/bedrock-agentcore-control/command/SetTokenVaultCMKCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-bedrock-agentcore-control/Interface/SetTokenVaultCMKCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-bedrock-agentcore-control/Interface/SetTokenVaultCMKCommandOutput/)
 
+</details>
+<details>
+<summary>
+TagResource
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/bedrock-agentcore-control/command/TagResourceCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-bedrock-agentcore-control/Interface/TagResourceCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-bedrock-agentcore-control/Interface/TagResourceCommandOutput/)
+
+</details>
+<details>
+<summary>
+UntagResource
+</summary>
+
+[Command API Reference](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/bedrock-agentcore-control/command/UntagResourceCommand/) / [Input](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-bedrock-agentcore-control/Interface/UntagResourceCommandInput/) / [Output](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-bedrock-agentcore-control/Interface/UntagResourceCommandOutput/)
+
 </details>
 <details>
 <summary>

clients/client-bedrock-agentcore-control/src/BedrockAgentCoreControl.ts

@@ -196,6 +196,11 @@ import {
   ListOauth2CredentialProvidersCommandInput,
   ListOauth2CredentialProvidersCommandOutput,
 } from "./commands/ListOauth2CredentialProvidersCommand";
+import {
+  ListTagsForResourceCommand,
+  ListTagsForResourceCommandInput,
+  ListTagsForResourceCommandOutput,
+} from "./commands/ListTagsForResourceCommand";
 import {
   ListWorkloadIdentitiesCommand,
   ListWorkloadIdentitiesCommandInput,
@@ -206,6 +211,12 @@ import {
   SetTokenVaultCMKCommandInput,
   SetTokenVaultCMKCommandOutput,
 } from "./commands/SetTokenVaultCMKCommand";
+import { TagResourceCommand, TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
+import {
+  UntagResourceCommand,
+  UntagResourceCommandInput,
+  UntagResourceCommandOutput,
+} from "./commands/UntagResourceCommand";
 import {
   UpdateAgentRuntimeCommand,
   UpdateAgentRuntimeCommandInput,
@@ -289,8 +300,11 @@ const commands = {
   ListGatewayTargetsCommand,
   ListMemoriesCommand,
   ListOauth2CredentialProvidersCommand,
+  ListTagsForResourceCommand,
   ListWorkloadIdentitiesCommand,
   SetTokenVaultCMKCommand,
+  TagResourceCommand,
+  UntagResourceCommand,
   UpdateAgentRuntimeCommand,
   UpdateAgentRuntimeEndpointCommand,
   UpdateApiKeyCredentialProviderCommand,
@@ -926,6 +940,23 @@ export interface BedrockAgentCoreControl {
     cb: (err: any, data?: ListOauth2CredentialProvidersCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link ListTagsForResourceCommand}
+   */
+  listTagsForResource(
+    args: ListTagsForResourceCommandInput,
+    options?: __HttpHandlerOptions
+  ): Promise<ListTagsForResourceCommandOutput>;
+  listTagsForResource(
+    args: ListTagsForResourceCommandInput,
+    cb: (err: any, data?: ListTagsForResourceCommandOutput) => void
+  ): void;
+  listTagsForResource(
+    args: ListTagsForResourceCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: ListTagsForResourceCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link ListWorkloadIdentitiesCommand}
    */
@@ -961,6 +992,28 @@ export interface BedrockAgentCoreControl {
     cb: (err: any, data?: SetTokenVaultCMKCommandOutput) => void
   ): void;
 
+  /**
+   * @see {@link TagResourceCommand}
+   */
+  tagResource(args: TagResourceCommandInput, options?: __HttpHandlerOptions): Promise<TagResourceCommandOutput>;
+  tagResource(args: TagResourceCommandInput, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
+  tagResource(
+    args: TagResourceCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: TagResourceCommandOutput) => void
+  ): void;
+
+  /**
+   * @see {@link UntagResourceCommand}
+   */
+  untagResource(args: UntagResourceCommandInput, options?: __HttpHandlerOptions): Promise<UntagResourceCommandOutput>;
+  untagResource(args: UntagResourceCommandInput, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
+  untagResource(
+    args: UntagResourceCommandInput,
+    options: __HttpHandlerOptions,
+    cb: (err: any, data?: UntagResourceCommandOutput) => void
+  ): void;
+
   /**
    * @see {@link UpdateAgentRuntimeCommand}
    */
@@ -1087,7 +1140,7 @@ export interface BedrockAgentCoreControl {
 }
 
 /**
- * <note> <p>Amazon Bedrock AgentCore is in preview release and is subject to change.</p> </note> <p>Amazon Bedrock Agent Core Control is a service that enables you to manage memory resources for your Amazon Bedrock agents.</p> <p>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.</p>
+ * <note> <p> is in preview release and is subject to change.</p> </note> <p>Welcome to the Amazon Bedrock AgentCore Control plane API reference. Control plane actions configure, create, modify, and monitor Amazon Web Services resources.</p>
  * @public
  */
 export class BedrockAgentCoreControl extends BedrockAgentCoreControlClient implements BedrockAgentCoreControl {}

clients/client-bedrock-agentcore-control/src/BedrockAgentCoreControlClient.ts

@@ -157,11 +157,17 @@ import {
   ListOauth2CredentialProvidersCommandInput,
   ListOauth2CredentialProvidersCommandOutput,
 } from "./commands/ListOauth2CredentialProvidersCommand";
+import {
+  ListTagsForResourceCommandInput,
+  ListTagsForResourceCommandOutput,
+} from "./commands/ListTagsForResourceCommand";
 import {
   ListWorkloadIdentitiesCommandInput,
   ListWorkloadIdentitiesCommandOutput,
 } from "./commands/ListWorkloadIdentitiesCommand";
 import { SetTokenVaultCMKCommandInput, SetTokenVaultCMKCommandOutput } from "./commands/SetTokenVaultCMKCommand";
+import { TagResourceCommandInput, TagResourceCommandOutput } from "./commands/TagResourceCommand";
+import { UntagResourceCommandInput, UntagResourceCommandOutput } from "./commands/UntagResourceCommand";
 import { UpdateAgentRuntimeCommandInput, UpdateAgentRuntimeCommandOutput } from "./commands/UpdateAgentRuntimeCommand";
 import {
   UpdateAgentRuntimeEndpointCommandInput,
@@ -241,8 +247,11 @@ export type ServiceInputTypes =
   | ListGatewaysCommandInput
   | ListMemoriesCommandInput
   | ListOauth2CredentialProvidersCommandInput
+  | ListTagsForResourceCommandInput
   | ListWorkloadIdentitiesCommandInput
   | SetTokenVaultCMKCommandInput
+  | TagResourceCommandInput
+  | UntagResourceCommandInput
   | UpdateAgentRuntimeCommandInput
   | UpdateAgentRuntimeEndpointCommandInput
   | UpdateApiKeyCredentialProviderCommandInput
@@ -297,8 +306,11 @@ export type ServiceOutputTypes =
   | ListGatewaysCommandOutput
   | ListMemoriesCommandOutput
   | ListOauth2CredentialProvidersCommandOutput
+  | ListTagsForResourceCommandOutput
   | ListWorkloadIdentitiesCommandOutput
   | SetTokenVaultCMKCommandOutput
+  | TagResourceCommandOutput
+  | UntagResourceCommandOutput
   | UpdateAgentRuntimeCommandOutput
   | UpdateAgentRuntimeEndpointCommandOutput
   | UpdateApiKeyCredentialProviderCommandOutput
@@ -499,7 +511,7 @@ export type BedrockAgentCoreControlClientResolvedConfigType = __SmithyResolvedCo
 export interface BedrockAgentCoreControlClientResolvedConfig extends BedrockAgentCoreControlClientResolvedConfigType {}
 
 /**
- * <note> <p>Amazon Bedrock AgentCore is in preview release and is subject to change.</p> </note> <p>Amazon Bedrock Agent Core Control is a service that enables you to manage memory resources for your Amazon Bedrock agents.</p> <p>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.</p>
+ * <note> <p> is in preview release and is subject to change.</p> </note> <p>Welcome to the Amazon Bedrock AgentCore Control plane API reference. Control plane actions configure, create, modify, and monitor Amazon Web Services resources.</p>
  * @public
  */
 export class BedrockAgentCoreControlClient extends __Client<

clients/client-bedrock-agentcore-control/src/commands/CreateAgentRuntimeCommand.ts

@@ -36,7 +36,7 @@ export interface CreateAgentRuntimeCommandInput extends CreateAgentRuntimeReques
 export interface CreateAgentRuntimeCommandOutput extends CreateAgentRuntimeResponse, __MetadataBearer {}
 
 /**
- * <p>Creates an Amazon Secure Agent.</p>
+ * <p>Creates an Amazon Bedrock AgentCore Runtime.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -48,14 +48,22 @@ export interface CreateAgentRuntimeCommandOutput extends CreateAgentRuntimeRespo
  * const input = { // CreateAgentRuntimeRequest
  *   agentRuntimeName: "STRING_VALUE", // required
  *   description: "STRING_VALUE",
- *   agentRuntimeArtifact: { // AgentArtifact Union: only one key present
+ *   agentRuntimeArtifact: { // AgentRuntimeArtifact Union: only one key present
  *     containerConfiguration: { // ContainerConfiguration
  *       containerUri: "STRING_VALUE", // required
  *     },
  *   },
  *   roleArn: "STRING_VALUE", // required
  *   networkConfiguration: { // NetworkConfiguration
- *     networkMode: "PUBLIC", // required
+ *     networkMode: "PUBLIC" || "VPC", // required
+ *     networkModeConfig: { // VpcConfig
+ *       securityGroups: [ // SecurityGroups // required
+ *         "STRING_VALUE",
+ *       ],
+ *       subnets: [ // Subnets // required
+ *         "STRING_VALUE",
+ *       ],
+ *     },
  *   },
  *   protocolConfiguration: { // ProtocolConfiguration
  *     serverProtocol: "MCP" || "HTTP", // required
@@ -75,6 +83,14 @@ export interface CreateAgentRuntimeCommandOutput extends CreateAgentRuntimeRespo
  *       ],
  *     },
  *   },
+ *   requestHeaderConfiguration: { // RequestHeaderConfiguration Union: only one key present
+ *     requestHeaderAllowlist: [ // RequestHeaderAllowlist
+ *       "STRING_VALUE",
+ *     ],
+ *   },
+ *   tags: { // TagsMap
+ *     "<keys>": "STRING_VALUE",
+ *   },
  * };
  * const command = new CreateAgentRuntimeCommand(input);
  * const response = await client.send(command);

clients/client-bedrock-agentcore-control/src/commands/CreateAgentRuntimeEndpointCommand.ts

@@ -36,7 +36,7 @@ export interface CreateAgentRuntimeEndpointCommandInput extends CreateAgentRunti
 export interface CreateAgentRuntimeEndpointCommandOutput extends CreateAgentRuntimeEndpointResponse, __MetadataBearer {}
 
 /**
- * <p>Creates an Amazon Secure AgentEndpoint.</p>
+ * <p>Creates an AgentCore Runtime endpoint.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -51,6 +51,9 @@ export interface CreateAgentRuntimeEndpointCommandOutput extends CreateAgentRunt
  *   agentRuntimeVersion: "STRING_VALUE",
  *   description: "STRING_VALUE",
  *   clientToken: "STRING_VALUE",
+ *   tags: { // TagsMap
+ *     "<keys>": "STRING_VALUE",
+ *   },
  * };
  * const command = new CreateAgentRuntimeEndpointCommand(input);
  * const response = await client.send(command);

clients/client-bedrock-agentcore-control/src/commands/CreateBrowserCommand.ts

@@ -50,7 +50,15 @@ export interface CreateBrowserCommandOutput extends CreateBrowserResponse, __Met
  *   description: "STRING_VALUE",
  *   executionRoleArn: "STRING_VALUE",
  *   networkConfiguration: { // BrowserNetworkConfiguration
- *     networkMode: "PUBLIC", // required
+ *     networkMode: "PUBLIC" || "VPC", // required
+ *     vpcConfig: { // VpcConfig
+ *       securityGroups: [ // SecurityGroups // required
+ *         "STRING_VALUE",
+ *       ],
+ *       subnets: [ // Subnets // required
+ *         "STRING_VALUE",
+ *       ],
+ *     },
  *   },
  *   recording: { // RecordingConfig
  *     enabled: true || false,
@@ -60,6 +68,9 @@ export interface CreateBrowserCommandOutput extends CreateBrowserResponse, __Met
  *     },
  *   },
  *   clientToken: "STRING_VALUE",
+ *   tags: { // TagsMap
+ *     "<keys>": "STRING_VALUE",
+ *   },
  * };
  * const command = new CreateBrowserCommand(input);
  * const response = await client.send(command);

clients/client-bedrock-agentcore-control/src/commands/CreateCodeInterpreterCommand.ts

@@ -50,9 +50,20 @@ export interface CreateCodeInterpreterCommandOutput extends CreateCodeInterprete
  *   description: "STRING_VALUE",
  *   executionRoleArn: "STRING_VALUE",
  *   networkConfiguration: { // CodeInterpreterNetworkConfiguration
- *     networkMode: "PUBLIC" || "SANDBOX", // required
+ *     networkMode: "PUBLIC" || "SANDBOX" || "VPC", // required
+ *     vpcConfig: { // VpcConfig
+ *       securityGroups: [ // SecurityGroups // required
+ *         "STRING_VALUE",
+ *       ],
+ *       subnets: [ // Subnets // required
+ *         "STRING_VALUE",
+ *       ],
+ *     },
  *   },
  *   clientToken: "STRING_VALUE",
+ *   tags: { // TagsMap
+ *     "<keys>": "STRING_VALUE",
+ *   },
  * };
  * const command = new CreateCodeInterpreterCommand(input);
  * const response = await client.send(command);

clients/client-bedrock-agentcore-control/src/commands/CreateGatewayTargetCommand.ts

@@ -37,7 +37,7 @@ export interface CreateGatewayTargetCommandInput extends CreateGatewayTargetRequ
 export interface CreateGatewayTargetCommandOutput extends CreateGatewayTargetResponse, __MetadataBearer {}
 
 /**
- * <p>Creates a target for a gateway. A target defines an endpoint that the gateway can connect to.</p> <p>To create a target, you must specify the gateway identifier and target configuration.</p>
+ * <p>Creates a target for a gateway. A target defines an endpoint that the gateway can connect to.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-bedrock-agentcore-control/src/commands/CreateMemoryCommand.ts

@@ -37,7 +37,7 @@ export interface CreateMemoryCommandInput extends CreateMemoryInput {}
 export interface CreateMemoryCommandOutput extends CreateMemoryOutput, __MetadataBearer {}
 
 /**
- * <p>Creates a new memory.</p>
+ * <p>Creates a new Amazon Bedrock AgentCore Memory resource.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

clients/client-bedrock-agentcore-control/src/commands/DeleteAgentRuntimeCommand.ts

@@ -32,7 +32,7 @@ export interface DeleteAgentRuntimeCommandInput extends DeleteAgentRuntimeReques
 export interface DeleteAgentRuntimeCommandOutput extends DeleteAgentRuntimeResponse, __MetadataBearer {}
 
 /**
- * <p>Deletes an Amazon Secure Agent.</p>
+ * <p>Deletes an Amazon Bedrock AgentCore Runtime.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript