API overview

Updated at:

Data Management provides the following API operations.

Orders

APIDescription
BuyPayAsYouGoOrderCall BuyPayAsYouGoOrder to purchase pay-as-you-go DMS products.
RefundPayAsYouGoOrderCall RefundPayAsYouGoOrder to unsubscribe from purchased pay-as-you-go DMS products.
ListEffectiveOrdersCall ListEffectiveOrders to query the list of effective orders.

User management

APIDescription
RegisterUserCall RegisterUser to add a new user to your enterprise.
DisableUserCall DisableUser to disable an Alibaba Cloud account that is temporarily not needed in the product.
EnableUserCall EnableUser to enable a previously disabled Alibaba Cloud account in the product.
DeleteUserCall DeleteUser to delete an unnecessary Alibaba Cloud account from the product.
UpdateUserCall UpdateUser to update user information.
ListUsersCall the ListUsers operation to obtain a list of user details.
ListUserTenantsCall ListUserTenants to obtain the list of current tenants.
GetUserActiveTenantCall GetUserActiveTenant to obtain information about the current tenant.
GetUserCall GetUser to obtain user information.

Instance management

APIDescription
RegisterInstanceCall RegisterInstance to add a new database instance to your enterprise.
UpdateInstanceCall UpdateInstance to update instance information and check connectivity.
GetInstanceCall GetInstance to obtain the details of an instance.
DeleteInstanceCall DeleteInstance to delete an instance managed by DMS Enterprise.
ListInstancesCall ListInstances to search the instance list and obtain instance details.

Operation audit

APIDescription
GetOpLogCall GetOpLog to obtain a list of operation log details within a specified time range.
ListSQLExecAuditLogCall ListSQLExecAuditLog to obtain the list of audit logs for SQL windows.
ListProxySQLExecAuditLogCall ListProxySQLExecAuditLog to obtain the list of audit information for the secure access proxy.
ListInstanceLoginAuditLogCall ListInstanceLoginAuditLog to obtain the list of instance logon information.
ListSensitiveDataAuditLogCall the ListSensitiveDataAuditLog operation to view the details of sensitive data audit logs.

Approval flows

APIDescription
ListWorkFlowNodesCall ListWorkFlowNodes to obtain the list of approval nodes.
ListWorkFlowTemplatesCall ListWorkFlowTemplates to obtain the list of approval templates.

Database and table metadata

APIDescription
SearchDatabaseCall SearchDatabase to search for database details.
SearchTableCall SearchTable to search for a list of table details.
ListDatabasesCall ListDatabases to obtain the details of databases in an instance.
ListTablesCall ListTables to obtain a list of table details in a database.
ListColumnsCall ListColumns to return the column information of a table.
ListIndexesCall ListIndexes to return the index information of a table.
GetDatabaseCall GetDatabase to obtain the details of a specific database.
GetPhysicalDatabaseCall GetPhysicalDatabase to obtain the details of a physical database.
GetTableTopologyCall GetTableTopology to obtain the topology of a data table.
GetMetaTableDetailInfoCall the GetMetaTableDetailInfo operation to obtain information about a table, such as its fields and indexes.
GetMetaTableColumnCall the GetMetaTableColumn operation to obtain the field information of a table.
SyncInstanceMetaCall SyncInstanceMeta to synchronize the metadata of all database dictionaries in an instance.
SyncDatabaseMetaCall SyncDatabaseMeta to synchronize the metadata of a database dictionary.

Logical databases and tables

APIDescription
CreateLogicDatabaseCall CreateLogicDatabase to create a DMS logical database.
EditLogicDatabaseCall EditLogicDatabase to edit the information of a DMS logical database.
DeleteLogicDatabaseCall DeleteLogicDatabase to delete a DMS logical database.
ListLogicDatabasesCall ListLogicDatabases to obtain a list of logical databases.
GetLogicDatabaseCall GetLogicDatabase to obtain the details of a logical database.
GetDBTopologyCall GetDBTopology to obtain the topology of a logical database and its corresponding physical sharded databases.
ListLogicTablesCall ListLogicTables to obtain a list of logical table details in a specified logical database.
GetTableDBTopologyCall the GetTableDBTopology operation to obtain the topology graph of a data table.
AddLogicTableRouteConfigCall AddLogicTableRouteConfig to add a routing algorithm configuration for a logical table.
DeleteLogicTableRouteConfigCall DeleteLogicTableRouteConfig to delete the routing algorithm configuration of a logical table.
ListLogicTableRouteConfigCall ListLogicTableRouteConfig to obtain the list of routing algorithm configurations for a logical table.

