Creazione di un bucket di storage a oggetti

Creare un bucket di storage degli oggetti per memorizzare gli oggetti.

Per informazioni sulle autorizzazioni necessarie per creare un bucket nello storage degli oggetti, vedere Criterio IAM obbligatorio.

1. Nella pagina della lista Bucket selezionare Crea bucket. Per assistenza nella ricerca della pagina della lista, vedere Elenco dei bucket di storage degli oggetti.
  Viene visualizzato il pannello Crea bucket.
2. Immettere le informazioni riportate di seguito.
  
  Nome periodo fisso: il sistema genera un nome di periodo fisso predefinito che riflette l'anno, il mese, il giorno e l'ora correnti, ad esempio bucket-2019030620230306-1359. Se si imposta questo valore predefinito su qualsiasi altro nome di bucket, utilizzare lettere, numeri, lineette, caratteri di sottolineatura e punti. Evitare di fornire informazioni riservate.
  
  Livello di storage predefinito: selezionare il livello predefinito in cui si desidera memorizzare i dati. Quando si caricano gli oggetti, gli oggetti vengono assegnati e caricati automaticamente in questo livello.
  
  Standard è il livello di storage primario predefinito utilizzato per i dati del servizio di storage degli oggetti. Utilizzare questo livello per memorizzare i dati che richiedono un accesso rapido e immediato. Tuttavia, i bucket standard offrono un'opzione per assegnare e caricare oggetti a livelli di storage diversi (accesso e archiviazione non frequenti) pur rimanendo nel bucket standard.
  
  Archivio è il livello di storage predefinito utilizzato per i dati di storage di archivio. Utilizzare il livello Archivia per memorizzare i dati che richiedono lunghi periodi di conservazione, ma non l'accesso immediato. I dati archiviati devono essere ripristinati prima che i dati siano accessibili.
  
  Per ulteriori informazioni, vedere Livelli di storage degli oggetti.
  
  Abilita auto-tiering: abilitare questa opzione per monitorare e spostare automaticamente gli oggetti ad accesso non frequente dal livello Standard al livello di storage ad accesso non frequente meno costoso. Per ulteriori informazioni, vedere Tiering automatico.
  
  Abilita controllo delle versioni dell'oggetto: abilitare questa opzione per creare una versione dell'oggetto ogni volta che il contenuto viene modificato o l'oggetto viene eliminato. Per ulteriori informazioni, vedere Controllo delle versioni dello storage degli oggetti.
  
  Emetti eventi oggetto: abilitare questa opzione per consentire al bucket di emettere eventi per le modifiche allo stato dell'oggetto. Per ulteriori informazioni sugli eventi, vedere Panoramica degli eventi.
  
  Cleanup dei caricamenti multiparte non sottoposti a commit: abilitare questa opzione per creare una regola del ciclo di vita che elimini automaticamente tutti i caricamenti multiparte di cui non è stato eseguito il commit dopo 7 giorni.
  
  Cifratura: selezionare una delle seguenti opzioni di chiave di cifratura:
  
  Cifrare utilizzando chiavi gestite da Oracle: selezionare questa opzione per cifrare il bucket utilizzando chiavi gestite da Oracle.
  
  Cifra utilizzando chiavi gestite dal cliente: selezionare questa opzione per cifrare il bucket con chiavi personalizzate. Selezionare il compartimento vault e il vault contenenti la chiave di cifratura master che si desidera utilizzare. Selezionare anche il compartimento della chiave di cifratura primaria e la chiave di cifratura primaria.
  
  Per ulteriori informazioni sulla cifratura, vedere Panoramica del vault. Per informazioni dettagliate su come creare un vault, vedere Gestione dei vault.
Tag

Aggiungi tag: selezionare questa opzione se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare tag in formato libero a tale risorsa. Per applicare una tag definita, è necessario disporre delle autorizzazioni per utilizzare lo spazio di nomi tag.

Per ulteriori informazioni sull'applicazione di tag, vedere Panoramica sull'applicazione di tag. Se non si è certi di applicare i tag, saltare questa opzione (è possibile applicare i tag in seguito) o chiedere all'amministratore.

