Authentification IAM

Si vous utilisez l'authentification IAM, vous devez configurer votre client avec un identifiant d'instance pour pouvoir utiliser certaines commandes. Pour plus d'informations sur la création d'une instance de service, voir Création d'une instance de service. Pour récupérer l'ID de l'instance, vous pouvez taper ibmcloud resource service-instance <INSTANCE_NAME> --id, en remplaçant par <INSTANCE_NAME> l'alias unique que vous avez attribué à votre instance de service. Dans les exemples suivants, la valeur 8f275e7b-c076-49e2-b9c5-f985704cf678 correspond à un exemple d'ID d'instance.

Tout d'abord, extrayez le CRN et l'ID avec le nom de votre instance. Veillez à utiliser des guillemets (') sur votre nom d'instance et à vous connecter à IBM Cloud. Seule la dernière partie du nom de ressource de cloud est nécessaire, c'est-à-dire la partie qui suit ::.

$ ibmcloud resource service-instance 'My Awesome Cloud Object Storage'  --id
Retrieving service instance My Awesome Cloud Object Storage in all resource groups under account IBM as ibmuser@us.ibm.com...
crn:v1:bluemix:public:cloud-object-storage:global:a/94400e98c553415c9599db39b9be9219:3b7d66c8-9fdf-4f81-b7e6-08d187f07288:: 8f275e7b-c076-49e2-b9c5-f985704cf678

Définissez le CRN à l'aide de la commande ibmcloud cos config crn. Il peut vous avertir de l'écrasement. Si vous ne souhaitez pas fournir le CRN de manière interactive, vous pouvez le fournir sur la même commande avec l'indicateur --crn.

$ ibmcloud cos config crn
Resource Instance ID CRN:  ()> 8f275e7b-c076-49e2-b9c5-f985704cf678
Saving new Service Instance ID...
OK
Successfully stored your service instance ID.

Vérifiez la configuration :

$ ibmcloud cos config crn --list
Key   Value
CRN   8f275e7b-c076-49e2-b9c5-f985704cf678

Vous pouvez aussi ouvrir la console Web, sélectionner Données d'identification pour le service dans la barre de navigation et créer un nouvel ensemble de données d'identification (ou afficher un fichier de données d'identification existant que vous avez déjà créé).

Données d'identification HMAC

Si vous préférez, vous pouvez utiliser les données d'identification HMAC d'un ID de service à la place de votre clé d'API. Exécutez la commande ibmcloud cos config hmac pour entrer les données d'identification HMAC, puis changez de méthodes d'autorisation à l'aide de la commande ibmcloud cos config auth.

Si vous choisissez d'utiliser l'authentification par jeton avec votre propre clé d'API, vous n'avez pas besoin de fournir des données d'identification car le programme vous authentifie automatiquement.

A tout moment, pour passer de l'authentification HMAC à l'authentification IAM, vous pouvez entrer ibmcloud cos config auth. Pour plus d'informations sur l'authentification et l'autorisation dans IBM Cloud, voir la documentationIdentity and Access Management.

Télécharger des objets à l'aide de l' Aspera

• Action : télécharger un objet depuis un compartiment à l'aide d'un transfert haut-débit Aspera.
• Utilisation : ibmcloud cos aspera-download --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT] [OUTFILE]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • La CLÉ de l'objet à télécharger.
    • Indicateur : --key KEY
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT
  • Facultatif : chemin d'accès local où le fichier téléchargé est enregistré. Sauf indication contraire, le fichier est enregistré à l'emplacement de téléchargement par défaut sous le nom de fichier correspondant à la clé d'objet.
    • Argument : OUTFILE

Exemple :

export IBMCLOUD_API_KEY=<your-api-key>
ibmcloud cos aspera-download --bucket my-bucket --key videos/demo.mp4 /tmp/demo.mp4

Importez des fichiers ou des répertoires à l'aide de l' Aspera

• Action : Télécharger un fichier ou un répertoire vers un compartiment à l'aide d'un transfert haut débit d' Aspera.
• Utilisation : ibmcloud cos aspera-upload --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT] [SRCFILE]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • La clé (nom de l'objet de destination) dans le compartiment.
    • Indicateur : --key KEY
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT
  • Facultatif : chemin d'accès local du fichier ou du répertoire à télécharger.
    • Argument : SRCFILE

Exemple :

export IBMCLOUD_API_KEY=<your-api-key>
ibmcloud cos aspera-upload --bucket my-bucket --key videos/demo.mp4 /tmp/demo.mp4

Définir la configuration du cycle de vie dans un compartiment

• Action : Définir la configuration du cycle de vie d'un compartiment.
• Utilisation : ibmcloud cos bucket-lifecycle-configuration-put --bucket BUCKET_NAME --lifecycle-configuration STRUCTURE [--region REGION] [--output FORMAT]
• Paramètres à fournir :

  • Nom du compartiment.

    • Indicateur : --bucket BUCKET_NAME

  • Une STRUCTURE utilisant la syntaxe JSON. Le préfixe file:// peut être utilisé pour charger la structure JSON à partir d'un fichier, tel que --lifecycle-configuration file://<filename.json>.

    • Indicateur : --lifecycle-configuration STRUCTURE

      	{
      	  "Rules": [
      	    {
      	      "ID": "string",
      	      "Status": "Enabled"|"Disabled",
      	      "Filter": {
      	        "Prefix": "string"
      	      },
      	      "Expiration": {
      	        "Days": integer,
      	        "Date": "YYYY-MM-DDTHH:mm:ssZ",
      	        "ExpiredObjectDeleteMarker": true|false
      	      },
      	      "Transitions": [
      	        {
      	          "Days": integer,
      	          "Date": "YYYY-MM-DDTHH:mm:ssZ",
      	          "StorageClass": "string"
      	        }
      	      ],
      	      "NoncurrentVersionExpiration": {
      	        "NoncurrentDays": integer
      	      },
      	      "AbortIncompleteMultipartUpload": {
      	        "DaysAfterInitiation": integer
      	      }
      	    }
      	  ]
      	}
      

  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.

    • Indicateur : --region REGION

  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.

    • Indicateur : --output FORMAT

Exemple — utilisation d'un fichier :

ibmcloud cos bucket-lifecycle-configuration-put --bucket my-bucket --lifecycle-configuration file://lifecycle.json

Exemple — dans le texte :

ibmcloud cos bucket-lifecycle-configuration-put \
  --bucket my-bucket \
  --lifecycle-configuration '{
    "Rules": [
      {
        "ID": "expire-noncurrent-versions",
        "Status": "Enabled",
        "Filter": { "Prefix": "" },
        "NoncurrentVersionExpiration": {
          "NoncurrentDays": 30
        }
      },
      {
        "ID": "clean-delete-markers",
        "Status": "Enabled",
        "Filter": { "Prefix": "" },
        "Expiration": {
          "ExpiredObjectDeleteMarker": true
        }
      }
    ]
  }' \
  --region us-south

