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 sui bucket

Collaboratori
PDF

Il sistema StorageGRID supporta un massimo di 1,000 bucket per ciascun account tenant S3.

Le restrizioni dei nomi dei bucket seguono le restrizioni delle regioni AWS US Standard, ma è necessario limitarle ulteriormente alle convenzioni di denominazione DNS per supportare le richieste di tipo host virtuale S3.

Per ulteriori informazioni, vedere quanto segue:

LE operazioni GET bucket (Elenca oggetti) e GET Bucket Versions supportano i controlli di coerenza StorageGRID.

È possibile verificare se gli aggiornamenti dell'ultimo tempo di accesso sono attivati o disattivati per i singoli bucket.

La seguente tabella descrive come StorageGRID implementa le operazioni del bucket API REST S3. Per eseguire una di queste operazioni, è necessario fornire le credenziali di accesso necessarie per l'account.

Operazione Implementazione

ELIMINA bucket

Questa operazione elimina il bucket.

ELIMINA cors bucket

Questa operazione elimina la configurazione CORS per il bucket.

ELIMINA crittografia bucket

Questa operazione elimina la crittografia predefinita dal bucket. Gli oggetti crittografati esistenti rimangono crittografati, ma i nuovi oggetti aggiunti al bucket non vengono crittografati.

ELIMINA ciclo di vita bucket

Questa operazione elimina la configurazione del ciclo di vita dal bucket. Vedere "Creare la configurazione del ciclo di vita S3".

ELIMINA policy bucket

Questa operazione elimina la policy associata al bucket.

ELIMINA replica bucket

Questa operazione elimina la configurazione di replica collegata al bucket.

ELIMINA tag bucket

Questa operazione utilizza tagging sottorisorsa per rimuovere tutti i tag da un bucket.

OTTIENI bucket

(ListObjects)

(ListObjectsV2)

Questa operazione restituisce alcuni o tutti (fino a 1,000) gli oggetti in un bucket. La classe Storage per gli oggetti può avere due valori, anche se l'oggetto è stato acquisito con REDUCED_REDUNDANCY opzione classe di storage:

  • STANDARD, Che indica che l'oggetto è memorizzato in un pool di storage costituito da nodi di storage.

  • GLACIER, Che indica che l'oggetto è stato spostato nel bucket esterno specificato dal Cloud Storage Pool.

Se il bucket contiene un numero elevato di chiavi eliminate con lo stesso prefisso, la risposta potrebbe includere alcune CommonPrefixes che non contengono chiavi.

SCARICA le versioni degli oggetti bucket

(ListObjectVersions)

Con l'accesso IN LETTURA su un bucket, questa operazione con versions la sottorisorsa elenca i metadati di tutte le versioni degli oggetti nel bucket.

OTTIENI acl bucket

Questa operazione restituisce una risposta positiva e l'ID, il DisplayName e il permesso del proprietario del bucket, indicando che il proprietario ha pieno accesso al bucket.

OTTIENI bucket cors

Questa operazione restituisce il cors configurazione per il bucket.

OTTIENI la crittografia bucket

Questa operazione restituisce la configurazione di crittografia predefinita per il bucket.

OTTIENI il ciclo di vita del bucket

(GetBucketLifecycleConfiguration)

Questa operazione restituisce la configurazione del ciclo di vita del bucket. Vedere "Creare la configurazione del ciclo di vita S3".

OTTIENI posizione bucket

Questa operazione restituisce la regione impostata utilizzando LocationConstraint Elemento nella richiesta PUT bucket. Se l'area del bucket è us-east-1, viene restituita una stringa vuota per la regione.

OTTIENI notifica bucket

(GetBucketNotificationConfiguration)

Questa operazione restituisce la configurazione di notifica allegata al bucket.

OTTIENI la policy bucket

Questa operazione restituisce la policy allegata al bucket.

OTTIENI la replica bucket

Questa operazione restituisce la configurazione di replica collegata al bucket.

OTTIENI il contrassegno bucket

Questa operazione utilizza tagging sottorisorsa per restituire tutti i tag per un bucket.

SCARICA la versione di bucket

Questa implementazione utilizza versioning sottorisorsa per restituire lo stato di versione di un bucket.

  • Blank: Il controllo delle versioni non è mai stato abilitato (bucket “Unversioned”)

  • Enabled (attivato): Il controllo delle versioni è attivato

  • Suspended (sospeso): Il controllo delle versioni era stato precedentemente attivato e sospeso

OTTIENI configurazione blocco oggetto

Questa operazione restituisce la modalità di conservazione predefinita del bucket e il periodo di conservazione predefinito, se configurato.

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

BENNA PER LA TESTA

Questa operazione determina se esiste un bucket e se si dispone dell'autorizzazione per accedervi.

Questa operazione restituisce:

  • x-ntap-sg-bucket-id: UUID del bucket in formato UUID.

  • x-ntap-sg-trace-id: L'ID di traccia univoco della richiesta associata.

