のバージョン 5 (V5) AWS Tools for PowerShell がリリースされました。
重要な変更とアプリケーションの移行については、[「移行トピック](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)」を参照してください。
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Tools for PowerShell V5 を使用した Amazon Glacier の例
次のコード例は、Amazon Glacier で AWS Tools for PowerShell V5 を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。
*アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。
各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。
**Topics**
+ [アクション](#actions)
## アクション
### `Get-GLCJob`
次のコード例は、`Get-GLCJob` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: 指定したジョブの詳細を返します。ジョブが正常に完了したら、Read-GCJobOutput コマンドレットを使用して、ジョブの内容 (アーカイブまたはインベントリのリスト) をローカルファイルシステムに取得できます。**
```
Get-GLCJob -VaultName myvault -JobId "op1x...JSbthM"
```
**出力:**
```
Action : ArchiveRetrieval
ArchiveId : o9O9j...X-TpIhQJw
ArchiveSHA256TreeHash : 79f3ea754c02f58...dc57bf4395b
ArchiveSizeInBytes : 38034480
Completed : False
CompletionDate : 1/1/0001 12:00:00 AM
CreationDate : 12/13/2018 11:00:14 AM
InventoryRetrievalParameters :
InventorySizeInBytes : 0
JobDescription :
JobId : op1x...JSbthM
JobOutputPath :
OutputLocation :
RetrievalByteRange : 0-38034479
SelectParameters :
SHA256TreeHash : 79f3ea754c02f58...dc57bf4395b
SNSTopic :
StatusCode : InProgress
StatusMessage :
Tier : Standard
VaultARN : arn:aws:glacier:us-west-2:012345678912:vaults/test
```
+ API の詳細については、AWS Tools for PowerShell コマンドレットリファレンス (V5) の「[DescribeJob](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。**
### `New-GLCVault`
次のコード例は、`New-GLCVault` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: ユーザーアカウント用に新しいボールトを作成します。-AccountId パラメータに値が指定されていないため、コマンドレットは現在のアカウントを示すデフォルトの「-」を使用します。**
```
New-GLCVault -VaultName myvault
```
**出力:**
```
/01234567812/vaults/myvault
```
+ API の詳細については、AWS Tools for PowerShell コマンドレットリファレンス (V5) の「[CreateVault](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。**
### `Read-GLCJobOutput`
次のコード例は、`Read-GLCJobOutput` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: 指定したジョブで取得がスケジュールされているアーカイブコンテンツをダウンロードし、コンテンツをディスク上のファイルに保存します。ダウンロード時に、チェックサムがある場合は自動的に検証されます。必要に応じて `-Select '*'` を指定すると、チェックサムを含むレスポンス全体を返すことができます。**
```
Read-GLCJobOutput -VaultName myvault -JobId "HSWjArc...Zq2XLiW" -FilePath "c:\temp\blue.bin"
```
+ API の詳細については、AWS Tools for PowerShell コマンドレットリファレンス (V5) の「[GetJobOutput](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。**
### `Start-GLCJob`
次のコード例は、`Start-GLCJob` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: 指定したユーザー所有のボールトからアーカイブを取得するジョブを開始します。ジョブのステータスは、Get-GLCJob コマンドレットを使用して確認できます。ジョブが正常に完了したら、Read-GCJobOutput コマンドレットを使用して、アーカイブの内容をローカルファイルシステムに取得できます。**
```
Start-GLCJob -VaultName myvault -JobType "archive-retrieval" -JobDescription "archive retrieval" -ArchiveId "o9O9j...TX-TpIhQJw"
```
**出力:**
```
JobId JobOutputPath Location
----- ------------- --------
op1x...JSbthM /012345678912/vaults/test/jobs/op1xe...I4HqCHkSJSbthM
```
+ API の詳細については、AWS Tools for PowerShell コマンドレットリファレンス (V5) の「[InitiateJob](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。**
### `Write-GLCArchive`
次のコード例は、`Write-GLCArchive` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: 指定したボールトに単一のファイルをアップロードし、アーカイブ ID と計算されたチェックサムを返します。**
```
Write-GLCArchive -VaultName myvault -FilePath c:\temp\blue.bin
```
**出力:**
```
FilePath ArchiveId Checksum
-------- --------- --------
C:\temp\blue.bin o9O9jUUs...TTX-TpIhQJw 79f3e...f4395b
```
**例 2: フォルダ階層の内容を、ユーザーアカウント内の指定したボールトにアップロードします。アップロードされたファイルごとに、コマンドレットはファイル名、対応するアーカイブ ID、アーカイブの計算されたチェックサムを出力します。**
```
Write-GLCArchive -VaultName myvault -FolderPath . -Recurse
```
**出力:**
```
FilePath ArchiveId Checksum
-------- --------- --------
C:\temp\blue.bin o9O9jUUs...TTX-TpIhQJw 79f3e...f4395b
C:\temp\green.bin qXAfOdSG...czo729UHXrw d50a1...9184b9
C:\temp\lum.bin 39aNifP3...q9nb8nZkFIg 28886...5c3e27
C:\temp\red.bin vp7E6rU_...Ejk_HhjAxKA e05f7...4e34f5
C:\temp\Folder1\file1.txt _eRINlip...5Sxy7dD2BaA d0d2a...c8a3ba
C:\temp\Folder2\file2.iso -Ix3jlmu...iXiDh-XfOPA 7469e...3e86f1
```
+ API の詳細については、「*AWS Tools for PowerShell コマンドレットリファレンス (V5)*」の「[UploadArchive](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。