Containers

List K8S Container

GEThttps://api.cegedim.cloud/itcare/compute/containers/kubernetes

Query parameters

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

totalElementsinteger (int64)

totalPagesinteger (int32)

firstboolean

sizeinteger (int32)

contentarray of K8sContainerV1 (object)

numberinteger (int32)

sortarray of SortObject (object)

pageablePageableObject (object)

numberOfElementsinteger (int32)

lastboolean

emptyboolean

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/compute/containers/kubernetes', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "totalElements": 0,
  "totalPages": 0,
  "first": false,
  "size": 0,
  "content": [
    {
      "id": 0,
      "name": "text",
      "type": "text",
      "internalType": "text",
      "status": "text",
      "category": "text",
      "technology": "text",
      "family": "text",
      "label": "text",
      "comment": "text",
      "productCode": "text",
      "productName": "text",
      "productVersion": "text",
      "cloudId": 0,
      "cloudName": "text",
      "serviceId": 0,
      "serviceName": "text",
      "serviceKey": "text",
      "environment": "text",
      "endOfSupportAt": "2025-01-02T14:35:00.561Z",
      "supportPhase": "text",
      "creationUser": "text",
      "creationTime": "text",
      "releasedAt": "2025-01-02T14:35:00.561Z",
      "endOfSalesAt": "2025-01-02T14:35:00.561Z",
      "extendedSupportAt": "2025-01-02T14:35:00.561Z",
      "monitoringEnabled": false,
      "monitoringAlerting": false,
      "monitoringOnCallEnabled": false,
      "monitoringRequested": false,
      "replicationStatus": false,
      "backupStatus": false,
      "patchParty": {
        "excluded": false,
        "exclusionReason": "text",
        "patchGroup": "text",
        "patchDate": "2025-01-02T14:35:00.561Z",
        "patchTag": "text",
        "name": "text",
        "id": 0,
        "excludedBy": "text",
        "exclusionDate": "2025-01-02T14:35:00.561Z"
      },
      "metrologyUrl": "text",
      "path": "text",
      "resourceType": "text",
      "internalResourceId": 0,
      "backupPolicyDetails": {
        "backups": [
          {
            "id": 0,
            "type": "text",
            "backupSize": 0,
            "backupLastDate": "2025-01-02T14:35:00.561Z"
          }
        ],
        "policies": [
          {
            "name": "text",
            "label": "text",
            "scope": "text",
            "type": "text",
            "replication": false,
            "durationInHours": 0,
            "startTime": "text",
            "timezone": "text",
            "policyId": "text",
            "backupLastDate": "2025-01-02T14:35:00.561Z",
            "backupSize": 0
          }
        ]
      },
      "nodeCount": 0,
      "topology": "text",
      "version": "text",
      "versionDetailed": "text",
      "managementUrl": "text",
      "technicalId": "text",
      "labelAreaList": [
        "text"
      ],
      "labelRegion": "text",
      "availableAZs": [
        "text"
      ],
      "availableDCs": [
        "text"
      ],
      "supportsHAMode": false,
      "allowMonitoringDisplay": false,
      "ingressProvider": "NGINX"
    }
  ],
  "number": 0,
  "sort": [
    {
      "direction": "text",
      "nullHandling": "text",
      "ascending": false,
      "property": "text",
      "ignoreCase": false
    }
  ],
  "pageable": {
    "offset": 0,
    "sort": [
      {
        "direction": "text",
        "nullHandling": "text",
        "ascending": false,
        "property": "text",
        "ignoreCase": false
      }
    ],
    "pageSize": 0,
    "pageNumber": 0,
    "paged": false,
    "unpaged": false
  },
  "numberOfElements": 0,
  "last": false,
  "empty": false
}

Create K8s Cluster

This method allows to create a cluster.

You will have to know at the minimum :

• where you want to host your cluster (area attribute)
• which network is used (networkId attribute)
• name of cluster (name attribute)
• sizing of cluster (nodeSizing attribute)
• number of nodes instances of your cluster (instanceCount attribute)
• service in which you want to put your cluster (serviceId attribute)

This method is asynchronous (status code 202) and you'll have to wait for async action to be completed by checking its status.

POST /clusters
{
	"name": "PCLUSTER01",
	"area": "EB",
	"networkId": "ED145",
	"serviceId": 123,
	"nodeSizing":, "1cpu2gb"
	"instanceCount": 2
}

POSThttps://api.cegedim.cloud/itcare/compute/containers/kubernetes

Body

application/vnd.cegedim-it.v1+json

serviceId*integer (int64)

id of service to put instance in.

regulationstring

Regulation. Refer to the regulation of the Area (HDS|STANDARD). If absent, default 'STANDARD' will be used.

region*string

Region. that is a low-latency network area, available in List Regions method. If absent, default Area of Region will be used.

cloudIdinteger (int64)

monitoringEnabledboolean

Indicates if monitoring will be setup. If absent, it will be automatically be setup if this is an production environment, or if backup is enabled.

noMonitoringProdReasonstring

Indicates why a production resource is not under monitoring.

onCallSupervisionboolean

Indicates if on call teams will be called on non business hours if an incident occurs on instance. If absent, set to false.

monitoringAlertingboolean

Indicates if alerting should be activated. If absent, set to false.

backupEnabledboolean

Indicates if backup has to be setup on instance. If absent, backup will be setup automatically if instance is in a production service.

noBackupProdReasonstring

Indicates why a production resource is not under backup.

replicationEnabledboolean

Indicates if replication will be setup. If absent, it will be automatically be setup if this is an production environment

noReplicationProdReasonstring

Indicates why a production resource is not replicated.

serverBackupPolicyIdstring

BackupPolicy id. Refers to desired backup policy to be applied for the virtual machine, must be set when backup is enabled.

dbBackupPolicyIdstring

