Atualizar assinatura

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Renove uma assinatura ampliando seu tempo de validade.

A tabela na seção Permissões lista os recursos que dão suporte à assinatura de notificações de alteração.

As assinaturas expiram após um período de tempo que varia de acordo com o tipo de recurso. Para evitar a perda de notificações de alteração, um aplicativo deve renovar suas assinaturas bem antes da data de expiração. Consulte a assinatura para saber o comprimento máximo de uma assinatura para cada tipo de recurso.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global	Governo dos EUA L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	✅

Permissões

Dependendo do recurso e do tipo de permissão (delegado ou aplicativo) solicitado, a permissão especificada na tabela a seguir é a menos privilegiada necessária para fazer chamadas a esta API. Para saber mais, incluindo tomar cuidado antes de escolher as permissões mais privilegiadas, pesquise as seguintes permissões em Permissões.

Observação

Alguns recursos são compatíveis com notificações de alteração em vários cenários, cada um dos quais pode exigir permissões diferentes. Nesses casos, use o caminho do recurso para diferenciar os cenários.

Recurso com suporte	Delegada (conta corporativa ou de estudante)	Delegada (conta pessoal da Microsoft)	Application
aiInsights /copilot/users/{userId}/onlineMeetings/getAllAiInsights Insights de IA do Copilot de reuniões das quais um determinado usuário faz parte.	OnlineMeetingAiInsight.Read.All	Sem suporte.	OnlineMeetingAiInsight.Read.All
aiInsights /copilot/users/{userId}/onlineMeetings/{onlineMeetingId}/aiInsights Insights de IA do Copilot para uma reunião específica.	OnlineMeetingAiInsight.Read.All	Sem suporte.	OnlineMeetingAiInsight.Read.All
aiInteraction copilot/users/{userId}/interactionHistory/getAllEnterpriseInteractions Interações de IA do Copilot das quais um determinado usuário faz parte.	AiEnterpriseInteraction.Read	Sem suporte.	AiEnterpriseInteraction.Read.All, AiEnterpriseInteraction.Read.User
aiInteraction copilot/interactionHistory/getAllEnterpriseInteractions Interações de IA do Copilot em uma organização.	Sem suporte.	Sem suporte.	AiEnterpriseInteraction.Read.All
approvalItems	Sem suporte.	Sem suporte.	ApprovalSolution.ReadWrite.All
callRecord	Sem suporte.	Sem suporte.	CallRecords.Read.All
callRecording communications/onlineMeetings/getAllRecordings Qualquer gravação fica disponível no locatário.	Sem suporte.	Sem suporte.	OnlineMeetingRecording.Read.All
callRecording communications/onlineMeetings/{onlineMeetingId}/recordings Qualquer gravação fica disponível para uma reunião específica.	OnlineMeetingRecording.Read.All	Sem suporte.	OnlineMeetingRecording.Read.All
callRecording users/{userId}/onlineMeetings/getAllRecordings Uma gravação de chamada que se torna disponível em uma reunião organizada por um usuário específico.	OnlineMeetingRecording.Read.All	Sem suporte.	OnlineMeetingRecording.Read.All
callRecording appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllRecordings Uma gravação de chamada que se torna disponível em uma reunião em que um determinado aplicativo do Teams está instalado.	Sem suporte.	Sem suporte.	OnlineMeetingRecording.Read.All, OnlineMeetingRecording.Read. Chat
callTranscript communications/onlineMeetings/getAllTranscripts Qualquer transcrição fica disponível no locatário.	Sem suporte.	Sem suporte.	OnlineMeetingTranscript.Read.All
callTranscript communications/onlineMeetings/{onlineMeetingId}/transcripts Qualquer transcrição fica disponível para uma reunião específica.	OnlineMeetingTranscript.Read.All	Sem suporte.	OnlineMeetingTranscript.Read.All
callTranscript users/{userId}/onlineMeetings/getAllTranscripts Uma transcrição de chamada que fica disponível em uma reunião organizada por um usuário específico.	OnlineMeetingTranscript.Read.All	Sem suporte.	OnlineMeetingTranscript.Read.All
callTranscript appCatalogs/teamsApps/{id}/installedToOnlineMeetings/getAllTranscripts Uma transcrição de chamada que se torna disponível em uma reunião em que um determinado aplicativo do Teams está instalado.	Sem suporte.	Sem suporte.	OnlineMeetingTranscript.Read.All, OnlineMeetingTranscript.Read. Chat
canal /teams/getAllChannels Todos os canais em uma organização.	Sem suporte.	Sem suporte.	Channel.ReadBasic.All, ChannelSettings.Read.All
canal /teams/{id}/channels Todos os canais em uma equipe específica em uma organização.	Channel.ReadBasic.All, ChannelSettings.Read.All	Sem suporte.	Channel.ReadBasic.All, ChannelSettings.Read.All
chat /chats Todos os chats em uma organização.	Sem suporte.	Sem suporte.	Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
chat /chats/{id} Um chat específico.	Chat.ReadBasic, Chat.Read, Chat.ReadWrite	Sem suporte.	ChatSettings.Read. Chat, ChatSettings.ReadWrite. Chat, Chat. Gerar. Chat, Chat. ReadBasic.All, Chat. Read.All, Chat. ReadWrite.All
chat /appCatalogs/teamsApps/{id}/installedToChats Todos os chats em uma organização onde um determinado aplicativo do Teams está instalado.	Sem suporte.	Sem suporte.	Chat. ReadBasic.WhereInstalled, Chat. Read.WhereInstalled, Chat. ReadWrite.WhereInstalled
chat /users/{id}/chats Todos os chats dos quais um determinado usuário faz parte.	Chat.ReadBasic, Chat.Read, Chat.ReadWrite	Sem suporte.	Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
chatMessage /teams/{id}/channels/{id}/messages Todas as mensagens e respostas em um canal específico.	ChannelMessage.Read.All, Group.Read.All, Group.ReadWrite.All	Sem suporte.	ChannelMessage.Read.Group, ChannelMessage.Read.All
chatMessage /teams/getAllMessages Todas as mensagens de canal na organização.	Sem suporte.	Sem suporte.	ChannelMessage.Read.All
chatMessage /chats/{id}/messages Todas as mensagens em um chat.	Chat.Read, Chat.ReadWrite	Sem suporte.	Chat.Read.All
chatMessage /chats/getAllMessages Todas as mensagens de chat em uma organização.	Sem suporte.	Sem suporte.	Chat.Read.All
chatMessage /users/{id}/chats/getAllMessages Mensagens de Chat para todos os chats dos quais um determinado usuário faz parte.	Chat.Read, Chat.ReadWrite	Sem suporte.	Chat.Read.All, Chat.ReadWrite.All
chatMessage /appCatalogs/teamsApps/{id}/installedToChats/getAllMessages Mensagens de Chat para todos os chats em uma organização onde um determinado aplicativo do Teams está instalado.	Sem suporte.	Sem suporte.	Chat. Read.WhereInstalled, Chat. ReadWrite.WhereInstalled
contato	Contacts.Read	Contacts.Read	Contacts.Read
conversationMember /chats/getAllMembers Membros de todos os chats em uma organização.	Sem suporte.	Sem suporte.	ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
conversationMember /chats/{id}/members Membros de um chat específico.	ChatMember.Read, ChatMember.ReadWrite, Chat.ReadBasic, Chat.Read, Chat.ReadWrite	Sem suporte.	ChatMember.Read.Chat, Chat.Manage.Chat, ChatMember.Read.All, ChatMember.ReadWrite.All, Chat.ReadBasic.All, Chat.Read.All, Chat.ReadWrite.All
conversationMember /appCatalogs/teamsApps/{id}/installedToChats/getAllMembers Membros do Chat para todos os chats em uma organização onde um determinado aplicativo do Teams está instalado.	Sem suporte.	Sem suporte.	ChatMember.Read.WhereInstalled, ChatMember.ReadWrite.WhereInstalled, Chat. ReadBasic.WhereInstalled, Chat. Read.WhereInstalled, Chat. ReadWrite.WhereInstalled
conversationMember /teams/getAllMembers Membros em todas as equipes de uma organização.	Sem suporte.	Sem suporte.	TeamMember.Read.All, TeamMember.ReadWrite.All
conversationMember /teams/{id}/members Membros de uma equipe específica.	TeamMember.Read.All	Sem suporte.	TeamMember.Read.All
conversationMember /teams/{id}/channels/getAllMembers Membros em todos os canais privados de uma equipe específica.	Sem suporte.	Sem suporte.	ChannelMember.Read.All
conversationMember /teams/getAllChannels/getAllMembers	Sem suporte.	Sem suporte.	ChannelMember.Read.All
driveItem (OneDrive pessoal de um usuário)	Sem suporte.	Files.ReadWrite	Sem suporte.
driveItem (OneDrive corporativo ou de estudante)	Files.ReadWrite.All	Sem suporte.	Files.ReadWrite.All
evento	Calendars.Read	Calendars.Read	Calendars.Read
grupo	Group.Read.All	Sem suporte.	Group.Read.All
conversa em grupo	Group.Read.All	Sem suporte.	Sem suporte.
Alerta de monitoramento do Microsoft Entra Health /reports/healthmonitoring/alerts	HealthMonitoringAlertConfig.ReadWrite.All	Sem suporte.	HealthMonitoringAlertConfig.ReadWrite.All
list	Sites.ReadWrite.All	Sem suporte.	Sites.ReadWrite.All
message	Mail.ReadBasic, Mail.Read	Mail.ReadBasic, Mail.Read	Mail.Read
offerShiftRequest /teams/{id}/schedule/offerShiftRequests Alterações em qualquer solicitação de turno de oferta em uma equipe.	Schedule.Read.All, Schedule.ReadWrite.All	Sem suporte.	Schedule.Read.All, Schedule.ReadWrite.All
reunião online	Sem suporte.	Sem suporte.	OnlineMeetings.Read.All, OnlineMeetings.ReadWrite.All
openShiftChangeRequest /teams/{id}/schedule/openShiftChangeRequests Alterações em qualquer solicitação de turno aberto em uma equipe.	Schedule.Read.All, Schedule.ReadWrite.All	Sem suporte.	Schedule.Read.All, Schedule.ReadWrite.All
presence	Presence.Read.All	Sem suporte.	Sem suporte.
impressora	Sem suporte.	Sem suporte.	Printer.Read.All, Printer.ReadWrite.All
printTaskDefinition	Sem suporte.	Sem suporte.	PrintTaskDefinition.ReadWrite.All
alerta de segurança	SecurityEvents.ReadWrite.All	Sem suporte.	SecurityEvents.ReadWrite.All
shift /teams/{id}/schedule/shifts Mudanças em qualquer turno em uma equipe.	Schedule.Read.All, Schedule.ReadWrite.All	Sem suporte.	Schedule.Read.All, Schedule.ReadWrite.All
swapShiftsChangeRequest /teams/{id}/schedule/swapShiftsChangeRequests Alterações em qualquer solicitação de turno de troca em uma equipe.	Schedule.Read.All, Schedule.ReadWrite.All	Sem suporte.	Schedule.Read.All, Schedule.ReadWrite.All
team /teams Todas as equipes em uma organização.	Sem suporte.	Sem suporte.	Team.ReadBasic.All, TeamSettings.Read.All
team /teams/{id} Uma equipe específica.	Team.ReadBasic.All, TeamSettings.Read.All	Sem suporte.	Team.ReadBasic.All, TeamSettings.Read.All
timeOffRequest /teams/{id}/schedule/timeOffRequests Alterações em qualquer solicitação de folga em uma equipe.	Schedule.Read.All, Schedule.ReadWrite.All	Sem suporte.	Schedule.Read.All, Schedule.ReadWrite.All
todoTask	Tasks.ReadWrite	Tasks.ReadWrite	Sem suporte.
user	User.Read.All	User.Read.All	User.Read.All
virtualEventWebinar	VirtualEvent.Read	Sem suporte.	VirtualEvent.Read.All
baseTask (preterido)	Tasks.ReadWrite	Tasks.ReadWrite	Sem suporte.

