Domain name for API request: as.tencentcloudapi.com.
This API (ModifyLaunchConfigurationAttributes) is used to modify some attributes of a launch configuration.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
Parameter Name | Required | Type | Description |
---|---|---|---|
Action | Yes | String | Common Params. The value used for this API: ModifyLaunchConfigurationAttributes. |
Version | Yes | String | Common Params. The value used for this API: 2018-04-19. |
Region | No | String | Common Params. This parameter is not required for this API. |
LaunchConfigurationId | Yes | String | Launch configuration ID |
ImageId | No | String | Image ID in the format of img-xxx . There are three types of images: You can obtain the image IDs in the CVM console. ImageId in the response. |
InstanceTypes.N | No | Array of String | List of instance types. Each type specifies different resource specifications. This list contains up to 10 instance types. The launch configuration uses InstanceType to indicate one single instance type and InstanceTypes to indicate multiple instance types. Specifying the InstanceTypes field will invalidate the original InstanceType . |
InstanceTypesCheckPolicy | No | String | Instance type verification policy which works when InstanceTypes is actually modified. Value range: ALL, ANY. Default value: ANY. Common reasons why an instance type is unavailable include stock-out of the instance type or the corresponding cloud disk. If a model in InstanceTypes does not exist or has been discontinued, a verification error will be reported regardless of the value of InstanceTypesCheckPolicy. |
LaunchConfigurationName | No | String | Display name of the launch configuration, which can contain Chinese characters, letters, numbers, underscores, separators ("-"), and decimal points with a maximum length of 60 bytes. |
UserData | No | String | Base64-encoded custom data of up to 16 KB. If you want to clear UserData , set it to an empty string. |
SecurityGroupIds.N | No | Array of String | Security group to which the instance belongs. This parameter can be obtained from the SecurityGroupId field in the response of the DescribeSecurityGroups API.At least one security group is required for this parameter. The security group specified is sequential. |
InternetAccessible | No | InternetAccessible | Information of the public network bandwidth configuration. When the public outbound network bandwidth is 0 Mbps, assigning a public IP is not allowed. Accordingly, if a public IP is assigned, the new public network outbound bandwidth must be greater than 0 Mbps. |
InstanceChargeType | No | String | Instance billing mode. Valid values: |
InstanceChargePrepaid | No | InstanceChargePrepaid | Parameter setting for the prepaid mode (monthly subscription mode). This parameter can specify the renewal period, whether to set the auto-renewal, and other attributes of the monthly-subscribed instances. This parameter is required when changing the instance billing mode to monthly subscription. It will be automatically discarded after you choose another billing mode. This field requires passing in the Period field. Other fields that are not passed in will use their default values.This field can be modified only when the current billing mode is monthly subscription. |
InstanceMarketOptions | No | InstanceMarketOptionsRequest | Market-related options for instances, such as parameters related to spot instances. This parameter is required when changing the instance billing mode to spot instance. It will be automatically discarded after you choose another instance billing mode. This field requires passing in the MaxPrice field under the SpotOptions . Other fields that are not passed in will use their default values.This field can be modified only when the current billing mode is spot instance. |
DiskTypePolicy | No | String | Selection policy of cloud disks. Default value: ORIGINAL. Valid values: |
SystemDisk | No | SystemDisk | Instance system disk configurations |
DataDisks.N | No | Array of DataDisk | Configuration information of instance data disks. Up to 11 data disks can be specified and will be collectively modified. Please provide all the new values for the modification. The default data disk should be the same as the system disk. |
HostNameSettings | No | HostNameSettings | CVM hostname settings. This field is not supported for Windows instances. This field requires passing the HostName field. Other fields that are not passed in will use their default values. |
InstanceNameSettings | No | InstanceNameSettings | Settings of CVM instance names. If this field is configured in a launch configuration, the InstanceName of a CVM created by the scaling group will be generated according to the configuration; otherwise, it will be in the as-{{AutoScalingGroupName }} format.This field requires passing in the InstanceName field. Other fields that are not passed in will use their default values. |
EnhancedService | No | EnhancedService | Specifies whether to enable additional services, such as security services and monitoring service. |
CamRoleName | No | String | CAM role name. This parameter can be obtained from the roleName field returned by DescribeRoleList API. |
HpcClusterId | No | String | HPC ID Note: This field is default to empty |
IPv6InternetAccessible | No | IPv6InternetAccessible | IPv6 public network bandwidth configuration. If the IPv6 address is available in the new instance, public network bandwidth can be allocated to the IPv6 address. This parameter is invalid if Ipv6AddressCount of the scaling group associated with the launch configuration is 0. |
DisasterRecoverGroupIds.N | No | Array of String | Placement group ID. Only one is allowed. |
LoginSettings | No | LoginSettings | Instance login settings, which include passwords, keys, or the original login settings inherited from the image. Please note that specifying new login settings will overwrite the existing ones. For instance, if you previously used a password for login and then use this parameter to switch the login settings to a key, the original password will be removed. |
Parameter Name | Type | Description |
---|---|---|
RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
This example shows you how to modify the image name to img-8toqc6s3
, modify the instance type to S2.SMALL1
, and modify the launch configuration name to updated_config
for the specified launch configuration asc-291kq6ku
.
POST / HTTP/1.1
Host: as.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyLaunchConfigurationAttributes
<Common request parameters>
{
"ImageId": "img-8toqc6s3",
"InstanceTypes": [
"S2.SMALL1"
],
"LaunchConfigurationName": "updated_config",
"LaunchConfigurationId": "asc-291kq6ku"
}
{
"Response": {
"RequestId": "07022dcb-5bba-48f0-a2b0-800ad006d031"
}
}
UserData
This example shows you how to modify UserData
to an empty string for the specified launch configuration asc-291kq6ku
.
POST / HTTP/1.1
Host: as.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyLaunchConfigurationAttributes
<Common request parameters>
{
"LaunchConfigurationId": "asc-291kq6ku",
"UserData": ""
}
{
"Response": {
"RequestId": "2c027f22-3a3b-489a-a77a-89c53fc15212"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
Error Code | Description |
---|---|
InternalError.CalleeError | Exceptions occurred while invoking other services. |
InvalidParameter.ActionNotFound | Invalid Action request. |
InvalidParameter.Conflict | Multiple parameters specified conflict and cannot co-exist. |
InvalidParameter.HostNameUnavailable | The hostname parameter is unavailable to this image. |
InvalidParameter.InScenario | The parameter is invalid in a specific scenario. |
InvalidParameter.InvalidCombination | Invalid parameter combination. |
InvalidParameter.ParameterDeprecated | This parameter has been disused. |
InvalidParameter.ParameterMustBeDeleted | Some parameters cannot coexist and should be deleted. |
InvalidParameterValue | Wrong parameter value. |
InvalidParameterValue.AccountNotSupportBandwidthPackageId | The bandwidth package ID is not supported in this account. |
InvalidParameterValue.CvmConfigurationError | Exception with CVM parameter validation. |
InvalidParameterValue.HostNameIllegal | Invalid hostname |
InvalidParameterValue.IPv6InternetChargeType | The specified IPv6 public network bandwidth billing mode is invalid. |
InvalidParameterValue.ImageNotFound | The specified image does not exist. |
InvalidParameterValue.InstanceNameIllegal | Invalid instance name |
InvalidParameterValue.InstanceTypeNotSupported | The instance type is not supported. |
InvalidParameterValue.InvalidDisasterRecoverGroupId | The format of the placement group ID is incorrect. |
InvalidParameterValue.InvalidHpcClusterId | The HPC ID is invalid. |
InvalidParameterValue.InvalidImageId | Invalid image ID. |
InvalidParameterValue.InvalidInstanceType | Invalid instance type. |
InvalidParameterValue.InvalidLaunchConfigurationId | Invalid launch configuration ID. |
InvalidParameterValue.InvalidSecurityGroupId | Invalid security group ID. |
InvalidParameterValue.LaunchConfigurationNameDuplicated | The launch configuration name already exists. |
InvalidParameterValue.LimitExceeded | The value exceeds the limit. |
InvalidParameterValue.MissingBandwidthPackageId | The bandwidth package ID is required. |
InvalidParameterValue.NotStringTypeFloat | The value should be a floating point string. |
InvalidParameterValue.TooLong | Too many values. |
InvalidParameterValue.TooShort | The value of input parameter is too short. |
InvalidParameterValue.UserDataFormatError | Incorrect UserData format. |
InvalidParameterValue.UserDataSizeExceeded | The UserData is too long. |
MissingParameter | Parameter missing. |
MissingParameter.InScenario | A parameter is missing in a specific scenario. |
ResourceNotFound.BandwidthPackageIdNotFound | The specified bandwidth package ID is not found. |
ResourceNotFound.DisasterRecoverGroupNotFound | The specified placement group ID does not exist. |
ResourceNotFound.LaunchConfigurationIdNotFound | The specified launch configuration does not exist. |
Was this page helpful?