Descripción Consulta de archivos con solicitudes Select Restauración de archivos Solicitudes Respuestas Ejemplos Más información

POST Object restore

Descripción

Esta operación realiza los siguientes tipos de solicitudes:

select: realización de una consulta Select en un objeto archivado
restore an archive: restauración de un objeto archivado

Para usar esta operación, debe tener permisos para realizar las acciones s3:RestoreObject y s3:GetObject. El propietario del bucket tiene este permiso de forma predeterminada y puede conceder este permiso a otros. Para obtener más información sobre permisos, consulte Permisos relacionados con operaciones de subrecursos de bucket y Administración de permisos de acceso a los recursos de Amazon S3 en la Guía del usuario de Amazon Simple Storage Service.

Consulta de archivos con solicitudes Select

Puede utilizar un tipo de solicitud Select para realizar consultas SQL sobre objetos archivados. Los objetos archivados que se consultan mediante solicitud Select deben tener un formato de archivos de valores separados por comas (CSV) sin comprimir. Puede ejecutar consultas y análisis personalizados de los datos archivados sin necesidad de restaurar los datos en un nivel de mayor actividad de Amazon S3. Para obtener información general sobre las solicitudes Select, consulte Consulta de objetos archivados en la Guía del usuario de Amazon Simple Storage Service.

Al realizar una solicitud Select, realice lo siguiente:

Defina una ubicación de salida para la salida de la consulta Select. Esta debe ser un bucket de Amazon S3 en la misma Región de AWS que el bucket que contiene el objeto de archivo que se está consultando. La Cuenta de AWS que inicia el trabajo debe tener permisos para escribir en el bucket de S3. Puede especificar la clase de almacenamiento y el cifrado de los objetos de salida almacenados en el bucket. Para obtener más información sobre la salida, consulte Consulta de objetos archivados en la Guía del usuario de Amazon Simple Storage Service.

Para obtener más información acerca de la estructura de S3 del cuerpo de la solicitud, consulte lo siguiente:
- PutObject
- Administración de acceso con ACL en la Guía del usuario de Amazon Simple Storage Service
- protección de los datos con el cifrado del servidor en la Guía del usuario de Amazon Simple Storage Service
Defina la expresión SQL para el tipo de restauración SELECT de la consulta en la estructura SelectParameters del cuerpo de la solicitud. Puede utilizar expresiones como las siguientes.
- La expresión siguiente devuelve todos los registros del objeto especificado.
```
SELECT * FROM Object
```
- Si no está utilizando encabezados para los datos almacenados en el objeto, puede especificar columnas con encabezados posicionales.
```
SELECT s._1, s._2 FROM Object s WHERE s._3 > 100
```
- Si tiene encabezados y establece fileHeaderInfo en la estructura de CSV en el cuerpo de la solicitud como USE, puede especificar encabezados en la consulta. (Si establece el campo fileHeaderInfo en IGNORE, la primera fila se omite en la consulta). No se pueden mezclar las posiciones ordinales con los nombres de columna de los encabezados.
```
SELECT s.Id, s.FirstName, s.SSN FROM S3Object s
```

Para obtener más información acerca del uso de SQL con la restauración de Amazon Glacier Select, consulte Referencia de SQL para Amazon S3 Select y Amazon Glacier Select en la Guía del usuario de Amazon Simple Storage Service.

Al realizar una solicitud Select, también puede hacer lo siguiente:

Para acelerar las consultas, especifique el nivel Expedited. Para obtener más información acerca de los niveles, consulte “Restauración de archivos” más adelante en este tema.
Especifique detalles sobre el formato de serialización de los datos del objeto de entrada que se consulta y la serialización de los resultados de la consulta codificados como CSV.

A continuación, se muestran datos adicionales importantes sobre la característica de selección:

Los resultados de salida son objetos nuevos de Amazon S3. A diferencia de las recuperaciones de archivos, se almacenan hasta que se eliminen de forma explícita, ya sea de forma manual o mediante una política de ciclo de vida.
Puede emitir más de una solicitud Select en el mismo objeto de Amazon S3. Amazon S3 no deduplica las solicitudes, así que evite emitir solicitudes duplicadas.
Amazon S3 acepta una solicitud Select incluso si el objeto ya se ha restaurado. Una solicitud Select no devuelve una respuesta de error 409.

Restauración de archivos

