@aws-sdk/client-bedrock-agentcore-control 3.1051.0 → 3.1053.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (85) hide show
  1. package/README.md +77 -0
  2. package/dist-cjs/index.js +188 -2
  3. package/dist-cjs/schemas/schemas_0.js +334 -92
  4. package/dist-es/BedrockAgentCoreControl.js +28 -0
  5. package/dist-es/commands/AddDatasetExamplesCommand.js +16 -0
  6. package/dist-es/commands/CreateDatasetCommand.js +16 -0
  7. package/dist-es/commands/CreateDatasetVersionCommand.js +16 -0
  8. package/dist-es/commands/DeleteDatasetCommand.js +16 -0
  9. package/dist-es/commands/DeleteDatasetExamplesCommand.js +16 -0
  10. package/dist-es/commands/GetDatasetCommand.js +16 -0
  11. package/dist-es/commands/ListDatasetExamplesCommand.js +16 -0
  12. package/dist-es/commands/ListDatasetVersionsCommand.js +16 -0
  13. package/dist-es/commands/ListDatasetsCommand.js +16 -0
  14. package/dist-es/commands/UpdateDatasetCommand.js +16 -0
  15. package/dist-es/commands/UpdateDatasetExamplesCommand.js +16 -0
  16. package/dist-es/commands/index.js +11 -0
  17. package/dist-es/index.js +1 -0
  18. package/dist-es/models/enums.js +19 -2
  19. package/dist-es/models/models_2.js +1 -0
  20. package/dist-es/pagination/ListDatasetExamplesPaginator.js +4 -0
  21. package/dist-es/pagination/ListDatasetVersionsPaginator.js +4 -0
  22. package/dist-es/pagination/ListDatasetsPaginator.js +4 -0
  23. package/dist-es/pagination/index.js +3 -0
  24. package/dist-es/schemas/schemas_0.js +318 -77
  25. package/dist-types/BedrockAgentCoreControl.d.ts +99 -0
  26. package/dist-types/BedrockAgentCoreControlClient.d.ts +13 -2
  27. package/dist-types/commands/AddDatasetExamplesCommand.d.ts +127 -0
  28. package/dist-types/commands/CreateDatasetCommand.d.ts +117 -0
  29. package/dist-types/commands/CreateDatasetVersionCommand.d.ts +113 -0
  30. package/dist-types/commands/CreateGatewayTargetCommand.d.ts +1 -1
  31. package/dist-types/commands/DeleteDatasetCommand.d.ts +123 -0
  32. package/dist-types/commands/DeleteDatasetExamplesCommand.d.ts +112 -0
  33. package/dist-types/commands/GetDatasetCommand.d.ts +130 -0
  34. package/dist-types/commands/GetGatewayTargetCommand.d.ts +1 -1
  35. package/dist-types/commands/ListDatasetExamplesCommand.d.ts +111 -0
  36. package/dist-types/commands/ListDatasetVersionsCommand.d.ts +103 -0
  37. package/dist-types/commands/ListDatasetsCommand.d.ts +103 -0
  38. package/dist-types/commands/ListWorkloadIdentitiesCommand.d.ts +2 -1
  39. package/dist-types/commands/SynchronizeGatewayTargetsCommand.d.ts +1 -1
  40. package/dist-types/commands/UpdateDatasetCommand.d.ts +104 -0
  41. package/dist-types/commands/UpdateDatasetExamplesCommand.d.ts +120 -0
  42. package/dist-types/commands/UpdateGatewayTargetCommand.d.ts +1 -1
  43. package/dist-types/commands/UpdateWorkloadIdentityCommand.d.ts +1 -1
  44. package/dist-types/commands/index.d.ts +11 -0
  45. package/dist-types/index.d.ts +1 -0
  46. package/dist-types/models/enums.d.ts +91 -3
  47. package/dist-types/models/models_0.d.ts +2382 -2324
  48. package/dist-types/models/models_1.d.ts +4111 -4197
  49. package/dist-types/models/models_2.d.ts +775 -0
  50. package/dist-types/pagination/ListDatasetExamplesPaginator.d.ts +7 -0
  51. package/dist-types/pagination/ListDatasetVersionsPaginator.d.ts +7 -0
  52. package/dist-types/pagination/ListDatasetsPaginator.d.ts +7 -0
  53. package/dist-types/pagination/index.d.ts +3 -0
  54. package/dist-types/schemas/schemas_0.d.ts +38 -0
  55. package/dist-types/ts3.4/BedrockAgentCoreControl.d.ts +209 -0
  56. package/dist-types/ts3.4/BedrockAgentCoreControlClient.d.ts +66 -0
  57. package/dist-types/ts3.4/commands/AddDatasetExamplesCommand.d.ts +53 -0
  58. package/dist-types/ts3.4/commands/CreateDatasetCommand.d.ts +52 -0
  59. package/dist-types/ts3.4/commands/CreateDatasetVersionCommand.d.ts +53 -0
  60. package/dist-types/ts3.4/commands/CreateGatewayTargetCommand.d.ts +1 -1
  61. package/dist-types/ts3.4/commands/DeleteDatasetCommand.d.ts +52 -0
  62. package/dist-types/ts3.4/commands/DeleteDatasetExamplesCommand.d.ts +53 -0
  63. package/dist-types/ts3.4/commands/GetDatasetCommand.d.ts +49 -0
  64. package/dist-types/ts3.4/commands/GetGatewayTargetCommand.d.ts +1 -1
  65. package/dist-types/ts3.4/commands/ListDatasetExamplesCommand.d.ts +53 -0
  66. package/dist-types/ts3.4/commands/ListDatasetVersionsCommand.d.ts +53 -0
  67. package/dist-types/ts3.4/commands/ListDatasetsCommand.d.ts +49 -0
  68. package/dist-types/ts3.4/commands/ListWorkloadIdentitiesCommand.d.ts +2 -4
  69. package/dist-types/ts3.4/commands/SynchronizeGatewayTargetsCommand.d.ts +1 -1
  70. package/dist-types/ts3.4/commands/UpdateDatasetCommand.d.ts +52 -0
  71. package/dist-types/ts3.4/commands/UpdateDatasetExamplesCommand.d.ts +53 -0
  72. package/dist-types/ts3.4/commands/UpdateGatewayTargetCommand.d.ts +1 -1
  73. package/dist-types/ts3.4/commands/UpdateWorkloadIdentityCommand.d.ts +1 -1
  74. package/dist-types/ts3.4/commands/index.d.ts +11 -0
  75. package/dist-types/ts3.4/index.d.ts +1 -0
  76. package/dist-types/ts3.4/models/enums.d.ts +25 -4
  77. package/dist-types/ts3.4/models/models_0.d.ts +192 -269
  78. package/dist-types/ts3.4/models/models_1.d.ts +268 -284
  79. package/dist-types/ts3.4/models/models_2.d.ts +273 -0
  80. package/dist-types/ts3.4/pagination/ListDatasetExamplesPaginator.d.ts +11 -0
  81. package/dist-types/ts3.4/pagination/ListDatasetVersionsPaginator.d.ts +11 -0
  82. package/dist-types/ts3.4/pagination/ListDatasetsPaginator.d.ts +11 -0
  83. package/dist-types/ts3.4/pagination/index.d.ts +3 -0
  84. package/dist-types/ts3.4/schemas/schemas_0.d.ts +38 -0
  85. package/package.json +8 -8
