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

Conecta um serviço de nuvem ao WAF no modo nativo da nuvem. Os serviços de nuvem suportados incluem ECS, CLB, NLB e Anti-DDoS.

Descrição da operação

Antes de invocar esta operação, conclua as seguintes etapas:

Confirme que você possui uma instância do WAF. Invoque DescribeInstance para consultar o ID da sua instância do WAF.
Confirme se o serviço de nuvem a ser conectado atende ao escopo aplicável. Para conexões ECS, CLB e NLB, verifique as especificações da instância e a região. Consulte a seção "Escopo aplicável" na documentação de conexão ECS, conexão CLB e conexão NLB. Para conexões Anti-DDoS, que são configuradas para nomes de domínio, consulte a seção "Escopo aplicável" na documentação de conexão Anti-DDoS. Após concluir as etapas anteriores, invoque esta operação para conectar o serviço de nuvem 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:CreateCloudResource

create

*DefenseResource.

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

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 Chame DescribeInstance para consultar o ID da sua instância do WAF.	waf_v3prepaid_public_cn-***
ResourceManagerResourceGroupId	string	Não	O ID do grupo de recursos do Alibaba Cloud.	rg-acfm***q
Listen	object	Sim	A configuração do listener.
TLSVersion	string	Não	A versão TLS a ser adicionada. Este parâmetro é usado apenas quando HttpsPorts não está vazio, o que indica que o nome de domínio usa HTTPS. Valores válidos: tlsv1: TLS 1.0 e posteriores. Maior compatibilidade, menor segurança. tlsv1.1: TLS 1.1 e posteriores. Boa compatibilidade, boa segurança. tlsv1.2: TLS 1.2 e posteriores. Boa compatibilidade, maior segurança. tlsv1.3: Apenas TLS 1.3. Maior segurança, menor compatibilidade.	tlsv1
EnableTLSv3	boolean	Não	Especifica se o TLS 1.3 é suportado. Valores válidos: true: O TLS 1.3 é suportado. false: O TLS 1.3 não é suportado. Nota Este parâmetro é usado apenas quando HttpsPorts não está vazio, o que indica que o nome de domínio usa HTTPS. Quando TLSVersion está definido como tlsv1.3, este valor deve ser true.	true
CipherSuite	integer	Não	O tipo de conjunto de cifras a ser adicionado. Este parâmetro é usado apenas quando HttpsPorts não está vazio, o que indica que o nome de domínio usa HTTPS. Valores válidos: 1: todos os conjuntos de cifras. 2: conjuntos de cifras fortes. Este valor está disponível apenas quando TLSVersion está definido como tlsv1.2. 99: conjuntos de cifras personalizados. Este valor está disponível apenas quando TLSVersion não está definido como tlsv1.3.	1
CustomCiphers	array	Não	Os conjuntos de cifras personalizados específicos a serem adicionados. Este parâmetro é usado apenas quando CipherSuite está definido como 99.
	string	Não	Os conjuntos de cifras personalizados específicos a serem adicionados. Este parâmetro é usado apenas quando CipherSuite está definido como 99.	ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384
ResourceProduct	string	Sim	O tipo de serviço de nuvem. Valores válidos: clb7 : CLB Camada 7. ecs : ECS. clb4 : CLB Camada 4. nlb : NLB. ddos : Anti-DDoS.	clb4
Port	integer	Não	A porta do serviço de nuvem conectado ao WAF.	80
ResourceInstanceId	string	Não	O ID da instância do serviço de nuvem. Nota A instância deve atender ao escopo aplicável do serviço de nuvem correspondente (especificações da instância, região, etc.). Consulte a documentação de conexão do produto correspondente listada na descrição da operação. Este parâmetro é obrigatório quando ResourceProduct está definido como ecs, clb4, clb7 ou nlb.	lb-bp1*****
Protocol	string	Não	O tipo de protocolo. Valores válidos: http : HTTP. https : HTTPS.	http
Certificates	array<object>	Não	A lista de IDs de certificados.
	object	Não	As informações do certificado.
