Na}{

File Content: `describe-policies.rst`

**To describe Auto Scaling policies**

This example describes the policies for the specified Auto Scaling group::

    aws autoscaling describe-policies --auto-scaling-group-name my-auto-scaling-group

The following is example output::

    {
        "ScalingPolicies": [
            {
                "PolicyName": "ScaleIn",
                "AutoScalingGroupName": "my-auto-scaling-group",
                "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:2233f3d7-6290-403b-b632-93c553560106:autoScalingGroupName/my-auto-scaling-group:policyName/ScaleIn",
                "AdjustmentType": "ChangeInCapacity",
                "Alarms": [],
                "ScalingAdjustment": -1
            },
            {
                "PolicyName": "ScalePercentChange",
                "MinAdjustmentStep": 2,
                "AutoScalingGroupName": "my-auto-scaling-group",
                "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:2b435159-cf77-4e89-8c0e-d63b497baad7:autoScalingGroupName/my-auto-scaling-group:policyName/ScalePercentChange",
                "Cooldown": 60,
                "AdjustmentType": "PercentChangeInCapacity",
                "Alarms": [],
                "ScalingAdjustment": 25
            }
        ]
    }

To return specific scaling policies, use the ``policy-names`` parameter::

    aws autoscaling describe-policies --auto-scaling-group-name my-auto-scaling-group --policy-names ScaleIn

To return a specific number of policies, use the ``max-items`` parameter::

    aws autoscaling describe-policies --auto-scaling-group-name my-auto-scaling-group --max-items 1

The following is example output::

    {
        "ScalingPolicies": [
            {
                "PolicyName": "ScaleIn",
                "AutoScalingGroupName": "my-auto-scaling-group",
                "PolicyARN": "arn:aws:autoscaling:us-west-2:123456789012:scalingPolicy:2233f3d7-6290-403b-b632-93c553560106:autoScalingGroupName/my-auto-scaling-group:policyName/ScaleIn",
                "AdjustmentType": "ChangeInCapacity",
                "Alarms": [],
                "ScalingAdjustment": -1
            }
        ],
        "NextToken": "Z3M3LMPEXAMPLE"
    }

If the output includes a ``NextToken`` field, use the value of this field with the ``starting-token`` parameter in a subsequent call to get the additional policies::

    aws autoscaling describe-policies --auto-scaling-group-name my-auto-scaling-group --starting-token Z3M3LMPEXAMPLE

For more information, see `Dynamic Scaling`_ in the *Auto Scaling Developer Guide*.

.. _`Dynamic Scaling`: http://docs.aws.amazon.com/AutoScaling/latest/DeveloperGuide/as-scale-based-on-demand.html

Name	Size	Permission
attach-instances.rst	247 bytes	0644
attach-load-balancer-target-groups.rst	358 bytes	0755
attach-load-balancers.rst	274 bytes	0644
complete-lifecycle-action.rst	415 bytes	0644
create-auto-scaling-group.rst	1585 bytes	0644
create-launch-configuration.rst	2013 bytes	0644
create-or-update-tags.rst	396 bytes	0644
delete-auto-scaling-group.rst	661 bytes	0644
delete-launch-configuration.rst	419 bytes	0644
delete-lifecycle-hook.rst	215 bytes	0644
delete-notification-configuration.rst	567 bytes	0644
delete-policy.rst	200 bytes	0644
delete-scheduled-action.rst	290 bytes	0644
delete-tags.rst	493 bytes	0644
describe-account-limits.rst	588 bytes	0644
describe-adjustment-types.rst	729 bytes	0644
describe-auto-scaling-groups.rst	2164 bytes	0644
describe-auto-scaling-instances.rst	1623 bytes	0644
describe-auto-scaling-notification-types.rst	826 bytes	0644
describe-launch-configurations.rst	2650 bytes	0644
describe-lifecycle-hook-types.rst	358 bytes	0644
describe-lifecycle-hooks.rst	828 bytes	0644
describe-load-balancer-target-groups.rst	525 bytes	0755
describe-load-balancers.rst	438 bytes	0644
describe-metric-collection-types.rst	1228 bytes	0644
describe-notification-configurations.rst	1995 bytes	0644
describe-policies.rst	2702 bytes	0644
describe-scaling-activities.rst	1728 bytes	0644
describe-scaling-process-types.rst	1087 bytes	0644
describe-scheduled-actions.rst	3036 bytes	0644
describe-tags.rst	1818 bytes	0644
describe-termination-policy-types.rst	762 bytes	0644
detach-instances.rst	949 bytes	0644
detach-load-balancer-target-groups.rst	362 bytes	0755
detach-load-balancers.rst	278 bytes	0644
disable-metrics-collection.rst	571 bytes	0644
enable-metrics-collection.rst	743 bytes	0644
enter-standby.rst	925 bytes	0644
execute-policy.rst	457 bytes	0644
exit-standby.rst	904 bytes	0644
put-lifecycle-hook.rst	607 bytes	0644
put-notification-configuration.rst	637 bytes	0644
put-scaling-policy.rst	1317 bytes	0644
put-scheduled-update-group-action.rst	983 bytes	0644
record-lifecycle-action-heartbeat.rst	341 bytes	0644
resume-processes.rst	506 bytes	0644
set-desired-capacity.rst	265 bytes	0644
set-instance-health.rst	218 bytes	0644
set-instance-protection.rst	498 bytes	0644
suspend-processes.rst	499 bytes	0644
terminate-instance-in-auto-scaling-group.rst	394 bytes	0644
update-auto-scaling-group.rst	1428 bytes	0644

Name

Size

Permission

Action

attach-instances.rst

247 bytes

0644