Los objetos en las clases de almacenamiento GLACIER y DEEP_ARCHIVE se archivan. Para obtener acceso a un objeto archivado, primero debe iniciar una solicitud de restauración. Esto restaura una copia temporal del objeto archivado. En una solicitud de restauración, se debe especificar el número de días durante los que se quiere que exista la copia restaurada. Después del periodo especificado, Amazon S3 elimina la copia temporal pero el objeto permanece archivado en la clase de almacenamiento GLACIER o DEEP_ARCHIVE desde la que se restauró el objeto.

Para restaurar una versión específica del objeto, puede proporcionar un ID de versión. Si no proporciona un ID de versión, Amazon S3 restaura la versión actual.

El tiempo que tardan los trabajos de restauración en finalizar depende de la clase de almacenamiento desde la que se esté restaurando el objeto y del nivel de acceso a los datos que especifique.

Al restaurar un objeto archivado (o utilizar una solicitud Select), puede especificar una de las siguientes opciones de nivel de acceso a datos en el elemento Tier del cuerpo de la solicitud:

Expedited - las recuperaciones rápidas le permiten obtener acceso rápidamente a sus datos almacenados en la clase de almacenamiento GLACIER cuando son necesarias solicitudes urgentes ocasionales para un subconjunto de archivos. En todos los casos salvo para los objetos archivados de mayor tamaño (más de 250 MB), los datos a los que se obtiene acceso con solicitudes rápidas suelen estar disponibles en entre 1 y 5 minutos. La capacidad aprovisionada garantiza que la capacidad que necesitan las recuperaciones Expedited estará disponible cuando lo necesite. Las recuperaciones rápidas y la capacidad aprovisionada no están disponibles para la clase de almacenamiento DEEP_ARCHIVE.
Standard - las recuperaciones estándares le permiten acceder a sus objetos archivados en un plazo de varias horas. Esta es la opción predeterminada para las solicitudes de recuperación de GLACIER y DEEP_ARCHIVE que no especifican la opción de recuperación. Las recuperaciones estándar suelen completarse en un plazo de 3 a 5 horas en el caso de la clase de almacenamiento GLACIER y, en el caso de la clase de almacenamiento DEEP_ARCHIVE, en un plazo de 12 horas.
Bulk: las recuperaciones en bloque son la opción de recuperación menos costosa de Amazon Glacier, lo que permite recuperar grandes cantidades de datos, incluso petabytes, de forma económica en un día. Las recuperaciones en bloque suelen completarse en un plazo de 5 a 12 horas en el caso de la clase de almacenamiento GLACIER y, en el caso de la clase de almacenamiento DEEP_ARCHIVE, en un plazo de 48 horas.

Para obtener más información acerca de las opciones de recuperación de archivos y capacidad aprovisionada para acceso a datos Expedited, consulte Restauración de objetos archivados en la Guía del usuario de Amazon Simple Storage Service.

Puede usar la actualización de la velocidad de restauración de Amazon S3 para cambiar la velocidad de restauración a una velocidad más rápida mientras está en curso. Para actualizar la velocidad de una restauración en curso, se emite otra solicitud de restauración para el mismo objeto y se establece un nuevo elemento de solicitud Tier. Al emitir una solicitud para actualizar la capa de restauración, debe elegir una capa más rápida que la capa de la restauración en curso que está usando. No debe cambiar ningún otro parámetro (por ejemplo: el elemento de solicitud Days). Para obtener más información, consulte Actualización de la velocidad de una restauración en curso en la Guía del usuario de Amazon Simple Storage Service.

Para obtener el estado de la restauración de un objeto, puede enviar una solicitud HEAD. Las operaciones devuelven el encabezado x-amz-restore, que proporciona información sobre el estado de la restauración, en la respuesta. Puede usar las notificaciones de eventos de Amazon S3 para notificar cuando se inicie o complete una restauración. Para obtener más información, consulte Configuración de notificaciones de eventos de Amazon S3 en la Guía del usuario de Amazon Simple Storage Service.

Tras restaurar un objeto archivado, puede actualizar el periodo de restauración volviendo a emitir la solicitud con un nuevo periodo. Amazon S3 actualiza el periodo de restauración en relación con el momento actual y solo cobra por la solicitud; no hay cargos por transferencia de datos. No puede actualizar el periodo de restauración cuando Amazon S3 esté procesando activamente la solicitud de restauración actual para el objeto.