Ticket operations

CategoryAPIDescription
GeneralApproveOrderCall ApproveOrder to process a ticket approval.
CloseOrderCall CloseOrder to close a ticket.
GetApprovalDetailCall GetApprovalDetail to obtain the approval details of a ticket.
GetOrderBaseInfoCall GetOrderBaseInfo to obtain the basic information of a ticket.
ListOrdersCall ListOrders to obtain a list of tickets.
CreateOrderCall CreateOrder to create a ticket.
SubmitOrderApprovalCall SubmitOrderApproval to submit a ticket for approval.
Permission requestGetOwnerApplyOrderDetailCall GetOwnerApplyOrderDetail to obtain the details of a ticket for requesting database, table, or instance ownership.
GetPermApplyOrderDetailCall GetPermApplyOrderDetail to obtain the details of a permission request ticket.
Database and table synchronizationCreateStructSyncOrderCall CreateStructSyncOrder to create a schema synchronization ticket.
GetStructSyncOrderDetailCall GetStructSyncOrderDetail to obtain the details of a schema synchronization ticket.
GetStructSyncJobDetailCall GetStructSyncJobDetail to obtain the details of a schema synchronization task.
GetStructSyncJobAnalyzeResultCall GetStructSyncJobAnalyzeResult to obtain the analysis result of a schema synchronization task.
GetStructSyncExecSqlDetailCall GetStructSyncExecSqlDetail to obtain the SQL script for a schema synchronization task.
SubmitStructSyncOrderApprovalCall SubmitStructSyncOrderApproval to submit a schema synchronization ticket to the approval flow.
ExecuteStructSyncCall ExecuteStructSync to execute a schema synchronization ticket.
Data changeCreateDataCorrectOrderCall CreateDataCorrectOrder to create a standard data change ticket.
CreateDataCronClearOrderCall CreateDataCronClearOrder to create a historical data cleanup ticket.
CreateDataImportOrderCall CreateDataImportOrder to create a data import ticket.
CreateFreeLockCorrectOrderCall CreateFreeLockCorrectOrder to create a lockless change ticket.
ExecuteDataCorrectCall ExecuteDataCorrect to execute a data change ticket.
GetDataCorrectTaskDetailCall GetDataCorrectTaskDetail to obtain the execution details of a standard data change, lockless change, or data import ticket.
GetDataCronClearTaskDetailListCall GetDataCronClearTaskDetailList to obtain the execution list of historical data cleanup tasks.
GetDataCorrectOrderDetailCall GetDataCorrectOrderDetail to obtain the details of a data change ticket.
GetDataCorrectBackupFilesCall GetDataCorrectBackupFiles to obtain the download URL for the backup file attachment of a data change.
GetDataCorrectSQLFileCall GetDataCorrectSQLFile to obtain the SQL script attachment for a data change ticket.
ModifyDataCorrectExecSQLCall ModifyDataCorrectExecSQL to modify the SQL script submitted in a data change ticket.
ListDataCorrectPreCheckSQLCall ListDataCorrectPreCheckSQL to obtain the SQL details of the precheck step in a data change ticket.
ListDataCorrectPreCheckDBCall ListDataCorrectPreCheckDB to obtain the database list of the precheck step in a data change ticket.
PauseDataCorrectSQLJobCall PauseDataCorrectSQLJob to pause a running data change SQL task.
RetryDataCorrectPreCheckCall RetryDataCorrectPreCheck to re-execute the precheck step of a data change ticket.
RestartDataCorrectSQLJobCall RestartDataCorrectSQLJob to retry a failed data change SQL task.
Schema designCreatePublishGroupTaskCall CreatePublishGroupTask to execute a schema design change.
ListDDLPublishRecordsCall ListDDLPublishRecords to obtain the publishing details of a schema design ticket.
Data exportingGetDataExportDownloadURLCall GetDataExportDownloadURL to obtain the download URL for the data exporting result attachment.
ExecuteDataExportCall ExecuteDataExport to execute a data exporting ticket.
GetDataExportOrderDetailCall GetDataExportOrderDetail to obtain the details of a data exporting ticket.
SQL reviewCreateSQLReviewOrderCall CreateSQLReviewOrder to create an SQL review ticket.
GetSQLReviewCheckResultStatusCall GetSQLReviewCheckResultStatus to obtain the review result of an SQL review ticket.
ListSQLReviewOriginSQLCall ListSQLReviewOriginSQL to obtain the SQL details from an SQL review ticket.
GetSQLReviewOptimizeDetailCall GetSQLReviewOptimizeDetail to obtain the details of optimization suggestions from an SQL review.
Attachment uploadCreateUploadFileJobCall the CreateUploadFileJob operation to create a task for uploading an attachment.
CreateUploadOSSFileJobCall the CreateUploadOSSFileJob operation to create a task for uploading an OSS attachment.
GetUserUploadFileJobCall GetUserUploadFileJob to obtain the task information for an uploaded attachment.

