调用DescribeGrantRulesToCen接口查询云企业网实例已获得授权的跨账号的网络实例的信息。

调试

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

请求参数

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

系统规定参数。取值:DescribeGrantRulesToCen

RegionId String cn-hangzhou

网络实例所属地域ID。

您可以通过调用DescribeChildInstanceRegions接口获取地域ID。

CenId String cen-nye53d7p3hzyu4****

云企业网实例ID。

ProductType String VPC

网络实例的类型,取值:

  • VPC:专有网络实例。
  • VBR:边界路由器实例。
  • CCN:云连接网实例。
  • VPN:IPsec连接。
MaxResults Long 20

分批次查询时每次显示的条目数。取值范围:1~100

  • 如果您不指定MaxResults参数的值,则表示您不需要分批次查询。调用接口后MaxResults的值表示列表条目总数。
  • 如果您指定MaxResults参数的值,则表示您需要分批次查询。调用接口后MaxResults的值表示当前查询批次下列表条目的数量。建议指定MaxResults参数的值为20
NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

  • 第一次查询和没有下一次查询时,均无需填写。
  • 如果有下一次查询,取值为上一次API调用返回的NextToken值。

返回数据

名称 类型 示例值 描述
RequestId String 4906B209-8613-5C19-9CC9-B7A3FFDA731C

请求ID。

GrantRules Array of GrantRule

授权信息列表。

GrantRule
ChildInstanceType String VPC

网络实例的类型。

  • VPC:专有网络实例。
  • VBR:边界路由器实例。
  • CCN:云连接网实例。
  • VPN:IPsec连接。
ChildInstanceRegionId String cn-hangzhou

网络实例所属地域ID。

ChildInstanceOwnerId Long 1250123456123456

网络实例所属阿里云账号(主账号)ID。

ChildInstanceId String vpc-bp1rgeww9mdstuuar****

网络实例ID。

CenId String cen-nye53d7p3hzyu4****

云企业网实例ID。

OrderType String PayByCenOwner

网络实例的付费方。

  • PayByCenOwner:表示网络实例产生的费用由云企业网实例所属的账号承担。
  • PayByResourceOwner:表示网络实例产生的费用由网络实例所属的账号承担。
CenOwnerId Long 1210123456123456

云企业网实例所属的阿里云账号(主账号)ID。

TotalCount Long 1

列表条目数。

MaxResults Long 20

分批次查询时每次显示的条目数。

NextToken String FFmyTO70tTpLG6I3FmYAXGKPd****

是否拥有下一次查询的令牌(Token)。取值:

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值,该取值表示下一次查询开始的令牌。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeGrantRulesToCen
&RegionId=cn-hangzhou
&CenId=cen-nye53d7p3hzyu4****
&ProductType=VPC
&MaxResults=20
&公共请求参数

正常返回示例

XML格式

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

<DescribeGrantRulesToCenResponse>
    <RequestId>4906B209-8613-5C19-9CC9-B7A3FFDA731C</RequestId>
    <GrantRules>
        <ChildInstanceType>VPC</ChildInstanceType>
        <ChildInstanceRegionId>cn-hangzhou</ChildInstanceRegionId>
        <ChildInstanceOwnerId>1250123456123456</ChildInstanceOwnerId>
        <ChildInstanceId>vpc-bp1rgeww9mdstuuar****</ChildInstanceId>
        <CenId>cen-nye53d7p3hzyu4****</CenId>
        <OrderType>PayByCenOwner</OrderType>
        <CenOwnerId>1210123456123456</CenOwnerId>
    </GrantRules>
    <TotalCount>1</TotalCount>
    <MaxResults>20</MaxResults>
</DescribeGrantRulesToCenResponse>

JSON格式

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

{
  "RequestId" : "4906B209-8613-5C19-9CC9-B7A3FFDA731C",
  "GrantRules" : [ {
    "ChildInstanceType" : "VPC",
    "ChildInstanceRegionId" : "cn-hangzhou",
    "ChildInstanceOwnerId" : 1250123456123456,
    "ChildInstanceId" : "vpc-bp1rgeww9mdstuuar****",
    "CenId" : "cen-nye53d7p3hzyu4****",
    "OrderType" : "PayByCenOwner",
    "CenOwnerId" : 1210123456123456
  } ],
  "TotalCount" : 1,
  "MaxResults" : 20
}

错误码

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