Querying Dictionaries
Function
This API is used to query dictionaries.
URI
GET /v2/{project_id}/instances/{instance_id}/dictionaries
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| instance_id | Yes | String | Instance ID. Minimum: 0 Maximum: 64 |
| project_id | Yes | String | Project ID. Minimum: 0 Maximum: 64 |
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| offset | No | String | Offset, which is greater than or equal to 0. Default: 0 Minimum: 0 Maximum: 64 |
| limit | No | String | Number of items displayed on each page. Default: 10 Minimum: 0 Maximum: 64 |
| parent_code | No | String | Parent dictionary code. The child dictionaries are returned. If this parameter is not specified, the top-level dictionaries are queried. Minimum: 0 Maximum: 64 |
| code | No | String | Code of the dictionary to query. Fuzzy match by dictionary code is supported. Minimum: 0 Maximum: 64 |
| name | No | String | Name of the dictionary to query. Fuzzy match by dictionary name is supported. Minimum: 0 Maximum: 64 |
Request 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 |
Response Parameters
Status code: 200
| Parameter | Type | Description |
|---|---|---|
| total | Integer | Total number of records, which is irrelevant to pagination. Minimum: 1 Maximum: 128 |
| size | Integer | Number of records displayed on the current page. The value must be less than or equal to the limit specified in the request. Minimum: 1 Maximum: 128 |
| dictionaries | Array of Dictionary objects | Dictionaries. |
| Parameter | Type | Description |
|---|---|---|
| id | String | Dictionary ID. Minimum: 0 Maximum: 64 |
| name | String | Dictionary name.
|
| remark | String | Dictionary description. |
| code | String | Dictionary code.
|
| order | Integer | Dictionary order. A smaller value indicates a higher order. |
| extend_one | String | Extended field 1.
|
| extend_two | String | Extended field 2.
|
| parent_code | String | Parent dictionary code. If the value is null, the dictionary is a top-level dictionary. |
| type | String | Dictionary type.
|
| 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
| 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
None
Example Responses
Status code: 200
OK
{
"total" : 0,
"size" : 0,
"dictionaries" : [ {
"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 |
|---|---|
| 200 | OK |
| 403 | Forbidden |
Error Codes
See Error Codes.
Last Article: Verifying the Existence of a Dictionary
Next Article: Creating a Dictionary
Did this article solve your problem?
Thank you for your score!Your feedback would help us improve the website.