を使用した Application Auto Scaling の例 AWS CLI - AWS Command Line Interface
アクション

このドキュメントは、 のバージョン 1 AWS CLI 専用です。のバージョン 2 に関連するドキュメントについては AWS CLI、バージョン 2 ユーザーガイド を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

を使用した Application Auto Scaling の例 AWS CLI

次のコード例は、Application Auto Scaling AWS Command Line Interface で を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。

トピック

アクション

次のコード例は、delete-scaling-policy を使用する方法を示しています。

AWS CLI

スケーリングポリシーを削除するには

この例では、デフォルトのクラスターで実行されている Amazon ECSサービスウェブアプリのスケーリングポリシーを削除します。

コマンド:

aws application-autoscaling delete-scaling-policy --policy-name web-app-cpu-lt-25 --scalable-dimension ecs:service:DesiredCount --resource-id service/default/web-app --service-namespace ecs

  • API 詳細については、AWS CLI 「 コマンドリファレンスDeleteScalingPolicy」の「」を参照してください。

次のコード例は、delete-scheduled-action を使用する方法を示しています。

AWS CLI

スケジュールされたアクションを削除するには

次のdelete-scheduled-action例では、指定された Amazon AppStream 2.0 フリートから指定されたスケジュール済みアクションを削除します。

aws application-autoscaling delete-scheduled-action \
    --service-namespace appstream \
    --scalable-dimension appstream:fleet:DesiredCapacity \
    --resource-id fleet/sample-fleet \
    --scheduled-action-name my-recurring-action

このコマンドでは何も出力されません。

詳細については、「Application Auto Scaling ユーザーガイド」の「スケジュールされたスケーリング」を参照してください。

  • API 詳細については、AWS CLI 「 コマンドリファレンスDeleteScheduledAction」の「」を参照してください。

次のコード例は、deregister-scalable-target を使用する方法を示しています。

AWS CLI

スケーラブルターゲットの登録を解除するには

この例では、デフォルトのクラスターで実行されているウェブアプリと呼ばれる Amazon ECSサービスのスケーラブルターゲットを登録解除します。

コマンド:

aws application-autoscaling deregister-scalable-target --service-namespace ecs --scalable-dimension ecs:service:DesiredCount --resource-id service/default/web-app

この例では、カスタムリソースのスケーラブルターゲットを登録解除します。 custom-resource-id.txt ファイルには、リソース ID を識別する文字列が含まれています。これは、カスタムリソースの場合、Amazon API Gateway エンドポイントを介したカスタムリソースへのパスです。

コマンド:

aws application-autoscaling deregister-scalable-target --service-namespace custom-resource --scalable-dimension custom-resource:ResourceType:Property --resource-id file://~/custom-resource-id.txt

custom-resource-id.txt ファイルの内容：

https://example.execute-api.us-west-2.amazonaws.com/prod/scalableTargetDimensions/1-23456789

  • API 詳細については、AWS CLI 「 コマンドリファレンスDeregisterScalableTarget」の「」を参照してください。

次のコード例は、describe-scalable-targets を使用する方法を示しています。

AWS CLI

スケーラブルターゲットを記述するには

次のdescribe-scalable-targets例では、ecsサービス名前空間のスケーラブルターゲットについて説明します。

aws application-autoscaling describe-scalable-targets \
    --service-namespace ecs

出力:

{
    "ScalableTargets": [
        {
            "ServiceNamespace": "ecs",
            "ScalableDimension": "ecs:service:DesiredCount",
            "ResourceId": "service/default/web-app",
            "MinCapacity": 1,
            "MaxCapacity": 10,
            "RoleARN": "arn:aws:iam::123456789012:role/aws-service-role/ecs.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_ECSService",
            "CreationTime": 1462558906.199,
            "SuspendedState": {
                "DynamicScalingOutSuspended": false,
                "ScheduledScalingSuspended": false,
                "DynamicScalingInSuspended": false
            },
            "ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123"
        }
    ]
}

詳細については、AWS 「Application Auto Scaling ユーザーガイド」の「Application Auto Scaling で使用できるサービス」を参照してください。 Auto Scaling

  • API 詳細については、AWS CLI 「 コマンドリファレンスDescribeScalableTargets」の「」を参照してください。

次の例は、describe-scaling-activities を使用する方法を説明しています。

