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.