Todos os produtos
Search
Central de documentação

:DsgSceneQuerySceneListByName

Última atualização: Jun 27, 2026

Consulta uma lista de cenários de mascaramento de dados.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DsgSceneQuerySceneListByName

Operação a ser executada. Defina o valor como DsgSceneQuerySceneListByName.

SceneName

String

Não

dev_

Nome do cenário de mascaramento de dados. A plataforma aplica correspondência aproximada com base em palavra-chave para localizar o cenário.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

Success

Boolean

true

Indica se a solicitação foi bem-sucedida. Valores válidos:

  • true

  • false

ErrorCode

String

1029030003

Código de erro.

ErrorMessage

String

param error

Mensagem de erro.

HttpStatusCode

Integer

400

Código de status HTTP.

Data

Array of Datas

Dados retornados.

ID

Long

123

ID do cenário de mascaramento de dados.

SceneCode

String

dataworks_display_desense_code

Código do cenário de mascaramento de dados de nível 1. Valores válidos:

  • dataworks_display_desense_code: mascaramento de dados exibidos no DataStudio e no Data Map

  • maxcompute_desense_code: mascaramento na camada do mecanismo de computação do MaxCompute

  • maxcompute_new_desense_code: mascaramento na camada do mecanismo de computação do MaxCompute (novo)

  • hologres_display_desense_code: mascaramento na camada do mecanismo de computação do Hologres

  • dataworks_data_integration_desense_code: mascaramento estático de dados no Data Integration

  • dataworks_analysis_desense_code: mascaramento de dados exibidos no DataAnalysis

Desc

String

Test scenario

Descrição do cenário de mascaramento de dados.

SceneName

String

test_scene

Nome do cenário de mascaramento de dados.

UserGroups

String

user1,user2

Lista de grupos de usuários no cenário de mascaramento de dados. Separe os grupos por vírgulas (,).

SceneLevel

Integer

1

Nível do cenário de mascaramento de dados. Valores válidos:

  • 0: cenário de mascaramento de dados de nível 1

  • 1: cenário de mascaramento de dados de nível 2

Projects

Array of Project

Informações sobre o mecanismo de computação ao qual o cenário de mascaramento de dados se aplica.

DbType

String

ODPS.ODPS

Tipo do mecanismo de computação. Valores válidos:

  • ODPS: ODPS.ODPS

  • HOLO: HOLO.POSTGRES

  • EMR: EMR

ProjectName

String

dev_project

Nome da instância do mecanismo de computação.

ClusterId

String

c-1234

ID do cluster EMR. Este parâmetro é retornado apenas quando o escopo de dados vigente no cenário de mascaramento refere-se a um mecanismo de computação EMR.

Children

Array of Any

$ref

Se houver múltiplos níveis de cenários de mascaramento de dados, indicando que um cenário contém subcenários, este parâmetro trará as informações desses subcenários. Os parâmetros seguem a mesma estrutura dos níveis externos.

RequestId

String

102400001

ID da solicitação. Utilize este ID para localizar logs e solucionar problemas.

Exemplos

Exemplos de solicitações

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

Exemplos de respostas de sucesso

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 erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

DESENSSCENE.ID.ERROR

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

O ID do cenário não existe ou não pertence ao locatário.

400

DESENSSCENE.IDLEVEL.ERROR

The desensitization scenario is not a secondary scenario.

O cenário de mascaramento de dados não é de nível 2.

400

DESENSSCENE.PROJECT.ERROR

The project space does not exist.

O workspace não existe.

400

DESENSSCENE.SIZE.ERROR

The number of desens scene exceeds the limit.

A quantidade de cenários de mascaramento de dados excede o limite máximo.

400

DESENSSCENE.UESRGROUP.ERROR

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

O ID do grupo de usuários não existe ou não pertence ao locatário.

400

PARAMS.ERROR

param error.

Um ou mais parâmetros especificados são inválidos.

403

PERMISSION.DENIED.ERROR

Permission denied

Você não tem autorização para executar esta operação.

500

UNKNOWN.ERROR

unknown error.

Ocorreu um erro desconhecido.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.