Merge pull request #25117 from microsoftgraph/AddRootDomainToV1

Add root domain to v1.0 domain entity

Author: Lauragra

api-reference/v1.0/api/domain-get-rootdomain.md

@@ -0,0 +1,104 @@
+---
+title: "Get rootDomain"
+description: "Get the root domain of a subdomain."
+author: "shilpi-kansal"
+ms.localizationpriority: medium
+ms.subservice: "entra-directory-management"
+doc_type: apiPageType
+---
+
+# Get rootDomain
+
+Namespace: microsoft.graph
+
+Get the [root domain](../resources/domain.md) of a subdomain.
+
+This API returns a single object.
+
+## Permissions
+
+Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions [only if your app requires it](/graph/permissions-overview#best-practices-for-using-microsoft-graph-permissions). For details about delegated and application permissions, see [Permission types](/graph/permissions-overview#permission-types). To learn more about these permissions, see the [permissions reference](/graph/permissions-reference).
+
+<!-- { "blockType": "permissions", "name": "domain_get_rootdomain" } -->
+[!INCLUDE [permissions-table](../includes/permissions/domain-get-rootdomain-permissions.md)]
+
+## HTTP request
+
+<!-- {
+  "blockType": "ignored"
+}
+-->
+``` http
+GET /domains/{id}/rootDomain
+```
+> For {id}, specify the domain with its fully qualified domain name.
+
+## Optional query parameters
+
+This method does not support OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:---|:---|
+|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
+
+## Request body
+
+Don't supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [domain](../resources/domain.md) object in the response body.
+
+## Examples
+
+### Request
+
+The following example shows a request.
+<!-- {
+  "blockType": "request",
+  "sampleKeys": ["sub.contoso.com"],
+  "name": "get_rootDomain"
+}
+-->
+``` http
+GET https://graph.microsoft.com/v1.0/domains/sub.contoso.com/rootDomain
+```
+
+### Response
+
+The following example shows the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+  "blockType": "response",
+  "truncated": true,
+  "@odata.type": "microsoft.graph.domain"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+  "value":
+    {
+      "@odata.type": "#microsoft.graph.domain",
+      "id": "contoso.com",
+      "authenticationType": "Managed",
+      "availabilityStatus": null,
+      "isAdminManaged": true,
+      "isDefault": true,
+      "isInitial": true,
+      "isRoot": true,
+      "isVerified": true,
+      "passwordNotificationWindowInDays": 14,
+      "passwordValidityPeriodInDays": 2147483647,
+      "supportedServices": [
+        "Email",
+        "OfficeCommunicationsOnline"
+      ],
+      "state": null
+    }
+}
+```

api-reference/v1.0/includes/permissions/domain-get-rootdomain-permissions.md

@@ -0,0 +1,12 @@
+---
+description: "Automatically generated file. DO NOT MODIFY"
+ms.topic: include
+ms.localizationpriority: medium
+---
+
+|Permission type|Least privileged permissions|Higher privileged permissions|
+|:---|:---|:---|
+|Delegated (work or school account)|Domain.Read.All|Directory.Read.All, Domain.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|Not supported.|
+|Application|Domain.Read.All|Directory.Read.All, Domain.ReadWrite.All|
+

api-reference/v1.0/resources/domain.md

@@ -34,6 +34,7 @@ To associate a domain with a tenant:
 |[List](../api/domain-list.md) | [domain](domain.md) | Retrieve all domains linked to the tenant. |
 |[Create](../api/domain-post-domains.md) | [domain](domain.md) | Adds a domain to the tenant. |
 |[Get](../api/domain-get.md) | [domain](domain.md) | Read properties and relationships of a domain object.|
+|[Get root domain](../api/domain-get-rootdomain.md) | [domain](domain.md) | Get the root domain of a subdomain.|
 |[Update](../api/domain-update.md) | [domain](domain.md) |Updates a domain.|
 |[Delete](../api/domain-delete.md) | None |Deletes a domain.|
 |[Force delete](../api/domain-forcedelete.md)|None|Deletes a domain using an asynchronous operation.|
@@ -67,9 +68,10 @@ Relationships between a domain and other objects in the directory such as its ve
 | Relationship | Type |Description|
 |:---------------|:--------|:----------|
 |domainNameReferences|[directoryObject](directoryobject.md) collection| The objects such as users and groups that reference the domain ID. Read-only, Nullable. Doesn't support `$expand`. Supports `$filter` by the OData type of objects returned. For example, `/domains/{domainId}/domainNameReferences/microsoft.graph.user` and `/domains/{domainId}/domainNameReferences/microsoft.graph.group`.|
+|federationConfiguration|[internalDomainFederation](internaldomainfederation.md)| Domain settings configured by a customer when federated with Microsoft Entra ID. Doesn't support `$expand`.|
+|rootDomain|[domain](domain.md)| Root domain of a subdomain. Read-only, Nullable. Supports `$expand`.|
 |serviceConfigurationRecords|[domainDnsRecord](domaindnsrecord.md) collection| DNS records the customer adds to the DNS zone file of the domain before the domain can be used by Microsoft Online services. Read-only, Nullable. Doesn't support `$expand`. |
 |verificationDnsRecords|[domainDnsRecord](domaindnsrecord.md) collection| DNS records that the customer adds to the DNS zone file of the domain before the customer can complete domain ownership verification with Microsoft Entra ID. Read-only, Nullable. Doesn't support `$expand`.|
-|federationConfiguration|[internalDomainFederation](internaldomainfederation.md)| Domain settings configured by a customer when federated with Microsoft Entra ID. Doesn't support `$expand`.|
 
 ## JSON representation
 The following JSON representation shows the resource type.

changelog/Microsoft.DirectoryServices.json

@@ -13627,6 +13627,40 @@
     "CreatedDateTime": "2024-09-11T18:27:13.3184952Z",
     "WorkloadArea": "Identity and access",
     "SubArea": "Directory management"
+  },
+  {
+    "ChangeList": [
+      {
+        "Id": "97e80cb9-b4af-40a3-94ee-d4d85aabc440",
+        "ApiChange": "Relationship",
+        "ChangedApiName": "rootDomain",
+        "ChangeType": "Addition",
+        "Description": "Added the **rootDomain** relationship to the [domain](https://learn.microsoft.com/en-us/graph/api/resources/domain?view=graph-rest-1.0) resource.",
+        "Target": "domain"
+      },
+      {
+        "Id": "97e80cb9-b4af-40a3-94ee-d4d85aabc440",
+        "ApiChange": "Method",
+        "ChangedApiName": "GET",
+        "ChangeType": "Addition",
+        "Description": "Added the [Get rootDomain](https://learn.microsoft.com/en-us/graph/api/domain-get-rootdomain?view=graph-rest-1.0) operation to the [domain](https://learn.microsoft.com/en-us/graph/api/resources/domain?view=graph-rest-1.0) resource.",
+        "Target": "domain"
+      },
+      {
+        "Id": "97e80cb9-b4af-40a3-94ee-d4d85aabc440",
+        "ApiChange": "NavigationPropertyBinding",
+        "ChangedApiName": "rootDomain",
+        "ChangeType": "Addition",
+        "Description": "Added the [rootDomain](https://learn.microsoft.com/en-us/?view=graph-rest-1.0) resource",
+        "Target": "domains"
+      }
+    ],
+      "Id": "97e80cb9-b4af-40a3-94ee-d4d85aabc440",
+      "Cloud": "Review",
+      "Version": "v1.0",
+      "CreatedDateTime": "2024-10-09T23:15:04.1920065Z",
+      "WorkloadArea": "Identity and access",
+      "SubArea": "Directory management"
   }
   ]
 }