Todos os produtos
Search
Central de documentação

:UpdateContainerConfiguration

Última atualização: Jul 08, 2026

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

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Cabeçalhos da requisição

Esta operação utiliza apenas o cabeçalho de requisição comum. Para mais informações, consulte Parâmetros comuns de requisição.

Sintaxe da requisição

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

Parâmetros da requisição

ParâmetroTipoPosiçãoObrigatórioExemploDescrição
AppIdStringQuerySimc627c157-560d-43ff-************

ID da aplicação.

GroupIdStringQueryNão8123db90-880f-**************

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

  • Se especificado, a operação configura o contêiner Tomcat do grupo de instâncias indicado.
  • Se defina como "", a configuração do contêiner Tomcat aplica-se à aplicação.
ContextPathStringQueryNão/

Caminho de contexto do contêiner Tomcat. Aceita string vazia, nome de pacote WAR nulo, diretório raiz ou outras strings personalizadas não vazias.

Permite letras, dígitos, hifens (-) e sublinhados (_).

  • Se omitido na configuração do grupo de instâncias, prevalece a configuração da aplicação.
  • Se ausente na configuração da aplicação, assume-se o diretório raiz /.
HttpPortIntegerQueryNão8080

Número da porta da aplicação no contêiner Tomcat.

  • Se omitido na configuração do grupo de instâncias, prevalece a configuração da aplicação.
  • Se ausente na configuração da aplicação, usa-se a porta 8080 por padrão.
MaxThreadsIntegerQueryNão20

Número máximo de threads no contêiner Tomcat.

  • Se omitido na configuração do grupo de instâncias, herda-se a configuração da aplicação.
  • Se ausente na configuração da aplicação, assume-se o valor padrão 250.
URIEncodingStringQueryNãoISO-8859-1

Esquema de codificação do URI (Identificador Uniforme de Recursos). Valores válidos: ISO-8859-1, GBK, GB2312 e UTF-8.

  • Se omitido na configuração do grupo de instâncias, prevalece a configuração da aplicação.
  • Se ausente na configuração da aplicação, utiliza-se o esquema de codificação URI padrão do contêiner Tomcat.
UseBodyEncodingBooleanQueryNãotrue

Indica se useBodyEncodingForURI está ativado.

  • Se omitido na configuração do grupo de instâncias, prevalece a configuração da aplicação.
  • Se ausente na configuração da aplicação, assume-se o valor padrão false.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

Code

Integer

200

Código de status HTTP.

ContainerConfiguration

Struct

Parâmetros retornados do contêiner Tomcat.

ContextPath

String

/

Caminho de contexto do contêiner Tomcat.

HttpPort

Integer

8080

Número da porta da aplicação no contêiner Tomcat.

MaxThreads

Integer

20

Número máximo de threads no contêiner Tomcat.

URIEncoding

String

ISO-8859-1

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

UseBodyEncoding

Boolean

true

Indica se useBodyEncodingForURI está ativado.

Message

String

success

Mensagem que indica se a requisição foi bem-sucedida.

RequestId

String

D16979DC-4D42-*

ID da requisição.

Exemplos

Exemplos de requisições

POST /pop/v5/app/container_config HTTP/1.1
Common request header
{
  "AppId": ""
}

Exemplos de respostas de sucesso

Formato XML

<Message>success</Message>
<ContainerConfiguration>
    <UseBodyEncoding>true</UseBodyEncoding>
    <MaxThreads>20</MaxThreads>
    <HttpPort>8080</HttpPort>
    <URIEncoding>ISO-8859-1</URIEncoding>
</ContainerConfiguration>
<Code>200</Code>

Formato JSON

{
    "Message": "success",
    "ContainerConfiguration": {
        "UseBodyEncoding": true,
        "MaxThreads": 20,
        "HttpPort": 8080,
        "URIEncoding": "ISO-8859-1"
    },
    "Code": 200
}

Códigos de erro

Acesse a Central de Erros para ver mais códigos de erro.

Para obter uma lista de códigos de erro, visite a Central de Erros de API.