подписка: повторная проверка подлинности

Пространство имен: microsoft.graph

Повторная авторизация подписки при получении запроса reauthorizationRequired .

Этот API доступен в следующих национальных облачных развертываниях.

Разрешения

В зависимости от ресурса и типа требующегося разрешения (делегированное или для приложения) разрешение, указанное в приведенной ниже таблице, является наименее привилегированным разрешением, необходимым для вызова этого API. Чтобы получить дополнительные сведения, в том числе о соблюдении осторожности перед выбором разрешений с повышенными привилегиями, найдите следующие разрешения в разделе Разрешения.

Примечание.

Некоторые ресурсы поддерживают уведомления об изменениях в нескольких сценариях, каждый из которых может требовать разных разрешений. В таких случаях используйте путь к ресурсу, чтобы дифференцировать сценарии.

Разрешения, отмеченные *, используют согласие для конкретного ресурса.

chatMessage

Подписки chatMessage можно указать для включения данных ресурсов (параметр includeResourceData имеет значение true). В этом случае требуется шифрование, и создание подписки завершается сбоем, если для таких подписок не указан сертификат шифрования .

Prefer: include-unknown-enum-members Используйте заголовок запроса, чтобы получить следующие значения в перечислении chatMessagemessageTypeс возможностью развития: systemEventMessage for /teams/{id}/channels/{id}/messages и /chats/{id}/messages resource.

conversationMember

Подписки conversationMember можно указать для включения данных ресурсов (параметр includeResourceData имеет значение true). В этом случае требуется шифрование, и создание подписки завершается сбоем, если для таких подписок не указан сертификат шифрования .

команда, канал и чат

Подписки команд, каналов и чатов можно указать для включения данных ресурсов (параметр includeResourceData имеет значение true). В этом случае требуется шифрование, и создание подписки завершается сбоем, если для таких подписок не указан сертификат шифрования .

Параметр строки запроса notifyOnUserSpecificProperties можно использовать при подписке на изменения в определенном чате или на уровне пользователя. Если параметр строки запроса notifyOnUserSpecificPropertiestrue задан во время создания подписки, подписчику отправляются два типа полезных данных. Один тип содержит свойства, зависящие от пользователя, а другой отправляется без них. Дополнительные сведения см. в статье Получение уведомлений об изменениях для чатов с помощью Microsoft Graph.

aiInteraction

Для подписок на взаимодействие с ИИ Copilot требуется действительная лицензия Copilot, которая включает следующий план обслуживания Copilot:

• Microsoft 365 Copilot Chat: 3f30311c-6b1e-48a4-ab79-725b469da960

Для подписок, предназначенных для взаимодействия с ИИ Copilot, частью которых является конкретный пользователь, пользователю в пути к ресурсу должны быть назначены предыдущие планы обслуживания в допустимом состоянии.

Для подписок, предназначенных для взаимодействия Copilot AI для всего клиента, клиент должен иметь действительные лицензии, которые включают все предыдущие планы обслуживания Copilot.

HTTP-запрос

POST /subscriptions/{subscriptionsId}/reauthorize

Заголовки запросов

Текст запроса

Не указывайте текст запроса для этого метода.

Отклик

В случае успешного выполнения это действие возвращает код отклика 204 No Content.

Примеры

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/v1.0/subscriptions/{subscriptionsId}/reauthorize

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Subscriptions["{subscription-id}"].Reauthorize.PostAsync();

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.Subscriptions().BySubscriptionId("subscription-id").Reauthorize().Post(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

graphClient.subscriptions().bySubscriptionId("{subscription-id}").reauthorize().post();

const options = {
	authProvider,
};

const client = Client.init(options);

await client.api('/subscriptions/{subscriptionsId}/reauthorize')
	.post();

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$graphServiceClient->subscriptions()->bySubscriptionId('subscription-id')->reauthorize()->post()->wait();

Import-Module Microsoft.Graph.ChangeNotifications

Invoke-MgReauthorizeSubscription -SubscriptionId $subscriptionId

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

await graph_client.subscriptions.by_subscription_id('subscription-id').reauthorize.post()

Отклик

Ниже приводится пример отклика.

HTTP/1.1 204 No Content