GetSecurityStrategy - DataWorks - Centro de documentación de Alibaba Cloud

Obtiene los detalles de una política de seguridad mediante su ID. Esta operación requiere permisos de administrador de inquilino y de administrador de seguridad de DataWorks.

Descripción de la operación

Solicitud

Esta API obtiene la información de configuración completa de una política de seguridad mediante su ID.
La API devuelve un mensaje de error si el Id proporcionado no es válido o no existe.
La respuesta incluye información básica de la política, como su nombre y descripción, así como detalles de la política, como los elementos de control y sus configuraciones.
Nota: Algunos campos en una política predeterminada del sistema no se pueden modificar ni eliminar.

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:GetSecurityStrategy

get

*All Resource

*

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
Id	integer	Sí	El ID de la estrategia de seguridad.	13

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El esquema de la respuesta.
RequestId	string	El ID de la solicitud.	0bc5df3a17****903790e8e8a
SecurityStrategy	object	La política de seguridad.
Id	integer	El ID de la política.	13
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.	DataQuerySecurityStrategySchema
ControlModule	string	El módulo de control.	DataQuery
ControlSubModule	string	El submódulo de control.	MyCatalog
ControlDwScope	string	El ámbito en el que la política es efectiva. Valores válidos: `Workspace` o `Tenant`.	Tenant
Workspaces	array	La lista de ID de espacios de trabajo asociados.
	integer	El ID del espacio de trabajo.	4843434
Enabled	boolean	Indica si la política de seguridad está habilitada.	true
OriginPolicyId	integer	El ID de origen de la política predeterminada del sistema.	12
Creator	string	El ID del creador.	203322746501002787
Updater	string	El ID del último actualizador.	203322746501002787
CreateTime	string	La hora en que se creó la política de seguridad.	2026-05-25T20:46:19
UpdateTime	string	La hora en que se actualizó por última vez la política de seguridad.	2026-05-25T20:46:19
Content	object	El contenido de la política de seguridad. Su estructura se define mediante `SecurityStrategySchema`.
Name	string	El campo `name` del `SecurityStrategySchema` asociado.	DataQuerySecurityStrategySchema
DisplayName	string	El campo `displayName` del `SecurityStrategySchema` asociado.	数据分析
DisplayNameEn	string	El campo `displayNameEn` del `SecurityStrategySchema` asociado.	Data Query
ControlModule	string	El módulo de control. Este valor corresponde a `controlModule` en el `SecurityStrategySchema` asociado.	DataQuery
ControlSubModule	string	El submódulo de control. Este valor corresponde a `controlSubModule` en el `SecurityStrategySchema` asociado.	MyCatalog
ControlDwScope	string	El ámbito en el que la política es efectiva. Valores válidos: Valores válidos: Tenant : Se aplica a nivel de inquilino. Workspace : Se aplica a nivel de espacio de trabajo.	Tenant
SystemPolicyName	string	El nombre de la política del sistema. Si se especifica, se 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 controladores. Nota: Los controladores disponibles dependen del esquema seleccionado. Consulte la documentación de su esquema para obtener una lista de controladores válidos.
	object	Un controlador.
Controller	string	El identificador del controlador. Para consultar los valores válidos, revise la documentación del esquema correspondiente.	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 individual
Enable	boolean	Indica si el controlador está habilitado.	true
ControllerValueType	string	El tipo de valor del controlador. Los valores válidos son `Boolean`, `Integer`, `Long` y `String`.	Integer
UserConfigValue	any	El valor configurado por el usuario. El tipo de datos de este valor se especifica mediante el parámetro `ControllerValueType`.	10
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 una matriz `[min, max]`.
	integer	El valor inicial o final del rango.	0
StandardEditionIntervalValue	array	El rango de valores válidos para Standard Edition, especificado como una matriz `[min, max]`.
	integer	El valor inicial o final del rango.	0
ProfessionalEditionIntervalValue	array	El rango de valores válidos para Professional Edition, especificado como una matriz `[min, max]`.
	integer	El valor inicial o final del rango.	0
EnterpriseEditionIntervalValue	array	El rango de valores válidos para Enterprise Edition, especificado como una matriz `[min, max]`.
	integer	El valor inicial o final del rango.	0

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "0bc5df3a17****903790e8e8a",
  "SecurityStrategy": {
    "Id": 13,
    "Name": "默认数据分析策略",
    "Description": "控制数据分析模块的查询结果安全行为",
    "SchemaName": "DataQuerySecurityStrategySchema",
    "ControlModule": "DataQuery",
    "ControlSubModule": "MyCatalog",
    "ControlDwScope": "Tenant",
    "Workspaces": [
      4843434
    ],
    "Enabled": true,
    "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": true,
          "ControllerValueType": "Integer",
          "UserConfigValue": "10",
          "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.