Get the Datacenter details of datacente given.
GET {{baseUrl}}/v1/datacenter/:datacenter_id
What
Obtain the details of the Datacenter ID passed as a parameter.
Parameters
The endpoint accepts only the following parameter in the path:
- datacenter_id: (Mandatory) The internal Datacenter ID to be queried.
Result
The result is a JSON object with the following structure:
- self: the URI of the API call
- name: the generic name of the Datacenter. The database takes the name from different sources, so it may be different from the real name.
- description: a full name of the Datacenter. It contains more details about the Datacenter.
- source: website of the company that owns the Datacenter.
- asn: the URI to the ASN of the Datacenter.
- status: the status of the Datacenter. It can be: enabled or disabled.
- prefixes: the URI to the list of prefixes that belong to the Datacenter.
- score: The risk score of the Datacenter. It ranges from 0 to 99.
- risk: The risk of the Datacenter. The allowed values are: LOW, MEDIUM, HIGH. It's a human readable representation of the score.
Errors
The endpoint will return the following errors:
- a 404 Not Found error if the Datacenter was not found.
- a 422 Unprocessable Entity error if the Datacenter is malformed.
It will also return the API Global errors described in the API description.
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"self":"quis sint","name":"pariatur e","source":"Ut et velit","asn":"ullamco","prefixes":"magna sin","description":"ipsum","status":"enabled","score":91771665,"risk":"MEDIUM"}