@aws-sdk/client-secrets-manager 3.296.0 → 3.297.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 (30) hide show
  1. package/dist-types/SecretsManager.d.ts +23 -0
  2. package/dist-types/SecretsManagerClient.d.ts +24 -4
  3. package/dist-types/commands/CancelRotateSecretCommand.d.ts +16 -0
  4. package/dist-types/commands/CreateSecretCommand.d.ts +16 -0
  5. package/dist-types/commands/DeleteResourcePolicyCommand.d.ts +16 -0
  6. package/dist-types/commands/DeleteSecretCommand.d.ts +16 -0
  7. package/dist-types/commands/DescribeSecretCommand.d.ts +16 -0
  8. package/dist-types/commands/GetRandomPasswordCommand.d.ts +16 -0
  9. package/dist-types/commands/GetResourcePolicyCommand.d.ts +16 -0
  10. package/dist-types/commands/GetSecretValueCommand.d.ts +16 -0
  11. package/dist-types/commands/ListSecretVersionIdsCommand.d.ts +16 -0
  12. package/dist-types/commands/ListSecretsCommand.d.ts +16 -0
  13. package/dist-types/commands/PutResourcePolicyCommand.d.ts +16 -0
  14. package/dist-types/commands/PutSecretValueCommand.d.ts +16 -0
  15. package/dist-types/commands/RemoveRegionsFromReplicationCommand.d.ts +16 -0
  16. package/dist-types/commands/ReplicateSecretToRegionsCommand.d.ts +16 -0
  17. package/dist-types/commands/RestoreSecretCommand.d.ts +16 -0
  18. package/dist-types/commands/RotateSecretCommand.d.ts +16 -0
  19. package/dist-types/commands/StopReplicationToReplicaCommand.d.ts +16 -0
  20. package/dist-types/commands/TagResourceCommand.d.ts +16 -0
  21. package/dist-types/commands/UntagResourceCommand.d.ts +16 -0
  22. package/dist-types/commands/UpdateSecretCommand.d.ts +16 -0
  23. package/dist-types/commands/UpdateSecretVersionStageCommand.d.ts +16 -0
  24. package/dist-types/commands/ValidateResourcePolicyCommand.d.ts +16 -0
  25. package/dist-types/models/SecretsManagerServiceException.d.ts +2 -0
  26. package/dist-types/models/models_0.d.ts +157 -2
  27. package/dist-types/pagination/Interfaces.d.ts +3 -0
  28. package/dist-types/pagination/ListSecretVersionIdsPaginator.d.ts +3 -0
  29. package/dist-types/pagination/ListSecretsPaginator.d.ts +3 -0
  30. package/package.json +3 -3
