Abonnement : réautoriser

Espace de noms: microsoft.graph

Autorisez à nouveau un abonnement lorsque vous recevez une demande d’autorisation ReauthorizationRequired .

Cette API est disponible dans les déploiements cloud nationaux suivants.

Autorisations

En fonction du type de ressource et d’autorisation(délégué ou application) demandé, l’autorisation spécifiée dans le tableau suivant est la moins requise privilégiée pour appeler cette API. Pour en savoir plus, notamment sur les Mesures de prudence avant de choisir des autorisations plus privilégiées, recherchez ces autorisations dans Autorisations.

chatMessage

chatMessage peuvent être spécifiés pour inclure les données de ressource (includeResourceData défini sur true). Dans ce cas, le chiffrement est requis et la création de l’abonnement échoue si un encryptionCertificate n’est pas spécifié pour ces abonnements.

Utilisez l’en-tête de Prefer: include-unknown-enum-members requête pour obtenir les valeurs suivantes dans chatMessagemessageTypeénumération évolutive : systemEventMessage pour /teams/{id}/channels/{id}/messages et /chats/{id}/messages ressource.

conversationMember

Les abonnements conversationMember peuvent être spécifiés pour inclure les données de ressources (includeResourceData défini sur true). Dans ce cas, le chiffrement est requis et la création de l’abonnement échoue si un encryptionCertificate n’est pas spécifié pour ces abonnements.

Équipe, canal et conversation

Les abonnements d’équipe, de canal et de conversation peuvent être spécifiés pour inclure les données de ressources (includeResourceData défini sur true). Dans ce cas, le chiffrement est requis et la création de l’abonnement échoue si un encryptionCertificate n’est pas spécifié pour ces abonnements.

Vous pouvez utiliser le paramètre de chaîne de requête notifyOnUserSpecificProperties lorsque vous vous abonnez aux modifications apportées à une conversation particulière ou au niveau de l’utilisateur. Lorsque vous définissez le paramètre de chaîne de requête notifyOnUserSpecificProperties sur true lors de la création de l’abonnement, deux types de charges utiles sont envoyés à l’abonné. L’un contient des propriétés spécifiques à l’utilisateur, tandis que l’autre est envoyé sans celles-ci. Pour plus d’informations, consultez Obtenir des notifications de modification pour les conversations à l’aide de Microsoft Graph.

aiInsights

Les abonnements à Copilot AI Insights nécessitent une licence Copilot valide qui inclut le plan de service Copilot suivant :

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

aiInteraction

Les abonnements aux interactions Copilot AI nécessitent une licence Copilot valide qui inclut le plan de service Copilot suivant :

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

Pour les abonnements qui ciblent les interactions Copilot AI dont un utilisateur particulier fait partie, l’utilisateur dans le chemin de ressource doit avoir les plans de service précédents qui lui sont attribués dans un état valide.

Pour les abonnements qui ciblent les interactions Copilot AI pour l’ensemble du client, le locataire doit disposer de licences valides approvisionnées qui incluent tous les plans de service Copilot précédents.

Requête HTTP

POST /subscriptions/{subscriptionsId}/reauthorize

En-têtes de demande

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si elle réussit, cette action renvoie un code de réponse 204 No Content.

Exemples

Demande

L’exemple suivant illustre une demande.

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()

Réponse

L’exemple suivant illustre la réponse.

HTTP/1.1 204 No Content