cURL verwenden

In den meisten Umgebungen können Sie die Arbeit mit der Befehlszeile optimal nutzen, indem Sie die folgenden Seiten besuchen: IBM® Storage Ceph® as a Service und cURL.

Im Folgenden finden Sie ein Cheat-Sheet der grundlegenden curl-Befehle für die IBM® Storage Ceph® as a Service-REST-API.

Die Verwendung von curl setzt eine gewisse Vertrautheit mit der Befehlszeile und Object Storage voraus und erfordert die erforderlichen Informationen aus einem Berechtigungsnachweis, der Endpunktreferenz oder der Konsole. Unbekannte Begriffe oder Variablen finden Sie im Glossar.

Hinweis: Personenbezogene Daten (PII): Verwenden Sie bei der Benennung von Buckets oder Objekten keine Informationen, anhand derer ein Nutzer (eine natürliche Person) durch Namen, Standort oder auf andere Weise identifiziert werden kann.

IAM-Token anfordern

Es gibt zwei Möglichkeiten, ein IAM- oauth-Token zur Authentifizierung von Anfragen zu generieren: entweder mithilfe des Befehls „ curl “ mit einem API-Schlüssel (wird später beschrieben) oder über die Befehlszeile mithilfe der IBM Cloud®-CLI.

IAM-Token mit API-Schlüssel anfordern

Stellen Sie sicher, dass Sie über einen API-Schlüssel verfügen. Sie können ihn über IBM Cloud® Identity and Access Management anfordern.

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"

Ressourceninstanz-ID abrufen

Für einige der folgenden Befehle ist der Parameter ibm-service-instance-id erforderlich. Um diesen Wert zu ermitteln, wechseln Sie in der Cloud-Konsole auf die Registerkarte „Anmeldeinformationen“ Ihrer „ Object Storage “-Instanz. Erstellen Sie bei Bedarf eine Berechtigung und rufen Sie anschließend über das Menü „Berechtigungen anzeigen“ das JSON-Format auf. Verwenden Sie den Wert von resource_instance_id.

Zur Verwendung mit curl-APIs benötigen Sie nur die UUID, die nach dem letzten einfachen Doppelpunkt beginnt und vor dem letzten doppelten Doppelpunkt endet. Beispielsweise kann die ID „ crn:v1:bluemix:public:software-defined-storage:global:a/81caa0254631ce5f9330ae427618f209:39d8d161-22c4-4b77-a856-f11db5130d7d:: “ zu „ 39d8d161-22c4-4b77-a856-f11db5130d7d “ abgekürzt werden.

Nächste Schritte

Die ausführliche Beschreibung der RESTful API für IBM Storage Ceph as a Service finden Sie in der IBM Storage Ceph as a Service Object Storage API-Dokumentation.