Todos os produtos
Search
Central de documentação

Edge Security Acceleration:GetHttpIncomingResponseHeaderModificationRule

Última atualização: Jun 29, 2026

Consulta os detalhes de configuração de uma regra de modificação de cabeçalho de resposta HTTP de entrada para um site.

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

esa:GetHttpIncomingResponseHeaderModificationRule

get

*Site

acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

SiteId

integer

Sim

O ID do site, que pode ser obtido chamando a operação ListSites.

347168101647504

ConfigId

integer

Sim

O ID da configuração. Você pode chamar a operação ListHttpIncomingResponseHeaderModificationRules para consultar o ID.

430509230649344

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta.

RequestId

string

O ID da solicitação.

EDBD3EB3-97DA-5465-AEF5-8DCA5DC5E395

ConfigId

integer

O ID da configuração.

432637955352576

ConfigType

string

O tipo de configuração. Valores válidos:

  • global: configurações globais.

  • rule: configurações de regra.

rule

SiteVersion

integer

O número da versão das configurações. Você pode usar este parâmetro para especificar uma versão do seu site para aplicar as configurações do recurso. Por padrão, a versão 0 é usada.

0

Sequence

integer

A ordem em que a regra é executada. Um valor menor dá prioridade à regra.

1

RuleEnable

string

Especifica se a regra deve ser ativada. Valores válidos: Você não precisa definir este parâmetro ao adicionar a configuração global. Especifica se deve ser verificado se a imagem usada pela instância suporta migração a quente. Valores válidos:

  • on

  • off

on

Rule

string

O conteúdo da regra. Uma expressão condicional é usada para corresponder a uma solicitação do usuário. Você não precisa definir este parâmetro ao adicionar a configuração global. Casos de uso:

  • true: Corresponde a todas as solicitações de entrada.

  • Defina o valor como uma expressão personalizada, por exemplo, (http.host eq "video.example.com"): Corresponde à solicitação especificada.

(http.host eq "video.example.com")

RuleName

string

O nome da regra. Você não precisa definir este parâmetro ao adicionar a configuração global.

rule_example

ResponseHeaderModification

array<object>

As configurações de modificação de cabeçalhos de resposta. Você pode adicionar, excluir ou modificar um cabeçalho de resposta.

object

A configuração de modificação de um cabeçalho de resposta.

Name

string

O nome do cabeçalho de resposta.

headerName

Operation

string

A ação. Valores válidos:

  • add: adiciona um cabeçalho de resposta.

  • del: exclui um cabeçalho de resposta.

  • modify: modifica um cabeçalho de resposta.

add

Value

string

O valor do cabeçalho de resposta.

headerValue

Type

string

O tipo de valor. Valores válidos:

  • static

  • dynamic

static

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "EDBD3EB3-97DA-5465-AEF5-8DCA5DC5E395",
  "ConfigId": 432637955352576,
  "ConfigType": "rule",
  "SiteVersion": 0,
  "Sequence": 1,
  "RuleEnable": "on",
  "Rule": "(http.host eq \"video.example.com\")\n",
  "RuleName": "rule_example",
  "ResponseHeaderModification": [
    {
      "Name": "headerName",
      "Operation": "add",
      "Value": "headerValue",
      "Type": "static"
    }
  ]
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InternalException Failed to call the service. Try again later or contact technical support. Failed to call the service. Try again later or contact technical support.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.