Configura parámetros de ajuste de escala automático con el Explorador de API
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Si usas las herramientas de la CLI de gcloud a fin de implementar tu app, como gcloud app deploy
o los complementos relacionados con la CLI de gcloud para Maven, Gradle, IntelliJ o Eclipse, puedes configurar los siguientes parámetros de ajuste de escala automático en el archivo de configuración de app.yaml
:
min_instances
max_instances
target_throughput_utilization
target_cpu_utilization
También puedes usar la interfaz de usuario del Explorador de API a fin de configurar un parámetro de ajuste de escala automático:
Abre la página del Explorador de API.
En el panel derecho, debajo de la etiqueta Prueba esta API, ubica el cuadro de texto nombre y, luego, ingresa la string del nombre de la aplicación con el formato siguiente:
apps/<YOUR-PROJECT-ID>/services/default/versions/<YOUR-VERSION-ID>
Reemplaza YOUR-PROJECT-ID
por el ID del proyecto de tu aplicación, y <YOUR-VERSION-ID>
por la versión de la app a la que envías la solicitud. Utiliza el resto de la string como se muestra.
En el cuadro de texto updateMask, ingresa el nombre completo de la ruta de acceso del objeto .json
del parámetro que configurarás, mediante los nombres updateMask
de la tabla siguiente:
nombre 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 |
Si configuras más de un parámetro en una solicitud, ingresa el nombre de la máscara para cada parámetro, separado por una coma. Por ejemplo, si configuras las instancias máximas y mínimas y el uso de CPU, utiliza el siguiente updateMask:
automatic_scaling.standard_scheduler_settings.max_instances,
automatic_scaling.standard_scheduler_settings.min_instances,
automatic_scaling.standard_scheduler_settings.target_cpu_utilization
En el cuadro del Cuerpo de la solicitud, haz clic en Agregar los parámetros del cuerpo de la solicitud.
Selecciona automaticScaling.
Haz clic en el cuadro de sugerencias (el ícono +
) y selecciona standardSchedulerSettings.
Haz clic en el cuadro de sugerencias y, a continuación, selecciona el parámetro del programador de ajuste de escala automático y suministra el valor deseado.
Para suministrar otro parámetro de programador de escalamiento automático, haz clic otra vez en el cuadro de sugerencias, selecciona el parámetro y suministra su valor.
El siguiente ejemplo muestra el cuerpo de una solicitud llena de muestra:
{
"automaticScaling": {
"standardSchedulerSettings": {
"maxInstances": 100,
"minInstances": 1,
"targetCpuUtilization": 0.75
}
}
}
Haz clic en Ejecutar. Es posible que se te pida autorizar el explorador de API la primera vez que lo ejecutas. En ese caso, autoriza al explorador de API siguiendo las instrucciones.
Abre la página Versiones de App Engine de tu proyecto y haz clic en Ver en la columna Configuración para confirmar que se aplicó la configuración correcta. Deberías ver los valores que acabas de configurar.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-09-04 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]