Querying Signature Keys
Function
This API is used to query all the signature keys.
URI
GET /v2/{project_id}/apic/instances/{instance_id}/signs
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
project_id |
Yes |
String |
Project ID. For details about how to obtain the project ID, see Appendix > Obtaining a Project ID in the ROMA Connect API Reference. |
|
instance_id |
Yes |
String |
Instance ID. |
|
Parameter |
Mandatory |
Type |
Description |
|---|---|---|---|
|
offset |
No |
Long |
Offset from which the query starts. If the offset is less than 0, the value is automatically converted to 0. Default: 0 |
|
limit |
No |
Integer |
Number of items displayed on each page. Minimum: 1 Maximum: 500 Default: 20 |
|
id |
No |
String |
Signature key ID. |
|
name |
No |
String |
Signature key name. |
|
precise_search |
No |
String |
Parameter name for exact matching. If multiple parameters need to support exact match, separate them with commas (,). Currently, only name is supported. |
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). |
Response Parameters
Status code: 200
|
Parameter |
Type |
Description |
|---|---|---|
|
size |
Integer |
Length of the returned resource list. |
|
total |
Long |
Number of resources that match the query conditions. |
|
signs |
Array of SignatureWithBindNum objects |
Signature key list. |
|
Parameter |
Type |
Description |
|---|---|---|
|
name |
String |
Signature key name. The value can contain only letters, digits, and underscores(_) and must start with a letter.
NOTE:
Characters must be in UTF-8 or Unicode format. Minimum: 3 Maximum: 64 |
|
sign_type |
String |
Signature key type.
The basic key type requires the instance to be upgraded to the corresponding version. If the basic key configuration does not exist in the instance, contact technical support to upgrade the instance. The public_key type can be used only when public_key is enabled for the instance. For details about the instance feature configuration, see Appendix > APIC Features Supported by ROMA Connect Instances in the API Reference. If the public_key configuration does not exist in the instance, contact technical support to enable public_key. The aes key type requires the instance to be upgraded to the corresponding version. If the basic key configuration does not exist in the instance, contact technical support to upgrade the instance. |
|
sign_key |
String |
Signature key.
|
|
sign_secret |
String |
Signature secret.
|
|
sign_algorithm |
String |
Signature algorithm. The default value is empty. Only AES signature keys support the signature algorithm. Other signature keys do not support the signature algorithm. |
|
update_time |
String |
Update time. |
|
create_time |
String |
Creation time. |
|
id |
String |
Signature key ID. |
|
bind_num |
Integer |
Number of bound APIs. |
|
ldapi_bind_num |
Integer |
Number of bound custom backends. |
Status code: 400
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. |
|
error_msg |
String |
Error description. |
Status code: 401
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. |
|
error_msg |
String |
Error description. |
Status code: 403
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. |
|
error_msg |
String |
Error description. |
Status code: 404
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. |
|
error_msg |
String |
Error description. |
Status code: 500
|
Parameter |
Type |
Description |
|---|---|---|
|
error_code |
String |
Error code. |
|
error_msg |
String |
Error description. |
Example Requests
None
Example Responses
Status code: 200
OK
{
"total" : 2,
"size" : 2,
"signs" : [ {
"sign_secret" : "signsecretsignsecretsignsecretsignsecret",
"update_time" : "2018-02-07T02:00:27.964766Z",
"create_time" : "2018-02-06T12:17:36Z",
"name" : "signature_demo",
"id" : "0b0e8f456b8742218af75f945307173c",
"sign_key" : "signkeysignkey",
"sign_type" : "hmac",
"bind_num" : 0,
"ldapi_bind_num" : 0
}, {
"sign_secret" : "9ce16b029034464898ee33540c42e16a",
"update_time" : "2020-07-30T03:56:58Z",
"create_time" : "2020-07-30T03:56:58Z",
"name" : "Signature_udlu",
"id" : "9dc388382fba485aadd19f932303f4c9",
"sign_key" : "ca50c5b670044c83b5b890a9a68a30d5",
"sign_type" : "hmac",
"bind_num" : 0,
"ldapi_bind_num" : 0
} ]
}
Status code: 400
Bad Request
{
"error_code" : "APIG.2012",
"error_msg" : "Invalid parameter value,parameterName:name. Please refer to the support documentation"
}
Status code: 401
Unauthorized
{
"error_code" : "APIG.1002",
"error_msg" : "Incorrect token or token resolution failed"
}
Status code: 403
Forbidden
{
"error_code" : "APIG.1005",
"error_msg" : "No permissions to request this method"
}
Status code: 404
Not Found
{
"error_code" : "APIG.3030",
"error_msg" : "The instance does not exist;id:f0fa1789-3b76-433b-a787-9892951c620ec"
}
Status code: 500
Internal Server Error
{
"error_code" : "APIG.9999",
"error_msg" : "System error"
}
Status Codes
|
Status Code |
Description |
|---|---|
|
200 |
OK |
|
400 |
Bad Request |
|
401 |
Unauthorized |
|
403 |
Forbidden |
|
404 |
Not Found |
|
500 |
Internal Server Error |
Error Codes
See Error Codes.
Last Article: Deleting a Signature Key
Next Article: Binding/Unbinding Signature Keys
Did this article solve your problem?
Thank you for your score!Your feedback would help us improve the website.