Documentação do Oracle Cloud Infrastructure

Enviar Solicitações

Siga essas diretrizes ao criar solicitações de envio usando a API REST dos domínios de identidades.

Estrutura de URL

Acesse a API REST de domínios de identidades por meio de um URL, que inclui o ponto final REST, o recurso que você deseja acessar e quaisquer parâmetros de consulta que você deseja incluir em uma solicitação. Obtenha a estrutura completa de URL para a API REST dos domínios de identidades do administrador do Oracle Cloud ou do domínio de identidades.

Ponto Final Básico

O ponto final básico da API REST de domínios de identidades é:

https://<domainURL>/

Em que: domainURL representa o URL específico do domínio. Para obter esse URL usando a Console de domínios de identidades, consulte Localizando um URL de Domínio de Identidades.

Como alternativa, obtenha esse URL do administrador do Oracle Cloud ou do domínio de identidades.

Pontos Finais do Recurso

Ao criar um novo recurso ou executar uma pesquisa por membros de um tipo de recurso, você anexa o nome do recurso. Por exemplo, quando você envia uma solicitação POST para criar um novo usuário, usa o ponto final:

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

Recursos Específicos em um Ponto Final

Para acessar um recurso específico, você anexa o valor do atributo id desse recurso ao ponto final do recurso. Por exemplo, se você tiver criado um Usuário e a resposta à sua solicitação POST tiver incluído o valor ocid ocid1.user.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx no corpo da resposta, use o seguinte ponto final para acessar esse recurso específico do Usuário nas solicitações subsequentes GET, PATCH ou PUT:

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

Métodos Suportados

A API REST de domínios de identidades suporta os seguintes métodos de solicitação.
Observação

Os métodos suportados dependem do ponto final.
Método HTTP Descrição
GET Pesquise recursos ou procure um recurso específico por ID.
HEAD Verifique a existência e/ou modificação do recurso. Não retorna um corpo de resposta. Somente leitura.
POST Crie, altere, redefina, importe, autentique, programe ou crie uma solicitação de pesquisa para recursos do domínio de identidades.
PUT Substitua (atualize totalmente) um recurso de domínio de identidades existente, ative ou desative um recurso de domínio de identidades e assim por diante.
PATCH Modificar (atualizar parcialmente) os recursos do domínio de identidades.
DELETE Exclua ou cancele recursos do domínio de identidades.
OPTIONS Recupera as operações permitidas para o ponto final.

Cabeçalhos suportados

A API REST de domínios de identidades suporta os cabeçalhos a seguir que podem ser informados na seção de cabeçalho da solicitação ou resposta HTTP.

Cabeçalho Descrição Exemplo
Content-Type Tipo de mídia do corpo da solicitação. Obrigatório para solicitações POST e PUT. Content-Type: application/scim+json Content-Type: application/json
Authorization

O token de acesso OAuth usado para acessar recursos protegidos

Ou as assinaturas de solicitação no cabeçalho Autorização

 Os tokens de acesso são strings muito longas. Este exemplo foi truncado: Bearer VkdVAZrb_fw......eyJ4NXQjUzI1Ni