cURL verwenden

Mit IBM® Storage Ceph® as a Service und cURL können Sie in den meisten Umgebungen die Arbeit mit der Befehlszeile optimal nutzen.

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: Persönlich identifizierbare Informationen (PII): Verwenden Sie bei der Benennung von Eimern oder Objekten keine Informationen, die einen Benutzer (eine natürliche Person) durch Namen, Standort oder andere Mittel identifizieren können.

IAM-Token anfordern

Es gibt zwei Möglichkeiten, ein IAM oauth-Token für die Authentifizierung von Anfragen zu generieren: über einen curl-Befehl mit einem API-Schlüssel (später beschrieben) oder über die Befehlszeile mit 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 finden, gehen Sie in der Cloud-Konsole auf die Registerkarte Credentials Ihrer Object Storage-Instanz. Erstellen Sie bei Bedarf einen Berechtigungsnachweis und verwenden Sie dann das Menü Berechtigungsnachweise anzeigen, um das JSON-Format anzuzeigen. 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. Zum Beispiel 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.