Skip to content

Commit 093a5be

Browse files
LauragraLauragra
authored
Merge pull request #25485 from microsoftgraph/jansedlk/entra_whats_new
Documentation for Entra What's New msgraph API
2 parents 51cfc66 + f827cf1 commit 093a5be

18 files changed

+1034
-0
lines changed

‎api-reference/beta/api/announcement-get.md

Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
---
2+
title: "Get announcement"
3+
description: "Read the properties and relationships of an announcement object."
4+
author: "garretraziel"
5+
ms.date: 11/20/2024
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-sign-in"
8+
doc_type: apiPageType
9+
---
10+
11+
# Get announcement
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Read the properties of an [announcement](../resources/announcement.md) object.
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "announcement-get-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/announcement-get-permissions.md)]
29+
30+
Any user can call these APIs, there are no admin role requirements.
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
GET /identity/productChanges/microsoft.graph.announcement/{id}
40+
```
41+
42+
## Optional query parameters
43+
44+
This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
45+
46+
## Request headers
47+
48+
|Name|Description|
49+
|:---|:---|
50+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
51+
52+
## Request body
53+
54+
Don't supply a request body for this method.
55+
56+
## Response
57+
58+
If successful, this method returns a `200 OK` response code and an [announcement](../resources/announcement.md) object in the response body.
59+
60+
## Examples
61+
62+
### Request
63+
64+
The following example shows a request.
65+
<!-- {
66+
"blockType": "request",
67+
"name": "get_announcement"
68+
}
69+
-->
70+
``` http
71+
GET https://graph.microsoft.com/beta/identity/productChanges/microsoft.graph.announcement/ddde9e3b-7ee4-4066-a62e-fb1fc5fb87a1
72+
```
73+
74+
### Response
75+
76+
The following example shows the response.
77+
>**Note:** The response object shown here might be shortened for readability.
78+
<!-- {
79+
"blockType": "response",
80+
"truncated": true,
81+
"@odata.type": "microsoft.graph.announcement"
82+
}
83+
-->
84+
``` http
85+
HTTP/1.1 200 OK
86+
Content-Type: application/json
87+
88+
{
89+
"value": {
90+
"@odata.type": "#microsoft.graph.announcement",
91+
"id": "ddde9e3b-7ee4-4066-a62e-fb1fc5fb87a1",
92+
"changeItemState": "available",
93+
"changeItemService": "mfA",
94+
"tags": [
95+
"Identity Modernization"
96+
],
97+
"systemTags": [
98+
"entra_change_announcements_90days"
99+
],
100+
"documentationUrls": [
101+
"https://learn.microsoft.com/en-us/entra/identity/authentication/how-to-migrate-mfa-server-to-azure-mfa?WT.mc_id=Portal-Microsoft_AAD_IAM"
102+
],
103+
"shortDescription": "Azure Multi-Factor Authentication Server (MFA Server) isn't available for new deployments and will be deprecated. Customers who are using MFA Server should move to using cloud-based Microsoft Entra multifactor authentication.",
104+
"title": "Migrate from MFA Server to Microsoft Entra multifactor authentication",
105+
"description": "*Omitted for brevity*",
106+
"announcementDateTime": "2022-09-30T00:00:00Z",
107+
"targetDateTime": "2024-09-30T00:00:00Z",
108+
"impactLink": null,
109+
"isCustomerActionRequired": true
110+
}
111+
}
112+
```

‎api-reference/beta/api/announcement-list.md

Lines changed: 114 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,114 @@
1+
---
2+
title: "List announcement objects"
3+
description: "Get a list of the announcement objects and their properties."
4+
author: "garretraziel"
5+
ms.date: 11/20/2024
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-sign-in"
8+
doc_type: apiPageType
9+
---
10+
11+
# List announcement objects
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get a list of the [announcement](../resources/announcement.md) objects and their properties.
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "announcement-list-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/announcement-list-permissions.md)]
29+
30+
Any user can call these APIs, there are no admin role requirements.
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
GET /identity/productChanges/microsoft.graph.announcement
40+
```
41+
42+
## Optional query parameters
43+
44+
This method supports the `$count`, `$filter` (`eq`, `ne`, `in`, `startswith`), `$orderby`, `$search`, `$top` (default page size is 100 items, maximum is 250 items), `$select` and `$skip` [OData query parameters](/graph/query-parameters) to help customize the response.
45+
46+
## Request headers
47+
48+
|Name|Description|
49+
|:---|:---|
50+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
51+
52+
## Request body
53+
54+
Don't supply a request body for this method.
55+
56+
## Response
57+
58+
If successful, this method returns a `200 OK` response code and a collection of [announcement](../resources/announcement.md) objects in the response body.
59+
60+
## Examples
61+
62+
### Request
63+
64+
The following example shows a request.
65+
<!-- {
66+
"blockType": "request",
67+
"name": "list_announcement"
68+
}
69+
-->
70+
``` http
71+
GET https://graph.microsoft.com/beta/identity/productChanges/microsoft.graph.announcement
72+
```
73+
74+
### Response
75+
76+
The following example shows the response.
77+
>**Note:** The response object shown here might be shortened for readability.
78+
<!-- {
79+
"blockType": "response",
80+
"truncated": true,
81+
"@odata.type": "microsoft.graph.announcement"
82+
}
83+
-->
84+
``` http
85+
HTTP/1.1 200 OK
86+
Content-Type: application/json
87+
88+
{
89+
"value": [
90+
{
91+
"@odata.type": "#microsoft.graph.announcement",
92+
"id": "ddde9e3b-7ee4-4066-a62e-fb1fc5fb87a1",
93+
"changeItemState": "available",
94+
"changeItemService": "mfA",
95+
"tags": [
96+
"Identity Modernization"
97+
],
98+
"systemTags": [
99+
"entra_change_announcements_90days"
100+
],
101+
"documentationUrls": [
102+
"https://learn.microsoft.com/en-us/entra/identity/authentication/how-to-migrate-mfa-server-to-azure-mfa?WT.mc_id=Portal-Microsoft_AAD_IAM"
103+
],
104+
"shortDescription": "Azure Multi-Factor Authentication Server (MFA Server) isn't available for new deployments and will be deprecated. Customers who are using MFA Server should move to using cloud-based Microsoft Entra multifactor authentication.",
105+
"title": "Migrate from MFA Server to Microsoft Entra multifactor authentication",
106+
"description": "*Omitted for brevity*",
107+
"announcementDateTime": "2022-09-30T00:00:00Z",
108+
"targetDateTime": "2024-09-30T00:00:00Z",
109+
"impactLink": null,
110+
"isCustomerActionRequired": true
111+
}
112+
]
113+
}
114+
```

