DescribeHanaInstances - Cloud Backup

Mengambil satu atau beberapa instans SAP HANA yang memenuhi kondisi yang ditentukan.

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

hbr:DescribeHanaInstances

get

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
VaultId	string	No	ID dari backup vault.	v-000b0ov******6zs
ClusterId	string	No	ID dari instans SAP HANA.	cl-0001zfc******50pr3
PageNumber	integer	No	Nomor halaman. Halaman dimulai dari halaman 1. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri per halaman. Nilai valid: 1 hingga 99. Nilai default: 10.	10
Tag	array<object>	No	Tag dari instans SAP HANA.
	object	No	Tag dari instans SAP HANA.
Key	string	No	Kunci tag.	ace:rm:rgld
Value	string	No	Nilai tag.	rg-acfmwutpyat2kwy
ResourceGroupId	string	No	ID dari kelompok sumber daya.	rg-aekz24ikcjyqjkq

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	4003DD68-3C3C-5071-B4FC-631A6C1BAC1C
Success	boolean	Menunjukkan apakah permintaan berhasil. Nilai valid: true false	true
Code	string	Kode respons. Kode status 200 menunjukkan bahwa permintaan berhasil.	200
Message	string	Pesan yang dikembalikan. Jika permintaan berhasil, "successful" dikembalikan. Jika permintaan gagal, pesan error dikembalikan.	successful
PageNumber	integer	Nomor halaman. Halaman dimulai dari halaman 1. Nilai default: 1.	1
PageSize	integer	Jumlah entri per halaman. Nilai valid: 1 hingga 99. Nilai default: 10.	10
TotalCount	integer	Total jumlah entri yang dikembalikan.	21
Hanas	object
Hana	array<object>	Informasi mengenai instans SAP HANA.
	array<object>	Instans SAP HANA.
Status	integer	Status instans SAP HANA. Nilai valid: INITIALIZING: Instans sedang diinisialisasi. INITIALIZED: Instans telah terdaftar. INVALID_HANA_NODE: Instans tidak valid. INITIALIZE_FAILED: Gagal menginstal client pada instans.	INITIALIZED
Host	string	Alamat IP privat atau internal dari host tempat node primary dari instans SAP HANA berada.	47.100.XX.XX
VaultId	string	ID dari backup vault.	v-0000s974******1hl
UseSsl	boolean	Menunjukkan apakah instans SAP HANA terhubung melalui Secure Sockets Layer (SSL). Nilai valid: true: Instans SAP HANA terhubung melalui SSL. false: Instans SAP HANA tidak terhubung melalui SSL.	true
HanaName	string	Nama instans SAP HANA.	HANA-DEV
InstanceNumber	integer	Nomor instans dari sistem SAP HANA.	00
ValidateCertificate	boolean	Menunjukkan apakah sertifikat SSL dari instans SAP HANA diverifikasi.	false
AlertSetting	string	Pengaturan peringatan. Nilai valid: INHERITED, yang menunjukkan bahwa client Cloud Backup mengirim pemberitahuan peringatan menggunakan metode yang sama seperti yang dikonfigurasi untuk backup vault.	INHERITED
UserName	string	Username dari database SYSTEMDB.	admin
StatusMessage	string	Informasi status.	INSTALL_CLIENT_FAILED
ClusterId	string	ID dari instans SAP HANA.	cl-0004cf6g6******0yd7y
Tags	object
Tag	array<object>	Tag dari instans SAP HANA.
	object	Tag dari instans SAP HANA.
Key	string	Kunci tag.	ace:rm:rgld
Value	string	Nilai tag.	rg-acfmwutpyat2kwy
ResourceGroupId	string	ID kelompok sumber daya.	rg-acfmvnf22m7itha
CrossAccountType	string	Menentukan apakah data dibackup dalam Akun Alibaba Cloud yang sama atau lintas Akun Alibaba Cloud. Nilai valid: SELF_ACCOUNT: Data dibackup dalam Akun Alibaba Cloud yang sama. CROSS_ACCOUNT: Data dibackup lintas Akun Alibaba Cloud.	CROSS_ACCOUNT
CrossAccountUserId	integer	ID akun Alibaba Cloud sumber yang memberikan otorisasi kepada akun Alibaba Cloud saat ini untuk melakukan backup data lintas akun Alibaba Cloud.	158975xxxxx4625
CrossAccountRoleName	string	Nama role Resource Access Management (RAM) yang dibuat dalam akun Alibaba Cloud sumber dan ditetapkan ke akun Alibaba Cloud saat ini untuk memberikan otorisasi kepada akun Alibaba Cloud saat ini agar dapat melakukan backup data lintas akun Alibaba Cloud.	hbrcrossrole

Contoh

Respons sukses

JSONformat

{
  "RequestId": "4003DD68-3C3C-5071-B4FC-631A6C1BAC1C",
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 21,
  "Hanas": {
    "Hana": [
      {
        "Status": 0,
        "Host": "47.100.XX.XX",
        "VaultId": "v-0000s974******1hl",
        "UseSsl": true,
        "HanaName": "HANA-DEV",
        "InstanceNumber": 0,
        "ValidateCertificate": false,
        "AlertSetting": "INHERITED",
        "UserName": "admin",
        "StatusMessage": "INSTALL_CLIENT_FAILED",
        "ClusterId": "cl-0004cf6g6******0yd7y",
        "Tags": {
          "Tag": [
            {
              "Key": "ace:rm:rgld",
              "Value": "rg-acfmwutpyat2kwy"
            }
          ]
        },
        "ResourceGroupId": "rg-acfmvnf22m7itha",
        "CrossAccountType": "CROSS_ACCOUNT",
        "CrossAccountUserId": 0,
        "CrossAccountRoleName": "hbrcrossrole"
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.