@aws-sdk/client-glacier 3.288.0 → 3.290.0

package/dist-types/commands/InitiateJobCommand.d.ts

@@ -33,6 +33,53 @@ export interface InitiateJobCommandOutput extends InitiateJobOutput, __MetadataB
  * @see {@link InitiateJobCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InsufficientCapacityException} (client fault)
+ *  <p>Returned if there is insufficient capacity to process this expedited request. This
+ *          error only applies to expedited retrievals and not to standard or bulk
+ *          retrievals.</p>
+ *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link PolicyEnforcedException} (client fault)
+ *  <p>Returned if a retrieval job would exceed the current data policy's retrieval rate
+ *          limit. For more information about data retrieval policies,</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't
+ *          exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To initiate an inventory-retrieval job
+ * ```javascript
+ * // The example initiates an inventory-retrieval job for the vault named examplevault.
+ * const input = {
+ *   "accountId": "-",
+ *   "jobParameters": {
+ *     "Description": "My inventory job",
+ *     "Format": "CSV",
+ *     "SNSTopic": "arn:aws:sns:us-west-2:111111111111:Glacier-InventoryRetrieval-topic-Example",
+ *     "Type": "inventory-retrieval"
+ *   },
+ *   "vaultName": "examplevault"
+ * };
+ * const command = new InitiateJobCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "jobId": " HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID",
+ *   "location": "/111122223333/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID"
+ * }
+ * *\/
+ * // example id: to-initiate-an-inventory-retrieval-job-1482186883826
+ * ```
+ *
  */
 export declare class InitiateJobCommand extends $Command<InitiateJobCommandInput, InitiateJobCommandOutput, GlacierClientResolvedConfig> {
     readonly input: InitiateJobCommandInput;

package/dist-types/commands/InitiateMultipartUploadCommand.d.ts

@@ -62,6 +62,39 @@ export interface InitiateMultipartUploadCommandOutput extends InitiateMultipartU
  * @see {@link InitiateMultipartUploadCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't
+ *          exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To initiate a multipart upload
+ * ```javascript
+ * // The example initiates a multipart upload to a vault named my-vault with a part size of 1 MiB (1024 x 1024 bytes) per file.
+ * const input = {
+ *   "accountId": "-",
+ *   "partSize": "1048576",
+ *   "vaultName": "my-vault"
+ * };
+ * const command = new InitiateMultipartUploadCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "location": "/111122223333/vaults/my-vault/multipart-uploads/19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ",
+ *   "uploadId": "19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ"
+ * }
+ * *\/
+ * // example id: 72f2db19-3d93-4c74-b2ed-38703baacf49
+ * ```
+ *
  */
 export declare class InitiateMultipartUploadCommand extends $Command<InitiateMultipartUploadCommandInput, InitiateMultipartUploadCommandOutput, GlacierClientResolvedConfig> {
     readonly input: InitiateMultipartUploadCommandInput;

package/dist-types/commands/InitiateVaultLockCommand.d.ts

@@ -63,6 +63,40 @@ export interface InitiateVaultLockCommandOutput extends InitiateVaultLockOutput,
  * @see {@link InitiateVaultLockCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't
+ *          exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To initiate the vault locking process
+ * ```javascript
+ * // The example initiates the vault locking process for the vault named my-vault.
+ * const input = {
+ *   "accountId": "-",
+ *   "policy": {
+ *     "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"
+ *   },
+ *   "vaultName": "my-vault"
+ * };
+ * const command = new InitiateVaultLockCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "lockId": "AE863rKkWZU53SLW5be4DUcW"
+ * }
+ * *\/
+ * // example id: to-initiate-the-vault-locking-process-1481919693394
+ * ```
+ *
  */
 export declare class InitiateVaultLockCommand extends $Command<InitiateVaultLockCommandInput, InitiateVaultLockCommandOutput, GlacierClientResolvedConfig> {
     readonly input: InitiateVaultLockCommandInput;

package/dist-types/commands/ListJobsCommand.d.ts

@@ -64,6 +64,64 @@ export interface ListJobsCommandOutput extends ListJobsOutput, __MetadataBearer
  * @see {@link ListJobsCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't
+ *          exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To list jobs for a vault
+ * ```javascript
+ * // The example lists jobs for the vault named my-vault.
+ * const input = {
+ *   "accountId": "-",
+ *   "vaultName": "my-vault"
+ * };
+ * const command = new ListJobsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "JobList": [
+ *     {
+ *       "Action": "ArchiveRetrieval",
+ *       "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
+ *       "ArchiveSHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67",
+ *       "ArchiveSizeInBytes": 3145728,
+ *       "Completed": false,
+ *       "CreationDate": "2015-07-17T21:16:13.840Z",
+ *       "JobDescription": "Retrieve archive on 2015-07-17",
+ *       "JobId": "l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
+ *       "RetrievalByteRange": "0-3145727",
+ *       "SHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67",
+ *       "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
+ *       "StatusCode": "InProgress",
+ *       "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault"
+ *     },
+ *     {
+ *       "Action": "InventoryRetrieval",
+ *       "Completed": false,
+ *       "CreationDate": "2015-07-17T20:23:41.616Z",
+ *       "InventoryRetrievalParameters": {
+ *         "Format": "JSON"
+ *       },
+ *       "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
+ *       "StatusCode": "InProgress",
+ *       "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-list-jobs-for-a-vault-1481920530537
+ * ```
+ *
  */
 export declare class ListJobsCommand extends $Command<ListJobsCommandInput, ListJobsCommandOutput, GlacierClientResolvedConfig> {
     readonly input: ListJobsCommandInput;

package/dist-types/commands/ListMultipartUploadsCommand.d.ts

@@ -54,6 +54,60 @@ export interface ListMultipartUploadsCommandOutput extends ListMultipartUploadsO
  * @see {@link ListMultipartUploadsCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't
+ *          exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To list all the in-progress multipart uploads for a vault
+ * ```javascript
+ * // The example lists all the in-progress multipart uploads for the vault named examplevault.
+ * const input = {
+ *   "accountId": "-",
+ *   "vaultName": "examplevault"
+ * };
+ * const command = new ListMultipartUploadsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Marker": "null",
+ *   "UploadsList": [
+ *     {
+ *       "ArchiveDescription": "archive 1",
+ *       "CreationDate": "2012-03-19T23:20:59.130Z",
+ *       "MultipartUploadId": "xsQdFIRsfJr20CW2AbZBKpRZAFTZSJIMtL2hYf8mvp8dM0m4RUzlaqoEye6g3h3ecqB_zqwB7zLDMeSWhwo65re4C4Ev",
+ *       "PartSizeInBytes": 4194304,
+ *       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
+ *     },
+ *     {
+ *       "ArchiveDescription": "archive 2",
+ *       "CreationDate": "2012-04-01T15:00:00.000Z",
+ *       "MultipartUploadId": "nPyGOnyFcx67qqX7E-0tSGiRi88hHMOwOxR-_jNyM6RjVMFfV29lFqZ3rNsSaWBugg6OP92pRtufeHdQH7ClIpSF6uJc",
+ *       "PartSizeInBytes": 4194304,
+ *       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
+ *     },
+ *     {
+ *       "ArchiveDescription": "archive 3",
+ *       "CreationDate": "2012-03-20T17:03:43.221Z",
+ *       "MultipartUploadId": "qt-RBst_7yO8gVIonIBsAxr2t-db0pE4s8MNeGjKjGdNpuU-cdSAcqG62guwV9r5jh5mLyFPzFEitTpNE7iQfHiu1XoV",
+ *       "PartSizeInBytes": 4194304,
+ *       "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-list-all-the-in-progress-multipart-uploads-for-a-vault-1481935250590
+ * ```
+ *
  */
 export declare class ListMultipartUploadsCommand extends $Command<ListMultipartUploadsCommandInput, ListMultipartUploadsCommandOutput, GlacierClientResolvedConfig> {
     readonly input: ListMultipartUploadsCommandInput;

package/dist-types/commands/ListPartsCommand.d.ts

@@ -50,6 +50,53 @@ export interface ListPartsCommandOutput extends ListPartsOutput, __MetadataBeare
  * @see {@link ListPartsCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't
+ *          exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To list the parts of an archive that have been uploaded in a multipart upload
+ * ```javascript
+ * // The example lists all the parts of a multipart upload.
+ * const input = {
+ *   "accountId": "-",
+ *   "uploadId": "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
+ *   "vaultName": "examplevault"
+ * };
+ * const command = new ListPartsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ArchiveDescription": "archive description",
+ *   "CreationDate": "2012-03-20T17:03:43.221Z",
+ *   "Marker": "null",
+ *   "MultipartUploadId": "OW2fM5iVylEpFEMM9_HpKowRapC3vn5sSL39_396UW9zLFUWVrnRHaPjUJddQ5OxSHVXjYtrN47NBZ-khxOjyEXAMPLE",
+ *   "PartSizeInBytes": 4194304,
+ *   "Parts": [
+ *     {
+ *       "RangeInBytes": "0-4194303",
+ *       "SHA256TreeHash": "01d34dabf7be316472c93b1ef80721f5d4"
+ *     },
+ *     {
+ *       "RangeInBytes": "4194304-8388607",
+ *       "SHA256TreeHash": "0195875365afda349fc21c84c099987164"
+ *     }
+ *   ],
+ *   "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/demo1-vault"
+ * }
+ * *\/
+ * // example id: to-list-the-parts-of-an-archive-that-have-been-uploaded-in-a-multipart-upload-1481921767590
+ * ```
+ *
  */
 export declare class ListPartsCommand extends $Command<ListPartsCommandInput, ListPartsCommandOutput, GlacierClientResolvedConfig> {
     readonly input: ListPartsCommandInput;

package/dist-types/commands/ListProvisionedCapacityCommand.d.ts

@@ -30,6 +30,43 @@ export interface ListProvisionedCapacityCommandOutput extends ListProvisionedCap
  * @see {@link ListProvisionedCapacityCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To list the provisioned capacity units for an account
+ * ```javascript
+ * // The example lists the provisioned capacity units for an account.
+ * const input = {
+ *   "accountId": "-"
+ * };
+ * const command = new ListProvisionedCapacityCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "ProvisionedCapacityList": [
+ *     {
+ *       "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z",
+ *       "ExpirationDate": "2016-12-12T00:00:00.000Z",
+ *       "StartDate": "2016-11-11T20:11:51.095Z"
+ *     },
+ *     {
+ *       "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z",
+ *       "ExpirationDate": "2017-01-15T00:00:00.000Z",
+ *       "StartDate": "2016-12-13T20:11:51.095Z"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-list-the-provisioned-capacity-units-for-an-account-1481923656130
+ * ```
+ *
  */
 export declare class ListProvisionedCapacityCommand extends $Command<ListProvisionedCapacityCommandInput, ListProvisionedCapacityCommandOutput, GlacierClientResolvedConfig> {
     readonly input: ListProvisionedCapacityCommandInput;

package/dist-types/commands/ListTagsForVaultCommand.d.ts

@@ -31,6 +31,40 @@ export interface ListTagsForVaultCommandOutput extends ListTagsForVaultOutput, _
  * @see {@link ListTagsForVaultCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't
+ *          exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To list the tags for a vault
+ * ```javascript
+ * // The example lists all the tags attached to the vault examplevault.
+ * const input = {
+ *   "accountId": "-",
+ *   "vaultName": "examplevault"
+ * };
+ * const command = new ListTagsForVaultCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Tags": {
+ *     "date": "july2015",
+ *     "id": "1234"
+ *   }
+ * }
+ * *\/
+ * // example id: list-tags-for-vault-1481755839720
+ * ```
+ *
  */
 export declare class ListTagsForVaultCommand extends $Command<ListTagsForVaultCommandInput, ListTagsForVaultCommandOutput, GlacierClientResolvedConfig> {
     readonly input: ListTagsForVaultCommandInput;

package/dist-types/commands/ListVaultsCommand.d.ts

@@ -47,6 +47,47 @@ export interface ListVaultsCommandOutput extends ListVaultsOutput, __MetadataBea
  * @see {@link ListVaultsCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't
+ *          exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To list all vaults owned by the calling user's account
+ * ```javascript
+ * // The example lists all vaults owned by the specified AWS account.
+ * const input = {
+ *   "accountId": "-",
+ *   "limit": "",
+ *   "marker": ""
+ * };
+ * const command = new ListVaultsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "VaultList": [
+ *     {
+ *       "CreationDate": "2015-04-06T21:23:45.708Z",
+ *       "LastInventoryDate": "2015-04-07T00:26:19.028Z",
+ *       "NumberOfArchives": 1,
+ *       "SizeInBytes": 3178496,
+ *       "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
+ *       "VaultName": "my-vault"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: list-vaults-1481753006990
+ * ```
+ *
  */
 export declare class ListVaultsCommand extends $Command<ListVaultsCommandInput, ListVaultsCommandOutput, GlacierClientResolvedConfig> {
     readonly input: ListVaultsCommandInput;

package/dist-types/commands/PurchaseProvisionedCapacityCommand.d.ts

@@ -29,6 +29,35 @@ export interface PurchaseProvisionedCapacityCommandOutput extends PurchaseProvis
  * @see {@link PurchaseProvisionedCapacityCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link LimitExceededException} (client fault)
+ *  <p>Returned if the request results in a vault or account limit being exceeded.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To purchases a provisioned capacity unit for an AWS account
+ * ```javascript
+ * // The example purchases provisioned capacity unit for an AWS account.
+ * const input = {
+ *   "accountId": "-"
+ * };
+ * const command = new PurchaseProvisionedCapacityCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "capacityId": "zSaq7NzHFQDANTfQkDen4V7z"
+ * }
+ * *\/
+ * // example id: to-purchases-a-provisioned-capacity-unit-for-an-aws-account-1481927446662
+ * ```
+ *
  */
 export declare class PurchaseProvisionedCapacityCommand extends $Command<PurchaseProvisionedCapacityCommandInput, PurchaseProvisionedCapacityCommandOutput, GlacierClientResolvedConfig> {
     readonly input: PurchaseProvisionedCapacityCommandInput;

package/dist-types/commands/RemoveTagsFromVaultCommand.d.ts

@@ -32,6 +32,36 @@ export interface RemoveTagsFromVaultCommandOutput extends __MetadataBearer {
  * @see {@link RemoveTagsFromVaultCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't
+ *          exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To remove tags from a vault
+ * ```javascript
+ * // The example removes two tags from the vault named examplevault.
+ * const input = {
+ *   "TagKeys": [
+ *     "examplekey1",
+ *     "examplekey2"
+ *   ],
+ *   "accountId": "-",
+ *   "vaultName": "examplevault"
+ * };
+ * const command = new RemoveTagsFromVaultCommand(input);
+ * await client.send(command);
+ * // example id: remove-tags-from-vault-1481754998801
+ * ```
+ *
  */
 export declare class RemoveTagsFromVaultCommand extends $Command<RemoveTagsFromVaultCommandInput, RemoveTagsFromVaultCommandOutput, GlacierClientResolvedConfig> {
     readonly input: RemoveTagsFromVaultCommandInput;

package/dist-types/commands/SetDataRetrievalPolicyCommand.d.ts

@@ -34,6 +34,35 @@ export interface SetDataRetrievalPolicyCommandOutput extends __MetadataBearer {
  * @see {@link SetDataRetrievalPolicyCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To set and then enact a data retrieval policy
+ * ```javascript
+ * // The example sets and then enacts a data retrieval policy.
+ * const input = {
+ *   "Policy": {
+ *     "Rules": [
+ *       {
+ *         "BytesPerHour": 10737418240,
+ *         "Strategy": "BytesPerHour"
+ *       }
+ *     ]
+ *   },
+ *   "accountId": "-"
+ * };
+ * const command = new SetDataRetrievalPolicyCommand(input);
+ * await client.send(command);
+ * // example id: to-set-and-then-enact-a-data-retrieval-policy--1481928352408
+ * ```
+ *
  */
 export declare class SetDataRetrievalPolicyCommand extends $Command<SetDataRetrievalPolicyCommandInput, SetDataRetrievalPolicyCommandOutput, GlacierClientResolvedConfig> {
     readonly input: SetDataRetrievalPolicyCommandInput;

package/dist-types/commands/SetVaultAccessPolicyCommand.d.ts

@@ -34,6 +34,35 @@ export interface SetVaultAccessPolicyCommandOutput extends __MetadataBearer {
  * @see {@link SetVaultAccessPolicyCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't
+ *          exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To set the access-policy on a vault
+ * ```javascript
+ * // The example configures an access policy for the vault named examplevault.
+ * const input = {
+ *   "accountId": "-",
+ *   "policy": {
+ *     "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-owner-access-rights\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\"}]}"
+ *   },
+ *   "vaultName": "examplevault"
+ * };
+ * const command = new SetVaultAccessPolicyCommand(input);
+ * await client.send(command);
+ * // example id: to--set-the-access-policy-on-a-vault-1482185872517
+ * ```
+ *
  */
 export declare class SetVaultAccessPolicyCommand extends $Command<SetVaultAccessPolicyCommandInput, SetVaultAccessPolicyCommandOutput, GlacierClientResolvedConfig> {
     readonly input: SetVaultAccessPolicyCommandInput;

package/dist-types/commands/SetVaultNotificationsCommand.d.ts

@@ -66,6 +66,39 @@ export interface SetVaultNotificationsCommandOutput extends __MetadataBearer {
  * @see {@link SetVaultNotificationsCommandOutput} for command's `response` shape.
  * @see {@link GlacierClientResolvedConfig | config} for GlacierClient's `config` shape.
  *
+ * @throws {@link InvalidParameterValueException} (client fault)
+ *  <p>Returned if a parameter of the request is incorrectly specified.</p>
+ *
+ * @throws {@link MissingParameterValueException} (client fault)
+ *  <p>Returned if a required header or parameter is missing from the request.</p>
+ *
+ * @throws {@link ResourceNotFoundException} (client fault)
+ *  <p>Returned if the specified resource (such as a vault, upload ID, or job ID) doesn't
+ *          exist.</p>
+ *
+ * @throws {@link ServiceUnavailableException} (server fault)
+ *  <p>Returned if the service cannot complete the request.</p>
+ *
+ *
+ * @example To configure a vault to post a message to an Amazon SNS topic when jobs complete
+ * ```javascript
+ * // The example sets the examplevault notification configuration.
+ * const input = {
+ *   "accountId": "-",
+ *   "vaultName": "examplevault",
+ *   "vaultNotificationConfig": {
+ *     "Events": [
+ *       "ArchiveRetrievalCompleted",
+ *       "InventoryRetrievalCompleted"
+ *     ],
+ *     "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"
+ *   }
+ * };
+ * const command = new SetVaultNotificationsCommand(input);
+ * await client.send(command);
+ * // example id: to-configure-a-vault-to-post-a-message-to-an-amazon-simple-notification-service-amazon-sns-topic-when-jobs-complete-1482186397475
+ * ```
+ *
  */
 export declare class SetVaultNotificationsCommand extends $Command<SetVaultNotificationsCommandInput, SetVaultNotificationsCommandOutput, GlacierClientResolvedConfig> {
     readonly input: SetVaultNotificationsCommandInput;