@@ -23,6 +23,7 @@ import { UpdateSecretVersionStageCommandInput, UpdateSecretVersionStageCommandOu
23
23
  import { ValidateResourcePolicyCommandInput, ValidateResourcePolicyCommandOutput } from "./commands/ValidateResourcePolicyCommand";
24
24
  import { SecretsManagerClient } from "./SecretsManagerClient";
25
25
  /**
26
+ * @public
26
27
  * <fullname>Amazon Web Services Secrets Manager</fullname>
27
28
  * <p>Amazon Web Services Secrets Manager provides a service to enable you to store, manage, and retrieve, secrets.</p>
28
29
  * <p>This guide provides descriptions of the Secrets Manager API. For more information about using this
@@ -52,6 +53,7 @@ import { SecretsManagerClient } from "./SecretsManagerClient";
52
53
  */
53
54
  export declare class SecretsManager extends SecretsManagerClient {
54
55
  /**
56
+ * @public
55
57
  * <p>Turns off automatic rotation, and if a rotation is currently in
56
58
  * progress, cancels the rotation.</p>
57
59
  * <p>If you cancel a rotation in progress, it can leave the <code>VersionStage</code>
@@ -76,6 +78,7 @@ export declare class SecretsManager extends SecretsManagerClient {
76
78
  cancelRotateSecret(args: CancelRotateSecretCommandInput, cb: (err: any, data?: CancelRotateSecretCommandOutput) => void): void;
77
79
  cancelRotateSecret(args: CancelRotateSecretCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CancelRotateSecretCommandOutput) => void): void;
78
80
  /**
81
+ * @public
79
82
  * <p>Creates a new secret. A <i>secret</i> can be a password, a set of
80
83
  * credentials such as a user name and password, an OAuth token, or other secret information
81
84
  * that you store in an encrypted form in Secrets Manager. The secret also
@@ -117,6 +120,7 @@ export declare class SecretsManager extends SecretsManagerClient {
117
120
  createSecret(args: CreateSecretCommandInput, cb: (err: any, data?: CreateSecretCommandOutput) => void): void;
118
121
  createSecret(args: CreateSecretCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateSecretCommandOutput) => void): void;
119
122
  /**
123
+ * @public
120
124
  * <p>Deletes the resource-based permission policy attached to the secret. To attach a policy to
121
125
  * a secret, use <a>PutResourcePolicy</a>.</p>
122
126
  * <p>Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters because it might be logged. For more information, see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/retrieve-ct-entries.html">Logging Secrets Manager events with CloudTrail</a>.</p>
@@ -131,6 +135,7 @@ export declare class SecretsManager extends SecretsManagerClient {
131
135
  deleteResourcePolicy(args: DeleteResourcePolicyCommandInput, cb: (err: any, data?: DeleteResourcePolicyCommandOutput) => void): void;
132
136
  deleteResourcePolicy(args: DeleteResourcePolicyCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteResourcePolicyCommandOutput) => void): void;
133
137
  /**
138
+ * @public
134
139
  * <p>Deletes a secret and all of its versions. You can specify a recovery
135
140
  * window during which you can restore the secret. The minimum recovery window is 7 days.
136
141
  * The default recovery window is 30 days. Secrets Manager attaches a <code>DeletionDate</code> stamp to
@@ -165,6 +170,7 @@ export declare class SecretsManager extends SecretsManagerClient {
165
170
  deleteSecret(args: DeleteSecretCommandInput, cb: (err: any, data?: DeleteSecretCommandOutput) => void): void;
166
171
  deleteSecret(args: DeleteSecretCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DeleteSecretCommandOutput) => void): void;
167
172
  /**
173
+ * @public
168
174
  * <p>Retrieves the details of a secret. It does not include the encrypted secret value. Secrets Manager
169
175
  * only returns fields that have a value in the response. </p>
170
176
  * <p>Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters because it might be logged. For more information, see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/retrieve-ct-entries.html">Logging Secrets Manager events with CloudTrail</a>.</p>
@@ -179,6 +185,7 @@ export declare class SecretsManager extends SecretsManagerClient {
179
185
  describeSecret(args: DescribeSecretCommandInput, cb: (err: any, data?: DescribeSecretCommandOutput) => void): void;
180
186
  describeSecret(args: DescribeSecretCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: DescribeSecretCommandOutput) => void): void;
181
187
  /**
188
+ * @public
182
189
  * <p>Generates a random password. We recommend that you specify the
183
190
  * maximum length and include every character type that the system you are generating a password
184
191
  * for can support.</p>
@@ -194,6 +201,7 @@ export declare class SecretsManager extends SecretsManagerClient {
194
201
  getRandomPassword(args: GetRandomPasswordCommandInput, cb: (err: any, data?: GetRandomPasswordCommandOutput) => void): void;
195
202
  getRandomPassword(args: GetRandomPasswordCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetRandomPasswordCommandOutput) => void): void;
196
203
  /**
204
+ * @public
197
205
  * <p>Retrieves the JSON text of the resource-based policy document attached to the
198
206
  * secret. For more information about permissions policies attached to a secret, see
199
207
  * <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/auth-and-access_resource-policies.html">Permissions
@@ -210,6 +218,7 @@ export declare class SecretsManager extends SecretsManagerClient {
210
218
  getResourcePolicy(args: GetResourcePolicyCommandInput, cb: (err: any, data?: GetResourcePolicyCommandOutput) => void): void;
211
219
  getResourcePolicy(args: GetResourcePolicyCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetResourcePolicyCommandOutput) => void): void;
212
220
  /**
221
+ * @public
213
222
  * <p>Retrieves the contents of the encrypted fields <code>SecretString</code> or
214
223
  * <code>SecretBinary</code> from the specified version of a secret, whichever contains
215
224
  * content.</p>
@@ -232,6 +241,7 @@ export declare class SecretsManager extends SecretsManagerClient {
232
241
  getSecretValue(args: GetSecretValueCommandInput, cb: (err: any, data?: GetSecretValueCommandOutput) => void): void;
233
242
  getSecretValue(args: GetSecretValueCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: GetSecretValueCommandOutput) => void): void;
234
243
  /**
244
+ * @public
235
245
  * <p>Lists the secrets that are stored by Secrets Manager in the Amazon Web Services account, not including secrets
236
246
  * that are marked for deletion. To see secrets marked for deletion, use the Secrets Manager console.</p>
237
247
  * <p>ListSecrets is eventually consistent, however it might not reflect changes from the last five minutes.
@@ -252,6 +262,7 @@ export declare class SecretsManager extends SecretsManagerClient {
252
262
  listSecrets(args: ListSecretsCommandInput, cb: (err: any, data?: ListSecretsCommandOutput) => void): void;
253
263
  listSecrets(args: ListSecretsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListSecretsCommandOutput) => void): void;
254
264
  /**
265
+ * @public
255
266
  * <p>Lists the versions of a secret. Secrets Manager uses staging labels to indicate the different versions
256
267
  * of a secret. For more information, see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/getting-started.html#term_version">
257
268
  * Secrets Manager concepts: Versions</a>.</p>
@@ -268,6 +279,7 @@ export declare class SecretsManager extends SecretsManagerClient {
268
279
  listSecretVersionIds(args: ListSecretVersionIdsCommandInput, cb: (err: any, data?: ListSecretVersionIdsCommandOutput) => void): void;
269
280
  listSecretVersionIds(args: ListSecretVersionIdsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ListSecretVersionIdsCommandOutput) => void): void;
270
281
  /**
282
+ * @public
271
283
  * <p>Attaches a resource-based permission policy to a secret. A resource-based policy is
272
284
  * optional. For more information, see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/auth-and-access.html">Authentication and access control for Secrets Manager</a>
273
285
  * </p>
@@ -285,6 +297,7 @@ export declare class SecretsManager extends SecretsManagerClient {
285
297
  putResourcePolicy(args: PutResourcePolicyCommandInput, cb: (err: any, data?: PutResourcePolicyCommandOutput) => void): void;
286
298
  putResourcePolicy(args: PutResourcePolicyCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutResourcePolicyCommandOutput) => void): void;
287
299
  /**
300
+ * @public
288
301
  * <p>Creates a new version with a new encrypted secret value and attaches it to the secret. The
289
302
  * version can contain a new <code>SecretString</code> value or a new <code>SecretBinary</code> value. </p>
290
303
  * <p>We recommend you avoid calling <code>PutSecretValue</code> at a sustained rate of more than
@@ -318,6 +331,7 @@ export declare class SecretsManager extends SecretsManagerClient {
318
331
  putSecretValue(args: PutSecretValueCommandInput, cb: (err: any, data?: PutSecretValueCommandOutput) => void): void;
319
332
  putSecretValue(args: PutSecretValueCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: PutSecretValueCommandOutput) => void): void;
320
333
  /**
334
+ * @public
321
335
  * <p>For a secret that is replicated to other Regions, deletes the secret replicas from the Regions you specify.</p>
322
336
  * <p>Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters because it might be logged. For more information, see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/retrieve-ct-entries.html">Logging Secrets Manager events with CloudTrail</a>.</p>
323
337
  * <p>
@@ -331,6 +345,7 @@ export declare class SecretsManager extends SecretsManagerClient {
331
345
  removeRegionsFromReplication(args: RemoveRegionsFromReplicationCommandInput, cb: (err: any, data?: RemoveRegionsFromReplicationCommandOutput) => void): void;
332
346
  removeRegionsFromReplication(args: RemoveRegionsFromReplicationCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: RemoveRegionsFromReplicationCommandOutput) => void): void;
333
347
  /**
348
+ * @public
334
349
  * <p>Replicates the secret to a new Regions. See <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/create-manage-multi-region-secrets.html">Multi-Region secrets</a>.</p>
335
350
  * <p>Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters because it might be logged. For more information, see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/retrieve-ct-entries.html">Logging Secrets Manager events with CloudTrail</a>.</p>
336
351
  * <p>
@@ -344,6 +359,7 @@ export declare class SecretsManager extends SecretsManagerClient {
344
359
  replicateSecretToRegions(args: ReplicateSecretToRegionsCommandInput, cb: (err: any, data?: ReplicateSecretToRegionsCommandOutput) => void): void;
345
360
  replicateSecretToRegions(args: ReplicateSecretToRegionsCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: ReplicateSecretToRegionsCommandOutput) => void): void;
346
361
  /**
362
+ * @public
347
363
  * <p>Cancels the scheduled deletion of a secret by removing the <code>DeletedDate</code> time
348
364
  * stamp. You can access a secret again after it has been restored.</p>
349
365
  * <p>Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters because it might be logged. For more information, see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/retrieve-ct-entries.html">Logging Secrets Manager events with CloudTrail</a>.</p>
@@ -358,6 +374,7 @@ export declare class SecretsManager extends SecretsManagerClient {
358
374
  restoreSecret(args: RestoreSecretCommandInput, cb: (err: any, data?: RestoreSecretCommandOutput) => void): void;
359
375
  restoreSecret(args: RestoreSecretCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: RestoreSecretCommandOutput) => void): void;
360
376
  /**
377
+ * @public
361
378
  * <p>Configures and starts the asynchronous process of rotating the secret. For information about rotation,
362
379
  * see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/rotating-secrets.html">Rotate secrets</a> in the <i>Secrets Manager User Guide</i>. If you include the configuration parameters, the operation sets the values for the secret and then immediately starts a rotation. If you don't include the configuration parameters, the operation starts a rotation with the values already stored in the secret. </p>
363
380
  * <p>When rotation is successful, the <code>AWSPENDING</code> staging label might be attached
@@ -379,6 +396,7 @@ export declare class SecretsManager extends SecretsManagerClient {
379
396
  rotateSecret(args: RotateSecretCommandInput, cb: (err: any, data?: RotateSecretCommandOutput) => void): void;
380
397
  rotateSecret(args: RotateSecretCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: RotateSecretCommandOutput) => void): void;
381
398
  /**
399
+ * @public
382
400
  * <p>Removes the link between the replica secret and the primary secret and promotes the replica to a primary secret in the replica Region.</p>
383
401
  * <p>You must call this operation from the Region in which you want to promote the replica to a primary secret.</p>
384
402
  * <p>Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters because it might be logged. For more information, see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/retrieve-ct-entries.html">Logging Secrets Manager events with CloudTrail</a>.</p>
@@ -393,6 +411,7 @@ export declare class SecretsManager extends SecretsManagerClient {
393
411
  stopReplicationToReplica(args: StopReplicationToReplicaCommandInput, cb: (err: any, data?: StopReplicationToReplicaCommandOutput) => void): void;
394
412
  stopReplicationToReplica(args: StopReplicationToReplicaCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: StopReplicationToReplicaCommandOutput) => void): void;
395
413
  /**
414
+ * @public
396
415
  * <p>Attaches tags to a secret. Tags consist of a key name and a value. Tags are part of the
397
416
  * secret's metadata. They are not associated with specific versions of the secret. This operation appends tags to the existing list of tags.</p>
398
417
  * <p>The following restrictions apply to tags:</p>
@@ -439,6 +458,7 @@ export declare class SecretsManager extends SecretsManagerClient {
439
458
  tagResource(args: TagResourceCommandInput, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
440
459
  tagResource(args: TagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: TagResourceCommandOutput) => void): void;
441
460
  /**
461
+ * @public
442
462
  * <p>Removes specific tags from a secret.</p>
443
463
  * <p>This operation is idempotent. If a requested tag is not attached to the secret, no error
444
464
  * is returned and the secret metadata is unchanged.</p>
@@ -460,6 +480,7 @@ export declare class SecretsManager extends SecretsManagerClient {
460
480
  untagResource(args: UntagResourceCommandInput, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
461
481
  untagResource(args: UntagResourceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UntagResourceCommandOutput) => void): void;
462
482
  /**
483
+ * @public
463
484
  * <p>Modifies the details of a secret, including metadata and the secret value. To change the secret value, you can also use <a>PutSecretValue</a>.</p>
464
485
  * <p>To change the rotation configuration of a secret, use <a>RotateSecret</a> instead.</p>
465
486
  * <p>To change a secret so that it is managed by another service, you need to recreate the secret in that service. See <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/service-linked-secrets.html">Secrets Manager secrets managed by other Amazon Web Services services</a>.</p>
@@ -492,6 +513,7 @@ export declare class SecretsManager extends SecretsManagerClient {
492
513
  updateSecret(args: UpdateSecretCommandInput, cb: (err: any, data?: UpdateSecretCommandOutput) => void): void;
493
514
  updateSecret(args: UpdateSecretCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateSecretCommandOutput) => void): void;
494
515
  /**
516
+ * @public
495
517
  * <p>Modifies the staging labels attached to a version of a secret. Secrets Manager uses staging labels to
496
518
  * track a version as it progresses through the secret rotation process. Each staging label can be
497
519
  * attached to only one version at a time. To add a staging label to a version when it is already
@@ -519,6 +541,7 @@ export declare class SecretsManager extends SecretsManagerClient {
519
541
  updateSecretVersionStage(args: UpdateSecretVersionStageCommandInput, cb: (err: any, data?: UpdateSecretVersionStageCommandOutput) => void): void;
520
542
  updateSecretVersionStage(args: UpdateSecretVersionStageCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: UpdateSecretVersionStageCommandOutput) => void): void;
521
543
  /**
544
+ * @public
522
545
  * <p>Validates that a resource policy does not grant a wide range of principals access to
523
546
  * your secret. A resource-based policy is optional for secrets.</p>
524
547
  * <p>The API performs three checks when validating the policy:</p>
@@ -30,15 +30,24 @@ import { UpdateSecretCommandInput, UpdateSecretCommandOutput } from "./commands/
30
30
  import { UpdateSecretVersionStageCommandInput, UpdateSecretVersionStageCommandOutput } from "./commands/UpdateSecretVersionStageCommand";
31
31
  import { ValidateResourcePolicyCommandInput, ValidateResourcePolicyCommandOutput } from "./commands/ValidateResourcePolicyCommand";
32
32
  import { ClientInputEndpointParameters, ClientResolvedEndpointParameters, EndpointParameters } from "./endpoint/EndpointParameters";
33
+ /**
34
+ * @public
35
+ */
33
36
  export type ServiceInputTypes = CancelRotateSecretCommandInput | CreateSecretCommandInput | DeleteResourcePolicyCommandInput | DeleteSecretCommandInput | DescribeSecretCommandInput | GetRandomPasswordCommandInput | GetResourcePolicyCommandInput | GetSecretValueCommandInput | ListSecretVersionIdsCommandInput | ListSecretsCommandInput | PutResourcePolicyCommandInput | PutSecretValueCommandInput | RemoveRegionsFromReplicationCommandInput | ReplicateSecretToRegionsCommandInput | RestoreSecretCommandInput | RotateSecretCommandInput | StopReplicationToReplicaCommandInput | TagResourceCommandInput | UntagResourceCommandInput | UpdateSecretCommandInput | UpdateSecretVersionStageCommandInput | ValidateResourcePolicyCommandInput;
37
+ /**
38
+ * @public
39
+ */
34
40
  export type ServiceOutputTypes = CancelRotateSecretCommandOutput | CreateSecretCommandOutput | DeleteResourcePolicyCommandOutput | DeleteSecretCommandOutput | DescribeSecretCommandOutput | GetRandomPasswordCommandOutput | GetResourcePolicyCommandOutput | GetSecretValueCommandOutput | ListSecretVersionIdsCommandOutput | ListSecretsCommandOutput | PutResourcePolicyCommandOutput | PutSecretValueCommandOutput | RemoveRegionsFromReplicationCommandOutput | ReplicateSecretToRegionsCommandOutput | RestoreSecretCommandOutput | RotateSecretCommandOutput | StopReplicationToReplicaCommandOutput | TagResourceCommandOutput | UntagResourceCommandOutput | UpdateSecretCommandOutput | UpdateSecretVersionStageCommandOutput | ValidateResourcePolicyCommandOutput;
41
+ /**
42
+ * @public
43
+ */
35
44
  export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__HttpHandlerOptions>> {
36
45
  /**
37
46
  * The HTTP handler to use. Fetch in browser and Https in Nodejs.
38
47
  */
39
48
  requestHandler?: __HttpHandler;
40
49
  /**
41
- * A constructor for a class implementing the {@link __Checksum} interface
50
+ * A constructor for a class implementing the {@link @aws-sdk/types#ChecksumConstructor} interface
42
51
  * that computes the SHA-256 HMAC or checksum of a string or binary buffer.
43
52
  * @internal
44
53
  */
@@ -128,23 +137,34 @@ export interface ClientDefaults extends Partial<__SmithyResolvedConfiguration<__
128
137
  */
129
138
  logger?: __Logger;
130
139
  /**
131
- * The {@link __DefaultsMode} that will be used to determine how certain default configuration options are resolved in the SDK.
140
+ * The {@link @aws-sdk/smithy-client#DefaultsMode} that will be used to determine how certain default configuration options are resolved in the SDK.
132
141
  */
133
142
  defaultsMode?: __DefaultsMode | __Provider<__DefaultsMode>;
134
143
  }
144
+ /**
145
+ * @public
146
+ */
135
147
  type SecretsManagerClientConfigType = Partial<__SmithyConfiguration<__HttpHandlerOptions>> & ClientDefaults & RegionInputConfig & EndpointInputConfig<EndpointParameters> & RetryInputConfig & HostHeaderInputConfig & AwsAuthInputConfig & UserAgentInputConfig & ClientInputEndpointParameters;
136
148
  /**
137
- * The configuration interface of SecretsManagerClient class constructor that set the region, credentials and other options.
149
+ * @public
150
+ *
151
+ * The configuration interface of SecretsManagerClient class constructor that set the region, credentials and other options.
138
152
  */
139
153
  export interface SecretsManagerClientConfig extends SecretsManagerClientConfigType {
140
154
  }
155
+ /**
156
+ * @public
157
+ */
141
158
  type SecretsManagerClientResolvedConfigType = __SmithyResolvedConfiguration<__HttpHandlerOptions> & Required<ClientDefaults> & RegionResolvedConfig & EndpointResolvedConfig<EndpointParameters> & RetryResolvedConfig & HostHeaderResolvedConfig & AwsAuthResolvedConfig & UserAgentResolvedConfig & ClientResolvedEndpointParameters;
142
159
  /**
143
- * The resolved configuration interface of SecretsManagerClient class. This is resolved and normalized from the {@link SecretsManagerClientConfig | constructor configuration interface}.
160
+ * @public
161
+ *
162
+ * The resolved configuration interface of SecretsManagerClient class. This is resolved and normalized from the {@link SecretsManagerClientConfig | constructor configuration interface}.
144
163
  */
145
164
  export interface SecretsManagerClientResolvedConfig extends SecretsManagerClientResolvedConfigType {
146
165
  }
147
166
  /**
167
+ * @public
148
168
  * <fullname>Amazon Web Services Secrets Manager</fullname>
149
169
  * <p>Amazon Web Services Secrets Manager provides a service to enable you to store, manage, and retrieve, secrets.</p>
150
170
  * <p>This guide provides descriptions of the Secrets Manager API. For more information about using this
@@ -4,16 +4,21 @@ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as
4
4
  import { CancelRotateSecretRequest, CancelRotateSecretResponse } from "../models/models_0";
5
5
  import { SecretsManagerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecretsManagerClient";
6
6
  /**
7
+ * @public
8
+ *
7
9
  * The input for {@link CancelRotateSecretCommand}.
8
10
  */
9
11
  export interface CancelRotateSecretCommandInput extends CancelRotateSecretRequest {
10
12
  }
11
13
  /**
14
+ * @public
15
+ *
12
16
  * The output of {@link CancelRotateSecretCommand}.
13
17
  */
14
18
  export interface CancelRotateSecretCommandOutput extends CancelRotateSecretResponse, __MetadataBearer {
15
19
  }
16
20
  /**
21
+ * @public
17
22
  * <p>Turns off automatic rotation, and if a rotation is currently in
18
23
  * progress, cancels the rotation.</p>
19
24
  * <p>If you cancel a rotation in progress, it can leave the <code>VersionStage</code>
@@ -43,6 +48,8 @@ export interface CancelRotateSecretCommandOutput extends CancelRotateSecretRespo
43
48
  * const response = await client.send(command);
44
49
  * ```
45
50
  *
51
+ * @param CancelRotateSecretCommandInput - {@link CancelRotateSecretCommandInput}
52
+ * @returns {@link CancelRotateSecretCommandOutput}
46
53
  * @see {@link CancelRotateSecretCommandInput} for command's `input` shape.
47
54
  * @see {@link CancelRotateSecretCommandOutput} for command's `response` shape.
48
55
  * @see {@link SecretsManagerClientResolvedConfig | config} for SecretsManagerClient's `config` shape.
@@ -96,11 +103,20 @@ export interface CancelRotateSecretCommandOutput extends CancelRotateSecretRespo
96
103
  export declare class CancelRotateSecretCommand extends $Command<CancelRotateSecretCommandInput, CancelRotateSecretCommandOutput, SecretsManagerClientResolvedConfig> {
97
104
  readonly input: CancelRotateSecretCommandInput;
98
105
  static getEndpointParameterInstructions(): EndpointParameterInstructions;
106
+ /**
107
+ * @public
108
+ */
99
109
  constructor(input: CancelRotateSecretCommandInput);
100
110
  /**
101
111
  * @internal
102
112
  */
103
113
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecretsManagerClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CancelRotateSecretCommandInput, CancelRotateSecretCommandOutput>;
114
+ /**
115
+ * @internal
116
+ */
104
117
  private serialize;
118
+ /**
119
+ * @internal
120
+ */
105
121
  private deserialize;
106
122
  }
@@ -4,16 +4,21 @@ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as
4
4
  import { CreateSecretRequest, CreateSecretResponse } from "../models/models_0";
5
5
  import { SecretsManagerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecretsManagerClient";
6
6
  /**
7
+ * @public
8
+ *
7
9
  * The input for {@link CreateSecretCommand}.
8
10
  */
9
11
  export interface CreateSecretCommandInput extends CreateSecretRequest {
10
12
  }
11
13
  /**
14
+ * @public
15
+ *
12
16
  * The output of {@link CreateSecretCommand}.
13
17
  */
14
18
  export interface CreateSecretCommandOutput extends CreateSecretResponse, __MetadataBearer {
15
19
  }
16
20
  /**
21
+ * @public
17
22
  * <p>Creates a new secret. A <i>secret</i> can be a password, a set of
18
23
  * credentials such as a user name and password, an OAuth token, or other secret information
19
24
  * that you store in an encrypted form in Secrets Manager. The secret also
@@ -60,6 +65,8 @@ export interface CreateSecretCommandOutput extends CreateSecretResponse, __Metad
60
65
  * const response = await client.send(command);
61
66
  * ```
62
67
  *
68
+ * @param CreateSecretCommandInput - {@link CreateSecretCommandInput}
69
+ * @returns {@link CreateSecretCommandOutput}
63
70
  * @see {@link CreateSecretCommandInput} for command's `input` shape.
64
71
  * @see {@link CreateSecretCommandOutput} for command's `response` shape.
65
72
  * @see {@link SecretsManagerClientResolvedConfig | config} for SecretsManagerClient's `config` shape.
@@ -137,11 +144,20 @@ export interface CreateSecretCommandOutput extends CreateSecretResponse, __Metad
137
144
  export declare class CreateSecretCommand extends $Command<CreateSecretCommandInput, CreateSecretCommandOutput, SecretsManagerClientResolvedConfig> {
138
145
  readonly input: CreateSecretCommandInput;
139
146
  static getEndpointParameterInstructions(): EndpointParameterInstructions;
147
+ /**
148
+ * @public
149
+ */
140
150
  constructor(input: CreateSecretCommandInput);
141
151
  /**
142
152
  * @internal
143
153
  */
144
154
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecretsManagerClientResolvedConfig, options?: __HttpHandlerOptions): Handler<CreateSecretCommandInput, CreateSecretCommandOutput>;
155
+ /**
156
+ * @internal
157
+ */
145
158
  private serialize;
159
+ /**
160
+ * @internal
161
+ */
146
162
  private deserialize;
147
163
  }