@@ -0,0 +1,113 @@
1
+ import { Command as $Command } from "@smithy/core/client";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../BedrockAgentCoreControlClient";
4
+ import type { CreateDatasetVersionRequest, CreateDatasetVersionResponse } from "../models/models_0";
5
+ /**
6
+ * @public
7
+ */
8
+ export type { __MetadataBearer };
9
+ export { $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link CreateDatasetVersionCommand}.
14
+ */
15
+ export interface CreateDatasetVersionCommandInput extends CreateDatasetVersionRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link CreateDatasetVersionCommand}.
21
+ */
22
+ export interface CreateDatasetVersionCommandOutput extends CreateDatasetVersionResponse, __MetadataBearer {
23
+ }
24
+ declare const CreateDatasetVersionCommand_base: {
25
+ new (input: CreateDatasetVersionCommandInput): import("@smithy/core/client").CommandImpl<CreateDatasetVersionCommandInput, CreateDatasetVersionCommandOutput, BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
26
+ new (input: CreateDatasetVersionCommandInput): import("@smithy/core/client").CommandImpl<CreateDatasetVersionCommandInput, CreateDatasetVersionCommandOutput, BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
27
+ getEndpointParameterInstructions(): {
28
+ [x: string]: unknown;
29
+ };
30
+ };
31
+ /**
32
+ * Publishes the current DRAFT as a new numbered version.
33
+ *
34
+ * Snapshots the DRAFT examples as the next version (1, 2, 3, ...).
35
+ * The DRAFT is preserved and remains editable after publishing.
36
+ * Returns immediately with status UPDATING. Poll GetDataset until
37
+ * status transitions to ACTIVE (draftStatus=UNMODIFIED) or UPDATE_FAILED.
38
+ *
39
+ * **State guard:** Returns ConflictException (DATASET_NOT_READY) if status is in
40
+ * \{CREATING, UPDATING, DELETING\}, or DATASET_IN_FAILED_STATE if status is in
41
+ * \{CREATE_FAILED, DELETE_FAILED\}.
42
+ *
43
+ * **Quota:** MAX_VERSIONS_PER_DATASET applies to published versions only (not DRAFT).
44
+ * @example
45
+ * Use a bare-bones client and the command you need to make an API call.
46
+ * ```javascript
47
+ * import { BedrockAgentCoreControlClient, CreateDatasetVersionCommand } from "@aws-sdk/client-bedrock-agentcore-control"; // ES Modules import
48
+ * // const { BedrockAgentCoreControlClient, CreateDatasetVersionCommand } = require("@aws-sdk/client-bedrock-agentcore-control"); // CommonJS import
49
+ * // import type { BedrockAgentCoreControlClientConfig } from "@aws-sdk/client-bedrock-agentcore-control";
50
+ * const config = {}; // type is BedrockAgentCoreControlClientConfig
51
+ * const client = new BedrockAgentCoreControlClient(config);
52
+ * const input = { // CreateDatasetVersionRequest
53
+ * datasetId: "STRING_VALUE", // required
54
+ * clientToken: "STRING_VALUE",
55
+ * };
56
+ * const command = new CreateDatasetVersionCommand(input);
57
+ * const response = await client.send(command);
58
+ * // { // CreateDatasetVersionResponse
59
+ * // datasetArn: "STRING_VALUE", // required
60
+ * // datasetId: "STRING_VALUE", // required
61
+ * // status: "CREATING" || "UPDATING" || "DELETING" || "ACTIVE" || "CREATE_FAILED" || "UPDATE_FAILED" || "DELETE_FAILED", // required
62
+ * // datasetVersion: "STRING_VALUE", // required
63
+ * // createdAt: new Date("TIMESTAMP"), // required
64
+ * // };
65
+ *
66
+ * ```
67
+ *
68
+ * @param CreateDatasetVersionCommandInput - {@link CreateDatasetVersionCommandInput}
69
+ * @returns {@link CreateDatasetVersionCommandOutput}
70
+ * @see {@link CreateDatasetVersionCommandInput} for command's `input` shape.
71
+ * @see {@link CreateDatasetVersionCommandOutput} for command's `response` shape.
72
+ * @see {@link BedrockAgentCoreControlClientResolvedConfig | config} for BedrockAgentCoreControlClient's `config` shape.
73
+ *
74
+ * @throws {@link AccessDeniedException} (client fault)
75
+ * <p>This exception is thrown when a request is denied per access permissions</p>
76
+ *
77
+ * @throws {@link ConflictException} (client fault)
78
+ * <p>This exception is thrown when there is a conflict performing an operation</p>
79
+ *
80
+ * @throws {@link InternalServerException} (server fault)
81
+ * <p>This exception is thrown if there was an unexpected error during processing of request</p>
82
+ *
83
+ * @throws {@link ResourceNotFoundException} (client fault)
84
+ * <p>This exception is thrown when a resource referenced by the operation does not exist</p>
85
+ *
86
+ * @throws {@link ServiceQuotaExceededException} (client fault)
87
+ * <p>This exception is thrown when a request is made beyond the service quota</p>
88
+ *
89
+ * @throws {@link ThrottlingException} (client fault)
90
+ * <p>This exception is thrown when the number of requests exceeds the limit</p>
91
+ *
92
+ * @throws {@link ValidationException} (client fault)
93
+ * <p>The input fails to satisfy the constraints specified by the service.</p>
94
+ *
95
+ * @throws {@link BedrockAgentCoreControlServiceException}
96
+ * <p>Base exception class for all service exceptions from BedrockAgentCoreControl service.</p>
97
+ *
98
+ *
99
+ * @public
100
+ */
101
+ export declare class CreateDatasetVersionCommand extends CreateDatasetVersionCommand_base {
102
+ /** @internal type navigation helper, not in runtime. */
103
+ protected static __types: {
104
+ api: {
105
+ input: CreateDatasetVersionRequest;
106
+ output: CreateDatasetVersionResponse;
107
+ };
108
+ sdk: {
109
+ input: CreateDatasetVersionCommandInput;
110
+ output: CreateDatasetVersionCommandOutput;
111
+ };
112
+ };
113
+ }
@@ -1,7 +1,7 @@
1
1
  import { Command as $Command } from "@smithy/core/client";
