列出订阅

命名空间：microsoft.graph

检索 Webhook 订阅的列表。

响应的内容取决于应用调用的上下文；有关详细信息，请参阅 权限 部分中的方案。

此 API 可用于以下国家级云部署。

权限

根据请求的资源和权限类型（委托或应用程序），下表中指定的权限为调用此 API 所需的最小权限。 若要了解其他信息， 在 特权权限之前要特别小心，在"权限" 中搜索。

响应结果基于调用应用的上下文。 以下部分介绍常见方案。

aiInteraction

Copilot AI 交互上的订阅需要有效的 Copilot 许可证，其中包括以下 Copilot 服务计划：

• 智能 Microsoft 365 Copilot 副驾驶® 对话助手：3f30311c-6b1e-48a4-ab79-725b469da960

对于面向特定用户所属的 Copilot AI 交互的订阅，资源路径中的用户必须具有以有效状态分配给他们的以前的服务计划。

对于面向整个租户的 Copilot AI 交互的订阅，租户必须预配了包含所有以前的 Copilot 服务计划的有效许可证。

基本方案

最常见的情况是，应用程序希望检索最初为当前已登录用户创建的订阅，或者目录中的所有用户 (工作/学校帐户) 。 除了应用最初用于创建其订阅的权限之外，这些方案不需要任何特殊权限。

高级方案

在某些情况下，应用想要检索其他应用创建的订阅。 例如，用户希望看到任何应用程序代表他们创建的所有订阅。 或者，想要查看目录中所有应用的所有订阅的全局管理员。 对于此类方案，委派权限 Subscription.Read.All 是必需的。

HTTP 请求

GET /subscriptions

可选的查询参数

此方法不支持 OData 查询参数 来帮助自定义响应。

请求标头

请求正文

请勿提供此方法的请求正文。

响应

如果成功，此方法在响应正文中返回 200 OK 响应代码和 subscription 对象列表。

示例

请求

GET https://graph.microsoft.com/beta/subscriptions

// 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
var result = await graphClient.Subscriptions.GetAsync();

// 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
subscriptions, err := graphClient.Subscriptions().Get(context.Background(), nil)

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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

SubscriptionCollectionResponse result = graphClient.subscriptions().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let subscriptions = await client.api('/subscriptions')
	.version('beta')
	.get();

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


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


$result = $graphServiceClient->subscriptions()->get()->wait();

Import-Module Microsoft.Graph.Beta.ChangeNotifications

Get-MgBetaSubscription

# 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

result = await graph_client.subscriptions.get()

响应

以下示例显示了相应的响应。

注意： 为了提高可读性，可能缩短了此处显示的响应。

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

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#subscriptions",
  "value": [
    {
      "id": "0fc0d6db-0073-42e5-a186-853da75fb308",
      "resource": "Users",
      "applicationId": "24d3b144-21ae-4080-943f-7067b395b913",
      "changeType": "updated,deleted",
      "clientState": null,
      "notificationUrl": "https://webhookappexample.azurewebsites.net/api/notifications",
      "lifecycleNotificationUrl":"https://webhook.azurewebsites.net/api/send/lifecycleNotifications",
      "expirationDateTime": "2018-03-12T05:00:00Z",
      "creatorId": "8ee44408-0679-472c-bc2a-692812af3437",
      "latestSupportedTlsVersion": "v1_2",
      "encryptionCertificate": "",
      "encryptionCertificateId": "",
      "includeResourceData": false,
      "notificationContentType": "application/json"
    }
  ]
}

注意： 出于安全目的，不会返回 clientState 属性值。

当请求返回多页数据时，响应中包含一个 @odata.nextLink 属性，可帮助你管理结果。 若要了解详细信息，请参阅在应用中对 Microsoft Graph 数据进行分页。