BackupPolicy id. Refers to desired backup policy to be applied for the database, must be set when backup is enabled.

area*string

Area. Refer to an Area of a Region, that is a low-latency network area, available in List Regions method. If absent, default Area of Region will be used.

nodeSizing*string

Node sizing for cluster

networkId*integer (int64)

The network Id of the ELS cluster

platform*string

Product platform of the cluster

name*string

Name of k8s cluster

Pattern: [a-z0-9\-]+

instanceCount*integer (int32)

Number of instances to create in k8s cluster

ingressProvider*enum

Kubernetes Container Ingress Providers

NGINXISTIOTRAEFIKNGINX,ISTIO,TRAEFIK

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

processstring

Code of action performed

statusenum

Status label of action

SUCCESS,IN_PROGRESS,ERROR

messagestring

Human readable message of status

idinteger (int32)

internalIdinteger (int64)

resourceNamestring

resourceTypestring

familystring

lastUpdatedAtstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/compute/containers/kubernetes', {
    method: 'POST',
    headers: {
      "Content-Type": "application/vnd.cegedim-it.v1+json"
    },
    body: JSON.stringify({
      "area": "text",
      "ingressProvider": "NGINX",
      "instanceCount": 0,
      "name": "text",
      "networkId": 0,
      "nodeSizing": "text",
      "platform": "text",
      "region": "text",
      "serviceId": 0
    }),
});
const data = await response.json();

Response

200

{
  "process": "text",
  "status": "SUCCESS,IN_PROGRESS,ERROR",
  "message": "text",
  "id": 0,
  "internalId": 0,
  "resourceName": "text",
  "resourceType": "text",
  "family": "text",
  "lastUpdatedAt": "2025-01-02T14:35:00.561Z"
}

Get K8s Container loadbalancer list.

GEThttps://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}/loadbalancers

Path parameters

id*integer (int64)

K8sCluster Id, example: 123

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

idinteger (int64)

namestring

typestring

internalTypestring

statusstring

categorystring

technologystring

familystring

labelstring

commentstring

productCodestring

productNamestring

productVersionstring

cloudIdinteger (int64)

cloudNamestring

serviceIdinteger (int64)

serviceNamestring

serviceKeystring

environmentstring

endOfSupportAtstring (date-time)

supportPhasestring

creationUserstring

creationTimestring

releasedAtstring (date-time)

endOfSalesAtstring (date-time)

extendedSupportAtstring (date-time)

monitoringEnabledboolean

monitoringAlertingboolean

monitoringOnCallEnabledboolean

monitoringRequestedboolean

replicationStatusboolean

backupStatusboolean

patchPartyPatchPartyV1 (object)

Representation of a resource patch party

metrologyUrlstring

pathstring

resourceTypestring

internalResourceIdinteger (int64)

backupPolicyDetailsBackupPolicyDetailsV1 (object)

ipAddressstring

nodeCountinteger (int64)

networkNetworkV1 (object)

urlsarray of URL (object)

urls of the load balancer

membersarray of InstanceV1 (object)

Instances that are load balanced by this loadbalancer

protocolsarray of Protocol (object)

Protocols on which this loadbalancer expose a virtual service

irulesarray of Irule (object)

iRules configured for this loadbalancer

healthChecksarray of HealthCheckV1 (object)

Healthchecks configured for this loadbalancer

certificateCertificateV1 (object)

defaultPersistencestring

Advanced property such as default persistence

fallbackPersistencestring

Advanced property such as fallback persistence

loadBalancingModestring

Advanced property such as load balancing mode

botDefenseEnabledboolean

Bot Defense state

botDefenseUpdatingboolean

Bot Defense is updating

securityProfileSecurityProfileV1 (object)

snatAutomapboolean

Source addresse translation automap enabled

parentResourceServiceResourceBaseV1 (object)

