Descrição Consulta em arquivos com solicitações de seleção Restauração de arquivos Solicitações Respostas Exemplos Mais informações

POST restauração de objeto

Descrição

Essa operação executa os seguintes tipos de solicitações:

select: executa uma consulta de seleção em um objeto arquivado
restore an archive: restaura um objeto arquivado

Para usar essa operação, você deve ter permissões para executar as ações s3:RestoreObject e s3:GetObject. O proprietário do bucket tem essa permissão por padrão e pode conceder essa permissão a outras pessoas. Para obter mais informações sobre as permissões, consulte Permissões relacionadas a operações de subrecursos de bucket e Gerenciamento de permissões de acesso aos recursos do Amazon S3 no Guia do usuário do Amazon Simple Storage Service.

Consulta em arquivos com solicitações de seleção

Use um tipo de solicitação de seleção para executar consultas SQL em objetos arquivados. Os objetos arquivados que estão sendo consultados pela solicitação de seleção devem ser formatados como arquivos de valores separados por vírgulas (CSV) descompactados. É possível executar consultas e análises personalizadas dos dados arquivados sem precisar restaurá-los para um nível mais avançado do Amazon S3. Para uma visão geral sobre solicitações de seleção, confira Consulta de objetos arquivados no Guia do usuário do Amazon Simple Storage Service.

Ao fazer uma solicitação de seleção:

Defina um local para a saída da consulta de seleção. Deve ser um bucket do Amazon S3 na mesma Região da AWS que o bucket que contém o objeto de arquivo que está sendo consultado. A Conta da AWS que inicia o trabalho deve ter permissões para gravação no bucket do S3. Você pode especificar a classe de armazenamento e a criptografia dos objetos de saída armazenados no bucket. Para obter mais informações sobre saída, confira Consulta de objetos arquivados no Guia do usuário do Amazon Simple Storage Service.

Para obter mais informações sobre a estrutura S3 no corpo da solicitação, consulte:
- PutObject
- Gerenciamento de acesso com ACLs no Guia do usuário do Amazon Simple Storage Service
- Proteção de dados usando criptografia do lado do servidor no Guia do usuário do Amazon Simple Storage Service
Defina a expressão SQL para o tipo de restauração SELECT da sua consulta na estrutura SelectParameters do corpo da solicitação. É possível usar expressões como os exemplos a seguir.
- A expressão a seguir retorna todos os registros do objeto especificado.
```
SELECT * FROM Object
```
- Supondo que você não está usando nenhum cabeçalho para dados armazenados no objeto, é possível especificar colunas com cabeçalhos posicionais.
```
SELECT s._1, s._2 FROM Object s WHERE s._3 > 100
```
- Se houver cabeçalhos e você definir fileHeaderInfo na estrutura CSV no corpo da solicitação para USE, especifique cabeçalhos na consulta. (Se você definir o campo fileHeaderInfo para IGNORE, a primeira linha será ignorado na consulta.) Você não pode combinar posições ordinais com nomes de coluna de cabeçalho.
```
SELECT s.Id, s.FirstName, s.SSN FROM S3Object s
```

Para obter mais informações sobre o uso do SQL com a restauração do Amazon Glacier Select, consulte Referência de SQL para o Amazon S3 Select e o Amazon Glacier Select no Guia do usuário do Amazon Simple Storage Service.

Ao fazer uma solicitação de seleção, você também pode fazer o seguinte:

Para agilizar as consultas, especifique o nível Expedited. Para obter mais informações sobre níveis, consulte "Restauração de arquivos", mais adiante neste tópico.
Especifique detalhes sobre o formato de serialização de dados do objeto de entrada que está sendo consultado e da serialização dos resultados de consulta codificados por CSV.

Confira a seguir outros fatos importantes sobre o recurso de seleção:

