Todos los productos
Search
Centro de documentos

DataWorks:ListSecurityStrategies

Última actualización: Sep 03, 2026

Obtiene una lista paginada de políticas de seguridad según las condiciones especificadas. Esta operación requiere permisos de administrador de inquilino o administrador de seguridad de DataWorks.

Descripción de la operación

Solicitud

  • Esta API obtiene una lista paginada de políticas de seguridad configuradas.

  • Los parámetros ControlModule y ControlSubModule filtran las políticas por un módulo o submódulo específico.

  • Los parámetros PageNum y PageSize controlan la paginación. PageNum especifica el número de página que se debe obtener (valor predeterminado: 1) y PageSize especifica el número de políticas que se deben devolver por página (valor predeterminado: 20).

  • Utilice los parámetros privados MaxResults y NextToken para la paginación avanzada.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

  • Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.

  • API: La API que debe invocarse para llevar a cabo la acción.

  • Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.

  • Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.

    • En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.

    • Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.

  • Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.

  • Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

dataworks:ListSecurityStrategies

list

*All Resource

*

Ninguna Ninguna

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

ControlModule

string

No

El módulo de control.

DataQuery

ControlSubModule

string

No

El submódulo de control.

MyCatalog

PageNumber

integer

No

El número de página. Comienza en 1. Valor predeterminado: 1.

1

PageSize

integer

No

El número de entradas por página. Valor predeterminado: 20.

10

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

El esquema de la respuesta.

RequestId

string

El ID de la solicitud.

0bc5df3a17****903790e8e8a

PagingInfo

object

El resultado de la paginación.

PageNumber

integer

El número de página. Valor predeterminado: 1.

1

PageSize

integer

El tamaño de página. Valor predeterminado: 20.

10

TotalCount

integer

El recuento total.

12

SecurityStrategies

array<object>

La lista de políticas de seguridad.

array<object>

Una política de seguridad.

Id

string

El ID de la política.

12345

Name

string

El nombre de la política.

默认数据分析策略

Description

string

La descripción de la política.

控制数据分析模块的查询结果安全行为

SchemaName

string

El nombre de la plantilla de esquema.

Valores válidos:

  • DataStudioMyCatalogSecurityStrategySchema :

    DataStudioMyCatalogSecurityStrategySchema.

  • DataQuerySecurityStrategySchema :

    DataQuerySecurityStrategySchema.

  • DataStudioSecurityStrategySchema :

    DataStudioSecurityStrategySchema.

DataQuerySecurityStrategySchema

ControlModule

string

El módulo de control.

DataQuery

ControlSubModule

string

El submódulo de control.

MyCatalog

ControlDwScope

string

El ámbito de control. Valores válidos: Workspace y Tenant.

Tenant

Workspaces

array

Los ID de los espacios de trabajo asociados.

integer

El ID del espacio de trabajo.

343434

Enabled

boolean

Indica si la política está habilitada.

false

OriginPolicyId

integer

El ID de origen de la política predeterminada del sistema.

12

Creator

string

El ID de usuario del creador.

203322746501002787

Updater

string

El ID del usuario que actualizó la política por última vez.

203322746501002787

CreateTime

string

La hora de creación.

2026-05-25T20:46:19

UpdateTime

string

La hora de la última actualización.

2026-05-25T20:46:19

Content

object

El contenido de la política. El contenido está restringido por SecurityStrategySchema.

Name

string

El name del SecurityStrategySchema asociado.

DataQuerySecurityStrategySchema

DisplayName

string

El displayName del SecurityStrategySchema asociado.

数据分析

DisplayNameEn

string

El displayNameEn del SecurityStrategySchema asociado.

Data Query

ControlModule

string

El módulo de control. Este valor proviene de la propiedad controlModule del SecurityStrategySchema asociado.

DataQuery

ControlSubModule

string

El submódulo de control. Este valor proviene de la propiedad controlSubModule del SecurityStrategySchema asociado.

MyCatalog

ControlDwScope

string

El ámbito de control.

Valores válidos:

  • Tenant :

    Tenant.

  • Workspace :

    Workspace.

Tenant

SystemPolicyName

string

El nombre de la política del sistema. Si esta propiedad no está vacía, el sistema crea automáticamente una política predeterminada.