Holds common properties to all Resources managed in ITCare available on a Service

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}/loadbalancers', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": 0,
    "name": "text",
    "type": "text",
    "internalType": "text",
    "status": "text",
    "category": "text",
    "technology": "text",
    "family": "text",
    "label": "text",
    "comment": "text",
    "productCode": "text",
    "productName": "text",
    "productVersion": "text",
    "cloudId": 0,
    "cloudName": "text",
    "serviceId": 0,
    "serviceName": "text",
    "serviceKey": "text",
    "environment": "text",
    "endOfSupportAt": "2025-01-02T14:35:00.561Z",
    "supportPhase": "text",
    "creationUser": "text",
    "creationTime": "text",
    "releasedAt": "2025-01-02T14:35:00.561Z",
    "endOfSalesAt": "2025-01-02T14:35:00.561Z",
    "extendedSupportAt": "2025-01-02T14:35:00.561Z",
    "monitoringEnabled": false,
    "monitoringAlerting": false,
    "monitoringOnCallEnabled": false,
    "monitoringRequested": false,
    "replicationStatus": false,
    "backupStatus": false,
    "patchParty": {
      "excluded": false,
      "exclusionReason": "text",
      "patchGroup": "text",
      "patchDate": "2025-01-02T14:35:00.561Z",
      "patchTag": "text",
      "name": "text",
      "id": 0,
      "excludedBy": "text",
      "exclusionDate": "2025-01-02T14:35:00.561Z"
    },
    "metrologyUrl": "text",
    "path": "text",
    "resourceType": "text",
    "internalResourceId": 0,
    "backupPolicyDetails": {
      "backups": [
        {
          "id": 0,
          "type": "text",
          "backupSize": 0,
          "backupLastDate": "2025-01-02T14:35:00.561Z"
        }
      ],
      "policies": [
        {
          "name": "text",
          "label": "text",
          "scope": "text",
          "type": "text",
          "replication": false,
          "durationInHours": 0,
          "startTime": "text",
          "timezone": "text",
          "policyId": "text",
          "backupLastDate": "2025-01-02T14:35:00.561Z",
          "backupSize": 0
        }
      ]
    },
    "ipAddress": "text",
    "nodeCount": 0,
    "network": {
      "id": 0,
      "technicalId": "text",
      "cidr": "text",
      "description": "text",
      "scope": "text",
      "defaultNetwork": false,
      "usedPercent": 0,
      "ipFreeNumber": 0,
      "ipAddress": "text",
      "dns": [
        {
          "alias": "text",
          "domain": "text"
        }
      ],
      "mask": "text",
      "networkShortDescription": "text",
      "isIpRangePublic": false,
      "cloud": "text",
      "environment": "text",
      "shortDescription": "text",
      "gateway": "text",
      "region": "text",
      "area": "text"
    },
    "urls": [
      {
        "id": 0,
        "name": "text",
        "type": "text",
        "serviceId": 0,
        "serviceName": "text",
        "serviceKey": "text",
        "environment": "text",
        "creationUser": "text",
        "creationTime": "text",
        "description": "text",
        "comment": "text",
        "releasedAt": "2025-01-02T14:35:00.561Z",
        "endOfSalesAt": "2025-01-02T14:35:00.561Z",
        "extendedSupportAt": "2025-01-02T14:35:00.561Z",
        "endOfSupportAt": "2025-01-02T14:35:00.561Z",
        "supportPhase": "text",
        "tags": [
          {
            "tagKey": "text",
            "tagValue": "text"
          }
        ],
        "status": "text",
        "monitoringEnabled": false,
        "monitoringAlerting": false,
        "monitoringOnCallEnabled": false,
        "monitoringMode": "text",
        "specificChecks": [
          {
            "name": "text",
            "parameter": {
              "path": "text",
              "prefix": "text",
              "authentification": {
                "user": "text",
                "password": "text"
              },
              "protocol": "text",
              "port": 0,
              "method": "text",
              "criticalStatus": "text",
              "warningContent": "text",
              "criticalContent": "text",
              "expectedContent": "text",
              "parameters": [
                {
                  "key": "text",
                  "value": "text"
                }
              ],
              "headers": [
                {
                  "key": "text",
                  "value": "text"
                }
              ]
            }
          }
        ]
      }
    ],
    "members": [
      {
        "id": 0,
        "name": "text",
        "type": "text",
        "internalType": "text",
        "status": "text",
        "category": "text",
        "technology": "text",
        "family": "text",
        "label": "text",
        "comment": "text",
        "productCode": "text",
        "productName": "text",
        "productVersion": "text",
        "cloudId": 0,
        "cloudName": "text",
        "serviceId": 0,
        "serviceName": "text",
        "serviceKey": "text",
        "environment": "text",
        "endOfSupportAt": "2025-01-02T14:35:00.561Z",
        "supportPhase": "text",
        "creationUser": "text",
        "creationTime": "text",
        "releasedAt": "2025-01-02T14:35:00.561Z",
        "endOfSalesAt": "2025-01-02T14:35:00.561Z",
        "extendedSupportAt": "2025-01-02T14:35:00.561Z",
        "monitoringEnabled": false,
        "monitoringAlerting": false,
        "monitoringOnCallEnabled": false,
        "monitoringRequested": false,
        "replicationStatus": false,
        "backupStatus": false,
        "patchParty": {
          "excluded": false,
          "exclusionReason": "text",
          "patchGroup": "text",
          "patchDate": "2025-01-02T14:35:00.561Z",
          "patchTag": "text",
          "name": "text",
          "id": 0,
          "excludedBy": "text",
          "exclusionDate": "2025-01-02T14:35:00.561Z"
        },
        "metrologyUrl": "text",
        "path": "text",
        "resourceType": "text",
        "internalResourceId": 0,
        "backupPolicyDetails": {
          "backups": [
            {
              "id": 0,
              "type": "text",
              "backupSize": 0,
              "backupLastDate": "2025-01-02T14:35:00.561Z"
            }
          ],
          "policies": [
            {
              "name": "text",
              "label": "text",
              "scope": "text",
              "type": "text",
              "replication": false,
              "durationInHours": 0,
              "startTime": "text",
              "timezone": "text",
              "policyId": "text",
              "backupLastDate": "2025-01-02T14:35:00.561Z",
              "backupSize": 0
            }
          ]
        },
        "ipAddress": "text",
        "network": {
          "id": 0,
          "technicalId": "text",
          "cidr": "text",
          "description": "text",
          "scope": "text",
          "defaultNetwork": false,
          "usedPercent": 0,
          "ipFreeNumber": 0,
          "ipAddress": "text",
          "dns": [
            {
              "alias": "text",
              "domain": "text"
            }
          ],
          "mask": "text",
          "networkShortDescription": "text",
          "isIpRangePublic": false,
          "cloud": "text",
          "environment": "text",
          "shortDescription": "text",
          "gateway": "text",
          "region": "text",
          "area": "text"
        },
        "storageInformation": {
          "totalSizeDisks": 0,
          "fileSystems": [
            {
              "mountingPoint": "text",
              "type": "text",
              "sizeOf": 0,
              "free": 0
            }
          ],
          "totalSizeFileSystems": 0
        },
        "availabilityZone": {
          "id": "text",
          "location": "text",
          "routable": false,
          "defaultZone": false,
          "datacenterId": "text",
          "availabilityZoneGroup": "text"
        },
        "area": {
          "id": "text",
          "location": "text",
          "regulation": "text",
          "defaultArea": false,
          "availabilityZones": [
            {
              "id": "text",
              "location": "text",
              "routable": false,
              "defaultZone": false,
              "datacenterId": "text",
              "availabilityZoneGroup": "text"
            }
          ]
        },
        "region": {
          "id": "text",
          "location": "text",
          "areas": [
            {
              "id": "text",
              "location": "text",
              "regulation": "text",
              "defaultArea": false,
              "availabilityZones": [
                {
                  "id": "text",
                  "location": "text",
                  "routable": false,
                  "defaultZone": false,
                  "datacenterId": "text",
                  "availabilityZoneGroup": "text"
                }
              ]
            }
          ],
          "dataCenter": "text"
        },
        "backup": {
          "backupSystem": "text",
          "size": 0,
          "type": "text",
          "filesNb": 0,
          "lastDate": "2025-01-02T14:35:00.561Z"
        },
        "replication": {
          "storageClass": "text",
          "storageReplicationClass": "text",
          "storageClassOverride": "text",
          "storageMoveInProgress": false,
          "storageMoveTicket": "text",
          "noStoRplExplanation": "text"
        },
        "snapshot": {
          "id": "text",
          "label": "text",
          "createdBy": "text",
          "createdAt": "2025-01-02T14:35:00.561Z",
          "recoveredAt": "2025-01-02T14:35:00.561Z",
          "expiresAt": "2025-01-02T14:35:00.561Z",
          "description": "text",
          "changeReference": "text",
          "snapshotSize": 0
        },
        "labelRegion": "text",
        "labelDataCenter": "text",
        "labelArea": "text",
        "labelAvailabilityZone": "text",
        "totalSizeDisks": "text",
        "cpu": 0,
        "ram": 0,
        "storage": 0,
        "isMemberOFLoadBalancer": false,
        "loadbalancers": [
          {
            "id": 0,
            "name": "text",
            "status": "text",
            "monitoringEnabled": false,
            "memberCount": 0,
            "serviceId": 0
          }
        ],
        "imageCode": "text",
        "osName": "text",
        "osType": "text",
        "isExternalIngressNode": false,
        "isInternalIngressNode": false,
        "storageMoveInProgress": false,
        "authenticationDomain": "text",
        "parentResourceType": "text"
      }
    ],
    "protocols": [
      {
        "protocol": "text",
        "port": 0,
        "name": "text",
        "comment": "text",
        "isCertificateRequired": false,
        "persistence": false,
        "redirectToHttps": false,
        "profilePersistenceOnly": "text",
        "profileNoPersistenceOnly": "text",
        "profilePersistenceRedirect": "text",
        "profileNoPersistenceNoRedirect": "text",
        "profilePersistenceNoRedirect": "text",
        "profileNoPersistenceRedirect": "text",
        "order": 0
      }
    ],
    "irules": [
      {
        "name": "text",
        "description": "text"
      }
    ],
    "healthChecks": [
      {
        "id": 0,
        "name": "text",
        "description": "text",
        "comment": "text"
      }
    ],
    "certificate": {
      "id": 0,
      "certificateName": "text",
      "commonName": "text",
      "description": "text",
      "expirationDate": "text"
    },
    "defaultPersistence": "text",
    "fallbackPersistence": "text",
    "loadBalancingMode": "text",
    "botDefenseEnabled": false,
    "botDefenseUpdating": false,
    "securityProfile": {
      "id": "text",
      "name": "text",
      "description": "text",
      "profile": "text",
      "enforcement": "text",
      "comment": "text",
      "whiteList": [
        {
          "ip": "text",
          "url": "text",
          "comment": "text"
        }
      ],
      "template": "text"
    },
    "snatAutomap": false,
    "parentResource": {
      "id": 0,
      "name": "text",
      "type": "text",
      "internalType": "text",
      "status": "text",
      "category": "text",
      "technology": "text",
      "family": "text",
      "label": "text",
      "comment": "text",
      "productCode": "text",
      "productName": "text",
      "productVersion": "text",
      "cloudId": 0,
      "cloudName": "text",
      "serviceId": 0,
      "serviceName": "text",
      "serviceKey": "text",
      "environment": "text",
      "endOfSupportAt": "2025-01-02T14:35:00.561Z",
      "supportPhase": "text",
      "creationUser": "text",
      "creationTime": "text",
      "releasedAt": "2025-01-02T14:35:00.561Z",
      "endOfSalesAt": "2025-01-02T14:35:00.561Z",
      "extendedSupportAt": "2025-01-02T14:35:00.561Z",
      "monitoringEnabled": false,
      "monitoringAlerting": false,
      "monitoringOnCallEnabled": false,
      "monitoringRequested": false,
      "replicationStatus": false,
      "backupStatus": false,
      "patchParty": {
        "excluded": false,
        "exclusionReason": "text",
        "patchGroup": "text",
        "patchDate": "2025-01-02T14:35:00.561Z",
        "patchTag": "text",
        "name": "text",
        "id": 0,
        "excludedBy": "text",
        "exclusionDate": "2025-01-02T14:35:00.561Z"
      },
      "metrologyUrl": "text",
      "path": "text",
      "resourceType": "text",
      "internalResourceId": 0,
      "backupPolicyDetails": {
        "backups": [
          {
            "id": 0,
            "type": "text",
            "backupSize": 0,
            "backupLastDate": "2025-01-02T14:35:00.561Z"
          }
        ],
        "policies": [
          {
            "name": "text",
            "label": "text",
            "scope": "text",
            "type": "text",
            "replication": false,
            "durationInHours": 0,
            "startTime": "text",
            "timezone": "text",
            "policyId": "text",
            "backupLastDate": "2025-01-02T14:35:00.561Z",
            "backupSize": 0
          }
        ]
      }
    }
  }
]