Log delle risorse

Abilita per consentire il monitoraggio, la risoluzione dei problemi e gli approfondimenti sui dati del bucket di storage degli oggetti che stai creando.

Selezionare Crea bucket.

Il bucket viene creato immediatamente ed è possibile iniziare a caricarvi oggetti. Gli oggetti aggiunti ai bucket di archivio vengono immediatamente archiviati e devono essere ripristinati prima di essere disponibili per il download.

Creazione di un bucket livello di storage predefinito standard

Per impostazione predefinita, un bucket viene creato nel livello di storage degli oggetti standard. Non è necessario impostare in modo esplicito --storage-tier. Standard è il livello di storage primario predefinito utilizzato per i dati del servizio Storage degli oggetti. Utilizzare il livello Standard per memorizzare i dati che richiedono un accesso rapido e immediato. Tuttavia, i bucket standard offrono un'opzione per assegnare e caricare oggetti a diversi livelli di storage (Accesso e archiviazione non frequenti), pur rimanendo nel bucket standard.

Utilizzare il comando oci os bucket create e i parametri necessari per creare un bucket:

oci os bucket create --compartment-id compartment_ocid --name bucket_name [OPTIONS]

Ad esempio:

oci os bucket create --compartment-id ocid.compartment.oc1..exampleuniqueID --name MyStandardBucket
{
  "data": {
    "approximate-count": null,
    "approximate-size": null,
    "auto-tiering": null,
    "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
    "created-by": "ocid1.user.oc1..exampleuniqueID",
    "defined-tags": {},
    "etag": "7b7c3dc1-713f-4996-b176-a938345cae8e",
    "freeform-tags": {},
    "id": "ocid1.bucket.oc1..exampleuniqueID",
    "is-read-only": false,
    "kms-key-id": null,
    "metadata": {},
    "name": "MyStandardBucket",
    "namespace": "MyNamespace",
    "object-events-enabled": false,
    "object-level-audit-mode": "Disabled",
    "object-lifecycle-policy-etag": null,
    "public-access-type": "NoPublicAccess",
    "replication-enabled": false,
    "storage-tier": "Standard",
    "time-created": "2020-06-12T19:04:05.879000+00:00",
    "versioning": "Disabled"
  },
  "etag": "7b7c3dc1-713f-4996-b176-a938345cae8e"
}

È inoltre possibile abilitare la gestione automatica dei livelli in un bucket standard al momento della creazione specificando il parametro --auto-tiering InfrequentAccess facoltativo. Per i dettagli, vedere Gestione automatica dei livelli. Ad esempio:

oci os bucket create --compartment-id ocid.compartment.oc1..exampleuniqueID --name MyStandardBucket --auto-tiering Infrequent Access
{
  "data": {
    "approximate-count": null,
    "approximate-size": null,
    "auto-tiering": "InfrequentAccess",
    "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
    "created-by": "ocid1.user.oc1..exampleuniqueID",
    "defined-tags": {},
    "etag": "7b7c3dc1-713f-4996-b176-a938345cae8e",
    "freeform-tags": {},
    "id": "ocid1.bucket.oc1..exampleuniqueID",
    "is-read-only": false,
    "kms-key-id": null,
    "metadata": {},
    "name": "MyStandardBucket",
    "namespace": "MyNamespace",
    "object-events-enabled": false,
    "object-level-audit-mode": "Disabled",
    "object-lifecycle-policy-etag": null,
    "public-access-type": "NoPublicAccess",
    "replication-enabled": false,
    "storage-tier": "Standard",
    "time-created": "2020-06-12T19:04:05.879000+00:00",
    "versioning": "Disabled"
  },
  "etag": "7b7c3dc1-713f-4996-b176-a938345cae8e"
}

Un bucket di livello standard viene creato immediatamente ed è possibile iniziare a caricare gli oggetti.

Per un elenco completo dei parametri e dei valori per i comandi CLI, consultare il manuale CLI Command Reference.

Creazione di un bucket livello di storage predefinito di archivio