Os resultados de saída são novos objetos do Amazon S3. Diferente das recuperações de arquivo, eles são armazenados até serem excluídos de modo explícito, seja manualmente ou por meio de uma política de ciclo de vida.
Você pode emitir mais de uma solicitação de seleção no mesmo objeto do Amazon S3. O Amazon S3 não desduplica solicitações; portanto, evite emitir solicitações duplicadas.
O Amazon S3 aceita uma solicitação de seleção mesmo que o objeto já tenha sido restaurado. Uma solicitação de seleção não retorna uma resposta de erro 409.

Restauração de arquivos

Objetos nas classes de armazenamento GLACIER e DEEP_ARCHIVE são arquivados. Para acessar um objeto arquivado, você deve iniciar uma solicitação de restauração primeiro. Isso restaura uma cópia temporária do objeto arquivado. Na solicitação de restauração, especifique o número de dias que você deseja que a cópia restaurada exista. Após o período especificado, o Amazon S3 exclui a cópia temporária, mas o objeto permanece arquivado na classe de armazenamento GLACIER ou DEEP_ARCHIVE da qual o objeto foi restaurado.

Para restaurar uma versão específica do objeto, você pode fornecer um ID de versão. Se você não fornecer um ID de versão, o Amazon S3 restaurará a versão atual.

O tempo necessário para concluir as tarefas de restauração depende da classe de armazenamento da qual o objeto está sendo restaurado e do nível de acesso aos dados que você especificar.

Ao restaurar um objeto arquivado (ou usar uma solicitação de seleção), você pode especificar uma das seguintes opções de nível de acesso aos dados no elemento Tier do corpo da solicitação:

Expedited - as recuperações expressas permitem acessar rapidamente os dados armazenados na classe de armazenamento GLACIER quando forem necessárias solicitações urgentes ocasionais para um subconjunto de arquivos. Salvo para os maiores objetos arquivados (250 MB+), os dados acessados usando recuperações expressas ficam normalmente disponíveis dentro de 1 a 5 minutos. A capacidade provisionada garante que sua capacidade de recuperação para recuperações expressas esteja disponível quando você precisar dela. As recuperações expressas e a capacidade provisionada não estão disponíveis para a classe de armazenamento DEEP_ARCHIVE.
Standard - As recuperações padrão permitem que você acesse alguns de seus objetos arquivados em algumas horas. Esta é a opção padrão para solicitações de recuperação do GLACIER e DEEP_ARCHIVE que não especificam a opção de recuperação. As recuperações padrão geralmente são concluídas em 3 a 5 horas a partir da classe de armazenamento GLACIER e em 12 horas a partir da classe de armazenamento DEEP_ARCHIVE.
Bulk: as recuperações em massa são a opção de recuperação de menor custo do Amazon Glacier, permitindo recuperar grandes quantidades de dados, até mesmo petabytes, com um custo baixo em um dia. As recuperações em massa geralmente são concluídas em 5 a 12 horas a partir da classe de armazenamento GLACIER e em 48 horas a partir da classe de armazenamento DEEP_ARCHIVE.

Para obter mais informações sobre opções de recuperação de arquivo e capacidade provisionada para acesso aos dados Expedited, consulte Restauração de objetos arquivados no Guia do desenvolvedor do Amazon Simple Storage Service.

Você pode usar a atualização rápida de restauração do Amazon S3 para alterar a velocidade de restauração para uma mais rápida enquanto o processo estiver em andamento. Atualize a velocidade de uma restauração em andamento emitindo outra solicitação de restauração para o mesmo objeto, definindo um novo elemento de solicitação Tier. Ao emitir uma solicitação para atualizar o nível de restauração, você deve escolher um nível mais rápido do que o nível de restauração do andamento. Você não deve alterar outros parâmetros, como o elemento de solicitação Days. Para obter mais informações, consulte Atualização da velocidade de uma restauração em andamento no Guia do usuário do Amazon Simple Storage Service.

Para obter o status da restauração do objeto, você pode enviar uma solicitação HEAD. As operações retornam o cabeçalho x-amz-restore, que fornece informações sobre o status da restauração, na resposta. Você pode usar as notificações de eventos do Amazon S3 para receber notificações quando uma restauração for iniciada ou concluída. Para obter mais informações, consulte Configuração de notificações de eventos do Amazon S3 no Guia do usuário do Amazon Simple Storage Service.

