Panggil DescribeInstances untuk kueri instans aset data - Data Security Center

Mengambil daftar instans aset data MaxCompute, RDS, dan OSS yang telah diotorisasi.

Deskripsi operasi

Saat memanggil operasi DescribeInstances, Anda dapat menetapkan parameter seperti kata kunci pencarian dan tingkat ancaman instans aset data untuk mengambil daftar instans yang sesuai dengan kriteria Anda.

Batas QPS

Batas permintaan per detik (QPS) untuk satu pengguna pada operasi ini adalah 10 panggilan per detik. Jika batas ini terlampaui, panggilan API akan dikenai pengendalian aliran (throttled), yang dapat berdampak pada bisnis Anda. Rencanakan panggilan API secara tepat.

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

get

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Lang	string	No	Bahasa yang digunakan dalam permintaan dan respons. Nilai default: zh_cn. Nilai yang valid: zh_cn: Bahasa Tiongkok en_us: Bahasa Inggris	zh_cn
Name	string	No	Kata kunci untuk pencarian. Pencocokan fuzzy didukung. Misalnya, jika Anda memasukkan "data", semua data yang mengandung "data" akan dikembalikan.	data
ProductId	integer	No	ID produk tempat instans aset data tersebut berada. Anda dapat memanggil operasi DescribeDataAssets untuk menanyakan ID produk.	1
RiskLevelId	integer	No	ID tingkat ancaman untuk instans aset data. Semakin tinggi ID tingkat ancaman, semakin sensitif datanya. Nilai yang valid: 1: Tidak ada data sensitif yang terdeteksi. Tidak ada ancaman. 2: Tingkat ancaman 1. 3: Tingkat ancaman 2. 4: Tingkat ancaman 3. 5: Tingkat ancaman 4. 6: Tingkat ancaman 5. 7: Tingkat ancaman 6. 8: Tingkat ancaman 7. 9: Tingkat ancaman 8. 10: Tingkat ancaman 9. 11: Tingkat ancaman 10.	2
RuleId	integer	No	ID aturan deteksi data sensitif yang dipicu oleh instans aset data. Anda dapat memanggil operasi DescribeRules dan melihat nilai parameter Id dalam respons untuk mendapatkan ID aturan tersebut.	1111111
ServiceRegionId	string	No	Wilayah tempat instans aset data berada. Untuk informasi selengkapnya, lihat Wilayah yang didukung.	cn-hangzhou
FeatureType	integer	No	Parameter ini sudah tidak digunakan lagi.	1
ProductCode	string	No	Nama produk tempat instans aset data berada, seperti MaxCompute, OSS, atau RDS. Untuk informasi selengkapnya mengenai produk yang didukung, lihat Aset data yang dapat dipindai untuk data sensitif.	RDS
PageSize	integer	No	Jumlah maksimum instans aset data yang dikembalikan pada setiap halaman dalam kueri terpaginasi. Nilai default: 10.	10
CurrentPage	integer	No	Nomor halaman dalam kueri terpaginasi. Nilai default: 1.	1

Elemen respons

Element	Type	Description	Example
	object
CurrentPage	integer	Nomor halaman.	1
RequestId	string	ID permintaan.	71064826-726F-4ADA-B879-05D8055476FB
PageSize	integer	Jumlah instans aset data yang dikembalikan pada setiap halaman.	10
TotalCount	integer	Total jumlah instans aset data.	231
Items	array<object>	Detail instans aset data.
	array<object>
