调用ListResourceShares查询共享单元列表。
本文将提供一个示例,查询当前账号在地域cn-hangzhou
创建的共享单元列表。返回结果显示,当前账号151266687691****
创建过以下2个共享单元:
- 共享单元
rs-hX9wC5jO****
,处于已删除Deleted
状态。 - 共享单元
rs-PqysnzIj****
,处于已启用Active
状态。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ListResourceShares |
要执行的操作。取值:ListResourceShares。 |
RegionId | String | 是 | cn-hangzhou |
地域ID。 支持资源共享的地域,请参见DescribeRegions。 |
ResourceOwner | String | 是 | Self |
共享单元归属者。取值:
|
ResourceShareIds.N | RepeatList | 否 | rs-PqysnzIj**** |
共享单元ID。 N的取值范围:1~5,即每次最多指定5个共享单元。 |
ResourceShareName | String | 否 | test |
共享单元名称。 |
ResourceShareStatus | String | 否 | Active |
共享单元状态。取值:
说明 Deleted状态的共享单元记录,会在48~96小时内被系统自动删除。
|
MaxResults | Integer | 否 | 20 |
单次请求返回结果的最大条数。 取值范围:1~20。默认值:20。 |
NextToken | String | 否 | TGlzdFJlc291cmNlU2hhcmVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0 |
当请求的返回结果被截断时,您可以使用 |
关于公共请求参数的详情,请参见公共参数。
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
NextToken | String | TGlzdFJlc291cmNlU2hhcmVzJjE1MTI2NjY4NzY5MTAzOTEmMiZORnI4NDhVeEtrUT0= |
当请求的返回结果被截断时,您可以使用 |
RequestId | String | 2F23CFB6-A721-4E90-AC1E-0E30FA8B45DA |
请求ID。 |
ResourceShares | Array of ResourceShare |
共享单元信息。 |
|
CreateTime | String | 2020-12-03T02:20:31.292Z |
共享单元创建时间。 |
ResourceShareId | String | rs-PqysnzIj**** |
共享单元ID。 |
ResourceShareName | String | test |
共享单元名称。 |
ResourceShareOwner | String | 151266687691**** |
共享单元归属者。 |
ResourceShareStatus | String | Active |
共享单元状态。取值:
说明 Deleted状态的共享单元记录,会在48~96小时内被系统自动删除。
|
UpdateTime | String | 2020-12-03T08:01:43.638Z |
共享单元更新时间。 |
示例
请求示例
https://resourcesharing.aliyuncs.com/?Action=ListResourceShares
&RegionId=cn-hangzhou
&ResourceOwner=Self
&<公共请求参数>
正常返回示例
XML
格式
<ListResourceSharesResponse>
<ResourceShares>
<ResourceShareId>rs-hX9wC5jO****</ResourceShareId>
<ResourceShareName>test1</ResourceShareName>
<ResourceShareStatus>Deleted</ResourceShareStatus>
<CreateTime>2020-12-03T02:47:14.651Z</CreateTime>
<UpdateTime>2020-12-03T08:01:56.696Z</UpdateTime>
<ResourceShareOwner>151266687691****</ResourceShareOwner>
</ResourceShares>
<ResourceShares>
<ResourceShareId>rs-PqysnzIj****</ResourceShareId>
<ResourceShareName>test</ResourceShareName>
<ResourceShareStatus>Active</ResourceShareStatus>
<CreateTime>2020-12-03T02:20:31.292Z</CreateTime>
<UpdateTime>2020-12-03T08:01:43.638Z</UpdateTime>
<ResourceShareOwner>151266687691****</ResourceShareOwner>
</ResourceShares>
<RequestId>2F23CFB6-A721-4E90-AC1E-0E30FA8B45DA</RequestId>
</ListResourceSharesResponse>
JSON
格式
{
"ResourceShares": [
{
"ResourceShareId": "rs-hX9wC5jO****",
"ResourceShareName": "test1",
"ResourceShareStatus": "Deleted",
"CreateTime": "2020-12-03T02:47:14.651Z",
"UpdateTime": "2020-12-03T08:01:56.696Z",
"ResourceShareOwner": "151266687691****"
},
{
"ResourceShareId": "rs-PqysnzIj****",
"ResourceShareName": "test",
"ResourceShareStatus": "Active",
"CreateTime": "2020-12-03T02:20:31.292Z",
"UpdateTime": "2020-12-03T08:01:43.638Z",
"ResourceShareOwner": "151266687691****"
}
],
"RequestId": "2F23CFB6-A721-4E90-AC1E-0E30FA8B45DA"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MissingParameter.ResourceOwner | You must specify ResourceOwner. | ResourceOwner参数缺失。 |
400 | InvalidParameter.ResourceOwner | The ResourceOwner is invalid. | ResourceOwner参数错误。 |
400 | InvalidParameter.ResourceShareName | The ResourceShareName is invalid. | 共享单元名称无效。 |
400 | InvalidParameter.ResourceShareName.Length | The maximum length of ResourceShareName exceeds 50 characters. | 共享单元名称字数超长(最大50字符)。 |
400 | InvalidParameter.ResourceShareStatus | The ResourceShareStatus is invalid. | ResourceShareStatus参数错误。 |
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.Length | The maximum length of ResourceShareIds exceeds 5 characters. | ResourceShareIds长度超限(最大5个)。 |
400 | InvalidParameter.ResourceShareIds.Duplicate | The ResourceShareIds contains duplicate values. | ResourceShareIds有重复项。 |
400 | InvalidParameter | The specified parameter is invalid. | 参数无效。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交