Abonnement: Erneut autorisieren

Namespace: microsoft.graph

Autorisieren Sie ein Abonnement erneut, wenn Sie eine reauthorizationRequired-Herausforderung erhalten.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Berechtigungen

Abhängig von der Ressource und dem angeforderten Berechtigungstyp (delegiert oder Anwendung) ist die in der folgenden Tabelle angegebene Berechtigung die niedrigste Berechtigung, die zum Aufrufen dieser API erforderlich ist. Um mehr zu erfahren und vor der Wahl weiterer privilegierterer Berechtigungen mit Umsicht vorzugehen, suchen Sie unter Berechtigungen nach den folgenden Berechtigungen.

ChatMessage

chatMessage-Abonnements können so angegeben werden, dass sie Ressourcendaten enthalten (includeResourceData auf truefestgelegt). In diesem Fall ist eine Verschlüsselung erforderlich, und die Abonnementerstellung schlägt fehl, wenn für solche Abonnements kein encryptionCertificate angegeben ist.

Verwenden Sie den Prefer: include-unknown-enum-members Anforderungsheader, um die folgenden Werte in der erweiterbaren EnumerationchatMessagemessageType abzurufen: systemEventMessage for /teams/{id}/channels/{id}/messages und /chats/{id}/messages Ressource.

conversationMember

conversationMember-Abonnements können so angegeben werden, dass sie Ressourcendaten enthalten (includeResourceData auf truefestgelegt). In diesem Fall ist eine Verschlüsselung erforderlich, und die Abonnementerstellung schlägt fehl, wenn für solche Abonnements kein encryptionCertificate angegeben ist.

Team, Kanal und Chat

Team-, Kanal- und Chatabonnements können so angegeben werden, dass sie Ressourcendaten enthalten (includeResourceData auf truefestgelegt). In diesem Fall ist eine Verschlüsselung erforderlich, und die Abonnementerstellung schlägt fehl, wenn für solche Abonnements kein encryptionCertificate angegeben ist.

Sie können den Abfragezeichenfolgeparameter notifyOnUserSpecificProperties verwenden, wenn Sie Änderungen in einem bestimmten Chat oder auf Benutzerebene abonnieren. Wenn Sie den Abfragezeichenfolgenparameter notifyOnUserSpecificPropertiestrue während der Abonnementerstellung festlegen, werden zwei Arten von Nutzlasten an den Abonnenten gesendet. Ein Typ enthält benutzerspezifische Eigenschaften, der andere wird ohne diese gesendet. Weitere Informationen finden Sie unter Abrufen von Änderungsbenachrichtigungen für Chats mit Microsoft Graph.

aiInsights

Abonnements für Copilot AI Insights erfordern eine gültige Copilot-Lizenz, die den folgenden Copilot-Serviceplan umfasst:

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

aiInteraction

Abonnements für Copilot KI-Interaktionen erfordern eine gültige Copilot-Lizenz, die den folgenden Copilot-Serviceplan umfasst:

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

Bei Abonnements, die auf Copilot KI-Interaktionen abzielen, an denen ein bestimmter Benutzer beteiligt ist, müssen dem Benutzer im Ressourcenpfad die vorherigen Servicepläne zugewiesen sein, die sich in einem gültigen Zustand befinden.

Für Abonnements, die auf Copilot KI-Interaktionen für den gesamten Mandanten abzielen, muss der Mandant über gültige Lizenzen verfügen, die alle früheren Copilot-Servicepläne enthalten.

HTTP-Anforderung

POST /subscriptions/{subscriptionsId}/reauthorize

Anforderungsheader

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Antwort

Wenn die Aktion erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.

Beispiele

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

POST https://graph.microsoft.com/beta/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 $v0.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-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')
	.version('beta')
	.post();

<?php
use Microsoft\Graph\Beta\GraphServiceClient;


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


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

Import-Module Microsoft.Graph.Beta.ChangeNotifications

Invoke-MgBetaReauthorizeSubscription -SubscriptionId $subscriptionId

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta 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()

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content