Delete the autoscaling configuration for an ALB

DELETE /ingress/v2/clusters/{id_or_name}/albs/{alb_id}/autoscale

Delete an autoscaling configuration for the ALB. Deleting the configuration disables autoscaling.

Request

Response

204 - Ok. Autoscale config was unset successfully.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. No autoscaling configuration set for this cluster and ALB, or the specified cluster or ALB could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the autoscaling configuration for an ALB

GET /ingress/v2/clusters/{id_or_name}/albs/{alb_id}/autoscale

Get the autoscaling configuration for an ALB. The autoscaling feature is enabled when there is a configuration set for the ALB. If the configuration is missing, the feature is disabled.

Request

Response

200 - Ok. The autoscaling configuration for your ALB is returned.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. No autoscale configuration set for this cluster and ALB, or the specified cluster or ALB could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Set the autoscaling configuration for an ALB

PUT /ingress/v2/clusters/{id_or_name}/albs/{alb_id}/autoscale

Set an autoscaling configuration for an ALB. Setting a configuration enables the autoscaling feature. You can also use this endpoint to change the autoscaling configuration.

Request

Request Body

AutoscaleDetails

New autoscale configuration to be set.

config

AutoscaleConfig

AutoscaleConfig is used for configuring autoscaling for albs

cpuAverageUtilization

integer

The cpuAverageUtilization value.

customMetrics

string

The customMetrics value.

maxReplicas

integer

The maxReplicas value.

minReplicas

integer

The minReplicas value.

Response

200 - Ok. The provided autoscaling configuration for your ALB is set.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The the specified cluster or ALB could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create an Ingress domain for a cluster

POST /ingress/v2/dns/createDomain

Create an Ingress domain for a cluster.

Request

Request Body

CreateDomainReq

Input parameter to create a domain.

cluster

string

The cluster value.

crn

string

The crn value.

hostname

string

The hostname value.

ips

Required *

array

The ips value.

isDefault

boolean

The isDefault value.

provider

string

The provider value.

secretNamespace

string

The secretNamespace value.

zoneID

string

The zoneID value.

Response

201 - Created. The domain is created.

certProvider

string

The certProvider value.

cluster

string

The cluster value.

crn

string

The crn value.

dnsType

string

The dnsType value.

isDefault

boolean

The isDefault value.

lbHostname

string

The lbHostname value.

nlbIPArray

array

The nlbIPArray value.

nlbSubdomain

string

The nlbSubdomain value.

provider

string

The provider value.

secretNamespace

string

The secretNamespace value.

statusMessage

string

The statusMessage value.

type

string

The type value.

zoneID

string

The zoneID value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: Delete external domain provider credential

POST /ingress/v2/dns/deleteCredential

Deprecated: Delete the registered external provider credential for a cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Response

204 - No Content. The credential was successfully fetched.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Delete a non-default Ingress domain for a cluster

POST /ingress/v2/dns/deleteDomain

Delete a non-default Ingress domain for a cluster.

Request

Request Body

DeleteDomainReq

Input parameter to delete a domain.

cluster

string

The cluster value.

subdomain

string

The subdomain value.

Response

200 - Ok. The domain is deleted.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: Get external domain provider credential metadata

GET /ingress/v2/dns/getCredential

Deprecated: Get metadata for the registered external provider credential for a cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Response

200 - Ok. The credential was successfully fetched.

cluster

string

The cluster value.

credID

string

The credID value.

expiresOn

string

The expiresOn value.

lastUpdatedTimestamp

string

The lastUpdatedTimestamp value.

provider

string

The provider value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Replace the existing default Ingress domain for a cluster

POST /ingress/v2/dns/replaceDefaultSubdomain

Replace the default Ingress domain for a cluster and refresh the related cluster components.

Request

Request Body

ReplaceDefaultSubdomainReq

Input parameter to replace default domain.

cluster

string

The cluster value.

subdomain

string

The subdomain value.

Response

200 - Ok. The default domain is replaced.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: Set external domain provider credential

POST /ingress/v2/dns/setCredential

Deprecated: Register a credential for external domain provider for use in ingress domain commands.

Request

Request Body

CreateCredentialReq

Input parameter to register an external domain provider credential.

akamai_credentials

AkamaiCredentials

AkamaiCredentials is the struct representation of Akamai creds

access_token

string

The access token value.

client_secret

string

The client secret value.

client_token

string

The client token value.

host

string

The host value.

zone

string

The zone value.

cloudflare_credentials

CloudflareCredentials

CloudflareCredentials is the struct representation of Cloudflare creds

token

string

The token value.

zone_id

string

The zone id value.

cluster

string

The cluster value.

provider

string

The provider value.

Response

201 - Created. The credential was successfully registered.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update an Ingress domain for a cluster

POST /ingress/v2/dns/updateDomain

Update an Ingress domain with the specified IPs or hostnames.

Request

Request Body

UpdateDomainReq

Input parameter to update a domain.

cluster

string

The cluster value.

domain

string

The domain value.

hostname

string

The hostname value.

ips

Required *

array

The ips value.

Response

200 - Ok. The domain is updated.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get configuration of load balancers for Ingress ALBs

GET /ingress/v2/load-balancer/configuration

Get settings for load balancers that expose Ingress ALBs in your cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster.

type

Required *

string

Type of load balancer configuration to return. Possible options are `public` and `private`.

Response

200 - Ok. The load balancer configuration for the specified type is returned.

backend

LBBackendConfig

LBBackendConfig stuct for configuring the loadbalancer's backend

cluster

string

The cluster value.

proxyProtocol

LBProxyProtocolConfig

LBProxyProtocolConfig stuct for storing the loadbalancer's proxy protocol config in etcd

type

string

The type value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update the configuration of load balancers for Ingress ALBs

PATCH /ingress/v2/load-balancer/configuration

Configure settings for load balancers that expose Ingress ALBs in your cluster. After you use this API to set load balancer options, the existing load balancers are deleted and recreated, which can cause service disruptions. Two unused IP addresses for each new load balancer must be available in each subnet during the load balancer recreation. To configure load balancers that expose only your public ALBs or only your private ALBs, specify `public` or `private` for the `type` field in the request body. If you leave the `type` field empty, the configuration is applied to all load balancers that expose ALBs in the cluster.

Available features: + `proxyProtocol`: + Limitations: + This feature is supported only for VPC Gen 2 clusters that run Kubernetes version 1.18 or later. + This feature is cluster-level, therefore `type` field of the request must be empty. + Configuration: + `enable`: Set to `true` to enable or `false` to disable the PROXY protocol for the ALB load balancers. The PROXY protocol enables load balancers to pass client connection information that is contained in headers on the client request, including the client IP address, the proxy server IP address, and both port numbers, to ALBs. + `headerTimeout`: The timeout value, in seconds, for the load balancer to receive the PROXY protocol headers that contain the client connection information. This option has effect only on ALBs running the Kubernetes Ingress image. Default: `5` + `cidr`: Load balancer CIDRs from which ALBs process information in PROXY protocol headers. If requests that contain PROXY headers originate from load balancers in other IP ranges, the information in the headers is not process by the ALB. This option has effect only on ALBs running the Kubernetes Ingress image. Default: `0.0.0.0/0`

Request

Request Body

LBConfig

In the request body, specify the desired configuration of load balancer features you want to change.

backend

LBBackendConfig

LBBackendConfig stuct for configuring the loadbalancer's backend

private

string

The private value.

public

string

The public value.

cluster

string

The cluster value.

proxyProtocol

LBProxyProtocolConfig

LBProxyProtocolConfig stuct for storing the loadbalancer's proxy protocol config in etcd

cidr

Required *

array

The cidr value.

enable

boolean

The enable value.

headerTimeout

integer

The headerTimeout value.

type

string

The type value.

Response

202 - Load-balancer configuration submitted and update started.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

423 - Locked. The previous load-balancer configuration is still in progress.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Add fields to an Ingress secret with a secret stored in IBM Cloud Secrets Man

POST /ingress/v2/secret/addField

Add fields to an Ingress secret with a secret stored in IBM Cloud Secrets Manager.

Request

Request Body

UpdateConfig

Input parameter to add a secret field.

add

Required *

array

The add value.

cluster

string

The cluster value.

crn

string

The crn value.

name

string

The name value.

namespace

string

The namespace value.

remove

Required *

array

The remove value.

Response

201 - Updated. The fields were successfully added to the secret in the cluster.

cluster

string

The cluster value.

crn

string

The crn value.

domain

string

deprecated: use "Domains" instead

domains

array

The domains value.

expiresOn

string

The expiresOn value.

fields

Fields

Fields struct for a secret array

lastUpdatedTimestamp

string

The lastUpdatedTimestamp value.

name

string

The name value.

namespace

string

The namespace value.

persistence

boolean

The persistence value.

secretType

string

The secretType value.

status

string

The status value.

type

string

The type value.

userManaged

boolean

The userManaged value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create an Ingress secret with a secret stored in IBM Cloud Secrets Manager

POST /ingress/v2/secret/createSecret

Create an Ingress secret with a secret stored in IBM Cloud Secrets Manager.

Request

Request Body

CreateConfig

Input parameter to add a secret.

add

Required *

array

The add value.

cluster

string

The cluster value.

crn

string

The crn value.

name

string

The name value.

namespace

string

The namespace value.

persistence

boolean

The persistence value.

type

string

The type value.

Response

201 - Created. The secret was successfully created in the cluster.

cluster

string

The cluster value.

crn

string

The crn value.

domain

string

deprecated: use "Domains" instead

domains

array

The domains value.

expiresOn

string

The expiresOn value.

fields

Fields

Fields struct for a secret array

lastUpdatedTimestamp

string

The lastUpdatedTimestamp value.

name

string

The name value.

namespace

string

The namespace value.

persistence

boolean

The persistence value.

secretType

string

The secretType value.

status

string

The status value.

type

string

The type value.

userManaged

boolean

The userManaged value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Delete an Ingress secret from the cluster

POST /ingress/v2/secret/deleteSecret

Delete an Ingress secret from the cluster.

Request

Request Body

DeleteConfig

Input parameter to add a secret.

cluster

string

The cluster value.

delete_cert

boolean

The delete cert value.

name

string

The name value.

namespace

string

The namespace value.

Response

204 - Deleted. The secret was successfully deleted from the cluster.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View an IBM Cloud Secrets Manager instance registered to the cluster

GET /ingress/v2/secret/getInstance

View an IBM Cloud Secrets Manager instance registered to the cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want information about. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

name

Required *

string

The name of the instance that you want information about. To list the instances that you have access to, use the `GET /ingress/v2/secret/getInstances` API or run `ibmcloud ks ingress secret instance ls`.

Response

200 - Ok. Detailed information about the secret is returned.

callbackChannel

string

The callbackChannel value.

cluster

string

The cluster value.

crn

string

The crn value.

isDefault

boolean

The isDefault value.

name

string

The name value.

secretGroupID

string

The secretGroupID value.

secretGroupName

string

The secretGroupName value.

status

string

The status value.

type

string

The type value.

userManaged

boolean

The userManaged value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View IBM Cloud Secrets Manager instances registered to the cluster

GET /ingress/v2/secret/getInstances

View IBM Cloud Secrets Manager instances registered to the cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want information about. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

show_deleted

string

To view previously deleted instances, pass `true`.

Response

200 - Ok. The list of available Ingress secrets is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View Ingress secret details

GET /ingress/v2/secret/getSecret

View Ingress secret details.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want information about. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

name

Required *

string

The name of the secret that you want information about. To list the secrets that you have access to, use the `GET /ingress/v2/secret/getSecrets` API or run `ibmcloud ks ingress secret ls`.

namespace

Required *

string

The namespace of the secret that you want information about. To list the secrets that you have access to, use the `GET /ingress/v2/secret/getSecrets` API or run `ibmcloud ks ingress secret ls`.

Response

200 - Ok. Detailed information about the secret is returned.

cluster

string

The cluster value.

crn

string

The crn value.

domain

string

deprecated: use "Domains" instead

domains

array

The domains value.

expiresOn

string

The expiresOn value.

fields

Fields

Fields struct for a secret array

lastUpdatedTimestamp

string

The lastUpdatedTimestamp value.

name

string

The name value.

namespace

string

The namespace value.

persistence

boolean

The persistence value.

secretType

string

The secretType value.

status

string

The status value.

type

string

The type value.

userManaged

boolean

The userManaged value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View Ingress secrets for a cluster

GET /ingress/v2/secret/getSecrets

View Ingress secrets for a cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want information about. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

show_deleted

string

To view previously deleted secrets, pass `true`.

Response

200 - Ok. The list of available Ingress secrets is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Register an IBM Cloud Secrets Manager instance to the cluster

POST /ingress/v2/secret/registerInstance

Register an IBM Cloud Secrets Manager instance to the cluster.

Request

Request Body

RegisterConfig

Input parameter to register an instance.

cluster

string

The cluster value.

crn

string

The crn value.

isDefault

boolean

The isDefault value.

secretGroupID

string

The secretGroupID value.

Response

200 - Created. The instance was successfully registered to the cluster.

callbackChannel

string

The callbackChannel value.

cluster

string

The cluster value.

crn

string

The crn value.

isDefault

boolean

The isDefault value.

name

string

The name value.

secretGroupID

string

The secretGroupID value.

secretGroupName

string

The secretGroupName value.

status

string

The status value.

type

string

The type value.

userManaged

boolean

The userManaged value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove fields from an Ingress secret with a secret stored in IBM Cloud Secret

POST /ingress/v2/secret/removeField

Remove fields from an Ingress secret with a secret stored in IBM Cloud Secrets Manager.

Request

Request Body

UpdateConfig

Remove input parameter to remove a secret field.

add

Required *

array

The add value.

cluster

string

The cluster value.

crn

string

The crn value.

name

string

The name value.

namespace

string

The namespace value.

remove

Required *

array

The remove value.

Response

200 - Updated. The fields were successfully removed from the secret in the cluster.

cluster

string

The cluster value.

crn

string

The crn value.

domain

string

deprecated: use "Domains" instead

domains

array

The domains value.

expiresOn

string

The expiresOn value.

fields

Fields

Fields struct for a secret array

lastUpdatedTimestamp

string

The lastUpdatedTimestamp value.

name

string

The name value.

namespace

string

The namespace value.

persistence

boolean

The persistence value.

secretType

string

The secretType value.

status

string

The status value.

type

string

The type value.

userManaged

boolean

The userManaged value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Unregister an IBM Cloud Secrets Manager instance from the cluster

POST /ingress/v2/secret/unregisterInstance

Unregister an IBM Cloud Secrets Manager instance from the cluster.

Request

Request Body

DeleteConfig

Input parameter to unregister an instance.

cluster

string

The cluster value.

delete_cert

boolean

The delete cert value.

name

string

The name value.

namespace

string

The namespace value.

Response

200 - Deleted. The secret was successfully deleted from the cluster.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update an IBM Cloud Secrets Manager instance registration configuration to th

POST /ingress/v2/secret/updateInstance

Update an IBM Cloud Secrets Manager instance registration configuration to the cluster.

Request

Request Body

InstanceUpdateConfig

Input parameter to update instance registration.

cluster

string

The cluster value.

isDefault

boolean

The isDefault value.

name

string

The name value.

secretGroupID

string

The secretGroupID value.

Response

200 - Update. The instance was successfully updated.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified instance could not be found. To list the registered instances that you have access to, use the `GET /v2/secret/getInstances` API or run `ibmcloud ks ingress secret instance ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update an Ingress secret with a secret stored in IBM Cloud Secrets Manager

POST /ingress/v2/secret/updateSecret

Update an Ingress secret with a secret stored in IBM Cloud Secrets Manager.

Request

Request Body

UpdateConfig

Input parameter to add a secret.

add

Required *

array

The add value.

cluster

string

The cluster value.

crn

string

The crn value.

name

string

The name value.

namespace

string

The namespace value.

remove

Required *

array

The remove value.

Response

201 - Created. The secret was successfully created in the cluster.

cluster

string

The cluster value.

crn

string

The crn value.

domain

string

deprecated: use "Domains" instead

domains

array

The domains value.

expiresOn

string

The expiresOn value.

fields

Fields

Fields struct for a secret array

lastUpdatedTimestamp

string

The lastUpdatedTimestamp value.

name

string

The name value.

namespace

string

The namespace value.

persistence

boolean

The persistence value.

secretType

string

The secretType value.

status

string

The status value.

type

string

The type value.

userManaged

boolean

The userManaged value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the configuration of a cluster's port 80 security settings

GET /ingress/v2/security/port80

Get the configuration of a cluster's port 80 security settings.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster.

Response

200 - Ok. The port 80 configuration for the specified cluster is returned.

cluster

string

The cluster value.

state

string

The state value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enable port 80 on the cluster

PATCH /ingress/v2/security/port80

Enable port 80 on a Kubernetes or Red Hat OpenShift cluster. For clusters created after December 1, 2025, port 80 belonging to the default OpenShift router and Kubernetes ingress is disabled by default. Configure this setting to enable the port.

Request

Request Body

Port80Config

Specify the security setting for port 80.

cluster

string

The cluster value.

state

string

The state value.

Response

200 - Port 80 security configuration submitted and update started.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the OAuth access type for a VPC cluster

GET /network/v2/oauth-access-type/{id_or_name}

Get the OAuth access type for a VPC cluster.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

200 - Ok. The OAuth access type for the specified cluster is returned.

oauth_access_type

string

The oauth access type value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Set the OAuth access type for a VPC cluster

POST /network/v2/oauth-access-type/{id_or_name}/set

Set the OAuth access type for a VPC cluster.

Request

Request Body

OauthAccessTypeJSON

Specify the OAuth access type that you want to use. Accepted values are `vpegw` or `legacy`.

oauth_access_type

string

The oauth access type value.

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

202 - Accepted. The request to set the OAuth access type was successful.

400 - The OAuth access type you specified is not supported.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Modify the outbound traffic protection policy for a VPC cluster using Secure

POST /network/v2/outbound-traffic-protection

Modify the outbound traffic protection policy for a VPC cluster using Secure .

Request

Request Body

OutboundTrafficProtectionRequest

Specify the outbound traffic protection policy for your cluster. Available options are `enable-outbound-protection` and `disable-outbound-protection`.

cluster

string

The cluster value.

operation

string

The operation value.

Response

202 - Accepted. The request to set the outbound traffic protection policy was successful.

400 - Bad request. The query parameters are either incomplete or in the wrong format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Disable the subnet allowlist for a Satellite cluster's service endpoint

DELETE /network/v2/satellite-acl/{id_or_name}

Disable the subnet allowlist feature for a Satellite cluster's service endpoint. After you disable this feature, authorized requests to your Satellite cluster master through the Satellite cluster's service endpoint can originate from any subnet.

Request

Response

202 - Accepted. The request to disable the Satellite allowlist feature for your Satellite cluster's service endpoint was successfully processed.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified Satellite cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get a Satellite cluster's service endpoint allowlist

GET /network/v2/satellite-acl/{id_or_name}

List all subnets in the Satellite allowlist for a Satellite cluster's service endpoint. This list includes subnets that you manually added by using the `PATCH /network/v2/satellite-acl/{idOrName}/add` API and subnets that are automatically added and managed by IBM, such as worker node subnets.

Request

Response

200 - Ok. The allowlist for the Satellite cluster's service endpoint is returned.

actualCSEACLList

array

The actualCSEACLList value.

desiredCSEACLList

array

The desiredCSEACLList value.

400 - Bad request. Satellite Service Endpoint Allowlist feature is disabled on the specified cluster.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified Satellite cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Add subnets to a Satellite cluster's service endpoint allowlist

PATCH /network/v2/satellite-acl/{id_or_name}/add

When you add a subnet to a disabled Satellite cluster's service endpoint allowlist, the Satellite allowlist is automatically enabled. Only authorized requests to your Satellite cluster master that originate from subnets in this allowlist are permitted through the Satellite cluster's service endpoint. The subnets for your Satellite cluster's worker nodes must be added to this allowlist for the worker nodes to communicate with the master through the Satellite service endpoint.

Request

Request Body

CsePatchAcl

The list of subnets to add to the Satellite cluster's service endpoint allowlist.

aclList

Required *

array

The ACL list to patch

Path Parameters

id_or_name

Required *

string

The name or ID of the Satellite cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

201 - Created. The subnets are successfully added to the Satellite cluster's service endpoint allowlist.

204 - No content. The subnets are successfully added to the Satellite cluster's service endpoint allowlist.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified Satellite cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enable the subnet allowlist for a Satellite cluster's service endpoint

POST /network/v2/satellite-acl/{id_or_name}/enable

Enable the subnet allowlist feature for a Satellite cluster's service endpoint. After you enable this feature, you can use the `PATCH /network/v2/satellite-acl/{idOrName}/add` API to add subnets to the allowlist for this Satellite cluster's service endpoint. Only authorized requests to your Satellite cluster master that originate from subnets in the allowlist are permitted through the Satellite cluster's service endpoints.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the Satellite cruiser. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

202 - Accepted. The request to enable the allowlist feature for your Satellite cluster's service endpoint was successfully processed.

400 - Bad request. The Satellite service endpoint allowlist feature is already enabled on the specified cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified Satellite cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove subnets from a Satellite cluster's service endpoint allowlist

PATCH /network/v2/satellite-acl/{id_or_name}/rm

Remove subnets that you previously added to the allowlist for a Satellite cluster's service endpoint. After a subnet is removed, any requests that originate from this subnet to the Satellite cluster master through the service endpoint are denied.

Request

Request Body

CsePatchAcl

The list of subnets to remove from the Satellite cluster's service endpoint allowlist.

aclList

Required *

array

The ACL list to patch

Path Parameters

id_or_name

Required *

string

The name or ID of the Satellite cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

202 - Accepted. The subnets are successfully removed from the Satellite cluster's service endpoint allowlist.

204 - No content. The subnets are successfully removed from the Satellite cluster's service endpoint allowlist.

400 - Bad request. Satellite Service Endpoint Allowlist feature is disabled on the specified cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified Satellite cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enable VPC Secure by Default Networking on an existing VPC cluster

POST /network/v2/secure-by-default/enable

Enable VPC Secure by Default Networking on an existing VPC cluster.

Request

Request Body

EnableSecureByDefaultClusterRequest

Enable a one-way migration to Secure by Default Networking on an existing VPC cluster currently using legacy security groups. Available options for `disableOutboundTrafficProtection` are `true` or `false`.

cluster

string

The cluster value.

disableOutboundTrafficProtection

boolean

The disableOutboundTrafficProtection value.

Response

202 - Accepted. The request to enable Secure by Default Networking was successful.

400 - Bad request. The query parameters are either incomplete or in the wrong format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Perform operations against a VPC Security Group associated with a cluster

POST /network/v2/security-group

Perform operations against a VPC Security Group associated with a cluster.

Request

Request Body

SecurityGroupRequest

Perform an operation against a VPC security group associated with a cluster. Currently supported operations are `reset` or `sync`.

cluster

string

The cluster value.

operation

string

The operation value.

securityGroupID

string

The securityGroupID value.

Response

202 - Accepted. The requested security group operation was successfully processed.

400 - Bad request. The query parameters are either incomplete or in the wrong format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List all security groups associated with a cluster

GET /network/v2/security-group/getSecurityGroups

List all security groups associated with a cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, run `ibmcloud ks cluster ls`.

type

string

Filter security groups by type. Specify `cluster`, `worker`, `vpc`, `vpegw`, or `lbaas`.

shared

string

Specify `true` to return the security groups that are shared across the VPC. Or, specify `false` to return only the cluster specific security groups.

user_provided

string

Specify `true` to return the security groups created by user. Specify `false` to return only the IKS managed security groups.

Response

200 - Ok. A list of security groups associated with the cluster is returned.

400 - Bad request. The query parameters are either incomplete or in the wrong format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: Private service endpoint allowlists are no longer supported and c

DELETE /v1/acl/{id_or_name}

Disable the subnet allowlist for a cluster's private service endpoint.

Disable the subnet allowlist feature for a cluster's private service endpoint. After you disable this feature, authorized requests to your cluster master through the cluster's private service endpoint can originate from any subnet.

Request

Response

202 - Accepted. The request to disable the allowlist feature for your cluster's private service endpoint was successfully processed.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: Private service endpoint allowlists are no longer supported and c

GET /v1/acl/{id_or_name}

Get a cluster's private service endpoint allowlist.

List all subnets in the allowlist for a cluster's private service endpoint. This list includes subnets that you manually added by using the `PATCH /v1/acl/{idOrName}/add` API and subnets that are automatically added and managed by IBM, such as worker node subnets.

Request

Response

200 - Ok. The allowlist for the cluster's private service endpoint is returned.

actualCSEACLList

CSEACLList

CSEACLList actual and desired

desiredCSEACLList

CSEACLList

CSEACLList actual and desired

400 - Bad request. Private Service Endpoint Allowlist feature is disabled on the specified cluster.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: Private service endpoint allowlists are no longer supported and c

PATCH /v1/acl/{id_or_name}/add

Add subnets to a cluster's private service endpoint allowlist.

After you use the `POST /v1/acl/{idOrName}/enable` API to enable an allowlist for your cluster's private service endpoint, add subnets to the allowlist. Only authorized requests to your cluster master that originate from subnets in this allowlist are permitted through the cluster's private service endpoint. By default, subnets for your cluster's worker nodes are added to this allowlist so that worker nodes can communicate with the master through the private service endpoint.

Request

Request Body

CsePatchAcl

The list of subnets to add to the cluster's private service endpoint allowlist.

aclList

Required *

array

The ACL list to patch

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

201 - Created. The subnets are successfully added to the cluster's private service endpoint allowlist.

204 - No content. The subnets are successfully added to the cluster's private service endpoint allowlist.

400 - Bad request. Private Service Endpoint Allowlist feature is disabled on the specified cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: Private service endpoint allowlists are no longer supported and c

POST /v1/acl/{id_or_name}/enable

Enable a subnet allowlist for a cluster's private service endpoint.

Enable the subnet allowlist feature for a cluster's private service endpoint. After you enable this feature, you can use the `PATCH /v1/acl/{idOrName}/add` API to add subnets to the allowlist for this cluster's private service endpoint. Only authorized requests to your cluster master that originate from subnets in the allowlist are permitted through the cluster's private service endpoint. If the public service endpoint is enabled for your cluster, authorized requests are still permitted through the public service endpoint.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

202 - Accepted. The request to enable the allowlist feature for your cluster's private service endpoint was successfully processed.

400 - Bad request. The private service endpoint allowlist feature is already enabled on the specified cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: Private service endpoint allowlists are no longer supported and c

PATCH /v1/acl/{id_or_name}/rm

Remove subnets from a cluster's private service endpoint allowlist.

Remove subnets that you previously added to the allowlist for a cluster's private service endpoint. After a subnet is removed, any requests that originate from this subnet to the cluster master through the private service endpoint are denied.

Request

Request Body

CsePatchAcl

The list of subnets to remove from the cluster's private service endpoint allowlist.

aclList

Required *

array

The ACL list to patch

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

202 - Accepted. The subnets are successfully removed from the cluster's private service endpoint allowlist.

204 - No content. The subnets are successfully removed from the cluster's private service endpoint allowlist.

400 - Bad request. Private Service Endpoint Allowlist feature is disabled on the specified cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List available add-ons that you can enable in a cluster

GET /v1/addons

List available add-ons that you can enable in a cluster. For each available add-on, the name, latest version, and minimum Kubernetes version required to run the add-on in a cluster are returned.

Request

Response

200 - OK. The name, latest version, and minimum required Kubernetes version for each available add-on are returned.

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enable an existing ALB in a cluster

POST /v1/alb/albs

Enable a public or private ALB in your standard cluster.

Request

Request Body

ALBConfig

The input parameter to enable an ALB. In the `albip` field, you can optionally specify an IP address that is on a VLAN in the zone that the ALB was created in. The ALB is enabled with and uses this public or private IP address. Note that this IP address must not be in use by another load balancer or ALB in the cluster. If no IP address is provided, the ALB is deployed with a public or private IP address from the portable public or private subnet that was provisioned automatically when you created the cluster, or the public or private IP address that you previously assigned to the ALB. To switch your ALB from one type of image to another, such as from an IBM Cloud Kubernetes Service ALB image to a community Kubernetes Ingress controller image, specify that image version in the ALBBuild field. To see the supported image versions, use the `GET /v2/alb/getAlbImages` call. For more information, see https://ibm.biz/alb_configure_docs

albBuild

string

The build number of the ALB.

albID

string

The ID of the application load balancer (ALB).

albType

string

The type of ALB.

albip

string

The public IP address that exposes the ALB.

authBuild

string

The auth build of the ALB.

clusterID

string

The ID of the cluster that the ALB belongs to.

createdDate

string

The date the ALB was created.

disableDeployment

boolean

If set to true, the deployment of the ALB is disabled.

enable

boolean

Set to true to enable the ALB, or false to disable the ALB for the cluster.

name

string

The name of the cluster that the ALB belongs to.

nlbVersion

string

The version of network load balancer that the ALB uses.

numOfInstances

string

Desired number of ALB replicas that you want in your cluster.

resize

boolean

If set to true, resizing of the ALB is done.

state

string

The state of the ALB.

status

string

The status of the ALB.

vlanID

string

The VLAN ID that the ALB is attached to.

zone

string

The zone where you want to add ALBs.

Response

201 - Enabled. The ALB for the cluster was successfully enabled.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or ALB could not be found. To list the clusters that you have access to, run `ibmcloud ks cluster ls`. To list the ALBs available in a cluster, use the `GET /clusters/{idOrName}` API or run `ibmcloud ks alb ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Disable an ALB in your cluster

DELETE /v1/alb/albs/{alb_id}

Disable a public or private ALB in your standard cluster. When you disable an ALB, the IP address that the ALB used goes back into the pool of available portable IPs so that another service can use the IP. If you later try to re-enable the ALB, the ALB might report an error if the IP address it previously used is now in use by another service. You can either stop running the other service or specify another IP address to use when you re-enable the ALB.

Request

Response

204 - Disabled. The ALB for the cluster was successfully disabled.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or ALB could not be found. To list the clusters that you have access to, run `ibmcloud ks cluster ls`. To list the ALBs available in a cluster, use the `GET /clusters/{idOrName}` API or run `ibmcloud ks alb ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of an ALB

GET /v1/alb/albs/{alb_id}

View detailed information for an ALB in a cluster.

Request

Response

200 - Ok. Details for the specified ALB are returned.

albBuild

string

The build number of the ALB.

albID

string

The ID of the application load balancer (ALB).

albType

string

The type of ALB.

albip

string

The public IP address that exposes the ALB.

authBuild

string

The auth build of the ALB.

clusterID

string

The ID of the cluster that the ALB belongs to.

createdDate

string

The date the ALB was created.

disableDeployment

boolean

If set to true, the deployment of the ALB is disabled.

enable

boolean

Set to true to enable the ALB, or false to disable the ALB for the cluster.

name

string

The name of the cluster that the ALB belongs to.

nlbVersion

string

The version of network load balancer that the ALB uses.

numOfInstances

string

Desired number of ALB replicas that you want in your cluster.

resize

boolean

If set to true, resizing of the ALB is done.

state

string

The state of the ALB.

status

string

The status of the ALB.

vlanID

string

The VLAN ID that the ALB is attached to.

zone

string

The zone where you want to add ALBs.

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or ALB could not be found. To list the clusters that you have access to, run `ibmcloud ks cluster ls`. To list the ALBs available in a cluster, use the `GET /clusters/{idOrName}` API or run `ibmcloud ks alb ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List all ALBs in a cluster