AWS CLI

例 1: 指定された Amazon ECSサービスのスケーリングアクティビティを記述するには

次のdescribe-scaling-activities例では、defaultクラスターで実行web-appされている という Amazon ECSサービスのスケーリングアクティビティについて説明します。出力には、スケーリングポリシーによって開始されたスケーリングアクティビティが表示されます。

aws application-autoscaling describe-scaling-activities \
    --service-namespace ecs \
    --resource-id service/default/web-app

出力:

{
    "ScalingActivities": [
        {
            "ScalableDimension": "ecs:service:DesiredCount",
            "Description": "Setting desired count to 1.",
            "ResourceId": "service/default/web-app",
            "ActivityId": "e6c5f7d1-dbbb-4a3f-89b2-51f33e766399",
            "StartTime": 1462575838.171,
            "ServiceNamespace": "ecs",
            "EndTime": 1462575872.111,
            "Cause": "monitor alarm web-app-cpu-lt-25 in state ALARM triggered policy web-app-cpu-lt-25",
            "StatusMessage": "Successfully set desired count to 1. Change successfully fulfilled by ecs.",
            "StatusCode": "Successful"
        }
    ]
}

詳細については、「Application Auto Scaling ユーザーガイド」の「Application Auto Scaling のスケーリングアクティビティ」を参照してください。 Auto Scaling

例 2: 指定された DynamoDB テーブルのスケーリングアクティビティを記述するには

次のdescribe-scaling-activities例では、 と呼ばれる DynamoDB テーブルのスケーリングアクティビティについて説明しますTestTable。出力には、2 つの異なるスケジュールされたアクションによって開始されたスケーリングアクティビティが表示されます。

aws application-autoscaling describe-scaling-activities \
    --service-namespace dynamodb \
    --resource-id table/TestTable

出力:

{
    "ScalingActivities": [
        {
            "ScalableDimension": "dynamodb:table:WriteCapacityUnits",
            "Description": "Setting write capacity units to 10.",
            "ResourceId": "table/my-table",
            "ActivityId": "4d1308c0-bbcf-4514-a673-b0220ae38547",
            "StartTime": 1561574415.086,
            "ServiceNamespace": "dynamodb",
            "EndTime": 1561574449.51,
            "Cause": "maximum capacity was set to 10",
            "StatusMessage": "Successfully set write capacity units to 10. Change successfully fulfilled by dynamodb.",
            "StatusCode": "Successful"
        },
        {
            "ScalableDimension": "dynamodb:table:WriteCapacityUnits",
            "Description": "Setting min capacity to 5 and max capacity to 10",
            "ResourceId": "table/my-table",
            "ActivityId": "f2b7847b-721d-4e01-8ef0-0c8d3bacc1c7",
            "StartTime": 1561574414.644,
            "ServiceNamespace": "dynamodb",
            "Cause": "scheduled action name my-second-scheduled-action was triggered",
            "StatusMessage": "Successfully set min capacity to 5 and max capacity to 10",
            "StatusCode": "Successful"
        },
        {
            "ScalableDimension": "dynamodb:table:WriteCapacityUnits",
            "Description": "Setting write capacity units to 15.",
            "ResourceId": "table/my-table",
            "ActivityId": "d8ea4de6-9eaa-499f-b466-2cc5e681ba8b",
            "StartTime": 1561574108.904,
            "ServiceNamespace": "dynamodb",
            "EndTime": 1561574140.255,
            "Cause": "minimum capacity was set to 15",
            "StatusMessage": "Successfully set write capacity units to 15. Change successfully fulfilled by dynamodb.",
            "StatusCode": "Successful"
        },
        {
            "ScalableDimension": "dynamodb:table:WriteCapacityUnits",
            "Description": "Setting min capacity to 15 and max capacity to 20",
            "ResourceId": "table/my-table",
            "ActivityId": "3250fd06-6940-4e8e-bb1f-d494db7554d2",
            "StartTime": 1561574108.512,
            "ServiceNamespace": "dynamodb",
            "Cause": "scheduled action name my-first-scheduled-action was triggered",
            "StatusMessage": "Successfully set min capacity to 15 and max capacity to 20",
            "StatusCode": "Successful"
        }
    ]
}