Depois de restaurar um objeto arquivado, você pode atualizar o período de restauração reemitindo a solicitação com um novo período. O Amazon S3 atualiza o período de restauração em relação à hora atual e cobra somente pela solicitação. Não há cobrança de transferência de dados. Você não pode atualizar o período de restauração quando o Amazon S3 está processando ativamente sua solicitação de restauração atual para o objeto.

Se o bucket tiver uma configuração de ciclo de vida com uma regra que inclui uma ação de expiração, a expiração do objeto substituirá a vida útil especificada em uma solicitação de restauração. Por exemplo, se você restaurar uma cópia do objeto por 10 dias, mas o objeto estiver programado para expirar em 3 dias, o Amazon S3 excluirá o objeto em 3 dias. Para obter mais informações sobre a configuração do ciclo de vida, consulte PutBucketLifecycleConfiguration e Gerenciamento do ciclo de vida do objeto no Guia do usuário do Amazon Simple Storage Service.

Solicitações

Sintaxe


POST /ObjectName?restore&versionId=VersionID HTTP/1.1
Host: BucketName.s3.amazonaws.com
Date: date
Authorization: authorization string (see Autenticação de solicitações (AWS Signature Version 4))
Content-MD5: MD5

 request body

nota

A sintaxe mostra alguns cabeçalhos da solicitação. Para obter uma lista completa, consulte “Cabeçalhos de solicitação”, mais adiante neste tópico.

Parâmetros da solicitação

Essa implementação da operação não usa parâmetros de solicitação.

Cabeçalhos de solicitação

Name (Nome) Descrição Obrigatório

Name (Nome)	Descrição	Obrigatório
`Content-MD5`	O resumo MD5 de 128 bits com codificação base64 dos dados. Você deve usar esse cabeçalho como uma verificação de integridade da mensagem para verificar se o corpo da solicitação não foi corrompido em trânsito. Para obter mais informações, consulte a RFC 1864. Tipo: string Padrão: nenhum	Sim

Content-MD5

O resumo MD5 de 128 bits com codificação base64 dos dados. Você deve usar esse cabeçalho como uma verificação de integridade da mensagem para verificar se o corpo da solicitação não foi corrompido em trânsito. Para obter mais informações, consulte a RFC 1864.

Tipo: string

Padrão: nenhum

Sim

Elementos da solicitação

Veja a seguir um exemplo em XML de um corpo de solicitação para restaurar um arquivo.


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

A tabela a seguir explica o XML para restauração de arquivo no corpo da solicitação.

Name (Nome)	Descrição	Obrigatório
`RestoreRequest`	Contêiner para informações de restauração. Tipo: Container	Sim
`Days`	Vida útil da cópia restaurada (ativa). O número mínimo de dias em que você pode restaurar um objeto do Amazon Glacier é 1. Depois que a cópia do objeto atinge a vida útil especificada, o Amazon S3 a remove do bucket. Se você estiver restaurando um arquivo, esse elemento será necessário. Não use esse elemento com um tipo de solicitação `SELECT`. Tipo: número inteiro positivo Antepassados: `RestoreRequest`	Sim, se estiver restaurando um arquivo
`GlacierJobParameters`	Contêiner para parâmetros de trabalho da classe de armazenamento do S3 Glacier. Não use esse elemento com um tipo de solicitação `SELECT`. Tipo: Container Antepassados: `RestoreRequest`	Não
`Tier`	O nível de acesso aos dados a ser usado ao restaurar o arquivo. `Standard` é o padrão. Tipo: Enum Valores válidos: `Expedited` \| `Standard` \| `Bulk` Antepassados: `GlacierJobParameters`	Não

O XML a seguir é o corpo da solicitação para uma consulta de seleção em um objeto arquivado:


<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>

As tabelas a seguir explicam o XML para um tipo de restauração SELECT no corpo da solicitação.

