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:

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 degli "ultimi successi" si basa sul momento in cui il sistema StorageGRID completa una data richiesta e non sul momento in cui 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	USA blocco oggetti S3
OTTIENI la conservazione degli oggetti	USA blocco oggetti S3
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	USA blocco oggetti S3
METTI la conservazione degli oggetti	USA blocco oggetti S3
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 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, come due client che scrivono sulla stessa chiave, vengono risolte in base alle "ultime vincite". La tempistica per la valutazione degli "ultimi successi" si basa sul momento in cui il sistema StorageGRID completa una data richiesta e non sul momento in cui 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

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

USA blocco oggetti S3

OTTIENI la conservazione degli oggetti

USA blocco oggetti S3

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

RIPRISTINO POST-oggetto

METTI oggetto

METTI oggetto - Copia

METTERE in attesa legale l'oggetto

USA blocco oggetti S3

METTI la conservazione degli oggetti

USA blocco oggetti S3

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

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, come due client che scrivono sulla stessa chiave, vengono risolte in base alle "ultime vincite". La tempistica per la valutazione degli "ultimi successi" si basa sul momento in cui il sistema StorageGRID completa una data richiesta e non sul momento in cui 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

Operazioni S3 monitorate nei registri di audit

Operazioni sugli oggetti

Creating your file...