Objetos de Versão

Arquivando e Expirando Objetos com Versão

As configurações de ciclo de vida são permitidas em um depósito ativado por versão No entanto, ao contrário do Amazon S3, novas versões estão sujeitas à regra de archive da mesma maneira que objetos regulares. Os objetos recebem uma data de transição quando são criados e são arquivados em suas datas de transição individuais, independentemente de serem versões atuais ou não. Sobrescrever um objeto não afeta a data de transição da versão anterior e a nova versão (atual) será designada uma data de transição.

Não é possível usar regras NoncurrentVersionTransition para arquivar apenas versões não atuais de objetos em uma configuração de ciclo de vida.

Imutável Object Storage (WORM)

A implementação do IBM COS do Immutable Object Storage (ou seja, políticas de retenção) não é permitida em depósitos com versão ativada. As tentativas de criar uma política de retenção falharão, assim como as tentativas de ativar a versão em um depósito com uma política de retenção.

Ativar a versão em um depósito

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?versioning" \
     -H 'Authorization: bearer $TOKEN' \
     -H 'Content-MD5: 8qj8HSeDu3APPMQZVG06WQ==' \
     -H 'Content-Type: text/plain; charset=utf-8' \
     -d $'<VersioningConfiguration>
            <Status>Enabled</Status>
          </VersioningConfiguration>'

Uma solicitação bem-sucedida retorna uma resposta de 200

Suspender versão em um depósito

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?versioning" \
     -H 'Authorization: bearer $TOKEN' \
     -H 'Content-MD5: hxXDWuCDWB72Be0LG4XniQ==' \
     -H 'Content-Type: text/plain; charset=utf-8' \
     -d $'<VersioningConfiguration>
            <Status>Suspended</Status>
          </VersioningConfiguration>'

Uma solicitação bem-sucedida retorna uma resposta de 200

Listar versões de objetos em um bucket

curl -X "GET" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/?versions" \
     -H 'Authorization: bearer $TOKEN'

Isso retorna um corpo de resposta XML:

<ListVersionsResult>
   <IsTruncated>boolean</IsTruncated>
   <KeyMarker>string</KeyMarker>
   <VersionIdMarker>string</VersionIdMarker>
   <NextKeyMarker>string</NextKeyMarker>
   <NextVersionIdMarker>string</NextVersionIdMarker>
   <Version>
      <ETag>string</ETag>
      <IsLatest>boolean</IsLatest>
      <Key>string</Key>
      <LastModified>timestamp</LastModified>
      <Owner>
         <DisplayName>string</DisplayName>
         <ID>string</ID>
      </Owner>
      <Size>integer</Size>
      <StorageClass>string</StorageClass>
      <VersionId>string</VersionId>
   </Version>
   ...
   <DeleteMarker>
      <IsLatest>boolean</IsLatest>
      <Key>string</Key>
      <LastModified>timestamp</LastModified>
      <Owner>
         <DisplayName>string</DisplayName>
         <ID>string</ID>
      </Owner>
      <VersionId>string</VersionId>
   </DeleteMarker>
   ...
   <Name>string</Name>
   <Prefix>string</Prefix>
   <Delimiter>string</Delimiter>
   <MaxKeys>integer</MaxKeys>
   <CommonPrefixes>
      <Prefix>string</Prefix>
   </CommonPrefixes>
   ...
   <EncodingType>string</EncodingType>
</ListVersionsResult>

delimiter: Um delimitador é um caractere que você especifica para agrupar chaves. Todas as chaves que contêm a mesma cadeia entre o prefixo e a primeira ocorrência do delimitador são agrupadas sob um único elemento de resultado em CommonPrefixes Esses grupos são contados como um resultado com relação à limitação de chaves máximas. Essas chaves não são retornadas em outro lugar na resposta..

encoding-type: solicita o COS para codificar por URL as chaves de objeto na resposta. As chaves do objeto podem conter qualquer caractere Unicode; no entanto, o analisador XML 1.0 não pode analisar alguns caracteres, como caracteres com um valor ASCII de 0 a 10. Para caracteres não suportados no XML 1.0, é possível incluir esse parâmetro para solicitar que o COS codifique as chaves na resposta. Valor válido: url.

key-marker: Especifica a chave com a qual começar ao listar objetos em um bucket.

max-keys: configura o número máximo de chaves retornadas na resposta. Por padrão, a API retorna até 1.000 nomes de chave.. A resposta pode conter menos chaves, mas nunca mais.

prefix: Use esse parâmetro para selecionar apenas as chaves que começam com o prefixo especificado.

version-id-marker: Especifica a versão do objeto da qual você deseja iniciar a listagem.