GET /v1/alb/clusters/{id_or_name}

List all ALB IDs in a cluster. If no ALB IDs are returned, then the cluster does not have a portable subnet.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster that you want to see ALB information for. To list the clusters that you have access to, run `ibmcloud ks cluster ls`.

Query Parameters

Response

200 - Ok. A list of ALB IDs for the cluster is returned.

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Force a one-time update of all ALB pods to the latest build

PUT /v1/alb/clusters/{id_or_name}/update

If automatic updates for Ingress ALBs are disabled, you can force a one-time update of your ALB pods. When you choose to manually update the ALBs, all ALB pods in the cluster are updated to the latest build. You cannot update an individual ALB or choose which build to update the ALBs to. Automatic updates remain disabled.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

200 - Ok. The update has been requested.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Check if automatic updates for Ingress ALBs are enabled in a cluster

GET /v1/alb/clusters/{id_or_name}/updatepolicy

Check if automatic updates for Ingress ALBs are enabled and whether your ALB pods are updated to the latest build version.

Request

Response

200 - Ok. The current update policy.

autoUpdate

boolean

If set to `true`, the cluster is enabled for automatic updates.

latestVersion

boolean

If set to `true`, the cluster log forwarder runs the latest version.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enable or disable automatic updates for the Ingress ALBs in a cluster

PUT /v1/alb/clusters/{id_or_name}/updatepolicy

By default, automatic updates to Ingress ALBs are enabled. ALB pods are automatically updated when a new build version is available. To instead update the Ingress ALB component manually, you can use this call to disable automatic updates, then use the `PUT /clusters/{idOrName}/update` call to update all ALB pods. Note: When you update the major or minor Kubernetes version of your cluster, IBM automatically makes necessary changes to the Ingress deployment, but does not change the build version of your Ingress ALBs. You are responsible for checking the compatability of the latest Kubernetes versions and your Ingress ALB add-on images. If automatic updates for the Ingress ALB component are disabled, you can re-enable automatic updates. Whenever the next build version becomes available, the ALBs are automatically updated to the latest build.

Request

Request Body

UpdatePolicy

The new update policy configuration.

autoUpdate

boolean

If set to `true`, the cluster is enabled for automatic updates.

latestVersion

boolean

If set to `true`, the cluster log forwarder runs the latest version.

Response

204 - Ok. The ALB update policy has been changed.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a public or private ALB in a specified zone and VLAN

POST /v1/alb/clusters/{id_or_name}/zone/{zone_id}

Create a new public or private ALB in a specified zone on a specified VLAN. You can also optionally specify an IP address on that VLAN in that zone for the ALB to use.

Request

Request Body

ALB

The input parameters to create an ALB. For more information, see https://ibm.biz/alb_create_docs

cluster

string

The cluster value.

enableByDefault

boolean

If set to true, the ALB is enabled by default. \

ingressImage

string

The type of Ingress image that you want to use for your ALB deployment.

type

string

The type of ALB that you want to create.

zone

string

The zone where you want to deploy the ALB.

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster that you want to see ALB information for. To list the clusters that you have access to, run `ibmcloud ks cluster ls`.

zone_id

Required *

string

The zone in which you want to create an ALB. To see the zones where you can create an ALB, run `ibmcloud ks cluster-get --cluster <cluster_name_or_ID>` and look for the `Worker Zones` field in the output.

Query Parameters

Response

201 - The ALB was successfully created.

alb

string

The alb value.

cluster

string

The cluster value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or zone could not be found. To list the clusters that you have access to, run `ibmcloud ks cluster ls`. To list the zones available in a cluster, use the `GET /v1/clusters/{idOrName}` API or run `ibmcloud ks cluster-get --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the clusters that you have access to

GET /v1/clusters

List the clusters that you have access to.

Request

Path Parameters

Query Parameters

location

string

Specify a location to filter clusters for. To see supported locations, use the `GET /v1​/locations` API or run `ibmcloud ks locations`.

show_resources

string

To view additional cluster resources like addons, VLANs, subnets, and storage, pass `true`.

Response

200 - Success. A list of clusters that you have access to is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a cluster

POST /v1/clusters

Create a cluster in the IBM Cloud account that you are logged into. Note: This API method requires Administrator platform role for IBM Cloud Kubernetes Service at the account level, as well as access to several other services such as the underlying infrastructure provider. For more information, see 'https://ibm.biz/cluster-perms'.

Request

Request Body

ClusterConfig

Input parameter to add a cluster. For more information, see https://ibm.biz/cluster_create_docs

cseAclEnabled

boolean

The cseAclEnabled value.

dataCenter

string

The data center where the worker node is created.

defaultWorkerPoolEntitlement

string

The defaultWorkerPoolEntitlement value.

defaultWorkerPoolName

string

The defaultWorkerPoolName value.

disableAutoUpdate

boolean

The disableAutoUpdate value.

diskEncryption

boolean

The diskEncryption value.

gatewayEnabled

boolean

The gatewayEnabled value.

isolation

string

The isolation value.

machineType

string

The machine type of the worker node.

masterVersion

string

The masterVersion value.

name

string

The name value.

networkPlugin

string

The networkPlugin value.

noSubnet

boolean

The noSubnet value.

operatingSystem

string

The operatingSystem value.

podSubnet

string

The podSubnet value.

podSubnets

string

The podSubnets value.

prefix

string

The prefix value.

privateSeviceEndpoint

boolean

The privateSeviceEndpoint value.

privateVlan

string

The private VLAN ID that the worker node is attached to.

publicServiceEndpoint

boolean

The publicServiceEndpoint value.

publicVlan

string

The public VLAN ID that the worker node is attached to.

serviceSubnet

string

The serviceSubnet value.

skipPermPrecheck

boolean

The skipPermPrecheck value.

trustedProfileID

string

The trustedProfileID value.

vpcNativeRoutingEnabled

boolean

The vpcNativeRoutingEnabled value.

workerNum

integer

The workerNum value.

Response

201 - Created. The cluster was successfully created in the IBM Cloud account that you are logged in to.

id

string

The id value.

non_critical_errors

ResponseErrors

ResponseErrors are used to communicate to non-critical errors to end users

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. A cluster with the same name already exists. Choose another name for your cluster.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Delete a cluster

DELETE /v1/clusters/{id_or_name}

Delete a cluster from the IBM Cloud account that you are logged in to. When you delete a cluster, all worker nodes, apps, and containers are permanently deleted. This action cannot be undone.

Request

Path Parameters

Query Parameters

delete_resources

string

To delete additional resources linked to the cluster such as VLANs, subnets, and storage, pass `true`.

skip_permissions_precheck

string

To skip checking for infrastructure permissions before completing this action, pass 'true'. Note that if you do not have the correct infrastructure permissions, this action might only partially succeed.

delete_open_shift_registry_cos_bucket

string

To delete the COS bucket and the associated service key that holds OpenShift registry backups, pass `true`

Response

204 - Ok. The cluster was successfully removed from the IBM Cloud account that you are logged in to.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details for a cluster

GET /v1/clusters/{id_or_name}

View detailed information for a cluster.

Request

Path Parameters

Query Parameters

show_resources

string

To view additional cluster resources like addons, VLANs, subnets, and storage, pass `true`.

Response

200 - Ok. Detailed information about the cluster is returned.

addons

array

The addons value.

apiUser

string

The apiUser value.

createdDate

string

The createdDate value.

crn

string

The crn value.

dataCenter

string

The dataCenter value.

desiredTrustedProfileID

string

The desiredTrustedProfileID value.

disableAutoUpdate

boolean

The disableAutoUpdate value.

etcdPort

string

The etcdPort value.

id

string

The id value.

ignitionServerURL

string

The ignitionServerURL value.

imageSecurityEnabled

boolean

The imageSecurityEnabled value.

ingressHostname

string

The ingressHostname value.

ingressMessage

string

The ingressMessage value.

ingressSecretName

string

The ingressSecretName value.

ingressStatus

string

The ingressStatus value.

isPaid

boolean

The isPaid value.

keyProtectEnabled

boolean

The keyProtectEnabled value.

konnectivityServerURL

string

The konnectivityServerURL value.

location

string

The location value.

logOrg

string

The logOrg value.

logOrgName

string

The logOrgName value.

logSpace

string

The logSpace value.

logSpaceName

string

The logSpaceName value.

masterHealth

string

The masterHealth value.

masterKubeVersion

string

The masterKubeVersion value.

masterState

string

The masterState value.

masterStatus

string

The masterStatus value.

masterStatusModifiedDate

string

The masterStatusModifiedDate value.

modifiedDate

string

The modifiedDate value.

monitoringURL

string

The monitoringURL value.

multiAzCapable

boolean

The multiAzCapable value.

name

string

The name value.

oauthServerURL

string

The oauthServerURL value.

podSubnet

string

The podSubnet value.

podSubnets

string

The podSubnets value.

privateServiceEndpointEnabled

boolean

The privateServiceEndpointEnabled value.

privateServiceEndpointURL

string

The privateServiceEndpointURL value.

publicServiceEndpointEnabled

boolean

The publicServiceEndpointEnabled value.

publicServiceEndpointURL

string

The publicServiceEndpointURL value.

pullSecretApplied

boolean

The pullSecretApplied value.

region

string

The region value.

resourceGroup

string

The resourceGroup value.

resourceGroupName

string

The resourceGroupName value.

serverURL

string

The serverURL value.

serviceSubnet

string

The serviceSubnet value.

state

string

The state value.

status

string

The status value.

targetVersion

string

The targetVersion value.

trustedProfileID

string

The trustedProfileID value.

type

string

The type value.

versionEOS

string

The versionEOS value.

vlans

array

The vlans value.

vpcNativeRoutingEnabled

boolean

The vpcNativeRoutingEnabled value.

workerCount

integer

The workerCount value.

workerZones

array

The workerZones value.

worker_vlans

VLANS

VLANS is a helper type to sort an api.VLAN list. The VLANS will sort the list in order of the Properties.PrimaryRouter value so that VLAN's of a common router are listed consecutively.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update the version of the Kubernetes cluster master node

PUT /v1/clusters/{id_or_name}

Update the Kubernetes master to the default API version. During the update, you cannot access or change the cluster. Worker nodes, apps, and resources that have been deployed by the user are not modified and will continue to run. You might need to change your YAML files for future deployments. For details, see the release notes at https://cloud.ibm.com/docs/containers?topic=containers-cs_versions

Request

Request Body

UpdateMasterCommand

Input parameter to update the Kubernetes master. Set `action` to `update` to update the master. Set `force` to `true` to attempt the update even if the change is greater than two minor versions. Set `version` to the Kubernetes version of the cluster. If you do not specify a version, the Kubernetes master is updated to the default API version. To see available versions, use the `GET /v1/kube-versions` API or run `ibmcloud ks versions`.

action

string

The action to perform on the master.

force

boolean

If set to true, any warnings during the update process are ignored.

version

string

The Kubernetes version to use for the update.

Response

204 - Ok. The request to update your master node was successfully processed.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The cluster cannot be updated. The master is more than two versions behind the targeted version, which is not supported. Instead, update to a supported version two or less ahead of the current version, or create a new cluster at the targeted version.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. The specified value is already set on the cluster. To list the clusters properties, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of the add-ons that are enabled in a cluster

GET /v1/clusters/{id_or_name}/addons

View details of the add-ons that are enabled in a cluster, including the add-on versions.

Request

Response

200 - OK. Details for the add-ons in this cluster are returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enable, disable, or update add-ons for a cluster

PATCH /v1/clusters/{id_or_name}/addons

Enable, disable, or update add-ons for a cluster.

Request

Request Body

AddonRequest

Input parameters to enable or disable add-ons in your cluster.

addons

Required *

array

The addons to operate on.

enable

boolean

Indicate if the specified addons should be enabled or disabled.

update

boolean

Indicate if the specified addons should be updated. Only Update or Enable should be used, not both.

Response

200 - OK. The add-on changes have been processed.

missingDeps

array

The addon enable request would result in an invalid configuration. Install missing addons to continue.

orphanedAddons

object

The addon disable request would result in an invalid configuration. Inspect the map to determine why the configuration is invalid.

400 - Bad request. The input parameters in the request body are not correct. Be sure to include all of the required parameters in your request in the correct JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. The current add-on configuration is not compatible. Check 'MissingDeps' for add-ons to enable in this cluster.

missingDeps

array

The addon enable request would result in an invalid configuration. Install missing addons to continue.

orphanedAddons

object

The addon disable request would result in an invalid configuration. Inspect the map to determine why the configuration is invalid.

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Delete an audit webhook configuration

DELETE /v1/clusters/{id_or_name}/apiserverconfigs/auditwebhook

Disable the webhook backend configuration for the cluster's API server. Diabling the webhook backend stops forwarding API server audit logs to a remote server.

Request

Response

204 - Successfully deleted the audit webhook configuration.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details for an audit webhook configuration

GET /v1/clusters/{id_or_name}/apiserverconfigs/auditwebhook

View the URL for the remote logging service that you are sending API server audit logs to.

Request

Response

200 - Successfully retrieved the audit webhook configuration.

auditServer

string

The URL of the server to send audit logs to.

caCertificate

string

The Certificate Authority certificate that is used to connect to the audit server.

clientCertificate

string

The client certificate that is used to connect to the audit server.

clientKey

string

The client key that is used to connect to the audit server.

policy

string

The audit policy type to be configured.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create or update an audit webhook configuration for a cluster

PUT /v1/clusters/{id_or_name}/apiserverconfigs/auditwebhook

Create or update an audit webhook configuration for a cluster. The webhook sends Kubernetes API server audit logs that allow you to monitor API requests to your cluster.

Request

Request Body

AuditWebhookConfig

The input parameter for creating or updating an audit webhook configuration. For more information, see https://ibm.biz/audit_config_docs

auditServer

string

The URL of the server to send audit logs to.

caCertificate

string

The Certificate Authority certificate that is used to connect to the audit server.

clientCertificate

string

The client certificate that is used to connect to the audit server.

clientKey

string

The client key that is used to connect to the audit server.

policy

string

The audit policy type to be configured.

Response

204 - Ok. The cluster will send audit logs to the audit server.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

412 - Precondition failed. The input parameters in the request body are incorrect. Some typical cases include if the audit server is http and certs are provided or if the server is https and not all certs are provided.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the cluster-specific configuration and certificates

GET /v1/clusters/{id_or_name}/config

Get the cluster-specific Kubernetes configuration data and certificates as a tar file to connect to your cluster and run Kubernetes API calls. To retrieve the administrator certificates and keys, pass `admin` at the end of the path. For example, `/v1/clusters/{idOrName}/config/admin`.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster for which you want to download the Kubernetes configuration file and certificates. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

sub

string

The format of the user identity to use in the Kubernetes configuration and policies. Must match the IAM provided user email, up to letter case.

format

string

To format the output in a single YAML file, pass `yaml`.

create_network_config

boolean

Retrieve the Calico network config with the Admin config. This only works against the admin endpoint('/config/admin')

skip_rbac

boolean

Deprecated: Previously this skipped adding the RBAC roles based on user's access in IAM. RBAC is now always applied and completes asynchronously.

Response

200 - Ok. The cluster-specific configuration file and certificates are returned as a zip file.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create and enable a key management service (KMS) provider configuration for a

POST /v1/clusters/{id_or_name}/kms

Create a configuration to enable a key management service (KMS) provider, such as IBM Key Protect, in your cluster. Your customer root key (CRK) from the KMS provider is used to encrypt the Kubernetes secrets within your cluster. After you enable KMS for your cluster, you can update the instance, endpoint, or CRK parameters that are used, but you cannot remove the KMS provider from your cluster. Note on permissions: This API method requires the IBM Cloud IAM Administrator platform role for IBM Cloud Kubernetes Service at the account level. The API key that is used for the region and resource group that the cluster is in requires the appropriate permission to create an instance and CRK in the KMS provider, such as the Editor platform and Writer service role for Key Protect. An additional Reader service-to-service authorization policy between IBM Cloud Kubernetes Service and Key Protect is automatically created for your cluster, if the policy does not already exist. Without this policy, your cluster cannot use all the Key Protect features.

Request

Request Body

KeyProtectData

Input parameters to create the Key Protect config for your cluster. The user specified URL parameter is ignored, because it is fetched from Ghost.

accountID

string

AccountID stores the ID of the account where the key protect instance resides Its value can be either: the same account ID the given cluster resides in (non cross account use case) not the clusters account ID in which the KMS instance resides (cross account use case) empty, in case of old clusters which were secret encrypted before this AccountID field was added to this struct. This case falls back to the first point and should be handled like that (non cross account use case)

correlationID

string

The correlation ID stores the correlation ID used to trace a CRK call through multiple services

crkID

Required *

string

CRK is a Key Protect customer root key. To get the CRK, see http://ibm.biz/kp-viewcrk

instanceID

Required *

string

InstanceID is a Key Protect instance ID. To get the instance ID, run 'ibmcloud resource service-instance <kp_service> --id' and copy the second value (not the full CRN)

serviceToService

boolean

ServiceToService indicates the KP information in this record was enabled via service-to-service integration, so an associated registration was created.

url

Required *

string

URL is a Key Protect endpoint. To get the endpoint, see http://ibm.biz/kp-endpoints

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

201 - OK. Your Key Protect config will be applied to the cluster.

400 - Bad request. The input parameters in the request body are not correct. Be sure to include all of the required parameters in your request in the correct JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. Processing multiple concurrent requests from your account to create a Key Protect config for the cluster. Wait a few minutes and try again.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Refresh the Kubernetes master

PUT /v1/clusters/{id_or_name}/masters

Restart the Kubernetes master in the cluster to apply changes to the API server configuration.

Request

Request Body

MasterAPIServer

The master state. Currently, `refresh` is supported.

action

string

The action to perform on the API Server.

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster that you want to interact with. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

204 - Ok. The Master will be put into the desired state.

400 - Bad Request. Check that all headers are present and that the state is valid. Valid states include `refresh`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the IBM Cloud services bound to a cluster across all namespaces

GET /v1/clusters/{id_or_name}/services

List the IBM Cloud services that are bound in any Kubernetes namespace in the cluster.

Request

Response

200 - Ok. A list of IBM Cloud services bound to a cluster across all Kubernetes namespaces is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

404 - Not found. The specified cluster ID or name could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

Bind an IBM Cloud service to a cluster

POST /v1/clusters/{id_or_name}/services

Bind an IBM Cloud service instance to a Kubernetes namespace in your cluster. To view available IBM Cloud services from the IBM Cloud catalog, run `ibmcloud catalog search --kind service`. If you already provisioned IBM Cloud service instances in an IBM Cloud space, you can list them by running `ibmcloud resource service-instances`. Note: You can add only IBM Cloud services that support service keys, and you must add the service in the same resource group that the cluster is in.

Request

Request Body

ServiceBindRequest

The ID of the IBM Cloud service instance that you want to bind. To find the ID of the service instance, use the `GET /v1/clusters/{idOrName}/services` API or run `{[bxcs]} cluster-services <cluster_name_or_ID>`.

namespaceID

string

The namespaceID value.

role

string

The role value.

serviceInstanceGUID

string

The serviceInstanceGUID value.

serviceKeyGUID

string

The serviceKeyGUID value.

serviceKeyJSON

string

The serviceKeyJSON value.

Response

201 - Created. Your IBM Cloud service instance was successfully bound to the Kubernetes namespace of your cluster.

binding

string

The binding value.

namespaceID

string

The namespaceID value.

secretName

string

The secretName value.

serviceInstanceGUID

string

The serviceInstanceGUID value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

List the IBM Cloud services bound to a specific namespace in a cluster

GET /v1/clusters/{id_or_name}/services/{namespace}

List the IBM Cloud services that are bound to a specific Kubernetes namespace in a cluster.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster where you want to list bound IBM Cloud services. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

namespace

Required *

string

The Kubernetes namespace in your cluster where you want to list all bound IBM Cloud services.

Query Parameters

Response

200 - Ok. A list of services bound to a cluster within a specific Kubernetes namespace is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

404 - Not found. The specified Kubernetes namespace or cluster ID/name could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To view available Kubernetes namespaces, run `kubectl get namespaces`.

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

Unbind an IBM Cloud service from a cluster

DELETE /v1/clusters/{id_or_name}/services/{namespace}/{service_instance_id}

Unbind an IBM Cloud service instance from a Kubernetes namespace in your cluster. Note: When you remove an IBM Cloud service, the service credentials are removed from the cluster. If a pod is still using the service, it fails because the service credentials cannot be found.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster where you want to unbind your IBM Cloud service instance. To list bound IBM Cloud services and their namespaces, use the `GET /v1/clusters/{nameOrId}/services` API or run `ibmcloud ks cluster service ls --cluster <cluster_name_or_ID>`.

namespace

Required *

string

The Kubernetes namespace where your IBM Cloud service was bound to. To list bound IBM Cloud services and their namespaces, use the `GET /v1/clusters/{nameOrId}/services` API or run `ibmcloud ks cluster service ls --cluster <cluster_name_or_ID>`.

service_instance_id

Required *

string

The name or ID of the IBM Cloud service instance that was bound to your cluster. To list bound IBM Cloud services and their namespaces, use the `GET /v1/clusters/{nameOrId}/services` API or run `ibmcloud ks cluster service ls --cluster <cluster_name_or_ID>`.

Query Parameters

Response

204 - The IBM Cloud service instance was successfully unbound from the Kubernetes namespace of your cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

404 - Not found. The specified cluster, IBM Cloud service instance, or namespace could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list bound IBM Cloud services and their namespaces, use the `GET /v1/clusters/{nameOrId}/services` API or run `ibmcloud ks cluster service ls --cluster <cluster_name_or_ID>`.

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

List classic subnets that are bound to a cluster

GET /v1/clusters/{id_or_name}/subnets

List subnets from your IBM Cloud classic infrastructure account that are bound to a cluster. Before you can call this API method, a one-time per account `POST /v1/credentials` is required.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

200 - Ok. A list of user-managed subnets that are bound to your cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Detach a public or private portable subnet from a cluster

PATCH /v1/clusters/{id_or_name}/subnets/{subnet_id}

Detach a subnet in your IBM Cloud classic infrastructure account from a cluster. The subnet remains available in your infrastructure account after it is detached.

Request

Response

204 - Ok. The specified subnet was successfully removed from your cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Add an IBM Cloud classic infrastructure subnet to a cluster

PUT /v1/clusters/{id_or_name}/subnets/{subnet_id}

Make an existing IBM Cloud classic infrastructure subnet available to an existing cluster. Note: When you make a subnet available to a cluster, IP addresses of this subnet are used for cluster networking purposes. To avoid IP address conflicts, make sure that you use a subnet with one cluster only. Do not use a subnet for multiple clusters or for other purposes outside of Kubernetes Service at the same time.

Request

Response

204 - Ok. The specified subnet was successfully made available to your cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List user-managed subnets that are bound to a cluster

GET /v1/clusters/{id_or_name}/usersubnets

List user-managed subnets that are bound to a cluster. Note that user-managed subnets are deprecated.

Request

Response

200 - Ok. A list of user-managed subnets that are bound to your cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Add an existing user-managed subnet to a cluster

POST /v1/clusters/{id_or_name}/usersubnets

Make your own private subnet available to an Kubernetes Service cluster. This private subnet is not one provided by IBM Cloud infrastructure (SoftLayer). As such, you must configure any inbound and outbound network traffic routing for the subnet. Note: User-managed subnets are deprecated. When you add a private user subnet to a cluster, IP addresses of this subnet are used for private Load Balancers in the cluster. To avoid IP address conflicts, make sure that you use a subnet with one cluster only. Do not use a subnet for multiple clusters or for other purposes outside of Kubernetes Service at the same time.

Request

Request Body

UserSubnet

Pass the CIDR of your user-managed subnet and the ID of an available private VLAN in the body.

cidr

string

The subnet and the CIDR that you want to add to the cluster in the format 12.34.45.78/24.

vlan_id

string

The private VLAN ID that the subnet CIDR belongs to.

Response

204 - Ok. The specified subnet was successfully made available to your cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove a user-managed subnet from a cluster

DELETE /v1/clusters/{id_or_name}/usersubnets/{subnet_id}/vlans/{vlan_id}

Remove a private user-managed subnet from a cluster. Note: User-managed subnets are deprecated. Any service that was deployed to an IP address from your own private subnet remains active after the subnet is removed.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster that you want to remove the user-managed subnet from. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

subnet_id

Required *

string

The GUID of the user-managed subnet that you want to remove from your cluster.

vlan_id

Required *

string

The ID of the private VLAN that the user-managed subnet is on.

Query Parameters

Response

204 - Ok. The specified subnet was successfully removed from your cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create an IBM Cloud classic infrastructure subnet and add it to an existing c

POST /v1/clusters/{id_or_name}/vlans/{vlan_id}

Create an IBM Cloud classic infrastructure subnet and make it available to an existing cluster. Note: When you make a subnet available to a cluster, IP addresses of this subnet are used for cluster networking purposes. To avoid IP address conflicts, make sure that you use a subnet with one cluster only. Do not use a subnet for multiple clusters or for other purposes outside of Kubernetes Service at the same time.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster for which you want to make an existing subnet from your IBM Cloud infrastructure account available. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

vlan_id

Required *

string

The VLAN in which to create the subnet. To list available VLANs, use the `GET /v1/datacenters/{datacenter}/vlans` API or run `ibmcloud ks vlan ls <zone>`.

Query Parameters

size

string

The number of subnet IP addresses. The default value is 8. Accepted values are 8, 16, 32, 64.

Response

204 - Ok. The specified subnet was successfully made available to your cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List all webhooks for a cluster

GET /v1/clusters/{id_or_name}/webhooks

List all webhooks for a Kubernetes cluster.

Request

Response

200 - Ok. A list of available webhooks for the cluster is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Add a webhook to a cluster

POST /v1/clusters/{id_or_name}/webhooks

Add a webhook, such as for Slack, to a Kubernetes cluster.

Request

Request Body

ClusterWebhook

Input parameter to create a webhook. Set `level` to the notification level, such as `Normal` or `Warning`. The default value is `Warning`. Set `type` to the webhook service type. Currently `slack` is supported. Set `url` to the URL for the webhook.

level

string

The notification level that you want to use for the webhook.

type

string

The webhook service type.

url

string

The webhook URL.

Response

201 - Created. The webhook was successfully added to the cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the worker pools in a cluster

GET /v1/clusters/{id_or_name}/workerpools

List all the worker pools that you have in a cluster.

Request

Response

200 - OK. The list of worker pools was successfully retrieved.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list all the clusters, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a worker pool for a cluster

POST /v1/clusters/{id_or_name}/workerpools

Create a worker pool for the specified cluster. Creating a worker pool requires Operator access to Kubernetes Service in the IBM Cloud account.

Request

Request Body

WorkerPoolRequest

The

diskEncryption

boolean

If set to true, the secondary disk of the worker node is encrypted. If set to false, no encryption is set up.

entitlement

string

The entitlement value.

isolation

string

The isolation value.

labels

object

The labels value.

machineType

string

The machineType value.

name

string

The name value.

operatingSystem

string

The operatingSystem value.

sizePerZone

integer

The sizePerZone value.

zones

Required *

array

The zones value.

Response

201 - Created. The worker pool was successfully created in for the specified cluster.

autoscaleEnabled

boolean

The autoscaleEnabled value.

id

string

The id value.

isBalanced

boolean

The isBalanced value.

isolation

string

The isolation value.

labels

object

The labels value.

machineType

string

The machineType value.

name

string

The name value.

operatingSystem

string

The operatingSystem value.

reasonForDelete

string

The reasonForDelete value.

region

string

The region value.

sizePerZone

integer

The sizePerZone value.

state

string

The state value.

zones

WorkerPoolZoneResponses

Worker pool zone responses

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. A worker pool create may already be in progress for the provided cluster. Please wait a few minutes and try again.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove a worker pool from a cluster

DELETE /v1/clusters/{id_or_name}/workerpools/{poolid_or_name}

Remove a worker pool from a cluster. All worker nodes in the pool are deleted. Your pods are rescheduled when you delete. To avoid downtime, be sure that you have enough worker nodes in other worker pools to run your workload.

Request

Response

204 - OK. The request to remove your worker pool was successfully received.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker pool could not be found. To list all worker pools for a cluster, use the `GET /v1/clusters/{idOrName}/workerpools` API or run `ibmcloud ks worker-pool ls mycluster`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details for a worker pool

GET /v1/clusters/{id_or_name}/workerpools/{poolid_or_name}

View detailed information for a worker pool.

Request

Response

200 - Ok. Detailed information about the worker pool is returned.

autoscaleEnabled

boolean

The autoscaleEnabled value.

id

string

The id value.

isBalanced

boolean

The isBalanced value.

isolation

string

The isolation value.

labels

object

The labels value.

machineType

string

The machineType value.

name

string

The name value.

operatingSystem

string

The operatingSystem value.

reasonForDelete

string

The reasonForDelete value.

region

string

The region value.

sizePerZone

integer

The sizePerZone value.

state

string

The state value.

zones

WorkerPoolZoneResponses

Worker pool zone responses

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker pool could not be found. To list all worker pools for a cluster, use the `GET /v1/clusters/{idOrName}/workerpools` API or run `ibmcloud ks worker-pool ls mycluster`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Resize or rebalance a worker pool

PATCH /v1/clusters/{id_or_name}/workerpools/{poolid_or_name}

To change the number of worker nodes in a worker pool, you can resize or rebalance the worker pool. When you resize the worker pool, you change the number of worker nodes that are created in each zone of the worker pool. For example, if you set the size per zone to 3 and have 3 zones in the pool, you have 9 worker nodes in total. When you rebalance the worker pool, you return the number of worker nodes in the worker pool to a balanced state. For example, if you remove some worker nodes such as to troubleshoot an issue, you might have an uneven number of nodes across zones. You might delete 2 worker nodes in zone dal13 but still have 3 worker nodes each in zones dal10 and dal12 for a total of 7 worker nodes. To fix this unbalanced state, rebalance the worker pool. After rebalancing, the worker pool has 9 worker nodes again. Rebalancing does not change the size per zone of the worker pool, even if you specify a different size per zone.

Request

Request Body

WorkerPoolPatchRequest

You can change the number of worker nodes by resizing or rebalancing the worker pool. To resize, set parameters `"state"` to `"resizing"` and `"sizePerZone"` to the number of worker nodes that you want in each zone. You can also note why you resize the worker pool in the `"reasonForResize"` string parameter. To rebalance, set parameter `"state"` to `"rebalancing"`. Note that rebalancing does not change the size per zone of the worker pool. To apply a custom label to the worker pool, set the `"state"` field to `"labels"` and fill in the `"labels"` section with your label key-value pairs. When you apply a label, all existing custom labels are replaced. If you have existing custom labels that you want to keep, include them in your request. To remove a custom label, set the `"state"` field to `"labels"` and in the `"labels"` section, include the same `"key"` field, but leave the value field blank `""`. Note that you must not edit the system-provided labels that that come with the worker pool and worker nodes by default, or you might experience unexpected results.

allowSingleOpenShiftWorker

boolean

The allowSingleOpenShiftWorker value.

labels

object

The labels value.

reasonForResize

string

The reasonForResize value.

sizePerZone

integer

The sizePerZone value.

state

string

The state value.

Response

202 - OK. The request to resize your worker pool was successfully processed.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The request will not be permitted.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker pool could not be found. To list all worker pools for a cluster, use the `GET /v1/clusters/{idOrName}/workerpools` API or run `ibmcloud ks worker-pool ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Add a zone to the specified worker pool for a cluster