詳細については、「Application Auto Scaling ユーザーガイド」の「Application Auto Scaling のスケーリングアクティビティ」を参照してください。 Auto Scaling

  • API 詳細については、AWS CLI 「 コマンドリファレンスDescribeScalingActivities」の「」を参照してください。

次のコード例は、describe-scaling-policies を使用する方法を示しています。

AWS CLI

スケーリングポリシーを記述するには

この例では、ECS サービス名前空間のスケーリングポリシーについて説明します。

コマンド:

aws application-autoscaling describe-scaling-policies --service-namespace ecs

出力:

{
    "ScalingPolicies": [
        {
            "PolicyName": "web-app-cpu-gt-75",
            "ScalableDimension": "ecs:service:DesiredCount",
            "ResourceId": "service/default/web-app",
            "CreationTime": 1462561899.23,
            "StepScalingPolicyConfiguration": {
                "Cooldown": 60,
                "StepAdjustments": [
                    {
                        "ScalingAdjustment": 200,
                        "MetricIntervalLowerBound": 0.0
                    }
                ],
                "AdjustmentType": "PercentChangeInCapacity"
            },
            "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/web-app-cpu-gt-75",
            "PolicyType": "StepScaling",
            "Alarms": [
                {
                    "AlarmName": "web-app-cpu-gt-75",
                    "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:web-app-cpu-gt-75"
                }
            ],
            "ServiceNamespace": "ecs"
        },
        {
            "PolicyName": "web-app-cpu-lt-25",
            "ScalableDimension": "ecs:service:DesiredCount",
            "ResourceId": "service/default/web-app",
            "CreationTime": 1462562575.099,
            "StepScalingPolicyConfiguration": {
                "Cooldown": 1,
                "StepAdjustments": [
                    {
                        "ScalingAdjustment": -50,
                        "MetricIntervalUpperBound": 0.0
                    }
                ],
                "AdjustmentType": "PercentChangeInCapacity"
            },
            "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/web-app-cpu-lt-25",
            "PolicyType": "StepScaling",
            "Alarms": [
                {
                    "AlarmName": "web-app-cpu-lt-25",
                    "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:web-app-cpu-lt-25"
                }
            ],
            "ServiceNamespace": "ecs"
        }
    ]
}

  • API 詳細については、AWS CLI 「 コマンドリファレンスDescribeScalingPolicies」の「」を参照してください。

次のコード例は、describe-scheduled-actions を使用する方法を示しています。

AWS CLI

スケジュールされたアクションを記述するには

次のdescribe-scheduled-actions例では、指定されたサービス名前空間のスケジュールされたアクションの詳細を表示します。

aws application-autoscaling describe-scheduled-actions \
    --service-namespace dynamodb

出力:

{
    "ScheduledActions": [
        {
            "ScalableDimension": "dynamodb:table:WriteCapacityUnits",
            "Schedule": "at(2019-05-20T18:35:00)",
            "ResourceId": "table/my-table",
            "CreationTime": 1561571888.361,
            "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledAction:2d36aa3b-cdf9-4565-b290-81db519b227d:resource/dynamodb/table/my-table:scheduledActionName/my-first-scheduled-action",
            "ScalableTargetAction": {
                "MinCapacity": 15,
                "MaxCapacity": 20
            },
            "ScheduledActionName": "my-first-scheduled-action",
            "ServiceNamespace": "dynamodb"
        },
        {
            "ScalableDimension": "dynamodb:table:WriteCapacityUnits",
            "Schedule": "at(2019-05-20T18:40:00)",
            "ResourceId": "table/my-table",
            "CreationTime": 1561571946.021,
            "ScheduledActionARN": "arn:aws:autoscaling:us-west-2:123456789012:scheduledAction:2d36aa3b-cdf9-4565-b290-81db519b227d:resource/dynamodb/table/my-table:scheduledActionName/my-second-scheduled-action",
            "ScalableTargetAction": {
                "MinCapacity": 5,
                "MaxCapacity": 10
            },
            "ScheduledActionName": "my-second-scheduled-action",
            "ServiceNamespace": "dynamodb"
        }
    ]
}

詳細については、「Application Auto Scaling ユーザーガイド」の「スケジュールされたスケーリング」を参照してください。

  • API 詳細については、AWS CLI 「 コマンドリファレンスDescribeScheduledActions」の「」を参照してください。

