View a markdown version of this page

使用适用于 PowerShell V4 的工具的 Amazon Glacier 示例 - Amazon Tools for PowerShell (版本 4)
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

Amazon Tools for PowerShell V4 的支持已到期。

我们建议您迁移到 Amazon Tools for PowerShell V5 。有关如何迁移的更多详细信息和信息,请参阅我们的终止支持公告

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用适用于 PowerShell V4 的工具的 Amazon Glacier 示例

以下代码示例向您展示了如何使用带有 Amazon Glacier 的 Amazon Tools for PowerShell V4 来执行操作和实现常见场景。

操作是大型程序的代码摘录,必须在上下文中运行。您可以通过操作了解如何调用单个服务函数,还可以通过函数相关场景的上下文查看操作。

每个示例都包含一个指向完整源代码的链接,您可以从中找到有关如何在上下文中设置和运行代码的说明。

主题

操作

以下代码示例演示了如何使用 Get-GLCJob

适用于 PowerShell V4 的工具

示例 1:返回指定任务的详细信息。任务成功完成后,可以使用 Read-O GCJob utput 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 的详细信息,请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DescribeJob中的。

以下代码示例演示了如何使用 New-GLCVault

适用于 PowerShell V4 的工具

示例 1:为用户账户创建新文件库。由于未向-AccountId 参数提供任何值,因此 cmdlet 使用默认值 “-” 来表示当前账户。

New-GLCVault -VaultName myvault

输出

/01234567812/vaults/myvault
  • 有关 API 的详细信息,请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateVault中的。

以下代码示例演示了如何使用 Read-GLCJobOutput

适用于 PowerShell V4 的工具

示例 1:下载计划在指定任务中检索的档案内容,并将这些内容存储到磁盘上的文件中。如果有校验和,则下载会为您验证校验和。如果需要,可以通过指定 -Select '*' 来返回包括校验和在内的整个响应。

Read-GLCJobOutput -VaultName myvault -JobId "HSWjArc...Zq2XLiW" -FilePath "c:\temp\blue.bin"
  • 有关 API 的详细信息,请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetJobOutput中的。

以下代码示例演示了如何使用 Start-GLCJob

适用于 PowerShell V4 的工具

示例 1:启动一项任务,从用户拥有的指定文件库中检索档案。可以使用 Get-GLCJob cmdlet 检查作业的状态。任务成功完成后,可以使用读取-GCJob 输出 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 的详细信息,请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) InitiateJob中的。

以下代码示例演示了如何使用 Write-GLCArchive

适用于 PowerShell V4 的工具

示例 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 的详细信息,请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UploadArchive中的。