POST /v1/clusters/{id_or_name}/workerpools/{poolid_or_name}/zones

Add a zone to the specified worker pool for a cluster. Worker nodes are created in each added zone, based on the requested size per zone of the worker pool details.

Request

Request Body

WorkerPoolZone

Input parameters to add zones to the worker pool.

id

Required *

string

The id value.

privateVlan

string

The privateVlan value.

publicVlan

string

The publicVlan value.

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

poolid_or_name

Required *

string

The ID of the worker pool. To list all worker pools for a cluster, use the `GET /v1/clusters/{idOrName}/workerpools` API or run `ibmcloud ks worker-pool ls --cluster <cluster_name_or_ID>`.

Query Parameters

Response

201 - OK. The requested zone has been added to the worker pool.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker pool could not be found. To list all worker pools for a cluster, use the `GET /v1/clusters/{idOrName}/workerpools` API or run `ibmcloud ks worker-pool ls mycluster`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. The provided zone already exists in the worker pool.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove a zone from a worker pool

DELETE /v1/clusters/{id_or_name}/workerpools/{poolid_or_name}/zones/{zoneid}

Remove a zone from a worker pool. All worker nodes for the zone are deleted from the worker pool. To avoid downtime for your apps, make sure that you have enough worker nodes left to reschedule your workloads.

Request

Response

202 - OK. The request to remove the zone from your worker pool was successfully submitted.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The request will not be permitted.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker pool or zone could not be found. To list all worker pool zones, use the `GET /v1/clusters/{idOrName}/workerpools/{poolIdOrName}/zones` API or run `ibmcloud ks worker-pool ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update the network configuration details, such as VLANs, for a zone in the wo

PATCH /v1/clusters/{id_or_name}/workerpools/{poolid_or_name}/zones/{zoneid}

Update the network configuration details, such as VLANs, for a zone in the wo.

Request

Request Body

WorkerPoolZonePatchRequest

Updated network configuration values for the worker pool zone.

privateVlan

string

The privateVlan value.

publicVlan

string

The publicVlan value.

Response

204 - OK. The request to update network configuration for your worker pool was successful.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The request will not be permitted.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker pool or zone could not be found. To list all worker pool zones, use the `GET /v1/clusters/{idOrName}/workerpools/{poolIdOrName}/zones` API or run `ibmcloud ks worker-pool ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List all worker nodes in a cluster

GET /v1/clusters/{id_or_name}/workers

List all worker nodes and the status of each in a cluster.

Request

Path Parameters

Query Parameters

pool

string

The name or ID of the worker pool to filter results for. Run `ibmcloud ks worker-pool ls --cluster <cluster name>`.

show_deleted

string

true|false Shows deleted workers

Response

200 - Ok. A list of worker nodes for the specified cluster is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Add worker nodes to a cluster

POST /v1/clusters/{id_or_name}/workers

Add additional worker nodes to a Kubernetes cluster. Note that adding stand-alone worker nodes is deprecated. Instead, resize the worker pool to add worker nodes.

Request

Request Body

WorkerConfig

Input parameter to add workers to a cluster. For more information, see https://ibm.biz/worker_add_docs

dataCenter

string

The data center where the worker node is created.

diskEncryption

boolean

The diskEncryption value.

isolation

string

The isolation value.

machineType

string

The machine type of the worker node.

operatingSystem

string

The operatingSystem value.

prefix

string

The prefix value.

privateVlan

string

The private VLAN ID that the worker node is attached to.

publicVlan

string

The public VLAN ID that the worker node is attached to.

workerNum

integer

The workerNum value.

Response

201 - Ok. Additional worker nodes were successfully added to your cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Delete a worker node from a cluster

DELETE /v1/clusters/{id_or_name}/workers/{worker_id}

Delete a worker node from a cluster. This action cannot be undone. When you delete the worker node, the worker node is cordoned and drained so that its pods are rescheduled onto remaining worker nodes in the cluster. Make sure that you have enough capacity in the cluster to support the workload. After you remove the worker node, you can rebalance the worker pool.

Request

Response

204 - Ok. The worker node was successfully removed from your cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of a worker node

GET /v1/clusters/{id_or_name}/workers/{worker_id}

View detailed information for a worker node.

Request

Response

200 - Ok. Detailed information about the worker node is returned.

errorMessage

string

The errorMessage value.

errorMessageDate

string

The errorMessageDate value.

id

string

The id value.

isolation

string

The isolation value.

kubeVersion

string

The kubeVersion value.

location

string

The location value.

machineType

string

The machineType value.

masterVersionEOS

string

The masterVersionEOS value.

pendingOperation

string

The pendingOperation value.

poolName

string

The poolName value.

poolid

string

The poolid value.

privateIP

string

The privateIP value.

privateVlan

string

The privateVlan value.

publicIP

string

The publicIP value.

publicVlan

string

The publicVlan value.

reasonForDelete

string

The reasonForDelete value.

state

string

The state value.

status

string

The status value.

statusDate

string

The statusDate value.

statusDetails

string

The statusDetails value.

targetVersion

string

The targetVersion value.

trustedStatus

string

The trustedStatus value.

versionEOS

string

The versionEOS value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Reboot, reload, or update a worker node for a cluster

PUT /v1/clusters/{id_or_name}/workers/{worker_id}

Reboot, reload, or update a worker node in a Kubernetes cluster. If a problem exists with a worker node, try to reload it, which reloads all the configurations and updates the worker node with the latest image and Kubernetes patch version. When you reboot a worker node, its state remains the same such as `deployed`, but its status updates as the machine in your infrastructure account is restarted. If you update the worker node, it is reimaged with the Kubernetes version that matches the cluster master. If you reboot, reload, or update a worker node, data is deleted if not stored outside the worker node in persistent storage. This action cannot be undone.

Request

Request Body

UpdateWorkerCommand

The action that you want your worker node to take. Pass `os_reboot`, `reload`, or `update` as the action string.

action

string

The action to perform on the worker node.

force

boolean

Setting force flag to true will ignore if the master is unavailable during 'os_reboot" and 'reload' action

Response

204 - OK. The request to reboot or reload your worker node was successfully processed.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List configuration values for your IBM Cloud account

GET /v1/config

List account configuration information that you can use when making IBM Cloud API requests.

Request

Response

200 - Success

accounts_url

string

The accounts url value.

acct_url

string

Deprecated: the account and user management APIs are now separated to AccountsURL and UserManagementURL respectively

bluemix_url

string

The bluemix url value.

env_name

string

The env name value.

iam_base_url

string

The iam base url value.

iam_client_id

string

The iam client id value.

iam_client_secret

string

The iam client secret value.

iam_issuer

string

The iam issuer value.

iam_papurl

string

The iam papurl value.

iam_pdpurl

string

The iam pdpurl value.

iam_url

string

The iam url value.

uaa_url

string

The uaa url value.

user_management_url

string

The user management url value.

Remove IBM Cloud classic infrastructure account credentials from your IBM Clo

DELETE /v1/credentials

Remove the IBM Cloud classic infrastructure user name and API key from the region and resource group in your IBM Cloud Kubernetes Service account. After removing the credentials, you cannot access that IBM Cloud classic infrastructure account through your IBM Cloud Kubernetes Service account anymore. Instead, the default infrastructure account for your IBM Cloud account and the corresponding API key is used. Before you remove the infrastructure credentials, check which clusters use these credentials and make a plan to re-create the clusters in the new infrastructure environment. Otherwise, you might not be able to perform infrastructure actions, like updating or adding worker nodes, to the clusters that use the old credentials.

Request

Response

204 - Ok. The IBM Cloud infrastructure account credentials were successfully removed from your IBM Cloud Kubernetes Service account for this region and resource group.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. No IBM Cloud infrastructure account credentials are stored in the Kubernetes Service account for this region and resource group.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View the IBM Cloud classic infrastructure account credentials that are set fo

GET /v1/credentials

Get the infrastructure user name of the credentials that are used to access the IBM Cloud classic infrastructure portfolio. Infrastructure credentials are set per region and resource group.

Request

Response

200 - Ok. The IBM Cloud infrastructure (SoftLayer) account credentials were successfully retrieved from IBM Cloud Kubernetes Service.

apiUser

string

The apiUser value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. No IBM Cloud infrastructure account credentials are stored in the Kubernetes Service account for this region and resource group.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Set IBM Cloud classic infrastructure account credentials for your IBM Cloud K

POST /v1/credentials

Set the IBM Cloud classic infrastructure user name and API key for the region and resource group in your IBM Cloud Kubernetes Service account. Do not set multiple credentials for one IBM Cloud Kubernetes Service account. Every IBM Cloud Kubernetes Service account is linked to one IBM Cloud infrastructure portfolio only. When you manually set infrastructure credentials with this API, these credentials are used instead of any API key that is set for the region and resource group.

Request

Path Parameters

Query Parameters

Response

204 - Ok. The IBM Cloud infrastructure account credentials were successfully set for this region and resource group.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List available machine types for a zone (data center)

GET /v1/datacenters/{datacenter}/machine-types

List available machine types that you can use for a worker node. Machine types vary by zone. Each machine type includes the amount of virtual CPU, memory, and disk space that is set up for the worker node. For more information, see http://ibm.biz/machine_types

Request

Path Parameters

datacenter

Required *

string

The zone ID where you want to list available machine types. To list available zones, run `ibmcloud ks zone ls` or use the `GET /v1/datacenters` API.

Query Parameters

Response

200 - Success

400 - The specified zone is invalid. To list available zones, run `ibmcloud ks zone ls` or use the `GET /v1/datacenters` API.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List available VLANs for a zone

GET /v1/datacenters/{datacenter}/vlans

List available public and private VLANs for a specified data center. Before using this operation, you must store your IBM Cloud infrastructure (SoftLayer) credentials in each Kubernetes Service account by using the `POST /v1/credentials` API or by running `ibmcloud ks credential set --infrastructure-api-key <API_key> --infrastructure-username <API_username>`.

Request

Path Parameters

datacenter

Required *

string

The ID of the zone where you want to list available public and private VLANs. To list available zones, run `ibmcloud ks zone ls` or use the `GET /v1/datacenters` API.

Query Parameters

Response

200 - Ok. A list of available public and private VLANs for the specified zone is returned.

400 - The specified zone is invalid. To list available zones, run `ibmcloud ks zone ls' or use the `GET /v1/datacenters` API.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get details on the permissions that the IBM Cloud infrastructure (SoftLayer)

GET /v1/infra-permissions

Get details on the compute, networking, and storage permissions that the IBM Cloud infrastructure (SoftLayer) credentials have in this region and resource group. To review what IBM Cloud infrastructure (SoftLayer) credentials are set, use the `GET /v1/credentials` API, or run `ibmcloud ks credential get` or `ibmcloud ks api-key info`.

Request

Path Parameters

Query Parameters

Response

200 - Ok.

account

string

ProviderAccountID may contain personally identifiable information

accountType

string

AccountType returns if the account information pertains to a linked or an IaaS account

networkManagerPermissions

Permissions

Permissions describes the result of checking granted permissions Note: the default zero/empty value implies sufficient permissions

physicalWorkerManagerPermissions

Permissions

Permissions describes the result of checking granted permissions Note: the default zero/empty value implies sufficient permissions

storageManagerPermissions

Permissions

Permissions describes the result of checking granted permissions Note: the default zero/empty value implies sufficient permissions

virtualWorkerManagerPermissions

Permissions

Permissions describes the result of checking granted permissions Note: the default zero/empty value implies sufficient permissions

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Reset the IAM API key

POST /v1/keys

Replace the IAM API key for the IBM Cloud Kubernetes Service in a region and resource group. The API key is used to access several services, such as the IBM Cloud classic infratructure portfolio, and is required to manage your clusters. To avoid service interruptions, do not replace the API key unless your existing key is compromised.

Request

Path Parameters

Query Parameters

Response

204 - Ok. The IAM API key is successfully reset.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: List available Kubernetes versions

GET /v1/kube-versions

List available Kubernetes versions that you can use to create a cluster. Note: This API call is deprecated. Use the `GET /v1/versions` API instead.

Request

Response

200 - Success. A list of available BOM versions is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List available locations

GET /v1/locations

List locations from the IBM Cloud catalog that are supported by the IBM Cloud Kubernetes Service.

Request

Response

200 - Success

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View information about the containers-kubernetes-key API key owner

GET /v1/logging/{id_or_name}/clusterkeyowner

View the name and email address for the owner of the cluster's containers-kubernetes-key API key.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the target cluster. To list the clusters that you have access to, run `ibmcloud ks cluster ls`.

Query Parameters

Response

200 - Ok. The cluster API key ID and the owner's name and email address.

email

string

The email value.

id

string

The id value.

name

string

The name value.

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View the default logging endpoint for the target region

GET /v1/logging/{id_or_name}/default

View the default logging endpoint for the target region.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the target cluster. To list the clusters that you have access to, run `ibmcloud ks cluster ls`.

Query Parameters

Response

200 - Ok. The default logging endpoint for the target region.

endpoint

string

The IBM Cloud Log Analysis with LogDNA API endpoint that the hostname uses.

hostname

string

The hostname for the ibm logging service.

port

integer

The port for the ibm logging service.

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deletes all logging filter configurations for the cluster

DELETE /v1/logging/{id_or_name}/filterconfigs

Stops log filtering.

Request

Path Parameters

Query Parameters

force_update

boolean

Forces the request which may cause a new fluentd version to be deployed to the cluster.

Response

204 - Ok. All log filtering configurations have been removed.

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List all logging filter configurations in the cluster

GET /v1/logging/{id_or_name}/filterconfigs

List the logging filter configurations that you created in a cluster.

Request

Path Parameters

Query Parameters

show_matches

boolean

Set to true to populate global filters with all matching logging configurations.

Response

200 - Ok. A list of logging filters in the cluster.

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a logging filter configuration

POST /v1/logging/{id_or_name}/filterconfigs

Start filtering logs that are forwarded by your logging configuration from the given sources based on one or more selectors.

Request

Request Body

FilterConfigBody

The new logging filter configuration.

container

string

The name of the container where you want to apply the logging filter.

logLevel

string

The log level that you want to apply to your logging filter.

loggingConfigs

Required *

array

A list of logging configuration IDs where you want to apply the logging filter.

message

string

A string in a message to which you want to apply the logging filter.

namespace

string

The Kubernetes namespace where you want to apply the logging filter.

regexMessageEnabled

boolean

Set this value to `true` if you want the message field to be interpreted as a regular expression.

type

string

The type of the logging filter.

Path Parameters

Query Parameters

force_update

boolean

Forces the request which may cause a new fluentd version to be deployed to the cluster.

Response

201 - Ok. Logs from the specified logging configurations will be filtered on the provided selectors.

container

string

The name of the container that you want to exclude from your logs.

coveringFilters

array

A list of logging filter IDs that the filter covers.

id

string

The unique identifier of the logging configuration.

label

string

The pod label that you want to exclude from your logs.

logLevel

string

The log level that you want to apply to your logs. Supported values are `debug` or `info`.

loggingConfigs

array

A list of logging configuration IDs where you want to apply the log filter.

message

string

A string in a log message that you want to exclude from your logs.

namespace

string

The Kubernetes namespace that you want to exclude from your logs.

regexMessageEnabled

boolean

Set this value to `true` if you want to interpret the message field as a regular expression.

type

string

The type of filter that you want to apply to your logs. Supported values are `container` and `non-container`.

version

string

Internal use only.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all of the required parameters, formatted in JSON. Supported logging types are 'syslog' and 'ibm'. Log forwarding is not supported for the 'ibm-system' and 'kube-system' namespaces.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Delete a logging filter configuration

DELETE /v1/logging/{id_or_name}/filterconfigs/{id}

Delete the specified logging filter configuration for a cluster.

Request

Path Parameters

Query Parameters

force_update

boolean

Forces the request which may cause a new fluentd version to be deployed to the cluster.

Response

204 - Ok. Logs will no longer be filtered by the specified filter configuration.

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View a logging filter configuration

GET /v1/logging/{id_or_name}/filterconfigs/{id}

View details for a logging filter configuration.

Request

Path Parameters

Query Parameters

show_matches

boolean

To show matching logging configurations for global filters, set to `true`.

Response

200 - Ok. A logging filter is configured for your cluster.

container

string

The name of the container that you want to exclude from your logs.

coveringFilters

array

A list of logging filter IDs that the filter covers.

id

string

The unique identifier of the logging configuration.

label

string

The pod label that you want to exclude from your logs.

logLevel

string

The log level that you want to apply to your logs. Supported values are `debug` or `info`.

loggingConfigs

array

A list of logging configuration IDs where you want to apply the log filter.

message

string

A string in a log message that you want to exclude from your logs.

namespace

string

The Kubernetes namespace that you want to exclude from your logs.

regexMessageEnabled

boolean

Set this value to `true` if you want to interpret the message field as a regular expression.

type

string

The type of filter that you want to apply to your logs. Supported values are `container` and `non-container`.

version

string

Internal use only.

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update a logging filter configuration

PUT /v1/logging/{id_or_name}/filterconfigs/{id}

Update a logging filter config where `id` is the UUID for the filter config.

Request

Request Body

FilterConfigBody

The new filter configuration for the specified ID.

container

string

The name of the container where you want to apply the logging filter.

logLevel

string

The log level that you want to apply to your logging filter.

loggingConfigs

Required *

array

A list of logging configuration IDs where you want to apply the logging filter.

message

string

A string in a message to which you want to apply the logging filter.

namespace

string

The Kubernetes namespace where you want to apply the logging filter.

regexMessageEnabled

boolean

Set this value to `true` if you want the message field to be interpreted as a regular expression.

type

string

The type of the logging filter.

Path Parameters

Query Parameters

force_update

boolean

Forces the request which may cause a new fluentd version to be deployed to the cluster.

Response

200 - Ok. The configuration was updated.

container

string

The name of the container that you want to exclude from your logs.

coveringFilters

array

A list of logging filter IDs that the filter covers.

id

string

The unique identifier of the logging configuration.

label

string

The pod label that you want to exclude from your logs.

logLevel

string

The log level that you want to apply to your logs. Supported values are `debug` or `info`.

loggingConfigs

array

A list of logging configuration IDs where you want to apply the log filter.

message

string

A string in a log message that you want to exclude from your logs.

namespace

string

The Kubernetes namespace that you want to exclude from your logs.

regexMessageEnabled

boolean

Set this value to `true` if you want to interpret the message field as a regular expression.

type

string

The type of filter that you want to apply to your logs. Supported values are `container` and `non-container`.

version

string

Internal use only.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all of the required parameters, formatted in JSON. Supported logging types are 'syslog'. Log forwarding is not supported for the 'ibm-system' and 'kube-system' namespaces.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Delete all log forwarding configurations for a cluster

DELETE /v1/logging/{id_or_name}/loggingconfig

Stops all log forwarding for a cluster by deleting all log forwarding configurations.

Request

Path Parameters

Query Parameters

force_update

boolean

Forces the request which may cause a new fluentd version to be deployed to the cluster.

Response

204 - Ok. All log forwarding configurations have been removed.

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List all log forwarding configurations in the cluster

GET /v1/logging/{id_or_name}/loggingconfig

List the log forwarding configurations in the target cluster.

Request

Response

200 - Ok. A list of logging configurations in the Kubernetes cluster.

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List all log forwarding configurations for a log source in the cluster

GET /v1/logging/{id_or_name}/loggingconfig/{log_source}

List the log forwarding configurations for the specified log source in the target cluster.

Request

Response

200 - Ok. A list of logging configurations for the specified log source in the cluster.

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a log forwarding configuration

POST /v1/logging/{id_or_name}/loggingconfig/{log_source}

Enable log collection for a specified log source and log forwarding to IBM Cloud Log Analysis or to an external syslog server. If you want to forward logs from one log source to both log collector servers, then you must create two logging configurations.

Request

Request Body

LogConfigBody

The type of log collector server for the logging configuration. Supported logging types are 'syslog' and 'ibm'.

appLogContainers

Required *

array

A list of container names that you want to collect logs for.

appLogPaths

Required *

array

A list of app paths that you want to collect logs for.

caCert

string

The name of the Kubernetes secret that holds the Certificate Authority certificate that you want to use for the syslog TLS termination.

loggingType

string

The logging type that you want to use. Supported values are `syslog` and `ibm`.

namespace

string

The Kubernetes namespace where the logging configuration is applied.

org

string

The name of the Cloud Foundry organization where the logging configuration is created.

protocol

string

The protocol that you want to use for syslog forwarding. Supported values are TCP, TLS and UDP. If no value is provided, the protocol is set to UDP by default.

remoteLogPort

integer

The port that the logging server uses. This value is required only when `LoggingType` is set to `syslog`.

remoteLogServer

string

The hostname or IP address of the logging server. This values is required only if `LoggingType` is set to `syslog`.

space

string

The name of the Cloud Foundry space where the logging configuration is created.

verifyMode

string

The verification mode that you want to use for the syslog TLS protocol. By default, `verify-none` is used. Other supported values include `verify-peer`, `verify-client-once`, and `verify-if-no-peer-cert`.

Path Parameters

Query Parameters

force_update

boolean

Forces the request which may cause a new fluentd version to be deployed to the cluster.

skip_validation

boolean

Set to `true` to skip validation of the space and org Cloud Foundry properties. Skipping validation decreases processing time, but an invalid logging configuration will not correctly forward logs.

Response

201 - Ok. Logs from the specified log source will be forwarded to the log server.

appLogContainers

array

A list of container names that you want to collect logs for.

appLogPaths

array

A list of app paths that you want to collect logs for.

caCert

string

The name of the Kubernetes secret that holds the Certificate Authority certificate that you want to use for the syslog TLS termination.

endpoint

string

The IBM Cloud Log Analysis with LogDNA API endpoint that the logging configuration uses.

errors

array

A list of errors that occurred during the last logging config update.

id

string

The unique identifier of the log source.

logSource

string

The type of logs that you want to read and forward to the logging server. Supported values are `container`, `kubernetes`, `ingress`, `worker`, and `application`.

logSourceContainers

array

A list of container names that logs are collected for and forwarded to the logging server.

logSourcePaths

array

A list of app paths that logs are collected for and forwarded to the logging server.

loggingType

string

The logging protocol to use. Supported values are `syslog` and `ibm`.

namespace

string

The Kubernetes namespace where the logging type is applied. This parameter is set only when the `container` log source is used.

org

string

The name of the Cloud Foundry organization where the logging configuration was created.

orgGUID

string

The GUID of the Cloud Foundry organization where the logging configuration was created.

protocol

string

The protocol that you want to use for syslog forwarding. Supported values are `TCP` and `UDP`. If no value is provided, the protocol is set to `UDP` by default.

remoteLogPort

integer

The port of the logging server.

remoteLogServer

string

The hostname or IP address of the logging server.

space

string

The name of the Cloud Foundry space where the logging configuration was created.

spaceGUID

string

The GUID of the Cloud Foundry space where the logging configuration was created.

verifyMode

string

The verification mode that is used for the syslog TLS protocol.

version

string

Internal use only.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format. Supported logging types are 'syslog' and 'ibm'. Log forwarding is not supported for the 'ibm-system' and 'kube-system' namespaces.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Delete a log forwarding configuration

DELETE /v1/logging/{id_or_name}/loggingconfig/{log_source}/{id}

Stops log forwarding by deleting a specified logging configuration.

Request

Response

204 - Ok. Logs will no longer be forwarded to the log server for the specified logging configuration.

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update a log forwarding configuration

PUT /v1/logging/{id_or_name}/loggingconfig/{log_source}/{id}

Update the details of a log forwarding configuration.

Request

Request Body

LogConfigBody

The new type of log collector server for the logging configuration. Supported logging types are 'syslog'.

appLogContainers

Required *

array

A list of container names that you want to collect logs for.

appLogPaths

Required *

array

A list of app paths that you want to collect logs for.

caCert

string

The name of the Kubernetes secret that holds the Certificate Authority certificate that you want to use for the syslog TLS termination.

loggingType

string

The logging type that you want to use. Supported values are `syslog` and `ibm`.

namespace

string

The Kubernetes namespace where the logging configuration is applied.

org

string

The name of the Cloud Foundry organization where the logging configuration is created.

protocol

string

The protocol that you want to use for syslog forwarding. Supported values are TCP, TLS and UDP. If no value is provided, the protocol is set to UDP by default.

remoteLogPort

integer

The port that the logging server uses. This value is required only when `LoggingType` is set to `syslog`.

remoteLogServer

string

The hostname or IP address of the logging server. This values is required only if `LoggingType` is set to `syslog`.

space

string

The name of the Cloud Foundry space where the logging configuration is created.

verifyMode

string

The verification mode that you want to use for the syslog TLS protocol. By default, `verify-none` is used. Other supported values include `verify-peer`, `verify-client-once`, and `verify-if-no-peer-cert`.

Path Parameters

Query Parameters

skip_validation

boolean

Set to `true` to skip validation of the space and org Cloud Foundry properties. Skipping validation decreases processing time, but an invalid logging configuration will not correctly forward logs.

Response

200 - Ok. The configuration was updated.

appLogContainers

array

A list of container names that you want to collect logs for.

appLogPaths

array

A list of app paths that you want to collect logs for.

caCert

string

The name of the Kubernetes secret that holds the Certificate Authority certificate that you want to use for the syslog TLS termination.

endpoint

string

The IBM Cloud Log Analysis with LogDNA API endpoint that the logging configuration uses.

errors

array

A list of errors that occurred during the last logging config update.

id

string

The unique identifier of the log source.

logSource

string

The type of logs that you want to read and forward to the logging server. Supported values are `container`, `kubernetes`, `ingress`, `worker`, and `application`.

logSourceContainers

array

A list of container names that logs are collected for and forwarded to the logging server.

logSourcePaths

array

A list of app paths that logs are collected for and forwarded to the logging server.

loggingType

string

The logging protocol to use. Supported values are `syslog` and `ibm`.

namespace

string

The Kubernetes namespace where the logging type is applied. This parameter is set only when the `container` log source is used.

org

string

The name of the Cloud Foundry organization where the logging configuration was created.

orgGUID

string

The GUID of the Cloud Foundry organization where the logging configuration was created.

protocol

string

The protocol that you want to use for syslog forwarding. Supported values are `TCP` and `UDP`. If no value is provided, the protocol is set to `UDP` by default.

remoteLogPort

integer

The port of the logging server.

remoteLogServer

string

The hostname or IP address of the logging server.

space

string

The name of the Cloud Foundry space where the logging configuration was created.

spaceGUID

string

The GUID of the Cloud Foundry space where the logging configuration was created.

verifyMode

string

The verification mode that is used for the syslog TLS protocol.

version

string

Internal use only.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format. Supported logging types are 'syslog'. Log forwarding is not supported for the 'ibm-system' and 'kube-system' namespaces.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Refresh the cluster's logging configuration

PUT /v1/logging/{id_or_name}/refresh

Refresh the logging configuration for a cluster. This refreshes the logging token for any logging configuration that is forwarding to the space level in your cluster.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the target cluster. To list the clusters that you have access to, run `ibmcloud ks cluster ls`.

Query Parameters

force_update

boolean

Forces the request which may cause a new fluentd version to be deployed to the cluster.

Response

204 - Ok. A request was sent for the cluster's logging configuration to be refreshed.

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Check if automatic updates for the Fluentd logging add-on are enabled in the

GET /v1/logging/{id_or_name}/updatepolicy

Check if automatic updates for the Fluentd logging add-on are enabled and whether your Fluentd pods are updated to the latest version.

Request

Response

200 - Ok. The current update policy.

autoUpdate

boolean

If set to `true`, the cluster is enabled for automatic updates.

latestVersion

boolean

If set to `true`, the cluster log forwarder runs the latest version.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format. Supported logging types are 'syslog' and 'ibm'. Log forwarding is not supported for the 'ibm-system' and 'kube-system' namespaces.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enable or diable automatic updates for the Fluentd logging add-on in the clus

PUT /v1/logging/{id_or_name}/updatepolicy

By default, automatic updates to the Fluentd logging add-on are enabled. Fluentd pods are automatically updated when a new version is available. To instead update the add-on manually, you can use this call to disable automatic updates. If automatic updates for the Fluentd add-on are disabled, you can re-enable automatic updates. Whenever the next version becomes available, the Fluentd pods are automatically updated to the latest version.

Request

Request Body

UpdatePolicy

The new update policy configuration

autoUpdate

boolean

If set to `true`, the cluster is enabled for automatic updates.

latestVersion

boolean

If set to `true`, the cluster log forwarder runs the latest version.

Response

204 - Ok. The logging update policy has been changed.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format. Supported logging types are 'syslog' and 'ibm'. Log forwarding is not supported for the 'ibm-system' and 'kube-system' namespaces.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. To retrieve your access tokens, be sure that you're logged in and run `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To see a list of your clusters, run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View the current messages

GET /v1/messages

View the current messages. Messages are notifications for new features or changes that may require attention.

Request

Response

200 - Success

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update a DNS record by adding an NLB IP address

PUT /v1/nlb-dns/clusters/{id_or_name}/add

Add an NLB IP address to an existing NLB subdomain that you created. For example, in a multizone cluster, you create an NLB in each zone to expose an app. You registered an NLB IP in one zone with a subdomain by using the `POST /clusters/{idOrName}/register` call, so now you can add the NLB IPs from the other zones to this existing subdomain.

Request

Request Body

NlbConfig

The input parameter to update an NLB DNS record. Include only the `nlbHost` parameter to specify the existing NLB subdomain and the `nlbIP` parameter to specify the NLB IP you want to add.

certProvider

string

The certProvider value.

clusterID

string

The clusterID value.

crn

string

The crn value.

isDefault

boolean

The isDefault value.

nlbDnsType

string

The nlbDnsType value.

nlbHost

string

The nlbHost value.

nlbIPArray

Required *

array

The nlbIPArray value.

nlbMonitorState

string

The nlbMonitorState value.

nlbSslSecretName

string

The nlbSslSecretName value.

nlbSslSecretStatus

string

The nlbSslSecretStatus value.

nlbStatusMessage

string

The nlbStatusMessage value.

nlbType

string

The nlbType value.

provider

string

The provider value.

secretNamespace

string

The secretNamespace value.

zoneID

string

The zoneID value.

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

204 - Ok. The request to update the NLB subdomain was successfully processed.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster, NLB subdomain, or NLB IP address could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list existing NLB subdomains for a cluster, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`. To list existing NLB IP addresses in a cluster, run `kubectl get svc -n <namespace>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enable or disable a health check monitor for an NLB subdomain

PUT /v1/nlb-dns/clusters/{id_or_name}/health

Enable or disable an existing health check monitor for an NLB subdomain.

Request

Request Body

NlbConfig

Include only the `nlbHost` parameter to specify the NLB subdomain and the `nlbMonitorState` parameter to specify the health check monitor as `enabled` or `disabled`.

