编辑应用 - ModifyApplication
功能介绍
本接口用于在工业数字模型驱动引擎(Industrial Digital Model Engine,简称iDME)中修改目标应用的信息。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,需具备如下身份策略权限。
授权项
访问级别
资源类型(*为必须)
条件键
别名
依赖的授权项
dme:apps:update
Write
-
-
dme:apps:modify
-
URI
PUT /v1/{project_id}/apps/{app_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,用于标识资源所属的项目空间。 获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 由英文字母和数字组成,长度为1-36个字符。 默认取值: 不涉及。 |
| app_id | 是 | String | 参数解释: 应用唯一标识,用于指定要删除的应用。 约束限制: 不涉及。 取值范围: 由英文和数字组成。当唯一标识为应用名称时,长度为1-36个字符;当唯一标识为应用ID时,长度固定为32个字符。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: IAM用户的认证Token,用于接口调用身份鉴权。 获取方法请参见获取IAM用户Token。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| id | 是 | String | 参数解释: 应用的唯一标识。 约束限制: 不涉及。 取值范围: 由英文和数字组成。当唯一标识为应用名称时,长度为1-36个字符;当唯一标识为应用ID时,长度固定为32个字符。 默认取值: 不涉及。 |
| description | 是 | String | 参数解释: 应用的中文描述,用于说明应用的功能或用途。 约束限制: 不涉及。 取值范围: 仅支持中文、大小写英文字母、数字、括号、“_”、“-”、空格、标点符号,最大长度1024个字符。 默认取值: 不涉及。 |
| description_en | 是 | String | 参数解释: 应用的英文描述,用于说明应用的功能或用途(英文)。 约束限制: 不涉及。 取值范围: 仅支持大小写英文字母、数字、“_”、“-”、空格、标点符号,最大长度1024个字符。 默认取值: 不涉及。 |
| app_user_list | 是 | Array of AppUserList objects | 参数解释: 应用责任人列表,用于指定应用的管理者和使用者。 约束限制: 必须填写当前租户下的IAM用户信息,且不能为空数组。 取值范围: AppUserList对象数组,每个对象包含用户ID和用户名。 默认取值: 不涉及。 |
| permission_control | 否 | String | 参数解释: 应用的权限控制策略,用于数据访问安全控制。 约束限制: 不涉及。 取值范围: 默认取值: 不涉及。 |
| id_type | 否 | String | 参数解释: 应用ID类型,设置应用运行态中数据模型的内置ID(即唯一编码)属性类型。 约束限制: 仅支持由数值改为文本,不支持由文本改为数值,且文本类型的应用仅支持JDK17版本。 取值范围: 默认取值: LONG。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 应用的唯一标识,由系统自动生成。 取值范围: 由英文和数字组成,且长度固定为32个字符。 |
| project_id | String | 参数解释: 项目ID,用于标识资源所属的项目空间。 取值范围: 由英文字母和数字组成,长度为1-36个字符。 |
| mark_for_delete | Integer | 参数解释: 逻辑删除标记,标识数据是否被标记删除。 取值范围: |
| create_by | String | 参数解释: 应用创建人的用户名。 取值范围: 不涉及。 |
| create_time | Long | 参数解释: 应用的创建时间,格式为Unix时间戳(毫秒)。 取值范围: 不涉及。 |
| update_by | String | 参数解释: 最近一次更新应用的用户名。 取值范围: 不涉及。 |
| update_time | Long | 参数解释: 应用的最近更新时间,格式为Unix时间戳(毫秒)。 取值范围: 不涉及。 |
| name_cn | String | 参数解释: 应用的中文名称。 取值范围: 仅支持中文、英文字母、数字、下划线(_)、短横线(-),且不能为“XDM”(不区分大小写),最大长度为128个字符。 |
| name_en | String | 参数解释: 应用的英文名称。 取值范围: 仅支持英文字母和数字,且必须以大写字母开头,且不能为“XDM”(不区分大小写),最大长度为128个字符。 |
| desc_cn | String | 参数解释: 应用的中文描述。 取值范围: 仅支持中文、英文字母(大小写)、数字、括号、下划线(_)、短横线(-)、空格及常用标点符号,最大长度为1024个字符。 |
| desc_en | String | 参数解释: 应用的英文描述。 取值范围: 仅支持英文字母(大小写)、数字、下划线(_)、短横线(-)、空格及常用标点符号,最大长度为1024个字符。 |
| database_type | String | 参数解释: 应用的数据库类型。 取值范围: |
| environment | String | 参数解释: 应用运行的环境标识。 取值范围: |
| versions | Array of Version objects | 参数解释: 应用版本信息。 取值范围: 不涉及。 |
| migrating | Boolean | 参数解释: 判断是否在迁移中。 取值范围: true:迁移中。 false:未迁移。 |
| migrate_status | String | 参数解释: 迁移状态。 取值范围: |
| app_type | String | 参数解释: 应用的使用场景类型,区分不同的应用规模。 取值范围: |
| permission_control | String | 参数解释: 应用的权限控制策略,用于数据访问安全控制。 取值范围: |
| id_type | String | 参数解释: 应用的ID类型,用于应用运行态中数据模型内置ID的属性类型。 取值范围: |
请求示例
编辑应用的基本信息。
PUT https://{endpoint}/v1/1234567890/apps/0069c1abcfda420e9e27588cefbe86dd
{
"id" : "0069c1abcfda420e9e27588cefbe86dd",
"description" : "更新后的中文应用描述",
"description_en" : "Updated English application description",
"app_user_list" : [ {
"id" : "user001",
"name" : "ADMIN"
}, {
"id" : "user002",
"name" : "DEVELOPER"
} ],
"permission_control" : "ALL",
"id_type" : "STRING"
} 响应示例
状态码:200
表示应用信息更新成功。
{
"id" : "0069c1abcfda420e9e27588cefbe86dd",
"project_id" : "71710b9f65b9496d96f53f4ef7f6128b",
"mark_for_delete" : 0,
"create_by" : "",
"create_time" : 1685987901000,
"update_by" : "",
"update_time" : 1685987901000,
"name_cn" : "wdqw222",
"name_en" : "QDwqwq222",
"desc_cn" : "QDwqwq222",
"desc_en" : "qewqew222",
"database_type" : "mysql",
"environment" : "dev",
"migrate_status" : "0",
"app_type" : "default",
"permission_control" : "NONE",
"id_type" : "LONG",
"versions" : null,
"migrating" : false
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 表示应用信息更新成功。 |
错误码
请参见错误码。