@@ -4,16 +4,21 @@ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as
4
4
  import { DeleteResourcePolicyRequest, DeleteResourcePolicyResponse } from "../models/models_0";
5
5
  import { SecretsManagerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecretsManagerClient";
6
6
  /**
7
+ * @public
8
+ *
7
9
  * The input for {@link DeleteResourcePolicyCommand}.
8
10
  */
9
11
  export interface DeleteResourcePolicyCommandInput extends DeleteResourcePolicyRequest {
10
12
  }
11
13
  /**
14
+ * @public
15
+ *
12
16
  * The output of {@link DeleteResourcePolicyCommand}.
13
17
  */
14
18
  export interface DeleteResourcePolicyCommandOutput extends DeleteResourcePolicyResponse, __MetadataBearer {
15
19
  }
16
20
  /**
21
+ * @public
17
22
  * <p>Deletes the resource-based permission policy attached to the secret. To attach a policy to
18
23
  * a secret, use <a>PutResourcePolicy</a>.</p>
19
24
  * <p>Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters because it might be logged. For more information, see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/retrieve-ct-entries.html">Logging Secrets Manager events with CloudTrail</a>.</p>
@@ -33,6 +38,8 @@ export interface DeleteResourcePolicyCommandOutput extends DeleteResourcePolicyR
33
38
  * const response = await client.send(command);
34
39
  * ```
35
40
  *
41
+ * @param DeleteResourcePolicyCommandInput - {@link DeleteResourcePolicyCommandInput}
42
+ * @returns {@link DeleteResourcePolicyCommandOutput}
36
43
  * @see {@link DeleteResourcePolicyCommandInput} for command's `input` shape.
37
44
  * @see {@link DeleteResourcePolicyCommandOutput} for command's `response` shape.
38
45
  * @see {@link SecretsManagerClientResolvedConfig | config} for SecretsManagerClient's `config` shape.
@@ -86,11 +93,20 @@ export interface DeleteResourcePolicyCommandOutput extends DeleteResourcePolicyR
86
93
  export declare class DeleteResourcePolicyCommand extends $Command<DeleteResourcePolicyCommandInput, DeleteResourcePolicyCommandOutput, SecretsManagerClientResolvedConfig> {
87
94
  readonly input: DeleteResourcePolicyCommandInput;
88
95
  static getEndpointParameterInstructions(): EndpointParameterInstructions;
96
+ /**
97
+ * @public
98
+ */
89
99
  constructor(input: DeleteResourcePolicyCommandInput);
90
100
  /**
91
101
  * @internal
92
102
  */
93
103
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecretsManagerClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DeleteResourcePolicyCommandInput, DeleteResourcePolicyCommandOutput>;
104
+ /**
105
+ * @internal
106
+ */
94
107
  private serialize;
108
+ /**
109
+ * @internal
110
+ */
95
111
  private deserialize;
96
112
  }