Create K8s Container custom loadbalancer

POSThttps://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}/loadbalancers

Path parameters

id*integer (int64)

K8sCluster Id, example: 123

Body

application/json

serviceId*integer (int64)

id of service to put instance in.

regulationstring

Regulation. Refer to the regulation of the Area (HDS|STANDARD). If absent, default 'STANDARD' will be used.

region*string

Region. that is a low-latency network area, available in List Regions method. If absent, default Area of Region will be used.

cloudIdinteger (int64)

monitoringEnabledboolean

Indicates if monitoring will be setup. If absent, it will be automatically be setup if this is an production environment, or if backup is enabled.

noMonitoringProdReasonstring

Indicates why a production resource is not under monitoring.

onCallSupervisionboolean

Indicates if on call teams will be called on non business hours if an incident occurs on instance. If absent, set to false.

monitoringAlertingboolean

Indicates if alerting should be activated. If absent, set to false.

backupEnabledboolean

Indicates if backup has to be setup on instance. If absent, backup will be setup automatically if instance is in a production service.

noBackupProdReasonstring

Indicates why a production resource is not under backup.

replicationEnabledboolean

Indicates if replication will be setup. If absent, it will be automatically be setup if this is an production environment

noReplicationProdReasonstring

Indicates why a production resource is not replicated.

