ModifyInstanceChargeType - - Alibaba Cloud Documentation Center

Mengubah metode penagihan satu atau beberapa instance Elastic Compute Service (ECS). Anda dapat mengubah metode penagihan instans antara pay-as-you-go dan subscription, atau mengubah metode penagihan semua disk data yang terpasang pada suatu instans dari pay-as-you-go menjadi subscription.

Catatan penggunaan

Sebelum memanggil operasi ini, pastikan Anda memahami metode penagihan dan jadwal harga ECS. Untuk informasi lebih lanjut, kunjungi halaman produk Elastic Compute Service.

Perhatikan hal-hal berikut:

Instans harus berada dalam status Running (Running) atau Stopped (Stopped), dan Anda tidak memiliki pembayaran tertunda untuk instans tersebut.
Setelah Anda mengubah metode penagihan, pembayaran akan diselesaikan secara otomatis. Pastikan saldo akun mencukupi. Jika tidak, pesanan Anda menjadi tidak valid dan harus dibatalkan. Jika saldo akun tidak mencukupi, Anda dapat mengatur AutoPay ke false untuk menghasilkan pesanan yang belum dibayar. Kemudian, Anda dapat login ke ECS console untuk membayar pesanan tersebut.
Mengubah metode penagihan dari subscription ke pay-as-you-go:
- Penggunaan ECS Anda menentukan apakah metode penagihan suatu instans dapat diubah dari subscription ke pay-as-you-go.
- Setelah Anda mengubah metode penagihan instans dari subscription ke pay-as-you-go, metode penagihan baru berlaku selama sisa siklus hidup instans tersebut. Selisih harga dikembalikan ke akun pembayaran yang Anda gunakan. Voucher yang telah ditukarkan tidak dapat dikembalikan.
- Aturan pengembalian dana: Anda memiliki kuota total pengembalian dana setiap bulan, dan sisa kuota yang tidak terpakai tidak dapat dialihkan ke bulan berikutnya. Setelah kuota pengembalian dana bulan ini habis, Anda hanya dapat mengubah metode penagihan pada bulan berikutnya. Jumlah pengembalian dana yang timbul saat Anda mengubah metode penagihan dihitung berdasarkan rumus berikut: Jumlah vCPU × (Jumlah hari tersisa × 24 ± Jumlah jam tersisa atau yang telah berlalu).
Mengubah metode penagihan dari pay-as-you-go ke subscription:
- Anda dapat mengubah metode penagihan semua disk data yang terpasang pada suatu instans dari pay-as-you-go menjadi subscription.
- Operasi ini tidak dapat dipanggil untuk instans pay-as-you-go yang telah diatur waktu rilis otomatisnya.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	ModifyInstanceChargeType	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke ModifyInstanceChargeType.
InstanceIds	String	Yes	["i-bp67acfmxazb4p**","i-bp67acfmxazb4d**"]	ID instans. Nilainya dapat berupa array JSON yang terdiri dari maksimal 20 ID instans. Pisahkan ID instans dengan koma (,).
RegionId	String	Yes	cn-hangzhou	ID wilayah instans. Anda dapat memanggil operasi DescribeRegions untuk mengambil daftar wilayah terbaru.
Period	Integer	No	1	Durasi perpanjangan instans subscription. Jika instans di-host pada dedicated host, durasi perpanjangan instans tersebut tidak boleh melebihi durasi langganan dedicated host tersebut. Nilai yang valid: Nilai yang valid saat `PeriodUnit` diatur ke Month: `1, 2, 3, 4, 5, 6, 7, 8, 9, dan 12`.
PeriodUnit	String	No	Month	Unit durasi perpanjangan (`Period`). Nilai yang valid: Month Nilai default: Month.
IncludeDataDisks	Boolean	No	false	Menentukan apakah akan mengubah metode penagihan semua disk data pada instans dari pay-as-you-go menjadi subscription. true false Nilai default: false.
DryRun	Boolean	No	false	Menentukan apakah hanya melakukan dry run tanpa menjalankan permintaan sebenarnya. Nilai yang valid: true: hanya melakukan dry run. Sistem memeriksa Pasangan Kunci Akses, izin Pengguna RAM, dan parameter yang diperlukan. Jika permintaan gagal dalam dry run, pesan kesalahan dikembalikan. Jika permintaan lolos dry run, kode kesalahan `DryRunOperation` dikembalikan. false: melakukan dry run dan menjalankan permintaan sebenarnya. Jika permintaan lolos dry run, kode status HTTP 2xx dikembalikan dan operasi dilaksanakan. Nilai default: false.
AutoPay	Boolean	No	false	Menentukan apakah pembayaran diselesaikan secara otomatis. Nilai yang valid: true: Pembayaran diselesaikan secara otomatis. Pastikan saldo akun mencukupi. Jika tidak, pesanan Anda menjadi tidak valid dan dibatalkan. false: Pesanan dihasilkan tetapi tidak ada pembayaran yang dilakukan. Nilai default: true. Catatan Jika saldo akun Anda tidak mencukupi, Anda dapat mengatur AutoPay ke false untuk menghasilkan pesanan yang belum dibayar. Kemudian, Anda dapat login ke ECS console untuk membayar pesanan tersebut.
InstanceChargeType	String	No	PrePaid	Metode penagihan baru. Nilai yang valid: PrePaid: subscription PostPaid: pay-as-you-go Nilai default: PrePaid.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. token hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat How to ensure idempotence.
IsDetailFee	Boolean	No	false	Menentukan apakah akan mengembalikan rincian biaya pesanan setelah metode penagihan diubah dari subscription ke pay-as-you-go. Nilai yang valid: true false Nilai default: false.

