Utilisation cURL

Pour tirer le meilleur parti de la ligne de commande dans la plupart des environnements, consultez les sites IBM® Storage Ceph® as a Service et cURL.

Voici un "aide-mémoire" des commandes curl de base pour l'API REST d'IBM® Storage Ceph® as a Service.

L'utilisation d' curl suppose une certaine familiarité avec la ligne de commande et Object Storage, et disposer des informations nécessaires à partir d' un identifiant, de la référence des points de terminaison ou de la console. Si des termes ou des variables ne vous sont pas familiers, vous pourrez les retrouver dans le glossaire.

Remarque: Informations personnelles identifiables (PII): lorsque vous nommez des compartiments ou des objets, n'utilisez aucune information permettant d'identifier un utilisateur (personne physique) par son nom, son lieu de résidence ou tout autre moyen.

Demande de jeton IAM

Il existe deux façons de générer un jeton d' oauth IAM pour l'authentification des requêtes : soit en utilisant la commande « curl » avec une clé API (décrite plus loin), soit depuis la ligne de commande à l'aide de l'interface CLI d' IBM Cloud®.

Demande de jeton IAM à l'aide d'une clé d'API

Vérifiez que vous disposez d'une clé d'API. Vous pouvez en obtenir une à partir d'IBM Cloud® Identity and Access Management.

curl -X "POST" "https://iam.cloud.ibm.com/oidc/token" \
     -H 'Accept: application/json' \
     -H 'Content-Type: application/x-www-form-urlencoded' \
     --data-urlencode "apikey={api-key}" \
     --data-urlencode "response_type=cloud_iam" \
     --data-urlencode "grant_type=urn:ibm:params:oauth:grant-type:apikey"

Obtention de votre ID d'instance de ressource

Certaines des commandes ci-après requièrent un paramètre ibm-service-instance-id. Pour trouver cette valeur, accédez à l'onglet « Credentials » (Identifiants) de votre instance d' Object Storage s dans la console cloud. Créez un identifiant si nécessaire, puis utilisez le menu « Afficher les identifiants » pour consulter le format JSON. Utilisez la valeur de resource_instance_id.

Pour utiliser des API curl, vous n'avez besoin que de l'identificateur unique universel (UUID) qui débute après le dernier signe deux-points et se termine avant le double signe deux-points final. Par exemple, l'URL crn:v1:bluemix:public:software-defined-storage:global:a/81caa0254631ce5f9330ae427618f209:39d8d161-22c4-4b77-a856-f11db5130d7d:: peut être abrégée en 39d8d161-22c4-4b77-a856-f11db5130d7d.

Etapes suivantes

La description détaillée de l'API RESTful pour IBM Storage Ceph as a Service se trouve dans la documentation de l'API IBM Storage Ceph as a Service Object Storage.