SQL tasks

APIDescription
ListDBTaskSQLJobCall ListDBTaskSQLJob to obtain a list of SQL tasks.
ListDBTaskSQLJobDetailCall ListDBTaskSQLJobDetail to obtain the details of an SQL task.
GetDBTaskSQLJobLogCall GetDBTaskSQLJobLog to obtain the scheduling detail logs of an SQL task.
GetOnlineDDLProgressCall the GetOnlineDDLProgress operation to obtain the execution progress details of an Online DDL task.

Permission management

APIDescription
SetOwnersCall SetOwners to set database and table owners.
RevokeUserPermissionCall RevokeUserPermission to revoke user permissions.
ListUserPermissionsCall ListUserPermissions to display the database and table permissions of a specified user.
ListDatabaseUserPermssionsCall ListDatabaseUserPermssions to display the permission details of users who have permissions on a specified database.
GrantUserPermissionCall GrantUserPermission to grant database and table permissions to a user.
ListInstanceUserPermissionsCall ListInstanceUserPermissions to obtain the list of user permissions for an instance.

Security management

CategoryAPIDescription
Security rule setsCreateStandardGroupCall CreateStandardGroup to create a security rule set.
ListStandardGroupsCall ListStandardGroups to obtain a list of security rule sets.
Secure access proxyCreateProxyCall CreateProxy to enable the data security protection proxy for a database instance.
CreateProxyAccessCall CreateProxyAccess to authorize a user to access a database instance through the data security protection proxy.
ListProxyAccessesCall ListProxyAccesses to obtain the authorization list for the security protection proxy.
InspectProxyAccessSecretCall InspectProxyAccessSecret to obtain the authorization password for the security protection proxy.
ListProxiesCall ListProxies to obtain a list of security protection proxies.
GetProxyCall GetProxy to obtain the details of a data security protection proxy.
DeleteProxyAccessCall DeleteProxyAccess to revoke the data security protection authorization of a target user.
DeleteProxyCall DeleteProxy to disable the data security protection proxy for a database instance.
Sensitive fieldsListSensitiveColumnsCall ListSensitiveColumns to search for a list of sensitive fields.
ListSensitiveColumnsDetailCall ListSensitiveColumnsDetail to obtain the details of sensitive fields.
AddDesensitizationRuleCall AddDesensitizationRule to add a desensitization rule.
ListDesensitizationRuleCall ListDesensitizationRule to obtain a list of desensitization rules.
ModifyDesensitizationStrategyCall ModifyDesensitizationStrategy to modify the desensitization rule attached to a field.
ListClassificationTemplatesCall the ListClassificationTemplates operation to obtain a list of classification templates.
ChangeColumnSecLevelCall ChangeColumnSecLevel to change the sensitivity level of a field.

Data query

APIDescription
ExecuteScriptCall ExecuteScript to execute an SQL script.

Data development

