Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Utilizar `PutScalingPolicy` con una CLI Los siguientes ejemplos de código muestran cómo utilizar `PutScalingPolicy`. ------ #### [ CLI ] **AWS CLI** **Ejemplo 1: aplicar una política de escalado de seguimiento de destino con una especificación de métrica predefinida** En el siguiente ejemplo de `put-scaling-policy`, se aplica una política de escalado de seguimiento de destino con una especificación de métricas predefinida para un servicio de Amazon ECS denominado web-app en el clúster predeterminado. La política mantiene la utilización media de la CPU del servicio en un 75 %, con períodos de recuperación de escalado horizontal y reducción horizontal de 60 segundos. El resultado contiene los nombres ARNs y los nombres de las dos CloudWatch alarmas creadas en su nombre. ``` aws application-autoscaling put-scaling-policy --service-namespace {{ecs}} \ --scalable-dimension {{ecs:service:DesiredCount}} \ --resource-id {{service/default/web-app}} \ --policy-name {{cpu75-target-tracking-scaling-policy}} --policy-type {{TargetTrackingScaling}} \ --target-tracking-scaling-policy-configuration {{file://config.json}} ``` En este ejemplo se supone que tiene un archivo config.json en el directorio actual con el siguiente contenido: ``` { "TargetValue": 75.0, "PredefinedMetricSpecification": { "PredefinedMetricType": "ECSServiceAverageCPUUtilization" }, "ScaleOutCooldown": 60, "ScaleInCooldown": 60 } ``` Salida: ``` { "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/cpu75-target-tracking-scaling-policy", "Alarms": [ { "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca", "AlarmName": "TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca" }, { "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmLow-1b437334-d19b-4a63-a812-6c67aaf2910d", "AlarmName": "TargetTracking-service/default/web-app-AlarmLow-1b437334-d19b-4a63-a812-6c67aaf2910d" } ] } ``` **Ejemplo 2: aplicar una política de escalado de seguimiento de destino con una especificación de métrica personalizada** En el siguiente ejemplo de `put-scaling-policy`, se aplica una política de escalado de seguimiento de destino con una especificación de métricas personalizada para un servicio de Amazon ECS denominado web-app en el clúster predeterminado. La política mantiene la utilización media del servicio en un 75 %, con períodos de recuperación de escalado horizontal y reducción horizontal de 60 segundos. El resultado contiene los nombres ARNs y los nombres de las dos CloudWatch alarmas creadas en su nombre. ``` aws application-autoscaling put-scaling-policy --service-namespace {{ecs}} \ --scalable-dimension {{ecs:service:DesiredCount}} \ --resource-id {{service/default/web-app}} \ --policy-name {{cms75-target-tracking-scaling-policy}} --policy-type {{TargetTrackingScaling}} \ --target-tracking-scaling-policy-configuration {{file://config.json}} ``` En este ejemplo se supone que tiene un archivo config.json en el directorio actual con el siguiente contenido: ``` { "TargetValue":75.0, "CustomizedMetricSpecification":{ "MetricName":"MyUtilizationMetric", "Namespace":"MyNamespace", "Dimensions": [ { "Name":"MyOptionalMetricDimensionName", "Value":"MyOptionalMetricDimensionValue" } ], "Statistic":"Average", "Unit":"Percent" }, "ScaleOutCooldown": 60, "ScaleInCooldown": 60 } ``` Salida: ``` { "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy: 8784a896-b2ba-47a1-b08c-27301cc499a1:resource/ecs/service/default/web-app:policyName/cms75-target-tracking-scaling-policy", "Alarms": [ { "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmHigh-9bc77b56-0571-4276-ba0f-d4178882e0a0", "AlarmName": "TargetTracking-service/default/web-app-AlarmHigh-9bc77b56-0571-4276-ba0f-d4178882e0a0" }, { "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:TargetTracking-service/default/web-app-AlarmLow-9b6ad934-6d37-438e-9e05-02836ddcbdc4", "AlarmName": "TargetTracking-service/default/web-app-AlarmLow-9b6ad934-6d37-438e-9e05-02836ddcbdc4" } ] } ``` **Ejemplo 3: aplicar una política de escalado de seguimiento de destino solo para el escalado ascendente** En el siguiente ejemplo de `put-scaling-policy`, se aplica una política de escalado de seguimiento de destino a un servicio de Amazon ECS denominado `web-app` en el clúster predeterminado. La política se usa para escalar horizontalmente el servicio de ECS cuando la métrica `RequestCountPerTarget` del equilibrador de carga de aplicación supera el umbral. El resultado contiene el ARN y el nombre de la CloudWatch alarma creada en su nombre. ``` aws application-autoscaling put-scaling-policy \ --service-namespace {{ecs}} \ --scalable-dimension {{ecs:service:DesiredCount}} \ --resource-id {{service/default/web-app}} \ --policy-name {{alb-scale-out-target-tracking-scaling-policy}} \ --policy-type {{TargetTrackingScaling}} \ --target-tracking-scaling-policy-configuration {{file://config.json}} ``` Contenido de `config.json`: ``` { "TargetValue": 1000.0, "PredefinedMetricSpecification": { "PredefinedMetricType": "ALBRequestCountPerTarget", "ResourceLabel": "app/EC2Co-EcsEl-1TKLTMITMM0EO/f37c06a68c1748aa/targetgroup/EC2Co-Defau-LDNM7Q3ZH1ZN/6d4ea56ca2d6a18d" }, "ScaleOutCooldown": 60, "ScaleInCooldown": 60, "DisableScaleIn": true } ``` Salida: ``` { "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/alb-scale-out-target-tracking-scaling-policy", "Alarms": [ { "AlarmName": "TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca", "AlarmARN": "arn:aws:cloudwatch:us-west-2:123456789012:alarm:TargetTracking-service/default/web-app-AlarmHigh-d4f0770c-b46e-434a-a60f-3b36d653feca" } ] } ``` Para obtener más información, consulte [Target Tracking Scaling Policies for Application Auto Scaling](https://docs.aws.amazon.com/autoscaling/application/userguide/application-auto-scaling-target-tracking.html) en la *Guía del usuario de AWS Auto Scaling de aplicaciones*. + Para obtener más información sobre la API, consulte [PutScalingPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/application-autoscaling/put-scaling-policy.html)la *Referencia de AWS CLI comandos*. ------ #### [ PowerShell ] **Herramientas para la PowerShell versión 4** **Ejemplo 1: Este cmdlet crea o actualiza una política para un destino escalable de Application Auto Scaling. Cada destino escalable se identifica mediante un espacio de nombres de servicio, un ID de recurso y una dimensión escalable.** ``` Set-AASScalingPolicy -ServiceNamespace AppStream -PolicyName ASFleetScaleInPolicy -PolicyType StepScaling -ResourceId fleet/MyFleet -ScalableDimension appstream:fleet:DesiredCapacity -StepScalingPolicyConfiguration_AdjustmentType ChangeInCapacity -StepScalingPolicyConfiguration_Cooldown 360 -StepScalingPolicyConfiguration_MetricAggregationType Average -StepScalingPolicyConfiguration_StepAdjustments @{ScalingAdjustment = -1; MetricIntervalUpperBound = 0} ``` **Salida:** ``` Alarms PolicyARN ------ --------- {} arn:aws:autoscaling:us-west-2:012345678912:scalingPolicy:4897ca24-3caa-4bf1-8484-851a089b243c:resource/appstream/fleet/MyFleet:policyName/ASFleetScaleInPolicy ``` + Para obtener más información sobre la API, consulte [PutScalingPolicy Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*. **Herramientas para la versión 5 PowerShell ** **Ejemplo 1: Este cmdlet crea o actualiza una política para un destino escalable de Application Auto Scaling. Cada destino escalable se identifica mediante un espacio de nombres de servicio, un ID de recurso y una dimensión escalable.** ``` Set-AASScalingPolicy -ServiceNamespace AppStream -PolicyName ASFleetScaleInPolicy -PolicyType StepScaling -ResourceId fleet/MyFleet -ScalableDimension appstream:fleet:DesiredCapacity -StepScalingPolicyConfiguration_AdjustmentType ChangeInCapacity -StepScalingPolicyConfiguration_Cooldown 360 -StepScalingPolicyConfiguration_MetricAggregationType Average -StepScalingPolicyConfiguration_StepAdjustments @{ScalingAdjustment = -1; MetricIntervalUpperBound = 0} ``` **Salida:** ``` Alarms PolicyARN ------ --------- {} arn:aws:autoscaling:us-west-2:012345678912:scalingPolicy:4897ca24-3caa-4bf1-8484-851a089b243c:resource/appstream/fleet/MyFleet:policyName/ASFleetScaleInPolicy ``` + Para obtener más información sobre la API, consulte [PutScalingPolicy](https://docs.aws.amazon.com/powershell/v5/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (*V5). ------