ModifyDedicatedHostsChargeType -

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyDedicatedHostsChargeType	The operation that you want to perform. Set the value to ModifyDedicatedHostsChargeType.
DedicatedHostIds	String	Yes	["dh-bp181e5064b5sotr**","dh-bp18064b5sotrr9c**"]	The IDs of dedicated hosts. The value can be a JSON array that consists of up to 20 dedicated host IDs. Separate the dedicated host IDs with commas (,).
RegionId	String	Yes	cn-hangzhou	The region ID of the dedicated host. You can call the DescribeRegions operation to query the most recent region list.
Period	Integer	No	1	The renewal duration of the subscription dedicated host. Valid values: When `PeriodUnit` is set to Week, valid values of `Period` are 1, 2, 3, and 4. When `PeriodUnit` is set to Month, valid values of `Period` are 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, and 60.
PeriodUnit	String	No	Month	The unit of the renewal duration (`Period`). Valid values: Week Month Default value: Month.
DryRun	Boolean	No	false	Specifies whether to check the validity of the request without actually making the request. Valid values: true: The validity of the request is checked but the request is not made. Check items include whether your AccessKey pair is valid, whether RAM users are granted required permissions, and whether the required parameters are specified. If the check fails, the corresponding error is returned. If the check succeeds, the `DryRunOperation` error code is returned. false: The validity of the request is checked. If the check succeeds, a 2XX HTTP status code is returned, and the request is made. Default value: false.
AutoPay	Boolean	No.	false	Specifies whether to enable automatic payment. Valid values: true: enables automatic payment. Make sure that your account balance is sufficient. Otherwise, your order becomes invalid and must be canceled. false: An order is generated but no payment is made. Default value: true. Note If your account balance is insufficient, you can set the `AutoPay` parameter to `false` to generate an unpaid order. Then, you can pay for the order.
DedicatedHostChargeType	String	No	PrePaid	The new billing method for the dedicated host. Valid values: PrePaid: changes the billing method from pay-as-you-go to subscription. PostPaid: changes the billing method from subscription to pay-as-you-go. Default value: PrePaid.
ClientToken	String	No	e4567-e89b-12d3-a456-426655440000	The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must make sure that the value is unique among different requests. The `ClientToken` value can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence.
DetailFee	Boolean	No	false	Specifies whether to return the billing details of the order when the billing method is changed from subscription to pay-as-you-go. Default value: false.

Response parameters


Parameter	Type	Example	Description
OrderId	String	20413515388****	The ID of the order.
RequestId	String	B61C08E5-403A-46A2-96C1-F7B1216DB10C	The ID of the request.
FeeOfInstances	Array of FeeOfInstance		Details about the charges for the order.
FeeOfInstance
InstanceId	String	dh-bp181e5064b5sotrr****	The ID of the dedicated host.
Currency	String	CNY	The unit of currency for the bill. Alibaba Cloud China site (aliyun.com): CNY. Alibaba Cloud International site (alibabacloud.com): USD.
Fee	String	0	The cost value.

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=ModifyDedicatedHostsChargeType
&RegionId=cn-hangzhou
&DedicatedHostIds=["dh-bp181e5064b5sotr****","dh-bpe5064b5sotrr9c****"]
&Period=1
&PeriodUnit=Month
&AutoPay=false
&ClientToken=e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Sample success response

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyDedicatedHostsChargeTypeResponse>
    <RequestId>B61C08E5-403A-46A2-96C1-F7B1216DB10C</RequestId>
    <OrderId>20413515388****</OrderId>
    <FeeOfInstances>
        <FeeOfInstance>
            <Fee>0</Fee>
            <InstanceId>dh-bp181e5064b5sotr****</InstanceId>
            <Currency>CNY</Currency>
        </FeeOfInstance>
        <FeeOfInstance>
            <Fee>0</Fee>
            <InstanceId>dh-bp181e5064b5sotr****</InstanceId>
            <Currency>CNY</Currency>
        </FeeOfInstance>
    </FeeOfInstances>
</ModifyDedicatedHostsChargeTypeResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "B61C08E5-403A-46A2-96C1-F7B1216DB10C",
  "OrderId" : "20413515388****",
  "FeeOfInstances" : {
    "FeeOfInstance" : [ {
      "Fee" : "0",
      "InstanceId" : "dh-bp181e5064b5sotr****",
      "Currency" : "CNY"
    }, {
      "Fee" : "0",
      "InstanceId" : "dh-bp181e5064b5sotr****",
      "Currency" : "CNY"
    } ]
  }
}

Error codes


HTTP status code	Error code	Error message	Description
400	InvalidParameter.InstanceIds	The specified InstanceIds are invalid.	The error message returned because the specified InstanceIds parameter is invalid.
400	InvalidParameter	%s	The error message returned because a specified parameter is invalid.
400	InvalidStatus.ValueNotSupported	%s	The error message returned because the operation is not supported while the resource is in the current state.
400	InvalidInstanceChargeType.ValueNotSupported	%s	The error message returned because the specified DedicatedHostChargeType parameter is invalid.
400	ExpiredInstance	The specified instance has expired.	The error message returned because the specified instance has expired.
400	InstancesIdQuotaExceed	The maximum number of Instances is exceeded.	The error message returned because the maximum number of instances has been reached.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	The error message returned because the specified ClientToken parameter is invalid.
400	ReleaseTimeHaveBeenSet	The specified instance has been set released time.	The error message returned because an automatic release time has been set for the specified instance.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	The error message returned because your request is throttled. Try again 5 minutes later.
400	Throttling	%s	The error message returned because the request is denied due to throttling.
400	QuotaExceed.AfterpayInstance	The maximum number of Pay-As-You-Go instances is exceeded: %s	The error message returned because resources are insufficient to create pay-as-you-go instances of the specified instance type. Reduce the number of instances to be created.
400	QuotaExceed.RufundVcpu	The maximum number of refund vcpu is exceeded: %s	The error message returned because the number of vCPUs that is used to calculate the refund amount exceeds the upper limit. For more information about the limit, see the return value of the %s placeholder in the error message.
400	InvalidPeriod.UnitMismatch	The specified Period must be correlated with the PeriodUnit.	The error message returned because the specified value of Period falls outside the valid value range determined by the PeriodUnit parameter.
400	InvalidImageType.NotSupported	%s	The error message returned because the specified image type is invalid. Check whether this image type is supported in the region.
400	InvalidSystemDiskCategory.ValueNotSupported	%s	The error message returned because the operation is not applicable to the specified system disk category.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	The error message returned because an internal error has occurred. Try again later.
500	InternalError	The request processing has failed due to some unknown error.	The error message returned because an internal error has occurred. Try again later.
403	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	The error message returned because the specified instance type does not exist or because you are not authorized to manage instances of the specified instance type.
403	InstanceType.Offline	%s	The error message returned because the operation is not supported while the instance type is retired or while resources of the instance type are insufficient.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	The error message returned because your account balance is insufficient. Add funds to your account and try again.
403	Account.Arrearage	Your account has an outstanding payment.	The error message returned because your account has unpaid orders.
403	InvalidParameter.NotMatch	%s	The error message returned because a specified parameter is invalid. Check whether parameter conflicts exist.
403	InvalidAction	%s	The error message returned because the operation is invalid.
403	QuotaExceed.PostPaidDisk	Living postPaid disks quota exceeded.	The error message returned because the maximum number of pay-as-you-go disks has been reached.
403	ImageNotSupportInstanceType	The specified instanceType is not supported by instance with marketplace image.	The error message returned because the specified Alibaba Cloud Marketplace image does not support the instance type.
403	InvalidInstanceType.PhasedOut	This instanceType is no longer offered.	The error message returned because the specified instance type is retired.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.	The error message returned because you have not completed real-name verification. Complete real-name verification and try again.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.	The error message returned because the specified instance does not exist.

For a list of error codes, visit the API Error Center.