Observação

As seguintes permissões usam o consentimento específico do recurso:

• OnlineMeetingRecording.Read. Chat
• OnlineMeetingTranscript.Read. Chat
• ChatSettings.Read.Chat
• ChatSettings.ReadWrite.Chat
• Chat.Manage.Chat
• ChannelMessage.Read.Group
• ChatMember.Read.Chat
• AiEnterpriseInteraction.Read.User

chatMessage

As assinaturas chatMessage podem ser especificadas para incluir dados de recursos (includeResourceData definido como true). Nesse caso, a criptografia é necessária e a criação da assinatura falhará se um encryptionCertificate não for especificado para essas assinaturas.

Use o cabeçalho da Prefer: include-unknown-enum-members solicitação para obter os seguintes valores em chatMessage, messageType, enumeração evolutiva: systemEventMessage for /teams/{id}/channels/{id}/messages e /chats/{id}/messages resource.

conversationMember

As assinaturas conversationMember podem ser especificadas para incluir dados de recursos (includeResourceData definido como true). Nesse caso, a criptografia é necessária e a criação da assinatura falhará se um encryptionCertificate não for especificado para essas assinaturas.

Equipe, canal e chat

As assinaturas de equipe, canal e chat podem ser especificadas para incluir dados de recursos (includeResourceData definido como true). Nesse caso, a criptografia é necessária e a criação da assinatura falhará se um encryptionCertificate não for especificado para essas assinaturas.