@@ -4,16 +4,21 @@ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as
4
4
  import { DeleteSecretRequest, DeleteSecretResponse } from "../models/models_0";
5
5
  import { SecretsManagerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecretsManagerClient";
6
6
  /**
7
+ * @public
8
+ *
7
9
  * The input for {@link DeleteSecretCommand}.
8
10
  */
9
11
  export interface DeleteSecretCommandInput extends DeleteSecretRequest {
10
12
  }
11
13
  /**
14
+ * @public
15
+ *
12
16
  * The output of {@link DeleteSecretCommand}.
13
17
  */
14
18
  export interface DeleteSecretCommandOutput extends DeleteSecretResponse, __MetadataBearer {
15
19
  }
16
20
  /**
21
+ * @public
17
22
  * <p>Deletes a secret and all of its versions. You can specify a recovery
18
23
  * window during which you can restore the secret. The minimum recovery window is 7 days.
19
24
  * The default recovery window is 30 days. Secrets Manager attaches a <code>DeletionDate</code> stamp to
@@ -53,6 +58,8 @@ export interface DeleteSecretCommandOutput extends DeleteSecretResponse, __Metad
53
58
  * const response = await client.send(command);
54
59
  * ```
55
60
  *
61
+ * @param DeleteSecretCommandInput - {@link DeleteSecretCommandInput}
62
+ * @returns {@link DeleteSecretCommandOutput}
56
63
  * @see {@link DeleteSecretCommandInput} for command's `input` shape.
57
64
  * @see {@link DeleteSecretCommandOutput} for command's `response` shape.
58
65
  * @see {@link SecretsManagerClientResolvedConfig | config} for SecretsManagerClient's `config` shape.
@@ -108,11 +115,20 @@ export interface DeleteSecretCommandOutput extends DeleteSecretResponse, __Metad
108
115
  export declare class DeleteSecretCommand extends $Command<DeleteSecretCommandInput, DeleteSecretCommandOutput, SecretsManagerClientResolvedConfig> {
109
116
  readonly input: DeleteSecretCommandInput;
110
117
  static getEndpointParameterInstructions(): EndpointParameterInstructions;
118
+ /**
119
+ * @public
120
+ */
111
121
  constructor(input: DeleteSecretCommandInput);
112
122
  /**
113
123
  * @internal
114
124
  */
115
125
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecretsManagerClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DeleteSecretCommandInput, DeleteSecretCommandOutput>;
126
+ /**
127
+ * @internal
128
+ */
116
129
  private serialize;
130
+ /**
131
+ * @internal
132
+ */
117
133
  private deserialize;
118
134
  }
