Azure AD 受給管理 API を使用するWorking with the Azure AD entitlement management API

名前空間: microsoft.graphNamespace: microsoft.graph

重要

/betaMicrosoft Graph のバージョンの api は変更される可能性があります。APIs under the /beta version in Microsoft Graph are subject to change. 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。Use of these APIs in production applications is not supported. API が v2.0 で利用できるかどうかを確認するには、 バージョン セレクターを使用します。To determine whether an API is available in v1.0, use the Version selector.

Azure Active Directory (Azure AD) 受給管理は、組織外のユーザーだけでなく、内部ユーザーのグループ、アプリケーション、および SharePoint Online サイトへのアクセスを管理するのに役立ちます。Azure Active Directory (Azure AD) entitlement management can help you manage access to groups, applications, and SharePoint Online sites for internal users as well as users outside your organization.

ユーザーがこれらのリソースに対して持っている必要がある役割を持つアクセスパッケージを作成し、アクセスパッケージを要求できるユーザーとアクセスパッケージに割り当て可能な期間を定義することによって、内部ユーザーと外部ユーザーの両方のアクセスのライフサイクルを管理できます。By creating access packages with the roles users need to have across those resources, and defining policies for who can request an access package and how long they can have an assignment to an access package, you can govern the lifecycle of access for both internal and external users.

利用資格管理リソースの種類には、次のものがあります。The entitlement management resource types include:

利用資格管理を使用して、内部ユーザーがセルフサービス要求できるリソースのパッケージを作成する方法を示すチュートリアルについては、「 Microsoft Graph api を使用して access パッケージを作成する」を参照してください。For a tutorial that shows you how to use entitlement management to create a package of resources that internal users can self-service request, see Create an access package using Microsoft Graph APIs.

API を含む利用資格管理機能は Azure AD Premium P2 に含まれていることに注意してください。Note that the entitlement management feature, including the API, is included in Azure AD Premium P2. 利用資格管理が使用されているテナントには、有効な購入済みまたは試用版の Azure AD プレミアム P2 または EMS E5 サブスクリプションが必要です。The tenant where entitlement management is being used must have a valid purchased or trial Azure AD Premium P2 or EMS E5 subscription.

メソッドMethods

次の表に、資格情報管理に関連するリソースとの対話に使用できる方法を示します。The following table lists the methods that you can use to interact with entitlement management-related resources.