CreationTime	integer	Waktu pembuatan instans aset data. Nilainya berupa Stempel waktu UNIX. Satuan: milidetik.	1637226782000
LastFinishTime	integer	Waktu penyelesaian pemindaian terakhir pada instans aset data. Nilainya berupa Stempel waktu UNIX. Satuan: milidetik.	1637622793000
Owner	string	Akun Alibaba Cloud yang memiliki instans aset data tersebut.	dtdep-239-******
TenantName	string	Nama penyewa.	tenant
Protection	boolean	Status perlindungan instans aset data. Nilai yang valid: true: Instans dilindungi. false: Instans tidak dilindungi.	false
DepartName	string	Nama departemen tempat instans aset data berada.	***DemoCenter
Labelsec	boolean	Status keamanan instans aset data. Nilai yang valid: true: aman false: tidak aman	true
RiskLevelId	integer	ID tingkat ancaman untuk instans aset data. Semakin tinggi ID tingkat ancaman, semakin sensitif datanya. 1: Tidak ada data sensitif yang terdeteksi. Tidak ada ancaman. 2: Tingkat ancaman 1. 3: Tingkat ancaman 2. 4: Tingkat ancaman 3. 5: Tingkat ancaman 4. 6: Tingkat ancaman 5. 7: Tingkat ancaman 6. 8: Tingkat ancaman 7. 9: Tingkat ancaman 8. 10: Tingkat ancaman 9. 11: Tingkat ancaman 10.	2
ProductId	string	ID produk tempat instans aset data berada.	5
Name	string	Nama instans aset data.	gxdata
TotalCount	integer	Total jumlah data dalam instans aset data. Misalnya, jika aset data tersebut merupakan instans RDS, parameter ini menunjukkan total jumlah tabel dalam instans tersebut.	231
InstanceDescription	string	Deskripsi instans aset data.	instance dscription
RuleName	string	Nama aturan deteksi data sensitif yang dipicu oleh instans aset data.	*** rule
Sensitive	boolean	Menunjukkan apakah instans aset data berisi data sensitif. Nilai yang valid: true: ya false: tidak	true
RiskLevelName	string	Nama tingkat ancaman untuk instans aset data.	S1
OdpsRiskLevelName	string	Parameter ini sudah tidak digunakan lagi.	1
SensitiveCount	integer	Total jumlah data sensitif dalam instans aset data. Misalnya, jika aset data tersebut merupakan instans RDS, parameter ini menunjukkan total jumlah tabel sensitif dalam instans tersebut.	123
Id	integer	ID unik instans aset data yang dicatat di Data Security Center.	11111
ProductCode	string	Nama produk tempat instans aset data berada, seperti MaxCompute, OSS, atau RDS. Untuk informasi selengkapnya mengenai produk yang didukung, lihat Aset data yang dapat dipindai untuk data sensitif.	RDS
ModelTags	array<object>	Daftar label data.
	object	Objek label data.
Id	integer	ID label data. Nilai yang valid: 101: Informasi pribadi sensitif 102: Informasi pribadi 107: Informasi umum	101
Name	string	Nama label data. Nilai yang valid: Informasi pribadi sensitif Informasi pribadi Informasi umum	personal sensitive data
MemberAliUid	string	Jika manajemen multi-akun diaktifkan dan aset tersebut dimiliki oleh akun anggota, parameter ini menunjukkan UID akun anggota tersebut.	12567890126

Contoh

Respons sukses

JSONformat

{
  "CurrentPage": 1,
  "RequestId": "71064826-726F-4ADA-B879-05D8055476FB",
  "PageSize": 10,
  "TotalCount": 231,
  "Items": [
    {
      "CreationTime": 1637226782000,
      "LastFinishTime": 1637622793000,
      "Owner": "dtdep-239-******",
      "TenantName": "tenant",
      "Protection": false,
      "DepartName": "***DemoCenter",
      "Labelsec": true,
      "RiskLevelId": 2,
      "ProductId": "5",
      "Name": "gxdata",
      "TotalCount": 231,
      "InstanceDescription": "instance dscription",
      "RuleName": "*** rule",
      "Sensitive": true,
      "RiskLevelName": "S1",
      "OdpsRiskLevelName": "1",
      "SensitiveCount": 123,
      "Id": 11111,
      "ProductCode": "RDS",
      "ModelTags": [
        {
          "Id": 101,
          "Name": "personal sensitive data"
        }
      ],
      "MemberAliUid": "12567890126"
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.