Documentation sur Oracle Cloud Infrastructure

Copie d'un objet vers un autre seau dans le stockage d'objets

Copiez un objet vers un autre seau du service de stockage d'objets.

Attention

La copie d'objets ne fonctionne pas si vous n'autorisez pas le service de stockage d'objets à copier des objets en votre nom. Pour plus d'informations, voir Autorisations du service.

Règles de remplacement de copie d'objet

Utilisez des règles de remplacement pour contrôler la copie des objets en fonction de leurs valeurs de balise d'entité (ETag).

  • Remplacement de l'objet de destination : Utilisez cette option lorsque vous ne voulez pas limiter une opération de copie en fonction d'une valeur ETag. Cette option est la valeur par défaut. Cette option peut être utilisée pour une opération de copie, qu'elle concerne ou non le remplacement d'un objet existant.

  • Ne remplacer aucun objet de destination : Utilisez cette option pour empêcher le remplacement d'une copie existante d'un objet dans l'emplacement de destination, quelle que soit la valeur ETag de l'objet de destination.

  • Remplacement de l'objet de destination uniquement s'il correspond à l'objet ETag spécifié : Utilisez cette option pour empêcher le remplacement accidentel d'un objet dans l'emplacement de destination qui n'a pas l'ETag spécifié. Lorsque vous utilisez cette option, l'opération de copie réussit uniquement si ETag que vous fournissez lors du démarrage de la demande de copie correspond à ETag de l'objet de destination.

  • Copier l'objet uniquement si la source correspond à l'ETag spécifié : Utilisez cette option si vous voulez que l'opération de copie réussisse uniquement si l'ETag que vous fournissez lors du démarrage de la demande de copie correspond à l'ETag de l'objet source. Pour les objets qui ont été mis à jour intentionnellement et remplacés dans le cadre de l'activité de gestion des données, cette option garantit que seule la version spécifiée de l'objet (indiquée par l'ETag) est autorisée à être copiée. Si la valeur ETag de l'objet est modifiée après la création de la demande de travail de copie, mais avant l'exécution de l'opération de copie, l'opération n'est pas terminée.

Attention

Si vous remplacez un objet, l'opération ne peut pas être annulée.

Portée et contraintes

  • Les objets ne peuvent pas être copiés directement à partir du stockage d'archives. Pour copier les objets qui se trouvent dans le stockage d'objets, vous devez d'abord restaurer l'objet vers le niveau de stockage d'objets standard. Les objets peuvent être copiés directement dans les seaux de niveau Archive à partir des niveaux d'accès Standard ou Accès peu fréquent. Lorsque vous copiez des objets dans un seau de stockage d'archives, la copie de l'objet est immédiatement archivée.

  • Indiquez un seau cible existant pour la demande de copie. L'opération de copie ne crée pas automatiquement des intervalles.

  • Lorsqu'un objet est copié, l'objet de destination reçoit une nouvelle valeur ETag.

  • Si vous renommez, remplacez ou supprimez un objet source lors d'une opération de copie, l'opération de copie échoue et l'objet de destination n'est pas créé ni remplacé.

  • La copie en masse n'est pas prise en charge. Identifiez un seul objet dans la demande de copie.

Autorisations du service

Comme le service Stockage d'objets est un service régional, vous devez autoriser le service de stockage d'objets pour chaque région effectuant des opérations de copie en votre nom. Par exemple, vous pouvez autoriser le service de stockage d'objets dans la région États-Unis - Est (Ashburn) à gérer les objets en votre nom. Après avoir autorisé le service de stockage d'objets, vous pouvez copier un objet stocké dans un seau de la région États-Unis - Est (Ashburn) vers un seau d'une autre région.

Pour déterminer la valeur de l'identificateur de région d'une région Oracle Cloud Infrastructure, voir Régions et domaines de disponibilité.

Pour les administrateurs :

Pour permettre la copie d'objet, vous devez autoriser le service à gérer les objets en votre nom :

  • Vous pouvez créer une politique qui autorise le service dans la région indiquée à gérer les espaces de noms de stockage d'objets, les seaux et les objets associés dans tous les compartiments de la location :

    Allow service objectstorage-<region_identifier> to manage object-family in tenancy

  • Au lieu d'utiliser le verbe de politique manage, vous pouvez créer une politique qui réduit la portée de l'accès à l'aide de l'un des énoncés suivants :

    Allow service objectstorage-<region_identifier> to manage object-family in tenancy where any {request.permission='OBJECT_READ', request.permission='OBJECT_INSPECT', request.permission='OBJECT_CREATE', request.permission='OBJECT_OVERWRITE', request.permission='OBJECT_DELETE'}
    Allow service objectstorage-<region_identifier> to manage object-family in compartment <compartment_name> where any {request.permission='OBJECT_READ', request.permission='OBJECT_INSPECT', request.permission='OBJECT_CREATE', request.permission='OBJECT_OVERWRITE', request.permission='OBJECT_DELETE'}

Copie d'un objet

    1. Dans la page de liste Seaux, sélectionnez le seau de stockage d'objets avec lequel vous voulez travailler. Si vous avez besoin d'aide pour trouver la page de liste ou le seau de stockage d'objets, voir Liste des seaux.
    2. Dans la page des détails, sélectionnez Objets.
    3. Dans le menu Actions de l'objet souhaité, sélectionnez Copier.

      La console vérifie les politiques IAM en place pour effectuer cette tâche. Si vous voyez un avertissement concernant une politique manquante, vous pouvez laisser la console essayer de créer les politiques manquantes ou vous pouvez copier les détails manquants dans le presse-papiers pour envoyer un courriel à l'administrateur. Si vous pensez disposer des politiques requises, continuez et essayez l'opération de copie.

    4. Entrez les informations suivantes :

      • Espace de noms de destination : Entrez l'espace de noms du seau de destination pour l'objet copié. La chaîne d'espace de noms de votre location est fournie en tant que valeur par défaut. Pour plus d'informations, voir Présentation des espaces de noms.

      • Région de destination : Sélectionnez dans la liste la région OCI qui contient le seau de destination de l'objet copié. Votre location doit être abonnée à une région pour que vous puissiez copier un objet vers un seau de cette région.

      • Seau de destination : Entrez le nom du seau de destination pour l'objet copié. La destination doit être un seau existant auquel vous avez accès. Voir Seaux pour plus d'informations sur la création d'un seau.

      • Nom de l'objet de destination : (Facultatif) Entrez un autre nom pour l'objet en cours de copie si vous ne voulez pas utiliser son nom initial. Par défaut, le nom est le même que celui de l'objet que vous copiez.

      • Niveau de stockage de destination : (Facultatif) Spécifiez le niveau de stockage vers lequel charger l'objet si vous voulez qu'il soit différent du niveau de stockage source. Les niveaux de stockage suivants sont pris en charge :

        Si vous ne spécifiez pas de niveau de stockage de destination, l'objet est stocké dans le même niveau que le compartiment. Pour plus d'informations, voir Niveaux de stockage d'objets.

      • Règle de remplacement : Sélectionnez la règle de remplacement appropriée pour la demande de copie :

        • Remplacer l'objet de destination

        • Ne remplacer aucun objet de destination

        • Remplacer l'objet de destination uniquement s'il correspond à l'ETag spécifié

        • Copier l'objet uniquement si la source correspond à ETag spécifié

        Voir Règles de remplacement de copie d'objet pour obtenir la description de chacune de ces règles.

    5. Sélectionnez Copier l'objet.

    La boîte de dialogue Détails de la demande de travail s'affiche et confirme que la demande de copie a été soumise et suit le statut de la demande.

  • Utilisez la commande oci os object copy et les paramètres requis pour copier un objet vers un autre seau :

    oci os object copy --bucket-name source_bucket_name --source-object-name source_object_name --destination-bucket destination_bucket_name [OPTIONS]

    Par exemple :

    oci os object copy --bucket-name photos --source-object-name hummingbird.jpg --destination-namespace ansh8lvru1zp --destination-bucket UK_photos

    Copie d'un objet vers une autre région

    Incluez le paramètre destination-region et l'identificateur de région pour spécifier un seau cible dans la région que celui où réside l'objet de destination.

    Par exemple :

    oci os object copy --bucket-name photos --source-object-name hummingbird.jpg --destination-bucket UK_photos --destination-region uk-london-1
    Votre location doit être abonnée à une région pour que vous puissiez copier un objet vers un seau de cette région.

    Copie vers un autre niveau de stockage de destination

    Incluez le paramètre destination-object-storage-tier et une valeur de niveau de stockage prise en charge pour copier l'objet vers un niveau de stockage différent dans le seau de destination par rapport au niveau où il réside dans la source.

    Par exemple :

    oci os object copy --bucket-name photos --source-object-name hummingbird.jpg --destination-bucket UK_photos --destination-object-storage-tier Archive

    Les valeurs prises en charge sont les suivantes :

    • Standard (par défaut)

    • InfrequentAccess

    • Archive

    • Si vous ne spécifiez pas de niveau de stockage de destination, l'objet est stocké dans le même niveau que le compartiment. Pour plus d'informations, voir Niveaux de stockage d'objets.

    Indiquer l'espace de noms de l'objet copié

    Incluez le paramètre destination-namespace et sa valeur pour spécifier l'espace de noms de destination vers lequel l'objet est copié.

    Par exemple :

    oci os object copy --bucket-name photos --source-object-name hummingbird.jpg --destination-bucket UK_photos --destination-namespace MyNamespace
    Pour plus d'informations, voir Présentation des espaces de noms.

    Spécification d'un autre nom pour l'objet copié

    Incluez le paramètre destination-object-name et sa valeur pour appliquer un autre nom à l'objet copié.

    Par exemple :

    oci os object copy --bucket-name photos --source-object-name hummingbird.jpg --destination-bucket UK_photos --destination-object-name hummingbird_brochure.jpg

    Par défaut, le nom est le même que celui de l'objet que vous copiez.

    Pour la liste complète des paramètres et valeurs des commandes de l'interface de ligne de commande, voir Informations de référence sur les commandes de l'interface.

  • Exécutez l'opération CopyObject pour copier un objet vers un autre seau.