次のコード例は、list-tags-for-resource を使用する方法を示しています。

AWS CLI

スケーラブルターゲットのタグを一覧表示するには

次のlist-tags-for-resource例では、 で指定されたスケーラブルターゲットにアタッチされているタグキーの名前と値を一覧表示しますARN。

aws application-autoscaling list-tags-for-resource \
    --resource-arn arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123

出力:

{
    "Tags": {
        "environment": "production"
    }
}

詳細については、「Application Auto Scaling ユーザーガイド」の「Application Auto Scaling のタグ付けサポート」を参照してください。 Auto Scaling

  • API 詳細については、AWS CLI 「 コマンドリファレンスListTagsForResource」の「」を参照してください。

次の例は、put-scaling-policy を使用する方法を説明しています。

AWS CLI

例 1: 事前定義されたメトリクス指定を使用してターゲット追跡スケーリングポリシーを適用するには

次のput-scaling-policy例では、デフォルトのクラスターのウェブアプリと呼ばれる Amazon ECSサービスに、事前定義されたメトリクス仕様を持つターゲット追跡スケーリングポリシーを適用します。このポリシーは、サービスの平均CPU使用率を 75% に保ち、スケールアウトとスケールインのクールダウン期間は 60 秒です。出力には、ユーザーに代わって作成された 2 つの CloudWatch アラームの ARNsと名前が含まれます。

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

この例では、現在のディレクトリに次の内容の config.json ファイルがあることを前提としています。

{
     "TargetValue": 75.0,
     "PredefinedMetricSpecification": {
         "PredefinedMetricType": "ECSServiceAverageCPUUtilization"
     },
     "ScaleOutCooldown": 60,
    "ScaleInCooldown": 60
}

出力:

{
    "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"
        }
    ]
}

例 2: カスタマイズされたメトリクス仕様を使用してターゲット追跡スケーリングポリシーを適用するには

次のput-scaling-policy例では、カスタマイズされたメトリクス仕様を持つターゲット追跡スケーリングポリシーを、デフォルトクラスターのウェブアプリと呼ばれる Amazon ECSサービスに適用します。このポリシーは、サービスの平均使用率を 75% に保ち、スケールアウトおよびスケールインのクールダウン期間は 60 秒です。出力には、ユーザーに代わって作成された 2 つの CloudWatch アラームの ARNsと名前が含まれます。

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

この例では、現在のディレクトリに次の内容の config.json ファイルがあることを前提としています。

{
    "TargetValue":75.0,
    "CustomizedMetricSpecification":{
        "MetricName":"MyUtilizationMetric",
        "Namespace":"MyNamespace",
        "Dimensions": [
            {
                "Name":"MyOptionalMetricDimensionName",
                "Value":"MyOptionalMetricDimensionValue"
            }
        ],
        "Statistic":"Average",
        "Unit":"Percent"
    },
    "ScaleOutCooldown": 60,
    "ScaleInCooldown": 60
}

出力:

{
    "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"
        }
    ]
}

例 3: スケールアウトにのみターゲット追跡スケーリングポリシーを適用するには

次のput-scaling-policy例では、ターゲット追跡スケーリングポリシーをデフォルトのクラスターweb-appで と呼ばれる Amazon ECSサービスに適用します。このポリシーは、Application Load Balancer のRequestCountPerTargetメトリクスがしきい値を超えたときにECSサービスをスケールアウトするために使用されます。出力には、ユーザーに代わって作成された CloudWatch アラームの ARNと名前が含まれます。

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

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
}

出力:

{
    "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"
        }
    ]
}

詳細については、「Application Auto Scaling ユーザーガイド」の「Application Auto Scaling のターゲット追跡スケーリングポリシー」を参照してください。 AWS Auto Scaling

  • API 詳細については、AWS CLI 「 コマンドリファレンスPutScalingPolicy」の「」を参照してください。

次の例は、put-scheduled-action を使用する方法を説明しています。

AWS CLI

スケジュールされたアクションを DynamoDB テーブルに追加するには

この例では、定期的なスケジュールでスケールアウト TestTable するために という DynamoDB テーブルにスケジュールされたアクションを追加します。指定されたスケジュール (毎日 12:15pm UTC) で、現在の容量が に指定された値を下回ると MinCapacity、Application Auto Scaling は に指定された値にスケールアウトします MinCapacity。

