Restaurando um objeto usando a CLI do AWS

Os exemplos a seguir usam variáveis de ambiente para maior clareza: Eles devem ser configurados para os valores desejados; por exemplo, $ENDPOINT seria configurado para https://s3.us.cloud-object-storage.appdomain.cloud ou https://s3.eu-de.private.cloud-object-storage.appdomain.cloud ou qualquer outro valor necessário.

1. Verifique o status do objeto: aws --endpoint-url $ENDPOINT s3api head-object --bucket $BUCKET --key $KEY. A classe de armazenamento será mostrada como ("StorageClass": "GLACIER").
2. Restaurar o objeto: aws --endpoint-url $ENDPOINT s3api restore-object ---bucket $BUCKET --key $KEY --restore-request '{"Days":25,"GlacierJobParameters":{"Tier":"Bulk"}}'
3. Verifique o status: aws --endpoint-url $ENDPOINT s3api head-object --bucket $BUCKET --key $KEY

Criar uma configuração de ciclo de vida do depósito

Essa implementação da operação PUT usa o parâmetro de consulta lifecycle para definir as configurações de ciclo de vida para o depósito. Essa operação permite uma definição de política de ciclo de vida única para um determinado depósito. A política é definida como uma regra que consiste nos parâmetros a seguir: ID, Status e Transition.

A ação de transição permite que objetos futuros sejam gravados no depósito em um estado arquivado após um período de tempo definido. As mudanças na política de ciclo de vida de um depósito são aplicadas somente a novos objetos gravados nesse depósito.

Os usuários do Cloud IAM devem ter no mínimo a função Writer para incluir uma política de ciclo de vida no depósito.

Os usuários da infraestrutura clássica devem ter Permissões de proprietário e ser capazes de criar depósitos na conta de armazenamento para incluir uma política de ciclo de vida no depósito.

Essa operação não faz uso de parâmetros adicionais de consulta específicos da operação.

Um cabeçalho Content-MD5 ou um cabeçalho checksum (incluindo x-amz-checksum-crc32, x-amz-checksum-crc32c, x-amz-checksum-crc64nvme, x-amz-checksum-sha1 ou x-amz-checksum-sha256) é necessário como uma verificação de integridade para a carga útil.

O corpo da solicitação deve conter um bloco XML com o esquema a seguir:

Sintaxe

PUT https://{endpoint}/{bucket}?lifecycle # path style
PUT https://{bucket}.{endpoint}?lifecycle # virtual host style

<LifecycleConfiguration>
	<Rule>
		<ID>{string}</ID>
		<Status>Enabled</Status>
		<Filter>
			<Prefix/>
		</Filter>
		<Transition>
			<Days>{integer}</Days>
			<StorageClass>{StorageClass}</StorageClass>
		</Transition>
	</Rule>
</LifecycleConfiguration>

Exemplos

Solicitação de amostra

PUT /images?lifecycle HTTP/1.1
Host: s3.us.cloud-object-storage.appdomain.cloud
Date: Wed, 7 Feb 2018 17:50:00 GMT
Authorization: authorization string
Content-Type: text/plain
Content-MD5: 1B2M2Y8AsgTpgAmY7PhCfg==
Content-Length: 305

<LifecycleConfiguration>
    <Rule>
        <ID>my-archive-policy</ID>
        <Filter>
			<Prefix/>
		</Filter>
        <Status>Enabled</Status>
        <Transition>
            <Days>20</Days>
            <StorageClass>ACCELERATED</StorageClass>
        </Transition>
    </Rule>
</LifecycleConfiguration>

Resposta de amostra

HTTP/1.1 200 OK
Date: Wed, 7 Feb 2018 17:51:00 GMT
Connection: close

var params = {
  Bucket: 'STRING_VALUE', /* required */
  LifecycleConfiguration: {
    Rules: [ /* required */
      {
        Status: 'Enabled', /* required */
        ID: 'STRING_VALUE',
        Filter: '', /* required */
        Prefix: '',
        Transitions: [
          {
            Date: DATE, /* required if Days not specified */
            Days: 0, /* required if Date not specified */
            StorageClass: 'STRING_VALUE' /* required */
          },
        ]
      },
    ]
  }
};

s3.putBucketLifecycleConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

