Oracle Cloud Infrastructure - Dokumentation

cURL verwenden

cURL ist ein Open-Source-Befehlszeilentool für die Übertragung von Daten mit URL-Syntax, das verschiedene Protokolle unterstützt, einschließlich HTTP und HTTPS. In den Beispielen in diesem Dokument wird mit cURL demonstriert, wie auf die REST-API für Identitätsdomains zugegriffen wird.

cURL für den Zugriff auf die REST-APIs verwenden

  1. Installieren Sie cURL. Siehe Schritt 2: cURL installieren.

  2. Legen Sie in einem Befehlsfenster die cURL-Umgebungsvariable CURL_CA_BUNDLE auf den Speicherort des lokalen CA-Zertifikats-Bundles fest. Informationen zur CA-Zertifikatverifizierung mit cURL finden Sie unter: http://curl.haxx.se/docs/sslcerts.html.

    Hinweis

    Weitere Informationen zu Autorisierungs- und Authentifizierungsanforderungen finden Sie unter Autorisierung.

  3. Rufen Sie cURL auf, und geben Sie eine oder mehrere der folgenden Befehlszeilenoptionen an, um die Ausführung zu leiten.

    • -d, --data @file.json: Gibt das Anforderungsdokument im JSON-Format auf dem lokalen Rechner an.
    • -F, --form @file.json: Gibt Formulardaten im JSON-Format auf dem lokalen Rechner an.
    • -H, --header: Definiert den Anforderungsheader im Format HEADER: VALUE. Die Headerwerte hängen davon ab, auf welchen Endpunkt Sie zugreifen.

      • Der Inhaltstyp des Anforderungsdokuments.

      • Die X-Client-ID, API_KEY_ID, für die Autorisierung von OAuth 2.0

      • Die X-Client-Secret, API_KEY_SECRET, für die OAuth2.0-Autorisierung

    • -i: Zeigt Antwortheaderinformationen an.
    • -X: Gibt die HTTP-Anforderungsmethode (DELETE, GET, POST, PATCH oder PUT). an Wenn diese Option ausgelassen wird, lautet der Standardwert GET.

Die cURL-Befehls-URL

Die mit dem cURL-Befehl verwendete URL entspricht der unter Anforderungen senden beschriebenen URL. Sie müssen jedoch Leerzeichen in der URL durch Pluszeichen (+) ersetzen und Anführungszeichen (") durch %22 ersetzen.

Alle Zeichen in einer URL, die sich außerhalb des ASCII-Zeichensatzes befinden, wie Leerzeichen und Anführungszeichen, müssen URL-codiert sein. Beispiel: Die folgende URL enthält eine Filterabfrage, die nach einem Benutzer mit einem Benutzernamen sucht, der entweder jen enthält oder mit bj beginnt. Beachten Sie, dass er Leerzeichen enthält.

https://<domainURL>/admin/v1/Users?filter=userName co "jen" or userName sw "bj"

Um diese URL in einer cURL-Befehlszeile zu verwenden, ändern Sie sie in: 

https://<domainURL>/admin/v1/Users?filter=userName+co+%22jen%22+or+userName+sw+%22bj%22

cURL-Befehl zum Senden einer GET-Anforderung

curl 
-H "Accept: application/scim+json" 
-H "Authorization: Bearer <really long access token here>" 
-G https://<domainURL>/admin/v1/Groups?filter=displayName+co+%22admin%22"

cURL-Befehl zum Senden einer POST-Anforderung

curl 
-H "Content-Type: application/scim+json" 
-H "Authorization: Bearer <really long access token here>" 
-d '{ "schemas": ["urn:ietf:params:scim:schemas:core:2.0:User"],"userName":"bjensen@example.com","name": {"familyName":"Jensen","givenName": "Barbara","middleName": "Jane"},"emails": [{"value": "bjensen@example.com","type": "work","primary": true}]}' "https://<domainURL>/admin/v1/Users"