CategoryAPIDescription
Data warehouse developmentCreateLakeHouseSpaceCall the CreateLakeHouseSpace operation to create a new project in data warehouse development.
GetLhSpaceByNameCall the GetLhSpaceByName operation to query project information by project name.
DeleteLakeHouseSpaceCall the DeleteLakeHouseSpace operation to delete a project in data warehouse development.
ListLhTaskFlowAndScenarioCall the ListLhTaskFlowAndScenario operation to query the list of task flows that correspond to a business scenario in a project.
AddLhMembersCall the AddLhMembers operation to add an administrator, member, or task flow developer to a data warehouse development project.
DeleteLhMembersCall the DeleteLhMembers operation to delete a member or task flow developer from a data warehouse development project.
ChangeLhDagOwnerCall the ChangeLhDagOwner operation to change the owner of a task flow.
Task orchestrationListTaskFlowCall the ListTaskFlow operation to obtain a list of task flows.
DeleteTaskFlowCall the DeleteTaskFlow operation to delete a task flow.
OfflineTaskFlowCall the OfflineTaskFlow operation to unpublish a published task flow in DMS.
ListTaskFlowInstanceCall the ListTaskFlowInstance operation to obtain the running records of a task flow.
GetTaskInstanceRelationCall the GetTaskInstanceRelation operation to obtain the node information of a task flow running record.
ListDAGVersionsCall the ListDAGVersions operation to obtain a list of historical published versions of a task flow.
ReDeployLhDagVersionCall the ReDeployLhDagVersion operation to redeploy a historical version of a task flow.
CreateTaskFlowCall the CreateTaskFlow operation to create a task flow.
DeleteTaskCall the DeleteTask operation to delete a task in a task flow.
MakeTaskFlowInstanceSuccessCall the MakeTaskFlowInstanceSuccess operation to set the status of a specified task flow to successful.
SuspendTaskFlowInstanceCall the SuspendTaskFlowInstance operation to pause a running task flow instance.
PublishAndDeployTaskFlowCall the PublishAndDeployTaskFlow operation to publish and deploy a specified task flow.
ListTasksInTaskFlowCall the ListTasksInTaskFlow operation to obtain the list of task nodes in a specified task flow.
UpdateTaskConfigCall the UpdateTaskConfig operation to update the advanced configuration of a task.
ListTaskFlowConstantsCall the ListTaskFlowConstants operation to obtain the list of constants for a task flow.
UpdateTaskFlowConstantsCall the UpdateTaskFlowConstants operation to update the list of constants for a task flow.
ResumeTaskFlowInstanceCall the ResumeTaskFlowInstance operation to resume a paused task flow.
ListTaskFlowsByPageCall the ListTaskFlowsByPage operation to obtain a paginated list of task flow running records.
UpdateTaskContentCall the UpdateTaskContent operation to update a task in a task flow.
UpdateScenarioCall the UpdateScenario operation to update the name and description of a task flow business scenario.
ListScenariosCall the ListScenarios operation to obtain a list of business scenarios.
DeleteScenarioCall the DeleteScenario operation to delete a business scenario.
CreateScenarioCall the CreateScenario operation to create a business scenario. You can also use it to group task flows by business scenario.
UpdateTaskTimeVariablesCall the UpdateTaskTimeVariables operation to update the time variables of a task.
UpdateTaskFlowTimeVariablesCall the UpdateTaskFlowTimeVariables operation to update the time variables of a task flow.
ListTaskFlowTimeVariablesCall the ListTaskFlowTimeVariables operation to obtain the list of time variables for a task flow.
UpdateTaskFlowCooperatorsCall the UpdateTaskFlowCooperators operation to update the list of personnel related to a task flow.
MoveTaskFlowToScenarioCall the MoveTaskFlowToScenario operation to move a task flow to a specified business scenario.
UpdateTaskNameCall the UpdateTaskName operation to update a task name.
ListTaskFlowCooperatorsCall the ListTaskFlowCooperators operation to obtain the list of personnel related to a task flow.
UpdateTaskOutputCall the UpdateTaskOutput operation to update the output variables of a task node.
GetTaskCall the GetTask operation to obtain the configuration of a specified node by its ID, including the time variables of the task.
UpdateTaskFlowScheduleCall the UpdateTaskFlowSchedule operation to update the scheduling configuration of a task flow.
StopTaskFlowInstanceCall the StopTaskFlowInstance operation to stop a running task flow instance.
ReRunTaskFlowInstanceCall the ReRunTaskFlowInstance operation to rerun a task flow instance.
CreateTaskCall the CreateTask operation to create a task in a task flow.
UpdateTaskFlowNotificationCall the UpdateTaskFlowNotification operation to update the notification settings of a task flow.
DeleteTaskFlowEdgesByConditionCall the DeleteTaskFlowEdgesByCondition operation to delete the edges of a task flow based on multiple conditions.
ListTaskFlowEdgesByConditionCall the ListTaskFlowEdgesByCondition operation to obtain the edges of a directed acyclic graph (DAG) for a specified task flow based on multiple conditions.
UpdateTaskFlowEdgesCall the UpdateTaskFlowEdges operation to batch update the start and end nodes of specified edges in a task flow.
AddTaskFlowEdgesCall the AddTaskFlowEdges operation to create directed edges for existing task flow nodes.
GetTaskFlowGraphCall the GetTaskFlowGraph operation to obtain the DAG of a task flow.
UpdateTaskFlowRelationsCall the UpdateTaskFlowRelations operation to perform a full update on the edges of a task flow.
UpdateTaskFlowNameAndDescCall the UpdateTaskFlowNameAndDesc operation to update the name and description of a task flow.
UpdateTaskFlowOwnerCall the UpdateTaskFlowOwner operation to update the owner of a task flow.
GetTaskFlowNotificationCall the GetTaskFlowNotification operation to obtain the notification settings of a task flow.
BackFillCall the BackFill operation to backfill data for task orchestration.