Per creare un bucket di livello archivio, è necessario impostare in modo esplicito --storage-tier Archive. L'archivio è il livello di storage predefinito utilizzato per i dati del servizio Storage di archivio. Utilizzare il livello Archivia per memorizzare i dati che non richiedono l'accesso immediato, ma che richiedono lunghi periodi di conservazione. L'accesso ai dati nel livello di archiviazione non è immediato. I dati archiviati devono essere ripristinati prima di essere accessibili.

oci os bucket create --compartment-id compartment_ocid --name archive_bucket_name --storage-tier Archive [OPTIONS]

Ad esempio:

oci os bucket create --compartment-id ocid.compartment.oc1..exampleuniqueID --name MyArchiveBucket
{
  "data": {
    "approximate-count": null,
    "approximate-size": null,
    "auto-tiering": null,
    "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
    "created-by": "ocid1.user.oc1..exampleuniqueID",
    "defined-tags": {},
    "etag": "7b7c3dc1-713f-4996-b176-a938345cae8e",
    "freeform-tags": {},
    "id": "ocid1.bucket.oc1..exampleuniqueID",
    "is-read-only": false,
    "kms-key-id": null,
    "metadata": {},
    "name": "MyArchiveBucket",
    "namespace": "MyNamespace",
    "object-events-enabled": false,
    "object-level-audit-mode": "Disabled",
    "object-lifecycle-policy-etag": null,
    "public-access-type": "NoPublicAccess",
    "replication-enabled": false,
    "storage-tier": "Archive",
    "time-created": "2020-06-12T19:04:05.879000+00:00",
    "versioning": "Disabled"
  },
  "etag": "c8889cd1-8414-41fb-84b7-3738c39e62c5"
}

Viene creato un bucket di storage di archivio che puoi avviare caricando gli oggetti. Gli oggetti caricati nei bucket di storage di archivio vengono immediatamente archiviati e devono essere ripristinati prima di essere disponibili per il download.

Creazione di un bucket pubblico (lettura e download di oggetti bucket)

Per creare un bucket pubblico che consenta di elencare e scaricare gli oggetti bucket, è necessario impostare in modo esplicito --public-access-type ObjectRead.

oci os bucket create --compartment-id compartment_ocid --name bucket_name --public-access-type ObjectRead [OPTIONS]

Ad esempio:

oci os bucket create --compartment-id ocid.compartment.oc1..exampleuniqueID --name MyPublicObjectReadBucket --public-access-type ObjectRead
{
  "data": {
    "approximate-count": null,
    "approximate-size": null,
    "auto-tiering": null,
    "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
    "created-by": "ocid1.user.oc1..exampleuniqueID",
    "defined-tags": {},
    "etag": "01096e0b-659a-4d9d-a806-d57568cf1b22",
    "freeform-tags": {},
    "id": "ocid1.bucket.oc1..exampleuniqueID",
    "is-read-only": false,
    "kms-key-id": null,
    "metadata": {},
    "name": "MyPublicObjectReadBucket",
    "namespace": "MyNamespace",
    "object-events-enabled": false,					
    "object-lifecycle-policy-etag": null,
    "public-access-type": "ObjectRead",
    "replication-enabled": false,
    "storage-tier": "Standard",
    "time-created": "2020-06-22T19:04:05.879000+00:00",
    "versioning": "Disabled"
  },
  "etag": "01096e0b-659a-4d9d-a806-d57568cf1b22"
}

Creazione di un bucket pubblico (scaricamento degli oggetti bucket)

Per creare un bucket pubblico che consenta solo il download degli oggetti bucket, è necessario impostare in modo esplicito --public-access-type ObjectReadWithoutList.

oci os bucket create --compartment-id compartment_ocid --name bucket_name --public-access-type ObjectReadWithoutList [OPTIONS]

Ad esempio:

