Esta página es solo para los clientes actuales del servicio S3 Glacier que utilizan Vaults y la API de REST original de 2012.

Si busca soluciones de almacenamiento de archivos, se recomienda que utilice las clases de almacenamiento de S3 Glacier en Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Para obtener más información sobre estas opciones de almacenamiento, consulte Clases de almacenamiento de S3 Glacier y Almacenamiento de datos a largo plazo con clases de almacenamiento de S3 Glacier en la Guía del usuario de Amazon S3. Estas clases de almacenamiento utilizan la API de Amazon S3, están disponibles en todas las regiones y se pueden administrar en la consola de Amazon S3. Ofrecen funciones como el análisis de costes de almacenamiento, Lente de almacenamiento características avanzadas de cifrado opcionales y más.

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 políticas basadas en identidades para Amazon S3 Glacier

De forma predeterminada, los usuarios y los roles no tienen permiso para crear, ver ni modificar recursos de S3 Glacier. Tampoco pueden realizar tareas mediante la AWS Management Console, AWS Command Line Interface (AWS CLI) o AWS la API. Un gestionador de IAM puede crear políticas de IAM para conceder permisos a los usuarios para realizar acciones en los recursos que necesitan. A continuación, el gestionador puede añadir las políticas de IAM a roles y los usuarios pueden asumirlos.

Para obtener información acerca de cómo crear una política basada en identidades de IAM mediante el uso de estos documentos de políticas JSON de ejemplo, consulte Creación de políticas de IAM (consola) en la Guía del usuario de IAM.

Para obtener más información sobre las acciones y los tipos de recursos definidos por S3 Glacier, incluido el ARNs formato de cada uno de los tipos de recursos, consulte Acciones, recursos y claves de condición de Amazon S3 Glacier en la Referencia de autorización de servicios.

El siguiente es un ejemplo de política que otorga permisos para tres acciones relacionadas con el almacén de S3 Glacier (glacier:CreateVaultglacier:DescribeVaultyglacier:ListVaults) en un recurso, mediante el nombre de recurso de Amazon (ARN) que identifica todos los almacenes de la región. us-west-2 AWS ARNs identifique los recursos de forma exclusiva. AWS Para obtener más información sobre cómo ARNs se usa con S3 Glacier, consulteRecursos de políticas para S3 Glacier.

      {
         "Version": "2012-10-17",
         "Statement": [
            {
               "Effect": "Allow",
               "Action": [
               "glacier:CreateVault",
               "glacier:DescribeVault",
               "glacier:ListVaults"
               ],
               "Resource": "arn:aws:glacier:us-west-2:123456789012:vaults/*"
            }
         ]
      }

La política concede permisos para crear, publicar y obtener descripciones de los almacenes de la región us-west-2. Si aparece el carácter comodín (*) al final del ARN, significa que esta instrucción puede establecer coincidencias con cualquier nombre de almacén.

Prácticas recomendadas sobre las políticas

Las políticas basadas en identidades determinan si alguien puede crear o eliminar los recursos de S3 Glacier en la cuenta y también si pueden acceder a ellos. Estas acciones pueden generar costos adicionales para su Cuenta de AWS. Siga estas directrices y recomendaciones al crear o editar políticas basadas en identidades:

Para obtener más información sobre las prácticas recomendadas de IAM, consulte Prácticas recomendadas de seguridad en IAM en la Guía del usuario de IAM.

Uso de la consola de S3 Glacier

Para acceder a la consola de Amazon S3 Glacier, debe tener un conjunto mínimo de permisos. Estos permisos deben permitirle enumerar y consultar detalles sobre los recursos de S3 Glacier en su Cuenta de AWS. Si crea una política basada en identidades que sea más restrictiva que el mínimo de permisos necesarios, la consola no funcionará del modo esperado para las entidades (usuarios o roles) que tengan esa política.

No es necesario que concedas permisos mínimos de consola a los usuarios que solo realizan llamadas a la API o a la AWS CLI API. AWS En su lugar, permite el acceso únicamente a las acciones que coincidan con la operación de API que intentan realizar.

La consola de S3 Glacier ofrece un entorno integrado que le permite crear y administrar almacenes de S3 Glacier. Como mínimo, las identidades IAM que cree deben tener permisos para la acción glacier:ListVaults a fin de ver la consola de S3 Glacier, tal y como se muestra en el siguiente ejemplo.

         {
               "Version": "2012-10-17",
               "Statement": [
                  {
                     "Action": [
                     "glacier:ListVaults"     
                     ],
                     "Effect": "Allow",
                     "Resource": "*"
                  }
               ]
            }

AWS aborda muchos casos de uso comunes al proporcionar políticas de IAM independientes que son creadas y administradas por. AWS Las políticas administradas conceden los permisos necesarios para casos de uso comunes, lo que le evita tener que investigar los permisos que se necesitan. Para más información, consulte Políticas administradas de AWS en la Guía del usuario de IAM.

Las siguientes políticas AWS administradas, que puede adjuntar a los usuarios de su cuenta, son específicas de S3 Glacier:

También puede crear sus propias políticas de IAM personalizadas para conceder permisos para acciones y recursos de la API de S3 Glacier. Puede asociar estas políticas personalizadas a los roles de IAM personalizados que cree para sus almacenes S3 Glacier.