Name (Nome)	Descrição	Obrigatório
`RestoreRequest`	Contêiner para informações de restauração. Tipo: Container	Sim
`Tier`	O nível de acesso aos dados a ser usado ao restaurar o arquivo. `Standard` é o padrão. Tipo: Enum Valores válidos: `Expedited` \| `Standard` \| `Bulk` Antepassados: `RestoreRequest`	Não
`Description`	A descrição opcional da solicitação. Tipo: string Antepassados: `RestoreRequest`	Não
`SelectParameters`	Descreve os parâmetros da solicitação de trabalho de seleção. Tipo: Container Antepassados: `RestoreRequest`	Sim, se o tipo de solicitação for `SELECT`
`OutputLocation`	Descreve o local que recebe os resultados da solicitação de restauração de seleção. Tipo: contêiner para Amazon S3 Antepassados: `RestoreRequest`	Sim, se o tipo de solicitação for `SELECT`

O elemento de contêiner `SelectParameters` possui os seguintes elementos.
Name (Nome)	Descrição	Obrigatório
`Expression`	A expressão SQL. Por exemplo: A expressão SQL a seguir recupera a primeira coluna dos dados do objeto armazenado no formato CSV: `SELECT s._1 FROM Object s` A expressão SQL a seguir retorna tudo do objeto: `SELECT * FROM Object` Tipo: string Antepassados: `SelectParameters`	Sim
`ExpressionType`	Identifica o tipo de expressão. Tipo: string Valores válidos: `SQL` Antepassados: `SelectParameters`	Sim
`InputSerialization`	Descreve o formato de serialização do objeto. Tipo: contêiner para CSV Antepassados: `SelectParameters`	Sim
`OutputSerialization`	Descreve como os resultados do trabalho de seleção são serializados. Tipo: contêiner para CSV Antepassados: `SelectParameters`	Sim

O elemento de contêiner CSV no elemento `InputSerialization` contém os seguintes elementos.
Name (Nome)	Descrição	Obrigatório
`RecordDelimiter`	Um único caractere usado para separar registros individuais na entrada. Em vez do valor padrão, você pode especificar um delimitador arbitrário. Tipo: string Padrão: `\n` Antepassados: `CSV`	Não
`FieldDelimiter`	Um único caractere usado para separar campos individuais em um registro. Você pode especificar um delimitador arbitrário. Tipo: string Padrão: `,` Antepassados: `CSV`	Não
`QuoteCharacter`	Um único caractere usado como escape quando o delimitador de campo faz parte do valor. Considere este exemplo em um arquivo CSV: `"a, b"` Colocar os valores entre aspas faz com que esse valor seja um campo único. Se você não usar as aspas, a vírgula será um delimitador de campo (o que a torna dois valores de campo separados, a e b). Tipo: string Padrão: `"` Antepassados: `CSV`	Não
`QuoteEscapeCharacter`	Um único caractere usado para fazer o escape do caractere de aspas em um valor que já recebeu escape. Por exemplo, o valor `""" a , b """` é analisado como `" a , b "`. Tipo: string Padrão: `"` Antepassados: `CSV`	Não
`FileHeaderInfo`	Descreve a primeira linha nos dados de entrada. É um dos valores de ENUM. `NONE`: a primeira linha não é um cabeçalho. `IGNORE`: a primeira linha é um cabeçalho, mas você não pode usar os valores do cabeçalho para indicar a coluna em uma expressão. Você pode usar a posição da coluna (como _1, _2 etc.) para indicar a coluna (`SELECT s._1 FROM OBJECT s`). `Use`: a primeira linha é um cabeçalho e você pode usar o valor do cabeçalho para identificar uma coluna em uma expressão (`SELECT "name" FROM OBJECT`). Tipo: Enum Valores válidos: `NONE \| USE \| IGNORE` Antepassados: `CSV`	Não
`Comments`	Um único caractere usado para indicar que uma linha deve ser ignorada quando o caractere está presente no início da linha. Você pode especificar qualquer caractere para indicar uma linha de comentário. Tipo: string Antepassados: `CSV`	Não

