ResetDisks - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengembalikan satu atau beberapa cloud disk menggunakan snapshot instans.

Deskripsi operasi

Operasi ini tidak digunakan lagi. Gunakan ResetDisk untuk mengembalikan cloud disk. Sebelum memanggil operasi ini, pastikan Instans ECS tempat cloud disk yang akan dikembalikan tersambung berada dalam status Stopped.

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:ResetDisks

update

*Disk.

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

*Snapshot.

acs:ecs:{#regionId}:{#accountId}:snapshot/{#snapshotId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah. Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
DryRun	boolean	No	Apakah akan menjalankan dry run pada permintaan. Nilai valid: true: Menjalankan dry run tanpa mengembalikan cloud disk. Sistem memeriksa apakah parameter wajib telah ditentukan, format permintaan, dan batas status Sumber daya. Jika permintaan gagal dalam pemeriksaan, Paket error yang sesuai akan dikembalikan. Jika permintaan lulus pemeriksaan, kode kesalahan DryRunOperation akan dikembalikan. false: Menjalankan permintaan standar. Setelah permintaan lulus pemeriksaan, sistem akan mengembalikan cloud disk. Nilai default: false.	false
Disk	array<object>	Yes	Daftar cloud disk.
	object	No
SnapshotId	string	No	ID snapshot yang sesuai dengan cloud disk tertentu dalam snapshot instans. Nilai valid untuk N: 1 hingga 10.	s-j6cdofbycydvg7ey****
DiskId	string	No	ID cloud disk yang akan dikembalikan. Nilai valid untuk N: 1 hingga 10.	d-j6cf7l0ewidb78lq****

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	3D66C85C-AA97-4A00-B0ED-2D9A80FE782C
OperationProgressSet	object
OperationProgress	array<object>	Kumpulan informasi status operasi saat mengembalikan satu atau beberapa cloud disk.
	array<object>
ErrorMsg	string	Paket error. Nilai kosong dikembalikan jika rollback berhasil. Untuk informasi lebih lanjut mengenai kode kesalahan dan Paket error, lihat Error Center.	testErrorMsg
ErrorCode	string	Kode kesalahan. Nilai kosong dikembalikan jika rollback berhasil. Untuk informasi lebih lanjut mengenai kode kesalahan dan Paket error, lihat Error Center.	400
OperationStatus	string	Apakah operasi berhasil. Jika operasi berhasil, Success dikembalikan. Jika operasi gagal, informasi ErrorCode dan ErrorMsg dikembalikan.	Success
RelatedItemSet	object
RelatedItem	array<object>	Informasi Sumber daya.
	object
Name	string	Nama Sumber daya.	SnapshotId
Value	string	ID Sumber daya.	s-j6cdofbycydvg7ey****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "3D66C85C-AA97-4A00-B0ED-2D9A80FE782C",
  "OperationProgressSet": {
    "OperationProgress": [
      {
        "ErrorMsg": "testErrorMsg",
        "ErrorCode": "400",
        "OperationStatus": "Success",
        "RelatedItemSet": {
          "RelatedItem": [
            {
              "Name": "SnapshotId",
              "Value": "s-j6cdofbycydvg7ey****"
            }
          ]
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	DiskCategory.OperationNotSupported	The operation is not supported to the specified disk due to its disk category.	Tipe disk saat ini tidak mendukung operasi ini.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.
400	DryRunOperation	Request validation has been passed with DryRun flag set.	Pemeriksaan DryRun berhasil. Permintaan Anda telah divalidasi.
500	InternalError	The request processing has failed due to some unknown error.
403	IncorrectDiskStatus	The current disk status does not support this operation.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	InstanceLockedForSecurity	The instance is locked due to security.	Instans tempat disk menyambungkan terkunci karena alasan keamanan.
403	InvalidParameter.Mismatch	The specified snapshot is not created from the specified disk.
403	InvalidSnapshot.TooOld	The snapshot was created before 2013-07-15 and cannot be restored since the disk was first detached.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	OperationDenied	The specified snapshot dees not support ResetDisk.
403	InvalidSnapshotId.NotReady	The specified snapshot has not completed yet.
403	InvalidAccountStatus.NotEnoughBalance	Your account does not have enough balance.
403	InvalidAccountStatus.SnapshotServiceUnavailable	Snapshot service has not been opened yet.	Layanan snapshot tidak diaktifkan. Operasi tidak dapat dilakukan.
403	Operation.Conflict	The operation may conflict with others. Please retry later.
403	UserNotInTheWhiteList	The user is not in disk white list.	Pengguna tidak berada dalam daftar putih Shared Block Storage. Kirim tiket untuk mengajukan permohonan masuk daftar putih.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK has not authorized the ECS service to perform the KMS TagResource and UntagResource operations. Please verify the authorization and try again.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
403	IncorrectDiskStatus.HasUnfinishedSnapshot	The current disk has unfinished snapshot.	Disk yang ditentukan memiliki snapshot yang tidak lengkap.
403	InvalidRegion.NotSupport	The specified region does not support resetting disks.
403	InvalidOperation.MultiAttachDisk	Multi attach disk does not support this operation.	Disk dengan menyambungkan multi diaktifkan tidak mendukung operasi ini.
403	InvalidDisk.ShareVolume	The specified diskId is invalid. The shared volume does not support creating a snapshot group.	diskId yang ditentukan tidak valid. Disk bersama tidak mendukung pembuatan grup snapshot yang konsisten.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Disk yang ditentukan tidak ada. Periksa apakah ID disk sudah benar.
404	Disk.NotFound	The specified disk does not exist.	Disk yang ditentukan tidak ada. Periksa apakah disk sudah benar.
404	InvalidSnapshotId.NotFound	The specified SnapshotId does not exist.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Instans yang ditentukan tidak ada. Periksa apakah ID instans benar.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	RegionId yang ditentukan tidak ada. Periksa apakah produk ini tersedia di wilayah yang ditentukan.
404	InvalidSnapshot.NotFound	The SnapshotId provided does not exist in our records.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.