@@ -4,16 +4,21 @@ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as
4
4
  import { DescribeSecretRequest, DescribeSecretResponse } from "../models/models_0";
5
5
  import { SecretsManagerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecretsManagerClient";
6
6
  /**
7
+ * @public
8
+ *
7
9
  * The input for {@link DescribeSecretCommand}.
8
10
  */
9
11
  export interface DescribeSecretCommandInput extends DescribeSecretRequest {
10
12
  }
11
13
  /**
14
+ * @public
15
+ *
12
16
  * The output of {@link DescribeSecretCommand}.
13
17
  */
14
18
  export interface DescribeSecretCommandOutput extends DescribeSecretResponse, __MetadataBearer {
15
19
  }
16
20
  /**
21
+ * @public
17
22
  * <p>Retrieves the details of a secret. It does not include the encrypted secret value. Secrets Manager
18
23
  * only returns fields that have a value in the response. </p>
19
24
  * <p>Secrets Manager generates a CloudTrail log entry when you call this action. Do not include sensitive information in request parameters because it might be logged. For more information, see <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/retrieve-ct-entries.html">Logging Secrets Manager events with CloudTrail</a>.</p>
@@ -33,6 +38,8 @@ export interface DescribeSecretCommandOutput extends DescribeSecretResponse, __M
33
38
  * const response = await client.send(command);
34
39
  * ```
35
40
  *
41
+ * @param DescribeSecretCommandInput - {@link DescribeSecretCommandInput}
42
+ * @returns {@link DescribeSecretCommandOutput}
36
43
  * @see {@link DescribeSecretCommandInput} for command's `input` shape.
37
44
  * @see {@link DescribeSecretCommandOutput} for command's `response` shape.
38
45
  * @see {@link SecretsManagerClientResolvedConfig | config} for SecretsManagerClient's `config` shape.
@@ -99,11 +106,20 @@ export interface DescribeSecretCommandOutput extends DescribeSecretResponse, __M
99
106
  export declare class DescribeSecretCommand extends $Command<DescribeSecretCommandInput, DescribeSecretCommandOutput, SecretsManagerClientResolvedConfig> {
100
107
  readonly input: DescribeSecretCommandInput;
101
108
  static getEndpointParameterInstructions(): EndpointParameterInstructions;
109
+ /**
110
+ * @public
111
+ */
102
112
  constructor(input: DescribeSecretCommandInput);
103
113
  /**
104
114
  * @internal
105
115
  */
106
116
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecretsManagerClientResolvedConfig, options?: __HttpHandlerOptions): Handler<DescribeSecretCommandInput, DescribeSecretCommandOutput>;
117
+ /**
118
+ * @internal
119
+ */
107
120
  private serialize;