Si el bucket tiene una configuración de ciclo de vida con una regla que incluye una acción de caducidad, la caducidad del objeto invalida la vida útil que especifique en la solicitud de restauración. Por ejemplo, si restaura una copia de un objeto durante 10 días, pero está previsto que el objeto caduque en 3 días, Amazon S3 elimina el objeto en 3 días. Para obtener más información sobre la configuración del ciclo de vida, consulte PutBucketLifecycleConfiguration y Administración del ciclo de vida del objeto en la Guía del usuario de Amazon Simple Storage Service.

Solicitudes

Sintaxis


POST /ObjectName?restore&versionId=VersionID HTTP/1.1
Host: BucketName.s3.amazonaws.com
Date: date
Authorization: authorization string (see Autenticación de solicitudes (AWS Signature Version 4))
Content-MD5: MD5

 request body

nota

La sintaxis muestra algunos de los encabezados de las solicitudes. Para obtener una lista completa, consulte “Encabezados de solicitudes”, más adelante en este tema.

Parámetros de la solicitud

Esta aplicación de la operación no utiliza parámetros de solicitud.

Encabezados de solicitud

Nombre Descripción Obligatorio

Nombre	Descripción	Obligatorio
`Content-MD5`	Resumen MD5 de 128 bits de los datos cifrados en base64. Debe utilizar este encabezado como comprobación de la integridad del mensaje para comprobar que el cuerpo de la solicitud no se dañó durante el tránsito. Para obtener más información, consulte RFC 1864. Tipo: cadena Valor predeterminado: None	Sí

Content-MD5

Resumen MD5 de 128 bits de los datos cifrados en base64. Debe utilizar este encabezado como comprobación de la integridad del mensaje para comprobar que el cuerpo de la solicitud no se dañó durante el tránsito. Para obtener más información, consulte RFC 1864.

Tipo: cadena

Valor predeterminado: None

Sí

Elementos de la solicitud

A continuación, se muestra un ejemplo de XML del cuerpo de una solicitud para restaurar un archivo.


<RestoreRequest>
   <Days>2</Days> 
   <GlacierJobParameters>
     <Tier>Bulk</Tier>
   </GlacierJobParameters> 
</RestoreRequest>

En la tabla siguiente, se explica el XML para la restauración del archivo en el cuerpo de la solicitud.

Nombre	Descripción	Obligatorio
`RestoreRequest`	Contenedor para restaurar información. Tipo: Contenedor	Sí
`Days`	Duración de la copia restaurada (activa). El número mínimo de días para restaurar un objeto de Amazon Glacier es de 1. Una vez que la copia del objeto alcanza la vida útil especificada, Amazon S3 la elimina del bucket. Si va a restaurar un archivo, este elemento es obligatorio. No utilice este elemento con un tipo de solicitud `SELECT`. Tipo: entero positivo Antecesores: `RestoreRequest`	Sí, si se restaura un archivo
`GlacierJobParameters`	Contenedor para los parámetros de trabajo de clase de almacenamiento de S3 Glacier. No utilice este elemento con un tipo de solicitud `SELECT`. Tipo: Contenedor Antecesores: `RestoreRequest`	No
`Tier`	El nivel de acceso a los datos que se utilizará al restaurar el archivo. `Standard` es el predeterminado. Tipo: enumeración Valores válidos: `Expedited` \| `Standard` \| `Bulk` Antecesores: `GlacierJobParameters`	No

El siguiente XML es el cuerpo de la solicitud para una consulta de selección en un objeto archivado:


