Retrieve Cluster
You can retrieve the information about a specific cluster using its clusterId
.
Endpoint
Use the regional endpoints to retrieve a specific cluster:
https://nfs.de-txl.ionos.com/clusters/{clusterId}
https://nfs.de-fra.ionos.com/clusters/{clusterId}
Request
curl -X 'GET' \
'https://nfs.de-txl.ionos.com/clusters/e69b22a5-8fee-56b1-b6fb-4a07e4205ead' \
-H 'accept: application/json'
To make authenticated requests to the API, the following fields are mandatory in the request header:
Header Parameters
Required
Type
Description
Authorization
yes
string
You can use Basic Authentication
or a Bearer token
. For more information, see Authentication.
Content-Type
yes
string
Set this to application/json
.
Response
A 200 message confirms that the specific cluster information is successfully retrieved.
{
"id": "e69b22a5-8fee-56b1-b6fb-4a07e4205ead",
"type": "cluster",
"href": "/clusters/e69b22a5-8fee-56b1-b6fb-4a07e4205ead",
"metadata": {
"createdDate": "2020-12-10T13:37:50+01:00",
"createdBy": "ionos:identity:::users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
"createdByUserId": "87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
"lastModifiedDate": "2020-12-11T13:37:50+01:00",
"lastModifiedBy": "ionos:identity:::users/87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
"lastModifiedByUserId": "87f9a82e-b28d-49ed-9d04-fba2c0459cd3",
"resourceURN": "ionos:<product>:<location>:<contract>:<resource-path>",
"status": "AVAILABLE",
"statusMessage": null
},
"properties": {
"name": "Cluster 1",
"connections": [
{
"datacenterId": "123e4567-e89b-12d3-a456-426614174001",
"lan": "1",
"ipAddress": "10.254.64.1/24"
}
],
"nfs": {
"minVersion": "4.2"
},
"size": 8
}
} ```
Last updated
Was this helpful?