certProvider

string

The certProvider value.

clusterID

string

The clusterID value.

crn

string

The crn value.

isDefault

boolean

The isDefault value.

nlbDnsType

string

The nlbDnsType value.

nlbHost

string

The nlbHost value.

nlbIPArray

Required *

array

The nlbIPArray value.

nlbMonitorState

string

The nlbMonitorState value.

nlbSslSecretName

string

The nlbSslSecretName value.

nlbSslSecretStatus

string

The nlbSslSecretStatus value.

nlbStatusMessage

string

The nlbStatusMessage value.

nlbType

string

The nlbType value.

provider

string

The provider value.

secretNamespace

string

The secretNamespace value.

zoneID

string

The zoneID value.

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

200 - Ok. Health check monitor enable/disable request for successfully processed.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or NLB subdomain could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list existing NLB subdomains for a cluster, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove an IP address from an NLB subdomain

DELETE /v1/nlb-dns/clusters/{id_or_name}/host/{nlb_host}/ip/{nlb_ip}/remove

Remove an IP address from the DNS record for an existing NLB subdomain. If you remove all IPs from a hostname, the hostname still exists but no IPs are associated with it.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

nlb_host

Required *

string

The existing NLB subdomain from which you want remove an NLB IP. To list existing NLB subdomains, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

nlb_ip

Required *

string

The NLB IP address that you want to unregister from the DNS record for the hostname. To list the NLB IPs registered with NLB subdomains, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

Query Parameters

Response

204 - Deleted. The NLB IP address was successfully unregistered from the DNS record for the NLB subdomain.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster, NLB subdomain, or NLB IP address could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list existing NLB subdomains and the NLB IPs registered with those hostnames, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List registered NLB subdomains and NLB IP addresses

GET /v1/nlb-dns/clusters/{id_or_name}/list

In a classic cluster, list NLB subdomains and the NLB IP addresses registered with the DNS provider for each subdomain.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

200 - Ok. A list of NLB subdomains and the NLB IPs associated with the DNS record for the subdomains is returned for this cluster.

clusterid

string

The clusterid value.

nlbHealthCheckConfigs

array

The nlbHealthCheckConfigs value.

nlbHealthCheckStatus

array

The nlbHealthCheckStatus value.

nlbs

array

The nlbs value.

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a new NLB subdomain and associate one or more NLB IP addresses with it

POST /v1/nlb-dns/clusters/{id_or_name}/register

Create a new NLB subdomain and register NLB IP addresses with the DNS provider. If the registration fails, an error from the DNS provider is returned.

Request

Request Body

NlbConfig

Include either the `nlbIP` or the `nlbIPArray` parameter that specifies the NLB IP address(es) that you want to register.

certProvider

string

The certProvider value.

clusterID

string

The clusterID value.

crn

string

The crn value.

isDefault

boolean

The isDefault value.

nlbDnsType

string

The nlbDnsType value.

nlbHost

string

The nlbHost value.

nlbIPArray

Required *

array

The nlbIPArray value.

nlbMonitorState

string

The nlbMonitorState value.

nlbSslSecretName

string

The nlbSslSecretName value.

nlbSslSecretStatus

string

The nlbSslSecretStatus value.

nlbStatusMessage

string

The nlbStatusMessage value.

nlbType

string

The nlbType value.

provider

string

The provider value.

secretNamespace

string

The secretNamespace value.

zoneID

string

The zoneID value.

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

201 - Created. The NLB subdomain was successfully created and the NLB IP addres(es) registered with DNS.

certProvider

string

The certProvider value.

clusterID

string

The clusterID value.

crn

string

The crn value.

isDefault

boolean

The isDefault value.

nlbDnsType

string

The nlbDnsType value.

nlbHost

string

The nlbHost value.

nlbIPArray

array

The nlbIPArray value.

nlbMonitorState

string

The nlbMonitorState value.

nlbSslSecretName

string

The nlbSslSecretName value.

nlbSslSecretStatus

string

The nlbSslSecretStatus value.

nlbStatusMessage

string

The nlbStatusMessage value.

nlbType

string

The nlbType value.

provider

string

The provider value.

secretNamespace

string

The secretNamespace value.

zoneID

string

The zoneID value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or NLB IP address could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list existing NLB IP addresses in a cluster, run `kubectl get svc -n <namespace>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Configure a health check monitor for an NLB subdomain

PATCH /v1/nlb-dns/health/clusters/{id_or_name}/config

Create and optionally enable a health check monitor for an existing NLB subdomain in a cluster.

Request

Request Body

NlbHealthSetConfig

The input body to configure the health check monitor for an NLB subdomain. To enable the health check monitor, set `monitorState` to `enabled`. For more information about each `healthcheckProperties` parameter, see https://cloud.ibm.com/docs/containers?topic=containers-cli-plugin-kubernetes-service-cli#cs_nlb-dns-monitor-configure

allowInsecureSet

string

The allowInsecureSet value.

clusterID

string

The clusterID value.

createdOn

string

The createdOn value.

desc

string

The desc value.

followRedirectSet

string

The followRedirectSet value.

healtcheckPropertiesSetStatus

string

The healtcheckPropertiesSetStatus value.

healthcheckProperties

object

The healthcheckProperties value.

modifiedOn

string

The modifiedOn value.

monitorState

string

The monitorState value.

nlbHost

string

The nlbHost value.

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

201 - Created. The health check monitor was successfully configured for the NLB subdomain.

allowInsecureSet

string

The allowInsecureSet value.

clusterID

string

The clusterID value.

createdOn

string

The createdOn value.

desc

string

The desc value.

followRedirectSet

string

The followRedirectSet value.

healtcheckPropertiesSetStatus

string

The healtcheckPropertiesSetStatus value.

healthcheckProperties

HealthcheckProperties

HealthcheckProperties used for storing config provided by user for healthcheck deprecated

modifiedOn

string

The modifiedOn value.

monitorState

string

The monitorState value.

nlbHost

string

The nlbHost value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or NLB subdomain could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list existing NLB subdomains for a cluster, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View the health check monitor settings for an NLB subdomain

GET /v1/nlb-dns/health/clusters/{id_or_name}/host/{nlb_host}/config

View the health check monitor settings for an NLB subdomain.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

nlb_host

Required *

string

The NLB subdomain that you want health check monitor settings for. To list existing NLB subdomains, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

Query Parameters

Response

200 - Ok. Health check monitor settings for the specified NLB subdomain are returned.

allowInsecureSet

string

The allowInsecureSet value.

clusterID

string

The clusterID value.

createdOn

string

The createdOn value.

desc

string

The desc value.

followRedirectSet

string

The followRedirectSet value.

healtcheckPropertiesSetStatus

string

The healtcheckPropertiesSetStatus value.

healthcheckProperties

HealthcheckProperties

HealthcheckProperties used for storing config provided by user for healthcheck deprecated

modifiedOn

string

The modifiedOn value.

monitorState

string

The monitorState value.

nlbHost

string

The nlbHost value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or NLB subdomain could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list existing NLB subdomains for a cluster, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the health check monitor settings for all NLB subdomains

GET /v1/nlb-dns/health/clusters/{id_or_name}/list

List the settings for all existing health check monitors in a cluster.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

200 - Ok. The health check monitor settings for each NLB subdomain in the cluster are returned.

clusterid

string

The clusterid value.

nlbHealthCheckConfigs

array

The nlbHealthCheckConfigs value.

nlbHealthCheckStatus

array

The nlbHealthCheckStatus value.

nlbs

array

The nlbs value.

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: List the health check status for the IPs behind NLB subdomains in

GET /v1/nlb-dns/health/clusters/{id_or_name}/status

Deprecated: List the health check status (`healthy` or `not healthy`) that is returned by the monitors for the IPs behind all NLB subdomains in a cluster.

Request

Path Parameters

id_or_name

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Query Parameters

Response

200 - Ok. An array that contains the NlbHealthCheckStatus is returned.

clusterid

string

The clusterid value.

nlbHealthCheckConfigs

array

The nlbHealthCheckConfigs value.

nlbHealthCheckStatus

array

The nlbHealthCheckStatus value.

nlbs

array

The nlbs value.

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List product-specific values to substitute for variables in other files

GET /v1/prodconfig

List product-specific values to substitute for variables in other files.

Request

Response

200 - Success

company_name

string

The company name value.

container_service_name

string

The container service name value.

iaas_name

string

The iaas name value.

product_name

string

The product name value.

product_name_short

string

The product name short value.

Deprecated: List available Kubernetes Service regions

GET /v1/regions

List available IBM Cloud Kubernetes Service regions. A region is a geographic area that is accessed by a container service endpoint.

Request

Response

200 - Success

regions

array

The regions value.

404 - Not found. The list of regions could not be found. Try your request again.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List available IBM Cloud classic infrastructure subnets

GET /v1/subnets

List available subnets in an IBM Cloud classic infrastructure account. Before using this operation, you must store your IBM Cloud classic infrastructure credentials in each Kubernetes Service account by using the `POST /v1/credentials` API or by running `ibmcloud ks credential set --infrastructure-api-key <API_key> --infrastructure-username <API_username>`.

Request

Path Parameters

Query Parameters

datacenters

string

A comma seperated list of datacenters to filter subnets based off of.

Response

200 - Ok.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View the VLAN spanning status

GET /v1/subnets/vlan-spanning

View the VLAN spanning status for an IBM Cloud Infrastructure (SoftLayer) account. VLAN spanning enables all devices on an account to communicate with each other by means of the private network, regardless of its assigned VLAN.

Request

Path Parameters

Query Parameters

Response

200 - Ok. Details of VLAN spanning enablement.

enabled

boolean

The enabled value.

modifiedDate

string

The modifiedDate value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Unable to determine whether VLAN spanning is enabled in the IBM Cloud infrastructure account.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View a user's ability to create free and standard clusters in a region and re

GET /v1/user-config

View whether a user can create free and paid clusters in a region and resource group. If `"freeEnabled": true` is returned, you can create a free cluster in the specified region. If `"storedIaasCredentials": true` is returned, your IBM Cloud account uses IBM Cloud infrastructure (SoftLayer) credentials that were manually set with the `POST ​/v1​/credentials` API or the `ibmcloud ks credential set` command. When you create a standard cluster in the specified region and resource group, these credentials are used.

Request

Path Parameters

Query Parameters

Response

200 - Ok. The user's permissions to create free and paid clusters is returned.

freeEnabled

boolean

The freeEnabled value.

storedIaasCredentials

boolean

The storedIaasCredentials value.

List available IBM Cloud Kubernetes Service versions

GET /v1/versions

List available IBM Cloud Kubernetes Service versions that you can use to create a cluster in a region. The container management platform version that you select is installed on your cluster master and worker nodes. Later, you can update the version but cannot roll back to a previous version or switch to a different container management platform. If you want to use multiple versions, create a separate cluster for each version.

Request

Response

200 - Success. Available container management platform versions for the IBM Cloud Kubernetes Service region are returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List available zones (data centers)

GET /v1/zones

List available zones (data centers) where you can create a cluster.

Request

Path Parameters

Query Parameters

show_flavors

string

Specify true or false to show the machine types available in each zone.

location

string

Specify a location to filter zones for. To see supported locations, use the `GET /v1​/locations` API or run `ibmcloud ks locations`.

Response

200 - Success. A list of available zones is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Ignore specific ingress status errors in ingress status reporting

POST /v2/alb/addIgnoredIngressStatusErrors

Ignore specific ingress status errors in ingress status reporting. Ignored errors will not affect the cluster's ingress status state.

Request

Request Body

IgnoredIngressStatusErrors

Ingress status errors that are ignored for ingress status reporting.

cluster

string

The cluster value.

ignoredErrors

Required *

array

The ignoredErrors value.

Response

200 - Ignored ingress status errors were successfully added to the ingress status configuration.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of an ALB

GET /v2/alb/getAlb

View detailed information for an ALB in a VPC or classic cluster. An `ALBConfig` response will be returned for ALBs in classic clusters.

Request

Path Parameters

Query Parameters

alb_id

Required *

string

The ID of the ALB that you want details for. To list the IDs for the ALBs in a cluster, use the `GET /v2/alb/getClusterAlbs` API or run `ibmcloud ks alb ls --cluster <cluster_name_or_ID>`.

Response

200 - Ok. Details for the specified ALB are returned.

albBuild

string

The build number of the ALB.

albID

string

The ID of the application load balancer (ALB).

albType

string

The type of ALB.

albip

string

The public IP address that exposes the ALB.

authBuild

string

The auth build of the ALB.

clusterID

string

The ID of the cluster that the ALB belongs to.

createdDate

string

The date the ALB was created.

disableDeployment

boolean

If set to true, the deployment of the ALB is disabled.

enable

boolean

Set to true to enable the ALB, or false to disable the ALB for the cluster.

name

string

The name of the cluster that the ALB belongs to.

nlbVersion

string

The version of network load balancer that the ALB uses.

numOfInstances

string

Desired number of ALB replicas that you want in your cluster.

resize

boolean

If set to true, resizing of the ALB is done.

state

string

The state of the ALB.

status

string

The status of the ALB.

vlanID

string

The VLAN ID that the ALB is attached to.

zone

string

The zone where you want to add ALBs.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or ALB could not be found. To list the classic clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List supported Ingress controller images

GET /v2/alb/getAlbImages

List the community Kubernetes Ingress controller and IBM Cloud Kubernetes Service ALB images that are supported.

Request

Response

200 - Ok. A list of supported Ingress controller images is returned.

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to list supported Ingress controller images.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List all ALBs in a cluster

GET /v2/alb/getClusterAlbs

List all ALBs in a VPC or classic cluster. A `ClusterALB` response will be returned for classic clusters.

Note: If no ALB IDs are returned for a VPC cluster, no VPC load balancer exists for the ALBs. If no ALB IDs are returned for a classic cluster, no available portable subnet exists in the VLANs that your ALBs are on.

Request

Path Parameters

Query Parameters

cluster

Required *

string

To list the classic clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

Response

200 - Ok. A list of ALBs for the cluster is returned.

alb

array

PrivateIngressHostname string `json:"privateIngressHostname"` PrivateIngressSecretName string `json:"privateIngressSecretName"`

dataCenter

string

The dataCenter value.

id

string

The id value.

isPaid

boolean

The isPaid value.

publicIngressHostname

string

The publicIngressHostname value.

publicIngressSecretName

string

The publicIngressSecretName value.

region

string

The region value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the classic clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the status of the in-cluster ALB health checker

GET /v2/alb/getIngressClusterHealthcheck

Check the status of the in-cluster ALB health checker.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster.

Response

200 - Ok. The in-cluster ALB health checker status for your cluster is returned.

cluster

string

The cluster value.

enable

boolean

The enable value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the status of the ingress resources in a cluster

GET /v2/alb/getStatus

Check the status of the IBM provided subdomain and application load balancers

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want information about.

Response

200 - Ok. The ingress status for your cluster is returned.

StatusList

array

The StatusList value.

albStatus

array

The albStatus value.

cluster

string

The cluster value.

enabled

boolean

The enabled value.

generalComponentStatus

array

The generalComponentStatus value.

ignoredErrors

array

The ignoredErrors value.

message

string

The message value.

nonTranslatedStatus

string

The nonTranslatedStatus value.

routerStatus

array

The routerStatus value.

secretStatus

array

The secretStatus value.

status

string

The status value.

subdomainStatus

array

The subdomainStatus value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List all ingress status errors that are ignored for the cluster

GET /v2/alb/listIgnoredIngressStatusErrors

List all ingress status errors that are ignored for the cluster. If no ignored errors are returned, then the cluster does not have ignored ingress status errors.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster.

Response

200 - Ok. All ignored ingress status errors for your cluster are returned.

cluster

string

The cluster value.

ignoredErrors

array

The ignoredErrors value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Unignore specific ingress status errors in ingress status reporting

DELETE /v2/alb/removeIgnoredIngressStatusErrors

Unignore specific ingress status errors in ingress status reporting. Unignored errors will affect the cluster's ingress status state.

Request

Request Body

IgnoredIngressStatusErrors

Ingress status errors that are ignored for ingress status reporting.

cluster

string

The cluster value.

ignoredErrors

Required *

array

The ignoredErrors value.

Response

200 - Ignored ingress status errors were successfully removed from the ingress status configuration.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Set the in-cluster ingress health checker

POST /v2/alb/setIngressClusterHealthcheck

Set the in-cluster ingress health checker state. It can be either enabled or disabled.

Request

Request Body

ALBClusterHealthCheckConfig

The desired state of the in-cluster ingress health checker.

cluster

string

The cluster value.

enable

boolean

The enable value.

Response

200 - Set successfully finished.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Set the state of the ingress status

POST /v2/alb/setIngressStatusState

Set the state of the ingress status for a cluster. It can be either enabled or disabled.

Request

Request Body

StatusState

The desired state of ingress status.

cluster

string

The cluster value.

enable

boolean

The enable value.

Response

200 - Set successfully finished.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update ALBs in a cluster

POST /v2/alb/updateAlb

Update one or more public or private ALBs to a supported IBM Cloud Kubernetes Service ALB image or a supported community Kubernetes Ingress controller image. To update your ALB to a specified image version, automatic updates must be disabled. You can check the automatic update status by using the `GET ​/v1​/alb​/clusters​/{idOrName}​/updatepolicy` call. NOTE: You cannot use this call to switch your ALB from one type of image to another, such as from an IBM Cloud Kubernetes Service ALB image to a community Kubernetes Ingress controller image. Instead, first disable the ALB by using the `DELETE ​/v1​/alb​/albs​/{albID}` call (classic) or the `POST /v2​/alb​/vpc​/disableAlb` call (VPC). Then, enable the ALB by using the `POST ​/v1​/alb​/albs` (classic) or `POST ​/v2​/alb​/vpc​/enableAlb` (VPC) call, and include the ALB image that you want to switch to in the input parameter.

Request

Request Body

V2UpdateALB

The input parameter to update an ALB's image. To see the supported image versions, use the `GET ​/v2​/alb​/getAlbImages` call.

albBuild

string

The albBuild value.

albList

Required *

array

The albList value.

cluster

string

The cluster value.

Response

200 - Updated. The ALBs in the cluster were successfully updated.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or ALB could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a public or private ALB in a specified zone and VPC cluster

POST /v2/alb/vpc/createAlb

Create a new public or private ALB in a specified zone and VPC cluster.

Request

Request Body

ALB

The input parameters to create an ALB. For more information, see https://ibm.biz/alb_create_vpc

cluster

string

The cluster value.

enableByDefault

boolean

If set to true, the ALB is enabled by default. \

ingressImage

string

The type of Ingress image that you want to use for your ALB deployment.

type

string

The type of ALB that you want to create.

zone

string

The zone where you want to deploy the ALB.

Response

201 - The ALB was successfully created.

alb

string

The alb value.

cluster

string

The cluster value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or zone could not be found. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`. To list the zones available in a VPC cluster, use the `GET /v2/vpc/getCluster` API or run `ibmcloud ks cluster-get --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Disable an ALB in your VPC cluster

POST /v2/alb/vpc/disableAlb

Disable a public or private ALB in your VPC cluster.

Request

Request Body

ALBConfig

The input parameters to disable an ALB. DisableDeployment and albID are required. For more information, see https://ibm.biz/alb_configure_vpc

albBuild

string

The build number of the ALB.

albID

string

The ID of the application load balancer (ALB).

albType

string

The type of ALB.

albip

string

The public IP address that exposes the ALB.

authBuild

string

The auth build of the ALB.

clusterID

string

The ID of the cluster that the ALB belongs to.

createdDate

string

The date the ALB was created.

disableDeployment

boolean

If set to true, the deployment of the ALB is disabled.

enable

boolean

Set to true to enable the ALB, or false to disable the ALB for the cluster.

name

string

The name of the cluster that the ALB belongs to.

nlbVersion

string

The version of network load balancer that the ALB uses.

numOfInstances

string

Desired number of ALB replicas that you want in your cluster.

resize

boolean

If set to true, resizing of the ALB is done.

state

string

The state of the ALB.

status

string

The status of the ALB.

vlanID

string

The VLAN ID that the ALB is attached to.

zone

string

The zone where you want to add ALBs.

Response

204 - Disabled. The ALB for the cluster was successfully disabled.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or ALB could not be found. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`. To list the ALBs in a cluster, use the `GET /v2/alb/getClusterAlbs` API or run `ibmcloud ks alb ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enable an existing ALB in a VPC cluster

POST /v2/alb/vpc/enableAlb

Enable a public or private ALB in your VPC cluster.

Request

Request Body

ALBConfig

The input parameter to enable an ALB. AlbID is required. To switch your ALB from one type of image to another, such as from an IBM Cloud Kubernetes Service ALB image to a community Kubernetes Ingress controller image, specify that image version in the ALBBuild field. To see the supported image versions, use the `GET ​/v2​/alb​/getAlbImages` call. For more information, see https://ibm.biz/alb_configure_vpc

albBuild

string

The build number of the ALB.

albID

string

The ID of the application load balancer (ALB).

albType

string

The type of ALB.

albip

string

The public IP address that exposes the ALB.

authBuild

string

The auth build of the ALB.

clusterID

string

The ID of the cluster that the ALB belongs to.

createdDate

string

The date the ALB was created.

disableDeployment

boolean

If set to true, the deployment of the ALB is disabled.

enable

boolean

Set to true to enable the ALB, or false to disable the ALB for the cluster.

name

string

The name of the cluster that the ALB belongs to.

nlbVersion

string

The version of network load balancer that the ALB uses.

numOfInstances

string

Desired number of ALB replicas that you want in your cluster.

resize

boolean

If set to true, resizing of the ALB is done.

state

string

The state of the ALB.

status

string

The status of the ALB.

vlanID

string

The VLAN ID that the ALB is attached to.

zone

string

The zone where you want to add ALBs.

Response

201 - Enabled. The ALB for the cluster was successfully enabled.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions to use a requested optional feature.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or ALB could not be found. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`. To list the ALBs in a cluster, use the `GET /v2/alb/getClusterAlbs` API or run `ibmcloud ks alb ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Start applying IAM roles corresponding to your access to the cluster

POST /v2/applyRBAC

Apply IAM roles corresponding to your access to the cluster as RoleBindings and ClusterRoleBindings as described in http://ibm.biz/rbac-access. For example, if you have the IAM Viewer role, you will be granted the `ibm-view` role in the cluster. The roles are applied asynchronously. Use `/v2/getRBACStatus` to verify when they have finished applying.

Request

Request Body

Kubeconfig

Options to retrieve a kubeconfig file. Default format is 'json', other options include 'yaml' and 'zip'. To retrieve the Calico network config, pass admin:true and format:"zip" in the body.

admin

boolean

AdminUser Retrieve the admin kubeconfig file.

cluster

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v2/getClusters` API or run `ibmcloud ks cluster ls`.

endpointType

string

EndpointType Default endpoint is the public endpoint if available, private otherwise. Use 'private' to require a private endpoint and 'link' for a Satellite Link endpoint.

format

string

Format Default format is json. Other options include yaml, and zip.

network

boolean

NetworkConfig Retrieve the Calico network config. Requires admin=true and format=zip.

Path Parameters

Query Parameters

Response

202 - Accepted. Applies IAM roles asynchronously.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v2/getClusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Start applying IAM roles corresponding to your access to the cluster, then re

POST /v2/applyRBACAndGetKubeconfig

Apply IAM roles corresponding to your access to the cluster as RoleBindings and ClusterRoleBindings as described in http://ibm.biz/rbac-access, then retrieve the cluster's kubeconfig file to connect to your cluster and run Kubernetes API calls. For example, if you have the IAM Viewer role, you will be granted the `ibm-view` role in the cluster and your kubeconfig will allow 'view' Kubernetes API calls. The roles are applied asynchronously. Use `/v2/getRBACStatus` to verify when they have finished applying.

Request

Request Body

Kubeconfig

Options to retrieve a kubeconfig file. Default format is 'json', other options include 'yaml' and 'zip'. To retrieve the Calico network config, pass admin:true and format:"zip" in the body.

admin

boolean

AdminUser Retrieve the admin kubeconfig file.

cluster

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v2/getClusters` API or run `ibmcloud ks cluster ls`.

endpointType

string

EndpointType Default endpoint is the public endpoint if available, private otherwise. Use 'private' to require a private endpoint and 'link' for a Satellite Link endpoint.

format

string

Format Default format is json. Other options include yaml, and zip.

network

boolean

NetworkConfig Retrieve the Calico network config. Requires admin=true and format=zip.

Path Parameters

Query Parameters

Response

200 - Ok. Returns the cluster's kubeconfig file.

apiVersion

string

Legacy field from pkg/api/types.go TypeMeta.

clusters

array

Clusters is a map of referencable names to cluster configs

contexts

array

Contexts is a map of referencable names to context configs

current-context

string

CurrentContext is the name of the context that you would like to use by default

kind

string

Legacy field from pkg/api/types.go TypeMeta.

preferences

object

Preferences holds general information to be use for cli interactions

users

array

AuthInfos is a map of referencable names to user configs

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v2/getClusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Set the autoupdate status of the cluster master

POST /v2/autoUpdateMaster

Set the autoupdate status of the cluster master. Only a limited set of users can access use this API.

Request

Request Body

AutoUpdateMaster

Input parameters to specify the name or ID of the cluster and whether to enable or disable auto master updates. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

autoUpdate

boolean

The autoUpdate value.

cluster

string

The cluster value.

Path Parameters

Query Parameters

Response

204 - Ok. The request was processed successfully.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The user doesn't have access to this API.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. The specified value is already set on the cluster. To list the clusters properties, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Detailed cluster information

GET /v2/classic/getCluster

Detailed cluster information.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

show_resources

string

To view additional cluster resources like addons, VLANs, subnets, and storage, pass `true`.

Response

200 - Success. Detailed cluster information.

addons

array

The addons value.

caCertRotationStatus

CommonClusterCACertRotation

CommonClusterCACertRotation CA cert rotation properties

calicoIPAutodetectionConfig

string

The calicoIPAutodetectionConfig value.

createdDate

string

The createdDate value.

crn

string

The crn value.

datacenter

string

The datacenter value.

desiredTrustedProfileID

string

The desiredTrustedProfileID value.

disableAutoUpdate

boolean

The disableAutoUpdate value.

entitlement

string

The entitlement value.

etcdPort

string

The etcdPort value.

features

CommonClusterFeatures

Common cluster features

id

string

The id value.

ignitionServerURL

string

The ignitionServerURL value.

imageSecurityEnabled

boolean

The imageSecurityEnabled value.

infrastructureTopology

string

The infrastructureTopology value.

ingress

CommonClusterIngress

Common cluster ingress

isPaid

boolean

The isPaid value.

keyManagementService

CommonClusterKMS

Common clusterkms

konnectivityServerURL

string

The konnectivityServerURL value.

lifecycle

CommonClusterLifecycle

Common cluster lifecycle

location

string

The location value.

locationEndpointURL

string

The locationEndpointURL value.

locationZones

array

The locationZones value.

masterKubeVersion

string

The masterKubeVersion value.

masterURL

string

The masterURL value.

multiAzCapable

boolean

The multiAzCapable value.

name

string

The name value.

networkPlugin

string

The networkPlugin value.

oauthServerURL

string

The oauthServerURL value.

offering

string

The offering value.

outboundTrafficProtection

string

The outboundTrafficProtection value.

podSubnet

string

The podSubnet value.

provider

string

The provider value.

region

string

The region value.

resourceGroup

string

The resourceGroup value.

resourceGroupName

string

The resourceGroupName value.

satellitePrivateEndpointURL

string

The satellitePrivateEndpointURL value.

secureByDefault

string

The secureByDefault value.

secureRequested

boolean

The secureRequested value.

serviceEndpoints

CommonClusterServiceEndpoint

Common cluster service endpoint

serviceSubnet

string

The serviceSubnet value.

state

string

The lifecycle state of the cluster. Possible values include aborted, critical, delete_failed, deleted, deleting, deploy_failed, deploying, normal, pending, requested, updating, unsupported, and warning. For more information, see the docs 'http://ibm.biz/cluster-health-states'

status

string

The status value.

supportedOperatingSystems

array

The supportedOperatingSystems value.

targetVersion

string

The targetVersion value.

trustedProfileID

string

The trustedProfileID value.

type

string

The type value.

versionEOS

string

The versionEOS value.

virtualPrivateEndpointURL

string

The virtualPrivateEndpointURL value.

vpcs

array

The vpcs value.

workerCount

integer

The workerCount value.

workerZones

array

The workerZones value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the classic clusters that you have access to

GET /v2/classic/getClusters

List the classic clusters that you have access to.

Request

Path Parameters

Query Parameters

location

string

Specify a location to filter clusters for. To see supported locations, use the `GET /v1/locations` API or run `ibmcloud ks locations`.

show_resources

string

To view additional cluster resources like addons, VLANs, subnets, and storage, pass `true`.

Response

200 - Success. A list of clusters that you have access to is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get if VRF and Service Endpoint is enabled for the given account in the selec

GET /v2/classic/getPrivateServiceEnabled

Get if VRF and Service Endpoint is enabled for the given account in the selected region.

Request

Path Parameters

Query Parameters

Response

200 - Ok. Detailed information about the private service enablement.

isPrivateServiceEnabled

boolean

The isPrivateServiceEnabled value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Not authorized to use this command. Only a limited group of early adopters have access to this feature. If you are sure that you are part of the limited group of early adopters, contact IBM Cloud support..

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List available classic infrastructure VLANs for a zone

GET /v2/classic/getVLANs

List available public and private VLANs for a specified zone (data center). Before using this operation, you must store your IBM Cloud classic infrastructure credentials in each Kubernetes Service account by using the `POST /v1/credentials` API or by running `ibmcloud ks credential set --infrastructure-api-key <API_key> --infrastructure-username <API_username>`.

Request

Path Parameters

Query Parameters

zone

Required *

string

The ID of the zone where you want to list available public and private VLANs. To list available zones, run `ibmcloud ks zone ls` or use the `GET /v1/datacenters` API.

Response

200 - Ok. A list of all VLANs is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions for the infrastructure provider.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of a worker node for classic cluster

GET /v2/classic/getWorker

View detailed information for a worker node in a classic cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

worker

Required *

string

The ID of the worker node that you want details for. To list all worker nodes for a cluster, use the `GET /v1/clusters/{idOrName}/workers` API or run `ibmcloud ks workers <cluster_name_or_ID>`.

Response

200 - Ok. Detailed information about the worker node is returned.

dedicatedHostId

string

The dedicatedHostId value.

dedicatedHostPoolId

string

The dedicatedHostPoolId value.

flavor

string

The flavor value.

health

GetWorkerResponseHealth

Get worker response health

id

string

The id value.

kubeVersion

GetWorkerResponseKubeVersion

Get worker response kube version

lifecycle

GetWorkerResponseLifecycle

Get worker response lifecycle

location

string

The location value.

networkInformation

GetWorkerResponseNetworkInformation

Get worker response network information

poolID

string

The poolID value.

poolName

string

The poolName value.

provider

string

The provider value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks clusters`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of a worker pool for a classic cluster

GET /v2/classic/getWorkerPool

View detailed information for a worker pool in a classic cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

workerpool

Required *

string

