Documentación de Oracle Cloud Infrastructure

Enviar Solicitudes

Siga estas directrices al crear solicitudes de envío mediante la API de REST de dominios de identidad.

Estructura de URL

Acceda a la API de REST de los dominios de identidad a través de una URL, que incluye el punto final de REST, el recurso al que desea acceder y cualquier parámetro de consulta que desee incluir en una solicitud. Obtenga la estructura de URL completa para la API de REST de los dominios de identidad del administrador de Oracle Cloud o del administrador del dominio de identidad.

Punto final básico

El punto final básico para la API de REST de los dominios de identidad es:

https://<domainURL>/

Donde: domainURL representa la URL específica del dominio. Para obtener esta URL mediante la consola de dominios de identidad, consulte Búsqueda de una URL de dominio de identidad.

También puede obtener esta URL del administrador de Oracle Cloud o del administrador del dominio de identidad.

Puntos finales de recurso

Cuando crea un nuevo recurso o realiza una búsqueda de miembros de un tipo de recurso, agrega el nombre del recurso. Por ejemplo, al enviar una solicitud POST para crear un nuevo usuario, utilice el punto final:

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

Recursos específicos dentro de un punto final

Para acceder a un recurso específico, agregue el valor del atributo id para ese recurso al punto final del recurso. Por ejemplo, si ha creado un usuario y la respuesta a la solicitud POST ha incluido el valor ocid ocid1.user.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx en el cuerpo de la respuesta, debería utilizar el siguiente punto final para acceder a ese recurso de usuario específico en las siguientes solicitudes GET, PATCH o PUT:

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

Métodos admitidos

La API de REST de los dominios de identidad admite los siguientes métodos de solicitud.
Nota

Los métodos soportados dependen del punto final.
Método HTTP Descripción
GET Busque recursos o busque un recurso específico por ID.
HEAD Compruebe la existencia y/o modificación del recurso. No devuelve un cuerpo de respuesta. Sólo Lectura.
POST Cree, cambie, restablezca, importe, autentique, programe o cree una solicitud de búsqueda en los recursos del dominio de identidad.
PUT Sustituya (actualice completamente) un recurso de dominio de identidad existente, active o desactive un recurso de dominio de identidad, etc.
PATCH Modificar (actualizar parcialmente) los recursos del dominio de identidad.
DELETE Suprimir o cancelar recursos de dominio de identidad.
OPTIONS Recupere las operaciones permitidas para el punto final.

Cabeceras soportadas

La API de REST de dominios de identidad soporta las siguientes cabeceras que se pueden transferir en la sección de cabecera de la solicitud o respuesta HTTP.

Cabecera Descripción Ejemplo
Content-Type Tipo de medio del cuerpo de la solicitud. Necesario para las solicitudes POST y PUT. Content-Type: application/scim+json Content-Type: application/json
Authorization

Token de acceso OAuth utilizado para acceder a los recursos protegidos

O las firmas de solicitud en el encabezado Autorización

 Los tokens de acceso son cadenas muy largas. Este ejemplo se ha truncado: Bearer VkdVAZrb_fw......eyJ4NXQjUzI1Ni