Retrieve Load Balancer details

GET /load-balancer/{id}

Path parameters

id string(uuid) Required

Responses

200 application/json

200
Hide response attributes Show response attributes object
- id string(uuid)
  
  Load Balancer ID
- description string
  
  Load Balancer description
  
  Maximum length is 255.
- name string
  
  Load Balancer name
  
  Minimum length is 1, maximum length is 255.
- state string
  
  Load Balancer state
  
  Values are creating, migrated, deleting, running, migrating, or error.
- created-at string(date-time)
  
  Load Balancer creation date
- ip string(ipv4)
  
  Load Balancer public IP
- services array[object]
  
  Load Balancer Services
  
  Hide services attributes Show services attributes object
  
  description string
  
  Load Balancer Service description
  
  Maximum length is 255.
  
  protocol string
  
  Network traffic protocol
  
  Values are tcp or udp.
  
  name string
  
  Load Balancer Service name
  
  Minimum length is 1, maximum length is 255.
  
  state string
  
  Load Balancer Service state
  
  Values are creating, deleting, running, updating, or error.
  
  target-port integer(int64)
  
  Port on which the network traffic will be forwarded to on the receiving instance
  
  Minimum value is 0.
  
  port integer(int64)
  
  Port exposed on the Load Balancer's public IP
  
  Minimum value is 0.
  
  instance-pool object
  
  Instance Pool to forward network traffic to
  
  Additional properties are allowed.
  
  Hide instance-pool attributes Show instance-pool attributes object
  
  anti-affinity-groups array[object]
  
  Instance Pool Anti-affinity Groups
  
  Hide anti-affinity-groups attributes Show anti-affinity-groups attributes object
  
  id string(uuid)
  
  Anti-affinity Group ID
  
  name string
  
  Anti-affinity Group name
  
  Minimum length is 1, maximum length is 255.
  
  description string
  
  Anti-affinity Group description
  
  Maximum length is 255.
  
  instances array[object]
  
  Anti-affinity Group instances
  
  Hide instances attributes Show instances attributes object
  
  anti-affinity-groups array[object]
  
  Instance Anti-affinity Groups
  
  Anti-affinity Group
  
  Additional properties are allowed.
  
  public-ip-assignment string
  
  Instance public IP assignment
  
  Values are inet4, dual, or none.
  
  labels object
  
  Resource labels
  
  Hide labels attribute Show labels attribute object
  
  * string Additional properties
  
  security-groups array[object]
  
  Instance Security Groups
  
  Hide security-groups attributes Show security-groups attributes object
  
  id string(uuid)
  
  Security Group ID
  
  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
  
  elastic-ips array[object]
  
  Instance Elastic IPs
  
  Hide elastic-ips attributes Show elastic-ips attributes object
  
  id string(uuid)
  
  Elastic IP ID
  
  ip string
  
  Elastic IP address
  
  addressfamily string
  
  Elastic IP address family
  
  Values are inet4 or inet6.
  
  cidr string
  
  Elastic IP cidr
  
  description string
  
  Elastic IP description
  
  Maximum length is 255.
  
  healthcheck object
  
  Elastic IP healthcheck
  
  Additional properties are allowed.
  
  Hide healthcheck attributes Show healthcheck attributes object
  
  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
  
  Resource labels
  
  Hide labels attribute Show labels attribute object
  
  * string Additional properties
  
  name string
  
  Instance name
  
  Minimum length is 1, maximum length is 255.
  
  instance-type object
  
  Instance Type
  
  Additional properties are allowed.
  
  Hide instance-type attributes Show instance-type attributes object
  
  id string(uuid)
  
  Instance type ID
  
  size string
  
  Instance type size
  
  Values are large, huge, jumbo, medium, mega, small, extra-large, titan, micro, colossus, or tiny.
  
  family string
  
  Instance type family
  
  Values are gpu3, gpu3080ti, gpu2, gpu, memory, gpua5000, storage, standard, colossus, or cpu.
  
  cpus integer(int64)
  
  CPU count
  
  Minimum value is 0.
  
  gpus integer(int64)
  
  GPU count
  
  Minimum value is 0.
  
  authorized boolean
  
  Requires authorization or publicly available
  
  memory integer(int64)
  
  Available memory
  
  Minimum value is 0.
  
  zones array[string]
  
  Instance Type available zones
  
  Values are ch-dk-2, de-muc-1, ch-gva-2, at-vie-1, de-fra-1, bg-sof-1, or at-vie-2.
  
  private-networks array[object]
  
  Instance Private Networks
  
  Hide private-networks attributes Show private-networks attributes object
  
  id string(uuid)
  
  Private Network ID
  
  mac-address string
  
  Private Network MAC address
  
  template object
  
  Instance Template
  
  Additional properties are allowed.
  
  Hide template attributes Show template attributes object
  
  maintainer string
  
  Template maintainer
  
  description string
  
  Template description
  
  Maximum length is 255.
  
  ssh-key-enabled boolean
  
  Enable SSH key-based login
  
  family string
  
  Template family
  
  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
  
  build string
  
  Template build
  
  checksum string
  
  Template MD5 checksum
  
  boot-mode string
  
  Boot mode (default: legacy)
  
  Values are legacy or uefi.
  
  id string(uuid)
  
  Template ID
  
  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
  
  version string
  
  Template version
  
  created-at string(date-time)
  
  Template creation date
  
  visibility string
  
  Template visibility
  
  Values are private or public.
  
  state string
  
  Instance state
  
  Values are expunging, starting, destroying, running, stopping, stopped, migrating, error, or destroyed.
  
  ssh-key object
  
  Instance SSH Key
  
  Additional properties are allowed.
  
  Hide ssh-key attributes Show ssh-key attributes object
  
  name string
  
  SSH key name
  
  Minimum length is 1, maximum length is 255.
  
  fingerprint string
  
  SSH key fingerprint
  
  user-data string
  
  Instance Cloud-init user-data (base64 encoded)
  
  Minimum length is 1.
  
  mac-address string
  
  Instance MAC address
  
  manager object
  
  Instance manager
  
  Additional properties are allowed.
  
  Hide manager attributes Show manager attributes object
  
  id string(uuid)
  
  Manager ID
  
  type string
  
  Manager type
  
  Values are sks-nodepool or instance-pool.
  
  deploy-target object
  
  Instance Deploy Target
  
  Additional properties are allowed.
  
  Hide deploy-target attributes Show deploy-target attributes object
  
  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.
  
  ipv6-address string
  
  Instance IPv6 address
  
  id string(uuid)
  
  Instance ID
  
  snapshots array[object]
  
  Instance Snapshots
  
  Hide snapshots attributes Show snapshots attributes object
  
  id string(uuid)
  
  Snapshot ID
  
  name string
  
  Snapshot name
  
  Minimum length is 1, maximum length is 255.
  
  created-at string(date-time)
  
  Snapshot creation date
  
  state string
  
  Snapshot state
  
  Values are snapshotting, deleted, exporting, ready, deleting, error, or exported.
  
  size integer(int64)
  
  Snapshot size in GiB
  
  Minimum value is 10, maximum value is 51200.
  
  export object
  
  Exported snapshot information
  
  Additional properties are allowed.
  
  Hide export attributes Show export attributes object
  
  presigned-url string
  
  Exported snapshot disk file pre-signed URL
  
  md5sum string
  
  Exported snapshot disk file MD5 checksum
  
  instance object
  
  Compute Instance snapshotted
  
  Additional properties are allowed.
  
  disk-size integer(int64)
  
  Instance disk size in GiB
  
  Minimum value is 10, maximum value is 51200.
  
  ssh-keys array[object]
  
  Instance SSH Keys
  
  Hide ssh-keys attributes Show ssh-keys attributes object
  
  name string
  
  SSH key name
  
  Minimum length is 1, maximum length is 255.
  
  fingerprint string
  
  SSH key fingerprint
  
  created-at string(date-time)
  
  Instance creation date
  
  public-ip string(ipv4)
  
  Instance public IPv4 address
  
  description string
  
  Instance Pool description
  
  Minimum length is 1, maximum length is 255.
  
  public-ip-assignment string
  
  Instance public IP assignment
  
  Values are inet4, dual, or none.
  
  labels object
  
  Resource labels
  
  Hide labels attribute Show labels attribute object
  
  * string Additional properties
  
  security-groups array[object]
  
  Instance Pool Security Groups
  
  Hide security-groups attributes Show security-groups attributes object
  
  id string(uuid)
  
  Security Group ID
  
  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
  
  elastic-ips array[object]
  
  Instances Elastic IPs
  
  Hide elastic-ips attributes Show elastic-ips attributes object
  
  id string(uuid)
  
  Elastic IP ID
  
  ip string
  
  Elastic IP address
  
  addressfamily string
  
  Elastic IP address family
  
  Values are inet4 or inet6.
  
  cidr string
  
  Elastic IP cidr
  
  description string
  
  Elastic IP description
  
  Maximum length is 255.
  
  healthcheck object
  
  Elastic IP healthcheck
  
  Additional properties are allowed.
  
  Hide healthcheck attributes Show healthcheck attributes object
  
  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
  
  Resource labels
  
  Hide labels attribute Show labels attribute object
  
  * string Additional properties
  
  name string
  
  Instance Pool name
  
  Minimum length is 1, maximum length is 255.
  
  instance-type object
  
  Instance Type
  
  Additional properties are allowed.
  
  Hide instance-type attributes Show instance-type attributes object
  
  id string(uuid)
  
  Instance type ID
  
  size string
  
  Instance type size
  
  Values are large, huge, jumbo, medium, mega, small, extra-large, titan, micro, colossus, or tiny.
  
  family string
  
  Instance type family
  
  Values are gpu3, gpu3080ti, gpu2, gpu, memory, gpua5000, storage, standard, colossus, or cpu.
  
  cpus integer(int64)
  
  CPU count
  
  Minimum value is 0.
  
  gpus integer(int64)
  
  GPU count
  
  Minimum value is 0.
  
  authorized boolean
  
  Requires authorization or publicly available
  
  memory integer(int64)
  
  Available memory
  
  Minimum value is 0.
  
  zones array[string]
  
  Instance Type available zones
  
  Values are ch-dk-2, de-muc-1, ch-gva-2, at-vie-1, de-fra-1, bg-sof-1, or at-vie-2.
  
  min-available integer(int64)
  
  Minimum number of running instances
  
  Minimum value is 0.
  
  private-networks array[object]
  
  Instance Pool Private Networks
  
  Hide private-networks attributes Show private-networks attributes object
  
  description string
  
  Private Network description
  
  Maximum length is 255.
  
  labels object
  
  Resource labels
  
  Hide labels attribute Show labels attribute object
  
  * string Additional properties
  
  name string
  
  Private Network name
  
  Minimum length is 1, maximum length is 255.
  
  start-ip string(ipv4)
  
  Private Network start IP address
  
  leases array[object]
  
  Private Network leased IP addresses
  
  Hide leases attributes Show leases attributes object
  
  ip string(ipv4)
  
  Private Network IP address
  
  instance-id string(uuid)
  
  Attached instance ID
  
  id string(uuid)
  
  Private Network ID
  
  vni integer(int64)
  
  Private Network VXLAN ID
  
  Minimum value is 0.
  
  netmask string(ipv4)
  
  Private Network netmask
  
  options object
  
  DHCP options
  
  Additional properties are allowed.
  
  Hide options attributes Show options attributes object
  
  routers array[string(ipv4)]
  
  Routers
  
  dns-servers array[string(ipv4)]
  
  DNS Servers
  
  ntp-servers array[string(ipv4)]
  
  NTP Servers
  
  domain-search array[string]
  
  Domain search list, limited to 255 octets
  
  end-ip string(ipv4)
  
  Private Network end IP address
  
  template object
  
  Instance Template
  
  Additional properties are allowed.
  
  Hide template attributes Show template attributes object
  
  maintainer string
  
  Template maintainer
  
  description string
  
  Template description
  
  Maximum length is 255.
  
  ssh-key-enabled boolean
  
  Enable SSH key-based login
  
  family string
  
  Template family
  
  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
  
  build string
  
  Template build
  
  checksum string
  
  Template MD5 checksum
  
  boot-mode string
  
  Boot mode (default: legacy)
  
  Values are legacy or uefi.
  
  id string(uuid)
  
  Template ID
  
  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
  
  version string
  
  Template version
  
  created-at string(date-time)
  
  Template creation date
  
  visibility string
  
  Template visibility
  
  Values are private or public.
  
  state string
  
  Instance Pool state
  
  Values are scaling-up, scaling-down, destroying, creating, suspended, running, or updating.
  
  size integer(int64)
  
  Number of instances
  
  Minimum value is 0.
  
  ssh-key object
  
  Instance SSH Key
  
  Additional properties are allowed.
  
  Hide ssh-key attributes Show ssh-key attributes object
  
  name string
  
  SSH key name
  
  Minimum length is 1, maximum length is 255.
  
  fingerprint string
  
  SSH key fingerprint
  
  instance-prefix string
  
  The instances created by the Instance Pool will be prefixed with this value (default: pool)
  
  Minimum length is 1, maximum length is 30.
  
  user-data string
  
  Instances Cloud-init user-data
  
  Minimum length is 1.
  
  manager object
  
  Instance manager
  
  Additional properties are allowed.
  
  Hide manager attributes Show manager attributes object
  
  id string(uuid)
  
  Manager ID
  
  type string
  
  Manager type
  
  Values are sks-nodepool or instance-pool.
  
  instances array[object]
  
  Instances
  
  Hide instances attributes Show instances attributes object
  
  anti-affinity-groups array[object]
  
  Instance Anti-affinity Groups
  
  Anti-affinity Group
  
  Additional properties are allowed.
  
  public-ip-assignment string
  
  Instance public IP assignment
  
  Values are inet4, dual, or none.
  
  labels object
  
  Resource labels
  
  Hide labels attribute Show labels attribute object
  
  * string Additional properties
  
  security-groups array[object]
  
  Instance Security Groups
  
  Hide security-groups attributes Show security-groups attributes object
  
  id string(uuid)
  
  Security Group ID
  
  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
  
  elastic-ips array[object]
  
  Instance Elastic IPs
  
  Hide elastic-ips attributes Show elastic-ips attributes object
  
  id string(uuid)
  
  Elastic IP ID
  
  ip string
  
  Elastic IP address
  
  addressfamily string
  
  Elastic IP address family
  
  Values are inet4 or inet6.
  
  cidr string
  
  Elastic IP cidr
  
  description string
  
  Elastic IP description
  
  Maximum length is 255.
  
  healthcheck object
  
  Elastic IP healthcheck
  
  Additional properties are allowed.
  
  Hide healthcheck attributes Show healthcheck attributes object
  
  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
  
  Resource labels
  
  Hide labels attribute Show labels attribute object
  
  * string Additional properties
  
  name string
  
  Instance name
  
  Minimum length is 1, maximum length is 255.
  
  instance-type object
  
  Instance Type
  
  Additional properties are allowed.
  
  Hide instance-type attributes Show instance-type attributes object
  
  id string(uuid)
  
  Instance type ID
  
  size string
  
  Instance type size
  
  Values are large, huge, jumbo, medium, mega, small, extra-large, titan, micro, colossus, or tiny.
  
  family string
  
  Instance type family
  
  Values are gpu3, gpu3080ti, gpu2, gpu, memory, gpua5000, storage, standard, colossus, or cpu.
  
  cpus integer(int64)
  
  CPU count
  
  Minimum value is 0.
  
  gpus integer(int64)
  
  GPU count
  
  Minimum value is 0.
  
  authorized boolean
  
  Requires authorization or publicly available
  
  memory integer(int64)
  
  Available memory
  
  Minimum value is 0.
  
  zones array[string]
  
  Instance Type available zones
  
  Values are ch-dk-2, de-muc-1, ch-gva-2, at-vie-1, de-fra-1, bg-sof-1, or at-vie-2.
  
  private-networks array[object]
  
  Instance Private Networks
  
  Hide private-networks attributes Show private-networks attributes object
  
  id string(uuid)
  
  Private Network ID
  
  mac-address string
  
  Private Network MAC address
  
  template object
  
  Instance Template
  
  Additional properties are allowed.
  
  Hide template attributes Show template attributes object
  
  maintainer string
  
  Template maintainer
  
  description string
  
  Template description
  
  Maximum length is 255.
  
  ssh-key-enabled boolean
  
  Enable SSH key-based login
  
  family string
  
  Template family
  
  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
  
  build string
  
  Template build
  
  checksum string
  
  Template MD5 checksum
  
  boot-mode string
  
  Boot mode (default: legacy)
  
  Values are legacy or uefi.
  
  id string(uuid)
  
  Template ID
  
  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
  
  version string
  
  Template version
  
  created-at string(date-time)
  
  Template creation date
  
  visibility string
  
  Template visibility
  
  Values are private or public.
  
  state string
  
  Instance state
  
  Values are expunging, starting, destroying, running, stopping, stopped, migrating, error, or destroyed.
  
  ssh-key object
  
  Instance SSH Key
  
  Additional properties are allowed.
  
  Hide ssh-key attributes Show ssh-key attributes object
  
  name string
  
  SSH key name
  
  Minimum length is 1, maximum length is 255.
  
  fingerprint string
  
  SSH key fingerprint
  
  user-data string
  
  Instance Cloud-init user-data (base64 encoded)
  
  Minimum length is 1.
  
  mac-address string
  
  Instance MAC address
  
  manager object
  
  Instance manager
  
  Additional properties are allowed.
  
  Hide manager attributes Show manager attributes object
  
  id string(uuid)
  
  Manager ID
  
  type string
  
  Manager type
  
  Values are sks-nodepool or instance-pool.
  
  deploy-target object
  
  Instance Deploy Target
  
  Additional properties are allowed.
  
  Hide deploy-target attributes Show deploy-target attributes object
  
  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.
  
  ipv6-address string
  
  Instance IPv6 address
  
  id string(uuid)
  
  Instance ID
  
  snapshots array[object]
  
  Instance Snapshots
  
  Hide snapshots attributes Show snapshots attributes object
  
  id string(uuid)
  
  Snapshot ID
  
  name string
  
  Snapshot name
  
  Minimum length is 1, maximum length is 255.
  
  created-at string(date-time)
  
  Snapshot creation date
  
  state string
  
  Snapshot state
  
  Values are snapshotting, deleted, exporting, ready, deleting, error, or exported.
  
  size integer(int64)
  
  Snapshot size in GiB
  
  Minimum value is 10, maximum value is 51200.
  
  export object
  
  Exported snapshot information
  
  Additional properties are allowed.
  
  Hide export attributes Show export attributes object
  
  presigned-url string
  
  Exported snapshot disk file pre-signed URL
  
  md5sum string
  
  Exported snapshot disk file MD5 checksum
  
  instance object
  
  Compute Instance snapshotted
  
  Additional properties are allowed.
  
  disk-size integer(int64)
  
  Instance disk size in GiB
  
  Minimum value is 10, maximum value is 51200.
  
  ssh-keys array[object]
  
  Instance SSH Keys
  
  Hide ssh-keys attributes Show ssh-keys attributes object
  
  name string
  
  SSH key name
  
  Minimum length is 1, maximum length is 255.
  
  fingerprint string
  
  SSH key fingerprint
  
  created-at string(date-time)
  
  Instance creation date
  
  public-ip string(ipv4)
  
  Instance public IPv4 address
  
  deploy-target object
  
  Instance Deploy Target
  
  Additional properties are allowed.
  
  Hide deploy-target attributes Show deploy-target attributes object
  
  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.
  
  ipv6-enabled boolean
  
  Enable IPv6 for instances
  
  id string(uuid)
  
  Instance Pool ID
  
  disk-size integer(int64)
  
  Instances disk size in GiB
  
  Minimum value is 10, maximum value is 51200.
  
  ssh-keys array[object]
  
  Instances SSH keys
  
  Hide ssh-keys attributes Show ssh-keys attributes object
  
  name string
  
  SSH key name
  
  Minimum length is 1, maximum length is 255.
  
  fingerprint string
  
  SSH key fingerprint
  
  strategy string
  
  Load balancing strategy
  
  Values are round-robin, maglev-hash, or source-hash.
  
  healthcheck object
  
  Healthcheck configuration
  
  Additional properties are allowed.
  
  Hide healthcheck attributes Show healthcheck attributes object
  
  mode string
  
  Healthcheck mode
  
  Values are tcp, http, or https.
  
  interval integer(int64)
  
  Healthcheck interval (default: 10). Must be greater than or equal to Timeout
  
  Minimum value is 5, maximum value is 300.
  
  uri string
  
  An endpoint to use for the HTTP healthcheck, e.g. '/status'
  
  Minimum length is 1, maximum length is 255.
  
  port integer(int64)
  
  Healthcheck port
  
  Minimum value is 1, maximum value is 65535.
  
  timeout integer(int64)
  
  Healthcheck timeout value (default: 2). Must be lower than or equal to Interval
  
  Minimum value is 2, maximum value is 60.
  
  retries integer(int64)
  
  Number of retries before considering a Service failed
  
  Minimum value is 1, maximum value is 20.
  
  tls-sni string
  
  SNI domain for HTTPS healthchecks
  
  Minimum length is 1, maximum length is 255.
  
  id string(uuid)
  
  Load Balancer Service ID
  
  healthcheck-status array[object]
  
  Healthcheck status per backend server
  
  Hide healthcheck-status attributes Show healthcheck-status attributes object
  
  public-ip string(ipv4)
  
  Backend server public IP
  
  status string
  
  Status of the instance's healthcheck
  
  Values are failure or success.
