Panggil DescribeInstances untuk kueri instans aset data - Data Security Center - Alibaba Cloud - Data Security Center

Mengambil daftar instans aset data untuk koneksi MaxCompute, ApsaraDB RDS, dan OSS yang diotorisasi.

Deskripsi operasi

Saat Anda memanggil operasi DescribeInstances, Anda dapat menetapkan parameter seperti kata kunci pencarian dan tingkat risiko instans aset data untuk mengambil daftar instans aset data yang memenuhi kondisi tertentu.

Batas QPS

Batas QPS per pengguna tunggal untuk operasi ini adalah 10 panggilan per detik. Jika jumlah panggilan melebihi batas, pembatasan kecepatan akan dipicu, yang dapat memengaruhi bisnis Anda. Panggil operasi ini sesuai kebutuhan.

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

*Semua Sumber daya.

*

acs:ResourceGroupId

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Lang	string	No	Bahasa permintaan dan tanggapan. Nilai default: zh_cn. Nilai valid: zh_cn: Bahasa Tionghoa (Sederhana). en_us: Bahasa Inggris (AS).	zh_cn
Name	string	No	Kata kunci pencarian. Pencocokan kabur didukung. Misalnya, jika Anda memasukkan data, semua entri data yang mengandung kata data dalam item pencarian akan dikembalikan.	data
ProductId	integer	No	ID produk tempat instans aset data berada. Anda dapat memanggil operasi DescribeDataAssets untuk memperoleh ID produk.	1
RiskLevelId	integer	No	ID tingkat risiko instans aset data. ID tingkat risiko yang lebih tinggi menunjukkan bahwa lebih banyak data sensitif terdeteksi. Nilai valid: 1: Tidak ada data sensitif yang terdeteksi. Tidak ada risiko. 2: Risiko data sensitif tingkat 1. 3: Risiko data sensitif tingkat 2. 4: Risiko data sensitif tingkat 3. 5: Risiko data sensitif tingkat 4. 6: Risiko data sensitif tingkat 5. 7: Risiko data sensitif tingkat 6. 8: Risiko data sensitif tingkat 7. 9: Risiko data sensitif tingkat 8. 10: Risiko data sensitif tingkat 9. 11: Risiko data sensitif tingkat 10.	2
RuleId	integer	No	ID aturan deteksi data sensitif yang dipicu oleh instans aset data. Anda dapat memanggil operasi DescribeRules dan memperoleh ID aturan dari parameter respons Id.	1111111
ServiceRegionId	string	No	Wilayah instans aset data. Untuk informasi selengkapnya, lihat Wilayah yang didukung.	cn-hangzhou
FeatureType	integer	No	Parameter ini tidak digunakan lagi.	1
ProductCode	string	No	Nama produk tempat instans aset data berada, seperti MaxCompute, OSS, atau RDS. Untuk nama produk yang didukung, lihat Tipe data dari mana data sensitif dapat dideteksi.	RDS
PageSize	integer	No	Jumlah maksimum instans aset data yang dikembalikan pada setiap halaman dalam kueri berhalaman. Nilai default: 10.	10
CurrentPage	integer	No	Nomor halaman saat ini dalam kueri berhalaman. Nilai default: 1.	1

Elemen respons

Element	Type	Description	Example
	object
CurrentPage	integer	Nomor halaman saat ini.	1
RequestId	string	ID permintaan.	71064826-726F-4ADA-B879-05D8055476FB
PageSize	integer	Jumlah instans aset data pada setiap halaman.	10
TotalCount	integer	Jumlah total instans aset data yang dikembalikan.	231
Items	array<object>	Detail instans aset data yang dikembalikan.
	array<object>
CreationTime	integer	Pengatur waktu pembuatan instans aset data. Nilainya adalah stempel waktu UNIX. Unit: milidetik.	1637226782000
LastFinishTime	integer	Pengatur waktu penyelesaian pemindaian terbaru instans aset data. Nilainya adalah stempel waktu UNIX. Unit: milidetik.	1637622793000
Owner	string	Akun Alibaba Cloud yang memiliki instans aset data.	dtdep-239-******
TenantName	string	Nama penyewa.	tenant
Protection	boolean	Status perlindungan instans aset data. Nilai valid: true: Dilindungi. false: Tidak dilindungi.	false
DepartName	string	Nama departemen tempat instans aset data berada.	***DemoCenter
Labelsec	boolean	Status keamanan instans aset data. Nilai valid: true: Aman. false: Tidak aman.	true
RiskLevelId	integer	ID tingkat risiko instans aset data. ID tingkat risiko yang lebih tinggi menunjukkan bahwa lebih banyak data sensitif terdeteksi. 1: Tidak ada data sensitif yang terdeteksi. Tidak ada risiko. 2: Risiko data sensitif tingkat 1. 3: Risiko data sensitif tingkat 2. 4: Risiko data sensitif tingkat 3. 5: Risiko data sensitif tingkat 4. 6: Risiko data sensitif tingkat 5. 7: Risiko data sensitif tingkat 6. 8: Risiko data sensitif tingkat 7. 9: Risiko data sensitif tingkat 8. 10: Risiko data sensitif tingkat 9. 11: Risiko data sensitif tingkat 10.	2
ProductId	string	ID produk tempat instans aset data berada.	5
Name	string	Nama instans aset data.	gxdata
TotalCount	integer	Jumlah total item data dalam instans aset data. Misalnya, jika aset data adalah ApsaraDB RDS, nilai ini menunjukkan jumlah total tabel dalam database instans.	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	Apakah instans aset data berisi data sensitif. Nilai valid: true: Berisi data sensitif. false: Tidak berisi data sensitif.	true
RiskLevelName	string	Nama tingkat risiko instans aset data.	S1
OdpsRiskLevelName	string	Parameter ini tidak digunakan lagi.	1
SensitiveCount	integer	Jumlah total item data sensitif dalam instans aset data. Misalnya, jika aset data adalah ApsaraDB RDS, nilai ini menunjukkan jumlah total tabel sensitif dalam database instans.	123
Id	integer	ID unik instans aset data yang dicatat di Pusat Keamanan Data.	11111
ProductCode	string	Nama produk tempat instans aset data berada, seperti MaxCompute, OSS, atau RDS. Untuk nama produk yang didukung, lihat Tipe data dari mana data sensitif dapat dideteksi.	RDS
ModelTags	array<object>	Daftar tag data.
	object	Objek tag data.
Id	integer	The ID of the data label. Valid values: 101: Personal sensitive information 102: Personal information 107: General information	101
Name	string	The name of the data label. Valid values: Personal sensitive information Personal information General information	personal sensitive data
MemberAliUid	string	Jika akun manajemen telah mengaktifkan manajemen multi-akun dan aset tersebut milik akun anggota lain, bidang ini menampilkan UID akun anggota.	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.