governanceResource: registergovernanceResource: register

重要

Microsoft Graph の/betaバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでは、これらの API の使用はサポートされていません。Use of these APIs in production applications is not supported.

特権 Id 管理にgovernanceResourceオブジェクトを登録します。Register a governanceResource object in Privileged Identity Management.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

注: この API では、要求者がリソースに対して少なくとも1つのアクティブなロール割り当てを持っている必要もあります。Note: This API also requires that the requester have at least one active role assignment on the resource.

アクセス許可の種類Permission type アクセス許可Permissions
委任 (職場または学校のアカウント)Delegated (work or school account) PrivilegedAccess AzureResourcesPrivilegedAccess.ReadWrite.AzureResources
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) サポートされていません。Not supported.
アプリケーションApplication サポートされていません。Not supported.

HTTP 要求HTTP request

POST /privilegedAccess/azureResources/resources/register

オプションのクエリ パラメーターOptional query parameters

このメソッド**** は、応答$select$expandカスタマイズするためのおよびOData クエリパラメーターのみをサポートしています。This method only supports the $select and $expand OData query parameters to help customize the response.

要求ヘッダーRequest headers

名前Name 説明Description
AuthorizationAuthorization ベアラー {トークン}Bearer {token}
Content-typeContent-type application/jsonapplication/json

要求本文Request body

プロパティProperties Type 説明Description
externalIdexternalId StringString PIM に登録するリソースの外部識別子。The external identifier of the resource to be registered in PIM. サブスクリプションを登録する場合、識別子はサブスクリプション id の先頭に/subscriptions/になります。If registering a subscription, the identifier is the subscription identifier prepended by /subscriptions/. たとえば、/subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac などです。For example, /subscriptions/c14ae696-5e0c-4e5d-88cc-bef6637737ac.

応答Response

成功した場合、このメソッド200 OKは応答を返します。If successful, this method returns a 200 OK response.

Example

次の例は、この API を呼び出す方法を示しています。The following example shows how to call this API.

要求Request

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

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

応答Response

HTTP/1.1 200 OK