All Products
Search
Document Center

DataWorks:FindBestMatchSecurityStrategy

Last Updated:Jun 11, 2026

Find the security policy that best matches the given conditions.

Operation description

Request Description

This API is used to find the most suitable security policy based on the provided control module, sub-module, and workspace ID. If a workspace ID is provided, the policy at the specified workspace level is matched first; otherwise, the tenant-level policy is returned. Note that system policies cannot be deleted or modified.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

ControlModule

string

No

Control module, used to match the security policy type.

Valid values:

  • DataStudio :

    DataStudio

  • DataQuery :

    DataQuery

DataQuery

ControlSubModule

string

No

Control sub-module, used to match the security policy type.

Valid values:

  • MyCatalog :

    MyCatalog

MyCatalog

WorkspaceId

integer

No

Workspace ID, used to precisely match workspace-level policies.

12345

Response elements

Element

Type

Description

Example

object

Schema of Response

RequestId

string

API request ID

0bc5df3a17***903790e8e8a

Data

object

Data object.

SecurityStrategy

object

Security policy.

Id

integer

16

Name

string

默认数据分析策略

Description

string

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

SchemaName

string

DataQuerySecurityStrategySchema

ControlModule

string

DataQuery

ControlSubModule

string

MyCatalog

ControlDwScope

string

Tenant

Workspaces

array

integer

12345

Enabled

boolean

true

Content

object

Name

string

DataQuerySecurityStrategySchema

DisplayName

string

数据分析

DisplayNameEn

string

Data Query

ControlModule

string

DataQuery

ControlSubModule

string

MyCatalog

ControlDwScope

string

Tenant

SystemPolicyName

string

SYSTEM_GENERATE_DEFAULT_DATA_QUERY

SystemPolicyDisplayName

string

Default system generate data query policy

Controllers

array<object>

object

Controller

string

viewCount

DisplayName

string

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

DisplayNameEn

string

Query Results - Single Display Record Limit

Enable

boolean

true

ControllerValueType

string

Integer

UserConfigValue

any

20

BasicEditionDefaultValue

any

0

StandardEditionDefaultValue

any

10000

ProfessionalEditionDefaultValue

any

200000

EnterpriseEditionDefaultValue

any

500000

BasicEditionIntervalValue

array

integer

0

StandardEditionIntervalValue

array

integer

0

ProfessionalEditionIntervalValue

array

integer

0

EnterpriseEditionIntervalValue

array

integer

0

OriginPolicyId

integer

12

Creator

string

203322746501002787

Updater

string

207947397706614297

CreateTime

string

2026-05-25T20:46:19

UpdateTime

string

2026-05-25T20:46:19

Edition

string

Purchased DataWorks edition.

STANDARD

EditionDisplayName

string

Purchased DataWorks edition name.

标准版

Examples

Success response

JSON format

{
  "RequestId": "0bc5df3a17***903790e8e8a",
  "Data": {
    "SecurityStrategy": {
      "Id": 16,
      "Name": "默认数据分析策略",
      "Description": "控制数据分析模块的查询结果安全行为",
      "SchemaName": "DataQuerySecurityStrategySchema",
      "ControlModule": "DataQuery",
      "ControlSubModule": "MyCatalog",
      "ControlDwScope": "Tenant",
      "Workspaces": [
        12345
      ],
      "Enabled": true,
      "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": "20",
            "BasicEditionDefaultValue": "0",
            "StandardEditionDefaultValue": "10000",
            "ProfessionalEditionDefaultValue": "200000",
            "EnterpriseEditionDefaultValue": "500000",
            "BasicEditionIntervalValue": [
              0
            ],
            "StandardEditionIntervalValue": [
              0
            ],
            "ProfessionalEditionIntervalValue": [
              0
            ],
            "EnterpriseEditionIntervalValue": [
              0
            ]
          }
        ]
      },
      "OriginPolicyId": 12,
      "Creator": "203322746501002787",
      "Updater": "207947397706614297",
      "CreateTime": "2026-05-25T20:46:19",
      "UpdateTime": "2026-05-25T20:46:19"
    },
    "Edition": "STANDARD",
    "EditionDisplayName": "标准版"
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.