2
2
  import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
3
  import type { BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../BedrockAgentCoreControlClient";
4
- import type { CreateGatewayTargetRequest, CreateGatewayTargetResponse } from "../models/models_1";
4
+ import type { CreateGatewayTargetRequest, CreateGatewayTargetResponse } from "../models/models_2";
5
5
  /**
6
6
  * @public
7
7
  */
@@ -0,0 +1,123 @@
1
+ import { Command as $Command } from "@smithy/core/client";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../BedrockAgentCoreControlClient";
4
+ import type { DeleteDatasetRequest, DeleteDatasetResponse } from "../models/models_0";
5
+ /**
6
+ * @public
7
+ */
8
+ export type { __MetadataBearer };
9
+ export { $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link DeleteDatasetCommand}.
14
+ */
15
+ export interface DeleteDatasetCommandInput extends DeleteDatasetRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link DeleteDatasetCommand}.
21
+ */
22
+ export interface DeleteDatasetCommandOutput extends DeleteDatasetResponse, __MetadataBearer {
23
+ }
24
+ declare const DeleteDatasetCommand_base: {
25
+ new (input: DeleteDatasetCommandInput): import("@smithy/core/client").CommandImpl<DeleteDatasetCommandInput, DeleteDatasetCommandOutput, BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
26
+ new (input: DeleteDatasetCommandInput): import("@smithy/core/client").CommandImpl<DeleteDatasetCommandInput, DeleteDatasetCommandOutput, BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
27
+ getEndpointParameterInstructions(): {
28
+ [x: string]: unknown;
29
+ };
30
+ };
31
+ /**
32
+ * Deletes a dataset version or an entire dataset (all versions + name claim). Asynchronous 202.
33
+ *
34
+ * **State transitions:**
35
+ * - If `datasetVersion` is absent (full delete): status transitions to DELETING immediately.
36
+ * - If `datasetVersion` is provided (version-specific delete): status transitions to UPDATING.
37
+ *
38
+ * **State guard (full delete):** Returns ConflictException (DATASET_NOT_READY) if the
39
+ * dataset status is in \{CREATING, UPDATING\}. Deletion is allowed from ACTIVE, CREATE_FAILED,
40
+ * UPDATE_FAILED, and DELETE_FAILED states.
41
+ *
42
+ * **State guard (version-specific delete):** Returns ConflictException (DATASET_NOT_READY) if
43
+ * the dataset status is not in \{ACTIVE, CREATE_FAILED, UPDATE_FAILED\}.
44
+ *
45
+ * Fails with ConflictException (REFERENCED_BY_EVAL_JOB) if referenced by an active
46
+ * evaluation job (full delete only).
47
+ *
48
+ * If the delete workflow fails after retries, status is set to DELETE_FAILED (full delete)
49
+ * or UPDATE_FAILED (version-specific delete).
50
+ * Calling DeleteDataset on a DELETE_FAILED dataset re-triggers the delete workflow
51
+ * (idempotent retry path).
52
+ *
53
+ * **Version parameter:**
54
+ * - If `datasetVersion` is absent: deletes ALL versions and the Dataset record itself.
55
+ * - If `datasetVersion` is provided: deletes only that specific DatasetVersion.
56
+ * Returns ResourceNotFoundException if the specified version does not exist.
57
+ * @example
58
+ * Use a bare-bones client and the command you need to make an API call.
59
+ * ```javascript
60
+ * import { BedrockAgentCoreControlClient, DeleteDatasetCommand } from "@aws-sdk/client-bedrock-agentcore-control"; // ES Modules import
61
+ * // const { BedrockAgentCoreControlClient, DeleteDatasetCommand } = require("@aws-sdk/client-bedrock-agentcore-control"); // CommonJS import
62
+ * // import type { BedrockAgentCoreControlClientConfig } from "@aws-sdk/client-bedrock-agentcore-control";
63
+ * const config = {}; // type is BedrockAgentCoreControlClientConfig
64
+ * const client = new BedrockAgentCoreControlClient(config);
65
+ * const input = { // DeleteDatasetRequest
66
+ * datasetId: "STRING_VALUE", // required
67
+ * datasetVersion: "STRING_VALUE",
68
+ * };
69
+ * const command = new DeleteDatasetCommand(input);
70
+ * const response = await client.send(command);
71
+ * // { // DeleteDatasetResponse
72
+ * // datasetArn: "STRING_VALUE", // required
73
+ * // datasetId: "STRING_VALUE", // required
74
+ * // status: "CREATING" || "UPDATING" || "DELETING" || "ACTIVE" || "CREATE_FAILED" || "UPDATE_FAILED" || "DELETE_FAILED", // required
75
+ * // datasetVersion: "STRING_VALUE", // required
76
+ * // updatedAt: new Date("TIMESTAMP"), // required
77
+ * // };
78
+ *
79
+ * ```
80
+ *
81
+ * @param DeleteDatasetCommandInput - {@link DeleteDatasetCommandInput}
82
+ * @returns {@link DeleteDatasetCommandOutput}
83
+ * @see {@link DeleteDatasetCommandInput} for command's `input` shape.
84
+ * @see {@link DeleteDatasetCommandOutput} for command's `response` shape.
85
+ * @see {@link BedrockAgentCoreControlClientResolvedConfig | config} for BedrockAgentCoreControlClient's `config` shape.
86
+ *
87
+ * @throws {@link AccessDeniedException} (client fault)
88
+ * <p>This exception is thrown when a request is denied per access permissions</p>
89
+ *
90
+ * @throws {@link ConflictException} (client fault)
91
+ * <p>This exception is thrown when there is a conflict performing an operation</p>
92
+ *
93
+ * @throws {@link InternalServerException} (server fault)
94
+ * <p>This exception is thrown if there was an unexpected error during processing of request</p>
95
+ *
96
+ * @throws {@link ResourceNotFoundException} (client fault)
97
+ * <p>This exception is thrown when a resource referenced by the operation does not exist</p>
98
+ *
99
+ * @throws {@link ThrottlingException} (client fault)
100
+ * <p>This exception is thrown when the number of requests exceeds the limit</p>
101
+ *
102
+ * @throws {@link ValidationException} (client fault)
103
+ * <p>The input fails to satisfy the constraints specified by the service.</p>
104
+ *
105
+ * @throws {@link BedrockAgentCoreControlServiceException}
106
+ * <p>Base exception class for all service exceptions from BedrockAgentCoreControl service.</p>
107
+ *
108
+ *
109
+ * @public
110
+ */
111
+ export declare class DeleteDatasetCommand extends DeleteDatasetCommand_base {
112
+ /** @internal type navigation helper, not in runtime. */
113
+ protected static __types: {
114
+ api: {
115
+ input: DeleteDatasetRequest;
116
+ output: DeleteDatasetResponse;
117
+ };
118
+ sdk: {
119
+ input: DeleteDatasetCommandInput;
120
+ output: DeleteDatasetCommandOutput;
121
+ };
122
+ };
123
+ }
@@ -0,0 +1,112 @@
1
+ import { Command as $Command } from "@smithy/core/client";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../BedrockAgentCoreControlClient";
4
+ import type { DeleteDatasetExamplesRequest, DeleteDatasetExamplesResponse } from "../models/models_0";
5
+ /**
6
+ * @public
7
+ */
8
+ export type { __MetadataBearer };
9
+ export { $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link DeleteDatasetExamplesCommand}.
14
+ */
15
+ export interface DeleteDatasetExamplesCommandInput extends DeleteDatasetExamplesRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link DeleteDatasetExamplesCommand}.
21
+ */
22
+ export interface DeleteDatasetExamplesCommandOutput extends DeleteDatasetExamplesResponse, __MetadataBearer {
23
+ }
24
+ declare const DeleteDatasetExamplesCommand_base: {
25
+ new (input: DeleteDatasetExamplesCommandInput): import("@smithy/core/client").CommandImpl<DeleteDatasetExamplesCommandInput, DeleteDatasetExamplesCommandOutput, BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
26
+ new (input: DeleteDatasetExamplesCommandInput): import("@smithy/core/client").CommandImpl<DeleteDatasetExamplesCommandInput, DeleteDatasetExamplesCommandOutput, BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
27
+ getEndpointParameterInstructions(): {
28
+ [x: string]: unknown;
29
+ };
30
+ };
31
+ /**
32
+ * Deletes specific examples by ID from DRAFT.
33
+ *
34
+ * **Validation:** All example IDs are validated before any deletes occur. If any ID
35
+ * does not exist in DRAFT, the entire batch is rejected with ResourceNotFoundException —
36
+ * no examples are deleted (all-or-nothing semantics).
37
+ *
38
+ * **Asynchronous:** Operates in-place on DRAFT. No version bump occurs.
39
+ * Use CreateDatasetVersion to publish DRAFT as a new numbered version.
40
+ *
41
+ * **State guard:** Returns ConflictException (DATASET_NOT_READY) if the dataset
42
+ * status is not in \{DRAFT, ACTIVE\}.
43
+ * @example
44
+ * Use a bare-bones client and the command you need to make an API call.
45
+ * ```javascript
46
+ * import { BedrockAgentCoreControlClient, DeleteDatasetExamplesCommand } from "@aws-sdk/client-bedrock-agentcore-control"; // ES Modules import
47
+ * // const { BedrockAgentCoreControlClient, DeleteDatasetExamplesCommand } = require("@aws-sdk/client-bedrock-agentcore-control"); // CommonJS import
48
+ * // import type { BedrockAgentCoreControlClientConfig } from "@aws-sdk/client-bedrock-agentcore-control";
49
+ * const config = {}; // type is BedrockAgentCoreControlClientConfig
50
+ * const client = new BedrockAgentCoreControlClient(config);
51
+ * const input = { // DeleteDatasetExamplesRequest
52
+ * datasetId: "STRING_VALUE", // required
53
+ * clientToken: "STRING_VALUE",
54
+ * exampleIds: [ // ExampleIdList // required
55
+ * "STRING_VALUE",
56
+ * ],
57
+ * };
58
+ * const command = new DeleteDatasetExamplesCommand(input);
59
+ * const response = await client.send(command);
60
+ * // { // DeleteDatasetExamplesResponse
61
+ * // datasetArn: "STRING_VALUE", // required
62
+ * // datasetId: "STRING_VALUE", // required
63
+ * // status: "CREATING" || "UPDATING" || "DELETING" || "ACTIVE" || "CREATE_FAILED" || "UPDATE_FAILED" || "DELETE_FAILED", // required
64
+ * // deletedCount: Number("long"), // required
65
+ * // updatedAt: new Date("TIMESTAMP"), // required
66
+ * // };
67
+ *
68
+ * ```
69
+ *
70
+ * @param DeleteDatasetExamplesCommandInput - {@link DeleteDatasetExamplesCommandInput}
71
+ * @returns {@link DeleteDatasetExamplesCommandOutput}
72
+ * @see {@link DeleteDatasetExamplesCommandInput} for command's `input` shape.
73
+ * @see {@link DeleteDatasetExamplesCommandOutput} for command's `response` shape.
74
+ * @see {@link BedrockAgentCoreControlClientResolvedConfig | config} for BedrockAgentCoreControlClient's `config` shape.
75
+ *
76
+ * @throws {@link AccessDeniedException} (client fault)
77
+ * <p>This exception is thrown when a request is denied per access permissions</p>
78
+ *
79
+ * @throws {@link ConflictException} (client fault)
80
+ * <p>This exception is thrown when there is a conflict performing an operation</p>
81
+ *
82
+ * @throws {@link InternalServerException} (server fault)
83
+ * <p>This exception is thrown if there was an unexpected error during processing of request</p>
84
+ *
85
+ * @throws {@link ResourceNotFoundException} (client fault)
86
+ * <p>This exception is thrown when a resource referenced by the operation does not exist</p>
87
+ *
88
+ * @throws {@link ThrottlingException} (client fault)
89
+ * <p>This exception is thrown when the number of requests exceeds the limit</p>
90
+ *
91
+ * @throws {@link ValidationException} (client fault)
92
+ * <p>The input fails to satisfy the constraints specified by the service.</p>
93
+ *
94
+ * @throws {@link BedrockAgentCoreControlServiceException}
95
+ * <p>Base exception class for all service exceptions from BedrockAgentCoreControl service.</p>
96
+ *
97
+ *
98
+ * @public
99
+ */
100
+ export declare class DeleteDatasetExamplesCommand extends DeleteDatasetExamplesCommand_base {
101
+ /** @internal type navigation helper, not in runtime. */
102
+ protected static __types: {
103
+ api: {
104
+ input: DeleteDatasetExamplesRequest;
105
+ output: DeleteDatasetExamplesResponse;
106
+ };
107
+ sdk: {
108
+ input: DeleteDatasetExamplesCommandInput;
109
+ output: DeleteDatasetExamplesCommandOutput;
110
+ };
111
+ };
112
+ }
@@ -0,0 +1,130 @@
1
+ import { Command as $Command } from "@smithy/core/client";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../BedrockAgentCoreControlClient";
4
+ import type { GetDatasetRequest, GetDatasetResponse } from "../models/models_0";
5
+ /**
6
+ * @public
7
+ */
8
+ export type { __MetadataBearer };
9
+ export { $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link GetDatasetCommand}.
14
+ */
15
+ export interface GetDatasetCommandInput extends GetDatasetRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link GetDatasetCommand}.
21
+ */
22
+ export interface GetDatasetCommandOutput extends GetDatasetResponse, __MetadataBearer {
23
+ }
24
+ declare const GetDatasetCommand_base: {
25
+ new (input: GetDatasetCommandInput): import("@smithy/core/client").CommandImpl<GetDatasetCommandInput, GetDatasetCommandOutput, BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
26
+ new (input: GetDatasetCommandInput): import("@smithy/core/client").CommandImpl<GetDatasetCommandInput, GetDatasetCommandOutput, BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
27
+ getEndpointParameterInstructions(): {
28
+ [x: string]: unknown;
29
+ };
30
+ };
31
+ /**
32
+ * Retrieves dataset metadata only.
33
+ *
34
+ * Use `?datasetVersion=DRAFT` or `?datasetVersion=N` to retrieve a specific version's metadata.
35
+ * If absent, defaults to DRAFT (the mutable working copy).
36
+ * Returns ResourceNotFoundException if the specified version is not found.
37
+ *
38
+ * **Initial state after CreateDataset:** When CreateDataset completes successfully
39
+ * (status transitions to ACTIVE), only a DRAFT working copy exists. No published
40
+ * versions exist until CreateDatasetVersion is called. At this point draftStatus is
41
+ * MODIFIED because the DRAFT has content that has never been published.
42
+ *
43
+ * **Default version behavior:** When `datasetVersion` is omitted, the operation
44
+ * returns the DRAFT working copy. To retrieve a specific published version, pass
45
+ * the version number as a string (e.g. `?datasetVersion=1`).
46
+ *
47
+ * **State guard:** Allowed for all statuses including DELETING. Returns the dataset
48
+ * record with its current status so callers can observe the deletion in progress.
49
+ *
50
+ * For paginated example IDs use ListDatasetExamples.
51
+ * @example
52
+ * Use a bare-bones client and the command you need to make an API call.
53
+ * ```javascript
54
+ * import { BedrockAgentCoreControlClient, GetDatasetCommand } from "@aws-sdk/client-bedrock-agentcore-control"; // ES Modules import
55
+ * // const { BedrockAgentCoreControlClient, GetDatasetCommand } = require("@aws-sdk/client-bedrock-agentcore-control"); // CommonJS import
56
+ * // import type { BedrockAgentCoreControlClientConfig } from "@aws-sdk/client-bedrock-agentcore-control";
57
+ * const config = {}; // type is BedrockAgentCoreControlClientConfig
58
+ * const client = new BedrockAgentCoreControlClient(config);
59
+ * const input = { // GetDatasetRequest
60
+ * datasetId: "STRING_VALUE", // required
61
+ * datasetVersion: "STRING_VALUE",
62
+ * };
63
+ * const command = new GetDatasetCommand(input);
64
+ * const response = await client.send(command);
65
+ * // { // GetDatasetResponse
66
+ * // datasetArn: "STRING_VALUE", // required
67
+ * // datasetId: "STRING_VALUE", // required
68
+ * // datasetVersion: "STRING_VALUE", // required
69
+ * // datasetName: "STRING_VALUE", // required
70
+ * // description: "STRING_VALUE",
71
+ * // status: "CREATING" || "UPDATING" || "DELETING" || "ACTIVE" || "CREATE_FAILED" || "UPDATE_FAILED" || "DELETE_FAILED", // required
72
+ * // draftStatus: "MODIFIED" || "UNMODIFIED",
73
+ * // failureReason: "STRING_VALUE",
74
+ * // schemaType: "AGENTCORE_EVALUATION_PREDEFINED_V1" || "AGENTCORE_EVALUATION_SIMULATED_V1", // required
75
+ * // kmsKeyArn: "STRING_VALUE",
76
+ * // exampleCount: Number("long"), // required
77
+ * // downloadUrl: "STRING_VALUE",
78
+ * // downloadUrlExpiresAt: new Date("TIMESTAMP"),
79
+ * // createdAt: new Date("TIMESTAMP"), // required
80
+ * // updatedAt: new Date("TIMESTAMP"), // required
81
+ * // tags: { // TagsMap
82
+ * // "<keys>": "STRING_VALUE",
83
+ * // },
84
+ * // };
85
+ *
86
+ * ```
87
+ *
88
+ * @param GetDatasetCommandInput - {@link GetDatasetCommandInput}
89
+ * @returns {@link GetDatasetCommandOutput}
90
+ * @see {@link GetDatasetCommandInput} for command's `input` shape.
91
+ * @see {@link GetDatasetCommandOutput} for command's `response` shape.
92
+ * @see {@link BedrockAgentCoreControlClientResolvedConfig | config} for BedrockAgentCoreControlClient's `config` shape.
93
+ *
94
+ * @throws {@link AccessDeniedException} (client fault)
95
+ * <p>This exception is thrown when a request is denied per access permissions</p>
96
+ *
97
+ * @throws {@link ConflictException} (client fault)
98
+ * <p>This exception is thrown when there is a conflict performing an operation</p>
99
+ *
100
+ * @throws {@link InternalServerException} (server fault)
101
+ * <p>This exception is thrown if there was an unexpected error during processing of request</p>
102
+ *
103
+ * @throws {@link ResourceNotFoundException} (client fault)
104
+ * <p>This exception is thrown when a resource referenced by the operation does not exist</p>
105
+ *
106
+ * @throws {@link ThrottlingException} (client fault)
107
+ * <p>This exception is thrown when the number of requests exceeds the limit</p>
108
+ *
109
+ * @throws {@link ValidationException} (client fault)
110
+ * <p>The input fails to satisfy the constraints specified by the service.</p>
111
+ *
112
+ * @throws {@link BedrockAgentCoreControlServiceException}
113
+ * <p>Base exception class for all service exceptions from BedrockAgentCoreControl service.</p>
114
+ *
115
+ *
116
+ * @public
117
+ */
118
+ export declare class GetDatasetCommand extends GetDatasetCommand_base {
119
+ /** @internal type navigation helper, not in runtime. */
120
+ protected static __types: {
121
+ api: {
122
+ input: GetDatasetRequest;
123
+ output: GetDatasetResponse;
124
+ };
125
+ sdk: {
126
+ input: GetDatasetCommandInput;
127
+ output: GetDatasetCommandOutput;
128
+ };
129
+ };
130
+ }
@@ -2,7 +2,7 @@ import { Command as $Command } from "@smithy/core/client";
2
2
  import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
