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"}