The ID of the worker pool that you want details for. To list all worker pools for a cluster, use the `GET /v1/clusters/{idOrName}/workerpools` API or run `ibmcloud ks worker-pool ls --cluster <cluster_name_or_ID>`.

Response

200 - Ok. Detailed information about the worker pool is returned.

autoscaleEnabled

boolean

The autoscaleEnabled value.

dedicatedHostPoolId

string

The dedicatedHostPoolId value.

flavor

string

The flavor value.

flavorState

string

The flavorState value.

hostLabels

object

The hostLabels value.

id

string

The id value.

isBalanced

boolean

The isBalanced value.

isolation

string

The isolation value.

labels

object

The labels value.

lifecycle

GetWorkerPoolResponseLifecycle

Get worker pool response lifecycle

openshiftLicense

string

The openshiftLicense value.

operatingSystem

string

The operatingSystem value.

poolName

string

The poolName value.

provider

string

The provider value.

reservationID

string

The reservationID value.

reservationName

string

The reservationName value.

taints

object

The taints value.

workerCount

integer

The workerCount value.

zones

array

The zones value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of a worker pool for a classic cluster

GET /v2/classic/getWorkerPools

View detailed information for a worker pool in a classic cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Response

200 - Ok. Detailed information about the worker pools is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View all workers for a classic cluster

GET /v2/classic/getWorkers

View detailed information for all worker nodes in a classic cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks clusters`.

show_deleted

string

true|false Shows deleted workers

pool

string

The name or ID of the worker pool to filter results for. Run `ibmcloud ks worker-pool ls --cluster <cluster name>`.

Response

200 - Ok. Details for all workers in the classic cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks clusters`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get detailed information for one health issue (regional URL prefix)

GET /v2/cluster-health/getIssue

Same behavior as `GET /v2/cluster-health/getIssue`.

Request

Path Parameters

Query Parameters

cluster

Required *

string

Cluster ID or name.

issue

Required *

string

Issue code.

Response

200 - Success. Detailed health issue payload.

component

string

The component value.

description

string

The description value.

detected

string

The detected value.

id

string

The id value.

more_details

array

The more details value.

severity

string

The severity value.

solution

string

The solution value.

400 - Bad request.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

410 - Gone.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List aggregated health issues for a cluster (regional URL prefix)

GET /v2/cluster-health/getIssues

Same behavior as `GET /v2/cluster-health/getIssues`. Use this path when calling a regional Kubernetes Service endpoint directly.

Request

Path Parameters

Query Parameters

cluster

Required *

string

Cluster ID or name.

Response

200 - Success. An array of health issue summaries.

400 - Bad request.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

410 - Gone.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a dedicated host

POST /v2/createDedicatedHost

Create a dedicated host.

Request

Request Body

CreateDedicatedHost

The required dedicated host parameters.

flavor

string

The flavor value.

hostPoolID

string

The hostPoolID value.

zone

string

The zone value.

Response

201 - Created. The dedicated host was successfully created.

id

string

The id value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. A dedicated host create may already be in progress. Please wait a few minutes and try again.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a dedicated host pool

POST /v2/createDedicatedHostPool

Create a dedicated host pool.

Request

Request Body

CreateDedicatedHostPool

The required dedicated host pool parameters.

flavorClass

string

The flavorClass value.

metro

string

The metro value.

name

string

The name value.

Path Parameters

Query Parameters

Response

201 - Created. The dedicated host pool was successfully created.

id

string

The id value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. Creation of a dedicated host might already be in progress. Please wait a few minutes and try again.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Disable dedicated host placement

POST /v2/disableDedicatedHostPlacement

Disable placement of worker nodes on a dedicated host.

Request

Request Body

UpdateDedicatedHost

The dedicated host pool and host to disable placement on.

hostID

string

The hostID value.

hostPoolID

string

The hostPoolID value.

Response

200 - OK. The dedicated host placement was successfully disabled.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

V2Disableimagesecurity

POST /v2/disableImageSecurity

Disable image security enforcement for a cluster

Request

Request Body

ImageSecurity

Input parameters to specify the name or ID of the cluster that you want to disable image security enforcement in.

cluster

string

The cluster value.

Path Parameters

Query Parameters

Response

204 - Ok. The request to update your master node was successfully processed.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: Disable the Pod Security Policy admission controller

POST /v2/disablePodSecurityPolicy

Deprecated: This API was only available for Kubernetes clusters that ran version 1.24. Disable the Pod Security Policy admission controller for Kubernetes. Use this API when migrating from the deprecated Pod Security Policy to the Pod Security admission controller.

Request

Request Body

DisablePodSecurityPolicyRequest

The cluster to target.

cluster

string

The cluster value.

Response

204 - OK. The request to disable the Pod Security Policy admission controller was successfully received.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format. \

Bad Request. Your cluster must run Kubernetes version 1.24 to change the Pod Security Policy admission controller.
Bad Request. Cannot disable the Pod Security Policy admission controller when the Pod Security admission controller is disabled.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Disables a private service endpoint for a cluster

POST /v2/disablePrivateServiceEndpoint

Disables a private service endpoint for a cluster.

Request

Request Body

UpdateServiceEndpoint

Input parameters to specify the name or ID of the cluster and which service endpoint to update. Valid service endpoints are public or private.

cluster

string

The cluster value.

Path Parameters

Query Parameters

Response

204 - Ok. The request to update your master node was successfully processed.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The cluster cannot be updated. The master is more than two versions behind the targeted version, which is not supported. Instead, update to a supported version two or less ahead of the current version, or create a new cluster at the targeted version.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Disables a public service endpoint for a cluster

POST /v2/disablePublicServiceEndpoint

Disables a public service endpoint for a cluster.

Request

Request Body

UpdateServiceEndpoint

Input parameters to specify the name or ID of the cluster and which service endpoint to update. Valid service endpoints are public or private.

cluster

string

The cluster value.

Path Parameters

Query Parameters

Response

204 - Ok. The request to update your master node was successfully processed.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The cluster cannot be updated. The master is more than two versions behind the targeted version, which is not supported. Instead, update to a supported version two or less ahead of the current version, or create a new cluster at the targeted version.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enable dedicated host placement

POST /v2/enableDedicatedHostPlacement

Enable placement of worker nodes on a dedicated host.

Request

Request Body

UpdateDedicatedHost

The dedicated host pool and host to enable placement on.

hostID

string

The hostID value.

hostPoolID

string

The hostPoolID value.

Response

200 - OK. The dedicated host placement was successfully enabled.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

V2Enableimagesecurity

POST /v2/enableImageSecurity

Enable image security enforcement for a cluster

Request

Request Body

ImageSecurity

Input parameters to specify the name or ID of the cluster that you want to enable image security enforcement in.

cluster

string

The cluster value.

Path Parameters

Query Parameters

Response

204 - Ok. The request to update your master node was successfully processed.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enables KMS in a cluster

POST /v2/enableKMS

Enables a key management service (KMS) provider, such as IBM Key Protect, in a cluster. You cannot later disable KMS encryption, so make sure not to delete the KMS instance that you use to encrypt the cluster.

Request

Request Body

EnableKMSRequest

Input parameters to create the Key Protect config for your cluster.

account_id

string

The account id value.

cluster

string

The cluster value.

crk_id

string

The crk id value.

instance_id

string

The instance id value.

private_endpoint

boolean

The private endpoint value.

Path Parameters

Query Parameters

Response

200 - Ok. The requested KMS configuration has been enabled on the cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or worker could not be found. To list the clusters that you have access to, use the `GET /vpc/v2/clusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: Enable the Pod Security Policy admission controller

POST /v2/enablePodSecurityPolicy

Deprecated: This API was only available for Kubernetes clusters that ran version 1.24. Enable the Pod Security Policy admission controller. Use this API when migrating from the deprecated Pod Security Policy to the Pod Security admission controller.

Request

Request Body

EnablePodSecurityPolicyRequest

The cluster to target.

cluster

string

The cluster value.

Response

204 - OK. The request to enable the Pod Security Policy admission controller was successfully received.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format. \

Bad Request. Your cluster must run Kubernetes version 1.24 to change the Pod Security Policy admission controller.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enables the private service endpoint for a cluster

POST /v2/enablePrivateServiceEndpoint

Enables the private service endpoint for a cluster.

Request

Request Body

UpdateServiceEndpoint

Input parameters to specify the name or ID of the cluster and which service endpoint to update. Valid service endpoints are public or private.

cluster

string

The cluster value.

Path Parameters

Query Parameters

Response

204 - Ok. The request to update your master node was successfully processed.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The cluster cannot be updated. The master is more than two versions behind the targeted version, which is not supported. Instead, update to a supported version two or less ahead of the current version, or create a new cluster at the targeted version.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enables the public service endpoint for a cluster

POST /v2/enablePublicServiceEndpoint

Enables the public service endpoint for a cluster.

Request

Request Body

UpdateServiceEndpoint

Input parameters to specify the name or ID of the cluster and which service endpoint to update. Valid service endpoints are public or private.

cluster

string

The cluster value.

Path Parameters

Query Parameters

Response

204 - Ok. The request to update your master node was successfully processed.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The cluster cannot be updated. The master is more than two versions behind the targeted version, which is not supported. Instead, update to a supported version two or less ahead of the current version, or create a new cluster at the targeted version.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create an image pull secret to IBM Cloud Container Registry in the `default`

POST /v2/enablePullSecret

Create an image pull secret to IBM Cloud Container Registry in the `default` .

Request

Request Body

EnablePullSecret

Input parameters to specify the name or ID of the cluster and which to enable pull secrets for.

cluster

string

The cluster value.

Path Parameters

Query Parameters

Response

204 - Ok. The request to update your master node was successfully processed.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the cluster's CA cert

GET /v2/getCACert

Get the cluster's CA cert to configure services with it to connect to the given cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get CA cert from. To list the clusters that you have access to, use the `GET /v2/getClusters` API or run `ibmcloud ks cluster ls`.

Response

200 - Ok. Returns the cluster's CA cert.

400 - Bad request. The query parameters are either incomplete or in the wrong format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v2/getClusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the root keys for a Key Management Service instance

GET /v2/getCRKs

List all the customer root keys (CRKs) for a Key Management Service (KMS) instance, such as a Key Protect service instance, in your IBM Cloud account.

Request

Path Parameters

Query Parameters

kms_instance

Required *

string

The KMS instance ID to list root keys for. To list available Key Protect service instances, run `ibmcloud ks kms instance ls`.

Response

200 - Ok. A list of available root keys in the KMS instance is returned.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or worker could not be found. To list the clusters that you have access to, use the `GET /vpc/v2/clusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details for a cluster

GET /v2/getCluster

View detailed information for a cluster, including a VPC cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

Response

200 - Success. Detailed cluster information is returned.

addons

array

The addons value.

caCertRotationStatus

CommonClusterCACertRotation

CommonClusterCACertRotation CA cert rotation properties

calicoIPAutodetectionConfig

string

The calicoIPAutodetectionConfig value.

createdDate

string

The createdDate value.

crn

string

The crn value.

datacenter

string

The datacenter value.

desiredTrustedProfileID

string

The desiredTrustedProfileID value.

disableAutoUpdate

boolean

The disableAutoUpdate value.

entitlement

string

The entitlement value.

etcdPort

string

The etcdPort value.

features

CommonClusterFeatures

Common cluster features

id

string

The id value.

ignitionServerURL

string

The ignitionServerURL value.

imageSecurityEnabled

boolean

The imageSecurityEnabled value.

infrastructureTopology

string

The infrastructureTopology value.

ingress

CommonClusterIngress

Common cluster ingress

isPaid

boolean

The isPaid value.

keyManagementService

CommonClusterKMS

Common clusterkms

konnectivityServerURL

string

The konnectivityServerURL value.

lifecycle

CommonClusterLifecycle

Common cluster lifecycle

location

string

The location value.

locationEndpointURL

string

The locationEndpointURL value.

locationZones

array

The locationZones value.

masterKubeVersion

string

The masterKubeVersion value.

masterURL

string

The masterURL value.

multiAzCapable

boolean

The multiAzCapable value.

name

string

The name value.

networkPlugin

string

The networkPlugin value.

oauthServerURL

string

The oauthServerURL value.

offering

string

The offering value.

outboundTrafficProtection

string

The outboundTrafficProtection value.

podSubnet

string

The podSubnet value.

provider

string

The provider value.

region

string

The region value.

resourceGroup

string

The resourceGroup value.

resourceGroupName

string

The resourceGroupName value.

satellitePrivateEndpointURL

string

The satellitePrivateEndpointURL value.

secureByDefault

string

The secureByDefault value.

secureRequested

boolean

The secureRequested value.

serviceEndpoints

CommonClusterServiceEndpoint

Common cluster service endpoint

serviceSubnet

string

The serviceSubnet value.

state

string

The lifecycle state of the cluster. Possible values include aborted, critical, delete_failed, deleted, deleting, deploy_failed, deploying, normal, pending, requested, updating, unsupported, and warning. For more information, see the docs 'http://ibm.biz/cluster-health-states'

status

string

The status value.

supportedOperatingSystems

array

The supportedOperatingSystems value.

targetVersion

string

The targetVersion value.

trustedProfileID

string

The trustedProfileID value.

type

string

The type value.

versionEOS

string

The versionEOS value.

virtualPrivateEndpointURL

string

The virtualPrivateEndpointURL value.

vpcs

array

The vpcs value.

workerCount

integer

The workerCount value.

workerZones

array

The workerZones value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of the add-ons that are enabled in a cluster

GET /v2/getClusterAddons

View details of the add-ons that are enabled in a cluster, including the add-on versions.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Response

200 - OK. Details for the add-ons in this cluster are returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of a dedicated host

GET /v2/getDedicatedHost

View detailed information for a dedicated host.

Request

Path Parameters

Query Parameters

dedicatedhost

Required *

string

The ID of the dedicated host that you want details for..

dedicatedhostpool

Required *

string

The ID of the dedicated host pool that you want to get the dedicated host details from.

Response

200 - Ok. Detailed information about the dedicated host is returned.

flavor

string

The flavor value.

id

string

The id value.

lifecycle

DedicatedHostLifecycle

Dedicated host lifecycle

placementEnabled

boolean

The placementEnabled value.

resources

DedicatedHostResources

Dedicated host resources

workers

array

The workers value.

zone

string

The zone value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified dedicated host could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of a dedicated host pool

GET /v2/getDedicatedHostPool

View detailed information for a dedicated host pool.

Request

Path Parameters

Query Parameters

dedicatedhostpool

Required *

string

The ID of the dedicated host pool that you want to get.

Response

200 - Ok. Detailed information about the dedicated host pool is returned.

flavorClass

string

The flavorClass value.

hostCount

integer

The hostCount value.

id

string

The id value.

metro

string

The metro value.

name

string

The name value.

state

string

The state value.

workerPools

array

The workerPools value.

zones

array

The zones value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified dedicated host could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. The IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the dedicated host pools

GET /v2/getDedicatedHostPools

List the dedicated host pools.

Request

Path Parameters

Query Parameters

Response

200 - Ok. Detailed information about the dedicated host pools is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified dedicated host pool could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. The IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the dedicated hosts

GET /v2/getDedicatedHosts

List the dedicated hosts.

Request

Path Parameters

Query Parameters

dedicatedhostpool

Required *

string

The ID of the dedicated host pool that you want to get the dedicated hosts details from.

Response

200 - Ok. Detailed information about the dedicated hosts is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified dedicated host pool could not be found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the details for a worker node flavor

GET /v2/getFlavor

Get the details for a worker node flavor, including the flavor's virtual CPU amount, memory, disk space and supported operating systems. Flavors are specific to a IBM Cloud Kubernetes Service zone and infrastructure provider.

Request

Path Parameters

Query Parameters

flavor

Required *

string

The ID of the flavor. To list available flavors, run `ibmcloud ks flavors --zone ZONE` or use the `GET /v2/getFlavors` API.

zone

Required *

string

The ID of the zone. To list available zones, run `ibmcloud ks zone ls` or use the `GET /v2/zones` API.

provider

Required *

string

The name of the provider. To check available providers, see the output of the `ibmcloud ks flavors --zone ZONE` command or use the `GET /v2/getFlavors` API.

Response

200 - Success

architecture

string

The type of CPU architecture that the flavor uses.

correspondingFlavor

string

The correspondingFlavor value.

deprecated

boolean

The deprecated value.

id

string

The ID of the worker node flavor.

isTrusted

boolean

The isTrusted value.

name

string

The name of the worker node flavor.

provider

string

The name of the provider.

secondaryStorage

string

The secondaryStorage value.

secondaryStorageEncrypted

boolean

The secondaryStorageEncrypted value.

storage

string

The storage value.

400 - The specified zone is invalid. To list available zones, run `ibmcloud ks zone ls` or use the `GET /v2/zones` API.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List available flavors types for a VPC zone (data center)

GET /v2/getFlavors

List available flavors that you can use for a worker node. Flavors are specific to a location and a provider in an IBM Cloud Kubernetes Service zone. Each flavor includes the amount of virtual CPU, memory, and disk space that is set up for the worker node.

Request

Path Parameters

Query Parameters

zone

Required *

string

The ID of the location for which you want to list available flavors. To list available locations, run `ibmcloud ks zone ls` or use the `GET /v2/zones` API.

provider

string

Filters the flavors to match the provider type specified.

Response

200 - Success

400 - The specified location is invalid. To list available locations, run `ibmcloud ks zone ls` or use the `GET /v2/zones` API.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Gets KMS instances tied to an account

GET /v2/getKMSInstances

Retrieves available key management service (KMS) instances, such as Key Protect, in your IBM Cloud Account

Request

Path Parameters

Query Parameters

Response

200 - Ok. A list of all KMSs in your IBM Cloud Account

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or worker could not be found. To list the clusters that you have access to, use the `GET /vpc/v2/clusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the cluster's kubeconfig file

GET /v2/getKubeconfig

Apply IAM roles to the cluster asynchronously and retrieve the cluster's kubeconfig file to connect to your cluster and run Kubernetes API calls. Use `/v2/getRBACStatus` to verify when RBAC finishes applying.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v2/getClusters` API or run `ibmcloud ks cluster ls`.

endpoint_type

string

Default endpoint is the public endpoint if available, private otherwise. Use 'private' to require a private endpoint and 'link' for a Satellite Link endpoint.

format

string

Default format is json. Other options include yaml, and zip.

admin

boolean

Retrieve the admin kubeconfig file.

network

boolean

Retrieve the Calico network config. Requires admin=true and format=zip.

Response

200 - Ok. Returns the cluster's kubeconfig file.

apiVersion

string

Legacy field from pkg/api/types.go TypeMeta.

clusters

array

Clusters is a map of referencable names to cluster configs

contexts

array

Contexts is a map of referencable names to context configs

current-context

string

CurrentContext is the name of the context that you would like to use by default

kind

string

Legacy field from pkg/api/types.go TypeMeta.

preferences

object

Preferences holds general information to be use for cli interactions

users

array

AuthInfos is a map of referencable names to user configs

400 - Bad request. The query parameters are either incomplete or in the wrong format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v2/getClusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View the current messages

GET /v2/getMessages

View the current messages. Messages are notifications for new features or changes that may require attention.

Request

Response

200 - Success

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List supported operating systems

GET /v2/getOperatingSystems

Lists supported operating systems for the given configuration.

Request

Path Parameters

Query Parameters

provider

Required *

string

The name of the infrastructure provider in which to view supported operating systems. Available options include 'classic', 'vpc-gen2', and 'satellite'.

version

Required *

string

The Kubernetes or Openshift version.

core_os_enabled

boolean

Whether HyperShift is enabled.

Response

200 - Ok. The request to list supported operating systems was successfully processed.

400 - Bad Request. Required parameters were not set. You must provide the `version` and `provider` query parameters.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View the Pod Security admission control configuration for a cluster

GET /v2/getPodSecurity

View the Pod Security admission control configuration for a cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the Pod Security admission control configuration for. To list the clusters that you have access to, use the `GET /v2/clusters` API or run `ibmcloud ks cluster ls`.

Response

200 - Ok. The request to view the Pod Security admission control configuration was successfully processed.

configuration

string

Configuration is a base64 encoded PodSecurityConfiguration yaml definition

enabled

boolean

The enabled value.

400 - Bad Request. Required parameters were not set. You must provide the `cluster` query parameter. \

Bad Request. Pod Security admission is supported only for Kubernetes v1.24 or later clusters.
Bad Request. Pod Security admission is not supported for Red Hat OpenShift clusters.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: View the Pod Security Policy admission control configuration

GET /v2/getPodSecurityPolicy

Deprecated: This API was only available for Kubernetes clusters that ran version 1.24. View the Pod Security Policy admission control configuration. Use this API when migrating from the deprecated Pod Security Policy to the Pod Security admission controller.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the Pod Security admission control configuration for. To list the clusters that you have access to, use the `GET /v2/clusters` API or run `ibmcloud ks cluster ls`.

Response

200 - Ok. The request to view Pod Security Policy admission control configuration was successfully processed.

enabled

boolean

The enabled value.

400 - Bad Request. Required parameters were not set. You must provide the `cluster` query parameter. \

Bad Request. Pod Security admission configuration is not supported for OpenShift clusters.
Bad Request. Your cluster must run Kubernetes version 1.24 to remove the Pod Security admission controller or to change the Pod Security Policy admission controller.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View the quota for resources per region in the account

GET /v2/getQuota

View the quota for IBM Cloud Kubernetes Service resources such as clusters and worker nodes. The quota is per region and applies across resource groups in the account. To increase your quota, contact IBM Support and include the new quota limit that you want for the region, resource, and infrastructure provider such as classic or VPC.

Request

Response

200 - OK. A list of quota limits for resources per region in the account is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the RBACSync status

GET /v2/getRBACStatus

Get the RBACSync status for the authenticated user. The RBACSync status indicates whether the user has the correct identities and RoleBindings in the cluster. The `synchronized: true` status means the cluster is ready to receive requests from the user. After calling the `/v2/applyRBAC` endpoint for the first time on a cluster, poll this endpoint to verify the synchronization is complete.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the RBACSync status from. To list the clusters that you have access to, use the `GET /v2/getClusters` API or run `ibmcloud ks cluster ls`.

Response

200 - Success

synchronized

boolean

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v2/getClusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List available cluster versions

GET /v2/getVersions

List available versions that you can use to create a cluster in a region. The container management platform version that you select is installed on your cluster master and worker nodes. Later, you can update the version but cannot roll back to a previous version or switch to a different container management platform. If you want to use multiple versions, create a separate cluster for each version.

Request

Response

200 - Success. Available container management platform versions for the IBM Cloud Kubernetes Service region are returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of a worker node for cluster

GET /v2/getWorker

View detailed information for a worker node in a cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

worker

Required *

string

The ID of the worker node that you want details for. To list all worker nodes for a cluster, use the `GET /v2/getWorkers?cluster=idOrName` API or run `ibmcloud ks worker ls --cluster <cluster_name_or_ID>`.

Response

200 - Ok. Detailed information about the worker node is returned.

dedicatedHostId

string

The dedicatedHostId value.

dedicatedHostPoolId

string

The dedicatedHostPoolId value.

flavor

string

The flavor value.

health

GetWorkerResponseHealth

Get worker response health

id

string

The id value.

kubeVersion

GetWorkerResponseKubeVersion

Get worker response kube version

lifecycle

GetWorkerResponseLifecycle

Get worker response lifecycle

location

string

The location value.

networkInformation

GetWorkerResponseNetworkInformation

Get worker response network information

networkInterfaces

GetWorkerResponseNetworkInterfaces

Get worker response network interfaces

poolID

string

The poolID value.

poolName

string

The poolName value.

provider

string

The provider value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of a worker pool for a cluster

GET /v2/getWorkerPool

View detailed information for a worker pool in a cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

workerpool

Required *

string

The ID of the worker pool that you want details for. To list all worker pools for a cluster, use the `GET /v2/getWorkerPools?cluster=idOrName` API or run `ibmcloud ks worker-pool ls --cluster <cluster_name_or_ID>`.

Response

200 - Ok. Detailed information about the worker pool is returned.

autoscaleEnabled

boolean

The autoscaleEnabled value.

dedicatedHostPoolId

string

The dedicatedHostPoolId value.

flavor

string

The flavor value.

flavorState

string

The flavorState value.

hostLabels

object

The hostLabels value.

id

string

The id value.

isBalanced

boolean

The isBalanced value.

isolation

string

The isolation value.

labels

object

The labels value.

lifecycle

GetWorkerPoolResponseLifecycle

Get worker pool response lifecycle

openshiftLicense

string

The openshiftLicense value.

operatingSystem

string

The operatingSystem value.

poolName

string

The poolName value.

provider

string

The provider value.

reservationID

string

The reservationID value.

reservationName

string

The reservationName value.

secondaryStorageOption

DiskConfigResp

DiskConfigResp response type for describing a disk configuration

staticNetworkInterfaceCount

integer

The staticNetworkInterfaceCount value.

taints

object

The taints value.

vpcID

string

The vpcID value.

workerCount

integer

The workerCount value.

workerVolumeEncryption

WorkerVolumeEncryption

WorkerVolumeEncryption contains encryption related fields

zones

array

The zones value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the worker pools in a cluster

GET /v2/getWorkerPools

List the worker pools in a cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

Response

200 - Ok. Detailed information about the worker pools is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View all workers for cluster

GET /v2/getWorkers

View detailed information for all worker nodes in a cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

show_deleted

string

true|false Shows deleted workers

Response

200 - Ok. Details for all workers in the cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Validates user provided entitlement

GET /v2/hasValidEntitlement

Validates whether the provided entitlement value is supported or not.

Request

Path Parameters

Query Parameters

entitlement

Required *

string

The entitlement value to check if it is supported.

Response

200 - Ok. The entitlement validation request was successfully processed.

hasValidEntitlement

boolean

The hasValidEntitlement value.

400 - The entitlement option can not be set when the stored API key has a subtype. For more information, see 'http://ibm.biz/api-key'.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Could not connect to the back-end billing validation service. Try again later.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update the health monitoring configuration for the specified NLB subdomain in

PUT /v2/nlb-dns/configureHealthMonitor

Update the health monitoring configuration for the specified NLB subdomain in a cluster. Include the cluster ID, NLB subdomain, and any the provider specific configurations for the health check in the request body.

Request

Request Body

HealthMonitorConfiguration

The full health monitoring configuration to overwrite the current configuration with. The configuration is defined in the corresponding provider specific field.

akamaiMonitorConfiguration

AkamaiHealthcheckProperties

AkamaiHealthcheckProperties used for storing config provided by user for akamai healthcheck deprecated

httpError3xx

boolean

The httpError3xx value.

httpError4xx

boolean

The httpError4xx value.

httpError5xx

boolean

The httpError5xx value.

httpHeaders

Required *

array

The httpHeaders value.

httpMethod

string

The httpMethod value.

name

string

The name value.

peerCertificateVerification

boolean

The peerCertificateVerification value.

testInterval

integer

The testInterval value.

testObject

string

The testObject value.

testObjectPort

integer

The testObjectPort value.

testObjectProtocol

string

The testObjectProtocol value.

testTimeout

number

The testTimeout value.

cluster

string

The cluster value.

nlbSubdomain

string

The nlbSubdomain value.

Response

204 - Ok. The request to update the health monitor config was successfully processed.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or NLB subdomain could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list existing NLB subdomains for a cluster, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove a secret from an NLB subdomain

POST /v2/nlb-dns/deleteSecret

Delete a secret from an NLB subdomain in your cluster and prevent future renewal of the certificate. You might remove the secret from an NLB subdomain if you no longer use the subdomain or disassociate it from your NLB IP addresses.

Request

Request Body

SecretConfig

Include the NLB subdomain that you want to delete the secret for, and the cluster that the subdomain is in.

cluster

string

The cluster value.

subdomain

string

The subdomain value.

Response

204 - Deleted. The secret name was successfully deleted for the NLB subdomain.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster, subdomain, or secret could not be found. To list clusters you have access to, run `ibmcloud ks cluster ls`. To list existing NLB subdomains and associated secret names, run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_id>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the health monitoring configuration for the specified NLB subdomain in a

GET /v2/nlb-dns/getHealthMonitorConfig

Get the health monitoring configuration for the specified NLB subdomain in a cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

nlb_subdomain

Required *

string

The existing NLB subdomain that you want the monitor config for. To list existing NLB subdomains, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

Response

200 - OK. Current monitor config returned.

akamaiMonitorConfiguration

AkamaiHealthcheckProperties

AkamaiHealthcheckProperties used for storing config provided by user for akamai healthcheck deprecated

cluster

string

The cluster value.

nlbSubdomain

string

The nlbSubdomain value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list existing NLB subdomains for a cluster, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List registered NLB subdomains in a cluster

GET /v2/nlb-dns/getNlbDNSList

List NLB subdomains and the NLB IP addresses or the load balancer hostnames that are registered with the DNS provider for each NLB subdomain.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Response

200 - Ok. A list of NLB subdomains and associated details is returned for this cluster.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list existing NLB subdomains for a cluster, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the details for the specified NLB subdomain in a cluster

GET /v2/nlb-dns/getNlbDetails

Get the details for the NLB subdomain and the NLB IP addresses or the load balancer hostnames that are registered with the DNS provider for each NLB subdomain.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

nlb_subdomain

Required *

string

The existing NLB subdomain that you want details for. To list existing NLB subdomains, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

Response

200 - OK. Details of the NLB subdomain are returned.

Nlb

ExtendedNlbVPCConfig

ExtendedNlbVPCConfig is the response body for the get v2 vpc apis

secretName

string

The secretName value.

secretStatus

string

The secretStatus value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list existing NLB subdomains for a cluster, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the details for the specified subdomain in a Satellite location

GET /v2/nlb-dns/getSatLocationSubdomain

Get the details for the subdomain and the IP addresses that are registered with the DNS provider for each subdomain.

Request

Path Parameters

Query Parameters

controller

Required *

string

To list available locations, use the `GET /v2/satellite/getControllers` API, or run `ibmcloud sat location ls`.

subdomain

Required *

string

The existing subdomain that you want details for. To list existing subdomains, use the `GET /v2/nlb-dns/getSatLocationSubdomains` API or run `ibmcloud sat location dns ls --cluster <cluster_name_or_ID>`.

Response

200 - OK. A list of subdomains and associated details is returned for this location. If no list is returned, you can assign hosts to your location and try again.

certProvider

string

The certProvider value.

clusterID

string

The clusterID value.

crn

string

The crn value.

isDefault

boolean

The isDefault value.

nlbDnsType

string

The nlbDnsType value.

nlbHost

string

The nlbHost value.

nlbIPArray

array

The nlbIPArray value.

nlbMonitorState

string

The nlbMonitorState value.

nlbSslSecretName

string

The nlbSslSecretName value.

nlbSslSecretStatus

string

The nlbSslSecretStatus value.

nlbStatusMessage

string

The nlbStatusMessage value.

nlbType

string

The nlbType value.

provider

string

The provider value.

secretNamespace

string

The secretNamespace value.

zoneID

string