メソッドMethod 戻り値の種類Return type 説明Description
GetGet entitlementManagementSettingsentitlementManagementSettings EntitlementManagementSettingsオブジェクトのプロパティを読み取ります。Read the properties of an entitlementManagementSettings object.
UpdateUpdate entitlementManagementSettingsentitlementManagementSettings EntitlementManagementSettingsオブジェクトのプロパティを更新します。Update the properties of an entitlementManagementSettings object.
リスト accessPackagesList accessPackages accessPackage コレクションaccessPackage collection AccessPackageオブジェクトのリストを取得します。Retrieve a list of accessPackage objects.
AccessPackage を作成するCreate accessPackage accessPackageaccessPackage 新しい accessPackage オブジェクトを作成します。Create a new accessPackage object.
AccessPackage を取得するGet accessPackage accessPackageaccessPackage AccessPackageオブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of an accessPackage object.
AccessPackage の更新Update accessPackage なしNone Accesspackageオブジェクトのプロパティを更新します。Update the properties of an accesspackage object.
AccessPackage の削除Delete accessPackage AccessPackageを削除します。Delete accessPackage.
リスト accessPackageResourceRoleScopesList accessPackageResourceRoleScopes accessPackageResourceRoleScope コレクションaccessPackageResourceRoleScope collection アクセスパッケージの accessPackageResourceRoleScope オブジェクトのリストを取得します。Retrieve a list of accessPackageResourceRoleScope objects for an access package.
AccessPackageResourceRoleScope を作成するCreate accessPackageResourceRoleScope Access パッケージ用の新しい accessPackageResourceRoleScope オブジェクトを作成します。Create a new accessPackageResourceRoleScope object for an access package.
リスト accessPackageAssignmentPoliciesList accessPackageAssignmentPolicies accessPackageAssignmentPolicy コレクションaccessPackageAssignmentPolicy collection AccessPackageAssignmentPolicyオブジェクトのリストを取得します。Retrieve a list of accessPackageAssignmentPolicy objects.
AccessPackageAssignmentPolicy を作成するCreate accessPackageAssignmentPolicy accessPackageAssignmentPolicyaccessPackageAssignmentPolicy 新しい accessPackageAssignmentPolicy オブジェクトを作成します。Create a new accessPackageAssignmentPolicy object.
AccessPackageAssignmentPolicy を取得するGet accessPackageAssignmentPolicy accessPackageAssignmentPolicyaccessPackageAssignmentPolicy AccessPackageAssignmentPolicyオブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of an accessPackageAssignmentPolicy object.
AccessPackageAssignmentPolicy の更新Update accessPackageAssignmentPolicy accessPackageAssignmentPolicyaccessPackageAssignmentPolicy AccessPackageAssignmentPolicyオブジェクトのプロパティを更新します。Update the properties of an accessPackageAssignmentPolicy object.
AccessPackageAssignmentPolicy の削除Delete accessPackageAssignmentPolicy AccessPackageAssignmentPolicyを削除します。Delete an accessPackageAssignmentPolicy.
リスト accessPackageAssignmentRequestsList accessPackageAssignmentRequests accessPackageAssignmentRequest コレクションaccessPackageAssignmentRequest collection AccessPackageAssignmentRequestオブジェクトのリストを取得します。Retrieve a list of accessPackageAssignmentRequest objects.
AccessPackageAssignmentRequest を作成するCreate accessPackageAssignmentRequest accessPackageAssignmentRequestaccessPackageAssignmentRequest 新しい accessPackageAssignmentRequestを作成します。Create a new accessPackageAssignmentRequest.
AccessPackageAssignmentRequest を取得するGet accessPackageAssignmentRequest accessPackageAssignmentRequestaccessPackageAssignmentRequest AccessPackageAssignmentRequestオブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of an accessPackageAssignmentRequest object.
リスト accessPackageAssignmentsList accessPackageAssignments accessPackageAssignment コレクションaccessPackageAssignment collection AccessPackageAssignmentオブジェクトのリストを取得します。Retrieve a list of accessPackageAssignment objects.
リスト accessPackageAssignmentResourceRolesList accessPackageAssignmentResourceRoles accessPackageAssignmentResourceRole コレクションaccessPackageAssignmentResourceRole collection AccessPackageAssignmentResourceRoleオブジェクトのリストを取得します。Retrieve a list of accessPackageAssignmentResourceRole objects.
AccessPackageAssignmentResourceRole を取得するGet accessPackageAssignmentResourceRole accessPackageAssignmentResourceRoleaccessPackageAssignmentResourceRole AccessPackageAssignmentResourceRoleオブジェクトを取得します。Retrieve a accessPackageAssignmentResourceRole object.
リスト accessPackageCatalogsList accessPackageCatalogs accessPackageCatalog コレクションaccessPackageCatalog collection AccessPackageCatalogsオブジェクトのリストを取得します。Retrieve a list of accessPackageCatalogs objects.
AccessPackageCatalog を作成するCreate accessPackageCatalog accessPackageCatalogaccessPackageCatalog 新しい accessPackageCatalog オブジェクトを作成します。Create a new accessPackageCatalog object.
AccessPackageCatalog を取得するGet accessPackageCatalog accessPackageCatalogaccessPackageCatalog AccessPackageCatalogオブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of an accessPackageCatalog object.
AccessPackageCatalog の更新Update accessPackageCatalog なしNone AccessPackageCatalogオブジェクトのプロパティを更新します。Update the properties of an accessPackageCatalog object.
AccessPackageCatalog の削除Delete accessPackageCatalog AccessPackageCatalogを削除します。Delete an accessPackageCatalog.
AccessPackageCatalog リソースを一覧表示するList accessPackageCatalog resources accessPackageResource コレクションaccessPackageResource collection AccessPackageResourceオブジェクトのリストを取得します。Retrieve a list of accessPackageResource objects.
AccessPackageCatalog リソースの役割を一覧表示するList accessPackageCatalog resource roles accessPackageResourceRole コレクションaccessPackageResourceRole collection AccessPackageResourceRoleオブジェクトのリストを取得します。Retrieve a list of accessPackageResourceRole objects.
リスト accessPackageResourceRequestsList accessPackageResourceRequests accessPackageResourceRequest コレクションaccessPackageResourceRequest collection AccessPackageResourceRequestオブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of accessPackageResourceRequest objects.
AccessPackageResourceRequest を作成するCreate accessPackageResourceRequest accessPackageCatalogaccessPackageCatalog 新しい accessPackageResourceRequest オブジェクトを作成します。Create a new accessPackageResourceRequest object.
ConnectedOrganizations を一覧表示するList connectedOrganizations Connectedorganization コレクションconnectedOrganization collection Connectedorganizationオブジェクトの一覧を取得します。Retrieve a list of connectedOrganization objects.
ConnectedOrganization の作成Create connectedOrganization connectedOrganizationconnectedOrganization 新しい Connectedorganization オブジェクトを作成します。Create a new connectedOrganization object.
ConnectedOrganization の取得Get connectedOrganization connectedOrganizationconnectedOrganization Connectedorganizationオブジェクトのプロパティとリレーションシップを読み取ります。Read properties and relationships of a connectedOrganization object.
ConnectedOrganization の更新Update connectedOrganization なしNone Connectedorganizationを更新します。Update a connectedOrganization.
ConnectedOrganization の削除Delete connectedOrganization なしNone Connectedorganizationを削除します。Delete a connectedOrganization.
InternalSponsors を一覧表示するList internalSponsors directoryObject コレクションdirectoryObject collection Connectedorganization の内部スポンサの一覧を取得します。Retrieve a list of a connectedOrganization's internal sponsors.
ExternalSponsors を一覧表示するList externalSponsors directoryObject コレクションdirectoryObject collection Connectedorganization の外部スポンサの一覧を取得します。Retrieve a list of a connectedOrganization's external sponsors.
InternalSponsors を追加するAdd internalSponsors なしNone ユーザーまたはグループを、 Connectedorganization の 内部スポンサーに追加します。Add a user or group to a connectedOrganization's internal sponsors.
ExternalSponsors を追加するAdd externalSponsors なしNone ユーザーまたはグループを、 Connectedorganization の 外部スポンサに追加します。Add a user or group to a connectedOrganization's external sponsors.
InternalSponsors の削除Remove internalSponsors なしNone ユーザーまたはグループを、 Connectedorganization の 内部スポンサーから削除します。Remove a user or group from a connectedOrganization's internal sponsors.
ExternalSponsors の削除Remove externalSponsors なしNone ユーザーまたはグループを、 Connectedorganization の 外部スポンサから削除します。Remove a user or group from a connectedOrganization's external sponsors.

Types

関連項目See also