全部产品
Search
文档中心

Data Security Center:DescribeParentInstance

更新时间:Dec 20, 2025

Panggil operasi ini untuk mengkueri aset beserta status otorisasinya.

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

yundun-sddp:DescribeParentInstance

list

*All Resource

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

CurrentPage

integer

No

Nomor halaman yang dikembalikan untuk kueri terpaginasi. Nilai default: 1.

1

PageSize

integer

No

Jumlah entri yang dikembalikan pada setiap halaman untuk kueri terpaginasi. Nilai default: 10.

10

ServiceRegionId

string

No

Wilayah tempat aset berada. Nilai yang valid:

  • cn-beijing: China (Beijing).

  • cn-zhangjiakou: China (Zhangjiakou).

  • cn-huhehaote: China (Hohhot).

  • cn-hangzhou: China (Hangzhou).

  • cn-shanghai: China (Shanghai).

  • cn-shenzhen: China (Shenzhen).

  • cn-hongkong: China (Hong Kong).

cn-shanghai

EngineType

string

No

Tipe mesin database. Nilai yang valid:

  • MySQL.

  • MariaDB.

  • Oracle.

  • PostgreSQL.

  • SQLServer.

MySQL

InstanceId

string

No

ID instans aset data.

rm-*******xx

DbName

string

No

Nama database.

db_**t

ResourceType

integer

No

Parameter ini wajib diisi. Tipe produk. Nilai yang valid:

  • 1: MaxCompute

  • 2: OSS

  • 3: ADB-MYSQL

  • 4: TableStore

  • 5: RDS

  • 6: Self-managed database

  • 7: PolarDB-X

  • 8: PolarDB

  • 9: ADB-PG

  • 10: OceanBase

  • 11: MongoDB

  • 25: Redis

5

CheckStatus

integer

No

Status koneksi instans atau database dalam instans tersebut. Nilai yang valid:

  • -3: Database belum dibuat.

  • -2: Dilepas.

  • -1: Belum terhubung.

  • 2: Sedang menguji konektivitas.

  • 3: Terhubung.

  • 4: Koneksi gagal.

3

ClusterStatus

string

No

Status instans.

  • Running: Berjalan.

  • Released: Dilepas.

  • DatabaseNotCreated: Database belum dibuat.

Running

AuthStatus

integer

No

Status otorisasi instans aset data.

  • 0: Belum diotorisasi.

  • 1: Sudah diotorisasi.

0

MemberAccount

integer

No

ID akun anggota.

**********8103

Lang

string

No

Bahasa konten dalam permintaan dan respons. Nilai yang valid:

  • zh_cn: Bahasa Tionghoa Sederhana. Ini adalah nilai default.

  • en_us: Bahasa Inggris Amerika Serikat.

zh_cn

Elemen respons

Element

Type

Description

Example

object

Skema Respons

RequestId

string

ID permintaan.

ACEF9334-BB50-525D-8CF3-6CF504E4D1B3

CurrentPage

integer

Nomor halaman yang dikembalikan. Nilai default: 1.

1

PageSize

integer

Jumlah maksimum instans aset data yang dikembalikan pada setiap halaman. Nilai default: 10.

10

TotalCount

integer

Jumlah total entri yang dikembalikan.

3

Items

array<object>

Daftar aset data yang dikueri.

object

Detail aset yang dikueri.

InstanceId

string

ID instans.

rm-*******t2vz

LocalName

string

Nama wilayah. Daftar berikut menjelaskan nilai yang valid:

  • China (Hangzhou)

  • China (Shanghai)

  • China (Beijing)

  • China (Zhangjiakou)

  • China (Shenzhen)

  • China (Guangzhou)

  • China (Hong Kong)

  • Singapore

  • US (Silicon Valley)

华东1(杭州)

EngineType

string

Tipe mesin database. Nilai yang valid:

  • MySQL.

  • MariaDB.

  • Oracle.

  • PostgreSQL.

  • SQLServer.

MySQL

ParentId

string

Identifikasi aset yang diotorisasi. Jika aset tersebut merupakan data terstruktur, identifikasinya menggunakan format `ID Instans.Nama database`.

rm-******xxx.**st

DbNum

string

Jumlah database dalam instans.

3

ClusterStatus

string

Status instans.

Running

TenantId

string

ID penyewa. Parameter ini hanya berlaku untuk aset OceanBase.

HB***-zh_CN

TenantName

string

Nama penyewa. Parameter ini hanya berlaku untuk aset OceanBase.

user1

InstanceDescription

string

Deskripsi instans.

instance description

ResourceType

string

Nama tipe aset. Nilai yang valid:

  • MaxCompute

  • OSS

  • ADB-MYSQL

  • TableStore

  • RDS

  • SelfDB

  • PolarDB-X

  • PolarDB

  • ADB-PG

  • OceanBase

  • MongoDB

  • Redis

RDS

UnConnectDbCount

string

Jumlah database yang tidak terhubung dalam instans.

1

UnSupportOneClickAuthReason

string

Alasan mengapa otorisasi satu klik tidak didukung.

engine type not support

ConnectNode

string

Tipe node koneksi. Parameter ini hanya berlaku untuk aset MongoDB.

Primary

SupportConnectNodes

string

Node koneksi yang didukung. Beberapa node dipisahkan dengan koma.

Primary,Secondary

AuthStatus

integer

Status otorisasi instans aset data.

  • 0: Belum diotorisasi.

  • 1: Sudah diotorisasi.

1

InstanceSize

integer

Storage space instans. Parameter ini hanya berlaku untuk aset OSS. Satuan: byte.

409600

AuditStatus

integer

Status otorisasi audit. Nilai yang valid:

  • 1: Diotorisasi.

  • 0: Belum diotorisasi.

1

MemberAccount

integer

ID akun anggota.

**********8103

AuthTime

integer

Waktu saat instans diotorisasi. Satuan: milidetik.

1719882941000

RegionId

string

Wilayah tempat aset berada.

cn-hangzhou

Contoh

Respons sukses

JSONformat

{
  "RequestId": "ACEF9334-BB50-525D-8CF3-6CF504E4D1B3",
  "CurrentPage": 1,
  "PageSize": 10,
  "TotalCount": 3,
  "Items": [
    {
      "InstanceId": "rm-*******t2vz",
      "LocalName": "华东1(杭州)",
      "EngineType": "MySQL",
      "ParentId": "rm-******xxx.**st",
      "DbNum": "3",
      "ClusterStatus": "Running",
      "TenantId": "HB***-zh_CN",
      "TenantName": "user1",
      "InstanceDescription": "instance description",
      "ResourceType": "RDS",
      "UnConnectDbCount": "1",
      "UnSupportOneClickAuthReason": "engine type not support",
      "ConnectNode": "Primary",
      "SupportConnectNodes": "Primary,Secondary",
      "AuthStatus": 1,
      "InstanceSize": 409600,
      "AuditStatus": 1,
      "MemberAccount": 0,
      "AuthTime": 1719882941000,
      "RegionId": "cn-hangzhou"
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.