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, die den REST-Endpunkt, die Ressource, auf die Sie zugreifen möchten, und alle Abfrageparameter enthält, die Sie in eine Anforderung aufnehmen möchten. Rufen Sie die vollständige URL-Struktur für die REST-API für Identitätsdomains von Ihrem Oracle Cloud-Administrator oder Identitätsdomainadministrator ab.

Basisendpunkt

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

https://<domainURL>/

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

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

Ressourcenendpunkte

Wenn Sie eine neue Ressource erstellen oder nach Mitgliedern 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 die POST-Anforderung den ocid-Wert ocid1.user.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx im Antwortbody enthielt, verwenden Sie den folgenden Endpunkt, um in nachfolgenden GET, PATCH- oder PUT-Anforderungen auf diese spezifische Benutzerressource zuzugreifen:

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

Unterstützte Verfahren

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 ID nach einer bestimmten Ressource.
HEAD Prüfen Sie, ob Ressourcen vorhanden und/oder geändert sind. Gibt keinen Antworttext zurück. Schreibgeschützt.
POST Erstellen, ändern, zurücksetzen, importieren, authentifizieren, planen oder erstellen Sie eine Suchanforderung für Identitätsdomainressourcen.
PUT Ersetzen (vollständige Aktualisierung) einer vorhandenen Identitätsdomainressource, Aktivieren oder Deaktivieren einer 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.

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

Das Zugriffstoken OAuth für den Zugriff auf geschützte Ressourcen

Oder die Anforderungssignaturen im Autorisierungsheader

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