Ejemplos de S3 Glacier que utilizan AWS CLI - AWS SDKEjemplos de código
Acciones

Hay más AWS SDK ejemplos disponibles en el GitHub repositorio de AWS Doc SDK Examples.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ejemplos de S3 Glacier que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes AWS Command Line Interface con S3 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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código se muestra cómo usar abort-multipart-upload.

AWS CLI

El siguiente comando elimina una carga de varias partes en curso a un almacén denominado: my-vault

aws glacier abort-multipart-upload --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ

Este comando no produce ninguna salida. Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso. El comando aws glacier initiate-multipart-upload devuelve el ID de carga y también se puede obtener mediante aws glacier list-multipart-uploads.

Para obtener más información sobre las cargas multiparte a Amazon Glacier mediante el AWS CLI, consulte Uso de Amazon Glacier en la Guía del AWS CLIusuario.

  • Para API obtener más información, consulte la Referencia AbortMultipartUploadde AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar abort-vault-lock.

AWS CLI

Para anular un proceso de bloqueo de bóveda en curso

En el siguiente abort-vault-lock ejemplo, se elimina una política de bloqueo del depósito especificado y se restablece el estado de bloqueo del depósito a desbloqueado.

aws glacier abort-vault-lock \
    --account-id - \
    --vault-name MyVaultName

Este comando no genera ninguna salida.

Para obtener más información, consulte Abortar Vault DELETE Lock (política de bloqueo) en la Guía para desarrolladores de Amazon API Glacier.

  • Para API obtener más información, consulte la Referencia de AbortVaultLockcomandos AWS CLI .

En el siguiente ejemplo de código se muestra cómo usar add-tags-to-vault.

AWS CLI

El siguiente comando añade dos etiquetas a un almacén denominado my-vault:

aws glacier add-tags-to-vault --account-id - --vault-name my-vault --tags id=1234,date=july2015

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

  • Para API obtener más información, consulte AddTagsToVaultla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar complete-multipart-upload.

AWS CLI

El siguiente comando completa la carga multiparte de un archivo de 3 MiB:

aws glacier complete-multipart-upload --archive-size 3145728 --checksum 9628195fcdbcbbe76cdde456d4646fa7de5f219fb39823836d81f0cc0e18aa67 --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ --account-id - --vault-name my-vault

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

El comando aws glacier initiate-multipart-upload devuelve el ID de carga y también se puede obtener mediante aws glacier list-multipart-uploads. El parámetro checksum toma un hash de árbol SHA de -256 bits del archivo en formato hexadecimal.

Para obtener más información sobre las cargas de varias partes a Amazon Glacier mediante el uso de Amazon Glacier AWS CLI, incluidas las instrucciones sobre cómo calcular un hash de árbol, consulte Uso de Amazon Glacier en la Guía del AWS CLIusuario.

En el siguiente ejemplo de código se muestra cómo usar complete-vault-lock.

AWS CLI

Para completar un proceso de bloqueo de bóveda en curso

En el siguiente complete-vault-lock ejemplo, se completa el proceso de bloqueo en curso del depósito especificado y se establece el estado de bloqueo del depósito en. Locked El valor del lock-id parámetro se obtiene cuando se ejecutainitiate-lock-process.

aws glacier complete-vault-lock \
    --account-id - \
    --vault-name MyVaultName \
    --lock-id 9QZgEXAMPLEPhvL6xEXAMPLE

Este comando no genera ninguna salida.

Para obtener más información, consulte Complete Vault Lock (POSTlockId) en la Guía para API desarrolladores de Amazon Glacier.

  • Para API obtener más información, consulte CompleteVaultLockla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar create-vault.

AWS CLI

El comando siguiente crea un nuevo almacén llamado my-vault.

aws glacier create-vault --vault-name my-vault --account-id -

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

  • Para API obtener más información, consulte CreateVaultla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar delete-archive.

AWS CLI

Eliminación de un archivo desde un almacén

En el siguiente ejemplo de delete-archive se elimina el archivo especificado de example_vault.

aws glacier delete-archive \
    --account-id 111122223333  \
    --vault-name example_vault \
    --archive-id Sc0u9ZP8yaWkmh-XGlIvAVprtLhaLCGnNwNl5I5x9HqPIkX5mjc0DrId3Ln-Gi_k2HzmlIDZUz117KSdVMdMXLuFWi9PJUitxWO73edQ43eTlMWkH0pd9zVSAuV_XXZBVhKhyGhJ7w

Este comando no genera ninguna salida.

  • Para API obtener más información, consulte DeleteArchivela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar delete-vault-access-policy.