serverBackupPolicyIdstring

BackupPolicy id. Refers to desired backup policy to be applied for the virtual machine, must be set when backup is enabled.

dbBackupPolicyIdstring

BackupPolicy id. Refers to desired backup policy to be applied for the database, must be set when backup is enabled.

areastring

Area. Refer to an Area of a Region, that is a low-latency network area, available in List Regions method. If absent, default Area of Region will be used.

url*string

url of load balancer. Must be unique, and fit naming rules convention., example: url.cegedim.com

Pattern: ^(https?:\\/\\/)?(www\\.)?[a-zA-Z][a-zA-Z0-9.-]{2,63}+$

profileName*string

profile name of load balancer.

healthcheck*string

healtcheck of load balancer., example: http

portMembers*string

port member of load balancer., example: 80, 443, ...

networkIdinteger (int64)

Network id. Refer to networks available in List Networks method. If absent, a default network of AZ will be used.

certificateNamestring

certificate of the load balancer., example: wildcard_cegedim.com

sslProfilestring

ssl profile of the load balancer., example: profile_wildcard.cegedim.com_secure

vsPortinteger (int32)

port of load balancer in case of TCP VS Profile

setUpDNSEnabledboolean

Indicates if a DNS record is to be set. If absent, set to false.

persistenceboolean

redirectToHttpsboolean

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

processstring

Code of action performed

statusenum

Status label of action

SUCCESS,IN_PROGRESS,ERROR

messagestring

Human readable message of status

idinteger (int32)

internalIdinteger (int64)

resourceNamestring

resourceTypestring

familystring

lastUpdatedAtstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}/loadbalancers', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "healthcheck": "text",
      "portMembers": "text",
      "profileName": "text",
      "region": "text",
      "serviceId": 0,
      "url": "text"
    }),
});
const data = await response.json();

Response

200

{
  "process": "text",
  "status": "SUCCESS,IN_PROGRESS,ERROR",
  "message": "text",
  "id": 0,
  "internalId": 0,
  "resourceName": "text",
  "resourceType": "text",
  "family": "text",
  "lastUpdatedAt": "2025-01-02T14:35:00.561Z"
}

Get detailed information for an k8s container.

GEThttps://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}

Path parameters

id*integer (int64)

Resource Id, example: 123

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

idinteger (int64)

namestring

typestring

internalTypestring

statusstring

categorystring

technologystring

familystring

labelstring

commentstring

productCodestring

productNamestring

productVersionstring

cloudIdinteger (int64)

cloudNamestring

serviceIdinteger (int64)

serviceNamestring

serviceKeystring

environmentstring

endOfSupportAtstring (date-time)

supportPhasestring

creationUserstring

creationTimestring

releasedAtstring (date-time)

endOfSalesAtstring (date-time)

extendedSupportAtstring (date-time)

monitoringEnabledboolean

monitoringAlertingboolean

monitoringOnCallEnabledboolean

monitoringRequestedboolean

replicationStatusboolean

Storage Replication Enabled - The farm has replicated storage

backupStatusboolean

Indicates backup is active on the host

patchPartyPatchPartyV1 (object)

Representation of a resource patch party

metrologyUrlstring

pathstring

resourceTypestring

internalResourceIdinteger (int64)

backupPolicyDetailsBackupPolicyDetailsV1 (object)

nodeCountinteger (int64)

Number of Nodes of the K8s Cluster

topologystring

High availability mode status

versionstring

Version of the K8S Cluster

versionDetailedstring

Version of the K8S Cluster

managementUrlstring

Management host of the K8S Cluster

technicalIdstring

Technical ID of the K8S Cluster

labelAreaListarray of string

A list of Area name

labelRegionstring

Region pretty name

availableAZsarray of string

availableDCsarray of string

supportsHAModeboolean

allowMonitoringDisplayboolean

ingressProviderenum

Kubernetes Container Ingress Providers