Você pode usar o parâmetro da cadeia de caracteres de consulta notifyOnUserSpecificProperties ao assinar alterações em um chat específico ou no nível do usuário. Quando você define o parâmetro de cadeia de caracteres de consulta notifyOnUserSpecificProperties durante true a criação da assinatura, dois tipos de conteúdo são enviados ao assinante. Um tipo contém propriedades específicas do usuário e o outro é enviado sem elas. Para obter mais informações, consulte Obter notificações de alteração para chats usando o Microsoft Graph.

aiInsights

As assinaturas no Copilot AI Insights exigem uma licença válida do Copilot que inclua o seguinte plano de serviço do Copilot:

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

aiInteraction

As assinaturas nas interações de IA do Copilot exigem uma licença válida do Copilot que inclua o seguinte plano de serviço do Copilot:

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

Para assinaturas direcionadas a interações de IA do Copilot das quais um determinado usuário faz parte, o usuário no caminho do recurso deve ter os planos de serviço anteriores atribuídos a ele em um estado válido.

Para assinaturas que direcionam interações de IA do Copilot para todo o locatário, o locatário deve ter licenças válidas provisionadas que incluam todos os planos de serviço anteriores do Copilot.

driveItem

Mais limitações se aplicam a assinaturas em itens do OneDrive. As limitações se aplicam para criação e gerenciamento de assinaturas (receber, atualizar e excluir assinaturas).

