创建字段 - CreateField
功能介绍
创建自定义数据类字段
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限,具体权限要求请参见权限和授权项。
URI
POST /v1/{project_id}/workspaces/{workspace_id}/soc/dataclasses/{dataclass_id}/fields
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取项目ID 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| workspace_id | 是 | String | 参数解释: 工作空间ID,用于指定操作的工作空间范围。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 获取方式: 可通过调用查询数据类列表接口获取,也可从控制台获取。 |
| dataclass_id | 是 | String | 参数解释: 数据类的唯一ID,用于指定操作的数据类。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 获取方式: 可通过调用查询数据类列表接口获取,也可从控制台获取。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。获取用户Token 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| content-type | 是 | String | 参数解释: 请求体的内容类型,用于指定请求体的媒体类型 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 字段ID 取值范围: 不涉及 |
| cloud_pack_version | String | 参数解释: 订阅包版本 取值范围: 不涉及 |
| business_id | String | 参数解释: 关联业务id 取值范围: 不涉及 |
| business_type | String | 参数解释: 关联业务 取值范围: 不涉及 |
| dataclass_name | String | 参数解释: 数据类名称 取值范围: 不涉及 |
| business_code | String | 参数解释: 业务编码 取值范围: 不涉及 |
| field_key | String | 参数解释: 字段键 取值范围: 不涉及 |
| name | String | 参数解释: 字段名称 取值范围: 不涉及 |
| description | String | 参数解释: 字段描述 取值范围: 不涉及 |
| default_value | String | 参数解释: 默认值 取值范围: 不涉及 |
| display_type | String | 参数解释: 显示类型 取值范围: 不涉及 |
| field_type | String | 参数解释: 字段类型 取值范围: |
| extra_json | String | 参数解释: 附加json 取值范围: 不涉及 |
| field_tooltip | String | 参数解释: 工具提示 取值范围: 不涉及 |
| iu_type | String | 参数解释: 输入输出类型 取值范围: 不涉及 |
| used_by | String | 参数解释: 使用业务 取值范围: 不涉及 |
| json_schema | String | 参数解释: json模式 取值范围: 不涉及 |
| is_built_in | Boolean | 参数解释: 是否内置,true内置,false非内置 取值范围: |
| case_sensitive | Boolean | 参数解释: 大小写敏感,true敏感,false不敏感 取值范围: |
| read_only | Boolean | 参数解释: 只读模式,true只读,false非只读 取值范围: |
| required | Boolean | 参数解释: 是否必填,true必填,false非必填 取值范围: |
| searchable | Boolean | 参数解释: 是否可搜索,true可搜索,false不可搜索 取值范围: |
| visible | Boolean | 参数解释: 是否可见 取值范围: |
| maintainable | Boolean | 参数解释: 是否可维护 取值范围: |
| editable | Boolean | 参数解释: 是否可编辑 取值范围: |
| creatable | Boolean | 参数解释: 是否可创建,true可创建,false不可创建 取值范围: |
| mapping | Boolean | 参数解释: 是否展示在分类映射外的其他地方 取值范围: |
| target_api | String | 参数解释: 目标api 取值范围: 不涉及 |
| creator_id | String | 参数解释: 创建人id 取值范围: 不涉及 |
| creator_name | String | 参数解释: 创建人名称 取值范围: 不涉及 |
| modifier_id | String | 参数解释: 修改人id 取值范围: 不涉及 |
| modifier_name | String | 参数解释: 修改人名称 取值范围: 不涉及 |
| create_time | String | 参数解释: 创建时间,格式为yyyy-MM-ddTHH:mm:ssZ+0800 取值范围: 不涉及 |
| update_time | String | 参数解释: 修改时间,格式为yyyy-MM-ddTHH:mm:ssZ+0800 取值范围: 不涉及 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 错误描述 取值范围: 不涉及 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 错误码 取值范围: 不涉及 |
| error_msg | String | 参数解释: 错误描述 取值范围: 不涉及 |
请求示例
新建自定义数据类字段
https://{endpoint}/v1/{project_id}/workspaces/{workspace_id}/soc/dataclasses/{dataclass_id}/fields
{
"field_key" : "kk",
"name" : "测试字段",
"field_type" : "String"
} 响应示例
状态码:200
{
"default_value" : "a;b",
"description" : "新增测试字段",
"display_type" : "text",
"field_key" : "test_key",
"field_type" : "String",
"id" : "3e94505d-478f-4619-bef9-2c60a9fe3401",
"mapping" : true,
"name" : "新增测试字段",
"required" : false,
"visible" : true
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数有误 |
| 500 | 请求失败 |
错误码
请参见错误码。