Ejemplos de Amazon Glacier con las Herramientas para PowerShell V4 - Herramientas de AWS para PowerShell (versión 4)
Acciones

Se ha publicado la versión 5 (V5) de Herramientas de AWS para PowerShell.

Para empezar a utilizar la nueva versión de Tools para PowerShell, consulte la Guía del usuario de Herramientas de AWS para PowerShell (V5), especialmente el tema sobre la Migración a la V5.

Ejemplos de Amazon Glacier con las Herramientas para PowerShell V4

En el siguiente ejemplo de código se muestra cómo realizar acciones e implementar escenarios comunes mediante Herramientas de AWS para PowerShell V4 con Amazon Glacier.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar Get-GLCJob.

Herramientas para PowerShell V4

Ejemplo 1: devuelve información detallada de la tarea especificada. Cuando la tarea se completa correctamente, se puede usar el cmdlet Read-GCJobOutput para recuperar el contenido del trabajo (un archivo o una lista de inventario) en el sistema de archivos local.

Get-GLCJob -VaultName myvault -JobId "op1x...JSbthM"

Salida:

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

  • Para obtener información sobre la API, consulte DescribeJob en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar New-GLCVault.

Herramientas para PowerShell V4

Ejemplo 1: crea una nueva bóveda para la cuenta del usuario. Como no se ha proporcionado ningún valor al parámetro -AccountId, los cmdlets utilizan el valor predeterminado «-» para indicar la cuenta actual.

New-GLCVault -VaultName myvault

Salida:

/01234567812/vaults/myvault

  • Para obtener información sobre la API, consulte CreateVault en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Read-GLCJobOutput.

Herramientas para PowerShell V4

Ejemplo 1: descarga el contenido del archivo cuya recuperación estaba programada en la tarea especificada y lo almacena en un archivo en el disco. La descarga valida la suma de comprobación, si hay alguna disponible. Si lo desea, puede devolver la respuesta completa, incluida la suma de verificación, especificando -Select '*'.

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

  • Para obtener información sobre la API, consulte GetJobOutput en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Start-GLCJob.

Herramientas para PowerShell V4

Ejemplo 1: inicia una tarea para recuperar un archivo del almacén especificado propiedad del usuario. El estado de la tarea se puede comprobar mediante el cmdlet Get-GLCJob. Cuando la tarea se completa correctamente, se puede usar el cmdlet Read-GCJobOutput para recuperar el contenido del archivo en el sistema de archivos local.

Start-GLCJob -VaultName myvault -JobType "archive-retrieval" -JobDescription "archive retrieval" -ArchiveId "o9O9j...TX-TpIhQJw"

Salida:

JobId            JobOutputPath Location
-----            ------------- --------
op1x...JSbthM                  /012345678912/vaults/test/jobs/op1xe...I4HqCHkSJSbthM

  • Para obtener información sobre la API, consulte InitiateJob en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).

En el siguiente ejemplo de código, se muestra cómo utilizar Write-GLCArchive.

Herramientas para PowerShell V4

Ejemplo 1: carga un único archivo en el almacén especificado y devuelve el identificador del archivo y la suma de comprobación calculada.

Write-GLCArchive -VaultName myvault -FilePath c:\temp\blue.bin

Salida:

FilePath                    ArchiveId              Checksum
--------                    ---------              --------
C:\temp\blue.bin            o9O9jUUs...TTX-TpIhQJw 79f3e...f4395b

Ejemplo 2: carga el contenido de una jerarquía de carpetas al almacén especificado de la cuenta del usuario. Para cada archivo cargado, el cmdlet emite el nombre del archivo, el identificador de archivo correspondiente y la suma de comprobación calculada del archivo.

Write-GLCArchive -VaultName myvault -FolderPath . -Recurse

Salida:

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

  • Para obtener información sobre la API, consulte UploadArchive en la Referencia de cmdlets de Herramientas de AWS para PowerShell (V4).