METTI bucket

Questa operazione crea un nuovo bucket. Creando il bucket, diventerai il proprietario del bucket.

  • I nomi dei bucket devono rispettare le seguenti regole:

    • Deve essere unico in ogni sistema StorageGRID (non solo univoco all'interno dell'account tenant).

    • Deve essere conforme al DNS.

    • Deve contenere almeno 3 e non più di 63 caratteri.

    • Può essere una serie di una o più etichette, con etichette adiacenti separate da un punto. Ogni etichetta deve iniziare e terminare con una lettera minuscola o un numero e può utilizzare solo lettere minuscole, numeri e trattini.

    • Non deve essere simile a un indirizzo IP formattato con testo.

    • Non utilizzare i periodi nelle richieste di stile ospitate virtuali. I punti causano problemi con la verifica del certificato con caratteri jolly del server.

  • Per impostazione predefinita, i bucket vengono creati in us-east-1 regione; tuttavia, è possibile utilizzare LocationConstraint elemento di richiesta nel corpo della richiesta per specificare un'area diversa. Quando si utilizza LocationConstraint È necessario specificare il nome esatto di una regione definita utilizzando Grid Manager o l'API Grid Management. Contattare l'amministratore di sistema se non si conosce il nome della regione da utilizzare.

    Nota: Si verifica un errore se la richiesta PUT bucket utilizza un'area non definita in StorageGRID.

  • È possibile includere x-amz-bucket-object-lock-enabled Richiedi intestazione per creare un bucket con blocco oggetti S3 attivato. Vedere "Utilizzare l'API REST S3 per configurare il blocco oggetti S3".

    È necessario attivare il blocco oggetti S3 quando si crea il bucket. Non puoi aggiungere o disattivare il blocco oggetti S3 dopo la creazione di un bucket. S3 Object Lock richiede il controllo della versione del bucket, che viene attivato automaticamente quando si crea il bucket.

METTI cors bucket

Questa operazione imposta la configurazione del CORS per un bucket in modo che il bucket possa gestire le richieste di origine incrociata. La condivisione delle risorse tra origini (CORS) è un meccanismo di sicurezza che consente alle applicazioni Web client di un dominio di accedere alle risorse di un dominio diverso. Si supponga, ad esempio, di utilizzare un bucket S3 denominato images per memorizzare le immagini. Impostando la configurazione CORS per images bucket, è possibile consentire la visualizzazione delle immagini in quel bucket sul sito web http://www.example.com.

METTI la crittografia bucket

Questa operazione imposta lo stato di crittografia predefinito di un bucket esistente. Quando la crittografia a livello di bucket è attivata, tutti i nuovi oggetti aggiunti al bucket vengono crittografati.StorageGRID supporta la crittografia lato server con le chiavi gestite da StorageGRID. Quando si specifica la regola di configurazione della crittografia lato server, impostare SSEAlgorithm parametro a. AES256`e non utilizzare `KMSMasterKeyID parametro.

La configurazione della crittografia predefinita del bucket viene ignorata se la richiesta di caricamento degli oggetti specifica già la crittografia, ovvero se la richiesta include x-amz-server-side-encryption-* intestazione della richiesta).

METTI IL ciclo di vita del bucket

(PutBucketLifecycleConfiguration)

Questa operazione crea una nuova configurazione del ciclo di vita per il bucket o sostituisce una configurazione del ciclo di vita esistente. StorageGRID supporta fino a 1,000 regole del ciclo di vita in una configurazione del ciclo di vita. Ogni regola può includere i seguenti elementi XML:

  • Scadenza (giorni, data)

  • Non currentVersionExpiration (non currentDays)

  • Filtro (prefisso, tag)

  • Stato

  • ID

StorageGRID non supporta queste azioni:

  • AbortIncompleteMultipartUpload

  • ExpiredObjectDeleteMarker

  • Transizione

Vedere "Creare la configurazione del ciclo di vita S3". Per comprendere come l'azione di scadenza in un ciclo di vita del bucket interagisce con le istruzioni di posizionamento ILM, vedere "Come ILM opera per tutta la vita di un oggetto".

Nota: La configurazione del ciclo di vita del bucket può essere utilizzata con bucket con blocco oggetti S3 attivato, ma la configurazione del ciclo di vita del bucket non è supportata per bucket conformi legacy.

NOTIFICA DEL bucket

(PutBucketNotificationConfiguration)

