Oracle Cloud Infrastructure - Dokumentation

Anforderungen senden

Befolgen Sie diese Richtlinien, wenn Sie Sendeanforderungen mit der REST-API für Identitätsdomains erstellen.

URL-Struktur

Greifen Sie über eine URL auf die REST-API für Identitätsdomains zu. Diese enthält den REST-Endpunkt, die Ressource, auf die Sie zugreifen möchten, und alle Abfrageparameter, die Sie in eine Anforderung aufnehmen möchten. Rufen Sie die vollständige URL-Struktur für die Identitätsdomains-REST-API von Ihrem Oracle Cloud-Administrator oder Identitätsdomainadministrator ab.

Basisendpunkt

Der grundlegende Endpunkt für die REST-API für Identitätsdomains ist:

https://<domainURL>/

Dabei steht domainURL für die domänenspezifische URL. Informationen zum Abrufen dieser URL mit der Identitätsdomainkonsole finden Sie unter Identitätsdomain-URL suchen.

Alternativ können Sie diese URL von Ihrem Oracle Cloud-Administrator oder Identitätsdomainadministrator abrufen.

Ressourcenendpunkte

Wenn Sie eine neue Ressource erstellen oder nach Elementen eines Ressourcentyps suchen, hängen Sie den Namen der Ressource an. Beispiel: Wenn Sie eine POST-Anforderung zum Erstellen eines neuen Benutzers senden, verwenden Sie den Endpunkt:

https://<domainURL>/admin/v1/Users

Bestimmte Ressourcen innerhalb eines Endpunkts

Um auf eine bestimmte Ressource zuzugreifen, hängen Sie den Wert des Attributs id für diese Ressource an den Ressourcenendpunkt an. Beispiel: Wenn Sie einen Benutzer erstellt haben und die Antwort auf Ihre POST-Anforderung den ocid-Wert ocid1.user.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx im Antwortbody enthielt, können Sie mit dem folgenden Endpunkt auf diese bestimmte Benutzerressource in nachfolgenden GET,-PATCH- oder PUT-Anforderungen zugreifen:

https://<domainURL>/admin/v1/Users/ocid1.user.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Unterstützte Methoden

Die REST-API für Identitätsdomains unterstützt die folgenden Anforderungsmethoden.
Hinweis

Die unterstützten Methoden hängen vom Endpunkt ab.
HTTP-Methode Beschreibung
GET Suchen Sie nach Ressourcen, oder suchen Sie nach einer bestimmten Ressource nach ID.
HEAD Prüfen Sie auf Vorhandensein und/oder Änderung der Ressource. Gibt keinen Antwortbody zurück. Schreibgeschützt.
POST Erstellen, ändern, zurücksetzen, importieren, authentifizieren, planen oder erstellen Sie eine Suchanforderung für Identitätsdomainressourcen.
PUT Ersetzen (vollständiges Aktualisieren) Sie eine vorhandene Identitätsdomainressource, aktivieren oder deaktivieren Sie eine Identitätsdomainressource usw.
PATCH Identitätsdomainressourcen ändern (teilweise aktualisieren).
DELETE Identitätsdomainressourcen löschen oder abbrechen.
OPTIONS Rufen Sie die zulässigen Vorgänge für den Endpunkt ab.

Unterstützte Header

Die REST-API für Identitätsdomains unterstützt die folgenden Header, die im Headerabschnitt der HTTP-Anforderung oder -Antwort übergeben werden können.

Header Beschreibung Beispiel
Content-Type Medientyp des Hauptteils der Anforderung. Erforderlich für POST- und PUT-Anforderungen. Content-Type: application/scim+json Content-Type: application/json
Authorization

Das Zugriffstoken OAuth, mit dem auf geschützte Ressourcen zugegriffen wird

Oder die Anforderungssignaturen im Autorisierungsheader

 Zugriffstoken sind sehr lange Zeichenfolgen. Dieses Beispiel wurde abgeschnitten: Bearer VkdVAZrb_fw......eyJ4NXQjUzI1Ni