NGINXISTIOTRAEFIKNGINX,ISTIO,TRAEFIK

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "id": 0,
  "name": "text",
  "type": "text",
  "internalType": "text",
  "status": "text",
  "category": "text",
  "technology": "text",
  "family": "text",
  "label": "text",
  "comment": "text",
  "productCode": "text",
  "productName": "text",
  "productVersion": "text",
  "cloudId": 0,
  "cloudName": "text",
  "serviceId": 0,
  "serviceName": "text",
  "serviceKey": "text",
  "environment": "text",
  "endOfSupportAt": "2025-01-02T14:35:00.561Z",
  "supportPhase": "text",
  "creationUser": "text",
  "creationTime": "text",
  "releasedAt": "2025-01-02T14:35:00.561Z",
  "endOfSalesAt": "2025-01-02T14:35:00.561Z",
  "extendedSupportAt": "2025-01-02T14:35:00.561Z",
  "monitoringEnabled": false,
  "monitoringAlerting": false,
  "monitoringOnCallEnabled": false,
  "monitoringRequested": false,
  "replicationStatus": false,
  "backupStatus": false,
  "patchParty": {
    "excluded": false,
    "exclusionReason": "text",
    "patchGroup": "text",
    "patchDate": "2025-01-02T14:35:00.561Z",
    "patchTag": "text",
    "name": "text",
    "id": 0,
    "excludedBy": "text",
    "exclusionDate": "2025-01-02T14:35:00.561Z"
  },
  "metrologyUrl": "text",
  "path": "text",
  "resourceType": "text",
  "internalResourceId": 0,
  "backupPolicyDetails": {
    "backups": [
      {
        "id": 0,
        "type": "text",
        "backupSize": 0,
        "backupLastDate": "2025-01-02T14:35:00.561Z"
      }
    ],
    "policies": [
      {
        "name": "text",
        "label": "text",
        "scope": "text",
        "type": "text",
        "replication": false,
        "durationInHours": 0,
        "startTime": "text",
        "timezone": "text",
        "policyId": "text",
        "backupLastDate": "2025-01-02T14:35:00.561Z",
        "backupSize": 0
      }
    ]
  },
  "nodeCount": 0,
  "topology": "text",
  "version": "text",
  "versionDetailed": "text",
  "managementUrl": "text",
  "technicalId": "text",
  "labelAreaList": [
    "text"
  ],
  "labelRegion": "text",
  "availableAZs": [
    "text"
  ],
  "availableDCs": [
    "text"
  ],
  "supportsHAMode": false,
  "allowMonitoringDisplay": false,
  "ingressProvider": "NGINX"
}

Delete an existing k8s container

This method allows to delete a K8s Cluster Container.

This method is asynchronous (status code 202) and you'll have to wait for async action to be completed by checking its status.

DELETE /k8s-clusters/123

DELETE /k8s-clusters/123
{
    "changeReference": "rfc nunmber 456"
}

DELETEhttps://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}

Path parameters

id*integer (int64)

id, example: 123

Body

application/vnd.cegedim-it.v1+json

changeReferencestring

Optional reference for change

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

processstring

Code of action performed

statusenum

Status label of action

SUCCESS,IN_PROGRESS,ERROR

messagestring

Human readable message of status

idinteger (int32)

internalIdinteger (int64)

resourceNamestring

resourceTypestring

familystring

lastUpdatedAtstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}', {
    method: 'DELETE',
    headers: {
      "Content-Type": "application/vnd.cegedim-it.v1+json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "process": "text",
  "status": "SUCCESS,IN_PROGRESS,ERROR",
  "message": "text",
  "id": 0,
  "internalId": 0,
  "resourceName": "text",
  "resourceType": "text",
  "family": "text",
  "lastUpdatedAt": "2025-01-02T14:35:00.561Z"
}

update K8s Cluster

This method allows to update a cluster.

Structure of payload is generic and describes :

• operation you want to be performed
• options data relative to the operation performed - see details.

Below are different operations currently implemented.

Create Nodes

Use the create_nodes operation to create the nodes of a cluster.

Create nodes operation will add the new nodes in the cluster by availability zone. You can specify the availability zone you need in the request.

This method is synchronous (status code 202).

Example :

PATCH /containers/kubernetes/1234
{
    "operation": "create_nodes",
    "options": {
        "nodes": [
            {
                "nodesNb": 1,
                "nodeSizing": "2cpu4gb",
                "az": "EB-A"
            },
            {
                "nodesNb": 2,
                "nodeSizing": "4cpu8gb",
                "az": "EB-B"
            }
        ]
    }
}

Delete Nodes

Use the delete_nodes operation to delete the nodes of a cluster.

This operation cannot be undone afterwards.

This method is synchronous (status code 202).

PATCH /containers/kubernetes/1234
{
	"operation":"delete_nodes",
	"options":{
	    "nodes": ["11112","11113","11114"]
	}
}

Enable High Availability - HA

Use the enable_ha operation to enable the HA of a cluster.

This operation cannot be undone afterwards.

This method is synchronous (status code 202).

PATCH /containers/kubernetes/1234
{
	"operation":"enable_ha"
}

Update Monitoring

Use the update_monitoring operation to update the monitoring state of the cluster.

Use the state option to turn on/off monitoring. Use the on_call option to turn on/off 24/7 monitoring.

This method is synchronous (status code 202).

PATCH /containers/kubernetes/1234
{
  "operation": "update_monitoring",
  "options": {
       "state": true,
       "on_call": true
 }
}

Update Patch Party

Use the update_patch_party operation to update the patch party scheduled plan of the cluster.

• Use the excluded option to turn on/off patch party.
• Use the patchGroup option to select the patching group, the patchGroup is optional, and is only allowed when the farm has one member.
• Use the exclusionReason option to explain the reason of excluding the resource from patch part.

This method is synchronous (status code 202).

• Include from patch party body:

PATCH /containers/kubernetes/1234
{
  "operation": "update_patch_party",
  "options": {
    "patchParty": {
        "excluded": false,
        "patchGroup": "3"
    }
 }
}

• Exclude from patch party body:

PATCH /containers/kubernetes/1234
{
  "operation": "update_patch_party",
  "options": {
    "patchParty": {
        "excluded": true,
        "exclusionReason": "I want to handle this by myself"
    }
 }
}

Upgrade

Use the upgrade operation to upgrade the cluster.

• Use the version option to set the target version to be installed.

The requirements are :

• step by step upgrade only : Use the /compute/platform/products?type=KUBERNETES to list all versions available for the cluster.
• no downgrade possibility

This method is synchronous (status code 202).

PATCH /containers/kubernetes/1234
{
  "operation": "upgrade",
  "options": {
    "version": "1.24"
 }
}

PATCHhttps://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}

Path parameters

id*integer (int64)

K8s Cluster Id, example: 123

Body

application/jsonapplication/vnd.cegedim-it.v1+json

operationstring

optionsobject

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

processstring

Code of action performed

statusenum

Status label of action

SUCCESS,IN_PROGRESS,ERROR

messagestring

Human readable message of status

