PrepareUpgrade - Hologres - Alibaba Cloud Documentation Center

Mempersiapkan instance untuk pemutakhiran dengan menjalankan penilaian pra-pemutakhiran. Anda hanya dapat memutakhirkan instance jika penilaian berhasil. Jika gagal, hubungi dukungan teknis untuk pemutakhiran manual.

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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Sintaks permintaan

POST /api/v1/instances/{instanceId}/upgrade/prepare HTTP/1.1

Path Parameters

Parameter	Type	Required	Description	Example
instanceId	string	No	ID instance.	hgpostcn-cn-nwy3e6yxxx

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID region.	cn-shenzhen
body	object	No	Isi permintaan.
version	string	No	Versi target untuk pemutakhiran. Panggil operasi ListUpgradeReleaseVersion untuk mendapatkan daftar versi yang tersedia.	r5.0.0
dryRun	boolean	No	Parameter ini sudah tidak digunakan lagi.	true

Elemen respons

Element	Type	Description	Example
	object	Struktur data respons.
RequestId	string	ID permintaan.	77B97AFB-7C9D-50FF-A72D-F13FD73E49D8
Data	object	Parameter respons.
Success	boolean	Menunjukkan apakah tugas persiapan berhasil dimulai.	true
FailReason	string	Alasan kegagalan tugas persiapan.	null
ReasonKey	string	Kunci yang mengidentifikasi alasan kegagalan.	null
Success	boolean	Menunjukkan apakah panggilan API berhasil. Ini tidak menunjukkan hasil dari persiapan pemutakhiran.	true
ErrorCode	string	Kode kesalahan yang dikembalikan jika permintaan gagal.	null
ErrorMessage	string	Pesan kesalahan yang dikembalikan jika permintaan gagal.	null
HttpStatusCode	string	Kode status HTTP.	200

Contoh

Respons sukses

JSONformat

{
  "RequestId": "77B97AFB-7C9D-50FF-A72D-F13FD73E49D8",
  "Data": {
    "Success": true,
    "FailReason": "null\n",
    "ReasonKey": "null"
  },
  "Success": true,
  "ErrorCode": "null",
  "ErrorMessage": "null",
  "HttpStatusCode": "200"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.