governanceResource：register

项目
05/13/2022

命名空间：microsoft.graph

重要

Microsoft Graph版本下的 /beta API 可能会发生更改。不支持在生产应用程序中使用这些 API。若要确定 API 是否在 v1.0 中可用，请使用版本选择器。

注意

面向 Azure 资源的此版本特权标识管理 (PIM) API 即将弃用。请使用新的面向 Azure 资源角色的 Azure REST PIM API。

在 Privileged Identity Management 中注册 governanceResource 对象。

权限

要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限。

注意： 此 API 还要求请求者对资源至少具有一个活动角色分配。

Azure 资源

权限类型	权限
委派（工作或学校帐户）	PrivilegedAccess.ReadWrite.AzureResources
委派（个人 Microsoft 帐户）	不支持。
应用程序	不支持。

Azure AD

权限类型	权限
委派（工作或学校帐户）	PrivilegedAccess.ReadWrite.AzureAD
委派（个人 Microsoft 帐户）	不支持。
应用程序	不支持。

组

权限类型	权限
委派（工作或学校帐户）	PrivilegedAccess.ReadWrite.AzureADGroup
委派（个人 Microsoft 帐户）	不支持。
应用程序	不支持。

HTTP 请求

POST /privilegedAccess/azureResources/resources/register

可选的查询参数

此方法仅支持 $select OData 查询参数，$expand以帮助自定义响应。

请求标头

名称	说明
Authorization	持有者 {token}
Content-type	application/json

请求正文

属性	类型	说明
externalId	String	要在 PIM 中注册的资源的外部标识符。如果注册订阅，则标识符是订阅标识符，其 `/subscriptions/`前缀是订阅标识符。例如，`/subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac`。

响应

如果成功，此方法将返回 200 OK 响应。

示例

以下示例演示如何调用此 API。

请求

POST https://graph.microsoft.com/beta/privilegedAccess/azureResources/resources/register
Content-type: application/json

{
  "externalId": "/subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac"
}

响应

HTTP/1.1 200 OK