Edit

Share via

announcement resource type

  • Article

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents the Microsoft Entra change announcements, including deprecations, breaking changes, retirements, feature changes, and Microsoft-managed policies.

Inherits from changeItemBase.

Methods

Method Return type Description
List announcement collection Get a list of the announcement objects and their properties.
Get announcement Read the properties and relationships of an announcement object.

Properties

Property Type Description
announcementDateTime DateTimeOffset Change announcement date. Supports $filter (eq, ne, gt, lt, le and ge on year(), month(), day(), hour(), minute(), and second() built in functions) and $orderby.
changeType changeAnnouncementChangeType Specifies the nature of the change. The possible values are: breakingChange, deprecation, endOfSupport, featureChange, other, retirement, securityIncident, uxChange, unknownFutureValue. Supports $filter (eq, ne, in) and $orderby.
changeItemService String Specifies the Microsoft Entra service name to which this item belongs. Inherited from changeItemBase. Supports $filter (eq, ne, in) and $orderby.
description String Description of the change announcement. Inherited from changeItemBase. Supports $filter (eq, ne, in, startswith) and $orderby.
documentationUrls String collection Link to the change documentation. Inherited from changeItemBase. Supports $filter (any with eq).
id String Unique identifier for the change announcement. Inherited from entity. Supports $filter (eq, ne, in, startswith) and $orderby.
impactLink String Change impact URL. Supports $filter (eq, ne, in) and $orderby.
isCustomerActionRequired Boolean Indicates whether the customer needs to take any action for this change. Supports $filter (eq, ne).
shortDescription String A short description of the change. Inherited from changeItemBase. Supports $filter (eq, ne, in, startswith) and $orderby.
systemTags String collection Microsoft Entra specific tags. Example value: Top announcement - entra_roadmap_highlight_product_news. Inherited from changeItemBase. Supports $filter (any with eq).
tags String collection Identity and Access Management (IAM) related tags. Example values: External Identities, Reliability and Resilience. Inherited from changeItemBase. Supports $filter (any with eq).
targetDateTime DateTimeOffset Date on which the change rolls out. Supports $filter (eq, ne, gt, lt, le and ge on year(), month(), day(), hour(), minute(), and second() built in functions) and $orderby.
title String Title of the change. Inherited from changeItemBase. Supports $filter (eq, ne, in, startswith) and $orderby.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.announcement",
  "id": "String (identifier)",
  "changeItemService": "String",
  "changeType": "String",
  "tags": [
    "String"
  ],
  "systemTags": [
    "String"
  ],
  "documentationUrls": [
    "String"
  ],
  "shortDescription": "String",
  "title": "String",
  "description": "String",
  "announcementDateTime": "String (timestamp)",
  "targetDateTime": "String (timestamp)",
  "impactLink": "String",
  "isCustomerActionRequired": "Boolean"
}