No OneDrive pessoal, você pode se inscrever em qualquer pasta raiz ou qualquer subpasta da unidade. No OneDrive corporativo ou de estudante, você pode assinar apenas a pasta raiz. As notificações de alteração são enviadas para as alterações solicitadas na pasta assinada ou em qualquer arquivo, pasta ou outras instâncias de driveItem em sua hierarquia. Você não pode se inscrever em instâncias de drive ou driveItem que não sejam pastas, como arquivos individuais.

contato, evento e mensagem

Você pode assinar as alterações nos recursos de contato, evento ou mensagem do Outlook e, opcionalmente, especificar no conteúdo da solicitação POST se deseja incluir dados de recursos criptografados nas notificações.

Criar e gerenciar (obter, atualizar e excluir) uma assinatura requer um escopo de leitura para o recurso. Por exemplo, para receber notificações de alteração nas mensagens, seu aplicativo precisa da permissão Mail.Read. As notificações de alteração do Outlook dão suporte a escopos de permissão de aplicativo e delegados. Observe as seguintes limitações:

• A permissão delegada dá suporte a inscrição de itens em pastas apenas na caixa de correio do usuário conectado. Por exemplo, você não pode usar a permissão delegada Calendars.Read para assinar eventos na caixa de correio de outro usuário.

• Se inscrever para alterar as notificações de contatos, eventos no Outlook ou mensagens em pastascompartilhadas ou delegadas:

  • Usar a permissão de aplicativos correspondentes para inscrever as alterações dos itens em uma pasta ou uma caixa de correio de qualquer usuários no locatário.
  • Não use as permissões de compartilhamento do Outlook (Contacts.Read.Shared, Calendars.Read.Shared, Mail.Read.Shared e suas contrapartes de leitura/gravação), pois elas não dão suporte à assinatura para notificações de alteração em itens em pastas compartilhadas ou delegadas.

onlineMeetings, presença

onlineAsassinaturas de presença e reuniões exigem criptografia para notificações com dados do recurso. A criação da assinatura falhará se encryptionCertificate e encryptionCertificateId não forem especificados se os dados do recurso forem desejados nas notificações. Para saber mais, confira:

• Configurar notificações de alteração do Microsoft Graph com dados de recursos (notificações avançadas).
• Receba notificações de alteração para reuniões online.
• Receber notificações de alteração para atualizações de presença no Microsoft Teams

virtualEventWebinar

As assinaturas em eventos virtuais dão suporte apenas a notificações básicas e estão limitadas a algumas entidades de um evento virtual. Para obter mais informações sobre os tipos de assinatura com suporte, consulte Obter notificações de alteração para atualizações de eventos virtuais do Microsoft Teams.

Solicitação HTTP

PATCH /subscriptions/{id}

Cabeçalhos de solicitação

Nome	Tipo	Descrição
Autorização	string	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