<RestoreRequest>
    <Type>SELECT</Type>
    <Tier>Expedited</Tier>
    <Description>Job description</Description>
    <SelectParameters>
          <Expression>Select * from Object</Expression>
          <ExpressionType>SQL</ExpressionType>
          <InputSerialization>
              <CSV>
                  <FileHeaderInfo>IGNORE</FileHeaderInfo>
                  <RecordDelimiter>\n</RecordDelimiter>
                  <FieldDelimiter>,</FieldDelimiter>
                  <QuoteCharacter>"</QuoteCharacter>
                  <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
                  <Comments>#</Comments>
              </CSV>
           </InputSerialization>
         <OutputSerialization>
             <CSV>
                 <QuoteFields>ASNEEDED</QuoteFields>
                 <RecordDelimiter>\n</RecordDelimiter>
                 <FieldDelimiter>,</FieldDelimiter>
                 <QuoteCharacter>"</QuoteCharacter>
                 <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
             </CSV>                                
         </OutputSerialization>
    </SelectParameters>
    <OutputLocation>
        <S3>
	     <BucketName>Name of bucket</BucketName>
            <Prefix>Key prefix</Prefix>
	      <CannedACL>Canned ACL string</CannedACL>
	      <AccessControlList>
		    <Grantee>
		        <Type>Grantee Type</Type>
			 <ID>Grantee identifier</ID>
			 <URI>Grantee URI</URI>
		       <Permission>Granted permission</Permission>
                    <DisplayNmae>Display Name</DisplayName>
                    <EmailAddress>email</EmailAddress>
		    </Grantee>
	      </AccessControlList>
	      <Encryption>
	            <EncryptionType>Encryption type</EncryptionType>
		     <KMSKeyId>KMS Key ID</KMSKeyId>
		     <KMSContext>Base64-encoded JSON<KMSContext>
            </Encryption>
	     <UserMetadata>
               <MetadataEntry>
                   <Name>Key</Name>
                   <Value>Value</Value>
               </MetadataEntry>
            </UserMetadata>
            <Tagging>
                <TagSet>
                    <Tag>
                        <Key>Tag name</Key>
                        <Value>Tag value</Value>
                    </Tag>
               </TagSet>
            </Tagging>
            <StorageClass>Storage class</StorageClass>
	 </S3>
    </OutputLocation>
</RestoreRequest>

En las tablas siguientes, se explica el XML para un tipo de restauración SELECT en el cuerpo de la solicitud.

Nombre	Descripción	Obligatorio
`RestoreRequest`	Contenedor para restaurar información. Tipo: Contenedor	Sí
`Tier`	El nivel de acceso a los datos que se utilizará al restaurar el archivo. `Standard` es el predeterminado. Tipo: enumeración Valores válidos: `Expedited` \| `Standard` \| `Bulk` Antecesores: `RestoreRequest`	No
`Description`	La descripción opcional de la solicitud. Tipo: cadena Antecesores: `RestoreRequest`	No
`SelectParameters`	Describe los parámetros de la solicitud del trabajo de selección. Tipo: Contenedor Antecesores: `RestoreRequest`	Sí, si el tipo de solicitud es `SELECT`
`OutputLocation`	Describe la ubicación que recibe los resultados de la solicitud de restauración de selección. Tipo: Contenedor para Amazon S3 Antecesores: `RestoreRequest`	Sí, si el tipo de solicitud es `SELECT`

El elemento del contenedor `SelectParameters` contiene los siguientes elementos.
Nombre	Descripción	Obligatorio
`Expression`	La expresión SQL. Por ejemplo: La siguiente expresión SQL recupera la primera columna de los datos del objeto almacenado en formato CSV: `SELECT s._1 FROM Object s` La siguiente expresión SQL devuelve todo del objeto: `SELECT * FROM Object` Tipo: cadena Antecesores: `SelectParameters`	Sí
`ExpressionType`	Identifica el tipo de expresión. Tipo: cadena Valores válidos: `SQL` Antecesores: `SelectParameters`	Sí
`InputSerialization`	Describe el formato de serialización del objeto. Tipo: contenedor para CSV Antecesores: `SelectParameters`	Sí
`OutputSerialization`	Describe cómo se serializan los resultados del trabajo de selección. Tipo: contenedor para CSV Antecesores: `SelectParameters`	Sí