3
  import type { BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../BedrockAgentCoreControlClient";
4
4
  import type { GetGatewayTargetRequest } from "../models/models_0";
5
- import type { GetGatewayTargetResponse } from "../models/models_1";
5
+ import type { GetGatewayTargetResponse } from "../models/models_2";
6
6
  /**
7
7
  * @public
8
8
  */
@@ -0,0 +1,111 @@
1
+ import { Command as $Command } from "@smithy/core/client";
2
+ import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
3
+ import type { BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../BedrockAgentCoreControlClient";
4
+ import type { ListDatasetExamplesRequest, ListDatasetExamplesResponse } from "../models/models_0";
5
+ /**
6
+ * @public
7
+ */
8
+ export type { __MetadataBearer };
9
+ export { $Command };
10
+ /**
11
+ * @public
12
+ *
13
+ * The input for {@link ListDatasetExamplesCommand}.
14
+ */
15
+ export interface ListDatasetExamplesCommandInput extends ListDatasetExamplesRequest {
16
+ }
17
+ /**
18
+ * @public
19
+ *
20
+ * The output of {@link ListDatasetExamplesCommand}.
21
+ */
22
+ export interface ListDatasetExamplesCommandOutput extends ListDatasetExamplesResponse, __MetadataBearer {
23
+ }
24
+ declare const ListDatasetExamplesCommand_base: {
25
+ new (input: ListDatasetExamplesCommandInput): import("@smithy/core/client").CommandImpl<ListDatasetExamplesCommandInput, ListDatasetExamplesCommandOutput, BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
26
+ new (input: ListDatasetExamplesCommandInput): import("@smithy/core/client").CommandImpl<ListDatasetExamplesCommandInput, ListDatasetExamplesCommandOutput, BedrockAgentCoreControlClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
27
+ getEndpointParameterInstructions(): {
28
+ [x: string]: unknown;
29
+ };
30
+ };
31
+ /**
32
+ * Returns paginated examples from the dataset.
33
+ *
34
+ * **Version-pinned pagination:** The server embeds the resolved version in the `nextToken`.
35
+ * Once pagination begins, all subsequent pages are pinned to that version regardless of
36
+ * concurrent mutations or whether `datasetVersion` is passed on subsequent requests. The `datasetVersion`
37
+ * query parameter is only used for the first request (when `nextToken` is absent); if omitted,
38
+ * defaults to DRAFT.
39
+ *
40
+ * **State guard:** Allowed for all statuses including DELETING.
41
+ * @example
42
+ * Use a bare-bones client and the command you need to make an API call.
43
+ * ```javascript
44
+ * import { BedrockAgentCoreControlClient, ListDatasetExamplesCommand } from "@aws-sdk/client-bedrock-agentcore-control"; // ES Modules import
45
+ * // const { BedrockAgentCoreControlClient, ListDatasetExamplesCommand } = require("@aws-sdk/client-bedrock-agentcore-control"); // CommonJS import
46
+ * // import type { BedrockAgentCoreControlClientConfig } from "@aws-sdk/client-bedrock-agentcore-control";
47
+ * const config = {}; // type is BedrockAgentCoreControlClientConfig
48
+ * const client = new BedrockAgentCoreControlClient(config);
49
+ * const input = { // ListDatasetExamplesRequest
50
+ * datasetId: "STRING_VALUE", // required
51
+ * datasetVersion: "STRING_VALUE",
52
+ * maxResults: Number("int"),
53
+ * nextToken: "STRING_VALUE",
54
+ * };
55
+ * const command = new ListDatasetExamplesCommand(input);
56
+ * const response = await client.send(command);
57
+ * // { // ListDatasetExamplesResponse
58
+ * // datasetArn: "STRING_VALUE", // required
59
+ * // datasetId: "STRING_VALUE", // required
60
+ * // datasetVersion: "STRING_VALUE", // required
61
+ * // examples: [ // DatasetExampleList // required
62
+ * // "DOCUMENT_VALUE",
63
+ * // ],
64
+ * // nextToken: "STRING_VALUE",
65
+ * // };
66
+ *
67
+ * ```
68
+ *
69
+ * @param ListDatasetExamplesCommandInput - {@link ListDatasetExamplesCommandInput}
70
+ * @returns {@link ListDatasetExamplesCommandOutput}
71
+ * @see {@link ListDatasetExamplesCommandInput} for command's `input` shape.
72
+ * @see {@link ListDatasetExamplesCommandOutput} for command's `response` shape.
73
+ * @see {@link BedrockAgentCoreControlClientResolvedConfig | config} for BedrockAgentCoreControlClient's `config` shape.
74
+ *
75
+ * @throws {@link AccessDeniedException} (client fault)
76
+ * <p>This exception is thrown when a request is denied per access permissions</p>
77
+ *
78
+ * @throws {@link ConflictException} (client fault)
79
+ * <p>This exception is thrown when there is a conflict performing an operation</p>
80
+ *
81
+ * @throws {@link InternalServerException} (server fault)
82
+ * <p>This exception is thrown if there was an unexpected error during processing of request</p>
83
+ *
84
+ * @throws {@link ResourceNotFoundException} (client fault)
85
+ * <p>This exception is thrown when a resource referenced by the operation does not exist</p>
86
+ *
87
+ * @throws {@link ThrottlingException} (client fault)
88
+ * <p>This exception is thrown when the number of requests exceeds the limit</p>
89
+ *
90
+ * @throws {@link ValidationException} (client fault)
91
+ * <p>The input fails to satisfy the constraints specified by the service.</p>
92
+ *
93
+ * @throws {@link BedrockAgentCoreControlServiceException}
94
+ * <p>Base exception class for all service exceptions from BedrockAgentCoreControl service.</p>
95
+ *
96
+ *
97
+ * @public
98
+ */
99
+ export declare class ListDatasetExamplesCommand extends ListDatasetExamplesCommand_base {
100
+ /** @internal type navigation helper, not in runtime. */
101
+ protected static __types: {
102
+ api: {
103
+ input: ListDatasetExamplesRequest;
104
+ output: ListDatasetExamplesResponse;
105
+ };
106
+ sdk: {
107
+ input: ListDatasetExamplesCommandInput;
108
+ output: ListDatasetExamplesCommandOutput;
109
+ };
110
+ };
111
+ }