Documentazione di Oracle Cloud Infrastructure

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.
    2. Selezionare Crea bucket.
    3. Immettere le informazioni riportate di seguito.

      • Nome periodo fisso: il sistema genera un nome periodo fisso predefinito che riflette l'anno, il mese, il giorno e l'ora correnti, ad esempio periodo fisso-2019030620230306-1359. Se si modifica questo valore predefinito in qualsiasi altro nome bucket, utilizzare lettere, numeri, lineette, caratteri di sottolineatura e punti. Evitare di fornire informazioni riservate.

      • Livello di memorizzazione predefinito: selezionare il livello predefinito in cui si desidera memorizzare i dati. Quando si caricano gli oggetti, gli oggetti vengono assegnati e caricati automaticamente a questo livello.

        • Standard è il livello di storage primario predefinito utilizzato per i dati del servizio 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 diversi livelli di storage (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, consulta la sezione relativa ai livelli di storage degli oggetti.

      • Abilita gestione automatica dei livelli: selezionare questa opzione se si desidera che lo storage degli oggetti controlli e sposti automaticamente gli oggetti ad accesso non frequente dal livello Standard al livello di storage ad accesso non frequente meno costoso. Per ulteriori informazioni, vedere Gestione automatica dei livelli.

      • Abilita controllo delle versioni oggetto: selezionare questa opzione se si desidera che lo storage degli oggetti crei 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: selezionare questa opzione se si desidera consentire al bucket di emettere eventi per le modifiche dello stato degli oggetti. Per ulteriori informazioni sugli eventi, vedere Panoramica degli eventi.

      • Cleanup caricamenti multiparte senza commit: selezionare questa opzione per creare una regola del ciclo di vita che elimini automaticamente tutti i caricamenti multiparte senza commit dopo 7 giorni.

      • Cifratura: i bucket vengono cifrati con chiavi gestite da Oracle per impostazione predefinita, ma è possibile cifrare facoltativamente i dati in questo bucket utilizzando la propria chiave di cifratura del vault. Selezionare Cifra mediante chiavi gestite dal cliente, quindi selezionare il compartimento vault e il vault contenenti la chiave di cifratura master che si desidera utilizzare. Selezionare anche il compartimento e la chiave di cifratura master. Per ulteriori informazioni sulla cifratura, vedere Panoramica del vault. Per i dettagli su come creare un vault, vedere Gestione dei vault.

      • Tag: 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 le tag, saltare questa opzione (è possibile applicare le tag in un secondo momento) o chiedere all'amministratore.

    4. Selezionare Crea.

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

    Creazione di un bucket del 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"
}

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

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

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

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