The zoneID value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your IAM and UAA tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Could not find the IBM Cloud Satellite location. To list available locations, use the `GET /v2/satellite/getControllers` API, or run `ibmcloud sat location ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List registered NLB subdomains in a Satellite location

GET /v2/nlb-dns/getSatLocationSubdomains

Get the details for the NLB subdomains along with the NLB IP addresses or CNAME records that are registered with the DNS provider for each NLB subdomain. Your Satellite location has a set of hosts that run control plane operations to manage your Satellite components across all the clusters in the location. If your location becomes unavailable, you might use the NLB subdomain and IP address details of the hosts to help troubleshoot.

Request

Path Parameters

Query Parameters

controller

Required *

string

To list available locations, use the `GET /v2/satellite/getControllers` API, or run `ibmcloud sat location ls`.

Response

200 - OK. A list of NLB subdomains and associated details is returned for this location. If no list is returned, you can assign hosts to your location and try again.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Could not find the IBM Cloud Satellite location. To list available locations, use the `GET /v2/satellite/getControllers` API, or run `ibmcloud sat location ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Regenerates cert for secret

POST /v2/nlb-dns/regenerateCert

Regenerate the certificate and recreate the secret for an NLB subdomain. You might regenerate an NLB subdomain's certificate and secret if you previously deleted the secret.

Request

Request Body

SecretConfig

Include the cluster and subdomain for the NLB subdomain that you want to remove the secret from.

cluster

string

The cluster value.

subdomain

string

The subdomain value.

Response

202 - The cert has been successfully triggered for regeneration.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster, subdomain, or secret could not be found. To list clusters you have access to, run `ibmcloud ks cluster ls`. To list existing NLB subdomains and relevant secret names, run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_id>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Registers domains: c001, c002, c003, each tied to a corresponding IP and c000

POST /v2/nlb-dns/registerMSCDomains

Registers Multishift domains for a cluster.

Request

Request Body

MSCRegistration

The input parameter to register a Multishift cluster's domains.

controller

string

The controller value.

ips

Required *

array

The ips value.

Response

200 - Registered. The multishift cluster domains and cname have been successfully registered.

controller

string

The controller value.

dnsRegistrations

array

The dnsRegistrations value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or NLB subdomain could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`. To list existing NLB subdomains for a cluster, use the `GET /clusters/{idOrName}/list` API or run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a new NLB subdomain in a VPC cluster and associate a load balancer hos

POST /v2/nlb-dns/vpc/createNlbDNS

In a VPC cluster, create a new NLB subdomain and register a VPC load balancer hostname with the DNS provider. Note that you can create the NLB subdomain with only one VPC load balancer hostname. If the registration fails, an error from the DNS provider is returned.

Request

Request Body

NlbVPCConfig

Include the `lbHostname` parameter that specifies the VPC load balancer hostname that you want to register.

cluster

string

The cluster value.

dnsType

string

The dnsType value.

lbHostname

string

The lbHostname value.

nlbSubdomain

string

The nlbSubdomain value.

secretNamespace

string

The secretNamespace value.

type

string

The type value.

Response

201 - Created. The NLB subdomain was successfully created and the VPC load balancer hostname is registered with DNS.

cluster

string

The cluster value.

dnsType

string

The dnsType value.

lbHostname

string

The lbHostname value.

nlbSubdomain

string

The nlbSubdomain value.

secretNamespace

string

The secretNamespace value.

type

string

The type value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified VPC cluster or load balancer hostname could not be found. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`. To list existing load balancer hostnames in a cluster, run `kubectl get svc -n <namespace>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove the load balancer hostname from the DNS record for an existing NLB sub

POST /v2/nlb-dns/vpc/removeLBHostname

In a VPC cluster, remove a load balancer hostname from the DNS record for an existing NLB subdomain. After you remove the load balancer hostname, the NLB subdomain still exists, but no load balancer is associated with it.

Request

Request Body

NlbVPCConfig

Include the cluster parameter (required) and the nlbSubdomain parameter (required) for the NLB subdomain that you want to remove the load balancer hostname from.

cluster

string

The cluster value.

dnsType

string

The dnsType value.

lbHostname

string

The lbHostname value.

nlbSubdomain

string

The nlbSubdomain value.

secretNamespace

string

The secretNamespace value.

type

string

The type value.

Response

204 - Removed. The load balancer hostname was successfully unregistered from the DNS record for the NLB subdomain.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM or UAA token is invalid or expired. To retrieve your UAA and IAM tokens, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified VPC cluster or NLB subdomain could not be found. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`. To list existing NLB subdomains, run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_id>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update the DNS record for an NLB subdomain by replacing the load balancer hos

POST /v2/nlb-dns/vpc/replaceLBHostname

In a VPC cluster, update the DNS record for an NLB subdomain by replacing the load balancer hostname that is currently associated with the NLB subdomain with another load balancer hostname. Only one load balancer hostname can be associated with an NLB DNS record at a time.

Request

Request Body

NlbVPCConfig

Include only the `cluster` ID, existing `lbHostname` that you want to replace, and `nlbSubdomain` of the DNS record that you want to update.

cluster

string

The cluster value.

dnsType

string

The dnsType value.

lbHostname

string

The lbHostname value.

nlbSubdomain

string

The nlbSubdomain value.

secretNamespace

string

The secretNamespace value.

type

string

The type value.

Response

200 - Ok. The request to update the load balancer hostname was successfully processed.

cluster

string

The cluster value.

dnsType

string

The dnsType value.

lbHostname

string

The lbHostname value.

nlbSubdomain

string

The nlbSubdomain value.

secretNamespace

string

The secretNamespace value.

type

string

The type value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified VPC cluster, load balancer hostname, or NLB subdomain could not be found. To list the VPC clusters that you have access to, use the `GET /v2/vpc/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`. To list existing load balancer hostnames in a cluster, run `kubectl get svc -n <namespace>`. To list existing NLB subdomains, run `ibmcloud ks nlb-dns ls --cluster <cluster_name_or_id>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Rebalance workers in a worker pool

POST /v2/rebalanceWorkerPool

When you rebalance the worker pool, you return the number of worker nodes in the worker pool to a balanced state. For example, if you remove some worker nodes such as to troubleshoot an issue, you might have an uneven number of nodes across zones. You might delete 2 worker nodes in zone dal13 but still have 3 worker nodes each in zones dal10 and dal12 for a total of 7 worker nodes. To fix this unbalanced state, rebalance the worker pool. After rebalancing, the worker pool has 9 worker nodes again. Rebalancing does not change the size per zone of the worker pool, even if you specify a different size per zone.

Request

Request Body

RebalanceWorkerPool

Fields required to rebalance the worker pool.

cluster

string

The cluster value.

workerpool

string

The workerpool value.

Path Parameters

Query Parameters

Response

204 - OK. The request to balance the worker pool was successfully received.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Refresh the Kubernetes master

POST /v2/refreshMaster

Restart the Kubernetes master in the cluster to apply changes to the API server configuration.

Request

Request Body

RefreshMaster

Input parameters to refresh master. The cluster ID or name is required.

cluster

string

The cluster value.

Path Parameters

Query Parameters

Response

204 - Ok. The Master will be put into the desired state.

400 - Bad Request. Check that all headers are present and the cluster ID or name is provided.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster. To list the clusters that you have access to, use the `GET /vpc/v2/clusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Removes a dedicated host

POST /v2/removeDedicatedHost

Removes a dedicated host.

Request

Request Body

DeleteDedicatedHost

The dedicated host to target in a given dedicated host pool.

host

string

The host value.

hostPool

string

The hostPool value.

Response

202 - OK. The request to remove your dedicated host was successfully received.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. The IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Removes a dedicated host pool

POST /v2/removeDedicatedHostPool

Removes a dedicated host pool.

Request

Request Body

RemoveDedicatedHostPool

The dedicated host pool to target.

hostPool

string

The hostPool value.

Response

202 - OK. The request to remove your dedicated host pool was successfully received.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. The IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated: Remove the Pod Security admission controller configuration for Ku

POST /v2/removePodSecurity

Deprecated: This API was only available for Kubernetes clusters that ran version 1.24. Remove the Pod Security admission controller configuration. Use this API when migrating from the deprecated Pod Security Policy to the Pod Security admission controller.

Request

Request Body

RemovePodSecurityRequest

The cluster to target.

cluster

string

The cluster value.

Response

204 - OK. The request to remove the Pod Security admission controller configuration was successfully received.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format. \

Bad Request. Your cluster must run Kubernetes version 1.24 to remove the Pod Security admission controller or to change the Pod Security Policy admission controller.
Bad Request. Cannot disable the Pod Security admission controller when the Pod Security Policy admission controller is disabled.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Delete a worker node from a cluster

POST /v2/removeWorker

Delete a worker node from a cluster. This action cannot be undone. When you delete the worker node, the worker node is cordoned and drained so that its pods are rescheduled onto remaining worker nodes in the cluster. Make sure that you have enough capacity in the cluster to support the workload. After you remove the worker node, you can rebalance the worker pool.

Request

Request Body

RemoveWorker

Input parameters to remove a worker node. The cluster and worker node ID parameters are required.

cluster

string

The cluster value.

workerID

string

The workerID value.

Path Parameters

Query Parameters

Response

204 - Ok. The worker node was successfully removed from your cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - The specified cluster or worker node could not be found. To list the clusters that you have access to, use the `GET /v2/clusters` API or run `ibmcloud ks cluster ls`. To list worker nodes in the cluster, use the `GET /v2/getWorkers` API or run `ibmcloud ks worker ls -c <cluster_name>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Removes a worker pool

POST /v2/removeWorkerPool

Remove a worker pool from a cluster. All worker nodes in the pool are deleted. Your pods are rescheduled when you delete. To avoid downtime, be sure that you have enough workers to run your workload.

Request

Request Body

RemoveWorkerPool

The cluster and worker pool to target.

allowSingleOpenShiftWorker

boolean

The allowSingleOpenShiftWorker value.

cluster

string

The cluster value.

workerpool

string

The workerpool value.

Path Parameters

Query Parameters

Response

204 - OK. The request to remove your worker pool was successfully received.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove a zone from a worker pool

POST /v2/removeWorkerPoolZone

Remove a zone from a worker pool in your cluster. All worker nodes that are deployed to that zone in the worker pool are deleted. The app pods from the deleted worker nodes are rescheduled to other worker nodes when the zone is removed. To avoid downtime, be sure that you have enough worker nodes to handle your workload.

Request

Request Body

RemoveWorkerPoolZoneReq

The input parameter to specify the cluster, worker pool, and zone.

cluster

string

The cluster value.

workerpool

string

The workerpool value.

zone

string

The zone value.

Path Parameters

Query Parameters

Response

204 - OK. The request to remove the zone from your worker pool was successfully received..

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Replace a worker node with a new worker node

POST /v2/replaceWorker

Delete the specified worker node from the cluster and create a new worker node in the same worker pool to replace the deleted worker node. The new worker node is assigned new public or private IP addresses. When the worker node is deleted, it is cordoned and drained to reschedule the pods that run on the worker node before deleting it, to avoid downtime for your apps. You might replace a worker node if you cannot reload or update the worker node, such as if it enters a troubled state.

Request

Request Body

ReplaceWorkerRequest

Input parameters to replace a worker.

cluster

string

The cluster value.

update

boolean

The update value.

workerID

string

The workerID value.

Path Parameters

Query Parameters

Response

204 - OK. The worker node is being removed and replaced with a new worker node.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or worker could not be found. To list the VPC clusters that you have access to, use the `GET /vpc/v2/getClusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Resize an existing worker pool

POST /v2/resizeWorkerPool

Resize a worker pool for the specified cluster, such as to add or remove worker pools from each zone that the worker pool spans. Resizing the worker pool resets the desired count of worker node per zone.

Request

Request Body

ResizeWorkerPool

The resize request.

allowSingleOpenShiftWorker

boolean

The allowSingleOpenShiftWorker value.

cluster

string

The cluster value.

size

integer

The size value.

workerpool

string

The workerpool value.

Path Parameters

Query Parameters

Response

202 - Accepted. The worker pool will be resized to the specified value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Do not use it as this endpoint is not supported in the long term

GET /v2/rotateClusterCOSKey

Do not use it as this endpoint is not supported in the long term. Rotates the ROKS cluster's HMAC data.

Rotates the HMAC service key, key ID and key GUID associated to the cluster. If the bucket of the cluster doesn't exist it gets created firstly.`

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster of which you want to rotate the COS data. To list the clusters that you have access to, use the `GET /v2/getClusters` API or run `ibmcloud ks cluster ls`.

Response

204 - No Content. Indicates that the rotation was successful.

400 - Bad request. The query parameters are either incomplete or in the wrong format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v2/getClusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create an IBM Cloud Satellite cluster

POST /v2/satellite/createCluster

Create an OpenShift Container Platform cluster in an IBM Cloud Satellite location. Creating a cluster requires Administrator access to Kubernetes Service in the IBM Cloud account. After you create a Satellite cluster, assign hosts to the cluster to add compute capacity for your workloads.

Request

Request Body

MultishiftCreateCluster

The configuration details for your Satellite cluster, in JSON format. The "controller" field (required) is the name or ID of the location to deploy the cluster to. The "name" field (required) is the name to give the cluster. The "kubeVersion" field is optional, and defaults to the latest Red Hat OpenShift on IBM Cloud version when not specified.

adminAgentOptIn

boolean

Optional: User provided value to indicate opt-in agreement to SatCon admin agent

calicoIPAutodetection

object

Optional: Used to determine the correct IP for internal routing

controller

string

The name or ID of the Satellite location

defaultWorkerPoolEntitlement

string

Optional: The entitlement to use in the default worker pool

infrastructureTopology

string

Optional: Enables single worker node clusters

kubeVersion

string

Optional: The OpenShift Container Platform version

labels

object

Key-value pairs to label the host, such as cpu=4 to describe the host capabilities

name

string

The unique name for the new IBM Cloud Satellite cluster

networkPlugin

string

Optional: NetworkPlugin indicates what container network interface has to be used in the cluster. If the field is missing it is defaulted to Calico.

operatingSystem

string

Optional: The operating system to use in the default worker pool

podSubnet

string

Optional: User provided value for the pod subnet

pullSecret

string

Optional: The RedHat pull secret to create the OpenShift cluster

requestSecure

boolean

Optional: Flag to request a secure cluster is created

serviceSubnet

string

Optional: User provided value for service subnet

trustedProfileID

string

Optional: The trusted profile ID to set in the cluster

workerCount

integer

Optional: The number of worker nodes to create per zone in the default worker pool

zone

string

Optional: The name of the zone to create the default worker pool in

Path Parameters

Query Parameters

Response

201 - Created. The cluster was successfully created in the IBM Cloud Satellite location.

id

string

The id value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions for the specified infrastructure provider.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. A cluster with the same name already exists. Choose another name for your cluster.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create an IBM Cloud Satellite cluster in a location that does not belong to y

POST /v2/satellite/createClusterRemoteLocation

Create an OpenShift Container Platform cluster in an IBM Cloud Satellite location that belongs to another account. Creating a cluster requires service-to-service IAM authorization in the target IBM Cloud account. After you create a Satellite cluster, the account owner is responsible for providing hosts to run the worker nodes.

Request

Request Body

MultishiftCreateCluster

The configuration details for your Satellite cluster, in JSON format. The "controller" field (required) is the name or ID of the location to deploy the cluster to. The "name" field (required) is the name to give the cluster. The "kubeVersion" field is optional, and defaults to the latest Red Hat OpenShift on IBM Cloud version when not specified.

adminAgentOptIn

boolean

Optional: User provided value to indicate opt-in agreement to SatCon admin agent

calicoIPAutodetection

object

Optional: Used to determine the correct IP for internal routing

controller

string

The name or ID of the Satellite location

defaultWorkerPoolEntitlement

string

Optional: The entitlement to use in the default worker pool

infrastructureTopology

string

Optional: Enables single worker node clusters

kubeVersion

string

Optional: The OpenShift Container Platform version

labels

object

Key-value pairs to label the host, such as cpu=4 to describe the host capabilities

name

string

The unique name for the new IBM Cloud Satellite cluster

networkPlugin

string

Optional: NetworkPlugin indicates what container network interface has to be used in the cluster. If the field is missing it is defaulted to Calico.

operatingSystem

string

Optional: The operating system to use in the default worker pool

podSubnet

string

Optional: User provided value for the pod subnet

pullSecret

string

Optional: The RedHat pull secret to create the OpenShift cluster

requestSecure

boolean

Optional: Flag to request a secure cluster is created

serviceSubnet

string

Optional: User provided value for service subnet

trustedProfileID

string

Optional: The trusted profile ID to set in the cluster

workerCount

integer

Optional: The number of worker nodes to create per zone in the default worker pool

zone

string

Optional: The name of the zone to create the default worker pool in

Path Parameters

Query Parameters

Response

201 - Created. The cluster was successfully created in the IBM Cloud Satellite location.

id

string

The id value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions for the specified infrastructure provider.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. A cluster with the same name already exists. Choose another name for your cluster.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create an IBM Cloud Satellite location

POST /v2/satellite/createController

Create an IBM Cloud Satellite location in the IBM Cloud account that you are logged into. Creating a location requires Administrator access to Kubernetes Service in the IBM Cloud account.

Request

Request Body

MultishiftCreateController

The configuration details for your Satellite location, in JSON format.

calicoIPAutodetection

object

Optional: Used to determine the correct IP for internal routing

capabilitiesManagedBySatellite

Required *

array

Satellite capabilities attached to the location

coreos_enabled

boolean

Indicates whether CoreOS features should be enabled for the location

cos_config

COSBucket

COSBucket Optional: IBM Cloud Object Storage bucket configuration details

bucket

string

The bucket value.

endpoint

string

The endpoint value.

region

string

The region value.

serviceInstance

object

The serviceInstance value.

cos_credentials

COSAuthorization

COSAuthorization Optional: IBM Cloud Object Storage authorization keys

access_key-id

string

The HMAC secret access key ID

secret_access_key

string

The HMAC secret access key

description

string

A description of the new Satellite location

iaas

IAAS

Iaas

credential

Required *

array

A JSON encoded credential string specific to the chosen provider

provider

string

The name of the infrastructure provider for the Satellite location, such as AWS, Azure, GCP or IBM Cloud.

region

string

The name of region in the infrastructure provider that is used for the Satellite location, such as the AWS 'us-east-2' region.

ingestion_keys

IngestionKeys

IngestionKeys Optional: Keys that can be passed in during Satellite location creation

activity_tracker_key

string

The activity tracker key value.

logging_key

string

The logging key value.

location

string

The IBM Cloud metro from which the Satellite location is managed

loggingAccountID

string

The account ID for IBM Log Analysis with LogDNA log forwarding

multishiftPodSubnet

string

Optional: Used to determine the pod subnet

multishiftServiceSubnet

string

Optional: Used to determine the service subnet

name

string

A unique name for the new Satellite location

physicalAddress

string

An optional physical address of the new Satellite location which is deployed on premise

zones

Required *

array

The names of at least three high availability zones to use for the location (e.g. cloud-zone-1, cloud-zone-2, cloud-zone-3)

Path Parameters

Query Parameters

Response

201 - Created. The location was successfully created in the IBM Cloud account that you are logged in to.

crn

string

The crn value.

id

string

The id value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions for the specified infrastructure provider.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. A location with the same name already exists. Choose another name for your location.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a worker pool for an IBM Cloud Satellite cluster

POST /v2/satellite/createWorkerPool

Create a worker pool for the specified cluster in an IBM Cloud Satellite location. Creating a worker pool requires Operator access to Kubernetes Service in the IBM Cloud account. Specify the worker pool `flavor` as "upi" for user provided infrastructure. You can also use `hostLabels` key value pairs so that available hosts with matching labels in the IBM Cloud Satellite location are automatically assigned to the worker pool.

Request

Request Body

V2SatelliteCreateWorkerPoolRequest

The configuration details for your worker pool, in JSON format.

Zones

Required *

array

The Zones value.

cluster

string

The cluster value.

diskEncryption

boolean

The diskEncryption value.

entitlement

string

The entitlement value.

flavor

string

The flavor value.

hostLabels

object

The hostLabels value.

isolation

string

The isolation value.

labels

object

The labels value.

name

string

The name value.

operatingSystem

string

The operatingSystem value.

workerCount

integer

The workerCount value.

Path Parameters

Query Parameters

Response

201 - Created. The worker pool was successfully created in the specified cluster.

workerPoolID

string

The workerPoolID value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. Another worker pool might be provisioning for the specified cluster. Wait a few minutes and try again.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a zone in the specified worker pool for an IBM Cloud Satellite cluster

POST /v2/satellite/createWorkerPoolZone

Create a zone in the specified worker pool for an IBM Cloud Satellite cluster. Worker nodes are provisioned in each zone based on the size per zone of the worker pool.

Request

Request Body

SatelliteWorkerPoolZoneAdd

Input parameters to add zones to the worker pool.

cluster

string

The cluster value.

id

Required *

string

The id value.

workerpool

string

The workerpool value.

Path Parameters

Query Parameters

Response

201 - OK. The requested zone was added to the worker pool.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker pool could not be found. To list all worker pools for a cluster, use the `GET /v2/getWorkerPools` API or run `ibmcloud ks worker-pool ls -c <cluster>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. The provided zone already exists in the worker pool.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the IBM Cloud Satellite clusters that you have access to

GET /v2/satellite/getClusters

List the IBM Cloud Satellite clusters that you have access to.

Request

Path Parameters

Query Parameters

Response

200 - Success. A list of clusters that you have access to is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the details for an IBM Cloud Satellite location

GET /v2/satellite/getController

Get the details for an IBM Cloud Satellite location.

Request

Path Parameters

Query Parameters

controller

Required *

string

The ID of the location to get information about.

Response

200 - Success. The details of the requested IBM Satellite location are returned.

activityTrackerKeyProvided

boolean

The activityTrackerKeyProvided value.

addons

array

The addons value.

caCertRotationStatus

CommonClusterCACertRotation

CommonClusterCACertRotation CA cert rotation properties

calicoIPAutodetectionConfig

string

The calicoIPAutodetectionConfig value.

capabilitiesManagedBySatellite

array

The capabilitiesManagedBySatellite value.

coreosEnabled

boolean

The coreosEnabled value.

cos_config

COSBucket

COSBucket Optional: IBM Cloud Object Storage bucket configuration details

createdDate

string

The createdDate value.

crn

string

The crn value.

datacenter

string

The datacenter value.

deployments

Deployments

Deployments reports status of deployments on the IBM Cloud Satellite location

description

string

The description value.

desiredTrustedProfileID

string

The desiredTrustedProfileID value.

disableAutoUpdate

boolean

The disableAutoUpdate value.

entitlement

string

The entitlement value.

etcdPort

string

The etcdPort value.

features

CommonClusterFeatures

Common cluster features

hostUpdateSeverity

string

HostUpdateSeverity indicates the highest update severity among all worker nodes (hosts) in this location. Possible values: "" (no update needed), warning (behind by patch/build version), critical (behind by minor version).

hosts

Hosts

Hosts lists the hosts belonging to the IBM Cloud Satellite location

iaas

IAAS

Iaas

id

string

The id value.

ignitionServerURL

string

The ignitionServerURL value.

ignition_server_port

integer

The ignition server port value.

imageSecurityEnabled

boolean

The imageSecurityEnabled value.

ingress

CommonClusterIngress

Common cluster ingress

isPaid

boolean

The isPaid value.

keyManagementService

CommonClusterKMS

Common clusterkms

konnectivityServerURL

string

The konnectivityServerURL value.

konnectivity_server_port

integer

The konnectivity server port value.

lifecycle

CommonClusterLifecycle

Common cluster lifecycle

location

string

The location value.

locationZones

array

The locationZones value.

logDNAKeyProvided

boolean

The logDNAKeyProvided value.

masterKubeVersion

string

The masterKubeVersion value.

masterURL

string

The masterURL value.

multiAzCapable

boolean

The multiAzCapable value.

name

string

The name value.

networkPlugin

string

The networkPlugin value.

oauthServerURL

string

The oauthServerURL value.

offering

string

The offering value.

open_vpn_server_port

integer

The open vpn server port value.

outboundTrafficProtection

string

The outboundTrafficProtection value.

physicalAddress

string

The physicalAddress value.

podSubnet

string

The podSubnet value.

provider

string

The provider value.

region

string

The region value.

resourceGroup

string

The resourceGroup value.

resourceGroupName

string

The resourceGroupName value.

secureByDefault

string

The secureByDefault value.

secureRequested

boolean

The secureRequested value.

serviceEndpoints

CommonClusterServiceEndpoint

Common cluster service endpoint

serviceSubnet

string

The serviceSubnet value.

state

string

The lifecycle state of the cluster. Possible values include aborted, critical, delete_failed, deleted, deleting, deploy_failed, deploying, normal, pending, requested, updating, unsupported, and warning. For more information, see the docs 'http://ibm.biz/cluster-health-states'

status

string

The status value.

supportedOperatingSystems

array

The supportedOperatingSystems value.

targetVersion

string

The targetVersion value.

trustedProfileID

string

The trustedProfileID value.

type

string

The type value.

versionEOS

string

The versionEOS value.

virtualPrivateEndpointURL

string

The virtualPrivateEndpointURL value.

vpcs

array

The vpcs value.

workerCount

integer

The workerCount value.

workerZones

array

The workerZones value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Could not find the IBM Cloud Satellite location. To list available locations, use the `GET /v2/satellite/getControllers` API, or run `ibmcloud sat location ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the IBM Cloud Satellite locations that you have access to

GET /v2/satellite/getControllers

List the IBM Cloud Satellite locations that you have access to.

Request

Path Parameters

Query Parameters

Response

200 - Success. A list of locations that you have access to is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the clusters in an IBM Cloud Satellite location that are associated with

GET /v2/satellite/getServiceClusters

List the clusters that are associated with a Satellite-enabled service that you deployed to your IBM Cloud Satellite location. The clusters in this list are managed by IBM Cloud to provide the cloud service in the location, but you still provide the hosts to run the clusters.

Request

Path Parameters

Query Parameters

controller

Required *

string

The ID of the location to list services.

Response

200 - Success. A list of Satellite-enabled service clusters that you have access to is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Assign a host to an IBM Cloud Satellite location or cluster

POST /v2/satellite/hostqueue/createAssignment

Assign a host to an IBM Cloud Satellite location or cluster. Before you can assign hosts to clusters, first assign at least three hosts to the Satellite location, to run control plane operations. Then, when you have Satellite clusters, you can assign hosts as needed to provide compute resources for your workloads. You can assign hosts by specifying a host ID or by providing labels to match hosts to your request.

Request

Request Body

MultishiftCreateAssignment

The configuration details to assign a host to an IBM Cloud Satellite resource, in JSON format. The "cluster" field (required) indicates the name or ID of the IBM Cloud Satellite resource to assign the host. The resource can be the name or ID of the Satellite location itself, or an IBM Cloud Satellite cluster. If "hostID" is specified, that host is assigned if it is available. If a set of "labels" is specified, all the available hosts are scanned to find a host that matches all the labels. If neither "hostID" nor "labels" are specified, a random available host is assigned.

cluster

string

The name or ID of a Satellite location or cluster to assign the host to

controller

string

The name or ID of the Satellite location

hostID

string

Optional: The name or ID of the specific host to assign to a Satellite location or cluster

labels

object

Key-value pairs to label the host, such as cpu=4 to describe the host capabilities

workerpool

string

Optional: The name or ID of the worker pool within the cluster to assign the host to

zone

string

Optional: The zone within the cluster to assign the host to

Path Parameters

Query Parameters

Response

201 - Created. A host was successfully assigned to your IBM Cloud Satellite resource.

hostID

string

The hostID value.

id

string

The id value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions for the specified infrastructure provider.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Could not find the IBM Cloud Satellite location. To list available locations, use the `GET /v2/satellite/getControllers` API, or run `ibmcloud sat location ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. Could not find any available hosts that match your requested host ID or label parameters.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Attach a host to an IBM Cloud Satellite location

POST /v2/satellite/hostqueue/createRegistrationScript

Create a script to run on a Red Hat Enterprise Linux 7 host in your on-premises infrastructure. The script attaches the host to your IBM Cloud Satellite location. The host must have access to the public network in order for the script to complete.

Request

Request Body

MultishiftNodeQueue

The configuration details to create an attachment script for your Satellite location, in JSON format. The "labels" field (required) is a set of key-value pairs to describe your host, such as cpu=4. Later, when you assign a host to IBM Cloud Satellite resources, these labels are used to match your host with your request.

controller

string

The name or ID of the Satellite location

labels

object

Key-value pairs to label the host, such as cpu=4 to describe the host capabilities

Path Parameters

Query Parameters

Response

201 - Created. The response contains a script that you can run on your host to attach the host to your IBM Cloud Satellite location.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions for the specified infrastructure provider.

404 - Could not find the IBM Cloud Satellite location. To list available locations, use the `GET /v2/satellite/getControllers` API, or run `ibmcloud sat location ls`.

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

List the hosts in your IBM Cloud Satellite location

GET /v2/satellite/hostqueue/getHosts

List the hosts in your IBM Cloud Satellite location.

Request

Path Parameters

Query Parameters

controller

Required *

string

The ID of the location to to retrieve hosts from.

Response

200 - Success. A list of hosts in your IBM Cloud Satellite location is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Could not find the IBM Cloud Satellite location. To list available locations, use the `GET /v2/satellite/getControllers` API, or run `ibmcloud sat location ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove a host from an IBM Cloud Satellite location or cluster

POST /v2/satellite/hostqueue/removeHost

Remove a host from an IBM Cloud Satellite resource, such as a cluster. The host is removed from the resource and no longer available in IBM Cloud Satellite. However, if you want, you must still delete the host machine in the underlying infrastructure provider. Before you can remove a host, you must remove the worker node that runs on the host. To check worker nodes on the host, use the `GET /v2/satellite/hostqueue/getHosts` API or run `ibmcloud sat host ls`. To remove a worker node, run `ibmcloud ks worker rm -c <cluster_name_or_ID> -w <worker_ID>`.

Request

Request Body

MultishiftRemoveNode

The configuration details to remove a host from an IBM Cloud Satellite location, in JSON format.

controller

string

The name or ID of the Satellite location

hostID

string

The name or ID of the host to remove

Path Parameters

Query Parameters

Response

204 - OK. The host was successfully removed from your IBM Cloud Satellite location.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions for the specified infrastructure provider.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Could not find the host. To list available hosts, use the `GET /v2/satellite/hostqueue/getHosts` API or run `ibmcloud sat host ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. Cannot remove the host because a worker node runs on the host. Remove the worker node and try again.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update a host in your IBM Cloud Satellite location

POST /v2/satellite/hostqueue/updateHost

Update the labels of a host in your IBM Cloud Satellite location. You can apply a new set of labels only to hosts that are not already assigned to an IBM Cloud Satellite resource.

Request

Request Body

MultishiftUpdateNode

The configuration details to update a host to an IBM Cloud Satellite resource, in JSON format.

controller

string

The name or ID of the Satellite location

hostID

string

The name or ID of the host to update

labels

object

Key-value pairs to label the host, such as cpu=4 to describe the host capabilities

Path Parameters

Query Parameters

Response

204 - OK. The host was successfully updated.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions for the specified infrastructure provider.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Could not find the host. To list available hosts, use the `GET /v2/satellite/hostqueue/getHosts` API or run `ibmcloud sat host ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. The labels cannot be updated because the host is already assigned to an IBM Cloud Satellite resource, such as a cluster.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Satellite is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove an IBM Cloud Satellite Location