response = client.put_bucket_lifecycle_configuration(
    Bucket='string',
    LifecycleConfiguration={
        'Rules': [
            {
                'ID': 'string',
                'Status': 'Enabled',
                'Filter': '',
                'Prefix': '',
                'Transitions': [
                    {
                        'Date': datetime(2015, 1, 1),
                        'Days': 123,
                        'StorageClass': 'GLACIER'
                    },
                ]
            },
        ]
    }
)

public SetBucketLifecycleConfigurationRequest(String bucketName,
                                              BucketLifecycleConfiguration lifecycleConfiguration)

Resumo de método

Recuperar uma configuração de ciclo de vida do depósito

Essa implementação da operação GET usa o parâmetro de consulta lifecycle para recuperar as configurações de ciclo de vida para o depósito.

Os usuários do Cloud IAM devem ter no mínimo a função Reader para recuperar um ciclo de vida para um depósito.

Os usuários da infraestrutura clássica devem ter no mínimo permissões Read no depósito para recuperar uma política de ciclo de vida para um depósito.

Essa operação não faz uso de cabeçalhos, parâmetros de consulta ou carga útil específicos da operação adicionais.

Sintaxe

GET https://{endpoint}/{bucket}?lifecycle # path style
GET https://{bucket}.{endpoint}?lifecycle # virtual host style

Exemplos

Solicitação de amostra

GET /images?lifecycle HTTP/1.1
Host: s3.us.cloud-object-storage.appdomain.cloud
Date: Wed, 7 Feb 2018 17:50:00 GMT
Authorization: authorization string

Resposta de amostra

HTTP/1.1 200 OK
Date: Wed, 7 Feb 2018 17:51:00 GMT
Connection: close

<LifecycleConfiguration>
    <Rule>
        <ID>my-archive-policy</ID>
        <Filter />
        <Status>Enabled</Status>
        <Transition>
            <Days>20</Days>
            <StorageClass>GLACIER</StorageClass>
        </Transition>
    </Rule>
</LifecycleConfiguration>

