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

Consulta a lista de recursos conectados ao WAF no modo nativo da nuvem.

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:DescribeCloudResourceList

list

*DefenseResource

acs:yundun-waf:{#regionId}:{#accountId}:defenseresource/{#Resource}

Nenhuma

yundun-waf:DescribeCloudResourceList

Sintaxe da solicitação

POST  HTTP/1.1

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 DescribeInstance para consultar o ID da instância atual do WAF.	waf_elasticity-cn-0xldbqt****
ResourceManagerResourceGroupId	string	Não	O ID do grupo de recursos do Alibaba Cloud.	rg-acfm***q
OwnerUserId	string	Não	O UID do usuário proprietário do recurso.	1111111111
ResourceInstanceId	string	Não	O ID da instância do recurso.	i-8vbdlsd********81e22
Port	string	Não	A porta do serviço em nuvem conectado ao WAF.	80
ResourceProduct	string	Não	O serviço em nuvem ao qual o recurso pertence. Valores válidos: alb: Application Load Balancer (ALB). mse: Microservices Engine (MSE). fc: Function Compute (FC). sae: Serverless App Engine (SAE). ecs: Elastic Compute Service (ECS). clb4: Classic Load Balancer (CLB) (TCP). clb7: Classic Load Balancer (CLB) (HTTP/HTTPS). apig: API Gateway (APIG). nlb: Network Load Balancer (NLB). ddos: Anti-DDoS. Nota Produtos diferentes são suportados em regiões diferentes. Se você especificar um valor para este parâmetro, certifique-se de que o produto seja suportado na região especificada. Caso contrário, a consulta poderá falhar.	ecs
CloudResourceId	string	Não	O ID do recurso conectado, que é gerado automaticamente pelo WAF no modo nativo da nuvem. Nota Você pode chamar CreateCloudResource para conectar um recurso e então visualizar o ID do recurso na resposta.	i-8vbdlsd********81e22-80-ecs
NextToken	string	Não	O token de paginação para a próxima página. Se um valor for retornado para este parâmetro, a próxima página existe. Nota Se este parâmetro tiver um valor de retorno, a próxima página existe. Você pode usar o valor NextToken retornado como parâmetro de solicitação para obter a próxima página de dados. Repita esse processo até que nenhum valor seja retornado, o que indica que todos os dados foram recuperados.	AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS
MaxResults	integer	Não	O número de entradas por página em uma consulta paginada. Valores válidos: 1 a 100. Valor padrão: 10.	10
RegionId	string	Não	A região onde a instância do WAF reside. Valores válidos: cn-hangzhou: China continental. ap-southeast-1: fora da China continental.	cn-hangzhou
ResourceDomain	string	Não	O nome de domínio conectado ao WAF. Nota Este parâmetro é suportado apenas quando o tipo de serviço em nuvem é ddos.	www.c**sw.net

ID da região	Região	Produtos suportados
cn-hangzhou	China (Hangzhou)	SAE,ALB,FC,MSE,ECS,CLB,NLB
cn-shanghai	China (Xangai)	SAE,ALB,FC,MSE,ECS,CLB,NLB
cn-shenzhen	China (Shenzhen)	SAE,ALB,FC,MSE,ECS,CLB,NLB
cn-beijing	China (Pequim)	SAE,ALB,FC,MSE,ECS,CLB,NLB
cn-zhangjiakou	China (Zhangjiakou)	SAE,ALB,FC,MSE,ECS,CLB,NLB
cn-chengdu	China (Chengdu)	ALB,ECS,CLB,NLB
cn-qingdao	China (Qingdao)	ALB,ECS,CLB,NLB
cn-guangzhou	China (Guangzhou)	ALB
cn-wulanchabu	China (Ulanqab)	ALB
cn-hongkong	Hong Kong (China)	ALB,MSE,ECS,CLB,NLB
cn-fuzhou	China (Fuzhou - Região Local - Descontinuada)	ALB
ap-southeast-6	Filipinas (Manila)	ALB
ap-southeast-5	Indonésia (Jacarta)	ALB,ECS,CLB,NLB
ap-northeast-1	Japão (Tóquio)	ALB
ap-southeast-3	Malásia (Kuala Lumpur)	ALB,MSE,ECS,CLB,NLB
ap-southeast-1	Singapura	ALB,MSE
eu-central-1	Alemanha (Frankfurt)	ALB
us-west-1	EUA (Vale do Silício)	ALB
us-east-1	EUA (Virgínia)	ALB

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	F35F45B0-5D6B-4238-BE02-A62D****E840
NextToken	string	O token de paginação para a próxima página. Se um valor for retornado para este parâmetro, a próxima página existe. Nota Se este parâmetro tiver um valor de retorno, a próxima página existe. Você pode usar o valor NextToken retornado como parâmetro de solicitação para obter a próxima página de dados. Repita esse processo até que nenhum valor seja retornado, o que indica que todos os dados foram recuperados.	AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS
TotalCount	integer	O número total de entradas retornadas.	118
MaxResults	integer	O número de entradas por página em uma consulta paginada.	20
CloudResourceList	array<object>	A lista de recursos conectados ao WAF no modo nativo da nuvem.
	object	O recurso conectado ao WAF no modo nativo da nuvem.
Protocol	string	O tipo de protocolo. Valores válidos: http: HTTP. https: HTTPS.	http
Port	integer	A porta do serviço em nuvem conectado ao WAF.	80
ResourceRegionId	string	O ID da região de propriedade do recurso. Para valores válidos, consulte a descrição suplementar dos parâmetros de resposta.	cn-hangzhou
ResourceInstanceId	string	O ID da instância do recurso conectado ao WAF.	i-8vbdlsd********81e22
ResourceProduct	string	O serviço em nuvem ao qual o recurso pertence. Valores válidos: alb: Application Load Balancer (ALB). mse: Microservices Engine (MSE). fc: Function Compute (FC). sae: Serverless App Engine (SAE). ecs: Elastic Compute Service (ECS). clb4: Classic Load Balancer (CLB) (TCP). clb7: Classic Load Balancer (CLB) (HTTP/HTTPS). nlb: Network Load Balancer (NLB).	ecs
CloudResourceId	string	O ID do recurso conectado, que é gerado automaticamente pelo WAF.	i-8vbdlsd********81e22-80-ecs
ResourceManagerResourceGroupId	string	O ID do grupo de recursos do Alibaba Cloud.	rg-aek2uo2****lbka
ResourceDomain	string	O nome de domínio conectado ao WAF.	www.c**sw.net

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "F35F45B0-5D6B-4238-BE02-A62D****E840",
  "NextToken": "AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS",
  "TotalCount": 118,
  "MaxResults": 20,
  "CloudResourceList": [
    {
      "Protocol": "http",
      "Port": 80,
      "ResourceRegionId": "cn-hangzhou",
      "ResourceInstanceId": "i-8vbdlsd********81e22",
      "ResourceProduct": "ecs",
      "CloudResourceId": "i-8vbdlsd********81e22-80-ecs",
      "ResourceManagerResourceGroupId": "rg-aek2uo2****lbka",
      "ResourceDomain": "www.c**sw.net"
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Waf.Instance.ValidFaild	WAF instance check failed. Check whether the instance ID is correct.	Falha ao verificar a instância do WAF. Verifique se o ID da instância está correto.
400	Waf.Pullin.CloudProductParamEmpty	The resource Id of the cloud product accessing WAF is null or null values exist in the three input parameters of the cloud product name, port, and cloud product instance.	O ID do recurso para conexão em modo cloud native ao WAF está vazio, ou um dos seguintes parâmetros está vazio: nome do serviço em nuvem, porta ou instância do serviço em nuvem.
400	Waf.Pullin.CloudResourceInvalid	CloudResourceId parameter is illegal.	O parâmetro CloudResourceId é inválido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.