Obtenir la configuration du cycle de vie pour un compartiment

• Action : obtenir la configuration du cycle de vie d'un compartiment.
• Utilisation : ibmcloud cos bucket-lifecycle-configuration-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos bucket-lifecycle-configuration-get --bucket my-bucket

Supprimer la configuration du cycle de vie depuis un compartiment

• Action : Supprimer la configuration du cycle de vie d'un compartiment.
• Utilisation : ibmcloud cos bucket-lifecycle-configuration-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos bucket-lifecycle-configuration-delete --bucket my-bucket

Réplication de compartiment d'insertion

• Action : Définir la configuration de réplication d'un compartiment.
• Utilisation : ibmcloud cos bucket-replication-put --bucket BUCKET_NAME --replication-configuration STRUCTURE [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT
  • Une STRUCTURE utilisant la syntaxe JSON.

    • Indicateur : --replication-configuration STRUCTURE

      	{
      		"Rules": [
      			{
      				"Status": "Enabled",
      				"Priority": 1,
      				"Filter" : { "Prefix": ""},
      				"DeleteMarkerReplication": {
      					"Status": "Disabled"
      				},
      				"Destination": {
      					"Bucket": "DEST-BUCKET-CRN"
      				}
      			}
      		]
      	}
      

Exemple — utilisation d'un fichier :

ibmcloud cos bucket-replication-put --bucket SOURCE-BUCKET-NAME --replication-configuration file://replication.json

Exemple — dans le texte :

ibmcloud cos bucket-replication-put --bucket SOURCE-BUCKET-NAME \
  --replication-configuration '{
    "Rules": [
      {
        "Status": "Enabled",
        "Priority": 1,
        "Filter": {},
        "DeleteMarkerReplication": { "Status": "Disabled" },
        "Destination": { "Bucket": "DEST-BUCKET-CRN" }
      }
    ]
  }' \
  --region us-south

Obtenir la réplication de compartiment

• Action : obtenir la configuration de réplication d'un compartiment.
• Utilisation : ibmcloud cos bucket-replication-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos bucket-replication-get --bucket SOURCE-BUCKET-NAME

Supprimer la réplication de compartiment

• Action : supprimer la configuration de réplication d'un compartiment.
• Utilisation : ibmcloud cos bucket-replication-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos bucket-replication-delete --bucket SOURCE-BUCKET-NAME

Répertorier les échecs de réplication pour un compartiment