El elemento de contenedor de CSV del elemento `InputSerialization` contiene los siguientes elementos.
Nombre	Descripción	Obligatorio
`RecordDelimiter`	Un único carácter usado para separar registros individuales en la entrada. En lugar del valor predeterminado, puede especificar un delimitador arbitrario. Tipo: cadena Valor predeterminado: `\n` Antecesores: `CSV`	No
`FieldDelimiter`	Un carácter único usado para separar los campos individuales de un registro. Puede especificar un delimitador arbitrario. Tipo: cadena Valor predeterminado: `,` Antecesores: `CSV`	No
`QuoteCharacter`	Un carácter único que se utiliza como escape cuando el delimitador del campo forma parte del valor. Considere este ejemplo en un archivo CSV: `"a, b"` Al incluir el valor entre comillas, este valor se convierte en un solo campo. Si no usa las comillas, la coma es un delimitador de campo (lo que las convierte en dos valores de campo independientes, a y b). Tipo: cadena Valor predeterminado: `"` Antecesores: `CSV`	No
`QuoteEscapeCharacter`	Un carácter único utilizado como escape con el carácter de comillas cuando está dentro de un valor que ya contiene caracteres de escape. Por ejemplo, el valor `""" a , b """` se analiza como `" a , b "`. Tipo: cadena Valor predeterminado: `"` Antecesores: `CSV`	No
`FileHeaderInfo`	Describe la primera línea de los datos de entrada. Es uno de los valores ENUM. `NONE`: la primera línea no es un encabezado. `IGNORE`: la primera línea es un encabezado, pero no puede usar los valores del encabezado para indicar la columna en una expresión. Puede usar la posición de la columna (como _1, _2...) para indicar la columna (`SELECT s._1 FROM OBJECT s`). `Use`: la primera línea es un encabezado y puede usar el valores del encabezado para identificar una columna en una expresión (`SELECT "name" FROM OBJECT`). Tipo: enumeración Valores válidos: -.: `NONE \| USE \| IGNORE` Antecesores: `CSV`	No
`Comments`	Carácter único que se utiliza para indicar que una fila debe omitirse cuando el carácter está presente al inicio de esa fila. Puede especificar cualquier carácter para indicar una línea de comentario. Tipo: cadena Antecesores: `CSV`	No

El elemento de contenedor de CSV (en los elementos `OutputSerialization`) contiene los siguientes elementos.
Nombre	Descripción	Obligatorio
`QuoteFields`	Indica si se deben usar comillas en los campos de salida. `ALWAYS`: utilice siempre comillas en los campos de salida. `ASNEEDED`: utilice comillas en los campos de salida cuando sea necesario. Tipo: enumeración Valores válidos: -.: `ALWAYS \| ASNEEDED` Valor predeterminado: `AsNeeded` Antecesores: `CSV`	No
`RecordDelimiter`	Un único carácter usado para separar registros individuales en la salida. En lugar del valor predeterminado, puede especificar un delimitador arbitrario. Tipo: cadena Valor predeterminado: `\n` Antecesores: `CSV`	No
`FieldDelimiter`	Un carácter único usado para separar los campos individuales de un registro. Puede especificar un delimitador arbitrario. Tipo: cadena Valor predeterminado: `,` Antecesores: `CSV`	No
`QuoteCharacter`	Un carácter único que se utiliza como escape cuando el delimitador del campo forma parte del valor. Por ejemplo, si el valor es `a, b`, Amazon S3 escribe el valor de este campo entre comillas, de la siguiente manera: `" a , b "`. Tipo: cadena Valor predeterminado: `"` Antecesores: `CSV`	No
`QuoteEscapeCharacter`	Un carácter único utilizado como escape con el carácter de comillas cuando está dentro de un valor que ya contiene caracteres de escape. Por ejemplo, si el valor es `" a , b "`, Amazon S3 escribe el valor entre comillas, de la siguiente manera: `""" a , b """`. Tipo: cadena Antecesores: `CSV`	No

El elemento de contenedor de S3 (en el elemento `OutputLocation`) contiene los siguientes elementos.
Nombre	Descripción	Obligatorio
`AccessControlList`	Lista de concesiones que controlan el acceso a los resultados por etapas. Tipo: contenedor para concesión Antecesores: `S3`	No
`BucketName`	El nombre del bucket de S3 en el que se almacenan los resultados de la restauración de selección. El bucket debe estar en la misma Región de AWS que el bucket que contiene el objeto de archivo de entrada. Tipo: cadena Antecesores: `S3`	Sí
`CannedACL`	Lista de control de acceso (ACL) predefinida que se va a aplicar a los resultados de restauración de selección. Tipo: cadena Valores válidos: `private \| public-read \| public-read-write \| aws-exec-read \| authenticated-read \| bucket-owner-read \| bucket-owner-full-control` Antecesores: `S3`	No
`Encryption`	Contiene información de cifrado de los resultados almacenados. Tipo: contenedor para cifrado Antecesores: `S3`	No
`Prefix`	El prefijo que se antepone a los resultados de restauración de selección. La longitud máxima del prefijo es de 512 bytes. Tipo: cadena Antecesores: `S3`	Sí
`StorageClass`	La clase de almacenamiento utilizado para guardar los resultados de solicitud Select. Tipo: cadena Valores válidos: `STANDARD` \| `REDUCED_REDUNDANCY` \| `STANDARD_IA` \| `ONEZONE_IA` Antecesores: `S3`	No
`Tagging`	Contenedor para información de etiquetas. Tipo: estructura de etiquetas Antecesores: `S3`	No
`UserMetadata`	Contiene una lista de metadatos para almacenar con los resultados de restauración de selección. Tipo: estructura MetadataEntry Antecesores: `S3`	No

