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.
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 n'avez pas besoin de 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.
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" }
Pour obtenir la liste complète des paramètres et des valeurs des commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'interface de ligne de commande.
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" }
Pour obtenir la liste complète des paramètres et des valeurs des commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'interface de ligne de commande.
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.
-