Operações em versões específicas de objetos

Várias APIs usam um novo parâmetro de consulta (?versionId=<VersionId>) que indica qual versão do objeto você está solicitando. Esse parâmetro é usado da mesma maneira para ler, excluir, verificar metadados e tags e restaurar objetos arquivados. Por exemplo, para ler uma versão de um objeto foo com um ID de versão L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo, a solicitação pode ser semelhante ao seguinte:

curl -X "GET" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/foo?versionId=L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo" \
     -H 'Authorization: bearer $TOKEN'

A exclusão desse objeto é feita da mesma maneira.

curl -X "DELETE" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/foo?versionId=L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo" \
     -H 'Authorization: bearer $TOKEN'

Para solicitações que já usam um parâmetro de consulta, o parâmetro versionId pode ser incluído no final.

curl -X "GET" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/foo?tagging&versionId=L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo" \
     -H 'Authorization: bearer $TOKEN'

A cópia do lado do servidor de versões do objeto é suportada mas usa uma sintaxe ligeiramente diferente. O parâmetro de consulta não é adicionado ao próprio URL, mas sim anexado ao x-amz-copy-source cabeçalho. Essa é a mesma sintaxe da criação de uma parte para uma parte múltipla de um objeto de origem.

curl -X "PUT" "https://$BUCKET.s3.$REGION.cloud-object-storage.appdomain.cloud/<new-object-key>"
 -H "Authorization: bearer $TOKEN"
 -H "x-amz-copy-source: /<source-bucket>/<object-key>?versionId=L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo"

Python

A ativação da versão usando o IBM COS SDK for Python pode ser feita usando a sintaxe de recurso de alto nível ou cliente de baixo nível.

Usando um recurso:

#!/usr/bin/env python3

import ibm_boto3
from ibm_botocore.config import Config
from ibm_botocore.exceptions import ClientError

#Define constants
API_KEY = os.environ.get('IBMCLOUD_API_KEY')
SERVICE_INSTANCE = os.environ.get('SERVICE_INSTANCE_ID')
ENDPOINT = os.environ.get('ENDPOINT')

BUCKET = "my-versioning-bucket" # The bucket that will enable versioning.

#Create resource client with configuration info pulled from environment variables.
cos = ibm_boto3.resource("s3",
                         ibm_api_key_id=API_KEY,
                         ibm_service_instance_id=SERVICE_INSTANCE,
                         config=Config(signature_version="oauth"),
                         endpoint_url=ENDPOINT
                         )

versioning = cos.BucketVersioning(BUCKET)

versioning.enable()

A versão para o depósito pode, então, ser suspensa usando versioning.suspend()

Usando esse mesmo recurso cos, todas as versões de objetos podem ser listadas usando o seguinte:

versions = s3.Bucket(BUCKET).object_versions.filter(Prefix=key)

for version in versions:
    obj = version.get()
    print(obj.get('VersionId'), obj.get('ContentLength'), obj.get('LastModified'))

Usando um cliente:

#!/usr/bin/env python3

import ibm_boto3
from ibm_botocore.config import Config
from ibm_botocore.exceptions import ClientError

#Define constants
API_KEY = os.environ.get('IBMCLOUD_API_KEY')
SERVICE_INSTANCE = os.environ.get('SERVICE_INSTANCE_ID')
ENDPOINT = os.environ.get('ENDPOINT')

BUCKET = "my-versioning-bucket" # The bucket that will enable versioning.

#Create resource client with configuration info pulled from environment variables.
cosClient = ibm_boto3.client("s3",
                         ibm_api_key_id=API_KEY,
                         ibm_service_instance_id=SERVICE_INSTANCE,
                         config=Config(signature_version="oauth"),
                         endpoint_url=ENDPOINT
                         )

response = cosClient.put_bucket_versioning(
    Bucket=BUCKET,
    VersioningConfiguration={
        'Status': 'Enabled'
    }
)

Listando as versões de um objeto usando o mesmo cliente:

resp = cosClient.list_object_versions(Prefix='some-prefix', Bucket=BUCKET)

As APIs do site Python são muito flexíveis, e há muitas maneiras diferentes de realizar a mesma tarefa.

Node.js

Ativando a versão usando o SDK do IBM COS SDK for Node.js:

const IBM = require('ibm-cos-sdk');

var config = {
    endpoint: '<endpoint>',
    apiKeyId: '<api-key>',
    serviceInstanceId: '<resource-instance-id>',
};

var cos = new IBM.S3(config);

var params = {
    Bucket: 'my-versioning-bucket', /* required */
    VersioningConfiguration: { /* required */
    Status: 'Enabled'
   },
};

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