文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 AWS SDK 範例
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
使用 Tools for PowerShell 的 S3 Glacier 範例
下列程式碼範例示範如何使用 AWS Tools for PowerShell 搭配 S3 Glacier 來執行動作和實作常見案例。
Actions 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
每個範例都包含完整原始程式碼的連結，您可以在其中找到如何在內容中設定和執行程式碼的指示。
主題
動作
下列程式碼範例示範如何使用 Get-GLCJob。
- Tools for PowerShell
-
範例 1：傳回指定任務的詳細資訊。當任務成功完成時，Read-GCJobOutput cmdlet 可用來將任務的內容 （封存或庫存清單） 擷取至本機檔案系統。
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 Cmdlet Reference 中的 DescribeJob。
-
下列程式碼範例示範如何使用 New-GLCVault。
- Tools for PowerShell
-
範例 1：為使用者帳戶建立新的保存庫。由於未將值提供給 -AccountId 參數，Cmdlet 會使用預設值 "-" 來表示目前的帳戶。
New-GLCVault -VaultName myvault輸出：
/01234567812/vaults/myvault-
如需 API 詳細資訊，請參閱 AWS Tools for PowerShell Cmdlet Reference 中的 CreateVault。
-
下列程式碼範例示範如何使用 Read-GLCJobOutput。
- Tools for PowerShell
-
範例 1：下載排程在指定任務中擷取的封存內容，並將內容存放在磁碟上的檔案中。如果可用，下載會為您驗證檢查總和。如果需要，可以透過指定 來傳回包含檢查總和的整個回應
-Select '*'。Read-GLCJobOutput -VaultName myvault -JobId "HSWjArc...Zq2XLiW" -FilePath "c:\temp\blue.bin"-
如需 API 詳細資訊，請參閱《 AWS Tools for PowerShell Cmdlet 參考》中的 GetJobOutput。
-
下列程式碼範例示範如何使用 Start-GLCJob。
- Tools for PowerShell
-
範例 1：啟動任務，從使用者擁有的指定保存庫擷取封存。您可以使用 Get-GLCJob cmdlet 來檢查任務的狀態。當任務成功完成時，Read-GCJobOutput cmdlet 可用來將封存的內容擷取至本機檔案系統。
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 Cmdlet Reference 中的 InitiateJob。
-
下列程式碼範例示範如何使用 Write-GLCArchive。
- Tools for PowerShell
-
範例 1：將單一檔案上傳到指定的保存庫，傳回封存 ID 和計算的檢查總和。
Write-GLCArchive -VaultName myvault -FilePath c:\temp\blue.bin輸出：
FilePath ArchiveId Checksum -------- --------- -------- C:\temp\blue.bin o9O9jUUs...TTX-TpIhQJw 79f3e...f4395b範例 2：將資料夾階層的內容上傳至使用者帳戶中指定的保存庫。對於每個上傳的檔案，Cmdlet 會發出檔案名稱、對應的封存 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 Cmdlet Reference 中的 UploadArchive。
-