O elemento de contêiner CSV (nos elementos `OutputSerialization`) contém os seguintes elementos.
Name (Nome)	Descrição	Obrigatório
`QuoteFields`	Indica se devem ser usadas aspas nos campos de saída. `ALWAYS`: sempre use aspas nos campos de saída. `ASNEEDED`: use aspas nos campos de saída quando necessário. Tipo: Enum Valores válidos: `ALWAYS \| ASNEEDED` Padrão: `AsNeeded` Antepassados: `CSV`	Não
`RecordDelimiter`	Um único caractere usado para separar registros individuais na saída. Em vez do valor padrão, você pode especificar um delimitador arbitrário. Tipo: string Padrão: `\n` Antepassados: `CSV`	Não
`FieldDelimiter`	Um único caractere usado para separar campos individuais em um registro. Você pode especificar um delimitador arbitrário. Tipo: string Padrão: `,` Antepassados: `CSV`	Não
`QuoteCharacter`	Um único caractere usado como escape quando o delimitador de campo faz parte do valor. Por exemplo, se o valor for `a, b`, o Amazon S3 colocará esse valor de campo entre aspas, do seguinte modo: `" a , b "`. Tipo: string Padrão: `"` Antepassados: `CSV`	Não
`QuoteEscapeCharacter`	Um único caractere usado para fazer o escape do caractere de aspas em um valor que já recebeu escape. Por exemplo, se o valor for `" a , b "`, o Amazon S3 colocará o valor entre aspas, do seguinte modo: `""" a , b """`. Tipo: string Antepassados: `CSV`	Não

O elemento de contêiner do S3 (no elemento `OutputLocation`) contém os seguintes elementos.
Name (Nome)	Descrição	Obrigatório
`AccessControlList`	Uma lista de concessões que controlam o acesso aos resultados intermediários. Tipo: contêiner para concessão Antepassados: `S3`	Não
`BucketName`	O nome do bucket do S3 no qual os resultados da restauração de seleção são armazenados. O bucket deve estar na mesma Região da AWS do bucket que contém o objeto de arquivo de entrada. Tipo: string Antepassados: `S3`	Sim
`CannedACL`	A lista de controle de acesso (ACL) pré-configurada a ser aplicada aos resultados da restauração de seleção. Tipo: string Valores válidos: `private \| public-read \| public-read-write \| aws-exec-read \| authenticated-read \| bucket-owner-read \| bucket-owner-full-control` Antepassados: `S3`	Não
`Encryption`	Contém informações de criptografia dos resultados armazenados. Tipo: contêiner para criptografia Antepassados: `S3`	Não
`Prefix`	O prefixo que precede os resultados da restauração de seleção. O tamanho máximo do prefixo é 512 bytes. Tipo: string Antepassados: `S3`	Sim
`StorageClass`	A classe de armazenamento usada para armazenar os resultados da restauração de seleção. Tipo: string Valores válidos: `STANDARD` \| `REDUCED_REDUNDANCY` \| `STANDARD_IA` \| `ONEZONE_IA` Antepassados: `S3`	Não
`Tagging`	Contêiner para informações de tags. Tipo: estrutura Tag Antepassados: `S3`	Não
`UserMetadata`	Contém uma lista de metadados a ser armazenada com os resultados da restauração de seleção. Tipo: estrutura MetadataEntry Antepassados: `S3`	Não

O elemento do contêiner Grantee (no elemento `AccessControlList`) contém os seguintes elementos.
Name (Nome)	Descrição	Obrigatório
`DisplayName`	O nome da tela do favorecido. Tipo: string Antepassados: `Grantee`	Não
`EmailAddress`	O endereço de e-mail do favorecido. Tipo: string Antepassados: `Grantee`	Não
`ID`	O ID de usuário canônico do favorecido. Tipo: string Antepassados: `Grantee`	Não
`Type`	O tipo do favorecido. Tipo: string Antepassados: `Grantee`	Não
`URI`	O URI do grupo do favorecido. Tipo: string Antepassados: `Grantee`	Não
`Permission`	Permissão concedida. Tipo: string Antepassados: `Grantee`	Não