121
+ /**
122
+ * @internal
123
+ */
108
124
  private deserialize;
109
125
  }
@@ -4,16 +4,21 @@ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as
4
4
  import { GetRandomPasswordRequest, GetRandomPasswordResponse } from "../models/models_0";
5
5
  import { SecretsManagerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecretsManagerClient";
6
6
  /**
7
+ * @public
8
+ *
7
9
  * The input for {@link GetRandomPasswordCommand}.
8
10
  */
9
11
  export interface GetRandomPasswordCommandInput extends GetRandomPasswordRequest {
10
12
  }
11
13
  /**
14
+ * @public
15
+ *
12
16
  * The output of {@link GetRandomPasswordCommand}.
13
17
  */
14
18
  export interface GetRandomPasswordCommandOutput extends GetRandomPasswordResponse, __MetadataBearer {
15
19
  }
16
20
  /**
21
+ * @public
17
22
  * <p>Generates a random password. We recommend that you specify the
18
23
  * maximum length and include every character type that the system you are generating a password
19
24
  * for can support.</p>
@@ -34,6 +39,8 @@ export interface GetRandomPasswordCommandOutput extends GetRandomPasswordRespons
34
39
  * const response = await client.send(command);
35
40
  * ```
36
41
  *
42
+ * @param GetRandomPasswordCommandInput - {@link GetRandomPasswordCommandInput}
43
+ * @returns {@link GetRandomPasswordCommandOutput}
37
44
  * @see {@link GetRandomPasswordCommandInput} for command's `input` shape.
38
45
  * @see {@link GetRandomPasswordCommandOutput} for command's `response` shape.
39
46
  * @see {@link SecretsManagerClientResolvedConfig | config} for SecretsManagerClient's `config` shape.
@@ -85,11 +92,20 @@ export interface GetRandomPasswordCommandOutput extends GetRandomPasswordRespons
85
92
  export declare class GetRandomPasswordCommand extends $Command<GetRandomPasswordCommandInput, GetRandomPasswordCommandOutput, SecretsManagerClientResolvedConfig> {
86
93
  readonly input: GetRandomPasswordCommandInput;
87
94
  static getEndpointParameterInstructions(): EndpointParameterInstructions;
95
+ /**
96
+ * @public
97
+ */
88
98
  constructor(input: GetRandomPasswordCommandInput);
89
99
  /**
90
100
  * @internal
91
101
  */
92
102
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecretsManagerClientResolvedConfig, options?: __HttpHandlerOptions): Handler<GetRandomPasswordCommandInput, GetRandomPasswordCommandOutput>;
103
+ /**
104
+ * @internal
105
+ */
93
106
  private serialize;
