tipo de recurso domain

  • Artículo

Espacio de nombres: microsoft.graph

Representa un dominio asociado al inquilino.

Use operaciones de dominio para asociar dominios a un inquilino, comprobar la propiedad del dominio y configurar los servicios admitidos. Las operaciones de dominio permiten a los registradores automatizar la asociación de dominios para servicios como Microsoft 365. Por ejemplo, como parte del registro de dominio, un registrador puede habilitar un dominio de vanidad para correo electrónico, sitios web, autenticación, etc.

Para asociar un dominio a un inquilino:

  1. Asocie un dominio a un inquilino.

  2. Recupere los registros de comprobación de dominio. Agregue los detalles del registro de verificación al archivo de zona del dominio mediante la configuración del registrador de dominios o del servidor DNS.

  3. Compruebe la propiedad del dominio. Esto comprueba el dominio y establece la propiedad isVerified en true.

  4. Indique los servicios admitidos que tiene previsto usar con el dominio.

  5. Configure los servicios admitidos recuperando una lista de registros necesarios para habilitar los servicios para el dominio. Agregue los detalles del registro de configuración al archivo de zona del dominio mediante la configuración del registrador de dominios o del servidor DNS.

Métodos

Método Tipo de valor devuelto Descripción
Obtener dominio domain Lee las propiedades y las relaciones de un objeto de dominio.
Crear dominio domain Agregue un dominio al inquilino.
Enumerar dominio domain Recupere todos los dominios vinculados al inquilino.
Lista domainNameReference Colección directoryObject Recupere una lista de objetos de directorio con una referencia al dominio.
Enumerar serviceConfigurationRecords colección domainDnsRecord Recupere una lista de registros DNS de dominio para la configuración del dominio.
Comprobación de listaDnsRecords colección domainDnsRecord Recupere una lista de registros DNS de dominio para la comprobación del dominio.
Actualizar dominio domain Novedades un dominio.
Eliminar dominio Ninguno Elimina un dominio.
Dominio ForceDelete Ninguno Elimina un dominio mediante una operación asincrónica.
Comprobar dominio domain Valide la propiedad del dominio.
Promover dominio Booleano Promover un subdominio comprobado al dominio raíz.

Propiedades

Propiedad Tipo Description
authenticationType Cadena Indica el tipo de autenticación configurado para el dominio. El valor es o ManagedFederated. Managedindica un dominio administrado en la nube donde Microsoft Entra ID realiza la autenticación de usuario. Federatedindica que la autenticación está federada con un proveedor de identidades, como el Active Directory local del inquilino a través de Servicios de federación de Active Directory (AD FS). No admite valores NULL.

Para actualizar esta propiedad en escenarios delegados, a la aplicación que realiza la llamada se le debe asignar el permiso delegado Directory.AccessAsUser.All .
availabilityStatus Cadena Esta propiedad siempre null es excepto cuando se usa la acción de comprobación . Cuando se usa la acción de comprobación , se devuelve una entidad de dominio en la respuesta. La propiedad availabilityStatus de la entidad de dominio en la respuesta es AvailableImmediately o EmailVerifiedDomainTakeoverScheduled.
id Cadena Nombre completo del dominio. Clave, inmutable, no que acepta valores NULL, única.
isAdminManaged Booleano El valor de la propiedad es false si la administración de registros DNS del dominio se delega en Microsoft 365. De lo contrario, el valor es true. No admite valores NULL
isDefault Booleano true si este es el dominio predeterminado que se usa para la creación del usuario. Solo hay un dominio predeterminado por empresa. No admite valores NULL
isInitial Booleano true si este es el dominio inicial creado por Microsoft Online Services (contoso.com). Solo hay un dominio inicial por empresa. No admite valores NULL
isRoot Booleano true si el dominio es un dominio raíz comprobado. De lo contrario, false si el dominio es un subdominio o no comprobado. No admite valores NULL
isVerified Booleano true si el dominio ha completado la comprobación de la propiedad del dominio. No admite valores NULL
passwordNotificationWindowInDays Int32 Especifica el número de días antes de que un usuario reciba la notificación de que su contraseña expirará. Si no se establece la propiedad, se usa un valor predeterminado de 14 días.
passwordValidityPeriodInDays Int32 Especifica el período de tiempo que una contraseña es válida antes de que se deba cambiar. Si no se establece la propiedad, se usa un valor predeterminado de 90 días.
state domainState Estado de las operaciones asincrónicas programadas para el dominio.
supportedServices Colección string Funcionalidades asignadas al dominio. Puede incluir 0, 1 o más de los siguientes valores: Email, Sharepoint, , EmailInternalRelayOnly, OfficeCommunicationsOnlineSharePointDefaultDomain, FullRedelegation, SharePointPublic, OrgIdAuthentication, , YammerIntune. Los valores que puede agregar o quitar mediante la API incluyen: Email, OfficeCommunicationsOnline, Yammer. No admite valores NULL.

Relaciones

Las relaciones entre un dominio y otros objetos del directorio, como sus registros de verificación y los registros de configuración del servicio, se exponen a través de las propiedades de navegación. Puede leer estas relaciones si tiene como destino estas propiedades de navegación en las solicitudes.

Relación Tipo Descripción
domainNameReferences Colección directoryObject Objetos como usuarios y grupos que hacen referencia al identificador de dominio. Solo lectura, admite valores NULL. Admite $expand y $filter por el tipo de objetos OData devueltos. Por ejemplo, /domains/{domainId}/domainNameReferences/microsoft.graph.user y /domains/{domainId}/domainNameReferences/microsoft.graph.group.
serviceConfigurationRecords colección domainDnsRecord DNS registra el cliente agrega al archivo de zona DNS del dominio antes de que los servicios de Microsoft Online puedan usar el dominio. Solo lectura, admite valores NULL. Admite $expand.
verificationDnsRecords colección domainDnsRecord DNS registra que el cliente agrega al archivo de zona DNS del dominio antes de que el cliente pueda completar la comprobación de la propiedad del dominio con Microsoft Entra ID. Solo lectura, admite valores NULL. Admite $expand.
federationConfiguration internalDomainFederation Configuración de dominio configurada por un cliente cuando se federa con Microsoft Entra ID. Admite $expand.

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "authenticationType": "String",
  "availabilityStatus": "String",
  "id": "String (identifier)",
  "isAdminManaged": true,
  "isDefault": true,
  "isInitial": true,
  "isRoot": true,
  "isVerified": true,
  "passwordNotificationWindowInDays": 14,
  "passwordValidityPeriodInDays": 90,
  "state": {"@odata.type": "microsoft.graph.domainState"},
  "supportedServices": ["String"]
}