Esta documentación es para la versión 1 de AWS CLI. Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.
En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar situaciones comunes usando AWS Command Line Interface con planes de escalado automático.
Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
Temas
Acciones
En el siguiente ejemplo de código, se muestra cómo utilizar create-scaling-plan.
- AWS CLI
-
Creación de un plan de escalado
En el siguiente ejemplo de
create-scaling-plan, se crea un plan de escalado denominadomy-scaling-planmediante un archivo JSON ya creado (denominado config.json). La estructura del plan de escalado incluye una instrucción de escalado para un grupo de escalado automático denominadomy-asg. Especifica la propiedadTagFilterscomo el origen de la aplicación y permite el escalado predictivo y el escalado dinámico.aws autoscaling-plans create-scaling-plan \ --scaling-plan-namemy-scaling-plan\ --cli-input-jsonfile://~/config.jsonContenido del archivo
config.json:{ "ApplicationSource": { "TagFilters": [ { "Key": "purpose", "Values": [ "my-application" ] } ] }, "ScalingInstructions": [ { "ServiceNamespace": "autoscaling", "ResourceId": "autoScalingGroup/my-asg", "ScalableDimension": "autoscaling:autoScalingGroup:DesiredCapacity", "ScheduledActionBufferTime": 300, "PredictiveScalingMaxCapacityBehavior": "SetForecastCapacityToMaxCapacity", "PredictiveScalingMode": "ForecastAndScale", "PredefinedLoadMetricSpecification": { "PredefinedLoadMetricType": "ASGTotalCPUUtilization" }, "ScalingPolicyUpdateBehavior": "ReplaceExternalPolicies", "MinCapacity": 1, "MaxCapacity": 4, "TargetTrackingConfigurations": [ { "PredefinedScalingMetricSpecification": { "PredefinedScalingMetricType": "ASGAverageCPUUtilization" }, "TargetValue": 50 } ] } ] }Salida:
{ "ScalingPlanVersion": 1 }Para obtener más información, consulte la Guía del usuario de AWS Auto Scaling de aplicaciones.
-
Para obtener información sobre la API, consulte CreateScalingPlan
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar delete-scaling-plan.
- AWS CLI
-
Eliminación de un plan de escalado
En el siguiente ejemplo de
delete-scaling-plan, se elimina el plan de escalado especificado.aws autoscaling-plans delete-scaling-plan \ --scaling-plan-namemy-scaling-plan\ --scaling-plan-version1Este comando no genera ninguna salida.
Para obtener más información, consulte la Guía del usuario de AWS Auto Scaling de aplicaciones.
-
Para obtener información sobre la API, consulte DeleteScalingPlan
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-scaling-plan-resources.
- AWS CLI
-
Descripción de los recursos escalables de un plan de escalado
En el siguiente de
describe-scaling-plan-resources, se muestran detalles sobre el único recurso escalable (un grupo de escalado automático) que está asociado al plan de escalado especificado.aws autoscaling-plans describe-scaling-plan-resources \ --scaling-plan-namemy-scaling-plan\ --scaling-plan-version1Salida:
{ "ScalingPlanResources": [ { "ScalableDimension": "autoscaling:autoScalingGroup:DesiredCapacity", "ScalingPlanVersion": 1, "ResourceId": "autoScalingGroup/my-asg", "ScalingStatusCode": "Active", "ScalingStatusMessage": "Target tracking scaling policies have been applied to the resource.", "ScalingPolicies": [ { "PolicyName": "AutoScaling-my-asg-b1ab65ae-4be3-4634-bd64-c7471662b251", "PolicyType": "TargetTrackingScaling", "TargetTrackingConfiguration": { "PredefinedScalingMetricSpecification": { "PredefinedScalingMetricType": "ALBRequestCountPerTarget", "ResourceLabel": "app/my-alb/f37c06a68c1748aa/targetgroup/my-target-group/6d4ea56ca2d6a18d" }, "TargetValue": 40.0 } } ], "ServiceNamespace": "autoscaling", "ScalingPlanName": "my-scaling-plan" } ] }Para obtener más información, consulte What Is AWS Auto Scaling? en la Guía del usuario de AWS Auto Scaling de aplicaciones.
-
Para obtener información sobre la API, consulte DescribeScalingPlanResources
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-scaling-plans.
- AWS CLI
-
Descripción de un plan de escalado
En el siguiente ejemplo de
describe-scaling-plans, se muestran los detalles del plan de escalado especificado.aws autoscaling-plans describe-scaling-plans \ --scaling-plan-namesscaling-plan-with-asg-and-ddbSalida:
{ "ScalingPlans": [ { "LastMutatingRequestTime": 1565388443.963, "ScalingPlanVersion": 1, "CreationTime": 1565388443.963, "ScalingInstructions": [ { "ScalingPolicyUpdateBehavior": "ReplaceExternalPolicies", "ScalableDimension": "autoscaling:autoScalingGroup:DesiredCapacity", "TargetTrackingConfigurations": [ { "PredefinedScalingMetricSpecification": { "PredefinedScalingMetricType": "ASGAverageCPUUtilization" }, "TargetValue": 50.0, "EstimatedInstanceWarmup": 300, "DisableScaleIn": false } ], "ResourceId": "autoScalingGroup/my-asg", "DisableDynamicScaling": false, "MinCapacity": 1, "ServiceNamespace": "autoscaling", "MaxCapacity": 10 }, { "ScalingPolicyUpdateBehavior": "ReplaceExternalPolicies", "ScalableDimension": "dynamodb:table:ReadCapacityUnits", "TargetTrackingConfigurations": [ { "PredefinedScalingMetricSpecification": { "PredefinedScalingMetricType": "DynamoDBReadCapacityUtilization" }, "TargetValue": 50.0, "ScaleInCooldown": 60, "DisableScaleIn": false, "ScaleOutCooldown": 60 } ], "ResourceId": "table/my-table", "DisableDynamicScaling": false, "MinCapacity": 5, "ServiceNamespace": "dynamodb", "MaxCapacity": 10000 }, { "ScalingPolicyUpdateBehavior": "ReplaceExternalPolicies", "ScalableDimension": "dynamodb:table:WriteCapacityUnits", "TargetTrackingConfigurations": [ { "PredefinedScalingMetricSpecification": { "PredefinedScalingMetricType": "DynamoDBWriteCapacityUtilization" }, "TargetValue": 50.0, "ScaleInCooldown": 60, "DisableScaleIn": false, "ScaleOutCooldown": 60 } ], "ResourceId": "table/my-table", "DisableDynamicScaling": false, "MinCapacity": 5, "ServiceNamespace": "dynamodb", "MaxCapacity": 10000 } ], "ApplicationSource": { "TagFilters": [ { "Values": [ "my-application-id" ], "Key": "application" } ] }, "StatusStartTime": 1565388455.836, "ScalingPlanName": "scaling-plan-with-asg-and-ddb", "StatusMessage": "Scaling plan has been created and applied to all resources.", "StatusCode": "Active" } ] }Para obtener más información, consulte What Is AWS Auto Scaling? en la Guía del usuario de AWS Auto Scaling de aplicaciones.
-
Para obtener información sobre la API, consulte DescribeScalingPlans
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar get-scaling-plan-resource-forecast-data.
- AWS CLI
-
Recuperación de los datos de previsión de carga
En este ejemplo, se recuperan los datos de previsión de carga de un recurso escalable (un grupo de escalado automático) que está asociado al plan de escalado especificado.
aws autoscaling-plans get-scaling-plan-resource-forecast-data \ --scaling-plan-namemy-scaling-plan\ --scaling-plan-version1\ --service-namespace"autoscaling"\ --resource-idautoScalingGroup/my-asg\ --scalable-dimension"autoscaling:autoScalingGroup:DesiredCapacity"\ --forecast-data-type"LoadForecast"\ --start-time"2019-08-30T00:00:00Z"\ --end-time"2019-09-06T00:00:00Z"Salida:
{ "Datapoints": [...] }Para obtener más información, consulte What Is AWS Auto Scaling? en la Guía del usuario de AWS Auto Scaling de aplicaciones.
-
Para obtener información sobre la API, consulte GetScalingPlanResourceForecastData
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-scaling-plan.
- AWS CLI
-
Actualización de un plan de escalado
En el siguiente ejemplo de
update-scaling-plan, se modifica la métrica de escalado de un grupo de escalado automático en el plan de escalado especificado.aws autoscaling-plans update-scaling-plan \ --scaling-plan-namemy-scaling-plan\ --scaling-plan-version1\ --scaling-instructions '{"ScalableDimension":"autoscaling:autoScalingGroup:DesiredCapacity","ResourceId":"autoScalingGroup/my-asg","ServiceNamespace":"autoscaling","TargetTrackingConfigurations":[{"PredefinedScalingMetricSpecification": {"PredefinedScalingMetricType":"ALBRequestCountPerTarget","ResourceLabel":"app/my-alb/f37c06a68c1748aa/targetgroup/my-target-group/6d4ea56ca2d6a18d"},"TargetValue":40.0}],"MinCapacity": 1,"MaxCapacity": 10}'Este comando no genera ninguna salida.
Para obtener más información, consulte What Is AWS Auto Scaling? en la Guía del usuario de AWS Auto Scaling de aplicaciones.
-
Para obtener información sobre la API, consulte UpdateScalingPlan
en la Referencia de comandos de la AWS CLI.
-