idinteger (int32)

internalIdinteger (int64)

resourceNamestring

resourceTypestring

familystring

lastUpdatedAtstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}', {
    method: 'PATCH',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200

{
  "process": "text",
  "status": "SUCCESS,IN_PROGRESS,ERROR",
  "message": "text",
  "id": 0,
  "internalId": 0,
  "resourceName": "text",
  "resourceType": "text",
  "family": "text",
  "lastUpdatedAt": "2025-01-02T14:35:00.561Z"
}

Get a Kubernetes containter node informations

GEThttps://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}/nodes

Path parameters

id*integer (int64)

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

idinteger (int64)

namestring

typestring

internalTypestring

statusstring

categorystring

technologystring

familystring

labelstring

commentstring

productCodestring

productNamestring

productVersionstring

cloudIdinteger (int64)

cloudNamestring

serviceIdinteger (int64)

serviceNamestring

serviceKeystring

environmentstring

endOfSupportAtstring (date-time)

supportPhasestring

creationUserstring

creationTimestring

releasedAtstring (date-time)

endOfSalesAtstring (date-time)

extendedSupportAtstring (date-time)

monitoringEnabledboolean

monitoringAlertingboolean

monitoringOnCallEnabledboolean

monitoringRequestedboolean

replicationStatusboolean

backupStatusboolean

patchPartyPatchPartyV1 (object)

Representation of a resource patch party

metrologyUrlstring

pathstring

resourceTypestring

internalResourceIdinteger (int64)

backupPolicyDetailsBackupPolicyDetailsV1 (object)

ipAddressstring

networkNetworkV1 (object)

storageInformationStorageInformationV1 (object)

Information about a Storage of an Instance

availabilityZoneAvailabilityZoneV1 (object)

areaAreaV1 (object)

regionRegionV1 (object)

backupBackupV1 (object)

Backup information on an instance

replicationReplicationV1 (object)

Replication information on an instance

snapshotSnapshotV1 (object)

Snapshot of an instance

labelRegionstring

Region pretty name

labelDataCenterstring

DataCenter pretty name

labelAreastring

Area pretty name

labelAvailabilityZonestring

Availability Zone pretty name

totalSizeDisksstring

Total Disk size of the resource

cpuinteger (int64)

CPU of the resource

raminteger (int64)

RAM of the resource

storagenumber

Storage after disks format in GB of the resource

isMemberOFLoadBalancerboolean

Instance is member of load balancer

loadbalancersarray of LoadbalancerInfoV1 (object)

imageCodestring

Internal Image linked to this instance

osNamestring

OS name of this instance

osTypestring

OS type of this instance

isExternalIngressNodeboolean

This instance is ingress external node

isInternalIngressNodeboolean

This instance is ingress internal node

storageMoveInProgressboolean

Information about storage replication in Progress

authenticationDomainstring

parentResourceTypestring

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}/nodes', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": 0,
    "name": "text",
    "type": "text",
    "internalType": "text",
    "status": "text",
    "category": "text",
    "technology": "text",
    "family": "text",
    "label": "text",
    "comment": "text",
    "productCode": "text",
    "productName": "text",
    "productVersion": "text",
    "cloudId": 0,
    "cloudName": "text",
    "serviceId": 0,
    "serviceName": "text",
    "serviceKey": "text",
    "environment": "text",
    "endOfSupportAt": "2025-01-02T14:35:00.561Z",
    "supportPhase": "text",
    "creationUser": "text",
    "creationTime": "text",
    "releasedAt": "2025-01-02T14:35:00.561Z",
    "endOfSalesAt": "2025-01-02T14:35:00.561Z",
    "extendedSupportAt": "2025-01-02T14:35:00.561Z",
    "monitoringEnabled": false,
    "monitoringAlerting": false,
    "monitoringOnCallEnabled": false,
    "monitoringRequested": false,
    "replicationStatus": false,
    "backupStatus": false,
    "patchParty": {
      "excluded": false,
      "exclusionReason": "text",
      "patchGroup": "text",
      "patchDate": "2025-01-02T14:35:00.561Z",
      "patchTag": "text",
      "name": "text",
      "id": 0,
      "excludedBy": "text",
      "exclusionDate": "2025-01-02T14:35:00.561Z"
    },
    "metrologyUrl": "text",
    "path": "text",
    "resourceType": "text",
    "internalResourceId": 0,
    "backupPolicyDetails": {
      "backups": [
        {
          "id": 0,
          "type": "text",
          "backupSize": 0,
          "backupLastDate": "2025-01-02T14:35:00.561Z"
        }
      ],
      "policies": [
        {
          "name": "text",
          "label": "text",
          "scope": "text",
          "type": "text",
          "replication": false,
          "durationInHours": 0,
          "startTime": "text",
          "timezone": "text",
          "policyId": "text",
          "backupLastDate": "2025-01-02T14:35:00.561Z",
          "backupSize": 0
        }
      ]
    },
    "ipAddress": "text",
    "network": {
      "id": 0,
      "technicalId": "text",
      "cidr": "text",
      "description": "text",
      "scope": "text",
      "defaultNetwork": false,
      "usedPercent": 0,
      "ipFreeNumber": 0,
      "ipAddress": "text",
      "dns": [
        {
          "alias": "text",
          "domain": "text"
        }
      ],
      "mask": "text",
      "networkShortDescription": "text",
      "isIpRangePublic": false,
      "cloud": "text",
      "environment": "text",
      "shortDescription": "text",
      "gateway": "text",
      "region": "text",
      "area": "text"
    },
    "storageInformation": {
      "totalSizeDisks": 0,
      "fileSystems": [
        {
          "mountingPoint": "text",
          "type": "text",
          "sizeOf": 0,
          "free": 0
        }
      ],
      "totalSizeFileSystems": 0
    },
    "availabilityZone": {
      "id": "text",
      "location": "text",
      "routable": false,
      "defaultZone": false,
      "datacenterId": "text",
      "availabilityZoneGroup": "text"
    },
    "area": {
      "id": "text",
      "location": "text",
      "regulation": "text",
      "defaultArea": false,
      "availabilityZones": [
        {
          "id": "text",
          "location": "text",
          "routable": false,
          "defaultZone": false,
          "datacenterId": "text",
          "availabilityZoneGroup": "text"
        }
      ]
    },
    "region": {
      "id": "text",
      "location": "text",
      "areas": [
        {
          "id": "text",
          "location": "text",
          "regulation": "text",
          "defaultArea": false,
          "availabilityZones": [
            {
              "id": "text",
              "location": "text",
              "routable": false,
              "defaultZone": false,
              "datacenterId": "text",
              "availabilityZoneGroup": "text"
            }
          ]
        }
      ],
      "dataCenter": "text"
    },
    "backup": {
      "backupSystem": "text",
      "size": 0,
      "type": "text",
      "filesNb": 0,
      "lastDate": "2025-01-02T14:35:00.561Z"
    },
    "replication": {
      "storageClass": "text",
      "storageReplicationClass": "text",
      "storageClassOverride": "text",
      "storageMoveInProgress": false,
      "storageMoveTicket": "text",
      "noStoRplExplanation": "text"
    },
    "snapshot": {
      "id": "text",
      "label": "text",
      "createdBy": "text",
      "createdAt": "2025-01-02T14:35:00.561Z",
      "recoveredAt": "2025-01-02T14:35:00.561Z",
      "expiresAt": "2025-01-02T14:35:00.561Z",
      "description": "text",
      "changeReference": "text",
      "snapshotSize": 0
    },
    "labelRegion": "text",
    "labelDataCenter": "text",
    "labelArea": "text",
    "labelAvailabilityZone": "text",
    "totalSizeDisks": "text",
    "cpu": 0,
    "ram": 0,
    "storage": 0,
    "isMemberOFLoadBalancer": false,
    "loadbalancers": [
      {
        "id": 0,
        "name": "text",
        "status": "text",
        "monitoringEnabled": false,
        "memberCount": 0,
        "serviceId": 0
      }
    ],
    "imageCode": "text",
    "osName": "text",
    "osType": "text",
    "isExternalIngressNode": false,
    "isInternalIngressNode": false,
    "storageMoveInProgress": false,
    "authenticationDomain": "text",
    "parentResourceType": "text"
  }
]

