Documentação do Oracle Cloud Infrastructure

Enviar Solicitações

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

Estrutura de URL

Acesse a API REST dos 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 de URL completa para a API REST de domínios de identidades do administrador do Oracle Cloud ou do administrador de domínios 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 administrador do domínio de identidades.

Pontos Finais do Recurso

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

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

Recursos Específicos Dentro de um Ponto Final

Para acessar um recurso específico, anexe o valor do atributo id desse recurso ao ponto final do recurso. Por exemplo, se você criou um Usuário e a resposta à sua solicitação POST incluiu o valor ocid ocid1.user.oc1..xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx no corpo da resposta, use o ponto final a seguir 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 dos domínios de identidades suporta os métodos de solicitação a seguir.
Observação

Os métodos suportados dependem do ponto final.
Método HTTP Descrição
GET Procure 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 etc.
PATCH Modifique (atualização parcial) recursos do domínio de identidades.
DELETE Exclua ou cancele recursos do domínio de identidades.
OPTIONS Recupere as operações permitidas para o ponto final.

Cabeçalhos com Suporte

A API REST dos 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