Detach a Compute instance from an Elastic IP

PUT /elastic-ip/{id}:detach

Path parameters

  • id string(uuid) Required

Body Required

  • instance object Required

    Instance

    • anti-affinity-groups array[object]

      Anti-affinity Group

    • public-ip-assignment string

      Instance public IP assignment

      Values are inet4, dual, or none.

    • labels object

      Private Network labels

    • security-groups array[object]

      Security Group

      • name string

        Security Group name

        Minimum length is 1, maximum length is 255.

      • description string

        Security Group description

        Maximum length is 255.

      • external-sources array[string]

        Security Group external sources

      • rules array[object]

        Security Group rule

        • description string

          Security Group rule description

          Maximum length is 255.

        • start-port integer(int64)

          Start port of the range

          Minimum value is 1, maximum value is 65535.

        • protocol string

          Network protocol

          Values are tcp, esp, icmp, udp, gre, ah, ipip, or icmpv6.

        • icmp object

          ICMP details

          • code integer(int64)

            Minimum value is -1, maximum value is 254.

          • type integer(int64)

            Minimum value is -1, maximum value is 254.

        • end-port integer(int64)

          End port of the range

          Minimum value is 1, maximum value is 65535.

        • security-group object

          Security Group

          • name string

            Security Group name

            Minimum length is 1, maximum length is 255.

          • visibility string

            Whether this points to a public security group. This is only valid when in the context of
            a rule addition which uses a public security group as a source or destination.

            Values are private or public.

        • network string

          CIDR-formatted network allowed

        • flow-direction string

          Network flow direction to match

          Values are ingress or egress.

    • elastic-ips array[object]

      Elastic IP

      • description string

        Elastic IP description

        Maximum length is 255.

      • healthcheck object

        Elastic IP address healthcheck

        • strikes-ok integer(int64)

          Number of attempts before considering the target healthy (default: 2)

          Minimum value is 1, maximum value is 20.

        • tls-skip-verify boolean

          Skip TLS verification

        • tls-sni string

          An optional domain or subdomain to check TLS against

          Minimum length is 1, maximum length is 255.

        • strikes-fail integer(int64)

          Number of attempts before considering the target unhealthy (default: 3)

          Minimum value is 1, maximum value is 20.

        • mode string Required

          Health check mode

          Values are tcp, http, or https.

        • port integer(int64) Required

          Health check port

          Minimum value is 1, maximum value is 65535.

        • uri string

          An endpoint to use for the health check, for example '/status'

          Minimum length is 1, maximum length is 255.

        • interval integer(int64)

          Interval between the checks in seconds (default: 10)

          Minimum value is 5, maximum value is 300.

        • timeout integer(int64)

          Health check timeout value in seconds (default: 2)

          Minimum value is 2, maximum value is 60.

      • labels object

        Private Network labels

    • name string

      Instance name

      Minimum length is 1, maximum length is 255.

    • instance-type object

      Compute instance type

    • private-networks array[object]

      Private Network

    • template object

      Instance template

      • description string

        Template description

        Maximum length is 255.

      • ssh-key-enabled boolean

        Enable SSH key-based login

      • name string

        Template name

        Minimum length is 1, maximum length is 255.

      • default-user string

        Template default user

        Minimum length is 1, maximum length is 255.

      • size integer(int64)

        Template size

        Minimum value is 0.

      • password-enabled boolean

        Enable password-based login

      • checksum string

        Template MD5 checksum

      • boot-mode string

        Boot mode (default: legacy)

        Values are legacy or uefi.

      • zones array[string]

        Zones availability

        Values are ch-dk-2, de-muc-1, ch-gva-2, at-vie-1, de-fra-1, bg-sof-1, or at-vie-2.

      • url string

        Template source URL

    • ssh-key object

      SSH key

      • name string

        SSH key name

        Minimum length is 1, maximum length is 255.

    • user-data string

      Instance Cloud-init user-data (base64 encoded)

      Minimum length is 1.

    • deploy-target object

      Deploy target

      • id string(uuid) Required

        Deploy Target ID

      • name string

        Deploy Target name

        Minimum length is 1, maximum length is 255.

      • type string

        Deploy Target type

        Values are edge or dedicated.

      • description string

        Deploy Target description

        Maximum length is 255.

    • snapshots array[object]

      Snapshot

      • name string

        Snapshot name

        Minimum length is 1, maximum length is 255.

      • state string

        Snapshot state

        Values are snapshotting, deleted, exporting, ready, deleting, error, or exported.

      • export object

        Exported snapshot information

        • presigned-url string

          Exported snapshot disk file pre-signed URL

        • md5sum string

          Exported snapshot disk file MD5 checksum

      • instance object

        Instance

    • disk-size integer(int64)

      Instance disk size in GB

      Minimum value is 10, maximum value is 50000.

    • ssh-keys array[object]

      SSH key

      • name string

        SSH key name

        Minimum length is 1, maximum length is 255.

