列出共享项
本文内容
命名空间：microsoft.graph
重要
Microsoft Graph版本下的 /beta API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
检索 printerShares 列表 。
权限
要调用此 API，需要以下权限之一。要了解详细信息，包括如何选择权限的信息，请参阅权限 。
若要使用通用打印服务，除下表中列出的权限外，用户或应用的租户还必须具有活动的通用打印订阅。
权限类型
权限（从最低特权到最高特权）
委派（工作或学校帐户）
PrinterShare.ReadBasic.All、PrinterShare.Read.All、PrinterShare.ReadWrite.All
委派（个人 Microsoft 帐户）
不支持。
应用程序
不支持。
HTTP 请求
GET /print/shares
可选的查询参数
此方法支持一些 OData 查询参数来帮助自定义响应。 若要了解一般信息，请参阅 OData 查询参数 。
注意： 使用 $top=n 查询参数将 返回到 n共享。 调用方需要使用跳过令牌来枚举整个列表。
例外
不支持某些运算符： $count， ， $orderby。 $search
名称
说明
Authorization
Bearer {token}。必需。
请求正文
请勿提供此方法的请求正文。
响应
如果成功，此方法在响应正文中返回 200 OK 响应代码和 printerShare 对象集合。
注意 ：响应将不包含 默认 值或 功能 属性。
对于以下方案，响应将包含 id、displayName、manufacturer、model、location) (有限属性集：
代表不是 打印机管理员 的用户列出打印机共享。
根据或 location. capabilities 筛选打印机共享。
可以通过 Get printerShare 请求获取其他属性。
示例
请求
下面展示了示例请求。
GET https://graph.microsoft.com/beta/print/shares
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
var shares = await graphClient.Print.Shares
.Request()
.GetAsync();
const options = {
authProvider,
};
const client = Client.init(options);
let shares = await client.api('/print/shares')
.version('beta')
.get();
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/print/shares"]]];
[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];
MSGraphPrinterShare *printerShare = [[MSGraphPrinterShare alloc] initWithDictionary:[[collection value] objectAtIndex: 0] error:&nserror];
}];
[meDataTask execute];
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
PrinterShareCollectionPage shares = graphClient.print().shares()
.buildRequest()
.get();
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
result, err := graphClient.Print().Shares().Get()
Import-Module Microsoft.Graph.Devices.CloudPrint
Get-MgPrintShare
响应
下面展示了示例响应。
注意： 为了提高可读性，可能缩短了此处显示的响应对象。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#print/shares",
"value": [
{
"id": "016b5565-3bbf-4067-b9ff-4d68167eb1a6",
"displayName": "PrinterShareName",
"createdDateTime": "2020-02-04T00:00:00.0000000Z"
}
]
}