No corpo da solicitação, forneça apenas os valores das propriedades a serem atualizadas. As propriedades existentes que não estão incluídas no corpo da solicitação mantêm seus valores anteriores ou são recalculadas com base nas alterações de outros valores de propriedade.

A tabela a seguir especifica as propriedades que podem ser atualizadas.

O corpo da solicitação deve conter a expirationDateTime propriedade ou notificationUrl e seu valor.

Nome	Tipo	Descrição
expirationDateTime	DateTimeOffset	Especifica a data e a hora em UTC quando a assinatura expira. Para a assinatura máxima com suporte, o período varia de acordo com o recurso. Para obter mais informações, consulte Vida útil da assinatura.
notificationUrl	Cadeia de caracteres	Esta URL deve fazer uso do protocolo HTTPS. Qualquer parâmetro de cadeia de caracteres de consulta incluído na propriedade notificationUrl é incluído na solicitação HTTP POST quando o Microsoft Graph envia as notificações de alteração.

Resposta

Se bem-sucedido, este método retorna um código de resposta 200 OK e um objeto subscription no corpo da resposta.

Observação

Uma 404 Not Found resposta indica que a assinatura não existe mais. Por exemplo, ele já expirou e foi removido pelo serviço ou foi excluído. A assinatura não pode ser renovada nesse estado, portanto, repetir a atualização continua falhando. Para evitar notificações de alteração ausentes, crie uma nova assinatura em vez de repetir a atualização. Para reduzir a frequência com que isso acontece, renove as assinaturas bem antes de expirarem e use as notificações do ciclo de vida para renová-las de forma proativa.

Para detalhes sobre como os erros são retornados, confira Respostas de erro.

Exemplo

Solicitação

O exemplo a seguir mostra uma solicitação.

HTTP

PATCH https://graph.microsoft.com/beta/subscriptions/{id}
Content-type: application/json

{
   "expirationDateTime":"2016-11-22T18:23:45.9356913Z"
}

C#

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

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new Subscription
{
	ExpirationDateTime = DateTimeOffset.Parse("2016-11-22T18:23:45.9356913Z"),
};

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

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Ir

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

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

requestBody := graphmodels.NewSubscription()
expirationDateTime , err := time.Parse(time.RFC3339, "2016-11-22T18:23:45.9356913Z")
requestBody.SetExpirationDateTime(&expirationDateTime) 

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

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Java

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

Subscription subscription = new Subscription();
OffsetDateTime expirationDateTime = OffsetDateTime.parse("2016-11-22T18:23:45.9356913Z");
subscription.setExpirationDateTime(expirationDateTime);
Subscription result = graphClient.subscriptions().bySubscriptionId("{subscription-id}").patch(subscription);

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const subscription = {
   expirationDateTime: '2016-11-22T18:23:45.9356913Z'
};

await client.api('/subscriptions/{id}')
	.version('beta')
	.update(subscription);

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

PHP

<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\Models\Subscription;


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

$requestBody = new Subscription();
$requestBody->setExpirationDateTime(new \DateTime('2016-11-22T18:23:45.9356913Z'));

$result = $graphServiceClient->subscriptions()->bySubscriptionId('subscription-id')->patch($requestBody)->wait();

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

PowerShell

Import-Module Microsoft.Graph.Beta.ChangeNotifications

$params = @{
	expirationDateTime = [System.DateTime]::Parse("2016-11-22T18:23:45.9356913Z")
}

Update-MgBetaSubscription -SubscriptionId $subscriptionId -BodyParameter $params

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Python

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.subscription import Subscription
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = Subscription(
	expiration_date_time = "2016-11-22T18:23:45.9356913Z",
)

result = await graph_client.subscriptions.by_subscription_id('subscription-id').patch(request_body)

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK
Content-type: application/json

{
  "id":"7f105c7d-2dc5-4530-97cd-4e7ae6534c07",
  "resource":"me/messages",
  "applicationId": "24d3b144-21ae-4080-943f-7067b395b913",
  "changeType":"created,updated",
  "clientState":"secretClientValue",
  "notificationUrl":"https://webhook.azurewebsites.net/api/send/myNotifyClient",
  "lifecycleNotificationUrl":"https://webhook.azurewebsites.net/api/send/lifecycleNotifications",
  "expirationDateTime":"2016-11-22T18:23:45.9356913Z",
  "creatorId": "8ee44408-0679-472c-bc2a-692812af3437",
  "latestSupportedTlsVersion": "v1_2",
  "encryptionCertificate": "",
  "encryptionCertificateId": "",
  "includeResourceData": false,
  "notificationContentType": "application/json"
}