Création d'un bucket Object Storage

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

1. Ouvrez le menu de navigation et cliquez sur Stockage. Sous Object Storage et Archive Storage, cliquez sur Buckets.
2. Sélectionnez le compartiment dans la liste sous Portée de la liste. Tous les buckets de ce compartiment sont répertoriés sous forme tabulaire. Il s'agit du compartiment dans lequel se trouve le bucket que vous créez.
3. Cliquez sur Créer un bucket. La boîte de dialogue Créer un bucket apparaît.
4. Procédez comme suit :
  
  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 stockage par défaut : : sélectionnez le niveau par défaut auquel stocker les données. Lorsque vous téléchargez des objets, ceux-ci sont automatiquement affectés à ce niveau et téléchargés vers celui-ci.
  
  Standard : niveau de stockage par défaut principal utilisé pour les données du service Object Storage. Utilisez ce niveau 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 des 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.
  
  Archive Storage est le 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 : sélectionnez cette option si vous voulez qu'Object Storage surveille et déplace automatiquement les objets auxquels il est rare d'accéder du niveau Standard vers le niveau de stockage moins coûteux Accès rare. Pour plus d'informations, reportez-vous à Niveau automatique.
  
  Activer la gestion des versions d'objet : sélectionnez cette option si vous voulez qu'Object Storage crée 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 d'Object Storage.
  
  Emettre des événements d'objet : sélectionnez cette option afin de permettre au bucket d'émettre des événements pour les modifications d'état des objets. Pour plus d'informations sur les événements, reportez-vous à Présentation d'Events.
  
  Nettoyage des téléchargements multipart non validés : sélectionnez cette option pour créer une règle de cycle de vie qui supprime automatiquement tous les téléchargements multipart non validés au bout de 7 jours.
  
  Cryptage : : par défaut, les buckets sont cryptés à l'aide de clés gérées par Oracle, mais vous pouvez également crypter les données de ce bucket à l'aide de votre propre clé de cryptage Vault. Sélectionnez Crypter à l'aide des clés gérées par le client, puis le compartiment coffre et le coffre qui contiennent la clé de cryptage maître à utiliser. Sélectionnez également le compartiment de clé de cryptage maître et la clé de cryptage maître. 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 : si vous êtes autorisé à créer une ressource, vous disposez également des droits d'accès nécessaires pour lui appliquer des balises à format libre. 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'êtes pas certain d'appliquer des balises, ignorez cette option (vous pouvez les appliquer ultérieurement) ou demandez à l'administrateur.
5. Cliquez sur Créer.
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 bucket de niveau de stockage par défaut Standard

Par défaut, un bucket est créé dans le niveau Object Storage Standard. Vous ne devez pas définir explicitement --storage-tier. Standard : niveau de stockage par défaut principal utilisé pour les données du 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.

Création d'un bucket 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 en local.

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

Afin d'obtenir la liste complète des paramètres et des valeurs pour les commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'CLI.

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

Afin d'obtenir la liste complète des paramètres et des valeurs pour les commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'CLI.

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

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