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

Cria um objeto protegido.

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

create

*DefenseResource.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
Resource	string	Não	O nome do objeto protegido. Nota Apenas objetos protegidos no modo de serviço de nuvem híbrida suportam nomes personalizados de objetos protegidos.	abctest.com
Product	string	Sim	O nome do produto de nuvem. Valores válidos: alb: Application Load Balancer (ALB). ecs: Elastic Compute Service (ECS). clb4: Acesso da camada 4 do Classic Load Balancer (CLB). clb7: Acesso da camada 7 do Classic Load Balancer (CLB). nlb: Network Load Balancer (NLB). waf: Web Application Firewall (WAF).	ecs
ResourceGroup	string	Não	O nome do grupo de proteção ao qual o objeto protegido é adicionado. Este parâmetro é opcional.	testGroup
ResourceOrigin	string	Sim	A origem do objeto protegido. Valores válidos: custom: definido pelo usuário.	custom
Pattern	string	Sim	O modo de proteção do objeto protegido. Valores válidos: domain: proteção baseada em nome de domínio. multi_service: proteção baseada em serviço de nuvem híbrida. Nota Atualmente, apenas as seguintes combinações são suportadas: quando Product está definido como alb, ecs, clb4, clb7 ou nlb, Pattern deve ser definido como domain. Quando Product está definido como waf, Pattern deve ser definido como multi_service.	domain
Detail	string	Sim	As informações específicas dos parâmetros do objeto protegido, que consistem em uma string convertida a partir de um objeto JSON construído com uma série de parâmetros. Nota Os parâmetros variam dependendo do produto de nuvem (Product) e do modo de proteção (Pattern) especificados. Para mais informações, consulte Descrição do parâmetro Detail para objetos protegidos. Importante Quando Product está definido como ecs, clb4, clb7 ou nlb, os nomes de domínio conectados a regiões na China continental devem ter concluído o registro ICP.	{\"domain\": \"zhhclb4test096-05111.test.com\"}
XffStatus	integer	Não	Especifica se o proxy XFF está ativado para o objeto protegido. Valores válidos: 0: Desativado (padrão). 1: Ativado.	0
CustomHeaders	array	Não	A lista de campos de cabeçalho especificados. Nota Quando XffStatus está definido como 1, o primeiro IP no campo de cabeçalho especificado é usado como o IP de origem do cliente para evitar falsificação de XFF. Quando vários cabeçalhos são especificados, o sistema tenta obter o IP de origem de cada cabeçalho em ordem. Se o primeiro cabeçalho não contiver um IP, o sistema tenta o segundo cabeçalho, e assim por diante. Se nenhum cabeçalho especificado contiver um IP, o primeiro IP no cabeçalho X-Forwarded-For será usado. Quando XffStatus está definido como 1, o IP é obtido do primeiro cabeçalho disponível.
	string	Não	O campo de cabeçalho especificado.	x-forwarded-for
Description	string	Não	A descrição do objeto protegido.	ResourceTest
InstanceId	string	Sim	O ID da instância WAF. Nota Você pode chamar DescribeInstance para consultar o ID da instância WAF atual.	waf_v3prepaid_public_cn-4xl*******
OwnerUserId	string	Não	O ID da conta à qual o objeto protegido pertence em cenários de múltiplas contas. Por padrão, o objeto protegido pertence à conta de administrador do WAF.	123221XXX
Tag	array<object>	Não	A lista de tags, que contém até 20 itens.
	object	Não	A lista de tags de recursos, que contém até 20 itens.
Key	string	Não	A chave da tag.	demoTagKey
Value	string	Não	O valor da tag.	TagValue1
ResourceManagerResourceGroupId	string	Não	O ID do grupo de recursos do Alibaba Cloud.	rg-acfm***q
RegionId	string	Não	A região onde a instância WAF reside. Valores válidos: cn-hangzhou: China continental. ap-southeast-1: fora da China continental.	cn-hangzhou

Descrição do parâmetro Detail para objetos protegidos.

Configuração de site ALB (Product definido como alb, Pattern definido como domain)

Adiciona um nome de domínio de uma instância ALB que já está conectada ao WAF como um objeto protegido.

Descrição dos parâmetros

Nome	Tipo	Obrigatório	Exemplo	Descrição
instanceId	String	Sim	alb-cj3w3********1x	O ID da instância ALB que já está conectada ao WAF.
domain	String	Sim	alb.test.com	O nome de domínio a ser protegido pelo WAF.

Exemplo

{
    "domain": "alb.test.com",
    "instanceId": "alb-cj3w3********1x"
}

Configuração de site ECS (Product definido como ecs, Pattern definido como domain)

Adiciona um nome de domínio de uma instância ECS que já está conectada ao WAF como um objeto protegido.

Descrição dos parâmetros

Nome	Tipo	Obrigatório	Exemplo	Descrição
domain	String	Sim	ecs.test.com	O nome de domínio a ser protegido pelo WAF. O nome de domínio deve ter concluído o registro ICP quando conectado a regiões na China continental.

Exemplo

{
    "domain": "ecs.test.com"
}

Configuração de site CLB (Product definido como clb4 ou clb7, Pattern definido como domain)

Adiciona um nome de domínio de uma instância CLB que já está conectada ao WAF como um objeto protegido.

Descrição dos parâmetros

Nome	Tipo	Obrigatório	Exemplo	Descrição
domain	String	Sim	clb.test.com	O nome de domínio a ser protegido pelo WAF. O nome de domínio deve ter concluído o registro ICP quando conectado a regiões na China continental.

Exemplo

{
    "domain": "clb.test.com"
}

Configuração de site NLB (Product definido como nlb, Pattern definido como domain)

Adiciona um nome de domínio de uma instância NLB que já está conectada ao WAF como um objeto protegido.

Descrição dos parâmetros

Nome	Tipo	Obrigatório	Exemplo	Descrição
domain	String	Sim	nlb.test.com	O nome de domínio a ser protegido pelo WAF. O nome de domínio deve ter concluído o registro ICP quando conectado a regiões na China continental.

Exemplo

{
    "domain": "nlb.test.com"
}

Acesso a serviço de nuvem híbrida WAF (Product definido como waf, Pattern definido como multi_service)

Cria um objeto protegido para um caminho de nome de domínio em um cluster de acesso a serviço de nuvem híbrida do WAF.

Descrição dos parâmetros

Nome	Tipo	Obrigatório	Exemplo	Descrição
domain	String	Sim	a.test.com	O nome de domínio ou endereço IP a ser protegido pelo WAF.
url	String	Sim	/abc	O caminho da URL.

Exemplo

{
    "domain": "a.test.com",
    "url": "/abc"
}

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	1738C613-D054-5191-888B-DC0CF4C3A4A0
Resource	string	O nome do objeto protegido criado.	cdX.XXX-call.cn-alb

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "1738C613-D054-5191-888B-DC0CF4C3A4A0",
  "Resource": "cdX.XXX-call.cn-alb"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	Waf.Pullin.ResourceExsit	Access resource already exists, resource:%s.	O recurso conectado já existe. Recurso existente: %s.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.