CertificateId	string	Não	O ID do certificado a ser adicionado. Nota Chame DescribeResourceInstanceCerts para consultar os IDs de todos os certificados SSL associados à instância do serviço de nuvem.	123-cn-hangzhou
AppliedType	string	Não	O tipo de certificado para o protocolo HTTPS. Valores válidos: default: certificado padrão. extension: certificado de extensão.	default
Http2Enabled	boolean	Não	Especifica se o HTTP/2 deve ser ativado. Este parâmetro é usado apenas quando HttpsPorts não está vazio, o que indica que o nome de domínio usa HTTPS. Valores válidos: true: O HTTP/2 está ativado. false (padrão): O HTTP/2 não está ativado.	true
ResourceRegionId	string	Não	O ID da região do serviço de nuvem. Nota Este parâmetro é obrigatório quando o ID da instância a ser conectada ainda não foi sincronizado com o WAF. Chame SyncProductInstance para sincronizar ativos ECS, CLB e NLB, e chame DescribeProductInstances para consultar os ativos de serviço de nuvem sincronizados e seus IDs de região.	cn-hangzhou
Domain	string	Não	O nome de domínio a ser conectado ao WAF. Nota Este parâmetro é obrigatório apenas quando o tipo de serviço de nuvem é ddos. Para outros tipos de serviço, deixe este campo vazio. Consulte a documentação de conexão Anti-DDoS listada na descrição da operação para verificar o escopo aplicável de nomes de domínio.	www.c**sw.net
Redirect	object	Não	A configuração de encaminhamento.
RequestHeaders	array<object>	Não	O valor deste parâmetro está no formato [*{"k":"key","v":"value"}], onde key* especifica o campo de cabeçalho de solicitação personalizado e *value* especifica o valor definido para o campo. Nota Se o campo de cabeçalho personalizado já existir na solicitação, o sistema substituirá o valor do campo personalizado na solicitação pelo valor de marcação de tráfego especificado.
	object	Não	O valor deste parâmetro está no formato [*{"k":"key","v":"value"}], onde key* especifica o campo de cabeçalho de solicitação personalizado e *value* especifica o valor definido para o campo.
Key	string	Não	O campo de cabeçalho de solicitação personalizado.	key1
Value	string	Não	O valor definido para o campo de cabeçalho de solicitação personalizado.	value1
XffHeaderMode	integer	Não	O método que o WAF usa para obter o endereço IP de origem do cliente. Valores válidos: 0: Nenhum proxy de Camada 7 está implantado na frente do WAF. 1: O WAF lê o primeiro valor no cabeçalho X-Forwarded-For (XFF) como o endereço IP do cliente. 2: O WAF lê o valor de um campo de cabeçalho personalizado especificado por você como o endereço IP do cliente. 3: O WAF lê o IP do cliente do cabeçalho Proxy Protocol como o endereço IP do cliente.	1
XffHeaders	array	Não	A lista de campos de cabeçalho personalizados usados para obter o endereço IP do cliente, no formato ["header1","header2",……]. Nota Este parâmetro é obrigatório apenas quando XffHeaderMode está definido como 2, o que indica que o WAF lê o valor de um campo de cabeçalho personalizado especificado por você como o endereço IP do cliente.
	string	Não	A lista de campos de cabeçalho personalizados usados para obter o endereço IP do cliente, no formato ["header1","header2",……]. Nota Este parâmetro é obrigatório apenas quando XffHeaderMode está definido como 2, o que indica que o WAF lê o valor de um campo de cabeçalho personalizado especificado por você como o endereço IP do cliente.	header1
ReadTimeout	integer	Não	O período de tempo limite de leitura. Unidade: segundos. Valores válidos: 1 a 3600.	1
WriteTimeout	integer	Não	O período de tempo limite de gravação. Unidade: segundos. Valores válidos: 1 a 3600.	1
Keepalive	boolean	Não	Especifica se as conexões persistentes devem ser ativadas. Valores válidos: true (padrão): As conexões persistentes estão ativadas. false: As conexões persistentes não estão ativadas.	true
KeepaliveRequests	integer	Não	O número de solicitações que podem reutilizar uma conexão persistente. Valores válidos: 60 a 1000. Nota Após a ativação das conexões persistentes, este parâmetro especifica quantas solicitações podem reutilizar uma conexão persistente.	1000
KeepaliveTimeout	integer	Não	O período de tempo limite de ociosidade para conexões persistentes. Valores válidos: 10 a 3600. Valor padrão: 3600. Unidade: segundos. Nota Especifica por quanto tempo uma conexão persistente ociosa permanece aberta antes de ser liberada.	3600
XffProto	boolean	Não	Especifica se o X-Forward-For-Proto deve ser usado para passar o protocolo utilizado pelo WAF. Valores válidos: true (padrão): O protocolo utilizado pelo WAF é passado. false: O protocolo utilizado pelo WAF não é passado.	true
MaxBodySize	integer	Não	O tamanho máximo do corpo da solicitação. Valores válidos: 2 a 10. Valor padrão: 2. Unidade: GB. Nota Apenas a Edição Ultimate suporta este parâmetro.	2
Tag	array<object>	Não	A lista de tags. Um máximo de 20 tags pode ser especificado.
	object	Não
Key	string	Não	A chave da tag.	TagKey1
Value	string	Não	O valor da tag.	TagValue1
RegionId	string	Sim	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
OwnerUserId	string	Não	O UID da propriedade atual do recurso.	123

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	66A98669-ER12-WE34-23PO-301469*****E
CloudResourceId	string	O ID do recurso conectado, gerado automaticamente pelo WAF.	lb-***

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "66A98669-ER12-WE34-23PO-301469*****E",
  "CloudResourceId": "lb-***"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Waf.Pullin.CertNotExist	Certificate does not exist in SSL Certificate Center, certificate type:%s, certificate ID:%s.	O certificado não existe no SSL Certificates Service. Tipo de certificado: %s, ID do certificado: %s.
400	Waf.Pullin.CertExpired	Certificate expired, certificate ID:%s .	O certificado expirou. ID do certificado: %s.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.