‎api-reference/beta/api/identitycontainer-list-productchanges.md

Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
---
2+
title: "List changeItemBase objects"
3+
description: "Get a list of the changeItemBase objects and their properties."
4+
author: "garretraziel"
5+
ms.date: 11/20/2024
6+
ms.localizationpriority: medium
7+
ms.subservice: "entra-sign-in"
8+
doc_type: apiPageType
9+
---
10+
11+
# List changeItemBase objects
12+
13+
Namespace: microsoft.graph
14+
15+
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
16+
17+
Get a list of the [changeItemBase](../resources/changeitembase.md) objects and their properties.
18+
19+
## Permissions
20+
21+
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).
22+
23+
<!-- {
24+
"blockType": "permissions",
25+
"name": "identitycontainer-list-productchanges-permissions"
26+
}
27+
-->
28+
[!INCLUDE [permissions-table](../includes/permissions/identitycontainer-list-productchanges-permissions.md)]
29+
30+
Any user can call these APIs, there are no admin role requirements.
31+
32+
## HTTP request
33+
34+
<!-- {
35+
"blockType": "ignored"
36+
}
37+
-->
38+
``` http
39+
GET /identity/productChanges
40+
```
41+
42+
## Optional query parameters
43+
44+
This method supports the `$count`, `$filter` (`eq`, `ne`, `in`, `startswith`), `$orderby`, `$search`, `$top` (default page size is 10 items, maximum is 250 items), `$select` and `$skip` [OData query parameters](/graph/query-parameters) to help customize the response.
45+
46+
## Request headers
47+
48+
|Name|Description|
49+
|:---|:---|
50+
|Authorization|Bearer {token}. Required. Learn more about [authentication and authorization](/graph/auth/auth-concepts).|
51+
52+
## Request body
53+
54+
Don't supply a request body for this method.
55+
56+
## Response
57+
58+
If successful, this method returns a `200 OK` response code and a collection of [changeItemBase](../resources/changeitembase.md) objects in the response body.
59+
60+
## Examples
61+
62+
### Request
63+
64+
The following example shows a request.
65+
<!-- {
66+
"blockType": "request",
67+
"name": "list_changeitembase"
68+
}
69+
-->
70+
``` http
71+
GET https://graph.microsoft.com/beta/identity/productChanges
72+
```
73+
74+
### Response
75+
76+
The following example shows the response.
77+
>**Note:** The response object shown here might be shortened for readability.
78+
<!-- {
79+
"blockType": "response",
80+
"truncated": true,
81+
"@odata.type": "microsoft.graph.changeItemBase"
82+
}
83+
-->
84+
``` http
85+
HTTP/1.1 200 OK
86+
Content-Type: application/json
87+
88+
{
89+
"value": [
90+
{
91+
"@odata.type": "#microsoft.graph.roadmap",
92+
"id": "0146c01e-02c1-47a7-ad5b-8458a9351f95",
93+
"changeItemState": "available",
94+
"changeItemService": "reporting",
95+
"tags": [
96+
""
97+
],
98+
"systemTags": [],
99+
"documentationUrls": [
100+
"https://entra.microsoft.com/#view/Microsoft_AAD_DXP/ScenarioHealthSummary.ReactView"
101+
],
102+
"shortDescription": "",
103+
"title": "SLA Attainment Report at Tenant Level",
104+
"description": "*Omitted for brevity*",
105+
"deliveryStage": "ga",
106+
"category": "monitoringReporting",
107+
"publishedDateTime": "2024-06-24T07:00:00Z",
108+
"gotoLink": null
109+
}
110+
]
111+
}
112+
```

0 commit comments

Comments
 (0)