调用GetPermission查询共享权限信息。

使用说明

本文将提供一个示例，在cn-hangzhou地域，查询共享权限名称为AliyunRSDefaultPermissionVSwitch，权限版本为v1的共享权限信息。

QPS限制

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

调试

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

请求参数

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

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

PermissionName String 是 AliyunRSDefaultPermissionVSwitch

共享权限名称。
PermissionVersion String 否 v1

共享权限版本。

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

返回数据

名称 类型 示例值 描述
RequestId String 2F23CFB6-A721-4E90-AC1E-0E30FA8B45DA

请求ID。
Permission Object

共享权限信息。
PermissionName String AliyunRSDefaultPermissionVSwitch

共享权限名称。
PermissionVersion String v1

共享权限版本。
Permission String {"Effect":"Allow","Action":["vpc:DescribeVSwitches","vpc:DescribeVSwitchAttributes"]}

共享权限策略定义。
ResourceType String VSwitch

共享资源类型。

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

DefaultVersion Boolean true

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

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

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

更新时间。
DefaultPermission Boolean true

是否为默认权限。取值：

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

示例

请求示例

https://resourcesharing.cn-hangzhou.aliyuncs.com/?Action=GetPermission
&PermissionName=AliyunRSDefaultPermissionVSwitch
&PermissionVersion=v1
&<公共请求参数>

正常返回示例

XML格式 

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

<GetPermissionResponse>
    <RequestId>2F23CFB6-A721-4E90-AC1E-0E30FA8B45DA</RequestId>
    <Permission>
        <PermissionName>AliyunRSDefaultPermissionVSwitch</PermissionName>
        <PermissionVersion>v1</PermissionVersion>
        <Permission>{\"Effect\":\"Allow\",\"Action\":[\"vpc:DescribeVSwitches\",\"vpc:DescribeVSwitchAttributes\"]}</Permission>
        <ResourceType>VSwitch</ResourceType>
        <DefaultVersion>true</DefaultVersion>
        <CreateTime>2020-12-07T07:39:01.818Z</CreateTime>
        <UpdateTime>2020-12-07T07:39:01.818Z</UpdateTime>
        <DefaultPermission>true</DefaultPermission>
    </Permission>
</GetPermissionResponse>

JSON格式 

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

{
  "RequestId" : "2F23CFB6-A721-4E90-AC1E-0E30FA8B45DA",
  "Permission" : {
    "PermissionName" : "AliyunRSDefaultPermissionVSwitch",
    "PermissionVersion" : "v1",
    "Permission" : "{\\\"Effect\\\":\\\"Allow\\\",\\\"Action\\\":[\\\"vpc:DescribeVSwitches\\\",\\\"vpc:DescribeVSwitchAttributes\\\"]}",
    "ResourceType" : "VSwitch",
    "DefaultVersion" : true,
    "CreateTime" : "2020-12-07T07:39:01.818Z",
    "UpdateTime" : "2020-12-07T07:39:01.818Z",
    "DefaultPermission" : true
  }
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidParameter.PermissionVersion The PermissionVersion is invalid. PermissionVersion参数错误。
400 MissingParameter.PermissionName You must specify PermissionName. PermissionName参数缺失。
404 EntityNotExists.Permission The resource share permission does not exist. 共享权限不存在。

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