Responses

  • • 200 object

    200

    • id string(uuid)

      Operation ID

    • reason string

      Operation failure reason

      Values are incorrect, unknown, unavailable, forbidden, busy, fault, partial, not-found, interrupted, unsupported, or conflict.

    • reference object

      Related resource reference

      • id string(uuid)

        Reference ID

      • link string

        Link to the referenced resource

      • command string

        Command name

    • message string

      Operation message

    • state string

      Operation status

      Values are failure, pending, success, or timeout.

PUT /elastic-ip/{id}:detach 
curl \
 -X PUT https://api-ch-gva-2.exoscale.com/v2/elastic-ip/{id}:detach \
 -H "Content-Type: application/json" \
 -d '{"instance":{"anti-affinity-groups":[{}],"public-ip-assignment":"inet4","labels":{},"security-groups":[{"name":"string","description":"string","external-sources":["string"],"rules":[{"description":"string","start-port":42,"protocol":"tcp","icmp":{"code":42,"type":42},"end-port":42,"security-group":{"name":"string","visibility":"private"},"network":"string","flow-direction":"ingress"}]}],"elastic-ips":[{"description":"string","healthcheck":{"strikes-ok":42,"tls-skip-verify":true,"tls-sni":"string","strikes-fail":42,"mode":"tcp","port":42,"uri":"string","interval":42,"timeout":42},"labels":{}}],"name":"string","instance-type":{},"private-networks":[{"name":"string","description":"string","netmask":"string","start-ip":"string","end-ip":"string","labels":{}}],"template":{"description":"string","ssh-key-enabled":true,"name":"string","default-user":"string","size":42,"password-enabled":true,"checksum":"string","boot-mode":"legacy","zones":["ch-dk-2"],"url":"string"},"ssh-key":{"name":"string"},"user-data":"string","deploy-target":{"id":"string","name":"string","type":"edge","description":"string"},"snapshots":[{"name":"string","state":"snapshotting","export":{"presigned-url":"string","md5sum":"string"},"instance":{}}],"disk-size":42,"ssh-keys":[{"name":"string"}]}}'
Request example 
{
  "instance": {
    "anti-affinity-groups": [
      {}
    ],
    "public-ip-assignment": "inet4",
    "labels": {},
    "security-groups": [
      {
        "name": "string",
        "description": "string",
        "external-sources": [
          "string"
        ],
        "rules": [
          {
            "description": "string",
            "start-port": 42,
            "protocol": "tcp",
            "icmp": {
              "code": 42,
              "type": 42
            },
            "end-port": 42,
            "security-group": {
              "name": "string",
              "visibility": "private"
            },
            "network": "string",
            "flow-direction": "ingress"
          }
        ]
      }
    ],
    "elastic-ips": [
      {
        "description": "string",
        "healthcheck": {
          "strikes-ok": 42,
          "tls-skip-verify": true,
          "tls-sni": "string",
          "strikes-fail": 42,
          "mode": "tcp",
          "port": 42,
          "uri": "string",
          "interval": 42,
          "timeout": 42
        },
        "labels": {}
      }
    ],
    "name": "string",
    "instance-type": {},
    "private-networks": [
      {
        "name": "string",
        "description": "string",
        "netmask": "string",
        "start-ip": "string",
        "end-ip": "string",
        "labels": {}
      }
    ],
    "template": {
      "description": "string",
      "ssh-key-enabled": true,
      "name": "string",
      "default-user": "string",
      "size": 42,
      "password-enabled": true,
      "checksum": "string",
      "boot-mode": "legacy",
      "zones": [
        "ch-dk-2"
      ],
      "url": "string"
    },
    "ssh-key": {
      "name": "string"
    },
    "user-data": "string",
    "deploy-target": {
      "id": "string",
      "name": "string",
      "type": "edge",
      "description": "string"
    },
    "snapshots": [
      {
        "name": "string",
        "state": "snapshotting",
        "export": {
          "presigned-url": "string",
          "md5sum": "string"
        },
        "instance": {}
      }
    ],
    "disk-size": 42,
    "ssh-keys": [
      {
        "name": "string"
      }
    ]
  }
}
Response example (200) 
{
  "id": "string",
  "reason": "incorrect",
  "reference": {
    "id": "string",
    "link": "string",
    "command": "string"
  },
  "message": "string",
  "state": "failure"
}