Création d'un bucket Object Storage

Créez un bucket Object Storage pour stocker des objets.

Pour plus d'informations sur les droits d'accès requis permettant de créer un bucket dans Object Storage, reportez-vous à Stratégie IAM requise.

1. Sur la page de liste Buckets, sélectionnez Créer un bucket. Si vous avez besoin d'aide pour trouver la page de liste, reportez-vous à Liste des buckets Object Storage.
  Le panneau Créer un bucket s'ouvre.
2. Saisissez les informations suivantes:
  
  Nom du bucket : le système génère un nom de bucket par défaut qui reflète l'année, le mois, le jour et l'heure en cours, par exemple bucket-2019030620230306-1359. Si vous modifiez cette valeur par défaut en utilisant un autre nom de bucket, utilisez des lettres, des chiffres, des tirets, des traits de soulignement et des points. Evitez de saisir des informations confidentielles.
  
  Niveau de mémoire par défaut : sélectionnez le niveau de stockage par défaut auquel stocker les données. Lorsque vous téléchargez un objet, celui-ci est automatiquement affecté à ce niveau et téléchargé vers celui-ci.
  
  Standard est le premier niveau de stockage par défaut utilisé pour les données de service Object Storage. Utilisez ce niveau pour stocker des données nécessitant un accès rapide et immédiat. Les buckets Standard proposent toutefois une option permettant d'affecter les objets à différents niveaux de stockage (Accès rare et Archive) et de le télécharger vers les niveaux de stockage, tout en restant dans le bucket Standard.
  
  Archive : niveau de stockage par défaut utilisé pour les données Archive Storage. Utilisez le niveau Archive pour stocker les données qui nécessitent de longues périodes de conservation, mais pas d'accès immédiat. Les données archivées doivent être restaurées pour être accessibles.
  
  Pour plus d'informations, reportez-vous à Niveaux Object Storage.
  
  Activer la gestion des niveaux automatique : activez cette option pour surveiller et déplacer automatiquement les objets auxquels on accède rarement du niveau Standard vers le niveau moins coûteux de stockage Accès rare. Pour plus d'informations, reportez-vous à la rubrique Niveau automatique.
  
  Activer la gestion des versions d'objet : activez cette option pour créer une version d'objet à chaque fois que le contenu est modifié ou que l'objet est supprimé. Pour plus d'informations, reportez-vous à Gestion des versions Object Storage.
  
  Emettre des événements d'objet : activez cette option pour autoriser le bucket à émettre des événements pour les modifications d'état d'objet. Pour plus d'informations sur les événements, reportez-vous à Présentation d'Events.
  
  Nettoyage des téléchargements multipart Non validés : activez cette option pour créer une règle de cycle de vie qui supprime automatiquement tous les téléchargements multipart non validés après 7 jours.
  
  Cryptage : sélectionnez l'une des options de clé de cryptage suivantes :
  
  Crypter à l'aide de clés gérées par Oracle : sélectionnez cette option pour crypter le bucket à l'aide de clés gérées par Oracle.
  
  Crypter à l'aide de clés gérées par le client : sélectionnez cette option pour crypter le bucket avec vos propres clés. Sélectionnez le compartiment de coffre et le coffre qui contiennent la clé de cryptage maître à utiliser. Sélectionnez également le compartiment et la clé de cryptage maîtres de la clé de cryptage principale.
  
  Pour plus d'informations sur le cryptage, reportez-vous à Présentation de Vault. Pour plus de détails sur la création d'un coffre, reportez-vous à Gestion des coffres.
Balises

Ajouter des balises : sélectionnez cette option si vous disposez des droits d'accès permettant de créer une ressource, vous disposez également des droits d'accès permettant d'appliquer des balises à format libre à cette ressource. Pour appliquer une balise définie, vous devez disposer de droits d'accès permettant d'utiliser l'espace de noms de balise.

Pour plus d'informations sur le balisage, reportez-vous à Présentation de Tagging. Si vous n'avez pas certain de devoir appliquer des balises, ignorez cette option (vous pouvez les appliquer ultérieurement) ou demandez-le à l'administrateur.

Journalisation de ressource

Activer pour permettre le suivi, le dépannage et les informations clés sur les données du bucket Object Storage que vous créez.

Sélectionnez Créer un bucket.

Le bucket a été créé immédiatement et vous pouvez commencer à y télécharger des objets. Les objets ajoutés aux buckets d'archive sont immédiatement archivés et doivent être restaurés avant d'être disponibles pour téléchargement.

Création d'un compartiment de niveau de stockage par défaut standard

Par défaut, un bucket est créé dans le Niveau Object Storage standard. Vous n'avez pas besoin de définir explicitement --storage-tier. Standard est le premier niveau de stockage par défaut utilisé pour les données de service Object Storage. Utilisez le niveau Standard pour stocker les données qui nécessitent un accès rapide et immédiat. Les buckets Standard proposent toutefois une option permettant d'affecter les objets à différents niveaux de stockage (Accès rare et Archive) et de les télécharger vers ceux-ci, tout en restant dans le bucket Standard.

