La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Operazioni sugli oggetti

05/23/2023 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:

I controlli di coerenza StorageGRID sono supportati 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
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 sul momento in cui 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.
Non è possibile 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

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 non è temporaneamente 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.
ELIMINARE più oggetti	Autenticazione multifattore (MFA) e intestazione della risposta `x-amz-mfa` non sono supportati. È possibile eliminare più oggetti nello stesso messaggio di richiesta.
ELIMINA tag oggetti	Utilizza `tagging` sottorisorsa per rimuovere tutti i tag da un oggetto. Implementato con tutti i comportamenti REST API di Amazon S3. 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	"Utilizzo di S3 Object Lock"
OTTIENI la conservazione degli oggetti	"Utilizzo di S3 Object Lock"
OTTIENI tag di oggetti	Utilizza `tagging` sottorisorsa per restituire tutti i tag per un oggetto. Implementato con tutti i comportamenti REST API di Amazon S3 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	"Utilizzo di S3 Object Lock"
METTI la conservazione degli oggetti	"Utilizzo di S3 Object Lock"
INSERIRE tag degli oggetti	Utilizza `tagging` sottorisorsa per aggiungere un set di tag a un oggetto esistente. Implementato con tutti i comportamenti REST API di Amazon S3 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 sul momento in cui 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`.

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 non è temporaneamente 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.

ELIMINARE più oggetti

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

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

ELIMINA tag oggetti

Utilizza tagging sottorisorsa per rimuovere tutti i tag da un oggetto. Implementato con tutti i comportamenti REST API di Amazon S3.

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

"Utilizzo di S3 Object Lock"

OTTIENI la conservazione degli oggetti

"Utilizzo di S3 Object Lock"

OTTIENI tag di oggetti

Utilizza tagging sottorisorsa per restituire tutti i tag per un oggetto. Implementato con tutti i comportamenti REST API di Amazon S3

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

"Utilizzo di S3 Object Lock"

METTI la conservazione degli oggetti

"Utilizzo di S3 Object Lock"

INSERIRE tag degli oggetti

Utilizza tagging sottorisorsa per aggiungere un set di tag a un oggetto esistente. Implementato con tutti i comportamenti REST API di Amazon S3

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 sul momento in cui 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.

Informazioni correlate

"Controlli di coerenza"

"Operazioni S3 registrate nei registri di audit"

Operazioni sugli oggetti

Creating your file...