ModifyDedicatedHostsChargeType - Elastic Compute Service

Mengubah metode penagihan host khusus.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:ModifyDedicatedHostsChargeType

update

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
DedicatedHostIds	string	Yes	ID host khusus. Nilai dapat berupa array JSON yang terdiri dari hingga 20 ID host khusus. Pisahkan ID dengan koma (,).	["dh-bp181e5064b5sotr**","dh-bp18064b5sotrr9c**"]
RegionId	string	Yes	ID wilayah host khusus. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
Period	integer	No	Periode perpanjangan langganan. Nilai valid: Jika `PeriodUnit` diatur ke `Week`, nilai valid `Period` adalah 1, 2, 3, dan 4. Jika `PeriodUnit` diatur ke `Month`, nilai valid `Period` adalah 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, dan 60.	1
PeriodUnit	string	No	Unit periode perpanjangan, yang merupakan unit parameter `Period`. Nilai valid: Week Month Nilai default: Month.	Month
DryRun	boolean	No	Apakah akan menjalankan dry run. Nilai valid: true: Menjalankan dry run. Sistem memeriksa permintaan untuk potensi masalah, termasuk pasangan AccessKey yang tidak valid, pengguna RAM yang tidak diotorisasi, dan nilai parameter yang hilang. Jika pemeriksaan gagal, kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan `DryRunOperation` akan dikembalikan. false: Mengirim permintaan normal. Jika pemeriksaan berhasil, kode status HTTP 2xx akan dikembalikan dan operasi akan dijalankan. Nilai default: false.	false
AutoPay	boolean	No	Apakah akan mengaktifkan pembayaran otomatis. Nilai valid: true: Pembayaran otomatis diaktifkan. Pastikan saldo akun Anda mencukupi. Jika saldo akun tidak mencukupi, pesanan abnormal akan dibuat. Anda hanya dapat membatalkan pesanan abnormal tersebut. false: Pesanan dibuat tetapi pembayaran tidak dilakukan. Nilai default: true. Catatan Jika metode pembayaran Anda memiliki saldo yang tidak mencukupi, atur `AutoPay` ke `false`. Pesanan yang belum dibayar akan dibuat, dan Anda dapat membayarnya secara manual.	false
DedicatedHostChargeType	string	No	Metode penagihan baru host khusus. Nilai valid: PrePaid: Mengubah metode penagihan dari pay-as-you-go menjadi langganan. PostPaid: Mengubah metode penagihan dari langganan menjadi pay-as-you-go. Nilai default: PrePaid.	PrePaid
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. Nilai `ClientToken` hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat How to ensure idempotence.	e4567-e89b-12d3-a456-426655440000
DetailFee	boolean	No	Apakah akan mengembalikan detail penagihan pesanan ketika metode penagihan diubah dari langganan menjadi pay-as-you-go. Nilai default: false.	false

Elemen respons

Element	Type	Description	Example
	object
OrderId	string	ID pesanan. Parameter ini hanya dikembalikan ketika metode penagihan diubah menjadi langganan.	20413515388****
RequestId	string	ID permintaan.	B61C08E5-403A-46A2-96C1-F7B1216DB10C
FeeOfInstances	object
FeeOfInstance	array<object>	Detail penagihan pesanan.
	object
InstanceId	string	The IDs of the dedicated hosts.	dh-bp181e5064b5sotrr****
Currency	string	The unit of currency for the bill. Alibaba Cloud China site (aliyun.com): CNY Alibaba Cloud International site (alibabacloud.com): USD	CNY
Fee	string	The charged amount.	0

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidParameter.InstanceIds	The specified InstanceIds are invalid.
400	InvalidParameter	%s
400	InvalidStatus.ValueNotSupported	%s
400	InvalidInstanceChargeType.ValueNotSupported	%s
400	InvalidSpotStrategy	The specified spotStrategy is not valid.
400	ExpiredInstance	The specified instance has expired.
400	InstancesIdQuotaExceed	The maximum number of Instances is exceeded.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.
400	InvalidInstance.UnpaidOrder	The specified instance has unpaid order.
400	ReleaseTimeHaveBeenSet	The specified instance has been set released time.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.
400	InvalidPeriod.UnitMismatch	The specified Period must be correlated with the PeriodUnit.
400	InvalidImageType.NotSupported	%s
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
400	InvalidSystemDiskCategory.ValueNotSupported	%s
400	InvalidAccountStatus.PayAmountLimitExceeded	Your account is being restricted, due to no default payment method is set or you has not being authorized.
400	QuotaExceed.AfterpayInstance	The maximum number of Pay-As-You-Go instances is exceeded.
400	QuotaExceed.RufundVcpu	The maximum number of refunded vcpu is exceeded: %s .
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
403	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.
403	InstanceType.Offline	%s
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	Account.Arrearage	Your account has an outstanding payment.
403	InvalidParameter.NotMatch	%s
403	InvalidAction	%s
403	QuotaExceed.PostPaidDisk	Living postPaid disks quota exceeded.
403	ImageNotSupportInstanceType	The specified instanceType is not supported by instance with marketplace image.
403	InvalidInstanceType.PhasedOut	This instanceType is no longer offered.
403	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.
403	InvalidOperation.NotSupport	Instance on dedicated host not support modify charge type.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.
404	InvalidDedicatedHostId.NotFound	The specified Dedicated Host does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.