更新已有数据源的连接、认证或展示信息。
接口说明
仅修改本次传入的参数，未传入的内容保持不变。数据源类型不能修改。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
dms:UpdateAgenticDataSource |
update |
*全部资源
|
无 | 无 |
请求语法
POST HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| DataSourceUuid |
string |
是 |
要更新的数据源 UUID。 |
cn-hangzhou_a1b2c3d4e5f6 |
| InstanceResourceId |
string |
否 |
新的云资源实例 ID；不传表示不更新。 |
rm-bp1234567890 |
| Alias |
string |
否 |
新的数据源显示名称；不传表示不更新。 |
demo_mysql |
| CatalogName |
string |
否 |
新的元数据目录名称；不传表示不更新。最长 128 个字符，以中文、字母或下划线开头，后续可包含数字和连字符，不能为纯数字。 |
demo_catalog |
| DbType |
string |
否 |
当前不支持修改数据源类型，请勿传入。 |
MYSQL |
| Host |
string |
否 |
可选。新的数据库域名或 IP，不包含协议、路径和端口；不传表示不更新。 |
mysql.example.com |
| Port |
integer |
否 |
可选。新的数据库服务端口；不传表示不更新。 |
3306 |
| Schema |
string |
否 |
可选。ADB_POSTGRESQL、DRDS、POSTGRESQL、POLARDB_POSTGRESQL 填数据库名；ORACLE 填 SID 或服务名，服务名前加 /；POLARDB_ORACLE 填 SID；MAXCOMPUTE 填 Project；其他类型不填。不传表示不更新。 |
postgres |
| SnowflakeWarehouse |
string |
否 |
Snowflake 计算仓库名称，仅 DbType=SNOWFLAKE 生效 |
WAREHOUSE |
| SnowflakeRole |
string |
否 |
Snowflake 角色名称，仅 DbType=SNOWFLAKE 生效 |
ROLE |
| AdbSparkResourceGroup |
string |
否 |
ADB MySQL Spark 资源组名称，仅 DbType=ADB_MYSQL_SPARK 生效。不传时保留原资源组；与 Schema（数据库名）独立，不能相互替代。 |
resourceGroup1 |
| AuthType |
integer |
否 |
可选。取值：-1-无需认证，0-用户名和密码，1-仅密码，2-免密；不传表示不更新。 |
0 |
| AuthAccount |
string |
否 |
新的登录用户名；不传表示不更新。 |
db_user |
| AuthPassword |
string |
否 |
新的登录密码；不传表示不更新。属于敏感信息，请勿记录或泄露。 |
P@ss**** |
| UseSsl |
integer |
否 |
新的 SSL 设置：1-启用，0-关闭，-1-使用默认设置；不传表示不更新。仅 ADB_MYSQL、CLICKHOUSE、MARIADB、MYSQL、OCEANBASEX、POLARDB、SELECTDB、STARROCKS 支持 SSL。 |
1 |
| RoleArn |
string |
否 |
新的阿里云 RAM 角色 ARN；不传表示不更新。 |
acs:ram::123456789012****:role/DataSourceRole |
| KmsSecret |
string |
否 |
新的 KMS 托管凭据名称；不传表示不更新。 |
datasource-secret |
| EnvType |
string |
否 |
环境类型。取值：product、pre、dev、test、sit、uat、pet、stag；不传表示不更新。 |
product |
| SyncAlias |
integer |
否 |
是否使用云端实例名称作为数据源名称：1-是，0-否；不传表示不更新。 |
0 |
| CreateMode |
string |
否 |
录入方式：INSTANCE_ID-选择已有云实例，HOST_PORT-按连接地址和端口录入；不传表示不更新。 |
HOST_PORT |
| PolicyId |
string |
否 |
可选。新的数据访问安全策略 ID；不传表示不更新。 |
sp-usr-example |
| VpcId |
string |
否 |
VPC NAT 链路访问数据源时使用的专有网络 VPC ID，用于补充实例明细中缺失的 VPC 信息。可选，不传时保留原值。 |
vpc-25cdvfeq58pl**** |
| ZoneId |
string |
否 |
VPC NAT 链路访问数据源时使用的可用区 ID。可选，不传时保留原值。 |
cn-hangzhou-d |
| VSwitchId |
string |
否 |
VPC NAT 链路访问数据源时使用的虚拟交换机 ID。可选，不传时保留原值。 |
vsw-23dscddcffvf3**** |
DataSourceUuid 按接口模型要求传入；其他参数均为可选，不传表示不更新。
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
接口响应。 |
||
| RequestId |
string |
请求 ID，用于定位本次调用。 |
request-1234567890 |
| Success |
boolean |
本次调用是否成功。 |
|
| ErrorMessage |
string |
调用失败时返回的错误信息；成功时为空。 |
参数不合法。 |
| ErrorCode |
string |
调用失败时返回的错误码；成功时为空。 |
InvalidParameter |
| Data |
object |
更新后的数据源详情。 |
|
| DataSourceUuid |
string |
数据源的唯一标识。 |
cn-hangzhou_a1b2c3d4e5f6 |
| RegionId |
string |
数据源所在地域。 |
cn-hangzhou |
| ResourceAccountId |
string |
资源所属的阿里云主账号 ID。 |
123456789012**** |
| InstanceSource |
string |
数据源来源。取值：RDS-云数据库实例，PUBLIC_OWN-公网自建数据库，ECS_OWN-ECS 自建数据库，GATEWAY-通过数据库网关接入，VPC_IDC-专有网络或 IDC 接入。 |
RDS |
| InstanceResourceId |
string |
云资源实例 ID；按连接地址录入的数据源可能为空。 |
rm-bp1234567890 |
| Alias |
string |
数据源的显示名称。 |
demo_mysql |
| CatalogName |
string |
数据源关联的元数据目录（Catalog）名称。 |
demo_catalog |
| EnvType |
string |
环境类型。取值：product、pre、dev、test、sit、uat、pet、stag。 |
product |
| DbType |
string |
数据源类型。当前支持：MYSQL、POSTGRESQL、ORACLE、SQLSERVER、MARIADB、POLARDB、POLARDB_POSTGRESQL、POLARDB_ORACLE、OCEANBASEX、DRDS、ADB_MYSQL、ADB_POSTGRESQL、CLICKHOUSE、SELECTDB、STARROCKS、HOLOGRES、MAXCOMPUTE、ES_REST、TRINO。 |
MYSQL |
| Host |
string |
数据源连接地址；敏感场景可能返回脱敏值。 |
mysql.example.com |
| Schema |
string |
连接目标名称。ADB_POSTGRESQL、DRDS、POSTGRESQL、POLARDB_POSTGRESQL 表示数据库名；ORACLE 表示 SID 或服务名；POLARDB_ORACLE 表示 SID；MAXCOMPUTE 表示 Project；其他类型通常为空。 |
postgres |
| RoleArn |
string |
访问数据源使用的阿里云 RAM 角色 ARN；未使用角色授权时为空。 |
acs:ram::123456789012****:role/DataSourceRole |
| AuthAccount |
string |
数据源登录用户名；未使用用户名认证时为空。 |
db_user |
| GmtCreate |
string |
数据源创建时间，格式为 yyyy-MM-dd HH:mm:ss。 |
2026-10-13 14:30:00 |
| GmtModified |
string |
数据源最后修改时间，格式为 yyyy-MM-dd HH:mm:ss。 |
2026-10-13 14:35:00 |
| CreateMode |
string |
数据源录入方式：INSTANCE_ID-选择已有云实例，HOST_PORT-按连接地址和端口录入。 |
HOST_PORT |
| SyncAlias |
integer |
是否使用云端实例名称作为数据源名称：1-是，0-否。 |
0 |
| Port |
integer |
数据源连接端口。 |
3306 |
| UseSsl |
integer |
SSL 设置：1-启用，0-关闭，-1-使用默认设置。 |
1 |
| AuthType |
integer |
认证方式：-1-无需认证，0-用户名和密码，1-仅密码，2-免密。 |
0 |
| State |
integer |
数据源状态：0-正常，-1-已删除，-2-已禁用。 |
0 |
| KmsSecret |
string |
KMS 托管凭据名称；未使用 KMS 时为空，属于敏感信息。 |
datasource-secret |
| AuthPassword |
string |
密码或令牌的脱敏值，不会返回真实内容。 |
P@ss**** |
| PolicyId |
string |
当前使用的数据访问安全策略 ID；未设置时为空。 |
sp-usr-example |
| AdbSparkResourceGroup |
string |
ADB MySQL Spark 资源组名称，仅 DbType=ADB_MYSQL_SPARK 的数据源详情返回；与 Schema（数据库名）独立。 |
resourceGroup1 |
返回更新后的数据源信息。
示例
正常返回示例
JSON格式
{
"RequestId": "request-1234567890",
"Success": true,
"ErrorMessage": "参数不合法。",
"ErrorCode": "InvalidParameter",
"Data": {
"DataSourceUuid": "cn-hangzhou_a1b2c3d4e5f6",
"RegionId": "cn-hangzhou",
"ResourceAccountId": "123456789012****",
"InstanceSource": "RDS",
"InstanceResourceId": "rm-bp1234567890",
"Alias": "demo_mysql",
"CatalogName": "demo_catalog",
"EnvType": "product",
"DbType": "MYSQL",
"Host": "mysql.example.com",
"Schema": "postgres",
"RoleArn": "acs:ram::123456789012****:role/DataSourceRole",
"AuthAccount": "db_user",
"GmtCreate": "2026-10-13 14:30:00",
"GmtModified": "2026-10-13 14:35:00",
"CreateMode": "HOST_PORT",
"SyncAlias": 0,
"Port": 3306,
"UseSsl": 1,
"AuthType": 0,
"State": 0,
"KmsSecret": "datasource-secret",
"AuthPassword": "P@ss****",
"PolicyId": "sp-usr-example",
"AdbSparkResourceGroup": "resourceGroup1"
}
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。