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

Modifica um nome de domínio baseado em CNAME.

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

update

DefenseResource.

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

DefenseResource.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância WAF. Nota Você pode chamar DescribeInstance para consultar o ID da instância WAF atual.	waf_cdnsdf3****
Domain	string	Não	O nome de domínio a ser operado.	www.aliyundoc.com
DomainId	string	Não	O ID do nome de domínio.	www.aliyundoc.com-waf
Listen	object	Sim	A configuração de escuta.
HttpsPorts	array	Não	As portas de escuta para HTTPS. Use o formato [porta1,port2,...].
	integer	Não	A porta de escuta para HTTPS.	443
HttpPorts	array	Não	As portas de escuta para HTTP. Use o formato [porta1,port2,...].
	integer	Não	A porta de escuta para HTTP.	80
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
CertId	string	Não	O ID do certificado a ser adicionado.	123
SM2Enabled	boolean	Não	Especifica se o certificado China Encryption (China SM) deve ser ativado.	true
SM2CertId	string	Não	O ID do certificado China SM a ser adicionado. Este parâmetro é usado apenas quando SM2Enable está definido como true.	123-cn-hangzhou
SM2AccessOnly	boolean	Não	Especifica se deve ser permitido apenas o acesso do cliente. Este parâmetro é usado apenas quando SM2Enable está definido como true.	true
TLSVersion	string	Não	A versão TLS a ser adicionada. Este parâmetro é usado apenas quando HttpsPorts não está vazio (indicando que o nome de domínio usa o protocolo HTTPS). Valores válidos: tlsv1: Suporta TLS 1.0 e versões posteriores. Oferece a maior compatibilidade e a menor segurança. tlsv1.1: Suporta TLS 1.1 e versões posteriores. Oferece boa compatibilidade e boa segurança. tlsv1.2: Suporta TLS 1.2 e versões posteriores. 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
EnableTLSv3	boolean	Não	Especifica se o TLS 1.3 deve ser suportado. Valores válidos:	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:	2
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	O conjunto de cifras personalizado.	ECDHE-ECDSA-AES256-SHA384
FocusHttps	boolean	Não	Especifica se o redirecionamento forçado de HTTPS deve ser ativado. Este parâmetro só tem efeito quando HttpsPorts não está vazio (indicando que o nome de domínio usa o protocolo HTTPS) e HttpPorts está vazio (indicando que o nome de domínio não usa o protocolo HTTP). Valores válidos: true: Ativa o redirecionamento forçado de HTTPS. false: Não ativa o redirecionamento forçado de HTTPS.	true
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 : (Padrão) O tráfego do cliente não foi 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. 3 : O WAF lê o Client IP do cabeçalho Proxy Protocol como o endereço IP do cliente.	2
XffHeaders	array	Não	A lista de campos de cabeçalho personalizados usados para obter o endereço IP do cliente. Use o formato ["cabeçalho1","cabeçalho2",...].
	string	Não	Os campos de cabeçalho personalizados usados para obter o endereço IP do cliente.	Client-ip
IPv6Enabled	boolean	Não	Especifica se o IPv6 deve ser ativado. Valores válidos:	true
ProtectionResource	string	Não	O tipo de recurso de proteção a ser usado. Valores válidos:	share
ExclusiveIp	boolean	Não	Especifica se o recurso de endereço IP exclusivo deve ser ativado. Este parâmetro está disponível apenas quando IPv6Enabled está definido como false e ProtectionResource está definido como share. Valores válidos: true: Ativa o recurso de endereço IP exclusivo. false (padrão): Não ativa o recurso de endereço IP exclusivo.	true
HstsIncludeSubDomain	boolean	Não	Especifica se o HSTS inclui subdomínios. Valores válidos: true: Ativado. false: Não ativado.	false
HstsPreload	boolean	Não	Especifica se o pré-carregamento HSTS deve ser ativado. Este recurso está desativado por padrão. Valores válidos:	false
HstsMaxAge	integer	Não	O tempo de expiração do HSTS. Unidade: segundos.	365000
Redirect	object	Sim	A configuração de encaminhamento.
Backends	array	Não	Os endereços IP ou nomes de domínio dos servidores de origem correspondentes ao nome de domínio. Você pode definir apenas um tipo: endereços IP do servidor de origem ou nomes de domínio do servidor de origem. Quando o endereço back-to-origin é um nome de domínio, apenas IPv4 é suportado. IPv6 não é suportado.
	string	Não	O endereço IP ou nome de domínio do servidor de origem.	1.1.XX.XX
