Partilhar via


Criar domínio

Namespace: microsoft.graph

Adiciona um domínio ao inquilino.

Importante: não pode utilizar um domínio associado ao seu inquilino Microsoft Entra até que a propriedade seja verificada. Veja List verificationDnsRecords (Verificação de lista)DnsRecords (Registos ) para obter detalhes. Os domínios de raiz requerem verificação. Por exemplo, contoso.com requer verificação. Se um domínio de raiz for verificado, os subdomínios do domínio de raiz são verificados automaticamente. Por exemplo, subdomain.contoso.com é verificado automaticamente se contoso.com foi verificado.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Domain.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Domain.ReadWrite.All Indisponível.

Importante

Em cenários delegados com contas escolares ou profissionais, o utilizador com sessão iniciada tem de ter uma função de Microsoft Entra suportada ou uma função personalizada com uma permissão de função suportada. O Administrador de Nome de Domínio é a função com menos privilégios suportada para esta operação.

Solicitação HTTP

POST /domains

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto domain.

O corpo do pedido contém a propriedade ID do novo domínio. O ID é a única propriedade que pode ser especificada e é necessária. O valor da propriedade ID é o nome de domínio completamente qualificado a criar.

Resposta

Se bem-sucedido, este método retorna o código de resposta 201 Created e o objeto domain no corpo da resposta.

Exemplo

Solicitação

No corpo da solicitação, forneça uma representação JSON do objeto domain.

POST https://graph.microsoft.com/v1.0/domains
Content-type: application/json

{
  "id": "contoso.com"
}
Resposta

Observação: o objeto de resposta exibido aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-type: application/json

{
  "authenticationType": "authenticationType-value",
  "availabilityStatus": "availabilityStatus-value",
  "id": "contoso.com",
  "isAdminManaged": true,
  "isDefault": true,
  "isInitial": true,
  "isRoot": true
}