SYSTEM_GENERATE_DEFAULT_DATA_QUERY

SystemPolicyDisplayName

string

El nombre para mostrar de la política del sistema.

Política predeterminada de consulta de datos generada por el sistema

Controllers

array<object>

Una lista de elementos de control. Los elementos disponibles dependen del esquema. Para más detalles, consulte la definición de Controller y la lista de elementos de control de cada esquema.

object

Un elemento de control.

Controller

string

El identificador del elemento de control. Para consultar los valores válidos, revise la lista de elementos de control de cada esquema.

viewCount

DisplayName

string

El nombre para mostrar.

查询结果-单次展示记录值上限

DisplayNameEn

string

El nombre para mostrar en inglés.

Resultados de consulta - Límite de registros por visualización única

Enable

boolean

Indica si el elemento de control está habilitado.

ControllerValueType

string

El tipo de datos del valor. Valores válidos: Boolean, Integer, Long y String.

Integer

UserConfigValue

any

El valor establecido para el elemento de control. El tipo de datos de este valor se especifica mediante ControllerValueType.

20

BasicEditionDefaultValue

any

El valor predeterminado para Basic Edition.

10000

StandardEditionDefaultValue

any

El valor predeterminado para Standard Edition.

10000

ProfessionalEditionDefaultValue

any

El valor predeterminado para Professional Edition.

10000

EnterpriseEditionDefaultValue

any

El valor predeterminado para Enterprise Edition.

10000

BasicEditionIntervalValue

array

El rango de valores válidos para Basic Edition, especificado como [mín, máx].

integer

Un valor límite del rango.

0

StandardEditionIntervalValue

array

El rango de valores válidos para Standard Edition, especificado como [mín, máx].

integer

Un valor límite del rango.

0

ProfessionalEditionIntervalValue

array

El rango de valores válidos para Professional Edition, especificado como [mín, máx].

integer

Un valor límite del rango.

0

EnterpriseEditionIntervalValue

array

El rango de valores válidos para Enterprise Edition, especificado como [mín, máx].

integer

Un valor límite del rango.

0

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "0bc5df3a17****903790e8e8a",
  "PagingInfo": {
    "PageNumber": 1,
    "PageSize": 10,
    "TotalCount": 12,
    "SecurityStrategies": [
      {
        "Id": "12345",
        "Name": "默认数据分析策略",
        "Description": "控制数据分析模块的查询结果安全行为",
        "SchemaName": "DataQuerySecurityStrategySchema",
        "ControlModule": "DataQuery",
        "ControlSubModule": "MyCatalog",
        "ControlDwScope": "Tenant",
        "Workspaces": [
          343434
        ],
        "Enabled": false,
        "OriginPolicyId": 12,
        "Creator": "203322746501002787",
        "Updater": "203322746501002787",
        "CreateTime": "2026-05-25T20:46:19",
        "UpdateTime": "2026-05-25T20:46:19",
        "Content": {
          "Name": "DataQuerySecurityStrategySchema",
          "DisplayName": "数据分析",
          "DisplayNameEn": "Data Query",
          "ControlModule": "DataQuery",
          "ControlSubModule": "MyCatalog",
          "ControlDwScope": "Tenant",
          "SystemPolicyName": "SYSTEM_GENERATE_DEFAULT_DATA_QUERY",
          "SystemPolicyDisplayName": "Default system generate data query policy",
          "Controllers": [
            {
              "Controller": "viewCount",
              "DisplayName": "查询结果-单次展示记录值上限",
              "DisplayNameEn": "Query Results - Single Display Record Limit",
              "Enable": false,
              "ControllerValueType": "Integer",
              "UserConfigValue": "20",
              "BasicEditionDefaultValue": "10000",
              "StandardEditionDefaultValue": "10000",
              "ProfessionalEditionDefaultValue": "10000",
              "EnterpriseEditionDefaultValue": "10000",
              "BasicEditionIntervalValue": [
                0
              ],
              "StandardEditionIntervalValue": [
                0
              ],
              "ProfessionalEditionIntervalValue": [
                0
              ],
              "EnterpriseEditionIntervalValue": [
                0
              ]
            }
          ]
        }
      }
    ]
  }
}

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.