ListRouteTargetGroups - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Consulta em lote os grupos de destino de rota.

Descrição da operação

Lista os grupos de destino de rota.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

GET  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
VpcId	string	Não	O ID da VPC à qual o grupo de destino de rota pertence.	vpc-xxxx
RouteTargetGroupIds	array	Não	A lista de IDs de instância dos grupos de destino de rota. Até 50 IDs de instância podem ser consultados por vez.
	string	Não	O ID da instância do grupo de destino de rota.	rtg-xxxx
MemberId	string	Não	O ID da instância membro do grupo de destino de rota. Filtra os grupos de destino de rota que contêm o ID da instância membro especificado.	ep-xxxx
MaxResults	integer	Não	O tamanho da página, com um intervalo de 1 a 50. Valor padrão: 50.	50
NextToken	string	Não	O token para a próxima consulta. Valor: Se for a primeira consulta ou não houver próxima consulta, este campo não precisa ser preenchido. Se houver uma próxima consulta, o valor deve ser o NextToken retornado pela chamada de API anterior.	FFmyTO70tTpLG6I3FmYAXGKPd****
RegionId	string	Sim	O ID da região da VPC à qual o grupo de destino de rota pertence. Você pode obter o ID da região chamando a API DescribeRegions.	cn-hangzhou
ResourceGroupId	string	Não	O ID do grupo de recursos. Para obter mais informações sobre grupos de recursos, consulte O que é um grupo de recursos?	rg-acfmxazdjdhd****
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Gere um valor de parâmetro exclusivo a partir do seu cliente para garantir a exclusividade em diferentes solicitações. O ClientToken suporta apenas caracteres ASCII. Nota: Se você não especificar isso, o sistema usará automaticamente o RequestId da solicitação de API como identificador ClientToken. O RequestId é diferente para cada solicitação de API.	123e4567-e89b-12d3-a456-426655440000
Tag	array<object>	Não	A lista de tags.
	object	Não	A tag do recurso.
Key	string	Não	A chave da tag do recurso. São suportadas até 20 chaves de tag. Se você precisar passar este valor, não poderá inserir uma string vazia. Uma chave de tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	FinanceJoshua
Value	string	Não	O valor da tag do recurso. São suportados até 20 valores de tag. Se você precisar passar este valor, poderá inserir uma string vazia. Um valor de tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	FinanceJoshua

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6
NextToken	string	O token para a próxima consulta. Valor: Se o NextToken estiver vazio, indica que não há próxima consulta. Se o NextToken tiver um valor de retorno, indica o token para a próxima consulta.	FFmyTO70tTpLG6I3FmYAXGKPd****
TotalCount	integer	O número de itens na lista.	1
RouteTargetGroups	array<object>	A lista de grupos de destino de rota.
	array<object>
Status	string	O status do grupo de destino de rota. Valores válidos: Recovering: Reversão ativo-standby em andamento Switched: Ativo-standby alternado Available: Disponível Abnormal: Instância standby anormal Pending: Criando Switching: Alternância ativo-standby em andamento Deleting: Excluindo Unavailable: As instâncias primária e standby estão anormais Valores válidos: Recovering : Recovering. Switched : Switched. Available : Available. Abnormal : Abnormal. Pending : Pending. Switching : Switching. Deleting : Deleting. Unavailable : Unavailable.	Available
RouteTargetGroupDescription	string	A descrição do grupo de destino de rota.	myRouteTargetGroupDescription
RouteTargetMemberList	array<object>	A lista de membros do grupo de destino de rota.
	object	A lista de membros do grupo de destino de rota.
MemberId	string	The ID of the route target group member instance.	ep-xxxx
EnableStatus	string	The enable status of the route target group member. Values: Enable: Enabled. Disable: Disabled. Only disabled route target group members can be modified to other instances. Enabled route target group members cannot be modified. Valores válidos: Enable : Enable Disable : Disable	Enable
MemberType	string	The type of the route target group member. Currently supported types: GatewayLoadBalancerEndpoint Valores válidos: GatewayLoadBalancerEndpoint : GatewayLoadBalancerEndpoint	GatewayLoadBalancerEndpoint
HealthCheckStatus	string	The health check status of the route target group member. Values: Normal: Normal Abnormal: Abnormal Valores válidos: Normal : Normal Abnormal : Abnormal	Normal
Weight	integer	The weight value of the route target group member. Values: 100: Indicates that the member is the primary instance. 0: Indicates that the member is the backup instance. The weight value can only be set during creation and cannot be modified.	100
VpcId	string	O ID da VPC à qual o grupo de destino de rota pertence.	vpc-uf60y8uzhsvbhmuh3l654
RouteTargetGroupId	string	O ID da instância do grupo de destino de rota.	rtg-xxxx
ConfigMode	string	O modo de configuração do grupo de destino de rota. Os modos suportados são os seguintes: Active-Standby: Modo ativo-standby. Valores válidos: Active-Standby : Active-Standby.	Active-Standby
RegionId	string	O ID da região da VPC à qual o grupo de destino de rota pertence. Você pode obter o ID da região chamando a API DescribeRegions.	cn-hangzhou
Tags	array<object>	Os valores das tags. São suportados no máximo 20 valores de tag. Se você precisar passar este valor, poderá inserir uma string vazia. São suportados no máximo 128 caracteres. O valor não pode começar com `aliyun` ou `acs:` e não pode conter `http://` ou `https://`.
	object	As tags.
Value	string	The value of the resource tag. Up to 20 tag values are supported. If you need to pass this value, you can input an empty string. A maximum of 128 characters is allowed. The value cannot start with `aliyun` or `acs:`, and it must not contain `http://` or `https://`.	8
Key	string	The key of the resource tag.	image/upload/cbbec42e0be33abb27babefcbe0397f0
RouteTargetGroupName	string	O nome do grupo de destino de rota.	myRouteTargetGroupName
ResourceGroupId	string	O ID do grupo de recursos ao qual o grupo de destino de rota pertence.	rg-acfm3swh6ta56ri
CreateTime	string	A hora em que o grupo de destino de rota foi criado.	2025-12-30T06:40:50Z
MaxResults	integer	O tamanho da página.	50

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6",
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "TotalCount": 1,
  "RouteTargetGroups": [
    {
      "Status": "Available",
      "RouteTargetGroupDescription": "myRouteTargetGroupDescription",
      "RouteTargetMemberList": [
        {
          "MemberId": "ep-xxxx",
          "EnableStatus": "Enable",
          "MemberType": "GatewayLoadBalancerEndpoint",
          "HealthCheckStatus": "Normal",
          "Weight": 100
        }
      ],
      "VpcId": "vpc-uf60y8uzhsvbhmuh3l654",
      "RouteTargetGroupId": "rtg-xxxx",
      "ConfigMode": "Active-Standby",
      "RegionId": "cn-hangzhou",
      "Tags": [
        {
          "Value": "8",
          "Key": "image/upload/cbbec42e0be33abb27babefcbe0397f0"
        }
      ],
      "RouteTargetGroupName": "myRouteTargetGroupName",
      "ResourceGroupId": "rg-acfm3swh6ta56ri",
      "CreateTime": "2025-12-30T06:40:50Z"
    }
  ],
  "MaxResults": 50
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	IllegalParam.NextToken	The specified NextToken is invalid.	The specified NextToken is invalid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.