Updated on 2022-12-05 GMT+08:00

Creating a Dictionary

Function

This API is used to create a dictionary.

URI

POST /v2/{project_id}/instances/{instance_id}/dictionaries

Table 1 Path parameters

Parameter

Mandatory

Type

Description

instance_id

Yes

String

Instance ID.

Minimum: 0

Maximum: 64

project_id

Yes

String

Project ID.

Minimum: 0

Maximum: 64

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token, which can be obtained by calling the IAM API (value of X-Subject-Token in the response header).

Minimum: 1

Maximum: 100000

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

name

Yes

String

Dictionary name.

  • Characters allowed: letters, digits, underscores (_), and spaces

  • Constraints: The value must be unique in an instance.

remark

No

String

Dictionary description.

code

Yes

String

Dictionary code.

  • Characters allowed: letters, digits, underscores (_), and spaces

  • Constraints: The value must be unique in an instance.

order

No

Integer

Dictionary order. A smaller value indicates a higher order.

extend_one

No

String

Extended field 1.

  • Characters allowed: letters, digits, underscores (_), and spaces

extend_two

No

String

Extended field 2.

  • Characters allowed: letters, digits, underscores (_), and spaces

parent_code

No

String

Parent dictionary code. If the value is null, the dictionary is a top-level dictionary.

Response Parameters

Status code: 201

Table 4 Response body parameters

Parameter

Type

Description

id

String

Dictionary ID.

Minimum: 0

Maximum: 64

name

String

Dictionary name.

  • Characters allowed: letters, digits, underscores (_), and spaces

  • Constraints: The value must be unique in an instance.

remark

String

Dictionary description.

code

String

Dictionary code.

  • Characters allowed: letters, digits, underscores (_), and spaces

  • Constraints: The value must be unique in an instance.

order

Integer

Dictionary order. A smaller value indicates a higher order.

extend_one

String

Extended field 1.

  • Characters allowed: letters, digits, underscores (_), and spaces

extend_two

String

Extended field 2.

  • Characters allowed: letters, digits, underscores (_), and spaces

parent_code

String

Parent dictionary code. If the value is null, the dictionary is a top-level dictionary.

type

String

Dictionary type.

  • system: built-in dictionary of the system. It can be edited but cannot be deleted.

  • user: dictionary created by a user.

create_time

Number

Time when the dictionary was created.

Minimum: 1

Maximum: 128

update_time

Number

Time when the dictionary was updated.

Minimum: 1

Maximum: 128

Status code: 403

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

Minimum: 1

Maximum: 128

error_msg

String

Error message.

Minimum: 1

Maximum: 128

error_details

String

Error information.

Minimum: 1

Maximum: 128

request_id

String

Request ID.

Minimum: 1

Maximum: 128

Example Requests

{
  "name" : "DictName",
  "remark" : "example",
  "code" : "13760c1fe8655e61209b75665e9bef43",
  "order" : "1",
  "extend_one" : "param1",
  "extend_two" : "param2",
  "parent_code" : ""
}

Example Responses

Status code: 201

OK

{
  "id" : "string",
  "name" : "string",
  "remark" : "string",
  "code" : "string",
  "order" : 0,
  "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"
}

Status code: 403

Forbidden

{
  "error_code" : "ROMA.00000101",
  "error_msg" : "error summary",
  "error_details" : "some error details here",
  "request_id" : "13760c1fe8655e61209b75665e9bef43"
}

Status Codes

Status Code

Description

201

OK

403

Forbidden

Error Codes

See Error Codes.