El elemento de contenedor de beneficiario (en el elemento `AccessControlList`) contiene los siguientes elementos.
Nombre	Descripción	Obligatorio
`DisplayName`	Nombre del beneficiario que aparece en pantalla. Tipo: cadena Antecesores: `Grantee`	No
`EmailAddress`	Dirección de correo electrónico del beneficiario. Tipo: cadena Antecesores: `Grantee`	No
`ID`	ID de usuario canónico del beneficiario. Tipo: cadena Antecesores: `Grantee`	No
`Type`	Tipo de beneficiario. Tipo: cadena Antecesores: `Grantee`	No
`URI`	URI del grupo de beneficiarios. Tipo: cadena Antecesores: `Grantee`	No
`Permission`	Permiso concedido. Tipo: cadena Antecesores: `Grantee`	No

El elemento del contenedor `Encryption` (en S3) contiene los siguientes elementos.
Nombre	Descripción	Obligatorio
`EncryptionType`	El algoritmo de cifrado del servidor que se utiliza cuando se almacenan los resultados del trabajo. El valor predeterminado es sin cifrado. Tipo: cadena Valores válidos `aws:kms \| AES256` Antecesores: `Encryption`	No
`KMSContext`	Opcional. Si el tipo de cifrado es `aws:kms`, puede utilizar este valor para especificar el contexto de cifrado de los resultados de restauración de selección. Tipo: cadena Antecesores: Encryption	No
`KMSKeyId`	ID de clave de AWS Key Management Service (AWS KMS) que se va a utilizar con el cifrado de objetos. Tipo: cadena Antecesores: `Encryption`	No

El elemento de contenedor de `TagSet` (en el elemento `Tagging`) contiene el siguiente elemento.
Nombre	Descripción	Obligatorio
`Tag`	Contiene etiquetas. Tipo: Contenedor Antecesores: `TagSet`	No

El elemento de contenedor de etiqueta (en el elemento `TagSet`) contiene los siguientes elementos.
Nombre	Descripción	Obligatorio
`Key`	Nombre de la etiqueta. Tipo: cadena Antecesores: `Tag`	No
`Value`	Valor de la etiqueta. Tipo: cadena Antecesores: `Tag`	No

El elemento de contenedor de `MetadataEntry` (en el elemento `UserMetadata`) contiene los siguientes elementos de par clave-valor para almacenarlos junto con un objeto.
Nombre	Descripción	Obligatorio
`MetadataKey`	La clave de metadatos. Tipo: cadena Antecesores:	No
`MetadataEntry`	El valor de los metadatos. Tipo: cadena Antecesores:	No

Respuestas

Si la operación se realiza correctamente, se devuelve el código de estado 200 OK o 202 Accepted.

Si la copia del objeto no se ha restaurado previamente, Amazon S3 devuelve 202 Accepted en la respuesta.
Si la copia del objeto se ha restaurado previamente, Amazon S3 devuelve 200 OK en la respuesta.

Encabezados de respuesta

Esta implementación de la operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener más información, consulte Encabezados de respuesta comunes.

Elementos de respuesta

Esta operación no devuelve elementos de respuesta.

Errores especiales

Código de error	Descripción	Código de estado HTTP	Prefijo de código de error de SOAP
`RestoreAlreadyInProgress`	La restauración del objeto ya está en curso. (Este error no se aplica a las solicitudes de tipo SELECT).	Conflicto, 409	Cliente
`GlacierExpeditedRetrievalNotAvailable`	Las recuperaciones aceleradas de la clase de almacenamiento de S3 Glacier no están disponibles actualmente. Inténtelo de nuevo más tarde. (Se devuelve si no hay capacidad suficiente para procesar la solicitud `Expedited`. Este error solo se aplica a las recuperaciones `Expedited` y no a las recuperaciones `Standard` o `Bulk`).	503	N/A

Ejemplos

Restauración de un objeto durante dos días con la opción de recuperación acelerada

La siguiente solicitud de restauración restaura una copia del objeto photo1.jpg de Amazon Glacier durante un periodo de dos días mediante la opción de recuperación acelerada.


