调用ListPermissions查询默认共享权限信息。

使用说明

本文将提供一个示例，在cn-hangzhou地域，查询资源类型为VSwitch的默认共享权限信息。

QPS限制

本API的单用户QPS限制为20次/秒，全局QPS限制为500次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListPermissions

要执行的操作。取值：ListPermissions。

ResourceType String 否 VSwitch

共享资源类型。

支持共享的资源类型，请参见支持资源共享的云服务。

MaxResults Integer 否 20

单次请求返回结果的最大条数。

取值范围：1~100。默认值：20。
NextToken String 否 TGlzdFJlc291cm****

当请求的返回结果被截断时，您可以使用NextToken再次发起请求，获取从当前截断位置之后的内容。

关于公共请求参数的详情，请参见公共参数。

返回数据

名称 类型 示例值 描述
NextToken String TGlzdFJlc291cm****

当请求的返回结果被截断时，您可以使用NextToken再次发起请求，获取从当前截断位置之后的内容。
RequestId String 04677DCA-7C33-464B-8811-1B1DA3C3D197

请求ID。
Permissions Array of Permission

共享权限信息。
PermissionName String AliyunRSDefaultPermissionVSwitch

共享权限名称。
PermissionVersion String v1

共享权限版本。
DefaultVersion Boolean true

共享权限是否为默认版本。取值：

  • false：不是默认版本。
  • true：是默认版本。
CreateTime String 2020-12-07T07:39:01.818Z

创建时间。
UpdateTime String 2020-12-07T07:39:01.818Z

更新时间。
ResourceType String VSwitch

共享资源类型。

支持共享的资源类型，请参见支持资源共享的云服务。

DefaultPermission Boolean true

是否为默认权限。取值：

  • false：不是默认权限。
  • true：是默认权限。

示例

请求示例

https://resourcesharing.cn-hangzhou.aliyuncs.com/?Action=ListPermissions
&ResourceType=VSwitch
&MaxResults=20
&NextToken=TGlzdFJlc291cm****
&<公共请求参数>

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ListPermissionsResponse>
    <NextToken>TGlzdFJlc291cm****</NextToken>
    <RequestId>04677DCA-7C33-464B-8811-1B1DA3C3D197</RequestId>
    <Permissions>
        <PermissionName>AliyunRSDefaultPermissionVSwitch</PermissionName>
        <PermissionVersion>v1</PermissionVersion>
        <DefaultVersion>true</DefaultVersion>
        <CreateTime>2020-12-07T07:39:01.818Z</CreateTime>
        <UpdateTime>2020-12-07T07:39:01.818Z</UpdateTime>
        <ResourceType>VSwitch</ResourceType>
        <DefaultPermission>true</DefaultPermission>
    </Permissions>
</ListPermissionsResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NextToken" : "TGlzdFJlc291cm****",
  "RequestId" : "04677DCA-7C33-464B-8811-1B1DA3C3D197",
  "Permissions" : [ {
    "PermissionName" : "AliyunRSDefaultPermissionVSwitch",
    "PermissionVersion" : "v1",
    "DefaultVersion" : true,
    "CreateTime" : "2020-12-07T07:39:01.818Z",
    "UpdateTime" : "2020-12-07T07:39:01.818Z",
    "ResourceType" : "VSwitch",
    "DefaultPermission" : true
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParameter.ResourceType The ResourceType is invalid. 传入的资源类型错误。
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个字符）。

访问错误中心查看更多错误码。