Get a Kubernetes containter network informations

GEThttps://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}/networks

Path parameters

id*integer (int64)

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

idinteger (int64)

technicalIdstring

cidrstring

descriptionstring

scopestring

defaultNetworkboolean

usedPercentinteger (int32)

ipFreeNumberinteger (int32)

ipAddressstring

dnsarray of DNSV1 (object)

maskstring

networkShortDescriptionstring

isIpRangePublicboolean

cloudstring

environmentstring

shortDescriptionstring

gatewaystring

regionstring

areastring

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}/networks', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "id": 0,
    "technicalId": "text",
    "cidr": "text",
    "description": "text",
    "scope": "text",
    "defaultNetwork": false,
    "usedPercent": 0,
    "ipFreeNumber": 0,
    "ipAddress": "text",
    "dns": [
      {
        "alias": "text",
        "domain": "text"
      }
    ],
    "mask": "text",
    "networkShortDescription": "text",
    "isIpRangePublic": false,
    "cloud": "text",
    "environment": "text",
    "shortDescription": "text",
    "gateway": "text",
    "region": "text",
    "area": "text"
  }
]

Get K8s Container stats distribution of Availability Zone and Datacenter of the nodes the cluster

GEThttps://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}/metrics

Path parameters

id*integer (int64)

K8sCluster Id, example: 123

Query parameters

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

Other propertiesDistributionInformationV1 (object)

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}/metrics?type=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

List ingress providers

GEThttps://api.cegedim.cloud/itcare/compute/containers/kubernetes/ingress-providers

Response

200400

OK

Body

*/*

itemsstring

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/compute/containers/kubernetes/ingress-providers', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  "text"
]

Delete a Kubernetes container node

This method allows to delete a Kubernetes cluster node.

This operation cannot be undone afterwards.

This method is synchronous (status code 202).

To delete a Kubernetes node, the id of the Kubernetes cluster and the id of the node to delete must be specified.

To list the nodes of the Kubernetes cluster, use the endpoint : GET /containers/kubernetes/{kuberneteId}/nodes/{nodeId}.

Use the following to delete a node of a Kubernetes cluster.

DELETE /containers/kubernetes/1234/nodes/4567

To keep consistency on the Kubernetes cluster, please note that :

• All nodes cannot be deleted.

• All ingress nodes cannot be deleted.

API users will have a BAD_REQUEST when trying to break one of the rule above.

DELETEhttps://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}/nodes/{nodeId}

Path parameters

id*integer (int64)

id, example: 123

nodeId*integer (int64)

id, example: 456

Response

200400

OK

Body

application/vnd.cegedim-it.v1+json

processstring

Code of action performed

statusenum

Status label of action

SUCCESS,IN_PROGRESS,ERROR

messagestring

Human readable message of status

idinteger (int32)

internalIdinteger (int64)

resourceNamestring

resourceTypestring

familystring

lastUpdatedAtstring (date-time)

Request

JavaScriptCurlPython

const response = await fetch('https://api.cegedim.cloud/itcare/compute/containers/kubernetes/{id}/nodes/{nodeId}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

200

{
  "process": "text",
  "status": "SUCCESS,IN_PROGRESS,ERROR",
  "message": "text",
  "id": 0,
  "internalId": 0,
  "resourceName": "text",
  "resourceType": "text",
  "family": "text",
  "lastUpdatedAt": "2025-01-02T14:35:00.561Z"
}