POST /photo1.jpg?restore HTTP/1.1
Host: examplebucket.s3.amazonaws.com
Date: Mon, 22 Oct 2012 01:49:52 GMT
Authorization: authorization string
Content-Length: content length

<RestoreRequest>
  <Days>2</Days>
  <GlacierJobParameters>
    <Tier>Expedited</Tier>
  </GlacierJobParameters>
</RestoreRequest>

Si examplebucket no tiene una copia restaurada del objeto, Amazon S3 devuelve la respuesta 202 Accepted siguiente.


HTTP/1.1 202 Accepted
x-amz-id-2: GFihv3y6+kE7KG11GEkQhU7/2/cHR3Yb2fCb2S04nxI423Dqwg2XiQ0B/UZlzYQvPiBlZNRcovw=
x-amz-request-id: 9F341CD3C4BA79E0
Date: Sat, 20 Oct 2012 23:54:05 GMT
Content-Length: 0
Server: AmazonS3

Si ya se ha restaurado una copia del objeto, Amazon S3 devuelve una respuesta 200 OK y actualiza solo el tiempo de caducidad de la copia restaurada.

Consulta de un archivo con una solicitud SELECT

A continuación, se muestra un ejemplo solicitud de restauración de selección.


POST /object-one.csv?restore HTTP/1.1
Host: examplebucket.s3.amazonaws.com
Date: Date: Sat, 20 Oct 2012 23:54:05 GMT
Authorization: authorization string
Content-Length: content length

<RestoreRequest xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Type>SELECT</Type>
  <Tier>Expedited</Tier>
  <Description>this is a description</Description>
  <SelectParameters>
    <InputSerialization>
      <CSV>
        <FileHeaderInfo>IGNORE</FileHeaderInfo>
        <Comments>#</Comments>
        <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
        <RecordDelimiter>\n</RecordDelimiter>
        <FieldDelimiter>,</FieldDelimiter>
        <QuoteCharacter>"</QuoteCharacter>
      </CSV>
    </InputSerialization>
    <ExpressionType>SQL</ExpressionType>
    <Expression>select * from object</Expression>
    <OutputSerialization>
      <CSV>
        <QuoteFields>ALWAYS</QuoteFields>
        <QuoteEscapeCharacter>"</QuoteEscapeCharacter>
        <RecordDelimiter>\n</RecordDelimiter>
        <FieldDelimiter>\t</FieldDelimiter>
        <QuoteCharacter>\'</QuoteCharacter>
      </CSV>
    </OutputSerialization>
  </SelectParameters>
  <OutputLocation>
    <S3>
      <BucketName>example-output-bucket</BucketName>
      <Prefix>test-s3</Prefix>
      <AccessControlList>
        <Grant>
          <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="AmazonCustomerByEmail">
            <EmailAddress>jane-doe@example.com</EmailAddress>
          </Grantee>
          <Permission>FULL_CONTROL</Permission>
        </Grant>
      </AccessControlList>
      <UserMetadata>
        <MetadataEntry>
          <Name>test</Name>
          <Value>test-value</Value>
        </MetadataEntry>
        <MetadataEntry>
          <Name>other</Name>
          <Value>something else</Value>
        </MetadataEntry>
      </UserMetadata>
      <StorageClass>STANDARD</StorageClass>
    </S3>
  </OutputLocation>
</RestoreRequest>

Amazon S3 devuelve la respuesta 202 Accepted siguiente.


HTTP/1.1 202 Accepted
x-amz-id-2: GFihv3y6+kE7KG11GEkQhU7/2/cHR3Yb2fCb2S04nxI423Dqwg2XiQ0B/UZlzYQvPiBlZNRcovw=
x-amz-request-id: 9F341CD3C4BA79E0
x-amz-restore-output-path: js-test-s3/qE8nk5M0XIj-LuZE2HXNw6empQm3znLkHlMWInRYPS-Orl2W0uj6LyYm-neTvm1-btz3wbBxfMhPykd3jkl-lvZE7w42/
Date: Sat, 20 Oct 2012 23:54:05 GMT
Content-Length: 0
Server: AmazonS3

GetBucketLifecycleConfiguration
PutBucketLifecycleConfiguration
Referencia de SQL para Amazon S3 Select y Amazon Glacier Select en la Guía del usuario de Amazon Simple Storage Service

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Control de versiones

Creación de formularios HTML