• Action : répertorier les échecs de réplication pour un compartiment.
• Utilisation : ibmcloud cos bucket-replication-failures --bucket BUCKET_NAME [--starting-token TOKEN] [--encoding-type METHOD] [--first-sync-attempted-before TIMESTAMP] [--max-keys NUMBER] [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : un TOKEN permettant de spécifier où commencer la page suivante de résultats.
    • Indicateur : --starting-token TOKEN
  • Facultatif : demande l'encodage des clés d'objet dans la réponse et spécifie la MÉTHODE d'encodage à utiliser.
    • Indicateur : --encoding-type METHOD
  • Facultatif : filtre les résultats pour n'inclure que les échecs dont la première synchronisation a été tentée avant l'horodatage spécifié (format ISO 8601).
    • Indicateur : --first-sync-attempted-before TIMESTAMP
  • Facultatif : le NOMBRE maximal de clés à renvoyer.
    • Indicateur : --max-keys NUMBER
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos bucket-replication-failures --bucket my-bucket

Réessayer la réplication des objets ayant échoué dans un compartiment

• Action : relancer la réplication des objets ayant échoué dans un compartiment.
• Utilisation : ibmcloud cos bucket-replication-reattempt --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos bucket-replication-reattempt --bucket my-bucket

Définir la configuration de gestion des versions sur un compartiment

• Action : Définir la configuration de gestion des versions d'un compartiment.
• Utilisation : ibmcloud cos bucket-versioning-put --bucket BUCKET_NAME --versioning-configuration STRUCTURE [--region REGION] [--output FORMAT]
• Paramètres à fournir :

  • Nom du compartiment.

    • Indicateur : --bucket BUCKET_NAME

  • Une STRUCTURE utilisant la syntaxe JSON pour spécifier l'état de gestion des versions. Les valeurs valides pour Status sont et Enabled Suspended.

    • Indicateur : --versioning-configuration STRUCTURE

      	{
      	  "Status": "Enabled"|"Suspended"
      	}
      

  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.

    • Indicateur : --region REGION

  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.

    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos bucket-versioning-put --bucket my-bucket --versioning-configuration '{"Status": "Enabled"}'

Obtenir la configuration de gestion des versions pour un compartiment

• Action : obtenir la configuration de gestion des versions d'un compartiment.
• Utilisation : ibmcloud cos bucket-versioning-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos bucket-versioning-get --bucket my-bucket

Créez un nouveau bucket avec Key Protect

• Action : Créer un compartiment avec Key Protect dans une instance d' IBM Cloud Object Storage.
• Utilisation : ibmcloud cos bucket-create --bucket BUCKET_NAME [--ibm-service-instance-id ID] [--class CLASS_NAME] [--region REGION] --kms-root-key-crn CUSTOMERROOTKEYCRN --kms-encryption-algorithm ALGORITHM [--output FORMAT] [--json]
  • Notez que vous devez fournir un CRN si vous utilisez l'authentification IAM. Vous pouvez le définir à l'aide de la commande ibmcloud cos config crn.
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • La clé CUSTOMERROOTKEYCRN de la clé racine KMS à associer au compartiment pour le chiffrement des données.
    • Indicateur : --kms-root-key-crn CUSTOMERROOTKEYCRN
  • Facultatif : l'ALGORITHME et la TAILLE à utiliser avec la clé de chiffrement stockée à l'aide de Key Protect.
    • Indicateur : --kms-encryption-algorithm ALGORITHM
  • Facultatif : le nom de la classe.
    • Indicateur : --class CLASS_NAME
  • Facultatif : définit l'ID d'instance du service IBM dans la requête.
    • Indicateur : --ibm-service-instance-id ID
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT
  • (Obsolète): Résultat renvoyé au format JSON brut.
    • Indicateur : --json

Exemple :

ibmcloud cos bucket-create --bucket bucket-name --kms-root-key-crn crn:v1:staging:public:kms:us-south:a/9978e0xxxxxxxxxxxxxxxxxxxxxx8654:dfdxxxxx-xxxx-xxxx-xxxx-xxxxxxba6eb0:key:7cea005e-75d4-4a08-ad2f-5e56141f6a96 --kms-encryption-algorithm AES256

Créez un nouveau compartiment avec Hyper Protect Crypto Services

• Action: Créez un nouveau compartiment avec Hyper Protect Crypto Services.
• Utilisation : ibmcloud cos bucket-create --bucket BUCKET_NAME [--ibm-service-instance-id ID] [--class CLASS_NAME] [--region REGION] --kms-root-key-crn CUSTOMERROOTKEYCRN --kms-encryption-algorithm ALGORITHM [--output FORMAT] [--json]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • La clé CUSTOMERROOTKEYCRN de la clé racine KMS à associer au compartiment pour le chiffrement des données.
    • Indicateur : --kms-root-key-crn CUSTOMERROOTKEYCRN
  • Facultatif : l'ALGORITHME et la TAILLE à utiliser avec la clé de chiffrement stockée à l'aide de Key Protect.
    • Indicateur : --kms-encryption-algorithm ALGORITHM
  • Facultatif : le nom de la classe.
    • Indicateur : --class CLASS_NAME
  • Facultatif : définit l'ID d'instance du service IBM dans la requête.
    • Indicateur : --ibm-service-instance-id ID
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT
  • (Obsolète): Résultat renvoyé au format JSON brut.
    • Indicateur : --json

Exemple :

ibmcloud cos bucket-create --bucket bucket-name --kms-root-key-crn crn:v1:bluemix:public:hs-crypto:us-south:a/ee747e4xxxxxxxxxxxxxxxxxxxxxx7559:ac6xxxxx-xxxx-xxxx-xxxx-xxxxxx1bea99:key:e7451f36-d7ea-4f55-bc1c-ce4bcceb7018

Télécharger des objets à l'aide de l' S3Manager

• Action : permet de recevoir par téléchargement de façon simultanée des objets à partir de s3.
• Utilisation : ibmcloud cos download --bucket BUCKET_NAME --key KEY [--concurrency value] [--part-size SIZE] [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--response-cache-control HEADER] [--response-content-disposition HEADER] [--response-content-encoding HEADER] [--response-content-language HEADER] [--response-content-type HEADER] [--response-expires HEADER] [--region REGION] [--output FORMAT] [OUTFILE]
• Paramètres à fournir :
  • Nom (BUCKET_NAME) du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Clé de l'objet.
    • Indicateur : --key KEY
  • Facultatif : nombre de routines Go à lancer en parallèle par appel de téléchargement lors de l'envoi de parties. La valeur par défaut est 5.
    • Indicateur : --concurrency value
  • Facultatif : la TAILLE (en octets) du tampon à utiliser lors de la mise en tampon des données par blocs et de leur envoi par parties vers S3. La plus petite taille de partie autorisée est de 5 Mo.
    • Indicateur : --part-size SIZE
  • Facultatif : renvoyer l'objet uniquement si son identifiant d'entité (ETag) correspond à celui spécifié ETAG ; sinon, renvoyer un code 412 (échec de la condition préalable).
    • Indicateur : --if-match ETAG
  • Facultatif : renvoyer l'objet uniquement s'il a été modifié depuis le TIMESTAMP spécifié; sinon, renvoyer un code 304 (non modifié).
    • Indicateur : --if-modified-since TIMESTAMP
  • Facultatif : renvoyer l'objet uniquement si son identifiant d'entité (ETag) est différent de celui spécifié ETAG, sinon renvoyer un code 304 (non modifié).
    • Indicateur : --if-none-match ETAG
  • Facultatif : renvoyer l'objet uniquement s'il n'a pas été modifié depuis le TIMESTAMP spécifié; dans le cas contraire, renvoyer un code d'erreur 412 (échec de la condition préalable).
    • Indicateur : --if-unmodified-since TIMESTAMP
  • Facultatif : télécharge les octets spécifiés dans RANGE d'un objet. Pour plus d’informations sur l’en-tête Range de l’ HTTP, consultez la spécification de l’en-tête Range de l’ HTTP.
    • Indicateur : --range RANGE
  • Facultatif : définit l'en-tête Cache-Control de la réponse.
    • Indicateur : --response-cache-control HEADER
  • Facultatif : définit l'en-tête Content-Disposition de la réponse.
    • Indicateur : --response-content-disposition HEADER
  • Facultatif : définit l'en-tête Content-Encoding de la réponse.
    • Indicateur : --response-content-encoding HEADER
  • Facultatif : définit l'en-tête Content-Language de la réponse.
    • Indicateur : --response-content-language HEADER
  • Facultatif : définit l'en-tête Content-Type de la réponse.
    • Indicateur : --response-content-type HEADER
  • Facultatif : définit l'en-tête Expires de la réponse.
    • Indicateur : --response-expires HEADER
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilisera l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT
  • Facultatif : emplacement où enregistrer le contenu de l'objet. Si ce paramètre n'est pas fourni, le programme utilise l'emplacement par défaut.
    • Paramètre : OUTFILE

Création d'une liste de compartiments étendue

• **Action : ** permet d'afficher une liste de tous les compartiments présents dans le compte IBM Cloud Object Storage d'un utilisateur. Les compartiments peuvent se trouver dans différentes régions.
• Utilisation : ibmcloud cos buckets-extended [--ibm-service-instance-id ID] [--marker KEY] [--prefix PREFIX] [--page-size SIZE] [--max-items NUMBER] [--output FORMAT]
  • Notez que vous devez fournir un CRN si vous utilisez l'authentification IAM. Vous pouvez le définir à l'aide de la commande ibmcloud cos config crn.
• Paramètres à fournir :
  • Aucun paramètre à fournir.
  • Facultatif : définit l'ID d'instance du service IBM dans la requête.
    • Indicateur : --ibm-service-instance-id
  • Facultatif : spécifie la CLÉ à utiliser pour commencer la liste des objets d'un compartiment.
    • Indicateur : --marker KEY
  • Facultatif : limite la réponse aux clés commençant par le PRÉFIXE spécifié.
    • Indicateur : --prefix PREFIX
  • Facultatif : la TAILLE de chaque page à inclure dans l'appel de service. Cette valeur n'affecte pas le nombre d'éléments renvoyés dans le résultat de la commande. Si vous définissez une taille de page plus petite, un plus grand nombre d'appels est émis vers le service, avec moins d'éléments extraits dans chaque appel. Cela peut permettre d'éviter que les appels de service ne dépassent le délai d'expiration.
    • Indicateur : --page-size SIZE
  • Facultatif : le NOMBRE total d'éléments à renvoyer dans la sortie de la commande.
    • Indicateur : --max-items NUMBER
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Remonter une partie

• Action : permet d'envoyer par téléchargement une partie d'un fichier dans une instance d'envoi par téléchargement en plusieurs parties existante.
• Utilisation : ibmcloud cos part-upload --bucket BUCKET_NAME --key KEY --upload-id ID --part-number NUMBER [--body FILE_PATH] [--region REGION] [--output FORMAT]
  • Notez que vous devez enregistrer le numéro de chaque partie de fichier téléchargée et ( ETag que l'interface CLI affichera pour vous) pour chaque partie dans un fichier JSON. Pour plus d'informations, voir la rubrique sur l'envoi par téléchargement en plusieurs parties.
• Paramètres à fournir :
  • Nom du compartiment dans lequel s'effectue l'envoi par téléchargement en plusieurs parties.
    • Indicateur : --bucket BUCKET_NAME
  • Clé de l'objet.
    • Indicateur : --key KEY
  • ID d'envoi par téléchargement identifiant l'envoi par téléchargement en plusieurs parties.
    • Indicateur : --upload-id ID
  • Référence de la partie en cours d'envoi par téléchargement. Il s'agit d'un nombre entier positif compris entre 1 et 10 000. (valeur par défaut : 1)
    • Indicateur : --part-number NUMBER
  • Facultatif : emplacement des données de l'objet (FILE_PATH).
    • Indicateur : --body FILE_PATH
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Envoi par téléchargement d'une copie de partie

• Action : permet d'envoyer par téléchargement une partie en copiant les données d'un objet existant.
• Utilisation : ibmcloud cos part-upload-copy --bucket BUCKET_NAME --key KEY --upload-id ID --part-number NUMBER --copy-source SOURCE [--copy-source-if-match ETAG] [--copy-source-if-modified-since TIMESTAMP] [--copy-source-if-none-match ETAG] [--copy-source-if-unmodified-since TIMESTAMP] [--copy-source-range value] [--region REGION] [--output FORMAT]
  • Notez que vous devez enregistrer le numéro de chaque partie de fichier téléchargée et ( ETag que l'interface CLI affichera pour vous) pour chaque partie dans un fichier JSON. Pour plus d'informations, voir la rubrique sur l'envoi par téléchargement en plusieurs parties.
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Clé de l'objet.
    • Indicateur : --key KEY
  • ID d'envoi par téléchargement identifiant l'envoi par téléchargement en plusieurs parties.
    • Indicateur : --upload-id ID
  • Référence de la partie en cours d'envoi par téléchargement. Il s'agit d'un entier positif compris entre 1 et 10 000.
    • Indicateur : --part-number PART_NUMBER
  • (SOURCE) Nom du compartiment source et nom de la clé de l'objet source, séparés par une barre oblique (/). Doit être encodé selon la norme URL.
    • Indicateur : --copy-source SOURCE
  • Facultatif : copie l'objet si son identifiant d'entité (Etag) correspond à l'identifiant spécifié (ETAG).
    • Indicateur : --copy-source-if-match ETAG
  • Facultatif : copie l'objet s'il a été modifié depuis l'heure spécifiée (TIMESTAMP).
    • Indicateur : --copy-source-if-modified-since TIMESTAMP
  • Facultatif : copie l'objet si son identifiant d'entité (ETag) est différent de l'identifiant spécifié (ETAG).
    • Indicateur : --copy-source-if-none-match ETAG
  • Facultatif : copie l'objet s'il n'a pas été modifié depuis l'heure spécifiée (TIMESTAMP).
    • Indicateur : --copy-source-if-unmodified-since TIMESTAMP
  • Facultatif : la plage d'octets à copier à partir de l'objet source. La valeur de la plage doit être au format bytes=fist-last, first et last étant les décalages comptés à partir de zéro. Par exemple, bytes=0-9 indique que vous souhaitez copier les dix premiers octets de la source. Vous ne pouvez copier une plage que si l'objet source fait plus de 5 Mo.
    • Indicateur : --copy-source-range value
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Mettre la mise en attente juridique de l'objet

• Action : définir une conservation légale sur un objet.
• Utilisation : ibmcloud cos object-legal-hold-put --bucket BUCKET_NAME --key KEY [--legal-hold STRUCTURE] [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Clé de l'objet.
    • Indicateur : --key KEY
  • Une STRUCTURE utilisant la syntaxe JSON. Voir la documentationIBM Cloud.

    • Indicateur : --legalhold STRUCTURE

      	{
      	   "Status": "ON"|"OFF"
      	}
      

  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos object-legal-hold-put --bucket bucket-name --key file-name.txt --legal-hold '{"Status": "ON"}'

Obtenir la mise en attente légale de l'objet

• Action : mettre un objet sous conservation légale.
• Utilisation : ibmcloud cos object-legal-hold-get --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Clé de l'objet.
    • Indicateur : --key KEY
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos object-legal-hold-get --bucket bucket-name --key file-name.txt --region us-south

Exemple de réponse :

{
	"LegalHold": {
		"Status": "ON"
	}
}

Configuration du verrouillage d'insertion d'objet

Les jours et les années de conservation par défaut ne peuvent pas être fournis en même temps.

• Action : Définir la configuration du verrouillage des objets sur un compartiment.
• Utilisation : ibmcloud cos object-lock-configuration-put --bucket BUCKET_NAME [--object-lock-configuration STRUCTURE] [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Une STRUCTURE utilisant la syntaxe JSON. Voir la documentationIBM Cloud.

    • Indicateur : --object-lock-configuration STRUCTURE

      	{
      	"ObjectLockEnabled": "Enabled",
      	"Rule": {
      		"DefaultRetention": {
      		"Mode": "COMPLIANCE",
      		"Days": integer,
      		"Years": integer
      		}
      	}
      	}
      

  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos object-lock-configuration-put --bucket bucket-name --object-lock-configuration '{ "ObjectLockEnabled": "Enabled", "Rule": { "DefaultRetention": { "Mode": "COMPLIANCE", "Days": 30 }}}'

Obtenir la configuration du verrouillage d'objet

• Action : obtenir la configuration du verrouillage d'objet sur un compartiment.
• Utilisation : ibmcloud cos object-lock-configuration-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos object-lock-configuration-get --bucket bucket-name --region us-south

Exemple de réponse :

{
	"ObjectLockEnabled": "Enabled",
	"Rule": {
		"DefaultRetention": {
			"Mode": "COMPLIANCE",
			"Days": integer,
			"Years": integer
		}
	}
}

Conservation de l'objet d'insertion

• Action : définir la durée de conservation d'un objet.
• Utilisation : ibmcloud cos object-retention-put --bucket BUCKET_NAME --key KEY [--retention STRUCTURE] [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Clé de l'objet.
    • Indicateur : --key KEY
  • Une STRUCTURE utilisant la syntaxe JSON. Voir la documentationIBM Cloud.

    • Indicateur : --retention STRUCTURE

      	{
      	  "Mode": "COMPLIANCE",
      	  "RetainUntilDate": timestamp
      	}
      

  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos object-retention-put --bucket bucket-name --key file-name.txt --retention '{ "Mode": "COMPLIANCE", "RetainUntilDate": "2024-02-02T00:00:00"}'

Obtenir la conservation de l'objet

• Action : obtenir la durée de conservation d'un objet.
• Utilisation : ibmcloud cos object-retention-get --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Clé de l'objet.
    • Indicateur : --key KEY
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos object-retention-get --bucket bucket-name --key file-name.txt --region us-south

Exemple de réponse :

{
	"Retention": {
		"Mode": "COMPLIANCE",
		"RetainUntilDate": "2024-02-02T00:00:00.000Z"
	}
}

Définir des balises pour un objet

• Action : attribuer des balises à un objet.
• Utilisation : ibmcloud cos object-tagging-put --bucket BUCKET_NAME --key KEY --tagging STRUCTURE [--version-id VERSION_ID] [--region REGION] [--output FORMAT]
• Paramètres à fournir :

  • Nom du compartiment.

    • Indicateur : --bucket BUCKET_NAME

  • Clé de l'objet.

    • Indicateur : --key KEY

  • Une STRUCTURE utilisant la syntaxe JSON et contenant l'ensemble de balises. Le préfixe file:// peut être utilisé pour charger la structure JSON à partir d'un fichier, tel que --tagging file://<filename.json>.

    • Indicateur : --tagging STRUCTURE

      	{
      	  "TagSet": [
      	    {
      	      "Key": "string",
      	      "Value": "string"
      	    }
      	  ]
      	}
      

  • Facultatif : l'identifiant VERSION_ID de l'objet à baliser. Sauf indication contraire, la version actuelle est mentionnée.

    • Indicateur : --version-id VERSION_ID

  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.

    • Indicateur : --region REGION

  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.

    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos object-tagging-put --bucket my-bucket --key my-object.txt --tagging '{"TagSet": [{"Key": "env", "Value": "production"}]}'

Obtenir les balises d'un objet

• Action : obtenir les balises d'un objet.
• Utilisation : ibmcloud cos object-tagging-get --bucket BUCKET_NAME --key KEY [--version-id VERSION_ID] [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Clé de l'objet.
    • Indicateur : --key KEY
  • Facultatif : le VERSION_ID de la version spécifique de l'objet pour laquelle vous souhaitez récupérer les balises.
    • Indicateur : --version-id VERSION_ID
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos object-tagging-get --bucket my-bucket --key my-object.txt

Retirer des balises d'un objet

• Action : supprimer les balises d'un objet.
• Utilisation : ibmcloud cos object-tagging-delete --bucket BUCKET_NAME --key KEY [--version-id VERSION_ID] [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Clé de l'objet.
    • Indicateur : --key KEY
  • Facultatif : le VERSION_ID de la version spécifique de l'objet dont il faut supprimer les balises.
    • Indicateur : --version-id VERSION_ID
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos object-tagging-delete --bucket my-bucket --key my-object.txt

Définir la configuration de blocage d'accès public sur un compartiment

• Action : définir la configuration du blocage d'accès public sur un compartiment.
• Utilisation : ibmcloud cos public-access-block-put --bucket BUCKET_NAME --public-access-block-configuration STRUCTURE [--region REGION] [--output FORMAT]
• Paramètres à fournir :

  • Nom du compartiment.

    • Indicateur : --bucket BUCKET_NAME

  • Une STRUCTURE utilisant la syntaxe JSON. Le préfixe file:// peut être utilisé pour charger la structure JSON à partir d'un fichier, tel que --public-access-block-configuration file://<filename.json>.

    • Indicateur : --public-access-block-configuration STRUCTURE

      	{
      	  "BlockPublicAcls": true|false,
      	  "IgnorePublicAcls": true|false,
      	  "BlockPublicPolicy": true|false,
      	  "RestrictPublicBuckets": true|false
      	}
      

  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.

    • Indicateur : --region REGION

  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.

    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos public-access-block-put --bucket my-bucket --public-access-block-configuration '{"BlockPublicAcls": true, "IgnorePublicAcls": true, "BlockPublicPolicy": true, "RestrictPublicBuckets": true}'

Obtenir la configuration de blocage d'accès public sur un compartiment

• Action : obtenir la configuration du bloc d'accès public sur un compartiment.
• Utilisation : ibmcloud cos public-access-block-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos public-access-block-get --bucket my-bucket

Retirer la configuration de blocage d'accès public d'un compartiment

• Action : supprimer la configuration de blocage de l'accès public d'un compartiment.
• Utilisation : ibmcloud cos public-access-block-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.
    • Indicateur : --region REGION
  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.
    • Indicateur : --output FORMAT

Exemple :

ibmcloud cos public-access-block-delete --bucket my-bucket

Importer des objets à l'aide d' S3Manager

• Action: permet de télécharger simultanément des objets dans COS.
• Utilisation : ibmcloud cos upload --bucket BUCKET_NAME --key KEY --file PATH [--concurrency value] [--max-upload-parts PARTS] [--part-size SIZE] [--leave-parts-on-errors] [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-length SIZE] [--content-md5 MD5] [--content-type MIME] [--metadata MAP] [--region REGION] [--output FORMAT]
• Paramètres à fournir :

  • Nom (BUCKET_NAME) du compartiment.

    • Indicateur : --bucket BUCKET_NAME

  • Clé de l'objet.

    • Indicateur : --key KEY

  • Chemin d'accès au fichier à envoyer par téléchargement.

    • Indicateur : --file PATH

  • Facultatif : nombre de routines go à lancer en parallèle par appel à la fonction Upload lors de l'envoi de parties. La valeur par défaut est 5.

    • Indicateur : --concurrency value

  • Facultatif : nombre maximal de PARTS qui seront téléchargées sur S3, qui calcule la taille en parties de l'objet à télécharger. La limite est fixée à 10 000 parties.

    • Indicateur : --max-upload-parts PARTS

  • Facultatif : la TAILLE (en octets) du tampon à utiliser lors de la mise en tampon des données par blocs et de leur envoi par parties vers S3. La plus petite taille de partie autorisée est de 5 Mo.

    • Indicateur : --part-size SIZE

  • Facultatif : si vous définissez cette valeur sur true, le SDK évitera d'appeler la méthode AbortMultipartUpload en cas d'échec, laissant toutes les parties téléchargées avec succès sur S3 pour une récupération manuelle.

    • Indicateur : --leave-parts-on-errors

  • Facultatif : spécifie les CACHING_DIRECTIVES pour la chaîne de requêtes/réponses.

    • Indicateur : --cache-control CACHING_DIRECTIVES

  • Facultatif : précise des informations relatives à la mise en page (DIRECTIVES).

    • Indicateur : --content-disposition DIRECTIVES

  • Facultatif : précise quels encodages de contenu (CONTENT_ENCODING) ont été appliqués à l’objet et, par conséquent, quels mécanismes de décodage doivent être utilisés pour obtenir le type de média référencé par le champ d’en-tête Content-Type.

    • Indicateur : --content-encoding CONTENT_ENCODING

  • Facultatif : la LANGUE dans laquelle le contenu est rédigé.

    • Indicateur : --content-language LANGUAGE

  • Facultatif : TAILLE du corps en octets. Ce paramètre est utile lorsque la taille du corps ne peut pas être déterminée automatiquement.

    • Indicateur : --content-length SIZE

  • Facultatif : le résumé des données au format MD5 (128 bits) de l' base64-encoded.

    • Indicateur : --content-md5 MD5

  • Facultatif : un type MIME standard décrivant le format des données de l'objet.

    • Indicateur : --content-type MIME

  • Facultatif : une carte (MAP) des métadonnées à stocker. Le préfixe file:// peut être utilisé pour charger la structure JSON à partir d'un fichier.

    • Indicateur : --metadata MAP

      	{
      		"file_name": "file_20xxxxxxxxxxxx45.zip",
      		"label": "texas",
      		"state": "Texas",
      		"Date_to": "2019-11-09T16:00:00.000Z",
      		"Sha256sum": "9e39dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx8ce6b68ede3a47",
      		"Timestamp": "Thu, 17 Oct 2019 09:22:13 GMT"
      	}
      

  • Facultatif : la RÉGION dans laquelle se trouve le compartiment. Si cette option n'est pas fournie, le programme utilise l'option par défaut qui est spécifiée dans la configuration.

    • Indicateur : --region REGION

  • Facultatif : le FORMAT de sortie ne peut être que json ou texte.

    • Indicateur : --output FORMAT

bucket-exists

• Action : attendre la réception d'une réponse 200 lors d'une interrogation avec head-bucket.
• Utilisation : ibmcloud cos wait bucket-exists --bucket BUCKET_NAME [--region REGION]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment.
    • Indicateur : --region REGION

Exemple :

ibmcloud cos wait bucket-exists --bucket my-bucket

bucket-not-exists

• Action : attendre de recevoir une réponse 404 lors de l'interrogation avec head-bucket.
• Utilisation : ibmcloud cos wait bucket-not-exists --bucket BUCKET_NAME [--region REGION]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment.
    • Indicateur : --region REGION

Exemple :

ibmcloud cos wait bucket-not-exists --bucket my-bucket

objet-existe

• Action : attendre la réception d'une réponse 200 lors d'une interrogation avec head-object.
• Utilisation : ibmcloud cos wait object-exists --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--part-number NUMBER] [--region REGION]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Clé de l'objet.
    • Indicateur : --key KEY
  • Facultatif : ne renvoyer l'objet que si son identifiant d'entité (ETag) correspond à l'ETAG fourni.
    • Indicateur : --if-match ETAG
  • Facultatif : ne renvoyer l'objet que s'il a été modifié depuis l'horodatage (TIMESTAMP) spécifié.
    • Indicateur : --if-modified-since TIMESTAMP
  • Facultatif : ne renvoyer l'objet que si son ETag ne correspond pas à l'ETAG fourni.
    • Indicateur : --if-none-match ETAG
  • Facultatif : ne renvoyer l'objet que s'il n'a pas été modifié depuis le TIMESTAMP spécifié.
    • Indicateur : --if-unmodified-since TIMESTAMP
  • Facultatif : télécharge la PLAGE d'octets spécifiée d'un objet.
    • Indicateur : --range RANGE
  • Facultatif : NUMÉRO de pièce de l'objet en cours de lecture.
    • Indicateur : --part-number NUMBER
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment.
    • Indicateur : --region REGION

Exemple :

ibmcloud cos wait object-exists --bucket my-bucket --key my-object.txt

objet-inexistant

• Action : attendre de recevoir une réponse 404 lors de l'interrogation avec head-object.
• Utilisation : ibmcloud cos wait object-not-exists --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--part-number NUMBER] [--region REGION]
• Paramètres à fournir :
  • Nom du compartiment.
    • Indicateur : --bucket BUCKET_NAME
  • Clé de l'objet.
    • Indicateur : --key KEY
  • Facultatif : ne renvoyer l'objet que si son identifiant d'entité (ETag) correspond à l'ETAG fourni.
    • Indicateur : --if-match ETAG
  • Facultatif : ne renvoyer l'objet que s'il a été modifié depuis l'horodatage (TIMESTAMP) spécifié.
    • Indicateur : --if-modified-since TIMESTAMP
  • Facultatif : ne renvoyer l'objet que si son ETag ne correspond pas à l'ETAG fourni.
    • Indicateur : --if-none-match ETAG
  • Facultatif : ne renvoyer l'objet que s'il n'a pas été modifié depuis le TIMESTAMP spécifié.
    • Indicateur : --if-unmodified-since TIMESTAMP
  • Facultatif : télécharge la PLAGE d'octets spécifiée d'un objet.
    • Indicateur : --range RANGE
  • Facultatif : NUMÉRO de pièce de l'objet en cours de lecture.
    • Indicateur : --part-number NUMBER
  • Facultatif : la RÉGION dans laquelle se trouve le compartiment.
    • Indicateur : --region REGION

Exemple :

ibmcloud cos wait object-not-exists --bucket my-bucket --key my-object.txt