Documentazione dell'infrastruttura Oracle Cloud

Invia richieste

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

Struttura URL

Accedere all'API REST dei domini di Identity tramite un URL, che include l'endpoint REST, la risorsa a cui si desidera accedere e qualsiasi parametro di query che si desidera 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 identità è:

https://<domainURL>/

Dove: domainURL rappresenta l'URL specifico del dominio. Per ottenere questo URL utilizzando 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 dall'amministratore 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, 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 richieste GET, PATCH successive 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 per ID.
HEAD Verificare l'esistenza e/o la modifica della risorsa. Non restituisce un corpo risposta. Sola lettura.
POST Creare, modificare, reimpostare, importare, autenticare, pianificare o creare una richiesta di ricerca per le 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 Eliminare o annullare le risorse del dominio di Identity.
OPTIONS Recupera le operazioni consentite per l'endpoint.

Intestazioni supportate

L'API REST dei domini di Identity supporta le intestazioni seguenti che possono essere passate nella sezione di 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

Token di accesso OAuth utilizzato per accedere alle risorse protette

Oppure le firme della richiesta nell'intestazione di autorizzazione

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