Todos os produtos
Search
Central de documentação

DataWorks:DsgSceneAddOrUpdateScene

Última atualização: Oct 09, 2026

Cria ou modifica um cenário de mascaramento de nível 2.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

dataworks:DsgSceneAddOrUpdateScene

list

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

scenes

array<object>

Sim

As informações do cenário de mascaramento de nível 2.

array<object>

Não

As informações do cenário de mascaramento de nível 2.

id

string

Não

O ID do cenário de mascaramento de nível 2.\n- Se você não especificar este parâmetro, a operação atual cria um cenário de mascaramento de nível 2.\n- Se você especificar este parâmetro, a operação modifica o cenário de mascaramento de nível 2 especificado. Você pode chamar a operação DsgSceneQuerySceneListByName para consultar o ID do cenário de mascaramento de nível 2.

10000

sceneName

string

Sim

O nome do cenário de mascaramento de nível 2.

dev_scene

sceneCode

string

Sim

O código do cenário de mascaramento de nível 1 ao qual o cenário de mascaramento de nível 2 pertence. Valores válidos:\n- dataworks_display_desense_code: mascaramento para exibição no Data Studio e no Data Map\n- maxcompute_desense_code: mascaramento na camada do mecanismo MaxCompute\n- maxcompute_new_desense_code: mascaramento na camada do mecanismo MaxCompute (novo)\n- dataworks_analysis_desense_code: mascaramento para exibição no Data Analysis.

dataworks_display_desense_code

projects

array<object>

Não

As informações do mecanismo ao qual o cenário de mascaramento se aplica.\n\nNota: Especificar este parâmetro na versão atual pode retornar PARAMS.ERROR (400). Especifique apenas os campos obrigatórios sceneName e sceneCode.

object

Não

As informações do mecanismo ao qual o cenário de mascaramento se aplica.

clusterId

string

Não

O ID do cluster do E-MapReduce (EMR). Especifique este parâmetro apenas quando o cenário de mascaramento se aplicar a um mecanismo EMR.

c-1234

projectName

string

Não

O nome da instância do mecanismo ao qual o cenário de mascaramento se aplica.

dev_project

dbType

string

Não

O tipo do mecanismo ao qual o cenário de mascaramento se aplica. Valores válidos:\n- ODPS: ODPS.ODPS\n- HOLO: HOLO.POSTGRES\n- EMR: EMR.

ODPS.ODPS

desc

string

Não

A descrição.\n\nNota: Especificar este parâmetro na versão atual pode retornar PARAMS.ERROR (400). Especifique apenas os campos obrigatórios sceneName e sceneCode.

Test scenarios

userGroupIds

array

Não

As informações do grupo de usuários ao qual o cenário de mascaramento se aplica.\n\nNota: Especificar este parâmetro na versão atual pode retornar PARAMS.ERROR (400). Especifique apenas os campos obrigatórios sceneName e sceneCode.

integer

Não

O ID do grupo de usuários ao qual o cenário de mascaramento se aplica. Você pode chamar a operação DsgUserGroupQueryList para obter o ID.

123

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

OpenApiResultModel

Success

boolean

Indica se a chamada foi bem-sucedida. Valores válidos:\n- true: A chamada foi bem-sucedida.\n- false: A chamada falhou.

true

ErrorCode

string

O código de erro.

1029030003

ErrorMessage

string

A mensagem de erro.

param error

HttpStatusCode

integer

O código de status HTTP.

400

Data

boolean

O resultado da operação.

true

RequestId

string

O ID da solicitação. Você pode usar este ID para localizar logs e solucionar problemas.

102400001

Exemplos

Resposta de sucesso

JSON formato

{
  "Success": true,
  "ErrorCode": "1029030003",
  "ErrorMessage": "param error",
  "HttpStatusCode": 400,
  "Data": true,
  "RequestId": "102400001"
}

Códigos de erro

Código de status HTTP

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 a este tenant.
400 DESENSSCENE.IDLEVEL.ERROR The desensitization scenario is not a secondary scenario. O cenário de mascaramento de dados não é um cenário 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. O número de cenários de mascaramento de dados excede o limite.
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 a este tenant.
400 PARAMS.ERROR param error. O parâmetro é inválido.
500 UNKNOWN.ERROR unknown error. Ocorreu um erro desconhecido.
403 PERMISSION.DENIED.ERROR Permission denied Você não tem permissões suficientes.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.