AWS CLI

Para eliminar la política de acceso de un almacén

En el siguiente delete-vault-access-policy ejemplo, se elimina la política de acceso del almacén especificado.

aws glacier delete-vault-access-policy \
    --account-id 111122223333 \
    --vault-name example_vault

Este comando no genera ninguna salida.

En el siguiente ejemplo de código se muestra cómo usar delete-vault-notifications.

AWS CLI

Para eliminar las SNS notificaciones de un almacén

En el siguiente delete-vault-notifications ejemplo, se eliminan las notificaciones enviadas por Amazon Simple Notification Service (AmazonSNS) para el almacén especificado.

aws glacier delete-vault-notifications \
    --account-id 111122223333 \
    --vault-name example_vault

Este comando no genera ninguna salida.

En el siguiente ejemplo de código se muestra cómo usar delete-vault.

AWS CLI

El comando siguiente elimina un almacén llamado my-vault.

aws glacier delete-vault --vault-name my-vault --account-id -

Este comando no produce ninguna salida. Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

  • Para API obtener más información, consulte DeleteVaultla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar describe-job.

AWS CLI

El siguiente comando recupera información sobre un trabajo de recuperación de inventario en un almacén denominado my-vault:

aws glacier describe-job --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW

Salida:

{
    "InventoryRetrievalParameters": {
        "Format": "JSON"
    },
    "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
    "Completed": false,
    "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
    "Action": "InventoryRetrieval",
    "CreationDate": "2015-07-17T20:23:41.616Z",
    "StatusCode": "InProgress"
}

El ID del trabajo se encuentra en la salida de aws glacier initiate-job y aws glacier list-jobs. Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

  • Para API obtener más información, consulte DescribeJobla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar describe-vault.

AWS CLI

El siguiente comando recupera datos sobre un almacén denominado my-vault:

aws glacier describe-vault --vault-name my-vault --account-id -

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

  • Para API obtener más información, consulte DescribeVaultla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar get-data-retrieval-policy.

AWS CLI

El siguiente comando obtiene la política de recuperación de datos de la cuenta en uso:

aws glacier get-data-retrieval-policy --account-id -

Salida:

{
    "Policy": {
        "Rules": [
            {
                "BytesPerHour": 10737418240,
                "Strategy": "BytesPerHour"
            }
        ]
    }
}

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

En el siguiente ejemplo de código se muestra cómo usar get-job-output.

AWS CLI

El siguiente comando guarda el resultado de un trabajo de inventario de almacén en un archivo del directorio actual denominado output.json:

aws glacier get-job-output --account-id - --vault-name my-vault --job-id zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW output.json

El job-id está disponible en la salida de aws glacier list-jobs. Tenga en cuenta que el nombre de archivo de salida es un argumento posicional que no va precedido de un nombre de opción. Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

Salida:

{
    "status": 200,
    "acceptRanges": "bytes",
    "contentType": "application/json"
}

output.json:

{"VaultARN":"arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault","InventoryDate":"2015-04-07T00:26:18Z","ArchiveList":[{"ArchiveId":"kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw","ArchiveDescription":"multipart upload test","CreationDate":"2015-04-06T22:24:34Z","Size":3145728,"SHA256TreeHash":"9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67"}]}

  • Para API obtener más información, consulte GetJobOutputla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar get-vault-access-policy.

AWS CLI

Para recuperar la política de acceso de un almacén

En el siguiente get-vault-access-policy ejemplo, se recupera la política de acceso del almacén especificado.

aws glacier get-vault-access-policy \
    --account-id 111122223333 \
    --vault-name example_vault

Salida:

{
    "policy": {
        "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"
    }
}

  • Para API obtener más información, consulte GetVaultAccessPolicyla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar get-vault-lock.

AWS CLI

Para obtener los detalles de una cerradura de bóveda

En el siguiente get-vault-lock ejemplo, se recuperaron los detalles sobre el candado de la bóveda especificada.

aws glacier get-vault-lock \
    --account-id - \
    --vault-name MyVaultName

Salida:

{
    "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:99999999999:vaults/MyVaultName\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}",
    "State": "Locked",
    "CreationDate": "2019-07-29T22:25:28.640Z"
}

Para obtener más información, consulte Get Vault GET Lock (política de bloqueo) en la Guía para APIdesarrolladores de Amazon Glacier.

  • Para API obtener más información, consulte la Referencia GetVaultLockde AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar get-vault-notifications.

AWS CLI