var params = {
  Bucket: 'STRING_VALUE' /* required */
};
s3.getBucketLifecycleConfiguration(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

response = client.get_bucket_lifecycle_configuration(Bucket='string')

public GetBucketLifecycleConfigurationRequest(String bucketName)

Excluir uma configuração de ciclo de vida do depósito

Essa implementação da operação DELETE usa o parâmetro de consulta lifecycle para remover quaisquer configurações de ciclo de vida para o depósito. As transições definidas pelas regras não ocorrerão mais para novos objetos.

Nota: as regras de transição existentes serão mantidas para objetos que já foram gravados no depósito antes que as regras fossem excluídas.

Os usuários do Cloud IAM devem ter no mínimo a função Writer para remover uma política de ciclo de vida de um depósito.

Os usuários da infraestrutura clássica devem ter permissões Owner no depósito para remover uma política de ciclo de vida de um depósito.

Essa operação não faz uso de cabeçalhos, parâmetros de consulta ou carga útil específicos da operação adicionais.

Sintaxe

DELETE https://{endpoint}/{bucket}?lifecycle # path style
DELETE https://{bucket}.{endpoint}?lifecycle # virtual host style

Exemplos

Solicitação de amostra

DELETE /images?lifecycle HTTP/1.1
Host: s3.us.cloud-object-storage.appdomain.cloud
Date: Wed, 7 Feb 2018 18:50:00 GMT
Authorization: authorization string

Resposta de amostra

HTTP/1.1 204 No Content
Date: Wed, 7 Feb 2018 18:51:00 GMT
Connection: close

var params = {
  Bucket: 'STRING_VALUE' /* required */
};
s3.deleteBucketLifecycle(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

response = client.delete_bucket_lifecycle(Bucket='string')

public DeleteBucketLifecycleConfigurationRequest(String bucketName)

Restaurar temporariamente um objeto arquivado

Essa implementação da operação POST usa o parâmetro de consulta restore para solicitar a restauração temporária de um objeto arquivado. O usuário deve primeiro restaurar um objeto arquivado antes de fazer download ou modificar o objeto. Ao restaurar um objeto, o usuário deve especificar um período após o qual a cópia temporária do objeto será excluída. O objeto mantém a classe de armazenamento do depósito.

Pode haver um atraso de até 12 horas antes que a cópia restaurada esteja disponível para acesso. Uma solicitação HEAD poderá verificar se a cópia restaurada está disponível.

Para restaurar permanentemente o objeto, o usuário deve copiar o objeto restaurado para um depósito que não tenha uma configuração de ciclo de vida ativa.

Os usuários do Cloud IAM devem ter no mínimo a função Writer para restaurar um objeto.

Os usuários da infraestrutura clássica devem ter no mínimo as permissões Write no depósito e a permissão Read no objeto para restaurá-lo.

Essa operação não faz uso de parâmetros adicionais de consulta específicos da operação.

O corpo da solicitação deve conter um bloco XML com o esquema a seguir:

Uma resposta bem-sucedida retornará um 202 se o objeto estiver no estado arquivado e em um 200 se o objeto já estiver no estado restaurado. Se o objeto já estiver no estado restaurado e uma nova solicitação para restaurar o objeto for recebida, o elemento Days atualizará o prazo de expiração do objeto restaurado.

Sintaxe

POST https://{endpoint}/{bucket}/{object}?restore # path style
POST https://{bucket}.{endpoint}/{object}?restore # virtual host style

<RestoreRequest>
	<Days>{integer}</Days>
	<GlacierJobParameters>
		<Tier>Bulk</Tier>
	</GlacierJobParameters>
</RestoreRequest>

Exemplos

Solicitação de amostra

POST /images/backup?restore HTTP/1.1
Host: s3.us.cloud-object-storage.appdomain.cloud
Date: Wed, 7 Feb 2018 19:50:00 GMT
Authorization: {authorization string}
Content-Type: text/plain
Content-MD5: 1B2M2Y8AsgTpgAmY7PhCfg==
Content-Length: 305

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

Resposta de amostra

HTTP/1.1 202 Accepted
Date: Wed, 7 Feb 2018 19:51:00 GMT
Connection: close

var params = {
  Bucket: 'STRING_VALUE', /* required */
  Key: 'STRING_VALUE', /* required */
  ContentMD5: 'STRING_VALUE', /* required */
  RestoreRequest: {
   Days: 1, /* days until copy expires */
   GlacierJobParameters: {
     Tier: 'STRING_VALUE' /* required */
   },
  }
 };
 s3.restoreObject(params, function(err, data) {
   if (err) console.log(err, err.stack); // an error occurred
   else     console.log(data);           // successful response
});

response = client.restore_object(
    Bucket='string',
    Key='string',
    RestoreRequest={
        'Days': 123,
        'GlacierJobParameters': {
            'Tier': 'string'
        },
    }
)

public RestoreObjectRequest(String bucketName,
                            String key,
                            int expirationInDays)

Resumo de método

Obter cabeçalhos de um objeto

Um HEAD fornecido em um caminho para um objeto recupera os cabeçalhos desse objeto. Essa operação não faz uso de parâmetros de consulta ou elementos de carga útil específicos da operação.

Sintaxe

HEAD https://{endpoint}/{bucket-name}/{object-name} # path style
HEAD https://{bucket-name}.{endpoint}/{object-name} # virtual host style

Cabeçalhos de resposta para objetos arquivados

Solicitação de amostra

HEAD /images/backup HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20160825T183244Z
Host: s3.us.cloud-object-storage.appdomain.cloud

Resposta de amostra

HTTP/1.1 200 OK
Date: Wed, 7 Feb 2018 19:51:00 GMT
X-Clv-Request-Id: da214d69-1999-4461-a130-81ba33c484a6
Accept-Ranges: bytes
Server: 3.x
X-Clv-S3-Version: 2.5
ETag: "37d4c94839ee181a2224d6242176c4b5"
Content-Type: text/plain; charset=UTF-8
Last-Modified: Thu, 25 Aug 2017 17:49:06 GMT
Content-Length: 11
x-ibm-transition: transition="ARCHIVE", date="Mon, 03 Dec 2018 22:28:38 GMT"
x-amz-restore: ongoing-request="false", expiry-date="Thu, 06 Dec 2018 18:28:38 GMT"
x-amz-storage-class: "GLACIER"
x-ibm-restored-copy-storage-class: "Standard"

response = client.head_object(
    Bucket='string',
    Key='string'
)

var params = {
  Bucket: 'STRING_VALUE', /* required */
  Key: 'STRING_VALUE', /* required */
};
s3.headObject(params, function(err,data) {
  if (err) console.log(err, err.stack); // an error occurred
  else
    console.log(data);           // successful response
});

public ObjectMetadata()

Resumo de método