Todos os produtos
Search
Central de documentação

Edge Security Acceleration:UpdatePage

Última atualização: Jul 07, 2026

Atualiza uma página de resposta personalizada criada pelo usuário. Você pode usar esta operação para modificar o nome da página, a descrição, o tipo de conteúdo e o conteúdo.

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

update

*全部资源

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

Id

integer

Sim

O ID da página de resposta personalizada. Você pode obter esse valor chamando a operação ListPages.

50000001

Name

string

Sim

O nome da página de resposta personalizada após a atualização.

Sugestão de nomenclatura: Use uma combinação de letras, dígitos e sublinhados (como blocked_page_v2) para facilitar a referência nas regras. O conjunto de caracteres, o comprimento máximo e as restrições de unicidade estão sujeitos às convenções de nomenclatura do lado do servidor para páginas personalizadas. Se este parâmetro não for especificado, o nome original será mantido.

example

Description

string

Sim

A descrição da página após a atualização. Isso é usado para identificar a finalidade da página na lista do console. Este é um campo opcional. Se este parâmetro não for especificado, a descrição original será mantida. O comprimento máximo do campo está sujeito ao limite do lado do servidor.

a custom deny page

ContentType

string

Sim

O tipo MIME do conteúdo da página, que é retornado ao cliente como o cabeçalho de resposta HTTP Content-Type quando uma regra é correspondida.

Valores comuns:

  • text/html: Página HTML

  • application/json: Resposta JSON

Nota

O conjunto completo de valores suportados está sujeito à especificação do lado do servidor. O formato real de Content deve corresponder a este campo. Uma incompatibilidade pode causar problemas de renderização no navegador.

text/html

Content

string

Sim

O conteúdo da página codificado em BASE64, que deve ser consistente com ContentType.

Método de codificação:

  1. Converta o conteúdo original da página para uma string de bytes UTF-8.

  2. Codifique a string de bytes usando a codificação BASE64 padrão.

Exemplo: <html>hello page</html>PGh0bWw+aGVsbG8gcGFnZTwvaHRtbD4=

Nota

O limite de tamanho máximo está sujeito à especificação de página personalizada do lado do servidor. Se este parâmetro não for especificado, o conteúdo original da página será mantido.

PGh0bWw+aGVsbG8gcGFnZTwvaHRtbD4=

SiteIds

array

Não

A lista de IDs de sites associados a esta página após a atualização. Este parâmetro usa semântica de substituição total.

  • Você pode obter os IDs dos sites chamando a operação ListSites.

  • Passar uma lista vazia desassocia todos os sites da página.

  • Incluir um ID de site que não pertence à sua conta retorna um erro InvalidParameter.

integer

Não

O ID do site associado.

1

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

RequestId

string

O ID da solicitação.

36af3fcc-43d0-441c-86b1-428951dc8225

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "36af3fcc-43d0-441c-86b1-428951dc8225"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter The specified parameter is invalid. Falha na validação do formato do parâmetro de entrada.
400 InternalException Failed to call the service. Try again later or contact technical support. A chamada do serviço falhou. Tente novamente mais tarde ou entre em contato com o suporte ao cliente para obter detalhes.
403 %s.NotSupport The specified resource type %s is not supported. O tipo de recurso especificado não é suportado. Para usar este tipo de recurso, entre em contato conosco.
403 %s.OverQuota The quantity of %s exceeds the quota. O número de recursos excede o limite de cota. Para solicitar uma cota maior, entre em contato conosco.
403 %s.WrongValueMatched The value of specified parameter %s can not pass the matching check. A validação do valor do parâmetro especificado falhou. Se você precisar usar este valor de parâmetro, entre em contato conosco.
403 Page.NotExist The specified custom error page does not exist or is not recognized by the system.Check whether the error page identifier is correct and matches an error page that has been created and registered in the system's error handling framework.If you want to create a new error page, make sure that the creation process is complete. A página de erro especificada não foi encontrada ou não está registrada. Verifique o identificador da página e confirme se ela foi configurada corretamente.
403 Page.SiteAlreadyBound The specified site has already been associated with another custom error page of the same type. Dissociate the site from the existing page and try again. O site especificado já está vinculado a outra página de resposta personalizada do mesmo tipo. Desvincule o site da página existente e tente novamente.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.