Breaking change

Description

• Les champs cloudName (et son alias cloud) sont dépréciés dans les API ITCare.

• Retrait définitif : fin novembre 2026.

• Seul cloudId reste garanti dans le temps. Pour obtenir le nom d'un cloud : GET /clouds/{cloudId} → champ name.

Pourquoi ce changement ?

• Le nom d'un cloud est dupliqué dans de nombreuses réponses, alors qu'il peut être renommé.

• Certains endpoints renvoient déjà un nom désynchronisé de la valeur de référence.

• Centraliser le nom sur un seul endpoint élimine ces écarts.

Comment migrer ?

AVANT  →  item.cloudName   (ou item.cloud)
APRÈS  →  item.cloudId     puis   GET /clouds/{cloudId}.name

• Repérer dans le code toute lecture de cloudName / cloud

• Conserver cloudId comme référence

• Résoudre le nom via GET /clouds/{cloudId}

• Recommandation : mettre en cache le mapping cloudId → name côté client (le nom change rarement), plutôt qu'un appel par élément

• Déployer avant fin novembre 2026

Endpoint de remplacement

GET /clouds/{cloudId}

{
  "cloudId": 12345,
  "name": "MON-CLOUD"
}

• cloudId : identifiant stable, présent dans toutes les réponses listées ci-dessous.

• name : nom de référence, unique et toujours à jour.

Endpoints impactés — par domaine

Seuls les endpoints exposant le nom du cloud sont listés. cloudId reste disponible et inchangé partout.

Compute

Méthode	Endpoint	Champ nom exposé
GET	/compute/resources	cloudName
GET	/compute/resources/{id}	cloudName
GET	/compute/platform/resources-obsolescence	cloudName
GET	/compute/backup-policies	cloudName
GET	/compute/backup-policies/{id}	cloudName
GET	/compute/services	cloud
GET	/compute/services/{id}	cloud
GET	/compute/services/{id}/resources	cloudName
GET	/ai/departments	cloudName
GET	/networking/networks	cloud
GET	/analytics/matomo	cloudName
GET	/analytics/matomo/{id}	cloudName

Monitoring

Méthode	Endpoint	Champ nom exposé
GET	/monitoring/indicators	cloudName
POST	/monitoring/indicators	cloudName
GET	/monitoring/indicators/{id}	cloudName

Search

Méthode	Endpoint	Champ nom exposé
GET	/search	cloudName
GET	/resources	cloudName

Changes

Méthode	Endpoint	Champ nom exposé
GET	/changes	cloudName
GET	/patch-parties/{id}/resources/clouds	cloudName
GET	/patch-parties/{id}/clouds	cloudName

Points d'attention

• Deux noms de champ à traiter : cloudName sur la plupart des endpoints, alias cloud sur /compute/services, /compute/services/{id} et /networking/networks.

• Les endpoints POST (/monitoring/indicators, /api/rfcs/{id}/cis) renvoient aussi le nom en réponse — pas seulement les GET.

• Le filtrage reste basé sur cloudId (aucun filtre par nom de cloud disponible).

Calendrier

Étape	Échéance
Publication de cette page	Immédiate
Période de migration	Jusqu'à fin novembre 2026
Retrait de cloudName / cloud	Fin novembre 2026

FAQ / Contact

Pour toute question ou besoin d'accompagnement à la migration, contactez votre Service Delivery Manager (SDM) cegedim.cloud.