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

Modifica a configuração de um serviço em nuvem conectado ao WAF.

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

update

DefenseResource.

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

DefenseResource.

acs:yundun-waf:{#regionId}:{#accountId}:defenseresource/{#ResourceInstanceId}-{#Port}-{#Product}

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 DescribeInstance para consultar o ID da instância atual 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 de escuta.
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 o protocolo HTTPS. Valores válidos: tlsv1: Suporta TLS 1.0 e posterior. Oferece a maior compatibilidade e a menor segurança. tlsv1.1: Suporta TLS 1.1 e posterior. Oferece boa compatibilidade e boa segurança. tlsv1.2: Suporta TLS 1.2 e posterior. Oferece boa compatibilidade e a maior segurança. tlsv1.3: Suporta apenas TLS 1.3. Oferece a maior segurança e a menor compatibilidade.	tlsv1.2
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 o protocolo 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 o protocolo HTTPS. Valores válidos: 1: todos os conjuntos de cifras. 2: conjuntos de cifras fortes. Este valor só pode ser selecionado quando TLSVersion estiver definido como tlsv1.2. 99: conjuntos de cifras personalizados. Este valor só pode ser selecionado quando TLSVersion não estiver definido como tlsv1.3.	1
CustomCiphers	array	Não	Os conjuntos de cifras personalizados.
	string	Não	O conjunto de cifras personalizado específico a ser adicionado. Este parâmetro é usado apenas quando CipherSuite estiver definido como 99.	ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-GCM-SHA384
ResourceProduct `deprecated`	string	Não	O tipo de serviço em nuvem. Valores válidos: clb7 : CLB camada 7. ecs : ECS. clb4 : CLB camada 4. nlb : NLB.	clb7
ResourceInstanceId `deprecated`	string	Não	O ID da instância do recurso.	lb-***
Port `deprecated`	integer	Não	A porta do serviço em nuvem conectado ao WAF.	80
Protocol	string	Sim	O tipo de protocolo. Valores válidos: http : HTTP. https : HTTPS.	http
Certificates	array<object>	Não	As informações do certificado.
	object	Não	As informações do certificado.
CertificateId	string	Não	O ID do certificado.	123-cn-hangzhou
AppliedType	string	Não	O tipo de certificado para o protocolo HTTPS. Valores válidos: default: certificado padrão. extension: certificado estendido.	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 o protocolo HTTPS. Valores válidos: true: O HTTP/2 está ativado. false (padrão): O HTTP/2 não está ativado.	true
Redirect	object	Não	A configuração de encaminhamento.
RequestHeaders	array<object>	Não	Os campos e valores de marcação de tráfego do nome de domínio, usados para marcar o tráfego processado pelo WAF.
	object	Não	O valor deste parâmetro está no formato [*{"k":"key","v":"value"}]. 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.
Key	string	Não	O campo de cabeçalho de solicitação personalizado especificado.	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: O tráfego de acesso do cliente não é encaminhado por nenhum outro proxy de camada 7 antes de chegar ao 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.	0
XffHeaders	array	Não	A lista de campos personalizados usados para obter o endereço IP do cliente, no formato ["header1","header2",……]. Nota Este parâmetro é necessário apenas quando XffHeaderMode estiver 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 personalizados usados para obter o endereço IP do cliente, no formato ["header1","header2",……]. Nota Este parâmetro é necessário apenas quando XffHeaderMode estiver 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 pode permanecer aberta antes de ser liberada.	15
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.	2
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
CloudResourceId	string	Não	O ID do recurso conectado, gerado automaticamente pelo WAF durante a conexão no modo nativo da nuvem. Nota Você pode chamar CreateCloudResource para conectar um recurso e depois visualizar o ID do recurso na resposta.	lb-***-80-clb7

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	D7861F61-5B61-46CE-A47C-***
CloudResource	string	O ID do recurso conectado.	lb-xxx-80-clb7

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "D7861F61-5B61-46CE-A47C-***",
  "CloudResource": "lb-xxx-80-clb7"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Waf.Pullin.CertExpired	Certificate expired, certificate ID:%s .	O certificado expirou. ID do certificado: %s.
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.OnlyBeOneDefaultCert	There can be only one default certificate.	Apenas um certificado padrão é permitido.
400	Waf.Control.CloudProductInfoNotMartch	The value of the cloud product, port, instance, and input parameter to which the resource ID of the cloud product is connected to WAF does not match.	O serviço de nuvem, a porta e a instância associados ao ID do recurso para a conexão do modo nativo da nuvem ao WAF não correspondem aos valores de parâmetro especificados.
400	Waf.Control.CloudProductInfoEmpty	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 a conexão do modo nativo da nuvem ao WAF está vazio, ou um dos seguintes parâmetros está vazio: nome do serviço de nuvem, porta ou instância do serviço de nuvem.
400	Waf.Control.DefenseResourceEmpty	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.