El siguiente comando obtiene una descripción de la configuración de notificaciones de un almacén denominado my-vault:

aws glacier get-vault-notifications --account-id - --vault-name my-vault

Salida:

{
    "vaultNotificationConfig": {
        "Events": [
            "InventoryRetrievalCompleted",
            "ArchiveRetrievalCompleted"
        ],
        "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault"
    }
}

Si no se ha configurado ninguna notificación para el almacén, se devuelve un error. Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

En el siguiente ejemplo de código se muestra cómo usar initiate-job.

AWS CLI

El siguiente comando inicia un trabajo para obtener un inventario del almacénmy-vault:

aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters '{"Type": "inventory-retrieval"}'

Salida:

{
    "location": "/0123456789012/vaults/my-vault/jobs/zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
    "jobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW"
}

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

El siguiente comando inicia un trabajo para recuperar un archivo del almacén: my-vault

aws glacier initiate-job --account-id - --vault-name my-vault --job-parameters file://job-archive-retrieval.json

job-archive-retrieval.jsones un JSON archivo de la carpeta local que especifica el tipo de trabajo, el identificador del archivo y algunos parámetros opcionales:

{
  "Type": "archive-retrieval",
  "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
  "Description": "Retrieve archive on 2015-07-17",
  "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-topic"
}

IDsLos archivos están disponibles en la salida de aws glacier upload-archive yaws glacier get-job-output.

Salida:

{
    "location": "/011685312445/vaults/mwunderl/jobs/l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
    "jobId": "l7IL5-EkXy2O5uLYaFdAYOiEY9Ws95fClzIbk-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav"
}

Consulte Initiate Job in the Amazon Glacier API Reference para obtener más información sobre el formato de los parámetros del trabajo.

  • Para API obtener más información, consulte InitiateJobla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar initiate-multipart-upload.

AWS CLI

El siguiente comando inicia una carga multiparte en un almacén cuyo nombre my-vault tiene un tamaño de parte de 1 MiB (1024 x 1024 bytes) por archivo:

aws glacier initiate-multipart-upload --account-id - --part-size 1048576 --vault-name my-vault --archive-description "multipart upload test"

El parámetro de descripción del archivo es opcional. Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

Este comando genera un identificador de carga si se realiza correctamente. Usa el ID de carga cuando subas cada parte de tu archivo conaws glacier upload-multipart-part. Para obtener más información sobre las cargas multiparte a Amazon Glacier mediante el AWS CLI, consulte Uso de Amazon Glacier en la Guía del AWS CLIusuario.

En el siguiente ejemplo de código se muestra cómo usar initiate-vault-lock.

AWS CLI

Para iniciar el proceso de bloqueo de la bóveda

En el siguiente initiate-vault-lock ejemplo, se instala una política de bloqueo de bóveda en la bóveda especificada y se establece el estado de bloqueo de la bóveda en. InProgress Debe completar el proceso llamando complete-vault-lock en un plazo de 24 horas para establecer el estado de bloqueo de la bóveda. Locked

aws glacier initiate-vault-lock \
    --account-id - \
    --vault-name MyVaultName \
    --policy file://vault_lock_policy.json

Contenidos de vault_lock_policy.json:

{"Policy":"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"}

El resultado es el ID de bloqueo de la bóveda que puede utilizar para completar el proceso de bloqueo de la bóveda.

{
    "lockId": "9QZgEXAMPLEPhvL6xEXAMPLE"
}

Para obtener más información, consulte Iniciar Vault POST Lock (política de bloqueo) en la Guía para APIdesarrolladores de Amazon Glacier.

  • Para API obtener más información, consulte la Referencia InitiateVaultLockde AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar list-jobs.

AWS CLI

El siguiente comando muestra los trabajos en curso y los que se han completado recientemente para un almacén denominado my-vault:

aws glacier list-jobs --account-id - --vault-name my-vault

Salida:

{
    "JobList": [
        {
            "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
            "RetrievalByteRange": "0-3145727",
            "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
            "Completed": false,
            "SHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67",
            "JobId": "l7IL5-EkXyEY9Ws95fClzIbk2O5uLYaFdAYOi-azsX_Z8V6NH4yERHzars8wTKYQMX6nBDI9cMNHzyZJO59-8N9aHWav",
            "ArchiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
            "JobDescription": "Retrieve archive on 2015-07-17",
            "ArchiveSizeInBytes": 3145728,
            "Action": "ArchiveRetrieval",
            "ArchiveSHA256TreeHash": "9628195fcdbcbbe76cdde932d4646fa7de5f219fb39823836d81f0cc0e18aa67",
            "CreationDate": "2015-07-17T21:16:13.840Z",
            "StatusCode": "InProgress"
        },
        {
            "InventoryRetrievalParameters": {
                "Format": "JSON"
            },
            "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
            "Completed": false,
            "JobId": "zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW",
            "Action": "InventoryRetrieval",
            "CreationDate": "2015-07-17T20:23:41.616Z",
            "StatusCode": ""InProgress""
        }
    ]
}

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

  • Para API obtener más información, consulte ListJobsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar list-multipart-uploads.