107
+ /**
108
+ * @internal
109
+ */
94
110
  private deserialize;
95
111
  }
@@ -4,16 +4,21 @@ import { Handler, HttpHandlerOptions as __HttpHandlerOptions, MetadataBearer as
4
4
  import { GetResourcePolicyRequest, GetResourcePolicyResponse } from "../models/models_0";
5
5
  import { SecretsManagerClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../SecretsManagerClient";
6
6
  /**
7
+ * @public
8
+ *
7
9
  * The input for {@link GetResourcePolicyCommand}.
8
10
  */
9
11
  export interface GetResourcePolicyCommandInput extends GetResourcePolicyRequest {
10
12
  }
11
13
  /**
14
+ * @public
15
+ *
12
16
  * The output of {@link GetResourcePolicyCommand}.
13
17
  */
14
18
  export interface GetResourcePolicyCommandOutput extends GetResourcePolicyResponse, __MetadataBearer {
15
19
  }
16
20
  /**
21
+ * @public
17
22
  * <p>Retrieves the JSON text of the resource-based policy document attached to the
18
23
  * secret. For more information about permissions policies attached to a secret, see
19
24
  * <a href="https://docs.aws.amazon.com/secretsmanager/latest/userguide/auth-and-access_resource-policies.html">Permissions
@@ -35,6 +40,8 @@ export interface GetResourcePolicyCommandOutput extends GetResourcePolicyRespons
35
40
  * const response = await client.send(command);
36
41
  * ```
37
42
  *
43
+ * @param GetResourcePolicyCommandInput - {@link GetResourcePolicyCommandInput}
44
+ * @returns {@link GetResourcePolicyCommandOutput}
38
45
  * @see {@link GetResourcePolicyCommandInput} for command's `input` shape.
39
46
  * @see {@link GetResourcePolicyCommandOutput} for command's `response` shape.
40
47
  * @see {@link SecretsManagerClientResolvedConfig | config} for SecretsManagerClient's `config` shape.
@@ -89,11 +96,20 @@ export interface GetResourcePolicyCommandOutput extends GetResourcePolicyRespons
89
96
  export declare class GetResourcePolicyCommand extends $Command<GetResourcePolicyCommandInput, GetResourcePolicyCommandOutput, SecretsManagerClientResolvedConfig> {
90
97
  readonly input: GetResourcePolicyCommandInput;
91
98
  static getEndpointParameterInstructions(): EndpointParameterInstructions;
99
+ /**
100
+ * @public
101
+ */
92
102
  constructor(input: GetResourcePolicyCommandInput);
93
103
  /**
94
104
  * @internal
95
105
  */
96
106
  resolveMiddleware(clientStack: MiddlewareStack<ServiceInputTypes, ServiceOutputTypes>, configuration: SecretsManagerClientResolvedConfig, options?: __HttpHandlerOptions): Handler<GetResourcePolicyCommandInput, GetResourcePolicyCommandOutput>;
107
+ /**
108
+ * @internal
109
+ */
97
110
  private serialize;
111
+ /**
112
+ * @internal
113
+ */
98
114
  private deserialize;
99
115
  }