Gestion des API plateforme stv1 mise hors service - Cloud Azure global (août 2024)

S’APPLIQUE À : Développeur | De base | Standard | Premium

En tant que Cloud Platform-as-a-service (PaaS), la Gestion des API Azure fait abstraction de nombreux détails de l’infrastructure utilisée pour héberger et exécuter votre service. L’infrastructure associée à la version de la plateforme de calcul Gestion des API stv1 sera mise hors service le 31 août 2024 dans le cloud Microsoft Azure global. Une version de plateforme de calcul (stv2) plus récente est déjà disponible et fournit des fonctionnalités de service améliorées.

Le tableau suivant récapitule les plateformes de calcul actuellement utilisées pour les instances dans les différents niveaux de service Gestion des API.

Pour bénéficier d’une prise en charge continue et tirer parti des fonctionnalités à venir, les clients doivent migrer leurs instances Azure Gestion des API de la stv1 plateforme de calcul vers la stv2 plateforme de calcul. La plateforme de calcul stv2 est fournie avec des fonctionnalités et des améliorations supplémentaires, telles que la prise en charge d’Azure Private Link et d’autres fonctionnalités réseau.

Les nouvelles instances créées dans les niveaux de service autres que le niveau Consommation sont principalement hébergées sur la plateforme stv2. Les instances existantes sur la stv1 plateforme de calcul continueront de fonctionner normalement jusqu’à la date de mise hors service, mais ces instances ne recevront pas les dernières fonctionnalités disponibles pour la stv2 plateforme. La prise en charge des instances stv1 sera mise hors service le 31 août 2024.

Mon service est-il concerné par ce changement ?

Si la valeur de la propriété platformVersion de votre service est stv1, elle est hébergée sur la plateforme stv1. Consultez Comment savoir quelle plateforme héberge mon instance de Gestion des API ?

Quelle est la date limite pour effectuer ce changement ?

La prise en charge des instance de la Gestion des API hébergées sur la plateforme stv1 sera mise hors service le 31 août 2024.

Que dois-je faire ?

Migrez toutes vos instances existantes hébergées sur la stv1 plateforme de calcul vers la plateforme de stv2 calcul.

Si vous avez des instances existantes hébergées sur la plateforme stv1, suivez notre guide de migration pour garantir une migration réussie.

Que se passe-t-il après le 31 août 2024 ?

Votre stv1 instance ne sera pas arrêtée, désactivée ou supprimée. Toutefois, l’engagement sla pour l’instance se termine et toute stv1 instance après la date de mise hors service sera planifiée pour la migration automatique vers la stv2 plateforme.

Fin de l’engagement sla pour stv1 les instances

À compter du 1er septembre 2024, Gestion des API ne fournira plus de garanties de niveau de service, et par crédits de service d’extension, pour les problèmes de performances ou de disponibilité liés aux instances de service Developer, Basic, Standard et Premium s’exécutant sur la stv1 plateforme de calcul. En outre, aucun nouvel investissement en matière de sécurité et de conformité n’est effectué dans la plateforme Gestion des APIstv1.

Grâce à l’utilisation continue d’une instance hébergée sur la stv1 plateforme au-delà de la date de mise hors service, vous reconnaissez qu’Azure ne s’engage pas dans le contrat SLA de 99,95 % pour les instances supprimées.

Migration automatique

Après la date de mise hors service, nous allons migrer automatiquement les instances de service stv1 restantes vers la plateforme de calcul stv2. Tous les clients affectés seront avertis une semaine avant la migration automatique à venir. La migration automatique peut entraîner un temps d’arrêt pour vos consommateurs d’API en amont. Vous pouvez toujours migrer vos propres instances avant la migration automatique.

La configuration du réseau virtuel peut être supprimée pendant la migration automatique

Dans la plupart des cas, la migration automatique conserve les paramètres de réseau virtuel de votre instance Gestion des API s’ils sont configurés. Dans certaines conditions particulières, la configuration du réseau virtuel de votre instance de service stv1 est supprimée lors de la migration automatique et, par mesure de sécurité, l’accès à vos points de terminaison de service est bloqué. Si les paramètres réseau ont été supprimés lors du processus de migration, un message similaire à celui-ci s’affiche dans le portail : We have blocked access to all endpoints for your service.

Quand l’accès est bloqué, l’accès à la passerelle API, au portail des développeurs, à l’API de gestion directe et au référentiel Git est désactivé.

Restaurer l’accès et la configuration du réseau virtuel

Si l’accès est bloqué, vous pouvez restaurer l’accès à vos points de terminaison de service et à la configuration de votre réseau virtuel à l’aide du portail ou d’Azure CLI.

APIM_NAME={name of your API Management instance}
RG_NAME={name of your resource group}
SUBNET_NAME={name of the subnet where your API Management instance was originally deployed}
VNET_NAME={name of the virtual network where your API Management instance was originally deployed}
VNET_TYPE={external or internal}

# Get resource ID of subnet
SUBNET_ID=$(az network vnet subnet show \
    --resource-group $RG_NAME \
    --name $SUBNET_NAME \
    --vnet-name $VNET_NAME \
    --query id --output tsv)

# Get resource ID of API Management instance
APIM_RESOURCE_ID=$(az apim show \
    --resource-group $RG_NAME --name $APIM_NAME \
    --query id --output tsv)

# Enable access to service endpoints and restore virtual network configuration
az rest --method PATCH --uri "$APIM_RESOURCE_ID?api-version=2024-05-01" --body '{
    "properties": {
        "virtualNetworkType": "'$VNET_TYPE'",
        "virtualNetworkConfiguration": {
            "subnetResourceId": "'$SUBNET_ID'"
        },
        "customProperties": {
            "Microsoft.WindowsAzure.ApiManagement.Service.Disabled": "False"
        }
    }
}'

Aide et support

Nous vous proposons ici de vous aider à migrer vers la plateforme stv2 avec un minimum d’interruptions pour vos services.

Si vous avez des questions, interrogez les experts de la communauté dans Microsoft Q&A et obtenez des réponses rapides. Si vous disposez d’un plan de support et que vous avez besoin d’une aide technique, créez une demande de support.

1. Pour Résumé, tapez une description de votre problème, par exemple « mise hors service stv1 ».
2. Sous Type de problème, sélectionnez Technique.
3. Sous Abonnement, sélectionnez votre abonnement.
4. Sous Service, sélectionnez Mes services, puis Service de gestion des API.
5. Sous Ressource, sélectionnez la ressource Azure pour laquelle vous créez une demande de support.
6. Pour le Type de problème, sélectionnez Administration et gestion.
7. Pour le Sous-type de problème, sélectionnez Mettre à niveau, Mettre à l’échelle ou Modifier la référence SKU.

Contenu connexe

• Migrer de la plateforme stv1 vers stv2
• Consultez l’ensemble des changements et mises hors service nets des fonctionnalités.