IP Adressen des Accounts auslesen

GET /v1/accounts/{accountIdentifier}/ip-addresses/

API version

v1

Request method

GET

Operation ID

getAccountIpAddresses

---

gibt die IP Adressen des Accounts zurück, die sich alls DNS Records eignen

Request

• accountIdentifierstring

  required

  Account name oder uid.

Responses

Format

application/json

Description

Liste der verfügbaren IP-Adressen

Schema documentation

• Array[
• *object
  • addressstring

    required

    Die IP-Adresse

  • typestring (one of: SHARED, EXCLUSIVE, PREMIUM, ACCOUNT, CUSTOMER)

    required

    Die Art der IP-Adresse

  • versionnumber (one of: 4, 6)

    required

    die ip Version

  • commonNamestring

    required

    Der Common Name des SSL-Zertifikats, falls es eine SSL-IP ist

]

Example

[
  {
    "address": "string",
    "type": "SHARED",
    "version": 123,
    "commonName": "string"
  }
]

JSON Schema

{
  "type": "array",
  "items": {
    "type": "object",
    "required": [
      "address",
      "type",
      "commonName",
      "version"
    ],
    "properties": {
      "address": {
        "type": "string",
        "description": "Die IP-Adresse"
      },
      "type": {
        "type": "string",
        "description": "Die Art der IP-Adresse",
        "enum": [
          "SHARED",
          "EXCLUSIVE",
          "PREMIUM",
          "ACCOUNT",
          "CUSTOMER"
        ]
      },
      "version": {
        "type": "number",
        "description": "die ip Version",
        "enum": [
          4,
          6
        ]
      },
      "commonName": {
        "type": "string",
        "description": "Der Common Name des SSL-Zertifikats, falls es eine SSL-IP ist"
      }
    }
  }
}

Usage examples

cURL

$ curl \
    --fail \
    --location \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    https://api.mittwald.de/v1/accounts/string/ip-addresses