Utilisez la commande oci os bucket create et les paramètres requis pour créer un bucket :

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

Par exemple :

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

Vous pouvez également activer l'échelonnement automatique sur un bucket Standard lors de la création de ce dernier en indiquant le paramètre facultatif --auto-tiering InfrequentAccess. Pour obtenir des détails, reportez-vous à Niveau automatique. Par exemple :

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 de niveau Standard est créé immédiatement et vous pouvez commencer à télécharger des objets vers le serveur.

Pour obtenir la liste complète des paramètres et des valeurs des commandes de la CLI, reportez-vous à Référence des commandes de la CLI.

Création d'un compartiment de niveau de stockage par défaut Archive

Pour créer un bucket de niveau Archive, vous devez définir explicitement --storage-tier Archive. Archive : niveau de stockage par défaut utilisé pour les données du service Archive Storage. Utilisez le niveau Archive pour stocker les données qui ne nécessitent pas d'accès immédiat, mais qui nécessitent de longues périodes de conservation. L'accès aux données du niveau Archive n'est pas immédiat. Les données archivées doivent être restaurées pour être accessibles.

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

Par exemple :

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

Un bucket Archive Storage est créé et vous pouvez commencer à télécharger des objets vers le serveur. Les objets téléchargés vers les buckets Archive Storage sont immédiatement archivés et doivent être restaurés avant d'être disponibles pour téléchargement.

Création d'un bucket public (pour répertorier et télécharger des objets de bucket)

Pour créer un bucket public qui permet de répertorier et de télécharger les objets du bucket, vous devez définir explicitement --public-access-type ObjectRead.

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

Par exemple :

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

Création d'un bucket public (pour télécharger des objets de bucket)

Pour créer un bucket public qui permet uniquement de télécharger les objets du bucket, vous devez définir explicitement --public-access-type ObjectReadWithoutList.

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

Par exemple :

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

Création d'un bucket avec des balises de ressource

Vous pouvez créer des buckets de niveau Object Storage standard ou Archive avec des balises de ressource.

Pour ajouter des balises de ressource lors de la création d'un bucket, définissez l'une des options --defined-tags et --freeform-tags, ou les deux.

Conseil

Les options --defined-tags et --freeform-tags exigent que l'entrée soit un type complexe dans un format JSON valide. Pour plus d'informations sur le formatage JSON, reportez-vous à Transmission d'une entrée complexe et à Utilisation d'un fichier JSON pour une entrée complexe.

L'exemple de syntaxe suivant crée un bucket de niveau Object Storage standard avec une balise définie :

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

Exemples de formats de balise définie :

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

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

Remarque

Si vous exécutez l'interface de ligne de commande sur un ordinateur Windows, vous devrez peut-être utiliser la barre oblique inverse (\) pour échapper les chaînes contenant les valeurs des balises. Par exemple, une seule balise définie est formatée comme suit : '{\"Logistics\": {\"Procurement\": \"Madrid Center\"}}'

Par exemple :

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

L'exemple de syntaxe suivant crée un bucket de niveau Standard avec une balise à format libre :

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

Exemples de formatage de balise à format libre :

'{"Chicago_Team": "marketing_videos"}'

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

Remarque

Si vous exécutez l'interface de ligne de commande sur un ordinateur Windows, vous devrez peut-être utiliser la barre oblique inverse (\) pour échapper les chaînes contenant les valeurs des balises. Par exemple, une seule balise à format libre est formatée comme suit : '{\"Chicago_Team\": {\"marketing_videos\"}}'

Par exemple :

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

Affectation d'une clé au bucket

Vous pouvez affecter une clé Vault à un bucket que vous créez en incluant le paramètre kms_key_id.

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

où kms_key_id est l'OCID des versions de clé qui contiennent le matériel cryptographique utilisé pour crypter et décrypter les données, protégeant ainsi les données à leur emplacement de stockage.

Par exemple :


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

Exécutez l'opération CreateBucket pour créer un bucket.

Lors de l'accès à l'API Object Storage, le nom du bucket est utilisé avec le nom d'espace de noms Object Storage pour former l'URL de demande :
```
n/object_storage_namespace/b/bucket
```
Deux propriétés clés dans la charge utile sont :
- La propriété publicAccessType vérifie si le bucket est privé ou public, et limite la possibilité de répertorier le contenu du bucket public.
- La propriété objectEventsEnabled vérifie si des événements sont émis pour les objets de ce bucket.

Documentation Oracle Cloud Infrastructure

Création d'un bucket Object Storage

Balises

Journalisation de ressource

Création d'un compartiment de niveau de stockage par défaut standard

Création d'un compartiment de niveau de stockage par défaut Archive

Création d'un bucket public (pour répertorier et télécharger des objets de bucket)

Création d'un bucket public (pour télécharger des objets de bucket)

Création d'un bucket avec des balises de ressource

Affectation d'une clé au bucket