POST /v2/satellite/removeController

Remove an IBM Cloud Satellite location. Before you can remove a location, you must remove any Satellite clusters and the underlying host machines. To list the hosts in your location, run `ibmcloud sat hosts --location <name_or_ID>` and check the Cluster and Worker details in the output.

Request

Request Body

MultishiftCreateClusterFragment

The IBM Satellite location to remove.

calicoIPAutodetection

object

Optional: Used to determine the correct IP for internal routing

controller

string

The name or ID of the Satellite location

infrastructureTopology

string

Optional: Enables single worker node clusters

networkPlugin

string

Optional: NetworkPlugin indicates what container network interface has to be used in the cluster. If the field is missing it is defaulted to Calico.

pullSecret

string

Optional: The RedHat pull secret to create the OpenShift cluster

Path Parameters

Query Parameters

Response

204 - OK. The request to remove your IBM Cloud Satellite location was successfully received.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Could not find the IBM Cloud Satellite location. To list available locations, use the `GET /v2/satellite/getControllers` API, or run `ibmcloud sat location ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. Cannot delete an IBM Cloud Satellite location that has active clusters. To list the clusters in the Satellite location, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Set the Pod Security admission controller configuration

POST /v2/setPodSecurity

Set the Pod Security admission controller configuration.

Request

Request Body

SetPodSecurityRequest

The cluster to target.

cluster

string

The cluster value.

configuration

string

Optional: A base64 encoded Kubernetes PodSecurityConfiguration yaml definition. If configuration is present the specified custom configuration will be used. If configuration is not present the default Kubernetes configuration will be used.

Response

204 - OK. The request to set the Pod Security admission controller configuration was successfully received.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format. \

Bad Request. Your cluster must run Kubernetes version 1.24 or later to modify the Pod Security admission configuration.
Bad Request. Pod Security admission is not supported for Red Hat OpenShift clusters.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Set custom labels for a worker pool

POST /v2/setWorkerPoolLabels

Set custom labels for a worker pool and each of its worker nodes. You might use labels to restrict a workload to run on only this worker pool, or to apply a taint so that workloads do not run on the worker pool. To confirm that your custom labels are applied, run `ibmcloud ks worker-pool get -c <cluster_name_or_ID>`. To check the labels of the worker nodes, get the private IP address of the worker node (`ibmcloud ks worker ls -c <cluster_name_or_ID>`) and run `kubectl describe node <worker_private_IP>`. Note that you must not edit the system-provided labels that that come with the worker pool and worker nodes by default, or you might experience unexpected results.

Request

Request Body

SetWorkerPoolLabels

Labels to apply to the worker pool and each of its worker nodes. To apply a custom label to the worker pool, set the "state" field to "labels" and fill in the "labels" section with your label key-value pairs. When you apply a label, all existing custom labels are replaced. If you have existing custom labels that you want to keep, include them in your request. To remove a custom label, set the "state" field to "labels" and in the "labels" section, include the same "key" field, but leave the value field blank "". Note that you must not edit the system-provided labels that that come with the worker pool and worker nodes by default, or you might experience unexpected results.

cluster

string

The cluster value.

labels

object

The labels value.

workerpool

string

The workerpool value.

Path Parameters

Query Parameters

Response

204 - OK. The request to set the labels of the worker pool was successfully received.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Set the operating system of a worker pool

POST /v2/setWorkerPoolOperatingSystem

Set the operating system of a worker pool. To confirm that your modification is applied, check the details of a worker pool (`ibmcloud ks worker-pool get --cluster CLUSTER --worker-pool POOL`).

Request

Request Body

SetWorkerPoolOperatingSystem

Sets the operating system of a worker pool.

cluster

string

The cluster value.

operatingSystem

string

The operatingSystem value.

workerPool

string

The workerPool value.

Path Parameters

Query Parameters

Response

202 - OK. The request to set the operating system of the worker pool was successful.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - The worker pool's operating system is not suitable for an upgrade this way.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - The specified worker pool could not be found..

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Set custom taints for a worker pool

POST /v2/setWorkerPoolTaints

Set custom taints for a worker pool and each of its worker nodes. You might use taints so that workloads do not run on the worker pool. To confirm that your custom taints are applied, check the taints of the worker nodes by getting the private IP address of the worker node (`ibmcloud ks worker ls -c <cluster_name_or_ID>`) and run `kubectl describe node <worker_private_IP>`.

Request

Request Body

SetWorkerPoolTaints

Taints to apply to the worker pool and each of its worker nodes. To apply a custom taint to the worker pool, set the "state" field to "taints" and fill in the "taints" section with your taint key-value pairs where the value contains the taint value and the taint effect separated by a ":" with valid taint effects being "NoSchedule", "PreferNoSchedule", and "NoExecute". When you apply a taint, all existing custom taints are replaced. If you have existing custom taints that you want to keep, include them in your request. To remove a custom taint, set the "state" field to "taints" and in the "taints" section, include the same "key" field, but leave the value field blank "".

cluster

string

The cluster value.

taints

object

The taints value.

workerpool

string

The workerpool value.

Path Parameters

Query Parameters

Response

204 - OK. The request to set the taints of the worker pool was successfully received.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Createattachment

POST /v2/storage/createAttachment

Create volume attachment for a given worker

Request

Request Body

The config includes ID of the cluster, ID of the worker on which you want to attach a volume, and the unique volume ID of the volume to be attached to a worker. To list the clusters that you have access to, run `ibmcloud ks clusters`. To list all worker nodes for a cluster, run `ibmcloud ks workers <cluster_name_or_ID>`. To list the volumes that you have access to, run `ibmcloud is vols`.

cluster

string

volumeID

string

worker

string

Path Parameters

Query Parameters

Response

201 - Ok. Attach request successfully accepted.

device

Device

Device

id

string

The id value.

name

string

The name value.

status

string

The status value.

type

string

The type value.

volume

Volume

Volume

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker could not be found. To list the workers, use the `GET /v2/vpc/getWorkers` API or run `ibmcloud ks workers --cluster <clusterID or Name>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Detach volume from given worker

POST /v2/storage/deleteAttachment

Detach volume from given worker.

Request

Request Body

VPCVolumeAttachmentConfig

The config includes ID of the cluster, ID of the worker from which you want to detach volume, and the unique volume attachment ID for the attached volume. To list the clusters that you have access to, run `ibmcloud ks clusters`. To list all worker nodes for a cluster, run `ibmcloud ks workers <cluster_name_or_ID>`.

cluster

string

The cluster value.

volumeAttachmentID

string

The volumeAttachmentID value.

volumeID

string

The volumeID value.

worker

string

The worker value.

Path Parameters

Query Parameters

Response

201 - Ok. detach request successfully accepted.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker could not be found. To list the workers, use the `GET /v2/vpc/getWorkers` API or run `ibmcloud ks workers --cluster <clusterID or Name>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Getattachment

GET /v2/storage/getAttachment

Get the volume attachment detail for given volume attachment ID

Request

Path Parameters

Query Parameters

cluster

Required *

string

The ID or name of the cluster. To list the clusters that you have access to, run `ibmcloud ks clusters`.

worker

Required *

string

The ID of the worker node, whose volume attachments needs to be listed. To list all worker nodes for a cluster, run `ibmcloud ks workers <cluster_name_or_ID>`.

volume_attachment_id

Required *

string

The unique volume attachment ID for the attached volume

Response

200 - Ok.

device

Device

Device

id

string

The id value.

name

string

The name value.

status

string

The status value.

type

string

The type value.

volume

Volume

Volume

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker could not be found. To list the workers, use the `GET /v2/vpc/getWorkers` API or run `ibmcloud ks workers --cluster <clusterID or Name>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Getattachments

GET /v2/storage/getAttachments

Get the volume attachments detail for a given worker

Request

Path Parameters

Query Parameters

cluster

Required *

string

The ID or name of the cluster. To list the clusters that you have access to, run `ibmcloud ks clusters`.

worker

Required *

string

The ID of the worker node, whose volume attachments needs to be listed.

Response

200 - Ok.

volume_attachments

array

The volume attachments value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker could not be found. To list the workers, use the `GET /v2/vpc/getWorkers` API or run `ibmcloud ks workers --cluster <clusterID or Name>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get the details of a storage volume

GET /v2/storage/getVolume

Get the details of a storage volume.

Request

Path Parameters

Query Parameters

volume_id

Required *

string

The unique volume ID. To list the volume ID, use the `GET /v2/storage/classic/getVolumes` API or run `ibmcloud ks storage volume ls classic`.

Response

200 - Ok.

id

string

ID .. id is of a volume

name

string

Name .. Name of the volume

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker could not be found. To list the workers, use the `GET /v2/vpc/getWorkers` API or run `ibmcloud ks workers --cluster <clusterID or Name>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List storage volumes for a cluster or for the account if no cluster is provided

GET /v2/storage/getVolumes

List storage volumes for a cluster or for the account if no cluster is provided.

Request

Path Parameters

Query Parameters

cluster

string

The ID or name of the classic cluster. To list the clusters that you have access to, run `ibmcloud ks cluster ls --provider classic`.

provider

string

Filter the list for a specific infrastructure provider. Supported values are classic, vpc-classic, and vpc-gen2.

zone

string

The zone to filter volume results by. To list available zones, run `ibmcloud ks locations`.

Response

200 - Ok.

volumes

array

The volumes value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker could not be found. To list the workers, use the `GET /v2/vpc/getWorkers` API or run `ibmcloud ks workers --cluster <clusterID or Name>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Acknowledge the request to expand storage capacity

PATCH /v2/storage/satellite/ackDesiredStorageConfigCapacity

Acknowledge the request to expand the storage capacity of an existing storage request.

Request

Request Body

AckDesiredStorageCapacityRequest

Include the ID of the storage request (`request-id`), the cluster ID (`cluster`) and the name or ID of the Satellite location (`controller`) that the cluster is registered to. To list storage requests, use the `/v2/satellite/getDesiredStorageConfig` API. To list the Satellite clusters you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud sat service ls --location=<location-name-or-ID>`.

cluster

string

The cluster value.

controller

string

The controller value.

request-id

string

The request-id value.

Response

201 - OK. The storage request is created.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - The specified cluster or storage request could not be found. Check the input parameters and try again. Verify the input parameters and retry the request. To list the Satellite clusters you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud sat service ls --location=<location-name-or-ID>`. To list storage requests, use the `/v2/satellite/getDesiredStorageConfig` API.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create an assignment using a Satellite storage configuration for the cluster

POST /v2/storage/satellite/createAssignment

Create an assignment to install the storage driver that is described by the version of the storage configuration on the cluster group(s). Then, apps that run in the clusters, part of cluster group(s), can use the storage.

Request

Request Body

CreateSubscriptionInputData

Include following parameters to create an assignment: 1. Name of the assignment (`name`). 2. Storage configuration name or ID (`config`). To list the storage configurations that you have access to, use the `GET /v2/storage/satellite/getStorageConfigurations` API or run `ibmcloud sat storage config ls`. 3. The name or ID of the Satellite location (`controller`). To list the Satellite locations that you have access to, use the `GET /v2/satellite/getControllersAPI` or run `ibmcloud sat location ls`. 4. One or more cluster groups (`groups`) on which you want to apply the configuration. Note that at least one cluster group is required. To list the cluster groups that you have access to, run `ibmcloud sat group ls`. 5. Enable or disable automatic upgrades for the assignment (`autoUpgrade="true|false"`).

autoUpgrade

string

The autoUpgrade value.

config

string

The config value.

controller

string

The controller value.

groups

Required *

array

The groups value.

name

string

The name value.

Response

200 - OK. An assignment using the storage configuration is created.

addSubscription

AddSubscriptionType

Add subscription type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified config or cluster group(s) could not be found. To list the storage configurations that you have access to, use the `GET /v2/storage/satellite/getStorageConfigurations` API or run `ibmcloud sat storage config ls`. To list the Satellite cluster groups you have access to, run `ibmcloud sat group ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create an assignment using a Satellite storage configuration for a Satellite

POST /v2/storage/satellite/createAssignmentByCluster

Create an assignment to install the storage driver described by the version of the storage configuration on the Satellite cluster or service cluster. Then, apps that run in the cluster can use the storage.

Request

Request Body

CreateSubscriptionByClusterInputData

Include following parameters to create an assignment: 1. Name of the assignment (`name`). 2. Storage configuration name or ID (`config`). To list the storage configurations for a location that you have access to, use the `GET /v2/storage/satellite/getStorageConfigurationsByController` API or run `ibmcloud sat storage config ls --location LOCATION`. 3. ID of the Satellite cluster or service cluster that you want to apply the configuration to (`cluster`). To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`. 4. The name or ID of the Satellite location (`controller`). To list the Satellite locations that you have access to, use the `GET /v2/satellite/getControllersAPI` or run `ibmcloud sat location ls`. 5. Enable or disable automatic upgrades for the assignment (`autoUpgrade="true|false"`).

autoUpgrade

string

The autoUpgrade value.

cluster

string

The cluster value.

config

string

The config value.

controller

string

The controller value.

name

string

The name value.

Response

200 - OK. An assignment using the storage configuration is created.

addSubscription

AddSubscriptionType

Add subscription type

400 - Bad Request. The specified cluster is neither a Satellite cluster nor a service cluster. To list the Satellite clusters you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified config or cluster or location could not be found. To list the storage configurations for the location that you have access to, use the `GET /v2/storage/satellite/getStorageConfigurationsByController` API or run `ibmcloud sat storage config ls --location LOCATION`. To list the Satellite clusters you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated. To create a Satellite storage configuration, you can use /v2/stor

POST /v2/storage/satellite/createStorageConfiguration

Create a Satellite storage configuration based off the storage template, custom parameters, and location that you want to use. Then, assign the storage configuration to your clusters to install the storage driver so that the apps that run in the cluster can use the storage.

Request

Request Body

StorageConfigCreateInput

Include a name for the storage configuration (`config-name`), the storage template name (`storage-template-name`), version (`storage-template-version`), required parameters as per the template specified (`user-config-parameters`, `user-secret-parameters`, and/or `storage-class-parameters`) and the Satellite location (`location`) where you want to use the storage configuration. To list the storage templates and template versions, run `ibmcloud sat storage template ls`. To list the parameters for a given storage template and template version, run `ibmcloud sat storage template get --name=<template-name> --version=<template-version>`. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

config-name

string

The config-name value.

controller

string

The controller value.

storage-class-parameters

Required *

array

The storage-class-parameters value.

storage-template-name

string

The storage-template-name value.

storage-template-version

string

The storage-template-version value.

user-config-parameters

object

The user-config-parameters value.

user-secret-parameters

object

The user-secret-parameters value.

Response

201 - OK. The storage configuration is created.

addChannel

object

The addChannel value.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a Satellite storage configuration

POST /v2/storage/satellite/createStorageConfigurationByController

Create a Satellite storage configuration based on the storage template, custom parameters, and location that you want to use. After you create the configuration, install the storage driver by assigning the configuration to your clusters or cluster groups with the `/v2/storage/satellite/createAssignmentByCluster` or `/v2/storage/satellite/createAssignment` APIs.

Request

Request Body

StorageConfigCreateInput

Include a name for the storage configuration (`config-name`); the storage template name (`storage-template-name`), version (`storage-template-version`) (optionally; if unspecified, the default storage template version is picked), required parameters as per the template specified (`user-config-parameters`, `user-secret-parameters`, and/or `storage-class-parameters`) and ID of the Satellite location (`controller`) where you want to use the storage configuration. The `update-assignments` payload parameter may be ignored.

Enter a storage configuration name that is less than 253 characters long and contains only lowercase letters, numbers, `-`, or `.`.

To list the storage templates and template versions that you have access to, run `ibmcloud sat storage template ls`. To list the parameters for a given storage template and template version, run `ibmcloud sat storage template get --name=<template-name> --version=<template-version>`. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

config-name

string

The config-name value.

controller

string

The controller value.

storage-class-parameters

Required *

array

The storage-class-parameters value.

storage-template-name

string

The storage-template-name value.

storage-template-version

string

The storage-template-version value.

user-config-parameters

object

The user-config-parameters value.

user-secret-parameters

object

The user-secret-parameters value.

Response

201 - OK. The storage configuration is created.

addChannel

object

The addChannel value.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Expand the capacity of a storage request

PATCH /v2/storage/satellite/expandDesiredStorageConfigCapacity

Expand the capacity of an existing storage request. Specify the storage request that you want to expand, the cluster it is associated with, and the desired total capacity. Note that capacity expansion is subject to acknowledgement from the Satellite location administator.

To check if the Satellite location administrator has acknowledged the capacity expansion for a given storage request, use the `/v2/satellite/getDesiredStorageConfig` API. After the capacity expansion is acknowledged, the `status` field in the `backend` section of the `/v2/satellite/getDesiredStorageConfig` API response is set to `completed`.

Request

Request Body

ExpandDesiredStorageCapacityRequest

Include the ID of the storage request (`request-id`), the cluster ID (`cluster`) on which it is placed, and the desired total capacity (`total-capacity`). Specify the desired total capacity as a positive integer value in kilobytes (`K`), megabytes (`M`), gigabytes (`G`), terabytes (`T`) or exabytes (`E`). For example, specify `100G` for 100 GB. To list storage requests, use the `/v2/satellite/getDesiredStorageConfig` API. To list the Satellite clusters you have access to, use the `GET /v2/satellite/getClusters` API or run `ibmcloud sat service ls --location=<location-name-or-ID>`.

cluster

string

The cluster value.

request-id

string

The request-id value.

total-capacity

string

The total-capacity value.

Response

201 - OK. The storage request is created.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - The specified cluster or storage request could not be found. Check the input parameters and try again. To list the Satellite clusters you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud sat service ls --location=<location-name-or-ID>`. To list storage requests, use the `/v2/satellite/getDesiredStorageConfig` API.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List Satellite storage configurations assigned to a Satellite cluster or serv

GET /v2/storage/satellite/getAssignedStorageConfigs

List Satellite storage configurations that are assigned to a Satellite cluster or service cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

ID of the Satellite cluster or service cluster to list the assigned storage configurations for. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`.

controller

Required *

string

The name or ID of the Satellite location that the cluster is registered to. To list the Satellite clusters you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`.

Response

200 - OK. Assigned Satellite storage configurations are listed.

400 - Bad Request. The request failed due to one of the following reasons:

  1. The cluster is missing or the specified cluster is invalid.
  2. The specified cluster is neither a Satellite cluster nor a service cluster. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

404 - Not found. The specified cluster or location could not be found. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of an assignment

GET /v2/storage/satellite/getAssignment

View details of an assignment by the assignment UUID.

Request

Path Parameters

Query Parameters

uuid

Required *

string

The UUID of the assignment. To list the assignments that you have access to, use the `GET /v2/storage/satellite/getAssignments` API or run `ibmcloud sat storage assignment ls`.

Response

200 - OK. Assignment details are returned.

channelName

string

The channelName value.

channelUuid

string

The channelUuid value.

cluster

string

The cluster value.

clusterName

string

The clusterName value.

configRevisionStatus

object

The configRevisionStatus value.

created

string

The created value.

groups

array

The groups value.

isAssignmentUpgradeAvailable

boolean

The isAssignmentUpgradeAvailable value.

isAutoUpgradeEnabled

boolean

The isAutoUpgradeEnabled value.

name

string

The name value.

orgId

string

The orgId value.

owner

object

The owner value.

remoteResources

array

The remoteResources value.

rolloutStatus

object

The rolloutStatus value.

satSvcClusterId

string

The satSvcClusterId value.

satcluster

string

The satcluster value.

subscriptionType

string

The subscriptionType value.

updated

string

The updated value.

uuid

string

The uuid value.

version

string

The version value.

versionUuid

string

The versionUuid value.

400 - Bad Request. Either the uuid is missing or the specified uuid is invalid. To list the assignments that you have access to, use the `GET /v2/storage/satellite/getAssignments` API or run `ibmcloud sat storage assignment ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified assignment could not be found. To list the assignments that you have access to, use the `GET /v2/storage/satellite/getAssignments` API or run `ibmcloud sat storage assignment ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated. To view details of an assignment, you can use /v2/storage/satelli

GET /v2/storage/satellite/getAssignmentByName

View details of an assignment by the assignment name.

Request

Path Parameters

Query Parameters

name

Required *

string

The name of the assignment. To list the assignments that you have access to, use the `GET /v2/storage/satellite/getAssignments` API or run `ibmcloud sat storage assignment ls`.

Response

200 - OK. Assignment details successfully fetched.

channelName

string

The channelName value.

channelUuid

string

The channelUuid value.

cluster

string

The cluster value.

clusterName

string

The clusterName value.

configRevisionStatus

object

The configRevisionStatus value.

created

string

The created value.

groups

array

The groups value.

isAssignmentUpgradeAvailable

boolean

The isAssignmentUpgradeAvailable value.

isAutoUpgradeEnabled

boolean

The isAutoUpgradeEnabled value.

name

string

The name value.

orgId

string

The orgId value.

owner

object

The owner value.

remoteResources

array

The remoteResources value.

rolloutStatus

object

The rolloutStatus value.

satSvcClusterId

string

The satSvcClusterId value.

satcluster

string

The satcluster value.

subscriptionType

string

The subscriptionType value.

updated

string

The updated value.

uuid

string

The uuid value.

version

string

The version value.

versionUuid

string

The versionUuid value.

400 - Bad Request. Either the name is missing or the specified name is invalid. To list the assignments that you have access to, use the `GET /v2/storage/satellite/getAssignments` API or run `ibmcloud sat storage assignment ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified assignment could not be found. To list the assignments that you have access to, use the `GET /v2/storage/satellite/getAssignments` API or run `ibmcloud sat storage assignment ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List storage assignments in the IBM Cloud account

GET /v2/storage/satellite/getAssignments

List storage assignments that you have access to in the IBM Cloud account. Returned details include the assignment name, UUID, and creation timestamp.

Request

Response

200 - OK. Assignments are listed.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List storage assignments created for a Satellite cluster or service cluster

GET /v2/storage/satellite/getAssignmentsByClusterID

List storage assignments created for a Satellite cluster or service cluster. Returned details include the assignment name, UUID, and creation timestamp.

Request

Path Parameters

Query Parameters

cluster

Required *

string

ID of the Satellite cluster or service cluster to list the storage assignments for. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`.

controller

Required *

string

The name or ID of the Satellite location that the cluster is registered to. To list the Satellite clusters you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`.

Response

200 - OK. Assignments are listed.

400 - Bad Request. The request failed due to one of the following reasons:

  1. The cluster is missing or the specified cluster is invalid. 2.The specified cluster is neither a Satellite cluster nor a service cluster. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or location could not be found. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List storage assignments by configuration name or UUID

GET /v2/storage/satellite/getAssignmentsByConfig

List storage assignments by configuration name or UUID. Returned details include the assignment name, UUID, and creation timestamp.

Request

Path Parameters

Query Parameters

config

Required *

string

The name or ID of the Satellite storage configuration. To list the storage configurations that you have access to, use the `GET /v2/storage/satellite/getStorageConfigurations` API or run `ibmcloud sat storage config ls`.

Response

200 - OK. Assignments are listed.

400 - Bad Request. Either the config is missing or the specified config is invalid. To list the storage configurations that you have access to, use the `GET /v2/storage/satellite/getStorageConfigurations` API or run `ibmcloud sat storage config ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified config could not be found. To list the storage configurations that you have access to, use the `GET /v2/storage/satellite/getStorageConfigurations` API or run `ibmcloud sat storage config ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List storage assignments in a Satellite location

GET /v2/storage/satellite/getAssignmentsByController

List storage assignments that you have access to in a Satellite location. Returned details include the assignment name, UUID, and creation timestamp.

Request

Path Parameters

Query Parameters

controller

Required *

string

The name or ID of the Satellite location to list assignments for. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

Response

200 - OK. Assignments are listed.

400 - Bad Request. The controller is missing. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified location could not be found. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List and filter available storage classes from assigned Satellite storage con

GET /v2/storage/satellite/getAvailableStorageClasses

List and filter the available storage classes from assigned Satellite storage configurations on a Satellite or service cluster. By default, only the available storage classes from Software Defined Storage (SDS) template based Satellite storage configurations are returned. To view all available storage classes, set the `onlyShowSDS` query paramter flag to `false`. Optionally, filter the available storage classes based on volume type using the `volumeType` query parameter.

Note that, if a volume type is specified, the most preferable storage class from each of the assigned storage configurations of specified volume type is returned. For user-defined storage classes, the preference is set while creating the storage configuration. To view the preference for all the storage classes of an assigned storage configuration, run `ibmcloud sat storage config class ls --config CONFIG --show-params` and look for the parameter `storage-class-preference`.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The ID of the Satellite cluster or service cluster for which available storage classes from assigned Satellite storage configurations are to be listed. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`.

controller

Required *

string

The name or ID of the Satellite location that the cluster is registered to. To list the Satellite clusters you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`.

volume_type

string

Filter the available storage classes by volume type. The supported volume types are `file`, `block` and `object`. If unspecified, available storage classes of all volume types are returned.

only_show_sds

boolean

Specify `true` or `false` to view only the available storage classes from software-defined storage (SDS) storage configurations. If unspecified, the default value is `true`.

Response

200 - OK. Available storage classes are listed.

storage-classes

array

The storage-classes value.

400 - Bad Request. The request failed due to one of the following reasons:

  1. The cluster is missing or the specified cluster is invalid. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`.
  2. The specified cluster is neither a Satellite cluster nor a service cluster. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`.
  3. The specified value is an invalid value for parameter `volumeType`. Supported values for `volumeType` parameter are: `file, block, object`.
  4. The specified value is an invalid value for parameter `onlyShowSDS`. Supported values for `onlyShowSDS` parameter are: `true, false`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or location could not be found. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud ks cluster ls --provider=satellite`. To list the service clusters for a location that you have access to, run `ibmcloud sat services --location LOCATION`. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List Storage requests on a cluster

GET /v2/storage/satellite/getDesiredStorageConfig

List the storage requests for a cluster in a Satellite location.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The ID of the cluster where you want to list storage requests. To list the Satellite clusters you have access to, use the `GET /v2/satellite/getClusters` API or run `ibmcloud sat service ls --location=<location-name-or-ID>`. The response body for each storage request contains the request specifications and the following fields: 1. The`assignment` field. This field is initially empty when the storage request is created. When the location administrator assigns a storage configuration to the cluster that matches the storage request, this field is populated with the UUID of the assignment. 2. A `status` field in the `config` section that indicates the status of storage provisioning or assignment. If a storage assignment is created but no action is taken on it, the status is set to `pending`. If a storage configuration has been assigned to the cluster, the status is set to `assigned`. If the storage request is deleted, the status is set to `deleted`. 3. A `status` field in the `backend` section. This field indicates whether the location administrator has acknowledged the request to increase storage capacity. If the storage capacity expansion request is not acknowledged, the status is set to `pending`. If the request is acknowledged by the location administrator, the status is set to `completed`.

controller

Required *

string

The name or ID of the Satellite location that the cluster is registered to. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud sat service ls --location=<location-name-or-ID>`.

Response

201 - OK. Storage requests are listed.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Could not list the IBM Cloud Satellite storage requests. Verify the input parameters and retry the request. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud sat service ls --location=<location-name-or-ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of a Satellite storage configuration

GET /v2/storage/satellite/getStorageConfiguration

View the details of a Satellite storage configuration.

Request

Path Parameters

Query Parameters

name

Required *

string

The name of the storage configuration. To list the storage configurations that you have access to, run `ibmcloud sat storage config ls`.

include-assignments

boolean

Specify `true` to include details of assignment(s) of the specified storage configuration. The default value is `false`.

Response

201 - OK. Storage configuration details are returned.

config-name

string

The config-name value.

config-version

string

The config-version value.

controller

string

The controller value.

created

string

The created value.

is-revision-update-available

boolean

The is-revision-update-available value.

is-user-secret-parameters-set

object

The is-user-secret-parameters-set value.

latest-revision

string

The latest-revision value.

location

string

The location value.

orgId

string

The orgId value.

revision

string

The revision value.

storage-class-parameters

array

The storage-class-parameters value.

storage-template-metadata

ConfigAttributes

ConfigAttributes defines attributes related to storage configuration

storage-template-name

string

The storage-template-name value.

storage-template-version

string

The storage-template-version value.

subscriptions

array

The subscriptions value.

tags

array

The tags value.

template-status

string

The template-status value.

user-config-parameters

object

The user-config-parameters value.

user-secret-parameters

object

The user-secret-parameters value.

uuid

string

The uuid value.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List Satellite storage configurations

GET /v2/storage/satellite/getStorageConfigurations

List the Satellite storage configurations that you have access to in a Satellite location or in the IBM Cloud account.

Request

Path Parameters

Query Parameters

location

string

The name or ID of the Satellite location to list storage configurations for. If no location is specified, all storage configurations that you have access to in the IBM Cloud account are returned. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

Response

201 - OK. Storage configurations are listed.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List Satellite storage configurations in a Satellite location

GET /v2/storage/satellite/getStorageConfigurationsByController

List the Satellite storage configurations that you have access to in a Satellite location.

Request

Path Parameters

Query Parameters

controller

Required *

string

The name or ID of the Satellite location to list storage configurations for. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

Response

201 - OK. Storage configurations are listed.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View the details of a Satellite storage template

GET /v2/storage/satellite/getStorageTemplate

View the details of a Satellite storage template by name and version

Request

Path Parameters

Query Parameters

name

Required *

string

The name of the storage template. To list the storage templates that you have access to, use the `GET /v2/storage/satellite/getStorageTemplates` API or run `ibmcloud sat storage template ls`.

version

Required *

string

The version of the storage template. To list the storage templates that you have access to, use the `GET /v2/storage/satellite/getStorageTemplates` API or run `ibmcloud sat storage template ls`.

Response

200 - OK. Storage template details are returned.

custom-parameters

array

The custom-parameters value.

description

string

The description value.

name

string

The name value.

revision

string

The revision value.

status

string

The status value.

storage-class-parameters

array

The storage-class-parameters value.

storage-class-template

string

The storage-class-template value.

tags

array

The tags value.

vendor-storage-class-parameters

array

The vendor-storage-class-parameters value.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. User is not allowed to use the specified version of the storage template. To list the storage templates that you have access to, use the `GET /v2/storage/satellite/getStorageTemplates` API or run `ibmcloud sat storage template ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified storage template name or version could not be found. To list the storage templates that you have access to, use the `GET /v2/storage/satellite/getStorageTemplates` API or run `ibmcloud sat storage template ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

410 - The specified version of the storage template is unsupported. To list the storage templates that you have access to, use the `GET /v2/storage/satellite/getStorageTemplates` API or run `ibmcloud sat storage template ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View the change log details of Satellite storage templates

GET /v2/storage/satellite/getStorageTemplateChangelog

View the change log details of all Satellite storage templates or a specific Satellite storage template by name.

Request

Path Parameters

Query Parameters

name

string

The name of the storage template that you want to get the change log for. To list the storage templates that you have access to, use the `GET /v2/storage/satellite/getStorageTemplates` API or run `ibmcloud sat storage template ls`. To get change logs for all storage templates that you have access to, skip this parameter.

Response

200 - OK. Change log(s) of the storage template(s) is/are returned.

latest-revision

RevisionDetails

Revision details

previous-revision

RevisionDetails

Revision details

status

string

The status value.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified storage template could not be found. To list the storage templates that you have access to, use the `GET /v2/storage/satellite/getStorageTemplates` API or run `ibmcloud sat storage template ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Failed to fetch the changelog for the storage template. Note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List Satellite storage templates

