Documentazione di Oracle Cloud Infrastructure

Invia richieste

Seguire queste linee guida quando si creano richieste di invio utilizzando l'API REST dei domini di Identity.

Struttura URL

Accede all'API REST dei domini di Identity tramite un URL che include l'endpoint REST, la risorsa a cui si desidera accedere ed eventuali parametri di query da includere in una richiesta. Ottenere la struttura URL completa per l'API REST dei domini di Identity dall'amministratore di Oracle Cloud o dall'amministratore del dominio di Identity.

Endpoint di base

L'endpoint di base per l'API REST dei domini di Identity è:

https://<domainURL>/

Dove: domainURL rappresenta l'URL specifico del dominio. Per ottenere questo URL mediante la console dei domini di Identity, vedere Ricerca di un URL del dominio di Identity.

In alternativa, ottenere questo URL dall'amministratore di Oracle Cloud o del dominio di Identity.

Endpoint risorse

Quando si crea una nuova risorsa o si esegue una ricerca di membri di un tipo di risorsa, si aggiunge il nome della risorsa. Ad esempio, quando si invia una richiesta POST per creare un nuovo utente, si utilizza l'endpoint:

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

Risorse specifiche all'interno di un endpoint

Per accedere a una risorsa specifica, è possibile aggiungere il valore dell'attributo id per tale risorsa all'endpoint della risorsa. Ad esempio, se è stato creato un utente e la risposta alla richiesta POST includeva il valore ocid ocid1.user.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx nel corpo della risposta, utilizzare l'endpoint seguente per accedere a tale risorsa utente specifica nelle successive richieste GET, PATCH o PUT:

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

Metodi supportati

L'API REST dei domini di Identity supporta i metodi di richiesta riportati di seguito.
Nota

I metodi supportati dipendono dall'endpoint.
Metodo HTTP descrizione;
GET Cercare risorse o cercare una risorsa specifica in base all'ID.
HEAD Verificare l'esistenza e/o la modifica della risorsa. Non restituisce un corpo di risposta. Sola lettura.
POST Crea, modifica, reimposta, importa, autentica, pianifica o crea una richiesta di ricerca nelle risorse del dominio di Identity.
PUT Sostituire (aggiornare completamente) una risorsa del dominio di Identity esistente, attivare o disattivare una risorsa del dominio di Identity e così via.
PATCH Modificare (aggiornare parzialmente) le risorse del dominio di Identity.
DELETE Elimina o annulla le risorse del dominio di Identity.
OPTIONS Recupera le operazioni consentite per l'endpoint.

Header supportati

L'API REST dei domini di Identity supporta le intestazioni riportate di seguito che possono essere passate nella sezione dell'intestazione della richiesta o della risposta HTTP.

Intestazione descrizione; Esempio
Content-Type Tipo di supporto del corpo della richiesta. Obbligatorio per le richieste POST e PUT. Content-Type: application/scim+json Content-Type: application/json
Authorization

Il token di accesso OAuth utilizzato per accedere alle risorse protette

Oppure le firme della richiesta nell'intestazione dell'autorizzazione

 I token di accesso sono stringhe molto lunghe. Questo esempio è stato troncato: Bearer VkdVAZrb_fw......eyJ4NXQjUzI1Ni