创建字典
功能介绍
创建字典。
URI
POST /v2/{project_id}/instances/{instance_id}/dictionaries
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
instance_id |
是 |
String |
实例ID。 |
project_id |
是 |
String |
项目ID,获取方式请参见API参考的“附录 > 获取项目ID”章节。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
name |
是 |
String |
字典名称。
|
remark |
否 |
String |
字典描述。 |
code |
是 |
String |
字典编码。
|
order |
否 |
Integer |
字典排序,值越小顺序越靠前。 |
extend_one |
否 |
String |
字典扩展字段1。 字符集:中文、英文字母、数字、下划线和空格。 |
extend_two |
否 |
String |
字典扩展字段2。 字符集:中文、英文字母、数字、下划线和空格。 |
parent_code |
否 |
String |
父字典编码,为空时代表自身就是最顶级字典。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
字典ID。 |
name |
String |
字典名称。
|
remark |
String |
字典描述。 |
code |
String |
字典编码。
|
extend_one |
String |
字典扩展字段1。 字符集:中文、英文字母、数字、下划线和空格。 |
extend_two |
String |
字典扩展字段2。 字符集:中文、英文字母、数字、下划线和空格。 |
parent_code |
String |
父字典编码,为空时代表自身就是最顶级字典。 |
type |
String |
字典类型。
|
create_time |
String |
创建时间。 |
update_time |
String |
更新时间。 |
状态码: 403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码。 |
error_msg |
String |
错误消息。 |
error_details |
String |
具体错误消息。 |
request_id |
String |
请求处理ID。 |
请求示例
创建一个数据字典,指定字典名称和字典编码,字典排序为1。
{ "name" : "DictName", "remark" : "example", "code" : "13760c1fe8655e61209b75665e9bef43", "order" : "1", "extend_one" : "param1", "extend_two" : "param2", "parent_code" : "" }
响应示例
状态码: 200
OK
{ "id" : "string", "name" : "string", "remark" : "string", "code" : "string", "extend_one" : "string", "extend_two" : "string", "parent_code" : "string", "type" : "system", "create_time" : "2019-12-06T06:49:04Z", "update_time" : "2019-12-06T06:49:04Z" }
状态码: 403
Forbidden
{ "error_code" : "ROMA.00000101", "error_msg" : "error summary", "error_details" : "some error details here", "request_id" : "13760c1fe8655e61209b75665e9bef43" }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
403 |
Forbidden |
错误码
请参见错误码。