Skip to main content
È disponibile una versione più recente di questo prodotto.
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Operazioni sugli oggetti

Collaboratori
PDF

Questa sezione descrive come il sistema StorageGRID implementa le operazioni API REST S3 per gli oggetti.

Le seguenti condizioni si applicano a tutte le operazioni a oggetti:

  • StorageGRID "controlli di coerenza" sono supportate da tutte le operazioni sugli oggetti, ad eccezione di quanto segue:

    • GET Object ACL (OTTIENI ACL oggetto)

    • OPTIONS /

    • METTERE in attesa legale l'oggetto

    • METTI la conservazione degli oggetti

    • SELEZIONARE il contenuto dell'oggetto

  • Le richieste dei client in conflitto, come due client che scrivono sulla stessa chiave, vengono risolte in base alle "ultime vincite". La tempistica per la valutazione “ultimi successi” si basa su quando il sistema StorageGRID completa una data richiesta e non su quando i client S3 iniziano un'operazione.

  • Tutti gli oggetti in un bucket StorageGRID sono di proprietà del proprietario del bucket, inclusi gli oggetti creati da un utente anonimo o da un altro account.

  • Impossibile accedere agli oggetti dati acquisiti nel sistema StorageGRID tramite Swift tramite S3.

Nella tabella seguente viene descritto il modo in cui StorageGRID implementa le operazioni degli oggetti API REST S3.

Operazione Implementazione

ELIMINA oggetto

Autenticazione multifattore (MFA) e intestazione della risposta x-amz-mfa non sono supportati.

Durante l'elaborazione di una richiesta DI ELIMINAZIONE degli oggetti, StorageGRID tenta di rimuovere immediatamente tutte le copie dell'oggetto da tutte le posizioni memorizzate. Se l'esito è positivo, StorageGRID restituisce immediatamente una risposta al client. Se non è possibile rimuovere tutte le copie entro 30 secondi (ad esempio, perché una posizione è temporaneamente non disponibile), StorageGRID mette in coda le copie per la rimozione e indica che il client è riuscito.

Versione

Per rimuovere una versione specifica, il richiedente deve essere il proprietario del bucket e utilizzare versionId sottorisorsa. L'utilizzo di questa sottorisorsa elimina in modo permanente la versione. Se il versionId corrisponde a un indicatore di eliminazione, l'intestazione della risposta x-amz-delete-marker viene restituito impostato su true.

  • Se un oggetto viene eliminato senza versionId sottorisorsa su un bucket abilitato alla versione, si ottiene la generazione di un indicatore di eliminazione. Il versionId per il contrassegno di eliminazione viene restituito utilizzando x-amz-version-id intestazione della risposta e la x-amz-delete-marker l'intestazione della risposta viene restituita impostata su true.

  • Se un oggetto viene eliminato senza versionId sottorisorsa su un bucket sospeso della versione, si ottiene una cancellazione permanente di una versione 'null' già esistente o di un marker di eliminazione 'null' e la generazione di un nuovo marker di eliminazione 'null'. Il x-amz-delete-marker l'intestazione della risposta viene restituita impostata su true.

    Nota: In alcuni casi, per un oggetto potrebbero esistere più contrassegni di eliminazione.

Vedere "Utilizzare l'API REST S3 per configurare il blocco oggetti S3" Per informazioni su come eliminare le versioni degli oggetti in modalità GOVERNANCE.

ELIMINARE più oggetti

(DeleteObjects)

Autenticazione multifattore (MFA) e intestazione della risposta x-amz-mfa non sono supportati.

È possibile eliminare più oggetti nello stesso messaggio di richiesta.

Vedere "Utilizzare l'API REST S3 per configurare il blocco oggetti S3" Per informazioni su come eliminare le versioni degli oggetti in modalità GOVERNANCE.

ELIMINA tag oggetti

Utilizza tagging sottorisorsa per rimuovere tutti i tag da un oggetto.

Versione

