adding new feature

Author: dstagnol

pages/hosted_private_cloud/hosted_private_cloud_powered_by_vmware/spla_license_management/guide.en-gb.md

@@ -1,26 +1,90 @@
 ---
-title: How to manage Windows licenses for virtual machines on your Hosted Private Cloud infrastructure
-excerpt: Find out how to manage Windows licenses for virtual machines on your OVHcloud Hosted Private Cloud infrastructure
-updated: 2024-05-23
+title: How to manage Windows licences for virtual machines on your Hosted Private Cloud infrastructure
+excerpt: Learn how to track and activate Windows licences for your virtual machines using the OVHcloud Control Panel or API.
+updated: 2025-05-28
 ---
 
 ## Objective
 
-This guide explains how to manage Windows licenses for your virtual machines hosted on your Hosted Private Cloud infrastructure.
+This guide explains how to manage Windows licences for your virtual machines hosted on your Hosted Private Cloud infrastructure.
+
+It now includes a new feature available in the [OVHcloud Control Panel](/links/manager), which allows you to:
+- View the number of Windows virtual machines requiring a licence
+- Instantly activate a licence on eligible VMs from the interface
+
+This gives you better visibility, reduces the need for API calls, and helps ensure compliance with Microsoft licensing requirements.
 
 > [!warning]
 >
-> OVHcloud allows you to ease the management and billing of your Windows licenses by allowing you to tell us which virtual machines require the use of a license.
+> OVHcloud simplifies the management and billing of your Windows licences by allowing you to tell us which virtual machines require the use of a licence.
 > 
 > However, you remain responsible for the accuracy of the data you provide to us, and OVHcloud cannot be held liable for any unauthorized use of a Windows system on your part.
 
 ## Requirements
 