oci os bucket create --compartment-id ocid.compartment.oc1..exampleuniqueID --name MyPublicObjectReadBucket --public-access-type ObjectReadWithoutList
{
  "data": {
    "approximate-count": null,
    "approximate-size": null,
    "auto-tiering": null,
    "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
    "created-by": "ocid1.user.oc1..exampleuniqueID",
    "defined-tags": {},
    "etag": "ec20c59a-f5ba-4a6d-8a7e-b69bb9bb76ad",
    "freeform-tags": {},
    "id": "ocid1.bucket.oc1..exampleuniqueID",
    "is-read-only": false,
    "kms-key-id": null,
    "metadata": {},
    "name": "MyPublicObjectReadWithoutListBucket",
    "namespace": "MyNamespace",
    "object-events-enabled": false,
    "object-lifecycle-policy-etag": null,
    "public-access-type": "ObjectReadWithoutList",
    "replication-enabled": false,
    "storage-tier": "Standard",
    "time-created": "2020-06-22T20:18:29.203000+00:00",
    "versioning": "Disabled"
  },
  "etag": "ec20c59a-f5ba-4a6d-8a7e-b69bb9bb76ad"
}

Creazione di un bucket con tag risorsa

È possibile creare un livello di storage degli oggetti standard o bucket di livello Archivia con tag delle risorse.

Per aggiungere tag risorsa durante la creazione di un bucket, impostare una o entrambe le opzioni --defined-tags e --freeform-tags.

Suggerimento

Le opzioni --defined-tags e --freeform-tags richiedono che l'input sia un tipo complesso formattato in un formato JSON valido. Per informazioni sulla formattazione JSON, vedere Passaggio dell'input complesso e Utilizzo di un file JSON per l'input complesso.

La sintassi di esempio riportata di seguito crea un bucket di livello di storage degli oggetti standard con una tag definita:

oci os bucket create --compartment-id compartment_id --name bucket_name --defined-tags 'JSON_formatted_defined_tag'  [OPTIONS]

Esempi di formattazione tag definita:

'{"Operations": {"CostCenter": "42"}'

'{"Logistics": {"Procurement": "Madrid Center"}},"Financials":{"Production": "Unit 5"}}'

Nota

Se si esegue l'interfaccia CLI su un computer Windows, potrebbe essere necessario utilizzare il carattere barra rovesciata (\) per eseguire l'escape delle stringhe contenenti i valori dei tag. Ad esempio, un singolo tag definito viene formattato '{\"Logistics\": {\"Procurement\": \"Madrid Center\"}}'

Ad esempio:

oci os bucket create --compartment-id ocid.compartment.oc1..exampleuniqueID --name MyBucketDefined --defined-tags {"Operations": {"CostCenter": "42"}}
{
  "data": {
    "approximate-count": null,
    "approximate-size": null,
    "auto-tiering": null,
    "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
    "created-by": "ocid1.user.oc1..exampleuniqueID",
    "defined-tags": {
      "operations": {
        "costcenter": "42"				}
    },
    "etag": "ea88f444-842c-462d-965e-d3540b3b54f6",
    "freeform-tags": {},
    "id": "ocid1.bucket.oc1..exampleuniqueID",
    "is-read-only": false,
    "kms-key-id": null,
    "metadata": {},
    "name": "MyBucketDefined",
    "namespace": "MyNamespace",
    "object-events-enabled": false,					
    "object-lifecycle-policy-etag": null,
    "public-access-type": "NoPublicAccess",
    "replication-enabled": false,
    "storage-tier": "Standard",
    "time-created": "2020-06-23T19:47:51.362000+00:00",
    "versioning": "Disabled"
  },
  "etag": "ea88f444-842c-462d-965e-d3540b3b54f6"
}

La seguente sintassi di esempio crea un bucket di livello standard con un tag in formato libero:

oci os bucket create --compartment-id compartment_ocid --name bucket_name --freeform-tags JSON_formatted_free-form_tag [OPTIONS]

Esempi di formattazione dei tag in formato libero:

'{"Chicago_Team": "marketing_videos"}'

'{"Project": "prototype 3","Manager": "Meadows"}'

Nota

Se si esegue l'interfaccia CLI su un computer Windows, potrebbe essere necessario utilizzare il carattere barra rovesciata (\) per eseguire l'escape delle stringhe contenenti i valori dei tag. Ad esempio, un singolo tag in formato libero viene formattato come '{\"Chicago_Team\": {\"marketing_videos\"}}'

