# Creating an AS Group

#### Scenario

An AS group consists of a collection of instances that apply to the same scenario. It is the basis for enabling or disabling AS policies and performing scaling actions.

#### Precautions

- If you use a token for authentication, you must call the IAM API to obtain the user's token and add X-Auth-Token to the request message header of ECS API you call.
- The validity period of the token obtained from the IAM service is 24 hours. If you want to use a token for authentication, you can cache it to avoid frequently calling the IAM API.

#### Involved APIs

- IAM API used to obtain the token
- API used to query VPCs
- API used to query subnets
- API used to query security groups
- API used to query AS configurations
- API used to create an AS group

#### Procedure

1. For details about token authentication, see Token Authentication.
2. Send GET https://VPC endpoint/v1/{tenant_id}/vpcs to obtain VPCs. Use the ID of one of the obtained VPCs as parameter vpc_id for creating an AS group, such as a8327883-6b07-4497-9c61-68d03ee193. For the response parameters of the API used to query VPCs, see section Response Parameters for Querying VPCs.
3. Send GET https://VPC endpoint /v1/{tenant_id}/security-groups to obtain security groups. Use one of the obtained security groups as parameter security_groups for creating an AS group. For the response parameters of the API used to query security groups, see section Response Parameters for Querying Security Groups.
4. Send GET https://VPC endpoint /v1/{tenant_id}/subnets?vpc_id=a8327883-6b07-4497-9c61-68d03ee193a to obtain subnets in a specified VPC. For the response parameters of the API used to query subnets, see section Response Parameters for Querying Subnets.
5. Send GET https://AS endpoint/autoscaling-api/v1/{tenant_id}/scaling_configuration to obtain AS configurations. Use the ID of one of the obtained AS configurations as parameter scaling_configuration_id for creating an AS group. For the response parameters of the API used to query AS configurations, see section Response Parameters for Querying AS Configurations.
6. Send POST https://AS endpoint/autoscaling-api/v1/{tenant_id}/scaling_group to create an AS group. For detailed parameters, see section "Creating an AS Group" in the Auto Scaling API Reference.
   Specify the following parameters in the request body:

       {
           "scaling_group_name": "as-group-test",
           "scaling_configuration_id": "47683a91-93ee-462a-a7d7-484c006f4440",
           "desire_instance_number": 0,
           "min_instance_number": 0,
           "max_instance_number": 10,
           "cool_down_time": 300,
           "health_periodic_audit_method": "NOVA_AUDIT",
           "health_periodic_audit_time": 5,
           "instance_terminate_policy": "OLD_CONFIG_OLD_INSTANCE",
           "vpc_id": "a8327883-6b07-4497-9c61-68d03ee193a",
           "networks": [
               {
                   "id": "3cd35bca-5a10-416f-8994-f79169559870"
               }
           ],
           "security_groups": [
               {
                   "id": "23b7b999-0a30-4b48-ae8f-ee201a88a6ab"
               }
           ]
       }

   scaling_group_id is returned if the request is successful.

Parent topic: Common Operations