コマンド:

aws application-autoscaling put-scheduled-action --service-namespace dynamodb --scheduled-action-name my-recurring-action --schedule "cron(15 12 * * ? *)" --resource-id table/TestTable --scalable-dimension dynamodb:table:WriteCapacityUnits --scalable-target-action MinCapacity=6

詳細については、「Application Auto Scaling ユーザーガイド」の「スケジュールされたスケーリング」を参照してください。

  • API 詳細については、AWS CLI 「 コマンドリファレンスPutScheduledAction」の「」を参照してください。

次のコード例は、register-scalable-target を使用する方法を示しています。

AWS CLI

例 1: ECSサービスをスケーラブルターゲットとして登録するには

次のregister-scalable-target例では、Amazon ECSサービスを Application Auto Scaling に登録します。また、スケーラブルターゲットproductionにキー名environmentと値を含むタグを追加します。

aws application-autoscaling register-scalable-target \
    --service-namespace ecs \
    --scalable-dimension ecs:service:DesiredCount \
    --resource-id service/default/web-app \
    --min-capacity 1 --max-capacity 10 \
    --tags environment=production

出力:

{
    "ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123"
}

その他の AWS サービスやカスタムリソースの例については、AWS Application Auto Scaling ユーザーガイドの「Application Auto Scaling で使用できるサービスのトピック」を参照してください。 Auto Scaling

例 2: スケーラブルターゲットのスケーリングアクティビティを停止するには

次のregister-scalable-target例では、既存のスケーラブルターゲットのスケーリングアクティビティを一時停止します。

aws application-autoscaling register-scalable-target \
    --service-namespace dynamodb \
    --scalable-dimension dynamodb:table:ReadCapacityUnits \
    --resource-id table/my-table \
    --suspended-state DynamicScalingInSuspended=true,DynamicScalingOutSuspended=true,ScheduledScalingSuspended=true

出力:

{
    "ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123"
}

詳細については、「Application Auto Scaling ユーザーガイド」の「Application Auto Scaling のスケーリングの一時停止と再開」を参照してください。 Auto Scaling

例 3: スケーラブルターゲットのスケーリングアクティビティを再開するには

次のregister-scalable-target例では、既存のスケーラブルターゲットのスケーリングアクティビティを再開します。

aws application-autoscaling register-scalable-target \
    --service-namespace dynamodb \
    --scalable-dimension dynamodb:table:ReadCapacityUnits \
    --resource-id table/my-table \
    --suspended-state DynamicScalingInSuspended=false,DynamicScalingOutSuspended=false,ScheduledScalingSuspended=false

出力:

{
    "ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123"
}

詳細については、「Application Auto Scaling ユーザーガイド」の「Application Auto Scaling のスケーリングの一時停止と再開」を参照してください。 Auto Scaling

  • API 詳細については、AWS CLI 「 コマンドリファレンスRegisterScalableTarget」の「」を参照してください。

次の例は、tag-resource を使用する方法を説明しています。

AWS CLI

スケーラブルターゲットにタグを追加するには

次のtag-resource例では、キー名environmentと値が で指定されたスケーラブルターゲットproductionにタグを追加しますARN。

aws application-autoscaling tag-resource \
    --resource-arn arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123 \
    --tags environment=production

このコマンドでは何も出力されません。

詳細については、「Application Auto Scaling ユーザーガイド」の「Application Auto Scaling のタグ付けサポート」を参照してください。 Auto Scaling

  • API 詳細については、AWS CLI 「 コマンドリファレンスTagResource」の「」を参照してください。

次の例は、untag-resource を使用する方法を説明しています。

AWS CLI

スケーラブルターゲットからタグを削除するには

次のuntag-resource例では、 によって指定されたスケーラブルターゲットenvironmentからキー名を持つタグペアを削除しますARN。

aws application-autoscaling untag-resource \
    --resource-arn arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123 \
    --tag-keys "environment"

このコマンドでは何も出力されません。

詳細については、「Application Auto Scaling ユーザーガイド」の「Application Auto Scaling のタグ付けサポート」を参照してください。 Auto Scaling

  • API 詳細については、AWS CLI 「 コマンドリファレンスUntagResource」の「」を参照してください。