AWS CLI

El siguiente comando muestra todas las cargas multiparte en curso para un almacén denominado: my-vault

aws glacier list-multipart-uploads --account-id - --vault-name my-vault

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

Para obtener más información sobre las cargas multiparte a Amazon Glacier mediante el AWS CLI, consulte Uso de Amazon Glacier en la Guía del AWS CLIusuario.

  • Para API obtener más información, consulte la Referencia ListMultipartUploadsde AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar list-parts.

AWS CLI

El siguiente comando muestra las partes cargadas para una carga de varias partes en un almacén denominadomy-vault:

aws glacier list-parts --account-id - --vault-name my-vault --upload-id "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D"

Salida:

{
    "MultipartUploadId": "SYZi7qnL-YGqGwAm8Kn3BLP2ElNCvnB-5961R09CSaPmPwkYGHOqeN_nX3-Vhnd2yF0KfB5FkmbnBU9GubbdrCs8ut-D",
    "Parts": [
        {
            "RangeInBytes": "0-1048575",
            "SHA256TreeHash": "e1f2a7cd6e047350f69b9f8cfa60fa606fe2f02802097a9a026360a7edc1f553"
        },
        {
            "RangeInBytes": "1048576-2097151",
            "SHA256TreeHash": "43cf3061fb95796aed99a11a6aa3cd8f839eed15e655ab0a597126210636aee6"
        }
    ],
    "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
    "CreationDate": "2015-07-18T00:05:23.830Z",
    "PartSizeInBytes": 1048576
}

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

Para obtener más información sobre las cargas multiparte a Amazon Glacier mediante el AWS CLI, consulte Uso de Amazon Glacier en la Guía del AWS CLIusuario.

  • Para API obtener más información, consulte la Referencia ListPartsde AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar list-provisioned-capacity.

AWS CLI

Para recuperar las unidades de capacidad aprovisionadas

En el siguiente list-provisioned-capacity ejemplo, se recuperan los detalles de cualquier unidad de capacidad aprovisionada para la cuenta especificada.

aws glacier list-provisioned-capacity \
    --account-id 111122223333

Salida:

{
    "ProvisionedCapacityList": [
        {
            "CapacityId": "HpASAuvfRFiVDbOjMfEIcr8K",
            "ExpirationDate": "2020-03-18T19:59:24.000Z",
            "StartDate": "2020-02-18T19:59:24.912Z"
        }
    ]
}

En el siguiente ejemplo de código se muestra cómo usar list-tags-for-vault.

AWS CLI

El siguiente comando muestra las etiquetas aplicadas a un almacén denominado my-vault:

aws glacier list-tags-for-vault --account-id - --vault-name my-vault

Salida:

{
    "Tags": {
        "date": "july2015",
        "id": "1234"
    }
}

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

  • Para API obtener más información, consulte ListTagsForVaultla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar list-vaults.

AWS CLI

El siguiente comando muestra los almacenes de la cuenta y región predeterminadas:

aws glacier list-vaults --account-id -

Salida:

{
    "VaultList": [
        {
            "SizeInBytes": 3178496,
            "VaultARN": "arn:aws:glacier:us-west-2:0123456789012:vaults/my-vault",
            "LastInventoryDate": "2015-04-07T00:26:19.028Z",
            "VaultName": "my-vault",
            "NumberOfArchives": 1,
            "CreationDate": "2015-04-06T21:23:45.708Z"
        }
    ]
}

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

  • Para API obtener más información, consulte ListVaultsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar purchase-provisioned-capacity.

AWS CLI

Para comprar una unidad de capacidad aprovisionada

En el siguiente purchase-provisioned-capacity ejemplo, se compra una unidad de capacidad aprovisionada.

aws glacier purchase-provisioned-capacity \
    --account-id 111122223333

Salida:

{
    "capacityId": "HpASAuvfRFiVDbOjMfEIcr8K"
}

En el siguiente ejemplo de código se muestra cómo usar remove-tags-from-vault.

AWS CLI

