Управление API выхода на пенсию платформы stv1 — Azure для государственных организаций и Azure, управляемые 21Vianet (февраль 2025 г.)

ОБЛАСТЬ ПРИМЕНЕНИЯ: Разработчик | Базовый | Стандартный | Премия

Являясь облачной платформой как услугой (PaaS), Управление API Azure абстрагирует многие детали инфраструктуры, используемой для размещения и запуска вашей службы. Инфраструктура, связанная с версией вычислительной платформы Управление APIstv1, будет прекращена с 24 февраля 2025 г. в Microsoft Azure для государственных организаций и в Microsoft Azure под управлением 21 Vianet (Azure в Китае). Более свежая версия платформы вычислений (stv2) уже доступна и предоставляет расширенные возможности службы.

В следующей таблице описаны вычислительные платформы, используемые сейчас для экземпляров на разных уровнях служб Управления API.

Для продолжения поддержки и использования предстоящих функций клиенты должны перенести свои экземпляры Azure Управление API с вычислительной stv1 платформы на вычислительную платформуstv2. Платформа вычислений stv2 поставляется с дополнительными функциями и улучшениями, такими как поддержка Приватного канала Azure и других сетевые возможности.

Новые экземпляры, созданные на уровнях служб, отличных от уровня "Потребление", в основном уже размещены на платформе stv2. Существующие экземпляры на платформе вычислений stv1 будут и дальше нормально работать до даты прекращения поддержки, но эти экземпляры не получат новейшие функции, доступные для платформы stv2.

Повлияет ли это на мою службу?

Если значение platformVersion свойства вашей службы имеет stv1значение, оно размещено на stv1 платформе. Дополнительные сведения см. в разделе Как узнать, на какой платформе размещен мой экземпляр Управления API.

Каков крайний срок внесения изменения?

В Azure для государственных организаций и Azure, управляемых 21Vianet, поддержка Управление API экземпляров, размещенных на stv1 платформе, будет прекращена к 24 февраля 2025 г.

Кроме того, по состоянию на 1 сентября 2024 г. Управление API больше не будет Управление API экземпляров, работающих на вычислительной stv1 платформе с соглашением об уровне обслуживания.

Что мне нужно сделать?

Перенос всех существующих экземпляров, размещенных на вычислительной stv1 платформе, на stv2 вычислительную платформу к 24 февраля 2025 г.

Если у вас есть существующие экземпляры, размещенные на stv1 платформе, следуйте нашему руководству по миграции, чтобы обеспечить успешную миграцию.

Окончание обязательства по соглашение об уровне обслуживания для stv1 экземпляров — 1 сентября 2024 г.

По состоянию на 1 сентября 2024 г. Управление API больше не предоставляет никаких гарантий уровня обслуживания и по кредитам службы расширения для проблем с производительностью или доступностью, связанными с экземплярами службы Developer, Basic, Standard и Premium, работающими на stv1 вычислительной платформе. Кроме того, новые инвестиции в безопасность и соответствие требованиям не будут сделаны на платформе Управление APIstv1.

Благодаря продолжению использования экземпляра, размещенного на stv1 платформе за 1 сентября 2024 года, вы признаете, что Azure не фиксирует соглашение об уровне обслуживания 99,95%.

Автоматическая миграция

После даты выхода на пенсию мы автоматически переносим оставшиеся stv1 экземпляры служб на вычислительную платформу stv2 . Все затронутые клиенты будут уведомлены о предстоящей автоматической миграции за неделю заранее. Автоматическая миграция может привести к простою для потребителей вышестоящего API. Вы по-прежнему можете перенести собственные экземпляры, прежде чем происходит автоматическая миграция.

Конфигурация виртуальной сети может быть удалена во время автоматической миграции

В большинстве случаев автоматическая миграция сохраняет параметры виртуальной сети Управление API экземпляра, если они настроены. При определенных особых условиях конфигурация виртуальной сети экземпляра службы удаляется во время автоматической stv1 миграции и в качестве меры безопасности доступ к конечным точкам службы блокируется. Если параметры сети были удалены во время миграции, вы увидите сообщение на портале, аналогичное: We have blocked access to all endpoints for your service

Если доступ заблокирован, доступ к шлюзу API, порталу разработчика, API прямого управления и репозиторию Git отключен.

Восстановление конфигурации доступа и виртуальной сети

Если доступ заблокирован, вы можете восстановить доступ к конечным точкам службы и конфигурации виртуальной сети с помощью портала или 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"
        }
    }
}'

Помощь и поддержка

Мы здесь, чтобы помочь вам перейти на stv2 платформу с минимальными нарушениями в ваших службах.

Если у вас есть вопросы, получите быстрые ответы от экспертов сообщества в Microsoft Q&A. Если у вас есть план поддержки и вам нужна техническая помощь, создайте запрос на поддержку.

1. В поле Сводка введите описание проблемы, например "Прекращение поддержки stv1".
2. В поле Тип проблемы укажите Техническая.
3. В разделе Подписка выберите свою подписку.
4. В разделе Служба выберите Мои службы и щелкните Служба Управления API.
5. В разделе Ресурс выберите ресурс Azure, для которого вы создаете запрос в службу поддержки.
6. В поле Тип проблемы выберите Администрирование и управление.
7. В поле Подтип проблемы выберите Обновление, масштабирование или изменение SKU.

Связанный контент

• Переход с платформы stv1 на stv2
• Просмотрите все предстоящие основные изменения и прекращение поддержки функций.