tipo de recurso domain
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
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. 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:
Asocie un dominio a un inquilino.
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 del Sistema de nombres de dominio (DNS).
Compruebe la propiedad del dominio y establezca la propiedad
trueisVerified en .Indique los servicios admitidos que tiene previsto usar con el dominio.
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. |
| Obtener | domain | Lee las propiedades y las relaciones de un objeto de dominio. |
| Actualizar | domain | Actualizar un dominio. |
| Delete | Ninguno | Eliminar un dominio. |
| Forzar eliminación | Ninguno | Elimine 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. |
| Obtención del dominio raíz | Obtenga el dominio raíz de un subdominio. | |
| 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 para el dominio predeterminado que se usa para la creación de usuarios. Solo hay un dominio predeterminado por empresa. No admite valores NULL. |
| isInitial | Booleano |
true para el dominio inicial creado por Microsoft Online Services. Por ejemplo, contoso.onmicrosoft.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 para dominios comprobados. No admite valores NULL. |
| passwordNotificationWindowInDays | Int32 | Especifica el número de días antes de que un usuario reciba una notificación de expiración de contraseña. 14 días de forma predeterminada. |
| passwordValidityPeriodInDays | Int32 | Especifica el período de tiempo que una contraseña es válida antes de que se deba cambiar. 90 días de forma predeterminada. |
| supportedServices | Colección string | Funcionalidades asignadas al dominio. Puede incluir 0, 1o más de los siguientes valores: Email, Sharepoint, EmailInternalRelayOnly, OfficeCommunicationsOnline, ,SharePointDefaultDomain , SharePointPublicFullRedelegation, OrgIdAuthentication, Yammer, , CustomUrlDomainIntune. Los valores que puede agregar o quitar mediante la API incluyen: Email, OfficeCommunicationsOnline, Yammery CustomUrlDomain. No admite valores NULL. Para obtener más información sobre CustomUrlDomain, vea Dominios de dirección URL personalizados en inquilinos externos. |
| state | domainState | Estado de las operaciones asincrónicas programadas para el dominio. |
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 es compatible con $expand. Admite $filter el tipo de objetos OData devuelto. 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. No es compatible con $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 es compatible con $expand. |
| federationConfiguration | internalDomainFederation | Configuración de dominio configurada por el cliente cuando se federa con Microsoft Entra ID. No es compatible con $expand. |
| rootDomain | domain | Dominio raíz de un subdominio. Solo lectura, admite valores NULL. 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"]
}