Las dos políticas AWS gestionadas por S3 Glacier que se describen en la siguiente sección otorgan permisos paraglacier:ListVaults.

Para obtener más información, consulte Adición de permisos a un usuario en la Guía del usuario de IAM:

Cómo permitir a los usuarios consultar sus propios permisos

En este ejemplo, se muestra cómo podría crear una política que permita a los usuarios de IAM ver las políticas gestionadas e insertadas que se asocian a la identidad de sus usuarios. Esta política incluye permisos para completar esta acción en la consola o mediante programación mediante la API AWS CLI o AWS .

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ViewOwnUserInfo",
            "Effect": "Allow",
            "Action": [
                "iam:GetUserPolicy",
                "iam:ListGroupsForUser",
                "iam:ListAttachedUserPolicies",
                "iam:ListUserPolicies",
                "iam:GetUser"
            ],
            "Resource": ["arn:aws:iam::*:user/${aws:username}"]
        },
        {
            "Sid": "NavigateInConsole",
            "Effect": "Allow",
            "Action": [
                "iam:GetGroupPolicy",
                "iam:GetPolicyVersion",
                "iam:GetPolicy",
                "iam:ListAttachedGroupPolicies",
                "iam:ListGroupPolicies",
                "iam:ListPolicyVersions",
                "iam:ListPolicies",
                "iam:ListUsers"
            ],
            "Resource": "*"
        }
    ]
}

Ejemplos de políticas administradas por el cliente

En esta sección, encontrará ejemplos de políticas de usuario que conceden permisos para diversas acciones de S3 Glacier. Estas políticas funcionan cuando utiliza la API REST de S3 Glacier, Amazon SDKs, la consola de administración de S3 Glacier o AWS CLI, si corresponde, la consola de administración de S3 Glacier.

Ejemplo 1: Permitir que un usuario descargue archivos de un almacén

Para descargar un archivo, primero debe iniciar un trabajo que recupere el archivo. Una vez completado el trabajo de recuperación, podrá descargar los datos. La siguiente política de ejemplo concede permisos para ejecutar la acción glacier:InitiateJob e iniciar un trabajo (lo que permite al usuario recuperar un archivo o un inventario del almacén) y permisos para ejecutar la acción glacier:GetJobOutput y descargar los datos recuperados. La política también concede permisos para ejecutar la acción glacier:DescribeJob, de modo que el usuario pueda conocer el estado del trabajo. Para obtener más información, consulte Inicialización de trabajos (POST trabajos).

La política concede estos permisos en un almacén llamado examplevault. Puede obtener el ARN del almacén a través de la consola de Amazon S3 Glacier o mediante programación, mediante la llamada a las acciones de la API Descripción del almacén (GET almacén) o Enumeración de almacenes (GET almacenes).

{
               "Version":"2012-10-17",
               "Statement": [
                  {
                     "Effect": "Allow",
                     "Resource": "arn:aws:glacier:us-west-2:123456789012:vaults/examplevault",
                     "Action":["glacier:InitiateJob",
                              "glacier:GetJobOutput",
                              "glacier:DescribeJob"] 
                  }
               ]
               }

Ejemplo 2: Permitir que un usuario cree un almacén y configure notificaciones

La siguiente política de ejemplo concede permisos para crear un almacén en la región us-west-2 especificada en el elemento Resource y configurar las notificaciones. Para obtener más información sobre el uso de las notificaciones, consulte Configuración de las notificaciones de almacén en Amazon S3 Glacier. La política también otorga permisos para enumerar las bóvedas de la AWS región y obtener una descripción específica de las bóvedas.

{
               "Version":"2012-10-17",
               "Statement": [
                  {
                     "Effect": "Allow",
                     "Resource": "arn:aws:glacier:us-west-2:123456789012:vaults/*",
                     "Action":["glacier:CreateVault",
                              "glacier:SetVaultNotifications",
                              "glacier:GetVaultNotifications",
                              "glacier:DeleteVaultNotifications",
                              "glacier:DescribeVault",
                              "glacier:ListVaults"] 
                  }
               ]
               }

Ejemplo 3: Permitir que un usuario cargue archivos en un almacén concreto

La siguiente política de ejemplo concede permisos para cargar archivos en un almacén específico de la región us-west-2. Estos permisos permiten al usuario cargar un archivo de una sola vez mediante la operación API Carga de archivo (POST archivo) o en partes mediante la operación API Inicio de la carga multiparte (POST cargas-multiparte).

{
               "Version":"2012-10-17",
               "Statement": [
                  {
                     "Effect": "Allow",
                     "Resource": "arn:aws:glacier:us-west-2:123456789012:vaults/examplevault",
                     "Action":["glacier:UploadArchive",
                              "glacier:InitiateMultipartUpload",
                              "glacier:UploadMultipartPart",
                              "glacier:ListParts",
                              "glacier:ListMultipartUploads",
                              "glacier:CompleteMultipartUpload"] 
                  }
               ]
               }

Ejemplo 4: Conceder a un usuario permisos completos sobre un determinado almacén

La siguiente política de ejemplo concede permisos para ejecutar todas las acciones de S3 Glacier en un almacén llamado examplevault.

{
            "Version":"2012-10-17",
            "Statement": [
               {
                  "Effect": "Allow",
                  "Resource": "arn:aws:glacier:us-west-2:123456789012:vaults/examplevault",
                  "Action":["glacier:*"] 
               }
            ]
            }