Azure App Service の Service Management APIs が廃止されます
記載されている内容は 2018 年 3 月 21 日 時点のものとなり、現時点におきましては変更されている可能性がありますので、ご注意下さい。
このポストは、2018 年 3 月 12 日に投稿された Deprecating Service Management APIs support for Azure App Services の翻訳です。
Build 2014 にて、Azureは、呼ばれるリソース管理用の RESTful API である Azure Resource Manager と新しい Azure Portal を発表しました。 Azure App Service が Azure Resource Manager のサポートを実装して以来、すでに数年がたっています。ポータルや、REST API 、 その他の SDK やクライアント ツール を通してApp Service のリソースを管理や自動化をする場合や、 デプロイ用のテンプレート を使用してリソースをデプロイを行う際には、すでにAzure Resource Manager が利用されております。 一方、従来のAzure Service Management API を利用して自動化のためのスクリプトが構築されている場合は、このアナウンスが影響します。
Azure App Service のリソース管理は、Azure Resource Managerを介してのみサポートされるようになります。 Azure Service Management のサポートは 2018 年 6 月 30 日に廃止されます 。 Service Management の API は古く、現代のクラウドにはあまり適していません。 Service Management API を利用したままでは、優れた開発者エクスペリエンスが提供できず、 プレーン スケールの操作もできなくなります。 現在Service Management APIを使用しているお客様は、Resource Managerに移行してください。 Azure Resource Managerには、堅牢な導入モデル、ロールベースのアクセス、既存の機能や新しい機能のAPIサポートなど、サービス管理に比べて多くの利点があります。 詳細については、 Azure Service ManagerとAzure Resource Managerの違い を参照してください。
認証
Service Management では、Azure Active Directoryまたは管理証明書を使用した認証がサポートされています。 リソースマネージャの認証は、Azure Active Directoryアプリケーションと対話型ユーザーアクセスを中心に構築されています。 詳細については、 Resource Manager API Authentication を参照してください。 オートメーションで管理用の証明書を使用する必要がある場合は、 Authenticating to Azure Resource Manager using AAD and certificates を使用して自動化することができます。
リソースのデプロイメント
リソースマネージャには、宣言的なリソース記述を持つ堅牢なデプロイメントエンジンがあります。 両者のリソース デプロイメントの違いを理解するには、 Resource Manager Deployment Model を参照してください。 リソースマネージャは、 デプロイ用のテンプレート によるリソースのデプロイをサポートします。 また、Microsoft 2. Azure SDK for .NET 2.9以降、Visual Studioを使用したリソースの展開もサポートされています。 詳細については、Visual Studioを使用したリソースとコードの展開を参照してください。
API の呼び出し
Resource Manager REST APIを直接コーディングする場合は、 Azure App Service REST API のドキュメントを参照してください。 ARMClient と Azure Resource Explorer は、App Service Resource Manager API がどのようになっているのか調べるための素晴らしいツールです。 ARMClientの詳細については、 ARMClient: a command line tool for the Azure API を参照してください。
SDKとツール
Resource Managerは、SDK やツールを多数の言語、フレームワーク、プラットフォームで提供します。 これらには、.NET、Node、Java、Ruby、Python、Go、PowerShell、Azure CLIが含まれますが、これだけではありません。 詳細なドキュメント、チュートリアル、サンプルが ここ にあります。
Appサービスリソースメトリック
自動化のためのスクリプトなどが App Service Resource Metrics API を使用していた場合は、 Azure Resource Manager Monitoring API に切り替えることをお勧めします。 App Service 固有のメトリックAPIは引き続き提供していますが、間もなくその API を廃止にする予定です。 Resource Manager Monitoring API は、Azure 内の任意のサービス上の任意のリソースでメトリックとやりとりする共通的な方法です。 詳細については、 Azure Monitor でサポートされているメトリック を参照してください。
2018 年 6 月 30 日 より前に、すべての自動化ツールとデプロイメントツールを新しいAPIを使用するように移行すれば、サービスの中断を防ぎ、やAzure Resource Manager の優れたデプロイメントと管理機能の恩恵を受けるようにしましょう。
補足:
Service Management API を利用している例としては、Azure Service Management PowerShell Module 内のコマンドレットが挙げられます。
Get-AzureWebsite など、 こちら に記載されております Web Apps に関連するコマンドレットは利用できなくなる可能性がございますのでご注意ください。