Creating an AS Configuration

instance_id

No

String

Specifies the ECS ID. When you want to create an AS configuration from an ECS, specify this parameter. In this case, the flavorRef, imageRef, disk, tenancy, dedicated_host_id, and security_groups fields do not take effect.

If the instance_id field is not specified, flavorRef, imageRef, and disk fields are mandatory.

flavorRef

No

String

Specifies the ECS flavor ID. A maximum of 10 flavors can be selected. Use a comma (,) to separate multiple flavor IDs. You can obtain an ECS flavor ID from the API for querying details about flavors and extended flavor information. For details, see Querying Details About Flavors and Extended Flavor Information.

imageRef

No

String

Specifies the image ID. Its value is the same as that of image_id for specifying the image selected during ECS creation. You can obtain an image ID by calling the IMS API for querying images. For details, see Querying Images.

disk

No

Array of disk objects

Specifies the disk group information. System disks are mandatory and data disks are optional. For details, see Table 4.

key_name

No

String

Specifies the name of the SSH key pair used to log in to the ECS.

For details about how to obtain a key pair, see Creating and Importing an SSH Key Pair.

personality

No

Array of personality objects

Specifies information about the injected file. Only text files can be injected. A maximum of five files can be injected at a time and the maximum size of each file is 1 KB. For details, see Table 6.

public_ip

No

public_ip object

Specifies the EIP of the ECS. The EIP can be configured in two ways. For details, see Table 7.

• Do not use an EIP. In this case, this parameter is unavailable.
• Automatically assign an EIP. You need to specify the information about the new EIP.
  NOTE:

  If you enable fine-grained policy and associate the AS configuration with an EIP specified to an AS group, the fine-grained policy granted to you must contain the authorization item that allows the vpc:publicIps:create action.

user_data

No

String

Specifies the user data to be injected during the ECS creation process. Text, text files, and gzip files can be injected. For more information, see Passing User Data to ECSs.

Constraints:

• The content to be injected must be encoded with base64. The maximum size of the content to be injected (before encoding) is 32 KB.
• If key_name is not specified, the data injected by user_data is the password of user root for logging in to the ECS by default.
• This parameter is mandatory when you create a Linux ECS using the password authentication mode. Its value is the initial user root password.

Password complexity requirements:

• Consists of 8 to 26 characters.
• Contains at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters !@$%^-_=+[{}]:,./?

Examples:

• Use a plaintext password (risky in security), for example, Cloud.1234.

  #! /bin/bash
  echo 'root:Cloud.1234' | chpasswd ;

• Use a ciphertext password (recommended)

  #! /bin/bash
  echo 'root:$6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig' | chpasswd -e

In the preceding command output, $6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig is the ciphertext password, which can be generated as follows:

1. Generate an encrypted salt value.

[root@test linux]# python -c "import crypt, getpass, pwd;print crypt.mksalt()"  $6$V6azyeLwcD3CHlpY

2. Generate a ciphertext password based on the salt value.

[root@test linux]# python -c "import crypt, getpass, pwd;print crypt.crypt('Cloud.1234','\$6\$V6azyeLwcD3CHlpY')"   $6$V6azyeLwcD3CHlpY$BN3VVq18fmCkj66B4zdHLWevqcxlig

Examples:

• Linux

  #! /bin/bash
  echo user_test >> /home/user.txt

• Windows

  rem cmd
  echo 111 > c:\aaa.txt

metadata

No

metadata object

Specifies the ECS metadata. For details, see Table 10.

security_groups

No

Array of security_groups objects

Specifies security groups. For details, see Table 11. For how to obtain information about security groups using VPC IDs, see Querying Security Groups in Virtual Private Cloud API Reference.

If a security group is specified both in the AS configuration and AS group, scaled ECS instances will be added to the security group specified in the AS configuration. If a security group is not specified in either of them, scaled ECS instances will be added to the default security group. For your convenience, you are advised to specify the security group in the AS configuration.

server_group_id

No

String

Specifies the ECS group ID. For how to obtain an ECS group ID, see Querying ECS Groups.

tenancy

No

String

Specifies that ECSs are created on DeHs. Options:

• dedicated: Specifies that ECSs are created on DeHs.
• This parameter is not specified.

dedicated_host_id

No

String

Specifies the ID of a DeH.

multi_flavor_priority_policy

No

String

Specifies the priority policy used when there are multiple flavors and instances to be created using an AS configuration.

• PICK_FIRST (default): When an ECS is added for capacity expansion, the target flavor is determined in the order in the flavorRef list.
• COST_FIRST: When an ECS is added for capacity expansion, the target flavor is determined for minimal expenses.

market_type

No

String

Specifies a billing mode for an ECS. The options are as follows:

• Pay-per-use, which is not specified
• Spot pricing