Se il versionId il parametro query non è specificato nella richiesta, l'operazione elimina tutti i tag dalla versione più recente dell'oggetto in un bucket con versione. Se la versione corrente dell'oggetto è un indicatore di eliminazione, viene restituito lo stato “MethodNotAllowed” con x-amz-delete-marker intestazione risposta impostata su true.

OTTIENI oggetto

"OTTIENI oggetto"

GET Object ACL (OTTIENI ACL oggetto)

Se vengono fornite le credenziali di accesso necessarie per l'account, l'operazione restituisce una risposta positiva e l'ID, il DisplayName e l'autorizzazione del proprietario dell'oggetto, indicando che il proprietario dispone dell'accesso completo all'oggetto.

OTTENERE un blocco legale degli oggetti

"Utilizzare l'API REST S3 per configurare il blocco oggetti S3"

OTTIENI la conservazione degli oggetti

"Utilizzare l'API REST S3 per configurare il blocco oggetti S3"

OTTIENI tag di oggetti

Utilizza tagging sottorisorsa per restituire tutti i tag per un oggetto.

Versione

Se il versionId il parametro query non è specificato nella richiesta, l'operazione restituisce tutti i tag della versione più recente dell'oggetto in un bucket con versione. Se la versione corrente dell'oggetto è un indicatore di eliminazione, viene restituito lo stato “MethodNotAllowed” con x-amz-delete-marker intestazione risposta impostata su true.

Oggetto TESTA

"Oggetto TESTA"

RIPRISTINO POST-oggetto

"RIPRISTINO POST-oggetto"

METTI oggetto

"METTI oggetto"

METTI oggetto - Copia

"METTI oggetto - Copia"

METTERE in attesa legale l'oggetto

"Utilizzare l'API REST S3 per configurare il blocco oggetti S3"

METTI la conservazione degli oggetti

"Utilizzare l'API REST S3 per configurare il blocco oggetti S3"

INSERIRE tag degli oggetti

Utilizza tagging sottorisorsa per aggiungere un set di tag a un oggetto esistente.

Limiti tag oggetto

È possibile aggiungere tag a nuovi oggetti durante il caricamento oppure aggiungerli a oggetti esistenti. StorageGRID e Amazon S3 supportano fino a 10 tag per ciascun oggetto. I tag associati a un oggetto devono avere chiavi tag univoche. Una chiave di tag può contenere fino a 128 caratteri Unicode e i valori di tag possono contenere fino a 256 caratteri Unicode. Chiave e valori distinguono tra maiuscole e minuscole.

Aggiornamenti dei tag e comportamento di acquisizione

Quando si utilizza IL tag PUT Object per aggiornare i tag di un oggetto, StorageGRID non reinserisce l'oggetto. Ciò significa che l'opzione per il comportamento di Ingest specificata nella regola ILM corrispondente non viene utilizzata. Le modifiche al posizionamento degli oggetti che vengono attivate dall'aggiornamento vengono apportate quando ILM viene rivalutato dai normali processi ILM in background.

Ciò significa che se la regola ILM utilizza l'opzione Strict per il comportamento di acquisizione, non viene eseguita alcuna azione se non è possibile eseguire il posizionamento degli oggetti richiesto (ad esempio, perché non è disponibile una nuova posizione richiesta). L'oggetto aggiornato mantiene la posizione corrente fino a quando non è possibile il posizionamento richiesto.

Risoluzione dei conflitti

Le richieste dei client in conflitto, ad esempio due client che scrivono sulla stessa chiave, vengono risolte in base alle “ultime vittorie”. La tempistica per la valutazione “ultimi successi” si basa su quando il sistema StorageGRID completa una data richiesta e non su quando i client S3 iniziano un'operazione.

Versione

Se il versionId il parametro query non è specificato nella richiesta, l'operazione aggiunge tag alla versione più recente dell'oggetto in un bucket con versione. Se la versione corrente dell'oggetto è un indicatore di eliminazione, viene restituito lo stato “MethodNotAllowed” con x-amz-delete-marker intestazione risposta impostata su true.

SelectObjectContent

"SelectObjectContent"
Informazioni correlate

"Operazioni S3 monitorate nei registri di audit"