Questa operazione configura le notifiche per il bucket utilizzando l'XML di configurazione delle notifiche incluso nel corpo della richiesta. È necessario conoscere i seguenti dettagli di implementazione:

  • StorageGRID supporta gli argomenti del servizio di notifica semplice (SNS) come destinazioni. Gli endpoint SQS (Simple Queue Service) o Amazon Lambda non sono supportati.

  • La destinazione delle notifiche deve essere specificata come URN di un endpoint StorageGRID. Gli endpoint possono essere creati utilizzando il tenant Manager o l'API di gestione tenant.

    L'endpoint deve esistere perché la configurazione della notifica abbia esito positivo. Se l'endpoint non esiste, un 400 Bad Request viene restituito un errore con il codice InvalidArgument.

  • Non è possibile configurare una notifica per i seguenti tipi di evento. Questi tipi di evento sono non supportati.

    • s3:ReducedRedundancyLostObject

    • s3:ObjectRestore:Completed

  • Le notifiche degli eventi inviate da StorageGRID utilizzano il formato JSON standard, ad eccezione del fatto che non includono alcune chiavi e utilizzano valori specifici per altre, come mostrato nell'elenco seguente:

    • EventSource

      sgws:s3

    • AwsRegion

      non incluso

    • x-amz-id-2

      non incluso

    • arn

      urn:sgws:s3:::bucket_name

METTI la policy bucket

Questa operazione imposta la policy associata al bucket.

METTI la replica del bucket

Questa operazione viene configurata "Replica di StorageGRID CloudMirror" Per il bucket che utilizza l'XML di configurazione della replica fornito nel corpo della richiesta. Per la replica di CloudMirror, è necessario conoscere i seguenti dettagli di implementazione:

  • StorageGRID supporta solo V1 della configurazione di replica. Ciò significa che StorageGRID non supporta l'utilizzo di Filter Per le regole e segue le convenzioni V1 per l'eliminazione delle versioni degli oggetti. Per ulteriori informazioni, vedere "Documentazione di Amazon S3 sulla configurazione della replica".

  • La replica del bucket può essere configurata su bucket con versione o senza versione.

  • È possibile specificare un bucket di destinazione diverso in ciascuna regola dell'XML di configurazione della replica. Un bucket di origine può replicare in più di un bucket di destinazione.

  • I bucket di destinazione devono essere specificati come URN degli endpoint StorageGRID, come specificato in Gestione tenant o nell'API di gestione tenant. Vedere "Configurare la replica di CloudMirror".

    L'endpoint deve esistere per il successo della configurazione della replica. Se l'endpoint non esiste, la richiesta fallisce come a. 400 Bad Request. Il messaggio di errore indica: Unable to save the replication policy. The specified endpoint URN does not exist: URN.

  • Non è necessario specificare un Role Nel file XML di configurazione. Questo valore non viene utilizzato da StorageGRID e verrà ignorato se inviato.

  • Se si omette la classe di storage dall'XML di configurazione, StorageGRID utilizza STANDARD classe di storage per impostazione predefinita.

  • Se si elimina un oggetto dal bucket di origine o si elimina lo stesso bucket di origine, il comportamento della replica tra regioni è il seguente:

    • Se si elimina l'oggetto o il bucket prima che sia stato replicato, l'oggetto/bucket non viene replicato e non viene inviata alcuna notifica.

    • Se elimini l'oggetto o il bucket dopo che è stato replicato, StorageGRID segue il comportamento standard di eliminazione di Amazon S3 per V1 della replica tra regioni.

INSERIRE il contrassegno bucket

Questa operazione utilizza tagging sottorisorsa per aggiungere o aggiornare un set di tag per un bucket. Quando si aggiungono tag bucket, tenere presente le seguenti limitazioni:

  • StorageGRID e Amazon S3 supportano fino a 50 tag per ciascun bucket.

  • Le etichette associate a un bucket devono avere chiavi tag univoche. Una chiave tag può contenere fino a 128 caratteri Unicode.

  • I valori dei tag possono contenere fino a 256 caratteri Unicode.

  • Chiave e valori distinguono tra maiuscole e minuscole.

METTERE il bucket in versione

Questa implementazione utilizza versioning sottorisorsa per impostare lo stato di versione di un bucket esistente. È possibile impostare lo stato di versione con uno dei seguenti valori:

  • Enabled (attivato): Attiva il controllo delle versioni degli oggetti nel bucket. Tutti gli oggetti aggiunti al bucket ricevono un ID di versione univoco.

  • Suspended (sospeso): Disattiva il controllo delle versioni degli oggetti nel bucket. Tutti gli oggetti aggiunti al bucket ricevono l'ID versione null.

PUT Object Lock Configuration (CONFIGURAZIONE blocco oggetto)

Questa operazione consente di configurare o rimuovere la modalità di conservazione predefinita del bucket e il periodo di conservazione predefinito.

Se il periodo di conservazione predefinito viene modificato, la data di conservazione delle versioni degli oggetti esistenti rimane invariata e non viene ricalcolata utilizzando il nuovo periodo di conservazione predefinito.

Vedere "Utilizzare l'API REST S3 per configurare il blocco oggetti S3" per informazioni dettagliate.
Informazioni correlate

"Controlli di coerenza"

"OTTIENI l'ultimo tempo di accesso a bucket"

"Utilizza policy di accesso a bucket e gruppi"

"Operazioni S3 monitorate nei registri di audit"