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 ListObjects (GET Bucket) e ListObjectVersions (GET Bucket Object Versions) supportano StorageGRID "valori di coerenza".

È possibile verificare se gli aggiornamenti dell'ultimo tempo di accesso sono attivati o disattivati per i singoli bucket. Vedere "OTTIENI l'ultimo tempo di accesso a 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

CreateBucket

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 CreateBucket utilizza una regione 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.

DeleteBucket

Elimina il bucket.

DeleteBucketCors

Elimina la configurazione CORS per il bucket.

DeleteBucketEncryption

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

DeleteBucketLifecycle

Elimina la configurazione del ciclo di vita dal bucket. Vedere "Creare la configurazione del ciclo di vita S3".

DeleteBucketPolicy

Elimina il criterio allegato al bucket.

DeleteBucketReplication

Elimina la configurazione di replica collegata al bucket.

DeleteBucketTagging

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

Attenzione: Se per questo bucket è impostato un tag di criterio ILM non predefinito, verrà visualizzato un NTAP-SG-ILM-BUCKET-TAG tag bucket a cui è stato assegnato un valore. Non inviare una richiesta DeleteBucketTagging se è presente un NTAP-SG-ILM-BUCKET-TAG etichetta benna. Al contrario, eseguire una richiesta PutBucketTagging solo con NTAP-SG-ILM-BUCKET-TAG tag e il relativo valore assegnato per rimuovere tutti gli altri tag dal bucket. Non modificare o rimuovere NTAP-SG-ILM-BUCKET-TAG etichetta benna.

GetBucketAcl

Restituisce una risposta positiva e l'ID, il DisplayName e l'autorizzazione del proprietario del bucket, indicando che il proprietario ha accesso completo al bucket.

GetBucketCors

Restituisce il cors configurazione per il bucket.

GetBucketEncryption

Restituisce la configurazione di crittografia predefinita per il bucket.

GetBucketLifecycleConfiguration

(Precedentemente denominato ciclo di vita GET Bucket)

Restituisce la configurazione del ciclo di vita per il bucket. Vedere "Creare la configurazione del ciclo di vita S3".

GetBucketLocation

Restituisce la regione impostata mediante LocationConstraint Elemento nella richiesta CreateBucket. Se l'area del bucket è us-east-1, viene restituita una stringa vuota per la regione.

GetBucketNotificationConfiguration

(In precedenza denominato notifica GET Bucket)

Restituisce la configurazione di notifica collegata al bucket.

GetBucketPolicy

Restituisce la policy allegata al bucket.

GetBucketReplication

Restituisce la configurazione di replica collegata al bucket.

GetBucketTagging

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

Attenzione: Se per questo bucket è impostato un tag di criterio ILM non predefinito, verrà visualizzato un NTAP-SG-ILM-BUCKET-TAG tag bucket a cui è stato assegnato un valore. Non modificare o rimuovere questo tag.

GetBucketVersioning

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

  • Blank: La versione non è mai stata abilitata (bucket "Unversioned")

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

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

GetObjectLockConfiguration

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".

HeadBucket

Determina se esiste un bucket e 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.

ListObjects e ListObjectsV2

(Precedentemente denominato GET Bucket)

Restituisce alcuni o tutti gli oggetti (fino a 1.000) 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.

ListObjectVersions

(Precedentemente denominate versioni oggetto GET Bucket)

Con accesso di LETTURA su una benna, utilizzando questa operazione con versions la sottorisorsa elenca i metadati di tutte le versioni degli oggetti nel bucket.

PutBucketCors

Imposta la configurazione CORS per un bucket in modo che il bucket possa gestire le richieste cross-origin. 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.

PutBucketEncryption

Consente di impostare 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).

PutBucketLifecycleConfiguration

(Precedentemente denominato ciclo di vita bucket PUT)

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, ExpiredObjectDeleteMarker)

  • NoncurrentVersionExpiration (NewerNoncurrentVersions, NoncurrentDays)

  • Filtro (prefisso, tag)

  • Stato

  • ID

StorageGRID non supporta queste azioni:

  • AbortIncompleteMultipartUpload

  • 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.

PutBucketNotificationConfiguration

(Precedentemente denominata notifica bucket PUT)

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 di Amazon Simple Notification Service (Amazon SNS) o Kafka 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

PutBucketPolicy

Imposta il criterio associato al bucket. Vedere "Utilizza policy di accesso a bucket e gruppi".

PutBucketReplication

Configura "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 "Guida utente di Amazon Simple Storage Service: 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.

PutBucketTagging

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.

Attenzione: Se per questo bucket è impostato un tag di criterio ILM non predefinito, verrà visualizzato un NTAP-SG-ILM-BUCKET-TAG tag bucket a cui è stato assegnato un valore. Assicurarsi che il NTAP-SG-ILM-BUCKET-TAG Il tag bucket è incluso con il valore assegnato in tutte le richieste PutBucketTagging. Non modificare o rimuovere questo tag.

Nota: Questa operazione sovrascriverà tutti i tag correnti già presenti nel bucket. Se qualsiasi tag esistente viene omesso dal set, tali tag verranno rimossi per il bucket.

PutBucketVersioning

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.

PutObjectLockConfiguration

Configura o rimuove 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.