列出 accessPackages
本文内容
命名空间：microsoft.graph
重要
Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
检索 accessPackage 对象 的列表。 生成的列表包括调用方有权访问的所有目录内的所有访问包。
权限
要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限 。
权限类型
权限（从最低特权到最高特权）
委派（工作或学校帐户）
EntitlementManagement.Read.All、EntitlementManagement.ReadWrite.All
委派（个人 Microsoft 帐户）
不支持。
应用程序
EntitlementManagement.Read.All、EntitlementManagement.ReadWrite.All
HTTP 请求
GET /identityGovernance/entitlementManagement/accessPackages
可选的查询参数
此方法支持 $select 和 $filter OData 查询参数来帮助自定义响应。 例如，若要检索每个访问包的访问包策略，请添加 $expand=accessPackageAssignmentPolicies 。 若要搜索具有特定名称的访问包，请包含筛选器（ $filter=contains(tolower(displayName),'team') 如 在查询中）。 若要了解一般信息，请参阅 OData 查询参数 。
名称
说明
Authorization
持有者 {token}。必需。
请求正文
请勿提供此方法的请求正文。
响应
如果成功，此方法在响应正文中返回 响应代码和 200 OK accessPackage 对象集合。
示例
请求
下面展示了示例请求。
GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackages
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
var accessPackages = await graphClient.IdentityGovernance.EntitlementManagement.AccessPackages
.Request()
.GetAsync();
const options = {
authProvider,
};
const client = Client.init(options);
let accessPackages = await client.api('/identityGovernance/entitlementManagement/accessPackages')
.version('beta')
.get();
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/identityGovernance/entitlementManagement/accessPackages"]]];
[urlRequest setHTTPMethod:@"GET"];
MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {
NSError *jsonError = nil;
MSCollection *collection = [[MSCollection alloc] initWithData:data error:&jsonError];
MSGraphAccessPackage *accessPackage = [[MSGraphAccessPackage alloc] initWithDictionary:[[collection value] objectAtIndex: 0] error:&nserror];
}];
[meDataTask execute];
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
AccessPackageCollectionPage accessPackages = graphClient.identityGovernance().entitlementManagement().accessPackages()
.buildRequest()
.get();
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
result, err := graphClient.IdentityGovernance().EntitlementManagement().AccessPackages().Get()
Import-Module Microsoft.Graph.Identity.Governance
Get-MgEntitlementManagementAccessPackage
响应
下面展示了示例响应。
注意： 为了提高可读性，可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"value": [
{
"id":"360fa7de-90be-48dc-a2ce-fc40094a93dd",
"description":"Sample access package",
"displayName":"Access package for testing",
"isHidden":false,
"catalogId":"662d99e7-6ceb-4c21-9cb4-9b0bbfdefccc",
"isRoleScopesVisible":false,
"createdDateTime":"2019-01-27T18:19:50.74Z",
"modifiedDateTime":"2019-01-27T18:19:50.74Z",
"createdBy":"TestGA@example.com",
"modifiedBy":"TestGA@example.com"
}
]
}