Parameter respons

Parameter	Type	Example	Description
OrderId	String	20413515388****	ID pesanan.
RequestId	String	B61C08E5-403A-46A2-96C1-F7B1216DB10C	ID permintaan.
FeeOfInstances	Array of FeeOfInstance		Rincian biaya pesanan.
FeeOfInstance
InstanceId	String	i-bp67acfmxazb4p****	ID instans.
Currency	String	CNY	Unit mata uang untuk tagihan. Situs Alibaba Cloud China (aliyun.com): CNY. Situs Internasional Alibaba Cloud (alibabacloud.com): USD.
Fee	String	0	Nilai biaya.

Contoh

Contoh permintaan

http(s)://ecs.aliyuncs.com/?Action=ModifyInstanceChargeType
&RegionId=cn-hangzhou
&InstanceIds=["i-bp67acfmxazb4p****","i-bp67acfmxazb4d****"]
&Period=1
&PeriodUnit=Month
&AutoPay=false
&IncludeDataDisks=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Contoh respons sukses

XML format

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

<ModifyInstanceChargeTypeResponse>
    <OrderId>20413515388****</OrderId>
    <RequestId>B61C08E5-403A-46A2-96C1-F7B1216DB10C</RequestId>
    <FeeOfInstances>
        <InstanceId>i-bp67acfmxazb4p****</InstanceId>
        <Currency>CNY</Currency>
        <Fee>0</Fee>
    </FeeOfInstances>
</ModifyInstanceChargeTypeResponse>

JSON format

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

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