Ad esempio:

oci os bucket create --compartment-id ocid.compartment.oc1..exampleuniqueID --name MyBucketFreeform --freeform-tags {"Chicago_Team": "marketing_videos"}
{
  "data": {
    "approximate-count": null,
    "approximate-size": null,
    "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
    "created-by": "ocid1.user.oc1..exampleuniqueID",
    "defined-tags": {},
    "etag": "6f4bda10-fc8b-462e-8563-875639fd7294",
    "freeform-tags": {
      "Chicago_Team": "marketing_videos"
    },
    "is-read-only": false,
    "id": "ocid1.bucket.oc1..exampleuniqueID",
    "kms-key-id": null,
    "metadata": {},
    "name": "MyBucketFreeform",
    "namespace": "MyNamespace",
    "object-events-enabled": false,					
    "object-lifecycle-policy-etag": null,
    "public-access-type": "NoPublicAccess",
    "storage-tier": "Standard",
    "time-created": "2020-06-23T20:51:16.260000+00:00"
  },
  "etag": "6f4bda10-fc8b-462e-8563-875639fd7294"
}

Assegnazione di una chiave al bucket

È possibile assegnare una chiave vault a un bucket che si sta creando includendo il parametro kms_key_id.

oci os bucket create --compartment-id ocid.compartment.oc1..exampleuniqueID --name bucket_name --kms-key-id kms_key_id [OPTIONS]

dove kms_key_id è l'OCID delle versioni della chiave che contengono il materiale di cifratura utilizzato per cifrare e decifrare i dati, proteggendo i dati in cui sono memorizzati i dati.

Ad esempio:


oci os bucket create --compartment-id ocid.compartment.oc1..exampleuniqueID --name MyKeyBucket --kms-key-id ocid1.key.region1.sea..exampleuniqueID
{
  "data": {
    "approximate-count": null,
    "approximate-size": null,
    "auto-tiering": null,
    "compartment-id": "ocid.compartment.oc1..exampleuniqueID",
    "created-by": "ocid1.user.oc1..exampleuniqueID",
    "defined-tags": {},
    "etag": "e7f29fdd-b5f5-42e5-a98b-80883f9f2f32",
    "freeform-tags": {},
    "id": "ocid1.bucket.oc1..exampleuniqueID",
    "is-read-only": false,
    "kms-key-id": "ocid1.key.region1.sea..exampleuniqueID",
    "metadata": {},
    "name": "MyKeyBucket",
    "namespace": "MyNamespace",
    "object-events-enabled": false,					
    "object-lifecycle-policy-etag": null,
    "public-access-type": "NoPublicAccess"
    "replication-enabled": false,
    "storage-tier": "Standard",
    "time-created": "2020-06-29T23:00:35.490000+00:00",
    "versioning": "Disabled"
  },
  "etag": "e7f29fdd-b5f5-42e5-a98b-80883f9f2f32"
}

Eseguire l'operazione CreateBucket per creare un bucket.

Quando si accede all'API di storage degli oggetti, il nome del bucket viene utilizzato con il nome dello spazio di nomi dello storage degli oggetti per formare l'URL della richiesta:
```
n/object_storage_namespace/b/bucket
```
Di seguito sono riportate due proprietà chiave nel payload.
- La proprietà publicAccessType controlla se il bucket è privato o pubblico e limita la capacità di elencare i contenuti del bucket pubblico.
- La proprietà objectEventsEnabled controlla se vengono emessi eventi per gli oggetti in questo bucket.

Documentazione di Oracle Cloud Infrastructure

Creazione di un bucket di storage a oggetti

Tag

Log delle risorse

Creazione di un bucket livello di storage predefinito standard

Creazione di un bucket livello di storage predefinito di archivio

Creazione di un bucket pubblico (lettura e download di oggetti bucket)

Creazione di un bucket pubblico (scaricamento degli oggetti bucket)

Creazione di un bucket con tag risorsa

Assegnazione di una chiave al bucket