Todos os produtos
Search
Central de documentação

:ListGrantVSwitchesToCen

Última atualização: Jul 03, 2026

Consulta os vSwitches em uma Virtual Private Cloud (VPC) que pertence a outra conta Alibaba Cloud e está associada a uma instância do Cloud Enterprise Network (CEN).

Observações de uso

Antes de chamar a operação ListGrantVSwitchesToCen, verifique se os seguintes requisitos foram atendidos:

  • As permissões da VPC foram concedidas à instância CEN. Para mais informações, consulte GrantInstanceToCen.

  • A VPC está associada à instância CEN.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim ListGrantVSwitchesToCen

Operação a ser executada. Defina o valor como ListGrantVSwitchesToCen.

RegionId String Sim cn-hangzhou

ID da região da VPC.

Chame a operação DescribeChildInstanceRegions para consultar a lista de regiões mais recente.

CenId String Sim cen-44m0p68spvlrqq****

ID da instância CEN.

VpcId String Sim vpc-bp12ge2tq5gzdc915****

ID da VPC.

PageNumber Integer Não 1

Número da página a ser retornada. Valor padrão: 1.

PageSize Integer Não 10

Quantidade de entradas por página. Valores válidos: de 1 a 50. Valor padrão: 10.

ZoneId String Não cn-hangzhou-h

ID da zona.

  • Se você especificar um ID de zona, o sistema consultará as informações dos vSwitches nessa zona.
  • Caso não especifique um ID de zona, o sistema consultará as informações dos vSwitches em todas as zonas.

Chame a operação DescribeZones para obter a lista de zonas mais recente.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

PageSize

Integer

10

Quantidade de entradas retornadas por página.

RequestId

String

A9288C78-881A-5D30-A8A9-68E05EE0A086

ID da solicitação.

PageNumber

Integer

1

Número da página retornada.

TotalCount

Integer

2

Total de entradas retornadas.

VSwitches

Array of VSwitch

Lista de vSwitches.

VpcId

String

vpc-bp12ge2tq5gzdc915****

ID da VPC à qual o vSwitch pertence.

ZoneId

String

cn-hangzhou-h

ID da zona à qual o vSwitch pertence.

VSwitchId

String

vsw-bp1194lh263wx1gsk****

ID do vSwitch.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=ListGrantVSwitchesToCen
&RegionId=cn-hangzhou
&CenId=cen-44m0p68spvlrqq****
&VpcId=vpc-bp12ge2tq5gzdc915****
&PageNumber=1
&PageSize=10
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

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

<ListGrantVSwitchesToCenResponse>
    <TotalCount>2</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>A9288C78-881A-5D30-A8A9-68E05EE0A086</RequestId>
    <PageNumber>1</PageNumber>
    <VSwitches>
        <VpcId>vpc-bp12ge2tq5gzdc915****</VpcId>
        <ZoneId>cn-hangzhou-h</ZoneId>
        <VSwitchId>vsw-bp1194lh263wx1gsk****</VSwitchId>
    </VSwitches>
    <VSwitches>
        <VpcId>vpc-bp12ge2tq5gzdc915****</VpcId>
        <ZoneId>cn-hangzhou-i</ZoneId>
        <VSwitchId>vsw-bp1607g2jc48qanlk****</VSwitchId>
    </VSwitches>
</ListGrantVSwitchesToCenResponse>

Formato JSON

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

{
  "TotalCount" : 2,
  "PageSize" : 10,
  "RequestId" : "A9288C78-881A-5D30-A8A9-68E05EE0A086",
  "PageNumber" : 1,
  "VSwitches" : [ {
    "VpcId" : "vpc-bp12ge2tq5gzdc915****",
    "ZoneId" : "cn-hangzhou-h",
    "VSwitchId" : "vsw-bp1194lh263wx1gsk****"
  }, {
    "VpcId" : "vpc-bp12ge2tq5gzdc915****",
    "ZoneId" : "cn-hangzhou-i",
    "VSwitchId" : "vsw-bp1607g2jc48qanlk****"
  } ]
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Error Center.