**Esta página es solo para los clientes actuales del servicio Amazon 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 Amazon 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 las [clases de almacenamiento de Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (servicio original independiente basado en bóveda) ya no acepta nuevos clientes. Amazon Glacier es un servicio independiente propio APIs que almacena datos en almacenes y es distinto de las clases de almacenamiento Amazon S3 y Amazon S3 Glacier. Sus datos actuales permanecerán seguros y accesibles en Amazon Glacier de forma indefinida. No hay que hacer migraciones. Para un almacenamiento de archivos a largo plazo y de bajo costo, AWS recomienda las [clases de almacenamiento Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), que ofrecen una experiencia de cliente superior con S3 basada en cubos APIs, Región de AWS disponibilidad total, costos más bajos e AWS integración de servicios. Si desea mejorar las capacidades, considere la posibilidad de migrar a las clases de almacenamiento de Amazon S3 Glacier mediante nuestra [AWS Guía de soluciones para la transferencia de datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

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.

# Configuración de la política de acceso al almacén (PUT access-policy)
<a name="api-SetVaultAccessPolicy"></a>

## Description (Descripción)
<a name="api-SetVaultAccessPolicy-description"></a>

Esta operación configura una política de acceso para un almacén y sobrescribe una política existente. Para configurar una política de acceso a almacén, envíe una solicitud `PUT` al subrecurso `access-policy` del almacén. Puede definir una política de acceso por almacén y la política puede tener un tamaño de hasta 20 KB. Para obtener más información sobre las políticas de acceso a almacenes, consulte [Políticas de acceso a almacenes](vault-access-policy.md). 

## Solicitudes
<a name="api-SetVaultAccessPolicy-requests"></a>

### Sintaxis
<a name="api-SetVaultAccessPolicy-requests-syntax"></a>

Para configurar una política de acceso a almacén, envíe una solicitud HTTP `PUT` al URI del subrecurso `access-policy` del almacén, tal y como se muestra en el siguiente ejemplo de sintaxis.

```
 1. PUT /AccountId/vaults/vaultName/access-policy HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. Content-Length: Length
 6. x-amz-glacier-version: 2012-06-01
 7. 			
 8. {
 9.   "Policy": "string"
10. }
```

 

**nota**  
El `AccountId` valor es el Cuenta de AWS identificador de la cuenta propietaria del almacén. Puede especificar un Cuenta de AWS ID o, si lo desea, un único `-` '' (guión), en cuyo caso Amazon Glacier utilizará el Cuenta de AWS ID asociado a las credenciales utilizadas para firmar la solicitud. Si usa un ID de cuenta, no incluya ningún guion (“-”) en el ID.

### Parámetros de la solicitud
<a name="api-SetVaultAccessPolicy-requests-parameters"></a>

Esta operación no usa parámetros de solicitud.

### Encabezados de solicitud
<a name="api-SetVaultAccessPolicy-requests-headers"></a>

Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte [Encabezados de solicitudes comunes](api-common-request-headers.md).

### Cuerpo de la solicitud
<a name="api-SetVaultAccessPolicy-requests-elements"></a>

El cuerpo de la solicitud contiene los siguientes campos JSON.

 **Política**   
Política de acceso a almacenes en forma de una cadena JSON, donde se utiliza" \$1" como carácter de escape.  
 Tipo: cadena   
 Obligatorio: sí

## Respuestas
<a name="api-SetVaultAccessPolicy-responses"></a>

En respuesta, Amazon Glacier devuelve `204 No Content` si se acepta la política.

### Sintaxis
<a name="api-SetVaultAccessPolicy-response-syntax"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```

### Encabezados de respuesta
<a name="api-SetVaultAccessPolicy-responses-headers"></a>

Esta operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener información acerca de los encabezados de respuestas comunes, consulte [Encabezados de respuesta comunes](api-common-response-headers.md).

### Cuerpo de respuesta
<a name="api-SetVaultAccessPolicy-responses-elements"></a>

Esta operación no devuelve ningún cuerpo de respuesta.

### Errores
<a name="api-SetVaultAccessPolicy-responses-errors"></a>

Para obtener información acerca de los mensajes de error y las excepciones de Amazon Glacier, consulte [Respuestas de error](api-error-responses.md).

## Ejemplos
<a name="api-SetVaultAccessPolicy-examples"></a>

### Solicitud de ejemplo
<a name="api-SetVaultAccessPolicy-example-request"></a>

El siguiente ejemplo envía una solicitud HTTP `PUT` dirigida al URI del subrecurso `access-policy` del almacén. La cadena JSON `Policy` utiliza "\$1" como carácter de escape.

```
1. PUT /-/vaults/examplevault/access-policy HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
7. 
8. {"Policy":"{\"Version\":\"2012-10-17\",		 	 	 \"Statement\":[{\"Sid\":\"Define-owner-access-rights\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\"}]}"}
```

### Respuesta de ejemplo
<a name="api-SetVaultAccessPolicy-example-response"></a>

Si la solicitud se realizó correctamente, Amazon Glacier (Amazon Glacier) devuelve `HTTP 204 No Content`, tal y como se muestra en el ejemplo siguiente.

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```

## Secciones relacionadas
<a name="related-sections-SetVaultAccessPolicy"></a>

 
+ [Eliminación de la política de acceso del almacén (DELETE política-acceso)](api-DeleteVaultAccessPolicy.md)

 
+ [Obtención de la política de acceso del almacén (GET política-acceso)](api-GetVaultAccessPolicy.md)

## Véase también
<a name="api-SetVaultAccessPolicy_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos de Amazon SDKs, consulta lo siguiente:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/set-vault-access-policy.html)