API Management stv1 プラットフォームの提供終了 - グローバル Azure クラウド (2024 年 8 月)

APPLIES TO: Developer | Basic | Standard | Premium

クラウドの PaaS (サービスとしてのプラットフォーム) である Azure API Management では、サービスのホストと実行に使用されるインフラストラクチャのさまざまな点が抽象化されています。 API Management stv1 コンピューティング プラットフォーム バージョンに関連付けられているインフラストラクチャは、グローバルな Microsoft Azure クラウドで 2024 年 8 月 31 日に廃止されます。 それよりも新しいコンピューティング プラットフォーム バージョン (stv2) が既に提供されていて、サービスの機能も強化されています。

注

21Vianet クラウド (中国の Azure) によって運用されている Microsoft Azure Government クラウドまたは Microsoft Azure にデプロイされた API Management インスタンスの場合、 stv1 プラットフォームの提供終了日は 2025 年 2 月 24 日です。 詳細情報

次の表は、さまざまな API Management サービス レベルのインスタンスに現在使用されているコンピューティング プラットフォームをまとめたものです。

バージョン	説明	アーキテクチャ	層
stv2	Single-tenant v2	Azure によって割り当てられるコンピューティング インフラストラクチャ。可用性ゾーンやプライベート エンドポイントがサポートされます	Developer、Basic、Standard、Premium
stv1	Single-tenant v1	Azure によって割り当てられるコンピューティング インフラストラクチャ	Developer、Basic、Standard、Premium
mtv1	マルチテナント v1	共有インフラストラクチャ。ネイティブの自動スケーリングをサポートし、トラフィックのない時間はゼロにスケール ダウンされます	消費

サポートを継続し、今後の機能を利用するには、 コンピューティング プラットフォームから stv1 コンピューティング プラットフォームに Azure API Management インスタンスをstv2する必要があります。 stv2 コンピューティング プラットフォームには、Azure Private Link をはじめとするネットワーク機能がサポートされるなど、新たな機能や改善が加えられています。

従量課金レベル以外のサービス レベルで作成された新しいインスタンスは既に、ほとんどが stv2 プラットフォームでホストされます。 stv1 コンピューティング プラットフォーム上の既存のインスタンスは、提供終了日まで引き続き正常に動作しますが、これらのインスタンスには、stv2 プラットフォームで使用できる最新の機能は提供されません。 stv1 インスタンスのサポートは、2024 年 8 月 31 日で廃止される予定です。

私が利用しているサービスは影響を受けますか?

ご利用のサービスの platformVersion プロパティの値が stv1 の場合、そのサービスは stv1 プラットフォームでホストされています。 「API Management インスタンスのホストとなっているプラットフォームは、どのようにして確認できますか?」を参照してください。

変更の期日

stv1 プラットフォームでホストされている API Management インスタンスのサポートは、2024 年 8 月 31 日で廃止される予定です。

何をする必要がありますか?

stv1 コンピューティング プラットフォームでホストされているすべての既存のインスタンスを、stv2 コンピューティング プラットフォームに移行します。

stv1 プラットフォームでホストされている既存のインスタンスがある場合は、確実に移行を成功させるために、移行ガイドに従ってください。

2024 年 8 月 31 日以降はどうなりますか?

stv1 インスタンスはシャットダウン、非アクティブ化、または削除されません。 ただし、インスタンスの SLA コミットメントは終了し、提供終了日より後の stv1 インスタンスは、 stv2 プラットフォームへの自動移行がスケジュールされます。

stv1 インスタンスの SLA コミットメントの終了

2024 年 9 月 1 日の時点で、API Management は、 stv1 コンピューティング プラットフォームで実行されている Developer、Basic、Standard、および Premium サービス インスタンスに関連するパフォーマンスまたは可用性の問題について、サービス レベルの保証と拡張サービス クレジットによって提供されなくなります。 また、API Management stv1 プラットフォームでは、新しいセキュリティとコンプライアンスへの投資は行われません。

提供終了日を超えて stv1 プラットフォームでホストされているインスタンスを引き続き使用すると、廃止されたインスタンスに対して Azure が 99.95% の SLA にコミットしないことを確認できます。

自動移行

提供終了日が過ぎると、残りの stv1 サービス インスタンスが stv2 コンピューティング プラットフォームに自動的に移行されます。 影響を受けるすべてのお客様には、1 週間前にまもなく行われる自動移行について通知されます。 自動移行により、アップストリーム API コンシューマーにダウンタイムが発生する可能性があります。 自動移行が行われる前に、独自のインスタンスを移行することはできます。

仮想ネットワークの構成は、自動移行中に削除される可能性があります

ほとんどの場合、自動移行では、API Management インスタンスの仮想ネットワーク設定は保持されます (構成されている場合)。 特定の特殊な状況では、自動移行中に stv1 サービス インスタンスの仮想ネットワーク構成が削除され、セキュリティ対策として、サービス エンドポイントへのアクセスがブロックされます。 移行プロセス中にネットワーク設定が削除された場合、ポータルに次のようなメッセージが表示されます: We have blocked access to all endpoints for your service。

アクセスがブロックされている間、API ゲートウェイ、開発者ポータル、Direct Management API、Git リポジトリへのアクセスは無効になります。

アクセスと仮想ネットワークの構成を復元する

アクセスがブロックされている場合は、ポータルまたは Azure CLI を使用して、サービス エンドポイントと仮想ネットワーク構成へのアクセスを復元できます。

ヒント

API Management インスタンスが最初にデプロイされた仮想ネットワークとサブネットの名前を思い出す必要がある場合は、ポータルで情報を見つけることができます。 インスタンスの左側のメニューで、[問題の診断と解決]>[可用性とパフォーマンス]>[VNet Verifier] の順に選択します。 [時間範囲] で、インスタンスが移行される前の期間を選択します。

ポータル

1. ポータルのインスタンスの [概要] ページで、[サービスのブロック解除] を選択します。 このアクションは、元に戻すことはできません。

   警告

   サービス エンドポイントへのアクセスのブロックを解除すると、インターネットからパブリックにアクセスできるようになります。 環境を保護するには、アクセスのブロックを解除した後、できるだけ早く仮想ネットワークを再確立してください。

2. 仮想ネットワークに API Management インスタンスを再デプロイします。

   手順については、外部または内部の仮想ネットワークに API Management をデプロイするためのガイダンスを参照してください。 API Management コンピューティング プラットフォームと互換性のある設定を使用して、仮想ネットワークのstv2にインスタンスをデプロイすることを強くお勧めします。

Azure CLI

次の Azure CLI コマンドを実行して、API Management インスタンスへのアクセスを有効にし、指定された仮想ネットワークの構成を復元します。

注

bash シェル用に次のスクリプトが記述されています。 PowerShell でスクリプトを実行するには、変数を設定するときに、各変数名に $ 文字のプレフィックスを付けます。 例: $APIM_NAME=...。

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 Management サービス] を選択します。
5. [リソース] で、サポート リクエストを作成する Azure リソースを選択します。
6. [問題の種類] で [管理] を選択します。
7. [問題のサブタイプ] で [Upgrade, Scale or SKU Changes] (アップグレード、スケーリング、SKU の変更) を選択します。

注

Azure サポート、自動移行のタイムラインや、提供終了日より後のstv1 インスタンスの SLA サポートのタイムラインを拡張することはできません。

関連コンテンツ

• stv1 プラットフォームから stv2 に移行する
• 予定されているすべての破壊的変更と機能の廃止に関する記事を参照してください。