你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Invitations - List By Share
列出共享中的所有邀请。
列出共享中的邀请
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/invitations?api-version=2021-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataShare/accounts/{accountName}/shares/{shareName}/invitations?api-version=2021-08-01&$skipToken={$skipToken}&$filter={$filter}&$orderby={$orderby}
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
account
|
path | True |
string |
共享帐户的名称。 |
resource
|
path | True |
string |
资源组名称。 |
share
|
path | True |
string |
共享的名称。 |
subscription
|
path | True |
string |
订阅标识符 |
api-version
|
query | True |
string |
要使用的 API 版本。 |
$filter
|
query |
string |
使用 OData 语法筛选结果。 |
|
$orderby
|
query |
string |
使用 OData 语法对结果进行排序。 |
|
$skip
|
query |
string |
继续标记 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
成功 |
|
Other Status Codes |
从 Microsoft.DataShare 资源提供程序收到的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 流。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Invitations_ListByShare
Sample Request
Sample Response
Date: Wed, 13 Sep 2017 17:33:55 GMT
x-ms-request-id: 8e58266a-de42-40d5-b3c4-c6a7e159cfba
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-reads: 14993
x-ms-correlation-request-id: 5d862c55-4de9-4a46-969d-cf1ed3e235ed
{
"value": [
{
"properties": {
"userName": "John Smith",
"sentAt": "2018-11-26T22:33:24.5785265Z",
"targetEmail": "johnsmith@microsoft.com",
"invitationStatus": "Accepted",
"userEmail": "johnsmith@microsoft.com",
"expirationDate": "2020-08-26T22:33:24.5785265Z"
},
"id": "/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/testrg/providers/Microsoft.DataShare/accounts/account1/shares/share1/invitations/ancd",
"name": "ancd",
"type": "Microsoft.DataShare/Invitation"
}
]
}
定义
名称 | 说明 |
---|---|
created |
创建资源的标识类型。 |
Data |
数据共享错误模型。 |
Data |
数据共享错误主体模型。 |
Invitation |
邀请数据传输对象。 |
Invitation |
列出获取 InvitationList 的响应 |
invitation |
邀请的状态。 |
last |
上次修改资源的标识类型。 |
System |
与资源的创建和上次修改相关的元数据。 |
createdByType
创建资源的标识类型。
名称 | 类型 | 说明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DataShareError
数据共享错误模型。
名称 | 类型 | 说明 |
---|---|---|
error |
数据共享错误正文 |
DataShareErrorInfo
数据共享错误主体模型。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误代码 |
details |
错误模型的嵌套详细信息 |
|
message |
string |
错误消息 |
target |
string |
错误的目标 |
Invitation
邀请数据传输对象。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
Azure 资源的资源 ID |
name |
string |
Azure 资源的名称 |
properties.expirationDate |
string |
邀请和共享订阅的到期日期。 |
properties.invitationId |
string |
唯一邀请 ID |
properties.invitationStatus |
邀请的状态。 |
|
properties.respondedAt |
string |
收件人响应邀请的时间。 |
properties.sentAt |
string |
获取发送邀请的时间。 |
properties.targetActiveDirectoryId |
string |
目标 Azure AD ID。不能与电子邮件结合使用。 |
properties.targetEmail |
string |
邀请定向到的电子邮件。 |
properties.targetObjectId |
string |
要发送邀请的目标用户或应用程序 ID。 必须沿 TargetActiveDirectoryId 指定。 这允许向 AD 租户中的特定用户或应用程序发送邀请。 |
properties.userEmail |
string |
创建资源的用户的Email |
properties.userName |
string |
创建资源的用户的名称 |
systemData |
Azure 资源的系统数据。 |
|
type |
string |
Azure 资源的类型 |
InvitationList
列出获取 InvitationList 的响应
名称 | 类型 | 说明 |
---|---|---|
nextLink |
string |
下一个结果页的 URL。 |
value |
DataTransferObjects 类型的项的集合。 |
invitationStatus
邀请的状态。
名称 | 类型 | 说明 |
---|---|---|
Accepted |
string |
|
Pending |
string |
|
Rejected |
string |
|
Withdrawn |
string |
lastModifiedByType
上次修改资源的标识类型。
名称 | 类型 | 说明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
SystemData
与资源的创建和上次修改相关的元数据。
名称 | 类型 | 说明 |
---|---|---|
createdAt |
string |
资源创建时间戳 (UTC) 。 |
createdBy |
string |
创建资源的标识。 |
createdByType |
创建资源的标识类型。 |
|
lastModifiedAt |
string |
上次修改资源的标识类型。 |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识类型。 |