GET /v2/storage/satellite/getStorageTemplates

List Satellite storage templates.

Request

Response

200 - OK. Storage templates are listed.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove an assignment

DELETE /v2/storage/satellite/removeAssignment

Remove an assignment with a given UUID.

Request

Path Parameters

Query Parameters

uuid

Required *

string

ID of the assignment. To list the assignments that you have access to, use the `GET /v2/storage/satellite/getAssignments` API or run `ibmcloud sat storage assignment ls`.

controller

Required *

string

The name or ID of the Satellite location. To list the Satellite locations that you have access to, use the `GET /v2/satellite/getControllers` API or run `ibmcloud sat location ls`.

Response

200 - OK. The assignment is removed.

removeSubscription

RemoveSubscriptionType

Remove subscription type

400 - Bad Request. Either the uuid is missing or the specified uuid is invalid. To list the assignments that you have access to, use the `GET /v2/storage/satellite/getAssignments` API or run `ibmcloud sat storage assignment ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified assignment could not be found. To list the assignments that you have access to, use the `GET /v2/storage/satellite/getAssignments` API or run `ibmcloud sat storage assignment ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Delete a storage request

DELETE /v2/storage/satellite/removeDesiredStorageConfig

Delete a storage request on a cluster. If the cluster assignment status of a storage request is `pending` when this API is called, the request is deleted from the database. If the storage request is assigned to a cluster, the request is marked as `deleted` but not removed from the database. To check the cluster assignment status of a storage request, see the `status` field in the `config` section of the`/v2/satellite/getDesiredStorageConfig` API response.

Request

Path Parameters

Query Parameters

request-id

Required *

string

The ID of the storage request. To list storage requests, use the `/v2/satellite/getDesiredStorageConfig` API.

cluster

Required *

string

The ID of the cluster (`cluster`) on which the storage request is placed on. To list storage requests, use the `/v2/satellite/getDesiredStorageConfig` API. To list the Satellite clusters you have access to, use the `GET /v2/satellite/getClusters` API or run `ibmcloud sat service ls --location=<location-name-or-ID>`.

Response

201 - OK. The storage configuration is removed.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Remove a Satellite storage configuration

DELETE /v2/storage/satellite/removeStorageConfiguration

Remove a Satellite storage configuration with a given UUID. If you want to remove a Satellite storage configuration that is currently used in a Satellite storage assignment, set the `removeAssignments` query paramter flag to `true`. This flag when set to `true` removes the storage configuration as well as any associated assignments.

Request

Path Parameters

Query Parameters

uuid

Required *

string

The UUID of the storage configuration. To list the storage configurations that you have access to, run `ibmcloud sat storage config ls`. To view the storage assignments associated with a given storage configuration and the storage configuration UUID, run `ibmcloud sat config get --config=<storage-configuration-name>`.

controller

Required *

string

The name or ID of the Satellite location. To list the Satellite locations that you have access to, use the `GET /v2/satellite/getControllers` API or run `ibmcloud sat location ls`.

remove_assignments

boolean

Specify `true` to remove the storage configuration along with the associated assignments. If unspecified, the default value is `false`.

Response

200 - OK. The storage configuration is removed.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Enable or disable automatic upgrades for an existing storage assignment(s)

PATCH /v2/storage/satellite/setAssignmentAutoupgrade

Enable or disable automatic upgrades for an existing assignment(s) of a given storage configuration. To enable automatic upgrades, specify `autoUpgrade=true`. The default value is `false`. You can enable automatic upgrades for all assignments by specifying `All=true`. Alternatively, you can specify one or more individual assignment `UUIDs` to upgrade specific assignments.

Request

Request Body

SetAssignmentAutoupgradeInputData

The parameters must include: 1. Storage configuration name or ID (`config`). 2. Satellite Location (`controller`). 3. Set the `autoUpgrade` flag to `true` to enable assignments for automatic upgrades. If unspecified, it is assumed to be `false`. 4. Either set `All` to enable/disable automatic upgrades for all the assignments of the storage configuration or provide the `UUIDs` to enable/disable automatic upgrades for a set of assignments.

assignment

object

The assignment value.

all

boolean

The all value.

uuids

Required *

array

The uuids value.

autoUpgrade

boolean

The autoUpgrade value.

config

string

The config value.

controller

string

The controller value.

Response

200 - OK. The assignment(s) is/are enabled/disabled for automatic upgrades.

assignment

object

The assignment value.

autoUpgrade

boolean

The autoUpgrade value.

config

string

The config value.

controller

string

The controller value.

400 - Bad Request. The request failed due to one of the following reasons:

  1. The config name/uuid is missing or the specified config is invalid. To list the storage configurations that you have access to, use the `GET /v2/storage/satellite/getStorageConfigurations` API or run `ibmcloud sat storage config ls`.
  2. Both the parameters `All` and `UUIDs` are provided. Both cannot be provided at the same time.
  3. No assignment(s) provided to enable/disable automatic upgrade. Neither of the parameters `All` and `UUIDs` are provided.
  4. The assignment uuid provided in `UUIDs` parameter is invalid. To list the assignments that you have access to, use the `GET /v2/storage/satellite/getAssignmentsByConfig` API or run `ibmcloud sat storage assignment ls --config config`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The request failed due to one of the following reasons:

  1. The specified config could not be found. To list the storage configurations that you have access to, use the `GET /v2/storage/satellite/getStorageConfigurations` API or run `ibmcloud sat storage config ls`.
  2. The specified assignment could not be found. To list the storage assignments that you have access to, use the `GET /v2/storage/satellite/getAssignments` API or run `ibmcloud sat storage assignment ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a storage request on a cluster

POST /v2/storage/satellite/setDesiredStorageConfig

Create a storage request for a cluster by providing the cluster ID and the required storage specifications. You can only create storage requests for the clusters you have access to.

Request

Request Body

SetDesiredStorageConfigRequest

The configuration details for your Satellite storage request. Include the cluster ID (`cluster`) and the required storage specifications. To list available clusters in the Satellite location, use the `GET /v2/satellite/getClusters` API or run `ibmcloud sat service ls --location=<location-name-or-ID>`. The following storage specifications are supported: 1. Required: a. Volume type. Specify one of `file`, `block` or `object`. b. Provider. Specify one of the supported providers of storage templates. For a list of supported providers or templates, see `https://github.com/IBM/ibm-satellite-storage/blob/develop/config-templates/template_list.json`. c. Maximum volume size and total capacity. Specify a positive integer value. Use `K` for kilobytes, `M` for megabytes, `G` for gigabytes, `T` for terabytes, or `E` for exabytes. Example: `100G`. 2. Optional parameters. a. Offering type. Specify either `sds` for software-defined storage or `non-sds`. b. Volume encryption at rest. This is a boolean value. Specify `true` or `false`. c. Volume availability. This is a boolean value. Specify `true` or `false`. d. Volume expansion. This is a boolean value. Specify `true` or `false`. e. Volume snapshot. This is a boolean value. Specify `true` or `false`. f. Storage classes. Include a list of specific storage classes. Note that currently, requested storage classes are not strictly validated while provisioning storage.

See the following example payload for a storage request that specifies the cluster ID, volume type, offering type, provider, volume availability, volume expansion, volume snap shot, and storage classes: `{"cluster": "c9l508rw0eo68tnbijrg","storage-requests": {"volume-type": "file","offering-type": "sds","provider": "redhat","volume-availability": "regional","volume-expansion": "true","volume-encryption-at-rest": "true","storageclasses": ["gold"],"volume-snapshot": "false","max-volume-size": "100G","total-capacity": "1T"}}`

cluster

string

The cluster value.

storage-requests

DesiredAttributes

DesiredAttributes are various attributes associated with a particular storage request

max-volume-size

string

The max-volume-size value.

offering-type

string

The offering-type value.

provider

string

The provider value.

storageclasses

Required *

array

The storageclasses value.

total-capacity

string

The total-capacity value.

volume-availability

string

The volume-availability value.

volume-encryption-at-rest

string

The volume-encryption-at-rest value.

volume-expansion

string

The volume-expansion value.

volume-snapshot

string

The volume-snapshot value.

volume-type

string

The volume-type value.

Response

201 - OK. The storage request is created.

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Could not find the IBM Cloud Satellite cluster, volume type, available volume, or storage class. Verify the input parameters and try again. To list the Satellite clusters that you have access to and their respective location name or ID, use the `GET /v2/satellite/getClusters` API or run `ibmcloud sat service ls --location=<location-name-or-ID>`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update an assignment

PATCH /v2/storage/satellite/updateAssignment

Update the details of an assignment, such as the name of the assignment, the storage configuration version that it uses, or the cluster group(s) on which you want to apply the configuration. For updating an assignment to the latest available storage configuration version, set the `updateConfigVersion` flag to `true`. If unspecified, it is assumed to be `false`.

Request

Request Body

UpdateSubscriptionInputData

The parameters must include the UUID of the assignment (`uuid`) along with at least one of the following parameters to be updated: 1. One or more cluster groups (`groups`) on which you want to apply the configuration. To list the cluster groups that you have access to, run `ibmcloud sat group ls`. 2. New name of the assignment (`name`). 3. set the `updateConfigVersion` flag to `true` for updating an assignment to the latest available storage configuration version. If unspecified, it is assumed to be `false`. To see if assignment upgrade is available, use the `GET /v2/storage/satellite/getAssignment` API and look for `isAssignmentUpgradeAvailable` field in response or run `ibmcloud sat storage assignment get --assignment UUID` and look for `Assignment Upgrade Available` field in response.

groups

Required *

array

The groups value.

name

string

The name value.

updateConfigVersion

boolean

The updateConfigVersion value.

uuid

string

The uuid value.

Response

200 - OK. The assignment is updated.

editSubscription

UpdateSubscriptionType

Update subscription type

400 - Bad Request. The request failed due to one of the following reasons:

  1. The uuid is missing or the specified uuid is invalid. To list the assignments that you have access to, use the `GET /v2/storage/satellite/getAssignments` API or run `ibmcloud sat storage assignment ls`.
  2. There is no parameter in the request body to update. Input at least one parameter to be updated.
  3. Storage assignment is already up to date with the latest available storage configuration version. Set the `updateConfigVersion` flag to `false` if you want to update at least assignment name or cluster group(s) on which you want to apply the configuration.
  4. Updating an assignment, created for a cluster, to cluster group(s) is not supported. Run `ibmcloud sat storage assignment rm` to remove the assignment and create new assignment with cluster group(s).

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified assignment or cluster group(s) could not be found. To list the storage assignments that you have access to, use the `GET /v2/storage/satellite/getAssignments` API or run `ibmcloud sat storage assignment ls`. To list the Satellite cluster groups you have access to, run `ibmcloud sat group ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Deprecated. To update a Satellite storage configuration, you can use /v2/stor

POST /v2/storage/satellite/updateStorageConfiguration

Update an existing Satellite storage configuration. Note that you cannot update Satellite storage configurations that are currently used in a Satellite storage assignment.

Request

Request Body

StorageConfigUpdateInput

Include the storage template name (`storage-template-name`) and version (`storage-template-version`), the name of the existing storage configuration (`config-name`), the required parameters for the specified template (`user-config-parameters`, `user-secret-parameters`, and `storage-class-parameters`) and the Satellite location (`location`) where you want to use the storage configuration. To list the storage configurations that you have access to, run `ibmcloud sat storage config ls`. To view the storage assignments associated with a given storage configuration, run `ibmcloud sat config get --config=<storage-configuration-name>`. To list the storage templates and template versions, run `ibmcloud sat storage template ls`. To list the parameters for a given storage template and template version, run `ibmcloud sat storage template get --name=<template-name> --version=<template-version>`. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

config-name

string

The config-name value.

controller

string

The controller value.

storage-class-parameters

Required *

array

The storage-class-parameters value.

update-assignments

boolean

The update-assignments value.

user-config-parameters

object

The user-config-parameters value.

user-secret-parameters

object

The user-secret-parameters value.

Response

201 - OK. The storage configuration is updated.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update a Satellite storage configuration

POST /v2/storage/satellite/updateStorageConfigurationByController

Update an existing Satellite storage configuration. If a Satellite storage configuration is already assigned, only the parameters that are marked as `mutable` can be updated.

Request

Request Body

StorageConfigUpdateInput

Include the name of the storage configuration (`config-name`) and the name or ID of the relevant Satellite location (`controller`). To apply the updated storage configuration to this storage configuration's existing assignments, set the `update-assignments` option to `true`. If left unspecified, the `update-assignments` option defaults to `false`.

If the storage configuration is assigned, only the configuration (`user-config-parameters`) and secret (`user-secret-parameters`) parameters that are marked as `mutable` can be updated. If the storage configuration is not assigned, all parameters can be updated.

If user-defined storage classes are supported, specify the required storage class parameters (`storage-class-parameters`) for the template that the storage configuration was created from. Note that any existing user-defined storage classes are overwritten by any storage classes specified in this API request's payload. For example, if you intend to define new storage classes and keep the existing storage classes, you must specify the parameters for both the existing and new user-defined storage classes.

To list the storage configurations that you have access to, run `ibmcloud sat storage config ls`. To view the storage assignments associated with a given storage configuration, run `ibmcloud sat config get --config=<storage-configuration-name>`. To list the parameters for a given storage template and template version, run `ibmcloud sat storage template get --name=<template-name> --version=<template-version>`. To list the parameters of existing storage classes, run `ibmcloud sat storage config class ls --config=<storage-configuration-name> --show-params`. To list the Satellite locations that you have access to, run `ibmcloud sat location ls`.

config-name

string

The config-name value.

controller

string

The controller value.

storage-class-parameters

Required *

array

The storage-class-parameters value.

update-assignments

boolean

The update-assignments value.

user-config-parameters

object

The user-config-parameters value.

user-secret-parameters

object

The user-secret-parameters value.

Response

201 - OK. The storage configuration is updated.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update a Satellite storage configuration to use the latest template revision

PATCH /v2/storage/satellite/updateStorageConfigurationRevision

Update a Satellite storage configuration to use the latest template revision and optionally update assignment(s) based on the specified storage configuration. To check if a new template revision is available, view the 'getStorageConfiguration' API response for the storage configuration you want to update and compare your current template revision (`revision`) with the latest template revision (`latest-revision`). To update assignment(s) of the specified storage configuration, set the update assignments (`updateAssignments`) flag to `true`. By default, the flag is set to `false` if not specified and, assignment(s) are not updated as part of the template revision update operation.

Request

Path Parameters

Query Parameters

config

Required *

string

The name or UUID of the storage configuration. To list the storage configurations that you have access to, run `ibmcloud sat storage config ls`.

controller

Required *

string

The name or ID of the Satellite location. To list the Satellite locations that you have access to, use the `GET /v2/satellite/getControllers` API or run `ibmcloud sat location ls`.

update_assignments

boolean

Specify `true` or `false` to update assignment(s) of the specified storage configuration. The default value is `false`.

Response

201 - OK. Updated storage configuration template to latest revision.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. Your IAM token could not be verified. Make sure that you are logged in to IBM Cloud, and then run `ibmcloud iam oauth-tokens` to retrieve your access tokens.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

406 - Storage configuration template is already up to date with the latest revision.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact the IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Update the version of the Kubernetes cluster master node

POST /v2/updateMaster

Update the Kubernetes master to the default API version. During the update, you cannot access or change the cluster. Worker nodes, apps, and resources that have been deployed by the user are not modified and will continue to run. You might need to change your YAML files for future deployments. For details, see the release notes at https://cloud.ibm.com/docs/containers?topic=containers-cs_versions

Request

Request Body

UpdateMaster

Input parameters to specify the name or ID of the cluster, what version to update the master to, and whether to force the update. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

cluster

string

The cluster value.

force

boolean

The force value.

version

string

The version value.

Path Parameters

Query Parameters

Response

204 - Ok. The request to update your master node was successfully processed.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The cluster cannot be updated. The master is more than two versions behind the targeted version, which is not supported. Instead, update to a supported version two or less ahead of the current version, or create a new cluster at the targeted version.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. The specified value is already set on the cluster. To list the clusters properties, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a VPC cluster

POST /v2/vpc/createCluster

Create a cluster in a Virtual Private Cloud (VPC) that you have access to. Note: This API method requires Administrator platform role for IBM Cloud Kubernetes Service at the account level, as well as access to several other services such as the underlying infrastructure provider. For more information, see 'https://ibm.biz/cluster-perms'.

Request

Request Body

VPCCreateCluster

Input parameter to add a cluster. For more information, see https://ibm.biz/cluster_create_docs

cosInstanceCRN

string

The cosInstanceCRN value.

cseACLEnabled

boolean

The cseACLEnabled value.

defaultWorkerPoolEntitlement

string

The defaultWorkerPoolEntitlement value.

disableOutboundTrafficProtection

boolean

The disableOutboundTrafficProtection value.

disablePublicServiceEndpoint

boolean

The disablePublicServiceEndpoint value.

infrastructureTopology

string

The infrastructureTopology value.

kubeVersion

string

The kubeVersion value.

name

string

The name value.

networkPlugin

string

The networkPlugin value.

offering

string

The offering value.

podSubnet

string

The podSubnet value.

previews

Required *

array

The previews value.

provider

string

The provider value.

requestSecure

boolean

The requestSecure value.

securityGroupIDs

Required *

array

The securityGroupIDs value.

serviceSubnet

string

The serviceSubnet value.

trustedProfileID

string

The trustedProfileID value.

workerPool

VPCCreateClusterWorkerPool

VPCCreateClusterWorkerPool is the vpc version of the worker pool part of a create cluster request.

diskEncryption

boolean

The diskEncryption value.

flavor

string

The flavor value.

hostPoolID

string

The hostPoolID value.

isolation

string

The isolation value.

labels

object

The labels value.

name

string

The name value.

operatingSystem

string

The operatingSystem value.

secondaryStorageOption

string

The secondaryStorageOption value.

vpcID

string

The vpcID value.

workerCount

integer

The workerCount value.

workerVolumeEncryption

object

WorkerVolumeEncryption contains encryption related fields

zones

Required *

array

The zones value.

Path Parameters

Query Parameters

Response

201 - Created. The cluster was successfully created in the IBM Cloud account that you are logged in to.

clusterID

string

The clusterID value.

messages

array

The messages value.

non_critical_errors

ResponseErrors

ResponseErrors are used to communicate to non-critical errors to end users

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions for the specified VPC infrastructure provider.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. A cluster with the same name already exists. Choose another name for your cluster.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a worker pool for a VPC cluster

POST /v2/vpc/createWorkerPool

Create a worker pool for the specified VPC cluster. Creating a worker pool requires Operator access to Kubernetes Service in the IBM Cloud account.

Request

Request Body

V2VpcCreateWorkerPoolRequest

The

Zones

Required *

array

The Zones value.

cluster

string

The cluster value.

diskEncryption

boolean

The diskEncryption value.

entitlement

string

The entitlement value.

flavor

string

The flavor value.

hostPool

string

The hostPool value.

isolation

string

The isolation value.

labels

object

The labels value.

name

string

The name value.

operatingSystem

string

The operatingSystem value.

secondaryStorageOption

string

The secondaryStorageOption value.

securityGroupIDs

Required *

array

The securityGroupIDs value.

vpcID

string

The vpcID value.

workerCount

integer

The workerCount value.

workerVolumeEncryption

WorkerVolumeEncryption

WorkerVolumeEncryption contains encryption related fields

kmsAccountID

string

The kmsAccountID value.

kmsInstanceID

string

The kmsInstanceID value.

workerVolumeCRKID

string

The workerVolumeCRKID value.

Path Parameters

Query Parameters

Response

201 - Created. The worker pool was successfully created in for the specified cluster.

workerPoolID

string

The workerPoolID value.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. A worker pool create may already be in progress for the provided cluster. Please wait a few minutes and try again.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Create a zone in the specified worker pool for a VPC cluster

POST /v2/vpc/createWorkerPoolZone

Create a zone in the specified worker pool for a VPC cluster. Workers will be provisioned in each provided zone based on the size of the pool.

Request

Request Body

CreateWorkerpoolZoneRequest

Input parameters to add zones to the worker pool.

cluster

string

The cluster value.

id

Required *

string

The id value.

subnetID

string

The subnetID value.

workerpool

string

The workerpool value.

Path Parameters

Query Parameters

Response

201 - OK. The requested zone has been added to the worker pool.

400 - Bad request. The input parameters in the request body are either incomplete or in the wrong format. Be sure to include all required parameters in your request in JSON format.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified worker pool could not be found. To list all worker pools for a cluster, use the `GET /v1/clusters/{idOrName}/workerpools` API or run `ibmcloud ks worker-pool ls mycluster`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

409 - Conflict. The provided zone already exists in the worker pool.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and your cluster ID, and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Get details of a VPC cluster

GET /v2/vpc/getCluster

Get details of a VPC cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

show_resources

string

To view additional cluster resources like addons, VLANs, subnets, and storage, pass `true`.

Response

200 - Success. Detailed cluster information.

addons

array

The addons value.

caCertRotationStatus

CommonClusterCACertRotation

CommonClusterCACertRotation CA cert rotation properties

calicoIPAutodetectionConfig

string

The calicoIPAutodetectionConfig value.

createdDate

string

The createdDate value.

crn

string

The crn value.

datacenter

string

The datacenter value.

desiredTrustedProfileID

string

The desiredTrustedProfileID value.

disableAutoUpdate

boolean

The disableAutoUpdate value.

entitlement

string

The entitlement value.

etcdPort

string

The etcdPort value.

features

CommonClusterFeatures

Common cluster features

id

string

The id value.

ignitionServerURL

string

The ignitionServerURL value.

imageSecurityEnabled

boolean

The imageSecurityEnabled value.

infrastructureTopology

string

The infrastructureTopology value.

ingress

CommonClusterIngress

Common cluster ingress

isPaid

boolean

The isPaid value.

keyManagementService

CommonClusterKMS

Common clusterkms

konnectivityServerURL

string

The konnectivityServerURL value.

lifecycle

CommonClusterLifecycle

Common cluster lifecycle

location

string

The location value.

locationEndpointURL

string

The locationEndpointURL value.

locationZones

array

The locationZones value.

masterKubeVersion

string

The masterKubeVersion value.

masterURL

string

The masterURL value.

multiAzCapable

boolean

The multiAzCapable value.

name

string

The name value.

networkPlugin

string

The networkPlugin value.

oauthServerURL

string

The oauthServerURL value.

offering

string

The offering value.

outboundTrafficProtection

string

The outboundTrafficProtection value.

podSubnet

string

The podSubnet value.

provider

string

The provider value.

region

string

The region value.

resourceGroup

string

The resourceGroup value.

resourceGroupName

string

The resourceGroupName value.

satellitePrivateEndpointURL

string

The satellitePrivateEndpointURL value.

secureByDefault

string

The secureByDefault value.

secureRequested

boolean

The secureRequested value.

serviceEndpoints

CommonClusterServiceEndpoint

Common cluster service endpoint

serviceSubnet

string

The serviceSubnet value.

state

string

The lifecycle state of the cluster. Possible values include aborted, critical, delete_failed, deleted, deleting, deploy_failed, deploying, normal, pending, requested, updating, unsupported, and warning. For more information, see the docs 'http://ibm.biz/cluster-health-states'

status

string

The status value.

supportedOperatingSystems

array

The supportedOperatingSystems value.

targetVersion

string

The targetVersion value.

trustedProfileID

string

The trustedProfileID value.

type

string

The type value.

versionEOS

string

The versionEOS value.

virtualPrivateEndpointURL

string

The virtualPrivateEndpointURL value.

vpcs

array

The vpcs value.

workerCount

integer

The workerCount value.

workerZones

array

The workerZones value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the VPC clusters that you have access to

GET /v2/vpc/getClusters

List the VPC clusters that you have access to.

Request

Path Parameters

Query Parameters

location

string

Specify a location to filter clusters for. To see supported locations, use the `GET /v1/locations` API or run `ibmcloud ks locations`.

provider

string

The name of the provider to filter the clusters by.

Response

200 - Success. A list of clusters that you have access to is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View subnets for a given VPC

GET /v2/vpc/getSubnets

View details for subnets in a VPC for the given region and provider.

Request

Path Parameters

Query Parameters

provider

Required *

string

The name of the VPC provider.

zone

Required *

string

The name of the zone in which to list subnets.

vpc

Required *

string

The ID of the VPC.

Response

200 - Ok. A list of all subnets for the given VPC is returned.

400 - Bad Request. The given provider, zone, or VPC is invalid.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions for the specified VPC infrastructure provider.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of a VPC

GET /v2/vpc/getVPC

View details of a virtual private cloud (VPC).

Request

Path Parameters

Query Parameters

provider

Required *

string

The name of the infrastructure provider that the VPC is created in. To list infrastructure providers of a VPC, run `ibmcloud ks vpcs` or use the `GET /v2/vpc/getVPCs` API.

vpc_id

Required *

string

The ID of the VPC. To list the ID of a VPC, run `ibmcloud ks vpcs` or use the `GET /v2/vpc/getVPCs` API.

Response

200 - OK. Details of the specified VPC are returned.

id

string

The id value.

messages

array

The messages value.

name

string

The name value.

resourceGroup

string

The resourceGroup value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions for the specified VPC infrastructure provider.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View VPCs for the given provider

GET /v2/vpc/getVPCs

View details for all VPCs in the given provider

Request

Path Parameters

Query Parameters

provider

Required *

string

The name of the provider in which to list VPCs.

Response

200 - Ok. A list of all VPCs is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

403 - Forbidden. The credentials set for the region and resource group have insufficient permissions for the specified VPC infrastructure provider.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of a worker node for VPC cluster

GET /v2/vpc/getWorker

View detailed information for a worker node in a VPC cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

worker

Required *

string

The ID of the worker node that you want details for. To list all worker nodes for a cluster, use the `GET /v1/clusters/{idOrName}/workers` API or run `ibmcloud ks worker ls --cluster <cluster_name_or_ID>`.

Response

200 - Ok. Detailed information about the worker node is returned.

dedicatedHostId

string

The dedicatedHostId value.

dedicatedHostPoolId

string

The dedicatedHostPoolId value.

flavor

string

The flavor value.

health

GetWorkerResponseHealth

Get worker response health

id

string

The id value.

kubeVersion

GetWorkerResponseKubeVersion

Get worker response kube version

lifecycle

GetWorkerResponseLifecycle

Get worker response lifecycle

location

string

The location value.

networkInterfaces

GetWorkerResponseNetworkInterfaces

Get worker response network interfaces

poolID

string

The poolID value.

poolName

string

The poolName value.

provider

string

The provider value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View details of a worker pool for a VPC cluster

GET /v2/vpc/getWorkerPool

View detailed information for a worker pool in a VPC cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

workerpool

Required *

string

The ID of the worker pool that you want details for. To list all worker pools for a cluster, use the `GET /v1/clusters/{idOrName}/workerpools` API or run `ibmcloud ks worker-pool ls --cluster <cluster_name_or_ID>`.

Response

200 - Ok. Detailed information about the worker pool is returned.

autoscaleEnabled

boolean

The autoscaleEnabled value.

dedicatedHostPoolId

string

The dedicatedHostPoolId value.

flavor

string

The flavor value.

flavorState

string

The flavorState value.

hostLabels

object

The hostLabels value.

id

string

The id value.

isBalanced

boolean

The isBalanced value.

isolation

string

The isolation value.

labels

object

The labels value.

lifecycle

GetWorkerPoolResponseLifecycle

Get worker pool response lifecycle

openshiftLicense

string

The openshiftLicense value.

operatingSystem

string

The operatingSystem value.

poolName

string

The poolName value.

provider

string

The provider value.

secondaryStorageOption

DiskConfigResp

DiskConfigResp response type for describing a disk configuration

staticNetworkInterfaceCount

integer

The staticNetworkInterfaceCount value.

taints

object

The taints value.

vpcID

string

The vpcID value.

workerCount

integer

The workerCount value.

workerVolumeEncryption

WorkerVolumeEncryption

WorkerVolumeEncryption contains encryption related fields

zones

array

The zones value.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List the worker pools in a VPC cluster

GET /v2/vpc/getWorkerPools

List the worker pools in a VPC cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

Response

200 - Ok. Detailed information about the worker pools is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

View all workers for VPC cluster

GET /v2/vpc/getWorkers

View detailed information for all worker nodes in a VPC cluster.

Request

Path Parameters

Query Parameters

cluster

Required *

string

The name or ID of the cluster that you want to get the worker node details from. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

show_deleted

string

true|false Shows deleted workers

pool

string

The name or ID of the worker pool to filter results for. Run `ibmcloud ks worker-pool ls --cluster <cluster name>`.

Response

200 - Ok. Details for all workers in the VPC cluster.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster could not be found. To list the clusters that you have access to, use the `GET /v1/clusters` API or run `ibmcloud ks cluster ls`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

List available zones in a region

GET /v2/vpc/getZones

List available zones that you can use to create a cluster in an IBM Cloud Kubernetes Service region.

Request

Path Parameters

Query Parameters

provider

string

The provider for which to list zones. Defaults to vpc-classic.

show_flavors

boolean

Determines whether to show the flavors for the returned zones.

Response

200 - Success. A list of available zones for a region is returned.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - No zones found for provider. Run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

Replace a worker node with a new worker node

POST /v2/vpc/replaceWorker

Delete the specified worker node from the cluster and provision a new worker node to replace the deleted worker node. You might replace a worker node if you cannot reload it, such as if it enters a troubled state. You can also replace the worker node to include an update to the same major and minor version of the master. The replacement worker node is created in the same zone, same worker pool, and with the same flavor as the deleted worker node. However, the replacement worker node is assigned a new private IP address, and loses any custom labels that you applied to the old worker node (worker pool labels are still applied to the replacement worker node). Before you replace the worker node, consider adding more worker nodes to the cluster and draining the worker node to help avoid downtime for your apps.

Request

Request Body

ReplaceWorkerRequest

Input parameters to replace a worker node. The cluster and worker node ID parameters are required. The update parameter is optional. To update the worker node to the same major and minor version as the master, set “update” to true.

cluster

string

The cluster value.

update

boolean

The update value.

workerID

string

The workerID value.

Path Parameters

Query Parameters

Response

204 - OK. The worker node is being removed and replaced with a new worker node.

401 - Unauthorized. The IAM token is invalid or expired. To retrieve your IAM token, run `ibmcloud login` and then `ibmcloud iam oauth-tokens`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

404 - Not found. The specified cluster or worker could not be found. To list the clusters that you have access to, use the `GET /vpc/v2/clusters` API or run `ibmcloud ks cluster ls --provider vpc-classic`.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type

500 - Internal Server Error. IBM Cloud Kubernetes Service is currently unavailable. Your request could not be processed. Please wait a few minutes and try again. If you still encounter this problem, note the incident ID and contact IBM Cloud support.

code

string

The code value.

description

string

The description value.

incidentID

string

The incidentID value.

recoveryCLI

string

The recoveryCLI value.

terseDescription

string

The terseDescription value.

type

string

ErrorType error type