Todos los productos
Search
Centro de documentos

:DsgSceneQuerySceneListByName

Última actualización: Sep 04, 2026

Consulta una lista de escenarios de enmascaramiento de datos.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que ejecute esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action

String

Sí

DsgSceneQuerySceneListByName

La operación que desea ejecutar. Establezca el valor en DsgSceneQuerySceneListByName.

SceneName

String

No

dev_

Nombre del escenario de enmascaramiento de datos. La plataforma realiza una coincidencia aproximada basada en una palabra clave para buscar el escenario.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

Success

Boolean

true

Indica si la solicitud se completó correctamente. Valores válidos:

  • true

  • false

ErrorCode

String

1029030003

Código de error.

ErrorMessage

String

param error

Mensaje de error.

HttpStatusCode

Integer

400

Código de estado HTTP.

Data

Array of Datas

Datos devueltos.

Id

Long

123

ID del escenario de enmascaramiento de datos.

SceneCode

String

dataworks_display_desense_code

Código del escenario de enmascaramiento de datos de nivel 1. Valores válidos:

  • dataworks_display_desense_code: enmascaramiento de datos mostrados en DataStudio y Data Map

  • maxcompute_desense_code: enmascaramiento de datos en la capa del motor de cómputo de MaxCompute

  • maxcompute_new_desense_code: enmascaramiento de datos en la capa del motor de cómputo de MaxCompute (nuevo)

  • hologres_display_desense_code: enmascaramiento de datos en la capa del motor de cómputo de Hologres

  • dataworks_data_integration_desense_code: enmascaramiento estático de datos en Data Integration

  • dataworks_analysis_desense_code: enmascaramiento de datos mostrados en DataAnalysis

Desc

String

Test scenario

Descripción del escenario de enmascaramiento de datos.

SceneName

String

test_scene

Nombre del escenario de enmascaramiento de datos.

UserGroups

String

user1,user2

Lista de grupos de usuarios en el escenario de enmascaramiento de datos. Separe los grupos de usuarios con comas (,).

SceneLevel

Integer

1

Nivel del escenario de enmascaramiento de datos. Valores válidos:

  • 0: escenario de enmascaramiento de datos de nivel 1

  • 1: escenario de enmascaramiento de datos de nivel 2

Projects

Array of Project

Información sobre el motor de cómputo al que aplica el escenario de enmascaramiento de datos.

DbType

String

ODPS.ODPS

Tipo de motor de cómputo. Valores válidos:

  • ODPS: ODPS.ODPS

  • HOLO: HOLO.POSTGRES

  • EMR: EMR

ProjectName

String

dev_project

Nombre de la instancia del motor de cómputo.

ClusterId

String

c-1234

ID del clúster de EMR. Este parámetro se devuelve solo cuando el alcance de datos vigente en el escenario de enmascaramiento corresponde a un motor de cómputo de EMR.

Children

Array of Any

$ref

Si existen varios niveles de escenarios de enmascaramiento de datos, lo que indica que un escenario contiene subniveles, el valor de este parámetro corresponde a la información de dichos subniveles. Los parámetros son idénticos a los del nivel externo.

RequestId

String

102400001

ID de la solicitud. Use este ID para localizar registros y solucionar problemas.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=DsgSceneQuerySceneListByName
&SceneName=dev_
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DsgSceneQuerySceneListByNameResponse>
    <Success>true</Success>
    <ErrorCode>1029030003</ErrorCode>
    <ErrorMessage>param error</ErrorMessage>
    <HttpStatusCode>400</HttpStatusCode>
    <Data>
        <Id>123</Id>
        <SceneCode>dataworks_display_desense_code</SceneCode>
        <Desc>Test scenario</Desc>
        <SceneName>test_scene</SceneName>
        <UserGroups>user1,user2</UserGroups>
        <SceneLevel>1</SceneLevel>
        <Projects>
            <DbType>ODPS.ODPS</DbType>
            <ProjectName>dev_project</ProjectName>
            <ClusterId>c-1234</ClusterId>
        </Projects>
        <Children>$ref</Children>
    </Data>
    <RequestId>102400001</RequestId>
</DsgSceneQuerySceneListByNameResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

Códigos de error

HttpCode

Código de error

Mensaje de error

Descripción

400

DESENSSCENE.ID.ERROR

The desensitization scenario ID does not match or does not exist with the tenant.

El ID del escenario no existe o no pertenece al inquilino.

400

DESENSSCENE.IDLEVEL.ERROR

The desensitization scenario is not a secondary scenario.

El escenario de enmascaramiento de datos no es un escenario de nivel 2.

400

DESENSSCENE.PROJECT.ERROR

The project space does not exist.

El espacio de trabajo no existe.

400

DESENSSCENE.SIZE.ERROR

The number of desens scene exceeds the limit.

La cantidad de escenarios de enmascaramiento de datos supera el límite máximo.

400

DESENSSCENE.UESRGROUP.ERROR

The user group ID does not match the tenant or does not exist.

El ID del grupo de usuarios no existe o no pertenece al inquilino.

400

PARAMS.ERROR

param error.

Los valores especificados para uno o más parámetros no son válidos.

403

PERMISSION.DENIED.ERROR

Permission denied

No tiene autorización para ejecutar esta operación.

500

UNKNOWN.ERROR

unknown error.

Se ha producido un error desconocido.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.