**Esta página destina-se somente a clientes atuais do serviço Amazon Glacier que usam cofres e a API REST original de 2012.** Se você estiver procurando soluções de armazenamento de arquivos do Amazon Glacier, recomendamos usar as classes de armazenamento do Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para saber mais sobre essas opções de armazenamento, consulte [Classes de armazenamento do Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/). O Amazon Glacier (serviço autônomo original baseado em cofre) não está mais aceitando novos clientes. O Amazon Glacier é um serviço independente APIs que armazena dados em cofres e é diferente das classes de armazenamento Amazon S3 e Amazon S3 Glacier. Seus dados existentes permanecerão seguros e acessíveis no Amazon Glacier indefinidamente. Nenhuma migração é necessária. Para armazenamento de arquivamento de baixo custo e longo prazo, AWS recomenda as classes de armazenamento [Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), que oferecem uma experiência superior ao cliente com APIs base em buckets S3, disponibilidade Região da AWS total, custos mais baixos e integração de serviços. AWS Se você quiser recursos aprimorados, considere migrar para as classes de armazenamento do Amazon S3 Glacier usando nossas [Orientações de soluções da AWS para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/). As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Tipos de dados usados em operações de trabalho Estes são os tipos de dados usados com as operações de trabalho no Amazon Glacier. **Topics** + [CSVInput](api-CSVInput.md) + [CSVOutput](api-CSVOutput.md) + [Criptografia](api-Encryption.md) + [GlacierJobDescription](api-GlacierJobDescription.md) + [Concessão](api-Grant.md) + [Grantee](api-Grantee.md) + [InputSerialization](api-InputSerialization.md) + [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) + [jobParameters](api-jobParameters.md) + [OutputLocation](api-OutputLocation.md) + [OutputSerialization](api-OutputSerialization.md) + [S3Location](api-S3Location.md) + [SelectParameters](api-SelectParameters.md) # CSVInput Contém informações sobre o arquivo de valores separados por vírgulas (CSV). ## Conteúdo **Comentários** Um único caractere usado para indicar que uma linha deve ser ignorada quando o caractere está presente no início da linha. *Tipo:* string *Obrigatório*: não **FieldDelimiter** Um único caractere usado para separar campos individuais em um registro. O caractere deve ser um `\n`, `\r` ou um caractere ASCII no intervalo 32–126. O padrão é uma vírgula (`,`). *Tipo:* string *Padrão*: , *Obrigatório*: não **FileHeaderInfo** Um valor que descreve o que fazer com a primeira linha da entrada. *Tipo:* string *Valores válidos*: `Use` \$1 `Ignore` \$1 `None` *Obrigatório*: não **QuoteCharacter** Um único caractere usado como um caractere de escape em que o delimitador de campo é parte do valor. *Tipo:* string *Obrigatório*: não **QuoteEscapeCharacter** Um único caractere usado para fazer o escape do caractere de aspas em um valor que já recebeu escape. *Tipo:* string *Obrigatório*: não **RecordDelimiter** Um único caractere usado para separar registros individuais. *Tipo:* string *Obrigatório*: não ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) # CSVOutput Contém informações sobre o formato de valores separados por vírgulas (CSV) em que os resultados do trabalho são armazenados. ## Conteúdo **FieldDelimiter** Um único caractere usado para separar campos individuais em um registro. *Tipo:* string *Obrigatório*: não **QuoteCharacter** Um único caractere usado como um caractere de escape em que o delimitador de campo é parte do valor. *Tipo:* string *Obrigatório*: não **QuoteEscapeCharacter** Um único caractere usado para fazer o escape do caractere de aspas em um valor que já recebeu escape. *Tipo:* string *Obrigatório*: não **QuoteFields** Um valor que indica se todos os campos de saída devem ser colocados entre aspas. *Valores válidos*: `ALWAYS` \$1 `ASNEEDED` *Tipo:* string *Obrigatório*: não **RecordDelimiter** Um único caractere usado para separar registros individuais. *Tipo:* string *Obrigatório*: não ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) # Criptografia Contém informações sobre a criptografia usada para armazenar os resultados do trabalho no Amazon S3. ## Conteúdo **Criptografia** O algoritmo de criptografia no lado do servidor usado para armazenar os resultados do trabalho no Amazon S3. O padrão é sem criptografia. *Tipo:* string *Valores válidos*: `aws:kms` \$1 `AES256` *Obrigatório*: 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 do trabalho. *Tipo:* string *Obrigatório*: não **KMSKeyId** O ID da chave do AWS Key Management Service (AWS KMS) a ser usado na criptografia do objeto. *Tipo:* string *Obrigatório*: não ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) # GlacierJobDescription Contém a descrição de um trabalho do Amazon Glacier. ## Conteúdo **Ação** O tipo de trabalho. É `ArchiveRetrieval`, `InventoryRetrieval` ou `Select`. *Tipo:* string **ArchiveId** O ID de arquivo solicitado para um trabalho de seleção ou de recuperação de arquivo. Do contrário, esse campo será `null`. *Tipo:* string **ArchiveSHA256TreeHash** O hash de árvore SHA256 de todo o arquivo de uma recuperação do arquivo. Para trabalhos de recuperação do inventário, esse campo é `null`. *Tipo:* string **ArchiveSizeInBytes** Para um trabalho `ArchiveRetrieval`, trata-se do tamanho em bytes do arquivo solicitado para download. Para o trabalho `InventoryRetrieval`, o valor é `null`. *Tipo*: número **Concluído** `true` se o trabalho for concluído;, do contrário `false`. *Tipo*: booliano **CompletionDate** A data em que o trabalho foi concluído. A hora UTC (Horário Coordenado Universal) em que a solicitação de trabalho foi concluída. Enquanto o trabalho estiver em andamento, o valor será nulo. *Tipo*: uma representação de string no formato de data ISO 8601, por exemplo `2013-03-20T17:03:43.221Z`. **CreationDate** A data UTC quando o trabalho foi iniciado. *Tipo*: uma representação de string no formato de data ISO 8601, por exemplo `2013-03-20T17:03:43.221Z`. **InventoryRetrievalParameters** Os parâmetros de entrada usados em uma recuperação de inventário de intervalo. *Tipo*: [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) objeto **InventorySizeInBytes** Para um trabalho `InventoryRetrieval`, trata-se do tamanho em bytes do inventário solicitado para download. No trabalho `ArchiveRetrieval` ou `Select`, o valor é `null`. *Tipo*: número **JobDescription** A descrição do trabalho que você forneceu quando iniciou o trabalho. *Tipo:* string **JobId** O ID que identifica o trabalho no Amazon Glacier. *Tipo:* string **JobOutputPath** Contém o local de saída do trabalho. *Tipo:* string **OutputLocation** Um objeto com informações sobre o local onde os resultados e os erros do trabalho de seleção são armazenados. *Tipo*: [OutputLocation](api-OutputLocation.md) objeto **RetrievalByteRange** O intervalo de bytes recuperado para trabalhos de recuperação de arquivo no formato "*StartByteValue*-*EndByteValue*". Se nenhum intervalo for especificado na recuperação do arquivo, então, todo o arquivo será recuperado e *StartByteValue* será igual a 0 e *EndByteValue* será igual ao tamanho do arquivo menos 1. Para trabalhos de recuperação do inventário, esse campo é `null`. *Tipo:* string **SelectParameters** Um objeto com informações sobre os parâmetros usados em uma seleção. *Tipo*: [SelectParameters](api-SelectParameters.md) objeto **SHA256TreeHash** O valor do hash de árvore SHA256 para o intervalo solicitado de um arquivo. Se a solicitação [Initiate Job (trabalhos POST)](api-initiate-job-post.md) para um arquivo tiver especificado um intervalo alinhado ao hash de árvore, esse campo retornará um valor. Para obter mais informações sobre o alinhamento ao hash de árvore para recuperações do intervalo de arquivos, consulte [Receber somas de verificação durante o download de dados](checksum-calculations-range.md). Quando todo o arquivo for recuperado, esse valor será igual ao valor de `ArchiveSHA256TreeHash`. Esse campo é `null` nas seguintes situações: + Os trabalhos de recuperação de arquivo que especificam um intervalo não alinhado ao hash de árvore. + Trabalhos de arquivamento que especificam um intervalo igual a todo o arquivamento e cujo status do trabalho seja `InProgress`. + Trabalhos de inventário. + Trabalhos de seleção. *Tipo:* string **SNSTopic** O nome do recurso da Amazon (ARN) que representa um tópico do Amazon SNS em que a notificação da conclusão ou da falha do trabalho é enviada, se a notificação tiver sido configurada na iniciação do trabalho ([Initiate Job (trabalhos POST)](api-initiate-job-post.md)). *Tipo:* string **StatusCode** O código que indica o status do trabalho. *Valores válidos*: `InProgress` \$1 `Succeeded` \$1 `Failed` *Tipo:* string **StatusMessage** A mensagem de status do trabalho. *Tipo:* string **Tier** O nível de acesso a dados a ser usado na seleção ou na recuperação de arquivo. *Valores válidos*: `Expedited` \$1 `Standard` \$1 `Bulk` *Tipo:* string **VaultARN** O ARN do cofre do qual o trabalho é um sub-recurso. *Tipo:* string ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) # Concessão Contém informações sobre uma concessão. ## Conteúdo **Grantee** O favorecido. *Tipo*: [Grantee](api-Grantee.md) objeto *Obrigatório*: não **Permissão** A permissão concedida ao favorecido. *Tipo:* string *Valores válidos*: `FULL_CONTROL` \$1 `WRITE` \$1 `WRITE_ACP` \$1 `READ` \$1 `READ_ACP` *Obrigatório*: não ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) # Grantee Contém informações sobre um favorecido. ## Conteúdo **DisplayName** O nome da tela do favorecido. *Tipo:* string *Obrigatório*: não **EmailAddress** O endereço de e-mail do favorecido. *Tipo:* string *Obrigatório*: não **ID** O ID de usuário canônico do favorecido. *Tipo:* string *Obrigatório*: não **Tipo** O tipo do favorecido. *Tipo:* string *Valores válidos*: `AmazonCustomerByEmail` \$1 `CanonicalUser` \$1 `Group` *Obrigatório*: não **URI** O URI do grupo do favorecido. *Tipo:* string *Obrigatório*: não ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) # InputSerialization Descreve como o arquivo será serializado. ## Conteúdo **CSV** Um objeto que descreve a serialização de um objeto codificado por CSV. *Tipo*: [CSVInput](api-CSVInput.md) objeto *Obrigatório*: não ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) # InventoryRetrievalJobInput Fornece opções para especificar um trabalho de recuperação de inventário de intervalo. ## Conteúdo **EndDate** O final do intervalo de datas, em UTC, para uma recuperação de inventário de cofre que inclua os arquivos criados antes dessa data. *Valores válidos*: uma representação de string no formato de data ISO 8601 (`YYYY-MM-DDThh:mm:ssTZD`) em segundos, por exemplo `2013-03-20T17:03:43Z`. *Tipo*: string Uma representação de string no formato de data ISO 8601 (`YYYY-MM-DDThh:mm:ssTZD`) em segundos, por exemplo `2013-03-20T17:03:43Z`. *Obrigatório*: não **Formato** O formato de saída da lista de inventários de cofre, definido pela solicitação [Initiate Job (trabalhos POST)](api-initiate-job-post.md) durante a inicialização de um trabalho para recuperação de um inventário de cofre. *Valores válidos*: `CSV` \$1 `JSON` *Obrigatório*: não *Tipo:* string **Limite** O número máximo de itens de inventário que podem ser retornados para cada solicitação de recuperação de inventário de cofre. *Valores válidos*: um valor inteiro maior ou igual a 1. *Tipo:* string *Obrigatório*: não **Marker** Uma string invisível que representa onde continuar a paginação dos resultados da recuperação de inventário do cofre. Você usa esse marcador em uma nova solicitação `Initiate Job` para obter itens de inventário adicionais. Se não houver itens de inventário, esse valor será nulo. *Tipo:* string *Obrigatório*: não **StartDate** O início do intervalo de datas, em UTC, para uma recuperação de inventário de cofre que inclua arquivos criados nessa ou após essa data. *Valores válidos*: uma representação de string no formato de data ISO 8601 (`YYYY-MM-DDThh:mm:ssTZD`) em segundos, por exemplo `2013-03-20T17:03:43Z`. *Tipo*: string Uma representação de string no formato de data ISO 8601 (`YYYY-MM-DDThh:mm:ssTZD`) em segundos, por exemplo `2013-03-20T17:03:43Z`. *Obrigatório*: não ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) # jobParameters Fornece opções para definir um trabalho. ## Conteúdo **ArchiveId** O ID do arquivo desejado. Este campo só será obrigatório se o campo `Type` estiver definido como `select` ou `archive-retrieval`. Um erro ocorrerá se você especificar esse campo para uma solicitação de trabalho de recuperação de inventário. *Valores válidos*: devem ser um ID de arquivo válido obtido de uma solicitação anterior feita ao Amazon Glacier. *Tipo:* string *Obrigatório*: sim quando `Type` for definido como `select` ou `archive-retrieval`. **Descrição** A descrição opcional do trabalho. *Valores válidos*: a descrição deve ser menor ou igual a 1.024 bytes. Os caracteres permitidos são ASCII 7 bits sem códigos de controle — mais especificamente, valores ASCII 32–126 decimais ou 0x20–0x7E hexadecimais. *Tipo:* string *Obrigatório*: não **Formato** (Opcional) O formato da saída, ao iniciar um trabalho para recuperar um inventário de cofre. Se você estiver iniciando um trabalho de inventário e não especificar um campo `Format`, JSON será o formato padrão. *Valores válidos*: `CSV` \$1 `JSON` *Tipo:* string *Obrigatório*: não **InventoryRetrievalParameters** Os parâmetros de entrada usados em uma recuperação de inventário de intervalo. *Tipo*: [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) objeto *Obrigatório*: não **OutputLocation** Um objeto com informações sobre o local onde os resultados do trabalho de seleção são armazenados. *Tipo*: [OutputLocation](api-OutputLocation.md) objeto *Obrigatório*: sim para trabalhos `select`. **RetrievalByteRange** O intervalo de bytes a ser recuperado para uma `archive-retrieval`, no formato “*StartByteValue*-*EndByteValue*”. Se esse campo não for especificado, todo o arquivo será recuperado. Se esse campo for especificado, o intervalo de bytes deverá ser alinhado a megabyte (1024\$11024). Alinhado a megabyte significa que *StartByteValue* deve ser divisível por 1 MB e *EndByteValue* mais 1 deve ser divisível por 1 MB ou ser o final do arquivo especificado como o valor do tamanho de bytes do arquivo menos 1. Se **RetrievalByteRange** não estiver alinhado a megabyte, essa operação retornará a resposta `400`. Um erro ocorrerá se você especificar esse campo em uma solicitação de trabalho `inventory-retrieval` ou `select`. *Tipo:* string *Obrigatório*: não **SelectParameters** Um objeto com informações sobre os parâmetros usados em uma seleção. *Tipo*: [SelectParameters](api-SelectParameters.md) objeto *Obrigatório*: não **SNSTopic** O nome do recurso da Amazon (ARN) do tópico do Amazon SNS, em que o Amazon Glacier envia uma notificação quando o trabalho é concluído e a saída fica pronta para fazer download. O tópico especificado publica a notificação para os assinantes. O tópico do SNS deve existir. Do contrário, o Amazon Glacier não o criará para você. Além disso, o tópico do SNS deve ter uma política que permita à conta que criou o trabalho publicar mensagens no tópico. Para obter informações sobre nomes de tópico do SNS, consulte [CreateTopic](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html) na *Referência de API* do *Amazon Simple Notification Service*. *Tipo:* string *Obrigatório*: não **Tier** O nível a ser usado para um trabalho de seleção ou de recuperação de arquivo. `Standard` é o valor padrão usado. *Valores válidos*: `Expedited` \$1 `Standard` \$1 `Bulk` *Tipo:* string *Obrigatório*: não **Tipo** O tipo de trabalho. Você pode iniciar um trabalho para executar uma consulta select em um arquivo, recuperar um arquivo ou obter um inventário de um cofre. *Valores válidos*: `select` \$1 `archive-retrieval` \$1 `inventory-retrieval` *Tipo:* string *Obrigatório*: sim ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) # OutputLocation Contém informações sobre o local em que os resultados e os erros de trabalho são armazenados. ## Conteúdo **S3** Um objeto que descreve um local do Amazon S3 para receber os resultados da solicitação de restauração. *Tipo*: [S3Location](api-S3Location.md) *Obrigatório*: sim ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) # OutputSerialization Descreve como a saída será serializada. ## Conteúdo **CSV** Um objeto que descreve a serialização dos resultados de consulta codificados por valores separados por vírgulas (CSV). *Tipo*: [CSVOutput](api-CSVOutput.md) objeto *Obrigatório*: não ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) # S3Location Contém informações sobre o local do Amazon S3 em que os resultados do trabalho são armazenados. ## Conteúdo **AccessControlList** Uma lista de concessões que controlam o acesso aos resultados armazenados. *Tipo*: matriz de objetos [Concessão](api-Grant.md) *Obrigatório*: não **BucketName** O nome do bucket do Amazon S3 no qual os resultados do trabalho são armazenados. O bucket deve estar na mesma região da AWS do cofre que contém o objeto de arquivo de entrada. *Tipo:* string *Obrigatório*: sim **CannedACL** A lista de controle de acesso pré-configurada a ser aplicada aos resultados do trabalho. *Tipo:* string *Valores válidos*: `private` \$1 `public-read` \$1 `public-read-write` \$1 `aws-exec-read` \$1 `authenticated-read` \$1 `bucket-owner-read` \$1 `bucket-owner-full-control` *Obrigatório*: não **Criptografia** Um objeto com informações sobre a criptografia usada para armazenar os resultados do trabalho no Amazon S3. *Tipo*: [Criptografia](api-Encryption.md) objeto *Obrigatório*: não **Prefixo** O prefixo que precede os resultados dessa solicitação. O tamanho máximo do prefixo é 512 bytes. *Tipo:* string *Obrigatório*: sim **StorageClass** A classe de armazenamento usada para armazenar os resultados do trabalho. *Tipo:* string *Valores válidos*: `STANDARD` \$1 `REDUCED_REDUNDANCY` \$1 `STANDARD_IA` *Obrigatório*: não **Tags** O conjunto de tags aplicado aos resultados do trabalho. *Tipo*: mapa de string para string *Obrigatório*: não **UserMetadata** Um mapa de metadados a ser armazenado com os resultados do trabalho no Amazon S3. *Tipo*: mapa de string para string *Obrigatório*: não ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) # SelectParameters Contém informações sobre os parâmetros usados na seleção. ## Conteúdo **Expressão** A expressão usada para selecionar o objeto. A expressão não deve exceder a cota de 128.000 caracteres. *Tipo:* string *Obrigatório*: sim **ExpressionType** O tipo da expressão fornecida; por exemplo, `SQL`. *Valores Válidos*: `SQL` *Tipo:* string *Obrigatório*: sim **InputSerialization** Descreve o formato de serialização do objeto na seleção. *Tipo*: [InputSerialization](api-InputSerialization.md) objeto *Obrigatório*: não **OutputSerialization** Descreve como os resultados do trabalho de seleção são serializados. *Obrigatório*: não *Tipo*: [OutputSerialization](api-OutputSerialization.md) objeto ## Mais informações + [Initiate Job (trabalhos POST)](api-initiate-job-post.md)