Controllo delle versioni degli oggetti

Archiviazione e scadenza degli oggetti con versione

Le configurazioni del ciclo di vita sono consentite in un bucket abilitato alla versione. Tuttavia, a differenza di Amazon S3, le nuove versioni sono soggette alla regola di archivio allo stesso modo degli oggetti normali. Agli oggetti viene fornita una data di transizione quando vengono creati e vengono archiviati nella data di transizione individuale, indipendentemente dal fatto che siano versioni correnti o non correnti. La sovrascrittura di un oggetto non influisce sulla data di transizione della versione precedente e alla nuova versione (corrente) verrà assegnata una data di transizione.

Non è possibile utilizzare le regole NoncurrentVersionTransition per archiviare solo versioni non correnti di oggetti in una configurazione del ciclo di vita.

Immutabile 'Object Storage (WORM)

L'implementazione IBM COS di Object Storage (ossia, le politiche di conservazione) non è consentita nei bucket con il controllo delle versioni abilitato. I tentativi di creare una politica di conservazione avranno esito negativo, così come i tentativi di abilitare le versioni su un bucket con una politica di conservazione.

Abilita il controllo delle versioni su un bucket

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

Una richiesta riuscita restituisce una risposta 200.

Sospendi controllo versioni su un bucket

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

Una richiesta riuscita restituisce una risposta 200.

Elencare le versioni degli oggetti in un bucket

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

Viene restituito un corpo della risposta 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: un delimitatore è un carattere specificato per raggruppare le chiavi. Tutte le chiavi che contengono la stessa stringa tra il prefisso e la prima ricorrenza del delimitatore sono raggruppate in un singolo elemento del risultato in CommonPrefixes. Questi gruppi vengono contati come un risultato rispetto alla limitazione del numero massimo di chiavi. Queste chiavi non vengono restituite altrove nella risposta.

encoding-type: richiede COS per codificare l'URL delle chiavi dell'oggetto nella risposta. Le chiavi oggetto possono contenere qualsiasi carattere Unicode; tuttavia, il programma di analisi XML 1.0 non può analizzare alcuni caratteri, come i caratteri con un valore ASCII compreso tra 0 e 10. Per i caratteri non supportati in XML 1.0, puoi aggiungere questo parametro per richiedere che COS codifica le chiavi nella risposta. Valore valido url.

key-marker: Specifica la chiave da cui iniziare quando si elencano gli oggetti in un bucket.

max-keys: imposta il numero massimo di chiavi restituite nella risposta. Per impostazione predefinita, l'API restituisce fino a 1.000 nomi chiave. La risposta potrebbe contenere meno chiavi, ma non ne conterrà mai di più.

prefix: utilizzare questo parametro per selezionare solo le chiavi che iniziano con il prefisso specificato.

version-id-marker: specifica la versione dell'oggetto da cui si desidera avviare l'elenco.

Operazioni su versioni specifiche di oggetti

Diverse API utilizzano un nuovo parametro di query (?versionId=<VersionId>) che indica quale versione dell'oggetto si sta richiedendo. Questo parametro viene utilizzato nello stesso modo per leggere, eliminare, controllare metadati e tag e ripristinare oggetti archiviati. Ad esempio, per leggere una versione di un oggetto foo con un ID versione L4kqtJlcpXroDVBH40Nr8X8gdRQBpUMLUo, la richiesta potrebbe essere simile alla seguente:

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

L'eliminazione dell'oggetto viene eseguita nello stesso modo.

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

Per le richieste che utilizzano già un parametro di query, il parametro versionId può essere aggiunto alla fine.

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

La copia lato server delle versioni degli oggetti è supportata, ma utilizza una sintassi leggermente differente. Il parametro di query non viene aggiunto all'URL stesso, ma viene aggiunto all'intestazione x-amz-copy-source. Questa è la stessa sintassi della creazione di una parte per una parte multipla da un oggetto di origine.

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

L'abilitazione della versione utilizzando IBM COS SDK for Python può essere eseguita utilizzando la sintassi risorsa di alto livello o client di basso livello.

Utilizzo di una risorsa:

#!/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()

Il controllo delle versioni per il bucket può quindi essere sospeso utilizzando versioning.suspend()

Utilizzando la stessa risorsa cos, è possibile elencare tutte le versioni degli oggetti utilizzando:

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

Utilizzo di un client:

#!/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'
    }
)

Elenco delle versioni di un oggetto utilizzando lo stesso client:

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

Nota che le API Python sono molto flessibili e ci sono molti modi diversi per eseguire la stessa attività.

Node.js

Abilitazione della versione utilizzando 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
});