Get the Datacenter details of datacente given.

v1.0.0

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.

Input

{
  "type": "object",
  "properties": {
    "datacenter_id": {
      "type": "string"
    }
  },
  "required": [
    "datacenter_id"
  ],
  "additionalProperties": false
}

Output

{
  "type": "object",
  "required": [
    "asn",
    "name",
    "prefixes",
    "self",
    "source"
  ],
  "properties": {
    "asn": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "prefixes": {
      "type": "string"
    },
    "risk": {
      "type": "string",
      "enum": [
        "UNKNOWN",
        "LOW",
        "MEDIUM",
        "HIGH"
      ]
    },
    "score": {
      "type": "integer"
    },
    "self": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "disabled",
        "enabled"
      ]
    }
  }
}