Find key pairs by searching criteria
GET/projects/:projectId/zones/:zoneName/keypairs
Return key pairs that match all searching criteria. Criteria are project identifier and key pairs name.
Request
Path Parameters
Project Identifier
Zone name
Query Parameters
Possible values: [creating
, updating
, deleting
, active
, error
]
State of the searched key pair.
Default value: 0
Requested pagination of response. The parameter offset is the index of the first element to retrieve. Zero is the first element of the collection.
Possible values: >= 1
Default value: 100
Requested pagination of response. The parameter limit is the maximum number of elements to retrieve (it can be greater than the actual available number of items).
Possible values: <= 100 characters
, Value must match regular expression -?[A-Za-z0-9]+(?:,[A-Za-z0-9]+)*
The list of field names to sort the result. Prefixing a field name with a "-" sign will indicate a descending order.
Header Parameters
Your SIU token if you use this API through Orange Developer.
Bearer access token authentication if you use this API through Orange Developer or Orange Developer Inside.
Your SIU Id if you use this API through Orange Developer Inside.
Responses
- 200
- 400
- 401
- 403
- 404
- 405
- 500
- 503
Ok
Response Headers
X-Total-Count
integer
Returns Pagination of response. The total number of items in the collection, after application of filters if any.
X-Result-Count
integer
The actual number of items contained in the response body. Note that it can be less than the requested "limit".
- application/json
- Schema
- Example (from schema)
- example
Schema
Array [
- creating: resource creation in progress
- updating: resource update in progress
- deleting: resource deletion in progress
- active: resource created/updated successfully
- error: resource in error because the last creation/update/deletion failed
]
Possible values: <= 40 characters
, Value must match regular expression [A-Za-z0-9-]
Unique resource name. This attribute can not be updated.
Resource description
tags
object
Tags associated with the resource
Resource identifier.
Hypertext reference of the resource.
Creation date of the resource.
Date of the last modification of the resource.
Identifier of the user of the last create/update/delete operation requested on the resource.
Possible values: [creating
, updating
, deleting
, active
, error
]
Provisioning state of the resource. Possible state:
Possible values: >= 512 characters
and <= 2000 characters
SSH Public Key to connect to virtual machines. If a public key is provided, it will be used to create the KeyPair resource. Otherwise, a public key and a private key will be automatically generated and their values will be returned as a result of the KeyPair creation request.
[
{
"name": "string",
"description": "string",
"tags": {},
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"hRef": "string",
"createdDate": "2024-10-02T15:25:04.050Z",
"lastModifiedDate": "2024-10-02T15:25:04.050Z",
"lastRequesterId": "string",
"provisioningState": "creating",
"publicKey": "string"
}
]
[{ "name": "myKP", "description": "a key pair", "tags": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "hRef": "/projects/{projectId}/zones/{zoneName}/keypairs/3fa85f64-5717-4562-b3fc-2c963f66afa6", "createdDate": "2024-03-19T14:35:47.684Z", "lastModifiedDate": "2024-03-19T14:35:47.684Z", "lastRequester": "string", "provisioningState": "creating", "publicKey": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAACAQCDiJAec5j4De6UlVI9mabo9KHlShVIIy4h8EWE+kZ/drdkRWyU+GfygMdTxgztymkJI81H/9TOad6n4j8n+/9TnJ+7RPR0gxuPJQ4UI0amOaM3x+Mo1ukqQCT4oXpVfC0MrZcBGoJ6yJCQB611/fVbsCWs5BMoypkX5HNV53gk6ak35WvbtlIN8uiZne4HXdHntTs1Ev7RGZjTluaIFbtJccGXqzYmkDpjgGbgI7bUY1mvkRetXIsorygticUzWo7luEn9g4YOQCvoZtFoUk0wYfs1fyfY5n4pCXC/0E2e+FyVDFqXhooKJkGYoJHnXVNA7fvlaWHJyLqGqrM6IJLGmK6RmXKEwN+4cQQRb2Q+FxQz53tAr0C25Aj0lEbZrQj27tEvIHlfe+FKtF4a4oLVD6xCRBKfWNgofyTm71z5P9Ejfh34TFXIkZJnEZovBPELv8FuS0dgwq/31X6hJpdeCy7ohg13efw2ElXvL/s8nAvtNTbS5f5jIib8LOCLBzmsOHcbxfjqLvi/HVRXwFTjIPlDBTXK+x8vaa16rwtlm0z+ICZTtDmt6lain0m0Kl/3T6MaUna9KHR1qjTd8tsB9w5fe2WEBJgbmrVClTFMLdwVRAAjPlpdmPYNxh4Pje0la]+2m3tS6Z3hMq/eYV+1dy1K4kEyC/qWw2wWSz+KQ==" }]
Bad Request
Request is not valid
- application/json
- Schema
- Example (from schema)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
Unauthorized
Credentials are missing
- application/json
- Schema
- Example (from schema)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
Forbidden
Valid credentials but not enough privileges to perform the operation
- application/json
- Schema
- Example (from schema)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
Not Found
Unknown resource or service
- application/json
- Schema
- Example (from schema)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
Method Not Allowed
Operation is not valid according to the state of the resource
- application/json
- Schema
- Example (from schema)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
Internal Server Error
Unexpected error, please contact support
- application/json
- Schema
- Example (from schema)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}
Service Unavailable
Service probably in maintenance. Please retry later.
- application/json
- Schema
- Example (from schema)
Schema
An integer coding the error type. This is given to caller so he can translate them if required.
A short localized string that describes the error.
(optional) A long localized error description if needed. It can contain precise information about which parameter is missing, or what are the identifier acceptable values.
{
"code": 0,
"message": "string",
"description": "string"
}