El siguiente comando elimina una etiqueta con la clave date de un almacén denominadomy-vault:

aws glacier remove-tags-from-vault --account-id - --vault-name my-vault --tag-keys date

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

  • Para API obtener más información, consulte RemoveTagsFromVaultla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar set-data-retrieval-policy.

AWS CLI

El siguiente comando configura una política de recuperación de datos para la cuenta en uso:

aws glacier set-data-retrieval-policy --account-id - --policy file://data-retrieval-policy.json

data-retrieval-policy.jsones un JSON archivo de la carpeta actual que especifica una política de recuperación de datos:

{
  "Rules":[
     {
         "Strategy":"BytesPerHour",
         "BytesPerHour":10737418240
      }
   ]
}

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

El siguiente comando establece que la política de recuperación de datos se FreeTier utilice en línea: JSON

aws glacier set-data-retrieval-policy --account-id - --policy '{"Rules":[{"Strategy":"FreeTier"}]}'

Consulte Establecer una política de recuperación de datos en la APIreferencia de Amazon Glacier para obtener más información sobre el formato de la política.

En el siguiente ejemplo de código se muestra cómo usar set-vault-access-policy.

AWS CLI

Para configurar la política de acceso de un almacén

En el siguiente set-vault-access-policy ejemplo, se adjunta una política de permisos al almacén especificado.

aws glacier set-vault-access-policy \
    --account-id 111122223333 \
    --vault-name example_vault
    --policy '{"Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:ListJobs\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"},{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::444455556666:root\"},\"Action\":\"glacier:UploadArchive\",\"Resource\":\"arn:aws:glacier:us-east-1:111122223333:vaults/example_vault\"}]}"}'

Este comando no genera ninguna salida.

  • Para API obtener más información, consulte SetVaultAccessPolicyla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar set-vault-notifications.

AWS CLI

El siguiente comando configura SNS las notificaciones de un almacén denominadomy-vault:

aws glacier set-vault-notifications --account-id - --vault-name my-vault --vault-notification-config file://notificationconfig.json

notificationconfig.jsones un JSON archivo de la carpeta actual que especifica un SNS tema y los eventos que se van a publicar:

{
  "SNSTopic": "arn:aws:sns:us-west-2:0123456789012:my-vault",
  "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"]
}

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

En el siguiente ejemplo de código se muestra cómo usar upload-archive.

AWS CLI

El siguiente comando carga un archivo de la carpeta actual denominado archive.zip en un almacén denominado my-vault:

aws glacier upload-archive --account-id - --vault-name my-vault --body archive.zip

Salida:

{
    "archiveId": "kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw",
    "checksum": "969fb39823836d81f0cc028195fcdbcbbe76cdde932d4646fa7de5f21e18aa67",
    "location": "/0123456789012/vaults/my-vault/archives/kKB7ymWJVpPSwhGP6ycSOAekp9ZYe_--zM_mw6k76ZFGEIWQX-ybtRDvc2VkPSDtfKmQrj0IRQLSGsNuDp-AJVlu2ccmDSyDUmZwKbwbpAdGATGDiB3hHO0bjbGehXTcApVud_wyDw"
}

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

Para recuperar un archivo cargado, inicie un trabajo de recuperación con el comando aws glacier initiate-job.

  • Para API obtener más información, consulte UploadArchivela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar upload-multipart-part.

AWS CLI

El siguiente comando carga la primera parte de 1 MiB (1024 x 1024 bytes) de un archivo:

aws glacier upload-multipart-part --body part1 --range 'bytes 0-1048575/*' --account-id - --vault-name my-vault --upload-id 19gaRezEXAMPLES6Ry5YYdqthHOC_kGRCT03L9yetr220UmPtBYKk-OssZtLqyFu7sY1_lR7vgFuJV6NtcV5zpsJ

Amazon Glacier requiere un argumento de ID de cuenta al realizar operaciones, pero puede usar un guion para especificar la cuenta en uso.

El parámetro body toma una ruta a un archivo de parte del sistema de archivos local. El parámetro range toma un rango de HTTP contenido que indica los bytes que ocupa la pieza en el archivo completo. El comando aws glacier initiate-multipart-upload devuelve el ID de carga y también se puede obtener mediante aws glacier list-multipart-uploads.

Para obtener más información sobre las cargas multiparte a Amazon Glacier mediante el AWS CLI, consulte Uso de Amazon Glacier en la Guía del AWS CLIusuario.

  • Para API obtener más información, consulte la Referencia UploadMultipartPartde AWS CLI comandos.