@aws-sdk/client-ebs 3.379.1 → 3.382.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.
@@ -22,6 +22,7 @@ export declare class AccessDeniedException extends __BaseException {
22
22
  readonly $fault: "client";
23
23
  Message?: string;
24
24
  /**
25
+ * @public
25
26
  * <p>The reason for the exception.</p>
26
27
  */
27
28
  Reason: AccessDeniedExceptionReason | string | undefined;
@@ -36,10 +37,12 @@ export declare class AccessDeniedException extends __BaseException {
36
37
  */
37
38
  export interface Block {
38
39
  /**
40
+ * @public
39
41
  * <p>The block index.</p>
40
42
  */
41
43
  BlockIndex?: number;
42
44
  /**
45
+ * @public
43
46
  * <p>The block token for the block index.</p>
44
47
  */
45
48
  BlockToken?: string;
@@ -51,16 +54,19 @@ export interface Block {
51
54
  */
52
55
  export interface ChangedBlock {
53
56
  /**
57
+ * @public
54
58
  * <p>The block index.</p>
55
59
  */
56
60
  BlockIndex?: number;
57
61
  /**
62
+ * @public
58
63
  * <p>The block token for the block index of the <code>FirstSnapshotId</code> specified in
59
64
  * the <code>ListChangedBlocks</code> operation. This value is absent if the first snapshot
60
65
  * does not have the changed block that is on the second snapshot.</p>
61
66
  */
62
67
  FirstBlockToken?: string;
63
68
  /**
69
+ * @public
64
70
  * <p>The block token for the block index of the <code>SecondSnapshotId</code> specified in
65
71
  * the <code>ListChangedBlocks</code> operation.</p>
66
72
  */
@@ -93,14 +99,17 @@ export type ChecksumAlgorithm = (typeof ChecksumAlgorithm)[keyof typeof Checksum
93
99
  */
94
100
  export interface CompleteSnapshotRequest {
95
101
  /**
102
+ * @public
96
103
  * <p>The ID of the snapshot.</p>
97
104
  */
98
105
  SnapshotId: string | undefined;
99
106
  /**
107
+ * @public
100
108
  * <p>The number of blocks that were written to the snapshot.</p>
101
109
  */
102
110
  ChangedBlocksCount: number | undefined;
103
111
  /**
112
+ * @public
104
113
  * <p>An aggregated Base-64 SHA256 checksum based on the checksums of each written
105
114
  * block.</p>
106
115
  * <p>To generate the aggregated checksum using the linear aggregation method, arrange the
@@ -110,11 +119,13 @@ export interface CompleteSnapshotRequest {
110
119
  */
111
120
  Checksum?: string;
112
121
  /**
122
+ * @public
113
123
  * <p>The algorithm used to generate the checksum. Currently, the only supported algorithm
114
124
  * is <code>SHA256</code>.</p>
115
125
  */
116
126
  ChecksumAlgorithm?: ChecksumAlgorithm | string;
117
127
  /**
128
+ * @public
118
129
  * <p>The aggregation method used to generate the checksum. Currently, the only supported
119
130
  * aggregation method is <code>LINEAR</code>.</p>
120
131
  */
@@ -138,6 +149,7 @@ export type Status = (typeof Status)[keyof typeof Status];
138
149
  */
139
150
  export interface CompleteSnapshotResponse {
140
151
  /**
152
+ * @public
141
153
  * <p>The status of the snapshot.</p>
142
154
  */
143
155
  Status?: Status | string;
@@ -178,6 +190,7 @@ export declare class RequestThrottledException extends __BaseException {
178
190
  readonly $fault: "client";
179
191
  Message?: string;
180
192
  /**
193
+ * @public
181
194
  * <p>The reason for the exception.</p>
182
195
  */
183
196
  Reason?: RequestThrottledExceptionReason | string;
@@ -209,6 +222,7 @@ export declare class ResourceNotFoundException extends __BaseException {
209
222
  readonly $fault: "client";
210
223
  Message?: string;
211
224
  /**
225
+ * @public
212
226
  * <p>The reason for the exception.</p>
213
227
  */
214
228
  Reason?: ResourceNotFoundExceptionReason | string;
@@ -237,6 +251,7 @@ export declare class ServiceQuotaExceededException extends __BaseException {
237
251
  readonly $fault: "client";
238
252
  Message?: string;
239
253
  /**
254
+ * @public
240
255
  * <p>The reason for the exception.</p>
241
256
  */
242
257
  Reason?: ServiceQuotaExceededExceptionReason | string;
@@ -279,6 +294,7 @@ export declare class ValidationException extends __BaseException {
279
294
  readonly $fault: "client";
280
295
  Message?: string;
281
296
  /**
297
+ * @public
282
298
  * <p>The reason for the validation exception.</p>
283
299
  */
284
300
  Reason?: ValidationExceptionReason | string;
@@ -321,6 +337,7 @@ export declare class ConflictException extends __BaseException {
321
337
  */
322
338
  export interface GetSnapshotBlockRequest {
323
339
  /**
340
+ * @public
324
341
  * <p>The ID of the snapshot containing the block from which to get data.</p>
325
342
  * <important>
326
343
  * <p>If the specified snapshot is encrypted, you must have permission to use the
@@ -332,6 +349,7 @@ export interface GetSnapshotBlockRequest {
332
349
  */
333
350
  SnapshotId: string | undefined;
334
351
  /**
352
+ * @public
335
353
  * <p>The block index of the block in which to read the data. A block index is a logical
336
354
  * index in units of <code>512</code> KiB blocks. To identify the block index, divide
337
355
  * the logical offset of the data in the logical volume by the block size (logical offset
@@ -340,6 +358,7 @@ export interface GetSnapshotBlockRequest {
340
358
  */
341
359
  BlockIndex: number | undefined;
342
360
  /**
361
+ * @public
343
362
  * <p>The block token of the block from which to get data. You can obtain the <code>BlockToken</code>
344
363
  * by running the <code>ListChangedBlocks</code> or <code>ListSnapshotBlocks</code> operations.</p>
345
364
  */
@@ -350,18 +369,22 @@ export interface GetSnapshotBlockRequest {
350
369
  */
351
370
  export interface GetSnapshotBlockResponse {
352
371
  /**
372
+ * @public
353
373
  * <p>The size of the data in the block.</p>
354
374
  */
355
375
  DataLength?: number;
356
376
  /**
377
+ * @public
357
378
  * <p>The data content of the block.</p>
358
379
  */
359
380
  BlockData?: StreamingBlobTypes;
360
381
  /**
382
+ * @public
361
383
  * <p>The checksum generated for the block, which is Base64 encoded.</p>
362
384
  */
363
385
  Checksum?: string;
364
386
  /**
387
+ * @public
365
388
  * <p>The algorithm used to generate the checksum for the block, such as SHA256.</p>
366
389
  */
367
390
  ChecksumAlgorithm?: ChecksumAlgorithm | string;
@@ -371,6 +394,7 @@ export interface GetSnapshotBlockResponse {
371
394
  */
372
395
  export interface ListChangedBlocksRequest {
373
396
  /**
397
+ * @public
374
398
  * <p>The ID of the first snapshot to use for the comparison.</p>
375
399
  * <important>
376
400
  * <p>The <code>FirstSnapshotID</code> parameter must be specified with a
@@ -379,6 +403,7 @@ export interface ListChangedBlocksRequest {
379
403
  */
380
404
  FirstSnapshotId?: string;
381
405
  /**
406
+ * @public
382
407
  * <p>The ID of the second snapshot to use for the comparison.</p>
383
408
  * <important>
384
409
  * <p>The <code>SecondSnapshotId</code> parameter must be specified with a
@@ -387,12 +412,14 @@ export interface ListChangedBlocksRequest {
387
412
  */
388
413
  SecondSnapshotId: string | undefined;
389
414
  /**
415
+ * @public
390
416
  * <p>The token to request the next page of results.</p>
391
417
  * <p>If you specify <b>NextToken</b>, then
392
418
  * <b>StartingBlockIndex</b> is ignored.</p>
393
419
  */
394
420
  NextToken?: string;
395
421
  /**
422
+ * @public
396
423
  * <p>The maximum number of blocks to be returned by the request.</p>
397
424
  * <p>Even if additional blocks can be retrieved from the snapshot, the request can
398
425
  * return less blocks than <b>MaxResults</b> or an empty
@@ -404,6 +431,7 @@ export interface ListChangedBlocksRequest {
404
431
  */
405
432
  MaxResults?: number;
406
433
  /**
434
+ * @public
407
435
  * <p>The block index from which the comparison should start.</p>
408
436
  * <p>The list in the response will start from this block index or the next valid block
409
437
  * index in the snapshots.</p>
@@ -417,22 +445,27 @@ export interface ListChangedBlocksRequest {
417
445
  */
418
446
  export interface ListChangedBlocksResponse {
419
447
  /**
448
+ * @public
420
449
  * <p>An array of objects containing information about the changed blocks.</p>
421
450
  */
422
451
  ChangedBlocks?: ChangedBlock[];
423
452
  /**
453
+ * @public
424
454
  * <p>The time when the <code>BlockToken</code> expires.</p>
425
455
  */
426
456
  ExpiryTime?: Date;
427
457
  /**
458
+ * @public
428
459
  * <p>The size of the volume in GB.</p>
429
460
  */
430
461
  VolumeSize?: number;
431
462
  /**
463
+ * @public
432
464
  * <p>The size of the blocks in the snapshot, in bytes.</p>
433
465
  */
434
466
  BlockSize?: number;
435
467
  /**
468
+ * @public
436
469
  * <p>The token to use to retrieve the next page of results. This value is null when there
437
470
  * are no more results to return.</p>
438
471
  */
@@ -443,16 +476,19 @@ export interface ListChangedBlocksResponse {
443
476
  */
444
477
  export interface ListSnapshotBlocksRequest {
445
478
  /**
479
+ * @public
446
480
  * <p>The ID of the snapshot from which to get block indexes and block tokens.</p>
447
481
  */
448
482
  SnapshotId: string | undefined;
449
483
  /**
484
+ * @public
450
485
  * <p>The token to request the next page of results.</p>
451
486
  * <p>If you specify <b>NextToken</b>, then
452
487
  * <b>StartingBlockIndex</b> is ignored.</p>
453
488
  */
454
489
  NextToken?: string;
455
490
  /**
491
+ * @public
456
492
  * <p>The maximum number of blocks to be returned by the request.</p>
457
493
  * <p>Even if additional blocks can be retrieved from the snapshot, the request can
458
494
  * return less blocks than <b>MaxResults</b> or an empty
@@ -464,6 +500,7 @@ export interface ListSnapshotBlocksRequest {
464
500
  */
465
501
  MaxResults?: number;
466
502
  /**
503
+ * @public
467
504
  * <p>The block index from which the list should start. The list in the response will start
468
505
  * from this block index or the next valid block index in the snapshot.</p>
469
506
  * <p>If you specify <b>NextToken</b>, then
@@ -476,22 +513,27 @@ export interface ListSnapshotBlocksRequest {
476
513
  */
477
514
  export interface ListSnapshotBlocksResponse {
478
515
  /**
516
+ * @public
479
517
  * <p>An array of objects containing information about the blocks.</p>
480
518
  */
481
519
  Blocks?: Block[];
482
520
  /**
521
+ * @public
483
522
  * <p>The time when the <code>BlockToken</code> expires.</p>
484
523
  */
485
524
  ExpiryTime?: Date;
486
525
  /**
526
+ * @public
487
527
  * <p>The size of the volume in GB.</p>
488
528
  */
489
529
  VolumeSize?: number;
490
530
  /**
531
+ * @public
491
532
  * <p>The size of the blocks in the snapshot, in bytes.</p>
492
533
  */
493
534
  BlockSize?: number;
494
535
  /**
536
+ * @public
495
537
  * <p>The token to use to retrieve the next page of results. This value is null when there
496
538
  * are no more results to return.</p>
497
539
  */
@@ -502,6 +544,7 @@ export interface ListSnapshotBlocksResponse {
502
544
  */
503
545
  export interface PutSnapshotBlockRequest {
504
546
  /**
547
+ * @public
505
548
  * <p>The ID of the snapshot.</p>
506
549
  * <important>
507
550
  * <p>If the specified snapshot is encrypted, you must have permission to use
@@ -513,6 +556,7 @@ export interface PutSnapshotBlockRequest {
513
556
  */
514
557
  SnapshotId: string | undefined;
515
558
  /**
559
+ * @public
516
560
  * <p>The block index of the block in which to write the data. A block index is a logical
517
561
  * index in units of <code>512</code> KiB blocks. To identify the block index, divide
518
562
  * the logical offset of the data in the logical volume by the block size (logical offset of
@@ -521,6 +565,7 @@ export interface PutSnapshotBlockRequest {
521
565
  */
522
566
  BlockIndex: number | undefined;
523
567
  /**
568
+ * @public
524
569
  * <p>The data to write to the block.</p>
525
570
  * <p>The block data is not signed as part of the Signature Version 4 signing process. As a
526
571
  * result, you must generate and provide a Base64-encoded SHA256 checksum for the block
@@ -535,6 +580,7 @@ export interface PutSnapshotBlockRequest {
535
580
  */
536
581
  BlockData: StreamingBlobTypes | undefined;
537
582
  /**
583
+ * @public
538
584
  * <p>The size of the data to write to the block, in bytes. Currently, the only supported
539
585
  * size is <code>524288</code> bytes.</p>
540
586
  * <p>Valid values: <code>524288</code>
@@ -542,15 +588,18 @@ export interface PutSnapshotBlockRequest {
542
588
  */
543
589
  DataLength: number | undefined;
544
590
  /**
591
+ * @public
545
592
  * <p>The progress of the write process, as a percentage.</p>
546
593
  */
547
594
  Progress?: number;
548
595
  /**
596
+ * @public
549
597
  * <p>A Base64-encoded SHA256 checksum of the data. Only SHA256 checksums are
550
598
  * supported.</p>
551
599
  */
552
600
  Checksum: string | undefined;
553
601
  /**
602
+ * @public
554
603
  * <p>The algorithm used to generate the checksum. Currently, the only supported algorithm
555
604
  * is <code>SHA256</code>.</p>
556
605
  */
@@ -561,10 +610,12 @@ export interface PutSnapshotBlockRequest {
561
610
  */
562
611
  export interface PutSnapshotBlockResponse {
563
612
  /**
613
+ * @public
564
614
  * <p>The SHA256 checksum generated for the block data by Amazon EBS.</p>
565
615
  */
566
616
  Checksum?: string;
567
617
  /**
618
+ * @public
568
619
  * <p>The algorithm used by Amazon EBS to generate the checksum.</p>
569
620
  */
570
621
  ChecksumAlgorithm?: ChecksumAlgorithm | string;
@@ -575,10 +626,12 @@ export interface PutSnapshotBlockResponse {
575
626
  */
576
627
  export interface Tag {
577
628
  /**
629
+ * @public
578
630
  * <p>The key of the tag.</p>
579
631
  */
580
632
  Key?: string;
581
633
  /**
634
+ * @public
582
635
  * <p>The value of the tag.</p>
583
636
  */
584
637
  Value?: string;
@@ -588,11 +641,13 @@ export interface Tag {
588
641
  */
589
642
  export interface StartSnapshotRequest {
590
643
  /**
644
+ * @public
591
645
  * <p>The size of the volume, in GiB. The maximum size is <code>65536</code> GiB (64
592
646
  * TiB).</p>
593
647
  */
594
648
  VolumeSize: number | undefined;
595
649
  /**
650
+ * @public
596
651
  * <p>The ID of the parent snapshot. If there is no parent snapshot, or if you are creating
597
652
  * the first snapshot for an on-premises volume, omit this parameter.</p>
598
653
  * <p>You can't specify <b>ParentSnapshotId</b> and
@@ -614,14 +669,17 @@ export interface StartSnapshotRequest {
614
669
  */
615
670
  ParentSnapshotId?: string;
616
671
  /**
672
+ * @public
617
673
  * <p>The tags to apply to the snapshot.</p>
618
674
  */
619
675
  Tags?: Tag[];
620
676
  /**
677
+ * @public
621
678
  * <p>A description for the snapshot.</p>
622
679
  */
623
680
  Description?: string;
624
681
  /**
682
+ * @public
625
683
  * <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the
626
684
  * request. Idempotency ensures that an API request completes only once. With an idempotent
627
685
  * request, if the original request completes successfully. The subsequent retries with the same
@@ -633,6 +691,7 @@ export interface StartSnapshotRequest {
633
691
  */
634
692
  ClientToken?: string;
635
693
  /**
694
+ * @public
636
695
  * <p>Indicates whether to encrypt the snapshot.</p>
637
696
  * <p>You can't specify <b>Encrypted</b> and <b>
638
697
  * ParentSnapshotId</b> in the same request. If you specify both parameters, the
@@ -652,6 +711,7 @@ export interface StartSnapshotRequest {
652
711
  */
653
712
  Encrypted?: boolean;
654
713
  /**
714
+ * @public
655
715
  * <p>The Amazon Resource Name (ARN) of the Key Management Service (KMS) key to be used to encrypt the snapshot.</p>
656
716
  * <p>The encryption status of the snapshot depends on the values that you specify for
657
717
  * <b>Encrypted</b>, <b>KmsKeyArn</b>,
@@ -668,6 +728,7 @@ export interface StartSnapshotRequest {
668
728
  */
669
729
  KmsKeyArn?: string;
670
730
  /**
731
+ * @public
671
732
  * <p>The amount of time (in minutes) after which the snapshot is automatically cancelled
672
733
  * if:</p>
673
734
  * <ul>
@@ -700,48 +761,59 @@ export type SSEType = (typeof SSEType)[keyof typeof SSEType];
700
761
  */
701
762
  export interface StartSnapshotResponse {
702
763
  /**
764
+ * @public
703
765
  * <p>The description of the snapshot.</p>
704
766
  */
705
767
  Description?: string;
706
768
  /**
769
+ * @public
707
770
  * <p>The ID of the snapshot.</p>
708
771
  */
709
772
  SnapshotId?: string;
710
773
  /**
774
+ * @public
711
775
  * <p>The Amazon Web Services account ID of the snapshot owner.</p>
712
776
  */
713
777
  OwnerId?: string;
714
778
  /**
779
+ * @public
715
780
  * <p>The status of the snapshot.</p>
716
781
  */
717
782
  Status?: Status | string;
718
783
  /**
784
+ * @public
719
785
  * <p>The timestamp when the snapshot was created.</p>
720
786
  */
721
787
  StartTime?: Date;
722
788
  /**
789
+ * @public
723
790
  * <p>The size of the volume, in GiB.</p>
724
791
  */
725
792
  VolumeSize?: number;
726
793
  /**
794
+ * @public
727
795
  * <p>The size of the blocks in the snapshot, in bytes.</p>
728
796
  */
729
797
  BlockSize?: number;
730
798
  /**
799
+ * @public
731
800
  * <p>The tags applied to the snapshot. You can specify up to 50 tags per snapshot. For more
732
801
  * information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html"> Tagging your Amazon EC2
733
802
  * resources</a> in the <i>Amazon Elastic Compute Cloud User Guide</i>.</p>
734
803
  */
735
804
  Tags?: Tag[];
736
805
  /**
806
+ * @public
737
807
  * <p>The ID of the parent snapshot.</p>
738
808
  */
739
809
  ParentSnapshotId?: string;
740
810
  /**
811
+ * @public
741
812
  * <p>The Amazon Resource Name (ARN) of the Key Management Service (KMS) key used to encrypt the snapshot.</p>
742
813
  */
743
814
  KmsKeyArn?: string;
744
815
  /**
816
+ * @public
745
817
  * <p>Reserved for future use.</p>
746
818
  */
747
819
  SseType?: SSEType | string;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-ebs",
3
3
  "description": "AWS SDK for JavaScript Ebs Client for Node.js, Browser and React Native",
4
- "version": "3.379.1",
4
+ "version": "3.382.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -21,15 +21,15 @@
21
21
  "dependencies": {
22
22
  "@aws-crypto/sha256-browser": "3.0.0",
23
23
  "@aws-crypto/sha256-js": "3.0.0",
24
- "@aws-sdk/client-sts": "3.379.1",
25
- "@aws-sdk/credential-provider-node": "3.379.1",
24
+ "@aws-sdk/client-sts": "3.382.0",
25
+ "@aws-sdk/credential-provider-node": "3.382.0",
26
26
  "@aws-sdk/middleware-host-header": "3.379.1",
27
27
  "@aws-sdk/middleware-logger": "3.378.0",
28
28
  "@aws-sdk/middleware-recursion-detection": "3.378.0",
29
29
  "@aws-sdk/middleware-signing": "3.379.1",
30
- "@aws-sdk/middleware-user-agent": "3.379.1",
30
+ "@aws-sdk/middleware-user-agent": "3.382.0",
31
31
  "@aws-sdk/types": "3.378.0",
32
- "@aws-sdk/util-endpoints": "3.378.0",
32
+ "@aws-sdk/util-endpoints": "3.382.0",
33
33
  "@aws-sdk/util-user-agent-browser": "3.378.0",
34
34
  "@aws-sdk/util-user-agent-node": "3.378.0",
35
35
  "@smithy/config-resolver": "^2.0.1",