使用 Tools for PowerShell V4 的 Amazon Glacier 示例 - AWS Tools for PowerShell（版本 4）
操作

AWS Tools for PowerShell 版本 5（V5）已经发布！

要开始使用新版本的工具，请参阅《AWS Tools for PowerShell 用户指南（V5）》，特别是关于迁移到 V5 的主题。

使用 Tools for PowerShell V4 的 Amazon Glacier 示例

以下代码示例演示如何通过将 AWS Tools for PowerShell（V4）与 Amazon Glacier 结合使用，来执行操作和实现常见场景。

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

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

主题

操作

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

Tools for PowerShell V4

示例 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 参考（V4）》中的 DescribeJob。

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

Tools for PowerShell V4

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

New-GLCVault -VaultName myvault

输出：

/01234567812/vaults/myvault

  • 有关 API 的详细信息，请参阅《AWS Tools for PowerShell Cmdlet 参考（V4）》中的 CreateVault。

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

Tools for PowerShell V4

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

Read-GLCJobOutput -VaultName myvault -JobId "HSWjArc...Zq2XLiW" -FilePath "c:\temp\blue.bin"

  • 有关 API 的详细信息，请参阅《AWS Tools for PowerShell Cmdlet 参考（V4）》中的 GetJobOutput。

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

Tools for PowerShell V4

示例 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 参考（V4）》中的 InitiateJob。

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

Tools for 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 的详细信息，请参阅《AWS Tools for PowerShell Cmdlet 参考（V4）》中的 UploadArchive。