Kode kesalahan

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	InvalidParameter.InstanceIds	The specified InstanceIds are invalid.	Nilai InstanceIds tidak valid.
400	InvalidParameter	%s	Parameter tidak valid.
400	InvalidStatus.ValueNotSupported	%s	Operasi ini tidak dapat dilakukan pada resource dalam status saat ini.
400	InvalidInstanceChargeType.ValueNotSupported	%s	Nilai InstanceChargeType tidak valid.
400	ExpiredInstance	The specified instance has expired.	Instans yang ditentukan telah kedaluwarsa.
400	InstancesIdQuotaExceed	The maximum number of Instances is exceeded.	Jumlah maksimum instans telah terlampaui.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	Nilai ClientToken tidak valid.
400	InvalidInternetChargeType.ValueNotSupported	%s	Nilai InternetChargeType tidak valid.
400	ReleaseTimeHaveBeenSet	The specified instance has been set released time.	Waktu rilis otomatis telah diatur untuk instans yang ditentukan.
400	Throttling	Request was denied due to request throttling, please try again after 5 minutes.	Permintaan Anda ditolak karena pembatasan kecepatan. Coba lagi 5 menit kemudian.
400	Throttling	%s	Permintaan ditolak karena pembatasan kecepatan.
400	InvalidParameter.Bandwidth	%s	Bandwidth tidak valid. Periksa nilai parameternya.
400	InvalidPeriod.UnitMismatch	The specified Period must be correlated with the PeriodUnit.	Nilai Period berada di luar rentang nilai yang ditentukan oleh parameter PeriodUnit.
400	InvalidImageType.NotSupported	%s	Jenis image tidak valid. Periksa apakah jenis image tersebut didukung di wilayah tersebut.
400	InvalidMarketImageChargeType.NotSupport	The specified chargeType of marketImage is unsupported.	Metode penagihan gambar Marketplace Alibaba Cloud tidak didukung.
400	InvalidSystemDiskCategory.ValueNotSupported	%s	Kategori disk sistem tidak mendukung operasi ini.
400	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.	Instans yang ditentukan tidak memiliki disk sistem yang terpasang. Pastikan instans yang ditentukan memiliki disk sistem yang terpasang. Anda dapat memanggil operasi DescribeInstances untuk mengambil detail instans.
400	AccountForbidden.ProductCreationLimited	The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.	Pengguna internal hanya dapat membeli instans ECS berbayar sesuai pemakaian. Mereka tidak dapat membeli produk pihak ketiga seperti gambar Marketplace Alibaba Cloud. Periksa parameter. Pastikan semua parameter memenuhi persyaratan dan coba lagi.
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	Operasi ini tidak dapat dilakukan saat PrivatePoolOptions.MatchCriteria diatur ke Target.
400	InvalidPeriod	The specified period is not valid.	Nilai Period tidak valid.
403	InvalidInstance.TempBandwidthUpgrade	Cannot switch to Pay-As-You-Go during the period of temporary bandwidth upgrade.	Anda tidak dapat mengubah metode penagihan instans menjadi pay-as-you-go selama periode peningkatan bandwidth sementara.
403	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	Tipe instans tidak ditemukan, atau Anda tidak memiliki otorisasi untuk mengelola instans dengan tipe tersebut.
403	InstanceType.Offline	%s	Operasi tidak dapat dilakukan saat tipe instans sudah pensiun atau stok tipe instans tidak mencukupi.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.	Saldo akun Anda tidak mencukupi. Tambahkan dana ke akun Anda dan coba lagi.
403	Account.Arrearage	Your account has an outstanding payment.	Akun Anda memiliki pesanan yang belum dibayar.
403	InvalidParameter.NotMatch	%s	Nilai parameter tidak valid. Periksa apakah terdapat konflik parameter.
403	InvalidAction	%s	Operasi tidak valid.
403	QuotaExceed.PostPaidDisk	Living postPaid disks quota exceeded.	Jumlah maksimum disk pay-as-you-go telah terlampaui.
403	ImageNotSupportInstanceType	The specified instanceType is not supported by instance with marketplace image.	Gambar Marketplace Alibaba Cloud yang ditentukan tidak mendukung tipe instans tersebut.
403	InvalidInstanceType.PhasedOut	This instanceType is no longer offered.	Tipe instans yang ditentukan sudah pensiun.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.	Anda belum menyelesaikan verifikasi nama asli. Selesaikan verifikasi nama asli dan coba lagi.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	Jumlah maksimum instans dengan tipe instans tertentu di wilayah tersebut telah terlampaui. Coba wilayah atau tipe instans lain, atau kurangi jumlah instans yang ingin Anda buat. Anda juga dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type.	Jumlah maksimum instans dengan tipe instans tertentu di wilayah tersebut telah terlampaui. Coba wilayah atau tipe instans lain, atau kurangi jumlah instans yang ingin Anda buat. Anda juga dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.
403	QuotaExceed.ElasticQuota	The number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	Jumlah maksimum vCPU untuk semua tipe instans telah terlampaui. Anda dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.
403	QuotaExceed.ElasticQuota	The number of the specified ECS instances has exceeded the quota of the specified instance type, or the number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.	Jumlah maksimum instans dengan tipe instans tertentu di wilayah tersebut, atau jumlah maksimum vCPU untuk semua tipe instans telah terlampaui. Anda dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.	ID instans yang ditentukan tidak ditemukan.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Terjadi kesalahan internal. Coba lagi nanti.
500	InternalError	The request processing has failed due to some unknown error.	Terjadi kesalahan internal. Coba lagi nanti.
500	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	Anda tidak memiliki otorisasi untuk menggunakan tipe instans tersebut.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.