Loadbalance	string	Sim	O algoritmo de balanceamento de carga usado para solicitações de back-to-origin. Valores válidos: iphash: Algoritmo IP Hash. roundRobin: Algoritmo round-robin. leastTime: Algoritmo Least Time. Este valor está disponível apenas quando ProtectionResource está definido como gslb, o que indica que o tipo de recurso de proteção usa balanceamento de carga inteligente do cluster compartilhado.	iphash
FocusHttpBackend	boolean	Não	Especifica se o back-to-origin forçado via HTTP 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
SniEnabled	boolean	Não	Especifica se o SNI back-to-origin 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
SniHost	string	Não	O valor do campo de extensão SNI personalizado. Se você não definir esse parâmetro, o valor do campo Host no cabeçalho da solicitação será usado como o valor do campo de extensão SNI por padrão. Na maioria dos casos, você não precisa personalizar o SNI, a menos que sua empresa tenha requisitos de configuração especiais e você deseje que o WAF use um SNI diferente do Host real da solicitação nas solicitações back-to-origin (ou seja, o SNI personalizado definido aqui). Nota Esse parâmetro é obrigatório apenas quando SniEnalbed está definido como xxx (SNI back-to-origin personalizado).	www.aliyundoc.com
RequestHeaders	array<object>	Não	Os campos e valores de tags 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":"chave","v":"valor"}]. chave* especifica o campo de cabeçalho de solicitação personalizado e *valor* especifica o valor definido para o campo.
Key	string	Não	O campo de cabeçalho de solicitação personalizado.	aaa
Value	string	Não	O valor definido para o campo de cabeçalho de solicitação personalizado.	bbb
ConnectTimeout	integer	Não	O período de tempo limite de conexão. Unidade: segundos.	120
ReadTimeout	integer	Não	O período de tempo limite de leitura. Unidade: segundos.	200
WriteTimeout	integer	Não	O período de tempo limite de gravação. Unidade: segundos.	200
CnameEnabled	boolean	Não	Especifica se a recuperação de desastres em nuvem pública deve ser ativada. Valores válidos:	true
RoutingRules	string	Não	As regras de encaminhamento de nuvem híbrida. O valor é uma string que representa um array JSON. Cada elemento no array JSON é uma estrutura que contém os seguintes campos: rs: Tipo array \| A lista de endereços IP de back-to-origin ou CNAMEs de back-to-origin. backupRs: Tipo array \| A lista de endereços IP de back-to-origin de backup ou CNAMEs de back-to-origin de backup. Este campo é obrigatório. [] indica que nenhum backup está configurado. location: Tipo string \| O nome do nó de proteção. locationId: Tipo long \| O ID do nó de proteção.	[
Keepalive	boolean	Não	Especifica se as conexões persistentes devem ser ativadas. Valores válidos:	true
Retry	boolean	Não	Especifica se deve tentar novamente quando o WAF falhar ao encaminhar solicitações para o servidor de origem. Valores válidos: true (padrão): Tentar novamente. false: Não tentar novamente.	true
KeepaliveRequests	integer	Não	O número de solicitações que reutilizam uma conexão persistente. Valores válidos: 60 a 1000. Valor padrão: 1000.	1000
KeepaliveTimeout	integer	Não	O período de tempo limite de conexão persistente ociosa. Valores válidos: 1 a 60. Valor padrão: 15. Unidade: segundos.	15
XffProto	boolean	Não	Especifica se o X-Forward-For-Proto transmite o protocolo WAF. Valores válidos:	true
BackupBackends	array	Não	Os endereços IP ou nomes de domínio dos servidores de origem secundários correspondentes ao nome de domínio.
	string	Não	O endereço IP ou nome de domínio do servidor de origem secundário. Você pode definir apenas um tipo: endereços IP do servidor de origem ou nomes de domínio do servidor de origem. Quando o endereço back-to-origin é um nome de domínio, apenas IPv4 é suportado. IPv6 não é suportado.	2.2.XX.XX
XClientIp	boolean	Não	Especifica se o WAF tem permissão para sobrescrever o X-Client-IP. Valores válidos:	true
XTrueIp	boolean	Não	Especifica se o WAF tem permissão para sobrescrever X-True-IP. Valores válidos: true (padrão): O WAF tem permissão para sobrescrever. false: O WAF não tem permissão para sobrescrever.	true
WebServerType	boolean	Não	Especifica se o WAF tem permissão para sobrescrever o Web-Server-Type. Valores válidos:	true
WLProxyClientIp	boolean	Não	Especifica se o WAF tem permissão para sobrescrever o WL-Proxy-Client-IP. Valores válidos:	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
Http2Origin	boolean	Não	Especifica se o fetch de origem sobre HTTP/2 deve ser ativado. Valores válidos: true: Ativa o fetch de origem sobre HTTP/2. false: Não ativa o fetch de origem sobre HTTP/2.	true
Http2OriginMaxConcurrency	integer	Não	O número máximo de conexões simultâneas para back-to-origin HTTP/2. Valores válidos: 1 a 512. Valor padrão: 2.	128
ProxyProtocol	boolean	Não	Indica se o recurso de preservação do IP de origem do cliente está ativado. true: O recurso de preservação do IP de origem do cliente está ativado. Após a ativação desse recurso, os serviços de back-end podem visualizar o endereço IP de origem do cliente. false: O recurso de preservação do IP de origem do cliente não está ativado.	false
BackendPorts	array<object>	Não	A configuração de porta personalizada.
	object	Não	A configuração de porta personalizada.
ListenPort	integer	Não	A porta de escuta.	80
BackendPort	integer	Não	A porta back-to-origin.	80
Protocol	string	Não	O protocolo da porta do listener. Valores válidos: http: O protocolo da porta do listener é HTTP. https: O protocolo da porta do listener é HTTPS.	http
RegionId	string	Sim	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
AccessType	string	Não	O tipo de acesso da instância WAF. Valores válidos:	share

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	D7861F61-5B61-46CE-A47C-6B19160D****
DomainInfo	object	As informações sobre o nome de domínio adicionado.
Cname	string	O CNAME atribuído pelo WAF ao nome de domínio.	xxxxxcvdaf.****.com
Domain	string	O nome de domínio a ser modificado.	www.aliyundoc.com
DomainId	string	O ID do nome de domínio.	www.aliyundoc.com-waf

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "D7861F61-5B61-46CE-A47C-6B19160D****",
  "DomainInfo": {
    "Cname": "xxxxxcvdaf.****.com",
    "Domain": "www.aliyundoc.com",
    "DomainId": "www.aliyundoc.com-waf"
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Waf.Pullin.BusinessViolation	The web services are suspected of violating regulations. If you have any questions, please submit a work order. Violating resource: %s.	O serviço é suspeito de violações. Se você tiver dúvidas, envie um ticket. Recurso em violação: %s.
400	Waf.Control.DomainAndDomainIdBothEmpty	domain and domainId cannot be empty at the same time.	O nome de domínio e o ID do nome de domínio não podem estar ambos vazios.
400	Waf.Control.DomainAndDomainIdNotMatch	domain and domainId do not match.	O parâmetro Domain não corresponde ao parâmetro DomainId.
400	Waf.Control.DomainIdIsIllegal	The input parameter, the domainId is illegal.	O parâmetro DomainId é inválido.
400	Waf.Pullin.BackupBackendConflict	The backup backend configuration conflicts.	A configuração de back-to-origin do link secundário de back-to-origin está em conflito.
400	Waf.Pullin.BackendPortIncompatible	The back-to-source port is incompatible with the listening port, listening protocol:%s, listening port:%s, back-to-source port:%s.	A porta de back-to-origin é incompatível com a porta do listener. Protocolo do listener: %s, porta do listener: %s, porta de back-to-origin: %s.
400	Waf.Pullin.Http2OriginMustOnKeepaliveEnable	When the HTTP2 origin is turned on, the keepalive must be turned on.	O keep-alive deve ser ativado quando o back-to-origin HTTP/2 estiver ativado.
400	Waf.Pullin.Http2OriginEnabledFocusHttpBackendForbidden	When HTTP2 origin is enabled, HTTP origin cannot be enabled.	O back-to-origin HTTP não pode ser ativado quando o back-to-origin HTTP/2 está ativado.
400	Waf.Pullin.BatchDnsScheduleCheckFailed	Batch dns scheduling is in progress, and access related operations are prohibited.	O agendamento de DNS em lote está em andamento. Operações relacionadas à conexão são proibidas.
400	Waf.Pullin.InvalidMaxAgeWithPreload	HstsMaxAge the parameter is incorrect, when the HstsPreload is True, the HstsMaxAge must be greater than or equal to 31536000.	O parâmetro HstsMaxAge é inválido. Quando HstsPreload está definido como True, HstsMaxAge deve ser maior ou igual a 31536000.
400	Waf.Pullin.InvalidIncludeSubDomainWithPreload	The parameter HstsIncludeSubDomain is invalid. When the parameter HstsPreload is true, the HstsIncludeSubDomain must be true.	O parâmetro HstsIncludeSubDomain é inválido. Quando HstsPreload está definido como true, HstsIncludeSubDomain também deve ser definido como true.
400	Waf.Pullin.InvalidCustomCiphers	Invalid custom cipher suite.	O conjunto de cifras personalizado é inválido.
400	Waf.Pullin.InvalidHttp2OriginWithProxyProtocol	http2Origin and proxyProtocol cannot be opened at the same time.	http2Origin e proxyProtocol não podem ser ativados simultaneamente.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.