DescribeHybridCloudClusterServers - Web Application Firewall: Central de Documentação do Alibaba Cloud

Consulta a lista de máquinas em um cluster.

Descrição da operação

Antes de chamar esta operação, certifique-se de que o recurso de nuvem híbrida esteja ativado para a instância do WAF. Chame a operação DescribeInstance para consultar os detalhes da instância. Se o parâmetro de resposta Details.HybridCloud for true, o recurso de nuvem híbrida estará ativado. Se o recurso não estiver ativado, faça login no console do WAF e atualize a instância para ativar o recurso de nuvem híbrida.

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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

yundun-waf:DescribeHybridCloudClusterServers

get

*Todos os recursos.

*

acs:ResourceGroupId

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância do WAF. Nota Você pode chamar a operação DescribeInstance para consultar o ID da instância atual do WAF.	waf_v3prepaid_public_cn-******nd07
ClusterId	integer	Sim	O ID do cluster.	1
Ip	string	Não	O endereço IP do servidor.	1.X.X.1
HostName	string	Não	O nome do host.	online-***wwq
GroupType	string	Não	O tipo do grupo de nós de nuvem híbrida. Valores válidos: protect: proteção. control: gerenciamento. storage: armazenamento. controlStorage: gerenciamento e armazenamento.	protect
GroupName	string	Não	O nome do grupo de nós.	groupTest
PageSize	integer	Não	O número de entradas por página para paginação. Valor padrão: 10.	10
PageNumber	integer	Não	O número da página. Valor padrão: 1.	1
RegionId	string	Não	A região onde a instância do WAF está implantada. Valores válidos: cn-hangzhou: China continental. ap-southeast-1: fora da China continental.	cn-hangzhou
ResourceManagerResourceGroupId	string	Não	O ID do grupo de recursos do Alibaba Cloud.	rg-acfm***q

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
TotalCount	integer	O número total de entradas retornadas.	3
RequestId	string	O ID da solicitação.	C3B0FDD2-11CE-59A5-BEB5-*****1A969
ClusterServers	array<object>	A lista de resultados.
	object
GroupName	string	O nome do grupo de nós.	groupTest
Operator	string	O provedor de serviços em nuvem.	aliyun
Status	string	O status da máquina.	ok
RegionCodeValue	integer	O código da região.	0
RegionCode	string	O nome da região.	beijing
Memory	integer	Os dados de memória.	33547386880
Ip	string	O endereço IP.	1..1
Cpu	integer	O número de núcleos de CPU.	4
Mid	string	O identificador da máquina (MID).	28ab688cd403563e8e173*****79600
ContinentsValue	integer	O código do continente do cluster de proteção. Nota Para obter a lista de valores de código, consulte a descrição suplementar dos parâmetros de resposta.	410
Mac	string	O endereço MAC.	::00:02:eb:c7
GroupId	integer	O ID do grupo de nós.	1
JobStatus	string	O status de execução da máquina.	running
GroupType	string	O tipo do grupo de nós de nuvem híbrida. Valores válidos: protect: proteção. control: gerenciamento. storage: armazenamento. controlStorage: gerenciamento e armazenamento.	protect
CustomName	string	O nome do nó.	customTest
UpdateTimestamp	integer	O timestamp da última atualização.	1711953897000
Continents	string	O continente.	asiapacific
CreateTimestamp	integer	O timestamp de criação, em milissegundos.	1665987186000
HostName	string	O nome do host.	qsh5-sec-waf-*****-6
OperatorValue	integer	O valor do operador.	0

Exemplos

Resposta de sucesso

JSON formato

{
  "TotalCount": 3,
  "RequestId": "C3B0FDD2-11CE-59A5-BEB5-*****1A969",
  "ClusterServers": [
    {
      "GroupName": "groupTest",
      "Operator": "aliyun",
      "Status": "ok",
      "RegionCodeValue": 0,
      "RegionCode": "beijing",
      "Memory": 33547386880,
      "Ip": "1.*.*1",
      "Cpu": 4,
      "Mid": "28ab688cd403563e8e173*****79600",
      "ContinentsValue": 410,
      "Mac": "**:**:00:02:eb:c7",
      "GroupId": 1,
      "JobStatus": "running",
      "GroupType": "protect",
      "CustomName": "customTest",
      "UpdateTimestamp": 1711953897000,
      "Continents": "asiapacific",
      "CreateTimestamp": 1665987186000,
      "HostName": "qsh5-sec-waf-*****-6",
      "OperatorValue": 0
    }
  ]
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.