All Products
Search
Document Center

DataWorks:DsgSceneQuerySceneListByName

Last Updated:Jun 11, 2026

Panggil API `DsgSceneQuerySceneListByName` untuk mengambil daftar skenario penyamaran data.

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

dataworks:DsgSceneQuerySceneListByName

list

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

SceneName

string

No

Kata kunci untuk pencarian fuzzy nama skenario penyamaran data.

dev_

Elemen respons

Element

Type

Description

Example

object

OpenApiResultModel<List>

Success

boolean

Menunjukkan apakah permintaan berhasil. Nilai yang valid:

  • true: Permintaan berhasil.

  • false: Permintaan gagal.

true

ErrorCode

string

Kode kesalahan.

1029030003

ErrorMessage

string

Pesan kesalahan.

param error

HttpStatusCode

integer

Kode status HTTP.

400

Data

array<object>

Daftar skenario penyamaran data.

array<object>

Detail skenario penyamaran data.

Id

integer

ID skenario penyamaran data.

123

SceneCode

string

Kode untuk skenario level-1. Nilai yang valid:

  • Penyamaran data di Data Map dan DataStudio: dataworks_display_desense_code

  • Penyamaran data di lapisan mesin MaxCompute: maxcompute_desense_code

  • Penyamaran data di lapisan mesin MaxCompute (baru): maxcompute_new_desense_code

  • Penyamaran data di lapisan mesin Hologres: hologres_display_desense_code

  • Penyamaran data statis di Data Integration: dataworks_data_integration_desense_code

  • Penyamaran data di Data Analysis: dataworks_analysis_desense_code

dataworks_display_desense_code

Desc

string

Deskripsi skenario penyamaran data.

Test scenarios

SceneName

string

Nama skenario penyamaran data.

test_scene

UserGroups

string

Grup pengguna yang menerapkan skenario penyamaran data. Beberapa nama grup pengguna dipisahkan dengan koma (,).

user1,user2

SceneLevel

integer

Level skenario penyamaran data. Nilai yang valid:

  • 0: skenario level-1

  • 1: skenario level-2

1

Projects

array<object>

Instance mesin yang menerapkan skenario penyamaran data.

object

Instance mesin yang menerapkan skenario penyamaran data.

DbType

string

The type of the compute engine. Valid values:

  • ODPS: ODPS.ODPS

  • HOLO: HOLO.POSTGRES

  • EMR: EMR

ODPS.ODPS

ProjectName

string

The name of the compute engine.

dev_project

ClusterId

string

The ID of the EMR cluster. This parameter is returned only when the data scope that takes effect in the data masking scenario is an EMR compute engine.

c-123456

Children

array

Skenario penyamaran data bertingkat.

any

Skenario penyamaran data bertingkat (level-2). Parameter untuk skenario bertingkat sama dengan parameter induknya.

$ref

scenceDbType

string

RequestId

string

ID permintaan. Anda dapat menggunakan ID ini untuk memecahkan masalah.

102400001

Contoh

Respons sukses

JSONformat

{
  "Success": true,
  "ErrorCode": "1029030003",
  "ErrorMessage": "param error",
  "HttpStatusCode": 400,
  "Data": [
    {
      "Id": 123,
      "SceneCode": "dataworks_display_desense_code",
      "Desc": "Test scenarios",
      "SceneName": "test_scene",
      "UserGroups": "user1,user2",
      "SceneLevel": 1,
      "Projects": [
        {
          "DbType": "ODPS.ODPS",
          "ProjectName": "dev_project",
          "ClusterId": "c-123456"
        }
      ],
      "Children": [
        "$ref"
      ],
      "scenceDbType": ""
    }
  ],
  "RequestId": "102400001"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 DESENSSCENE.ID.ERROR The desensitization scenario ID does not match or does not exist with the tenant.
400 DESENSSCENE.IDLEVEL.ERROR The desensitization scenario is not a secondary scenario.
400 DESENSSCENE.PROJECT.ERROR The project space does not exist.
400 DESENSSCENE.SIZE.ERROR The number of desens scene exceeds the limit.
400 DESENSSCENE.UESRGROUP.ERROR The user group ID does not match the tenant or does not exist.
400 PARAMS.ERROR param error.
500 UNKNOWN.ERROR unknown error.
403 PERMISSION.DENIED.ERROR Permission denied

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.