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. La comprobación de un dominio a través de Microsoft Graph no configura el dominio para su uso con Office 365 servicios como Exchange. La configuración completa del dominio para que funcione con productos de Microsoft 365 puede requerir pasos adicionales. Para obtener más información, consulte Configuración del administrador de Microsoft 365.

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
List domain Recupere todos los dominios vinculados al inquilino.
Crear domain Agregue un dominio al inquilino.
Get domain Lee las propiedades y las relaciones de un objeto de dominio.
Obtención del dominio raíz domain Obtenga el dominio raíz de un subdominio.
Actualizar domain Novedades un dominio.
Delete Ninguno Elimina un dominio.
Forzar eliminación Ninguno Elimina un dominio mediante una operación asincrónica.
Verificar domain Valide la propiedad del dominio.
Promover Booleano Promover un subdominio comprobado al dominio raíz.
Enumerar referencias de nombre de dominio Colección directoryObject Recupere una lista de objetos de directorio con una referencia al dominio.
Enumerar registros de configuración de servicio colección domainDnsRecord Recupere una lista de registros DNS de dominio para la configuración del dominio.
Enumeración de registros DNS de comprobación colección domainDnsRecord Recupere una lista de registros DNS de dominio para la comprobación del dominio.

Propiedades

Propiedad Tipo Descripción
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 completó 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 expira. 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. No admite $expand. Admite $filter el tipo de objetos OData devuelto. Por ejemplo, /domains/{domainId}/domainNameReferences/microsoft.graph.user y /domains/{domainId}/domainNameReferences/microsoft.graph.group.
federationConfiguration internalDomainFederation Configuración de dominio configurada por un cliente cuando se federa con Microsoft Entra ID. No admite $expand.
rootDomain domain Dominio raíz de un subdominio. Solo lectura, admite valores NULL. Admite $expand.
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. No 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. No 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"]
}