-- [Windows licenses activated](/pages/hosted_private_cloud/hosted_private_cloud_powered_by_vmware/manager_ovh_private_cloud#licence-windows) in your [OVHcloud Control Panel](/links/manager)
+- A Hosted Private Cloud service powered by VMware
+- At least one virtual machine running a Windows operating system
+- [Windows licences activated](/pages/hosted_private_cloud/hosted_private_cloud_powered_by_vmware/manager_ovh_private_cloud#licence-windows) in your [OVHcloud Control Panel](/links/manager)
 
 ## Instructions
 
-### List virtual machines with a license
+### Monitor and activate Windows licences directly from the OVHcloud Control Panel
+
+> [!primary]
+>
+> This feature only applies if you want OVHcloud to license your Windows VMs via SPLA.
+> If you bring your own licence (BYOL), you do not need to activate anything in the [OVHcloud Control Panel](/links/manager).
+
+#### Check your Windows licence usage in the Control Panel
+
+1. Go to the `Hosted Private Cloud`{.action} section of your [OVHcloud Control Panel](/links/manager).
+
+2. Select your service, then open the `Datacenter`{.action} tab.
+
+Here, you will find:
+
+- The **total number of VMs** running in your datacenter
+- The **number of Windows VMs** (requiring a licence)
+- The **number of declared Windows VMs** (licensed by OVHcloud)
+
+![Licence overview](images/licence-visibility-EN.png).{thumbnail}
+
+> [!primary]
+> 
+> Activating the licence in the [OVHcloud Control Panel](/links/manager) is only required if you want OVHcloud to provide a Windows SPLA licence for the VM.
+
+#### Understand the two Windows licence management modes
+
+There are two scenarios:
+
+- **Case 1: You bring your own Microsoft licence (BYOL)**
+    → No action required in the interface.
+
+- **Case 2: You want OVHcloud to licence the VM**
+    → The VM licence must be activated in the [OVHcloud Control Panel](/links/manager) for it to be billed properly.
+
+#### Activate a Windows licence from the OVHcloud Control Panel
+
+1. In your private cloud, go to the `Virtual Machines`{.action} tab.
+2. Locate the VM that needs to be licensed.
+3. Click `Activate licence`{.action}.
+
+    ![Activate licence](images/activate-licence-EN.png){.thumbnail}
+
+4. Choose the appropriate licence from the dropdown menu.
+5. Click `Activate`{.action} to confirm the action.
+
+    ![Activate licence](images/select-licence-EN.png){.thumbnail}
+
+> [!success]
+> 
+> The VM is now declared and licensed by OVHcloud. It will appear in your billing and compliance tracking.
+
+### Manage licences using the OVHcloud API
+
+If you prefer to automate or integrate Windows licence management into your workflows, you can use the [API OVHcloud](https://api.ovh.com/){.external}. to list, assign, update or remove licences on your virtual machines.
+
+#### List virtual machines with a licence
 
 You can quickly check which virtual machines in your infrastructure are licensed via the OVHcloud API:
 
@@ -42,16 +106,16 @@ You can quickly check which virtual machines in your infrastructure are licensed
 ]
 ```
 
-### Verify the license of a virtual machine
+#### Verify the licence of a virtual machine
 
-You can check the license currently associated with one of your virtual machines via the OVHcloud API:
+You can check the licence currently associated with one of your virtual machines via the OVHcloud API:
 
 > [!api]
 >
 > @api {v1} /dedicatedCloud GET /dedicatedCloud/{serviceName}/datacenter/{datacenterId}/vm/{vmId}
 >
 
-If no license is attached to it, the `license` field value will be `null`.
+If no licence is attached to it, the `license` field value will be `null`.
 
 *Return example:*
 
@@ -63,9 +127,9 @@ If no license is attached to it, the `license` field value will be `null`.
 }
 ```
 
-### Update the license of a virtual machine
+#### Update the licence of a virtual machine
 
-You can update the license associated with one of your virtual machines via the OVHcloud API:
+You can update the licence associated with one of your virtual machines via the OVHcloud API:
 
 > [!api]
 >
@@ -74,17 +138,17 @@ You can update the license associated with one of your virtual machines via the
 
 > [!primary]
 >
-> Virtual machines deployed from [VMware content libraries](/pages/hosted_private_cloud/hosted_private_cloud_powered_by_vmware/how_to_use_content_library) are automatically attached to a corresponding Windows license.
+> Virtual machines deployed from [VMware content libraries](/pages/hosted_private_cloud/hosted_private_cloud_powered_by_vmware/how_to_use_content_library) are automatically attached to a corresponding Windows licence.
 
 > [!warning]
 >
-> In order to avoid the incorrect allocation of a Windows license on a virtual machine, the API call above will return an error in the case where the virtual machine has been configured for a different operating system from your vSphere interface. 
+> In order to avoid the incorrect allocation of a Windows licence on a virtual machine, the API call above will return an error in the case where the virtual machine has been configured for a different operating system from your vSphere interface. 
 >
 > You can resolve this by changing the VM settings or you can choose to ignore this error by passing the option `bypassGuestOsFamilyCheck`.
 
-### Unlicense a virtual machine
+#### Unlicense a virtual machine
 
-You can delete the license associated with one of your virtual machines via the OVHcloud API:
+You can delete the licence associated with one of your virtual machines via the OVHcloud API:
 
 > [!api]
 >
@@ -93,4 +157,8 @@ You can delete the license associated with one of your virtual machines via the
 
 ## Go further
 
-Join our community of users on <https://community.ovh.com/en/>.
+If you need training or technical assistance to implement our solutions, please contact your Technical Account Manager or click on [this link](/links/professional-services) to get a quote and ask our Professional Services experts for a custom analysis of your project.
+
+Ask questions, give your feedback and interact directly with the team building our Hosted Private Cloud services on the dedicated [Discord](https://discord.gg/ovhcloud) channel.
+
+Join our [community of users](/links/community).

pages/hosted_private_cloud/hosted_private_cloud_powered_by_vmware/spla_license_management/guide.fr-fr.md

@@ -1,12 +1,18 @@
 ---
-title: Gérer les licences Windows de vos machines virtuelles
-excerpt: Gérer les licences Windows de vos machines virtuelles
-updated: 2024-05-23
+title: Activer et gérer les licences Windows de vos machines virtuelles
+excerpt: Activer et gérer les licences Windows de vos machines virtuelles v
+updated: 2025-05-28
 ---
 
 ## Objectif
 
-Découvrez comment gérer les licences Windows de vos machines virtuelles hébergées sur votre infrastructure Hosted Private Cloud.
+Ce guide vous explique comment gérer les licences Windows de vos machines virtuelles hébergées sur votre infrastructure Hosted Private Cloud.
+
+Il intègre désormais une nouvelle fonctionnalité disponible dans l’[espace client OVHcloud](/links/manager) qui vous permet de :
+- Visualiser le nombre de machines virtuelles Windows nécessitant une licence
+- Activer instantanément une licence sur les VM éligibles, directement depuis l’interface
+
+Cela vous offre une meilleure visibilité, réduit le recours aux appels API, et vous aide à rester conforme aux exigences de licences Microsoft.
 
 > [!warning]
 >
@@ -16,11 +22,68 @@ Découvrez comment gérer les licences Windows de vos machines virtuelles héber
 
 ## Prérequis
 
-- [Avoir activé les licences Windows](/pages/hosted_private_cloud/hosted_private_cloud_powered_by_vmware/manager_ovh_private_cloud#licence-windows){.external} depuis votre [espace client OVHcloud](/links/manager){.external}
+- Un service Hosted Private Cloud basé sur VMware
+- Au moins une machine virtuelle exécutant un système d’exploitation Windows
+- [Licences Windows activées](/pages/hosted_private_cloud/hosted_private_cloud_powered_by_vmware/manager_ovh_private_cloud#license-windows) dans votre [espace client OVHcloud](/links/manager)
 
 ## En pratique
 
-### Lister les machine virtuelles avec une licence
+### Suivre et activer les licences Windows directement depuis votre espace client OVHcloud
+
+> [!primary]
+>
+> Cette fonctionnalité s’applique uniquement si vous souhaitez qu’OVHcloud fournisse la licence Windows via SPLA.
+> Si vous utilisez votre propre licence (BYOL), aucune activation n’est nécessaire dans l' [espace client OVHcloud](/links/manager).
+
+#### Consulter l’usage des licences Windows dans l'espace client OVHcloud
+
+1. Rendez-vous dans la section `Hosted Private Cloud`{.action} de votre [espace client OVHcloud](/links/manager).
+
+2. Sélectionnez votre service, puis ouvrez l'onglet `Datacenter`{.action} .
+
+Vous y trouverez :
+- Le **nombre total de VM** en cours d'exécution dans votre datacenter
+- Le **nombre de VM Windows** (nécessitant une licence)
+- Le **nombre de VM Windows déclarées** (licenciées via OVHcloud)
+
+    ![Licence overview](images/licence-visibility-FR.png).{thumbnail}
+
+> [!primary]
+>
+> L’activation de la licence dans l'[espace client OVHcloud](/links/manager) n’est requise que si vous souhaitez qu’OVHcloud fournisse une licence SPLA pour cette machine virtuelle.
+
+#### Comprendre les deux modes de gestion des licences Windows
+
+Deux cas de figure sont possibles :
+
+- **Cas 1 : vous utilisez votre propre licence Microsoft (BYOL)**
+    → Aucune action n'est requise dans l'interface.
+
+- **Cas n° 2 : vous souhaitez qu’OVHcloud fournisse une licence pour la VM**
+    → La licence de la VM doit être activée depuis l’[espace client OVHcloud](/links/manager) pour être correctement facturée.
+    
+#### Activer une licence Windows depuis l'espace client
+
+1. Dans votre Private Cloud, accédez à l'onglet `Virtual Machines`{.action} .
+2. Localisez la VM concernée (sous licence Windows)
+3. Cliquez sur `Activer la licence`{.action}.
+
+    ![Activer la licence](images/activate-licence-FR.png){.thumbnail}
+
+4. Choisissez la licence souhaitée dans le menu déroulant.
+5. Cliquez sur `Activer`{.action} pour confirmer l'action.
+
+    ![Activer la licence](images/select-licence-FR.png){.thumbnail}
+
+> [!success]
+>
+> La VM est désormais déclarée et licenciée par OVHcloud. Elle sera prise en compte dans votre facturation et dans le suivi de conformité.
+
+### Gérer les licences via l’API OVHcloud
+
+Si vous souhaitez automatiser la gestion des licences Windows ou l’intégrer à vos processus, vous pouvez utiliser l’[API OVHcloud](https://api.ovh.com/){.external} pour lister, attribuer, mettre à jour ou supprimer les licences de vos machines virtuelles.
+
+#### Lister les machines virtuelles avec une licence
 
 Vous pouvez vérifier rapidement quelles machines virtuelles de votre infrastructure possèdent une licence depuis l'API OVHcloud.
 
@@ -29,7 +92,7 @@ Vous pouvez vérifier rapidement quelles machines virtuelles de votre infrastruc
 > @api {v1} /dedicatedCloud GET /dedicatedCloud/{serviceName}/datacenter/{datacenterId}/vmLicensed
 >
 
-*Example de retour :*
+*Exemple de retour :*
 
 ```json
 [
@@ -42,9 +105,9 @@ Vous pouvez vérifier rapidement quelles machines virtuelles de votre infrastruc
 ]
 ```
 
-### Vérifier la licence d'une machine virtuelle
+#### Vérifier la licence d'une machine virtuelle
 
-Vous pouvez vérifier la license actuellement associé à une de vos machines virtuelles depuis l'API OVHcloud.
+Vous pouvez vérifier la licence actuellement associé à une de vos machines virtuelles depuis l'API OVHcloud.
 Si aucune licence n'est attachée à celle-ci, le champ `license` aura la valeur `null`.
 
 > [!api]
@@ -62,7 +125,7 @@ Si aucune licence n'est attachée à celle-ci, le champ `license` aura la valeur
 }
 ```
 
-### Mettre à jour la licence d'une machine virtuelle
+#### Mettre à jour la licence d'une machine virtuelle
 
 Vous pouvez mettre à jour la licence associée à une de vos machines virtuelles depuis l'API OVHcloud :
 
@@ -81,7 +144,7 @@ Vous pouvez mettre à jour la licence associée à une de vos machines virtuelle
 >
 > Vous pouvez résoudre ce problème en modifiant les réglages de la machine virtuelle ou vous pouvez choisir d'ignorer cette erreur en passant l'option `bypassGuestOsFamilyCheck`.
 
-### Supprimer la licence d'une machine virtuelle
+#### Supprimer la licence d'une machine virtuelle
 
 Vous pouvez supprimer la licence associée à une de vos machines virtuelles depuis l'API OVHcloud :
 
@@ -92,4 +155,8 @@ Vous pouvez supprimer la licence associée à une de vos machines virtuelles dep
 
 ## Aller plus loin
 
-Échangez avec notre [communauté d'utilisateurs](/links/community).
+Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en œuvre de nos solutions, contactez votre Technical Account Manager ou demandez une analyse personnalisée de votre projet à nos experts de l’équipe [Professional Services](/links/professional-services).
+
+Posez des questions, donnez votre avis et interagissez directement avec l’équipe qui construit nos services Hosted Private Cloud sur le canal [Discord](https://discord.gg/ovhcloud) dédié.
+
+Échangez avec notre [communauté d'utilisateurs](/links/community).