Todos os produtos
Search
Central de documentação

Enterprise Distributed Application Service:UpdateContainerConfiguration

Última atualização: Jun 28, 2026

Configura o contêiner Tomcat para uma aplicação ou grupo de instâncias de aplicação em um cluster Elastic Compute Service (ECS).

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.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

edas:ManageApplication

update

*Application

acs:edas:{#regionId}:{#accountId}:namespace/{#NameSpaceId}/application/{#AppId}

Nenhuma Nenhuma

Sintaxe da solicitação

POST /pop/v5/app/container_config HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

AppId

string

Sim

O ID da aplicação.

c627c157-560d-43ff-************

GroupId

string

Não

O ID do grupo de instâncias da aplicação.

  • Se um ID for especificado, esta operação configura o contêiner Tomcat para o grupo de instâncias da aplicação especificado.

  • Se você definir este parâmetro como "", esta operação configura o contêiner Tomcat para a aplicação.

8123db90-880f-**************

ContextPath

string

Não

O caminho de contexto do contêiner Tomcat. O caminho de contexto pode ser uma string vazia, um nome de pacote WAR nulo, um diretório raiz ou outras strings personalizadas não vazias. Pode conter letras, dígitos, hifens (-) e underscores (_). Observe os seguintes itens:

  • Se este parâmetro não for especificado ao configurar o grupo de instâncias da aplicação, a configuração da aplicação será aplicada.

  • Se este parâmetro não for especificado ao configurar o contêiner Tomcat para uma aplicação, o diretório raiz / será utilizado.

/

HttpPort

integer

Não

O número da porta da aplicação para o contêiner Tomcat. Observe os seguintes itens:

  • Se este parâmetro não for especificado ao configurar o grupo de instâncias da aplicação, a configuração da aplicação será aplicada.

  • Se este parâmetro não for especificado ao configurar a aplicação, a porta padrão 8080 será aplicada.

8080

MaxThreads

integer

Não

O número máximo de threads. Observe os seguintes itens:

  • Se este parâmetro não for especificado ao configurar o grupo de instâncias da aplicação, a configuração da aplicação será aplicada.

  • Se este parâmetro não for especificado ao configurar a aplicação, o valor padrão 250 será aplicado.

20

URIEncoding

string

Não

O esquema de codificação de URI (uniform resource identifier). Valores válidos: ISO-8859-1, GBK, GB2312 e UTF-8. Observe os seguintes itens:

  • Se este parâmetro não for especificado ao configurar o grupo de instâncias da aplicação, a configuração da aplicação será aplicada.

  • Se este parâmetro não for especificado ao configurar a aplicação, o esquema de codificação de URI padrão do contêiner Tomcat será aplicado.

ISO-8859-1

UseBodyEncoding

boolean

Não

Especifica se o esquema de codificação especificado no corpo da solicitação deve ser utilizado para parâmetros de consulta de URI. Observe os seguintes itens:

  • Se este parâmetro não for especificado ao configurar o grupo de instâncias da aplicação, a configuração da aplicação será aplicada.

  • Se este parâmetro não for especificado ao configurar a aplicação, o valor padrão false será aplicado.

true

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O conteúdo retornado.

Code

integer

O código de status HTTP retornado.

200

Message

string

As informações adicionais retornadas.

success

RequestId

string

O ID da solicitação.

D16979DC-4D42-***************

ContainerConfiguration

object

A configuração do contêiner Tomcat.

HttpPort

integer

O número da porta da aplicação para o contêiner Tomcat.

8080

ContextPath

string

O caminho de contexto do contêiner Tomcat.

/

UseBodyEncoding

boolean

Indica se useBodyEncodingForURI está ativado.

true

MaxThreads

integer

O número máximo de threads.

20

URIEncoding

string

O esquema de codificação de URI. Valores válidos: ISO-8859-1, GBK, GB2312 e UTF-8.

ISO-8859-1

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": 200,
  "Message": "success",
  "RequestId": "D16979DC-4D42-***************",
  "ContainerConfiguration": {
    "HttpPort": 8080,
    "ContextPath": "/",
    "UseBodyEncoding": true,
    "MaxThreads": 20,
    "URIEncoding": "ISO-8859-1"
  }
}

Códigos de erro

Consulte Códigos de ErroCódigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de VersãoNotas de Versão para uma lista completa.