Como definir parâmetros de escalonamento automático com a API Explorer
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Se você usar a CLI gcloud para implantar o aplicativo, como
gcloud app deploy,
ou plug-ins relacionados à CLI gcloud, para
Maven,
Gradle,
IntelliJ, ou
Eclipse,
defina os seguintes parâmetros de escalonamento automático no
arquivo de configuração
app.yaml:
min_instancesmax_instancestarget_throughput_utilizationtarget_cpu_utilization
Use também a interface do usuário do API Explorer para definir um parâmetro de escalonamento automático:
Abra a página API Explorer.
No painel à direita, abaixo do rótulo Teste esta API, localize a caixa de texto nome e insira a string de nome do aplicativo no formato a seguir:
apps/<YOUR-PROJECT-ID>/services/default/versions/<YOUR-VERSION-ID>
Substitua YOUR-PROJECT-ID pelo ID do projeto do aplicativo e <YOUR-VERSION-ID> pela versão do aplicativo ao qual você está enviando a solicitação. Use o restante da string da maneira mostrada.
Na caixa de texto updateMask, insira o nome completo do caminho do objeto .json do parâmetro que você está configurando, usando nomes updateMask da tabela abaixo:
| Nome updateMask |
automatic_scaling.standard_scheduler_settings.max_instances |
automatic_scaling.standard_scheduler_settings.min_instances |
automatic_scaling.standard_scheduler_settings.target_cpu_utilization |
automatic_scaling.standard_scheduler_settings.target_throughput_utilization |
Se você estiver configurando mais de um parâmetro em uma solicitação, insira o nome da máscara para cada parâmetro, separado por uma vírgula. Por exemplo, se você estiver definindo as instâncias mínima e máxima e a utilização da CPU, use a updateMask a seguir:
automatic_scaling.standard_scheduler_settings.max_instances,
automatic_scaling.standard_scheduler_settings.min_instances,
automatic_scaling.standard_scheduler_settings.target_cpu_utilization
Na caixa Corpo da solicitação, clique em Adicionar parâmetros do corpo da solicitação.
Selecione automaticScaling.
Clique no balão de dica (o ícone +) e, em seguida, selecione standardSchedulerSettings.
Clique no balão de dica, selecione o parâmetro do programador de escalonamento automático que você quer e insira o valor pretendido.
Para fornecer outro parâmetro do programador de escalonamento automático, clique no balão de dica novamente, selecione o parâmetro e informe o respectivo valor.
No exemplo a seguir, apresentamos uma amostra de corpo de solicitação preenchido:
{
"automaticScaling": {
"standardSchedulerSettings": {
"maxInstances": 100,
"minInstances": 1,
"targetCpuUtilization": 0.75
}
}
}
Clique em Executar. Talvez você tenha que autorizar a API Explorer na primeira vez que executar esse comando. Se necessário, siga as instruções para autorizar a API Explorer.
Confirme se as configurações corretas foram aplicadas abrindo a página de versões do App Engine para seu projeto e clicando em Visualizar na coluna Config. Você verá os valores que acabou de definir.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-04 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eYou can configure autoscaling parameters (\u003ccode\u003emin_instances\u003c/code\u003e, \u003ccode\u003emax_instances\u003c/code\u003e, \u003ccode\u003etarget_throughput_utilization\u003c/code\u003e, \u003ccode\u003etarget_cpu_utilization\u003c/code\u003e) for your application using the gcloud CLI or related plugins within your \u003ccode\u003eapp.yaml\u003c/code\u003e file.\u003c/p\u003e\n"],["\u003cp\u003eThe API Explorer can also be used to set autoscaling parameters, requiring you to enter your application's project ID, version, and the desired parameter's \u003ccode\u003eupdateMask\u003c/code\u003e name.\u003c/p\u003e\n"],["\u003cp\u003eTo set multiple autoscaling parameters via the API Explorer, you must list each parameter's full \u003ccode\u003e.json\u003c/code\u003e path name in the \u003ccode\u003eupdateMask\u003c/code\u003e field, separating them by commas.\u003c/p\u003e\n"],["\u003cp\u003eAfter executing the changes in the API Explorer, you can confirm that the correct settings have been applied by checking the configuration of your app's version in the App Engine versions page.\u003c/p\u003e\n"]]],[],null,["# Setting Autoscaling Parameters with the API Explorer\n\nIf you use the gcloud CLI tooling to deploy your app, such as\n`gcloud app deploy`,\nor gcloud CLI-related plugins for\n[Maven](/appengine/docs/legacy/standard/java/using-maven),\n[Gradle](/appengine/docs/legacy/standard/java/using-gradle),\n[IntelliJ](/tools/intellij/docs), or\n[Eclipse](/eclipse/docs),\nyou can set the following autoscaling parameters in the\n`app.yaml` configuration file:\n\n- `min_instances`\n- `max_instances`\n- `target_throughput_utilization`\n- `target_cpu_utilization`\n\nYou can also use the API explorer user interface to set an [autoscaling parameter](/appengine/docs/legacy/standard/java/config/appref#scaling_elements):\n\n1. Open the [API explorer\n page](/appengine/docs/admin-api/reference/rest/v1/apps.services.versions/patch).\n\n2. In the right panel under the label *Try This API* , locate the **name**\n text box and enter the application name string in the following format:\n\n apps/\u003cYOUR-PROJECT-ID\u003e/services/default/versions/\u003cYOUR-VERSION-ID\u003e\n\n Replace `YOUR-PROJECT-ID` with your application's project ID, and\n `\u003cYOUR-VERSION-ID\u003e` with the version of the app you are sending the request\n to. Use the rest of the string as shown.\n3. In the **updateMask** text box, enter the full `.json` object path name of the\n parameter you are setting, using `updateMask` names from the table below:\n\n If you are setting more than one parameter in one request, supply the mask\n name for each parameter, separated by a comma. For example, if you are\n setting the min and max instances, and the CPU utilization, use the\n following updateMask: \n\n automatic_scaling.standard_scheduler_settings.max_instances,\n automatic_scaling.standard_scheduler_settings.min_instances,\n automatic_scaling.standard_scheduler_settings.target_cpu_utilization\n\n4. In the **Request body** box, click **Add request body parameters** .\n\n5. Select **automaticScaling**.\n\n6. Click the hint bubble (the `+` icon), then select **standardSchedulerSettings**.\n\n7. Click the hint bubble, then select the desired auto scaling scheduler\n parameter and supply the desired value.\n\n8. To supply another auto scaling scheduler parameter, click the hint bubble\n again, select the parameter, and supply its value.\n\n The following example shows a sample filled out request body: \n\n {\n \"automaticScaling\": {\n \"standardSchedulerSettings\": {\n \"maxInstances\": 100,\n \"minInstances\": 1,\n \"targetCpuUtilization\": 0.75\n }\n }\n }\n\n9. Click **Execute**. You may be prompted to authorize API Explorer the first\n time you run this. If you are prompted, authorize API Explorer by following the\n prompts.\n\n10. Confirm that the correct settings have been applied by opening the\n [App Engine\n versions page](https://console.cloud.google.com/appengine/versions) for your project, and clicking **View** in the\n *Config* column. You should see the values you just set."]]