- labels object
  
  Resource labels
  
  Hide labels attribute Show labels attribute object
  
  * string Additional properties

GET /load-balancer/{id}

curl \
 -X GET https://api-ch-gva-2.exoscale.com/v2/load-balancer/{id}

Response examples (200)

{
  "id": "string",
  "description": "string",
  "name": "string",
  "state": "creating",
  "created-at": "2024-05-04T09:42:00+00:00",
  "ip": "string",
  "services": [
    {
      "description": "string",
      "protocol": "tcp",
      "name": "string",
      "state": "creating",
      "target-port": 42,
      "port": 42,
      "instance-pool": {
        "anti-affinity-groups": [
          {
            "id": "string",
            "name": "string",
            "description": "string",
            "instances": [
              {
                "anti-affinity-groups": [
                  {}
                ],
                "public-ip-assignment": "inet4",
                "labels": {
                  "additionalProperty1": "string",
                  "additionalProperty2": "string"
                },
                "security-groups": [
                  {
                    "id": "string",
                    "name": "string",
                    "description": "string",
                    "external-sources": [
                      "string"
                    ]
                  }
                ],
                "elastic-ips": [
                  {
                    "id": "string",
                    "ip": "string",
                    "addressfamily": "inet4",
                    "cidr": "string",
                    "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": {
                      "additionalProperty1": "string",
                      "additionalProperty2": "string"
                    }
                  }
                ],
                "name": "string",
                "instance-type": {
                  "id": "string",
                  "size": "large",
                  "family": "gpu3",
                  "cpus": 42,
                  "gpus": 42,
                  "authorized": true,
                  "memory": 42,
                  "zones": [
                    "ch-dk-2"
                  ]
                },
                "private-networks": [
                  {
                    "id": "string",
                    "mac-address": "string"
                  }
                ],
                "template": {
                  "maintainer": "string",
                  "description": "string",
                  "ssh-key-enabled": true,
                  "family": "string",
                  "name": "string",
                  "default-user": "string",
                  "size": 42,
                  "password-enabled": true,
                  "build": "string",
                  "checksum": "string",
                  "boot-mode": "legacy",
                  "id": "string",
                  "zones": [
                    "ch-dk-2"
                  ],
                  "url": "string",
                  "version": "string",
                  "created-at": "2024-05-04T09:42:00+00:00",
                  "visibility": "private"
                },
                "state": "expunging",
                "ssh-key": {
                  "name": "string",
                  "fingerprint": "string"
                },
                "user-data": "string",
                "mac-address": "string",
                "manager": {
                  "id": "string",
                  "type": "sks-nodepool"
                },
                "deploy-target": {
                  "id": "string",
                  "name": "string",
                  "type": "edge",
                  "description": "string"
                },
                "ipv6-address": "string",
                "id": "string",
                "snapshots": [
                  {
                    "id": "string",
                    "name": "string",
                    "created-at": "2024-05-04T09:42:00+00:00",
                    "state": "snapshotting",
                    "size": 42,
                    "export": {
                      "presigned-url": "string",
                      "md5sum": "string"
                    },
                    "instance": {}
                  }
                ],
                "disk-size": 42,
                "ssh-keys": [
                  {
                    "name": "string",
                    "fingerprint": "string"
                  }
                ],
                "created-at": "2024-05-04T09:42:00+00:00",
                "public-ip": "string"
              }
            ]
          }
        ],
        "description": "string",
        "public-ip-assignment": "inet4",
        "labels": {
          "additionalProperty1": "string",
          "additionalProperty2": "string"
        },
        "security-groups": [
          {
            "id": "string",
            "name": "string",
            "description": "string",
            "external-sources": [
              "string"
            ]
          }
        ],
        "elastic-ips": [
          {
            "id": "string",
            "ip": "string",
            "addressfamily": "inet4",
            "cidr": "string",
            "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": {
              "additionalProperty1": "string",
              "additionalProperty2": "string"
            }
          }
        ],
        "name": "string",
        "instance-type": {
          "id": "string",
          "size": "large",
          "family": "gpu3",
          "cpus": 42,
          "gpus": 42,
          "authorized": true,
          "memory": 42,
          "zones": [
            "ch-dk-2"
          ]
        },
        "min-available": 42,
        "private-networks": [
          {
            "description": "string",
            "labels": {
              "additionalProperty1": "string",
              "additionalProperty2": "string"
            },
            "name": "string",
            "start-ip": "string",
            "leases": [
              {
                "ip": "string",
                "instance-id": "string"
              }
            ],
            "id": "string",
            "vni": 42,
            "netmask": "string",
            "options": {
              "routers": [
                "string"
              ],
              "dns-servers": [
                "string"
              ],
              "ntp-servers": [
                "string"
              ],
              "domain-search": [
                "string"
              ]
            },
            "end-ip": "string"
          }
        ],
        "template": {
          "maintainer": "string",
          "description": "string",
          "ssh-key-enabled": true,
          "family": "string",
          "name": "string",
          "default-user": "string",
          "size": 42,
          "password-enabled": true,
          "build": "string",
          "checksum": "string",
          "boot-mode": "legacy",
          "id": "string",
          "zones": [
            "ch-dk-2"
          ],
          "url": "string",
          "version": "string",
          "created-at": "2024-05-04T09:42:00+00:00",
          "visibility": "private"
        },
        "state": "scaling-up",
        "size": 42,
        "ssh-key": {
          "name": "string",
          "fingerprint": "string"
        },
        "instance-prefix": "string",
        "user-data": "string",
        "manager": {
          "id": "string",
          "type": "sks-nodepool"
        },
        "instances": [
          {
            "anti-affinity-groups": [
              {}
            ],
            "public-ip-assignment": "inet4",
            "labels": {
              "additionalProperty1": "string",
              "additionalProperty2": "string"
            },
            "security-groups": [
              {
                "id": "string",
                "name": "string",
                "description": "string",
                "external-sources": [
                  "string"
                ]
              }
            ],
            "elastic-ips": [
              {
                "id": "string",
                "ip": "string",
                "addressfamily": "inet4",
                "cidr": "string",
                "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": {
                  "additionalProperty1": "string",
                  "additionalProperty2": "string"
                }
              }
            ],
            "name": "string",
            "instance-type": {
              "id": "string",
              "size": "large",
              "family": "gpu3",
              "cpus": 42,
              "gpus": 42,
              "authorized": true,
              "memory": 42,
              "zones": [
                "ch-dk-2"
              ]
            },
            "private-networks": [
              {
                "id": "string",
                "mac-address": "string"
              }
            ],
            "template": {
              "maintainer": "string",
              "description": "string",
              "ssh-key-enabled": true,
              "family": "string",
              "name": "string",
              "default-user": "string",
              "size": 42,
              "password-enabled": true,
              "build": "string",
              "checksum": "string",
              "boot-mode": "legacy",
              "id": "string",
              "zones": [
                "ch-dk-2"
              ],
              "url": "string",
              "version": "string",
              "created-at": "2024-05-04T09:42:00+00:00",
              "visibility": "private"
            },
            "state": "expunging",
            "ssh-key": {
              "name": "string",
              "fingerprint": "string"
            },
            "user-data": "string",
            "mac-address": "string",
            "manager": {
              "id": "string",
              "type": "sks-nodepool"
            },
            "deploy-target": {
              "id": "string",
              "name": "string",
              "type": "edge",
              "description": "string"
            },
            "ipv6-address": "string",
            "id": "string",
            "snapshots": [
              {
                "id": "string",
                "name": "string",
                "created-at": "2024-05-04T09:42:00+00:00",
                "state": "snapshotting",
                "size": 42,
                "export": {
                  "presigned-url": "string",
                  "md5sum": "string"
                },
                "instance": {}
              }
            ],
            "disk-size": 42,
            "ssh-keys": [
              {
                "name": "string",
                "fingerprint": "string"
              }
            ],
            "created-at": "2024-05-04T09:42:00+00:00",
            "public-ip": "string"
          }
        ],
        "deploy-target": {
          "id": "string",
          "name": "string",
          "type": "edge",
          "description": "string"
        },
        "ipv6-enabled": true,
        "id": "string",
        "disk-size": 42,
        "ssh-keys": [
          {
            "name": "string",
            "fingerprint": "string"
          }
        ]
      },
      "strategy": "round-robin",
      "healthcheck": {
        "mode": "tcp",
        "interval": 42,
        "uri": "string",
        "port": 42,
        "timeout": 42,
        "retries": 42,
        "tls-sni": "string"
      },
      "id": "string",
      "healthcheck-status": [
        {
          "public-ip": "string",
          "status": "failure"
        }
      ]
    }
  ],
  "labels": {
    "additionalProperty1": "string",
    "additionalProperty2": "string"
  }
}