O elemento de contêiner `Encryption` (no S3) contém os seguintes elementos.
Name (Nome)	Descrição	Obrigatório
`EncryptionType`	O algoritmo de criptografia no lado do servidor usado para armazenar os resultados do trabalho. O padrão é sem criptografia. Tipo: string Valores válidos `aws:kms \| AES256` Antepassados: `Encryption`	Não
`KMSContext`	Opcional. Se o tipo de criptografia for `aws:kms`, você poderá usar esse valor para especificar o contexto da criptografia nos resultados da restauração de seleção. Tipo: string Antepassados: criptografia	Não
`KMSKeyId`	O ID da chave do AWS Key Management Service (AWS KMS) a ser usado na criptografia do objeto. Tipo: string Antepassados: `Encryption`	Não

O elemento de contêiner `TagSet` (no elemento `Tagging`) contém o seguinte elemento.
Name (Nome)	Descrição	Obrigatório
`Tag`	Contém tags. Tipo: Container Antepassados: `TagSet`	Não

O elemento de contêiner Tag (no elemento `TagSet`) contém os seguintes elementos.
Name (Nome)	Descrição	Obrigatório
`Key`	Nome da tag. Tipo: string Antepassados: `Tag`	Não
`Value`	Valor da tag. Tipo: string Antepassados: `Tag`	Não

O elemento de contêiner `MetadataEntry` (no elemento `UserMetadata`) contém os seguintes elementos de par de chave-valor a serem armazenados com um objeto.
Name (Nome)	Descrição	Obrigatório
`MetadataKey`	A chave de metadados. Tipo: string Antepassados:	Não
`MetadataEntry`	O valor dos metadados. Tipo: string Antepassados:	Não

Respostas

Uma operação bem-sucedida retorna o código de status 200 OK ou 202 Accepted.

Se a cópia do objeto não tiver sido restaurada anteriormente, o Amazon S3 retornará 202 Accepted na resposta.
Se a cópia do objeto tiver sido restaurada anteriormente, o Amazon S3 retornará 200 OK na resposta.

Cabeçalhos de resposta

Essa implementação da operação usa somente os cabeçalhos de resposta que são comuns à maioria das respostas. Para obter mais informações, consulte Cabeçalhos de resposta comuns.

Elementos de resposta

Essa operação não retorna elementos de resposta.

Erros especiais

Código de erro	Descrição	Código de status HTTP	Prefixo do código de falha SOAP
`RestoreAlreadyInProgress`	A restauração do objeto já está em andamento. (Esse erro não se aplica às solicitações do tipo SELECT.)	409 Conflito	Cliente
`GlacierExpeditedRetrievalNotAvailable`	As recuperações rápidas da classe de armazenamento do S3 Glacier não estão disponíveis no momento. Tente novamente mais tarde. (Retornado se não houver capacidade suficiente para processar a solicitação `Expedited`. Esse erro se aplica somente às recuperações `Expedited` e não às recuperações `Standard` ou `Bulk`.)	503	N/D

Exemplos

Restaurar um objeto por dois dias usando a opção de recuperação rápida

A solicitação de restauração a seguir restaura uma cópia do objeto photo1.jpg do Amazon Glacier por um período de dois dias usando a opção de recuperação rápida.


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>

Se o examplebucket não tiver uma cópia restaurada do objeto, o Amazon S3 retornará a seguinte resposta 202 Accepted.


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

Se uma cópia do objeto já tiver sido restaurada, o Amazon S3 retornará uma resposta 200 OK e atualizará somente o tempo de expiração da cópia restaurada.

Consultar um arquivo com uma solicitação SELECT

Este é um exemplo de resposta de restauração de seleção.


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>

O Amazon S3 retorna a seguinte resposta 202 Accepted.


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
Referência de SQL para Seleção do Amazon S3 e Seleção do S3 Glacier no Guia do desenvolvedor do Amazon Simple Storage Service

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Versionamento

Criação de formulários HTML