资源使用者调用ListResourceShareInvitations查询自己收到的资源共享邀请信息。
接口说明
使用说明
本文将提供一个示例，查询当前账号在cn-hangzhou地域收到的资源共享邀请。返回结果显示，共收到 1 个邀请，且处于等待确认状态。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
resourcesharing:ListResourceShareInvitations |
list |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| MaxResults |
integer |
否 |
单次请求返回结果的最大条数。 取值范围：1~100。默认值：20。 |
20 |
| NextToken |
string |
否 |
当请求的返回结果被截断时，您可以使用 |
TGlzdFJlc291cm**** |
| ResourceShareIds |
array |
否 |
共享单元 ID。 |
|
|
string |
否 |
共享单元 ID。 |
rs-ysGRci9z**** |
|
| ResourceShareInvitationIds |
array |
否 |
资源共享邀请 ID。 |
|
|
string |
否 |
资源共享邀请 ID。 |
i-p6eRytrkjVvM**** |
关于公共请求参数的详情，请参见公共参数。
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回结果。 |
||
| NextToken |
string |
当请求的返回结果被截断时，您可以使用 |
TGlzdFJlc291cm**** |
| RequestId |
string |
请求 ID。 |
30EC8328-1BDE-51D5-BFAB-039508BD91A1 |
| ResourceShareInvitations |
array<object> |
资源共享邀请信息。 |
|
|
object |
资源共享邀请信息。 |
||
| Status |
string |
邀请状态。取值：
|
Pending |
| CreateTime |
string |
邀请创建时间（UTC 时间）。 |
2022-08-18T05:36:45.024Z |
| ResourceShareId |
string |
共享单元 ID。 |
rs-ysGRci9z**** |
| ResourceShareName |
string |
共享单元名称。 |
example |
| SenderAccountId |
string |
邀请者的阿里云账号 ID。 |
151266687691**** |
| ReceiverAccountId |
string |
被邀请者的阿里云账号 ID。 |
134254031178**** |
| ResourceShareInvitationId |
string |
资源共享邀请 ID。 |
i-p6eRytrkjVvM**** |
| InvitationFailedDetails |
array<object> |
接受共享单元邀请或退出共享单元检查失败详细原因。 |
|
|
object |
接受共享单元邀请或退出共享单元检查失败详细原因。 |
||
| Status |
string |
已弃用。请使用 FailureReason。 |
无 |
| StatusMessage |
string |
已弃用。请使用 FailureDescription。 |
无 |
| AssociateType |
string |
已弃用。请使用 OperationType。 |
无 |
| ResourceArn |
string |
||
| ResourceType |
string |
共享资源类型。 支持共享的资源类型，请参见支持资源共享的云服务。 |
Snapshot |
| FailureReason |
string |
接受或退出共享单元检查失败时的原因。取值：
|
Unavailable |
| FailureDescription |
string |
接受或退出共享单元检查失败时的详细原因描述。 |
You cannot access the specified resource at this time. |
| OperationType |
string |
操作类型。取值：
|
Associate |
| ResourceId |
string |
共享资源 ID。 |
s-7xvh46nx5oqlre0wv*** |
示例
正常返回示例
JSON格式
{
"NextToken": "TGlzdFJlc291cm****",
"RequestId": "30EC8328-1BDE-51D5-BFAB-039508BD91A1",
"ResourceShareInvitations": [
{
"Status": "Pending",
"CreateTime": "2022-08-18T05:36:45.024Z",
"ResourceShareId": "rs-ysGRci9z****",
"ResourceShareName": "example",
"SenderAccountId": "151266687691****",
"ReceiverAccountId": "134254031178****",
"ResourceShareInvitationId": "i-p6eRytrkjVvM****",
"InvitationFailedDetails": [
{
"Status": "无",
"StatusMessage": "无",
"AssociateType": "无",
"ResourceArn": "",
"ResourceType": "Snapshot",
"FailureReason": "Unavailable",
"FailureDescription": "You cannot access the specified resource at this time.",
"OperationType": "Associate",
"ResourceId": "s-7xvh46nx5oqlre0wv***"
}
]
}
]
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | InvalidParameter.MaxResults | The MaxResults is invalid. | MaxResults参数错误。 |
| 400 | InvalidParameter.NextToken | The NextToken is invalid. | NextToken参数错误。 |
| 400 | InvalidParameter.NextToken.Length | The maximum length of NextToken exceeds 256 characters. | NextToken长度超限（最大256个字符）。 |
| 400 | InvalidParameter.ResourceShareIds | The ResourceShareIds is invalid. | ResourceShareIds参数错误。 |
| 400 | InvalidParameter.ResourceShareIds.Duplicate | The ResourceShareIds contains duplicate values. | ResourceShareIds有重复项。 |
| 400 | InvalidParameter.ResourceShareIds.Length | The maximum length of ResourceShareIds exceeds 5 characters. | ResourceShareIds长度超限（最大5个）。 |
| 400 | InvalidParameter.ResourceShareInvitationIds | The ResourceShareInvitationIds is invalid. | 参数ResourceShareInvitationIds非法。 |
| 400 | InvalidParameter.ResourceShareInvitationIds.Duplicate | The ResourceShareInvitationIds duplicate values. | 参数ResourceShareInvitationIds重复。 |
| 400 | InvalidParameter.ResourceShareInvitationIds.Length | The maximum length of ResourceShareInvitationIds exceeds quota limit. | ResourceShareInvitationIds长度超限。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。