Criar domínio

Namespace: microsoft.graph

Adiciona um domínio ao inquilino.

Importante: Você não pode usar um domínio associado ao seu locatário do Azure AD até que a propriedade seja verificada. Confira Listar verificationDnsRecords para obter mais detalhes. Os domínios raiz exigem verificação. Por exemplo, contoso.com exige verificação. Se um domínio raiz for verificado, os subdomínios do domínio raiz serão verificados automaticamente. Por exemplo, o subdominio.contoso.com é automaticamente verificado se contoso.com for verificado.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão	Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante)	Domain.ReadWrite.All
Delegada (conta pessoal da Microsoft)	Sem suporte.
Aplicativo	Domain.ReadWrite.All

Solicitação HTTP

POST /domains

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório.
Content-Type	application/json

Corpo da solicitação

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

O corpo da solicitação contém a propriedade id do novo domínio. Id é a única propriedade que pode ser especificada e isso é necessário. O valor da propriedade id é o nome de domínio totalmente qualificado para 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
}