Azure カスタム リソース プロバイダーの概要

Azure カスタム リソース プロバイダーは、Azure の拡張性プラットフォームです。 これにより、既定の Azure エクスペリエンスを強化するために使用できるカスタム API を定義できます。 このドキュメントでは、次の内容について説明します。

• Azure カスタム リソース プロバイダーをビルドしてデプロイする方法。
• Azure カスタム リソース プロバイダーを使用して既存のワークフローを拡張する方法。
• 使用を開始するガイドとコード サンプルの場所。

カスタム リソース プロバイダーができること

Azure カスタム リソース プロバイダーで実現できる機能の例を次に示します。

• Azure Resource Manager REST API を拡張して、内部サービスと外部サービスを含めます。
• 既存の Azure ワークフローに基づいてカスタム シナリオを有効にします。
• Azure Resource Manager テンプレートの制御と効果をカスタマイズします。

カスタム リソース プロバイダーとは

Azure カスタム リソース プロバイダーは、Azure とエンドポイントの間にコントラクトを作成することによって作成されます。 このコントラクトでは、新しいリソース である Microsoft.CustomProviders/resourceProviders を使用して、新しいリソースとアクションの一覧を定義します。 その後、カスタム リソース プロバイダーは、これらの新しい API を Azure で公開します。 Azure カスタム リソース プロバイダーは、カスタム リソース プロバイダー、エンドポイント、カスタム リソース の 3 つの部分で構成されます。

カスタム リソース プロバイダーを構築する方法

カスタム リソース プロバイダーは、Azure とエンドポイントの間のコントラクトの一覧です。 これらのコントラクトでは、Azure がエンドポイントと対話する方法について説明します。 リソース プロバイダーはプロキシのように動作し、指定されたエンドポイントとの間で要求と応答を転送 します。 リソース プロバイダーは、 resourceTypes と アクションという 2 種類のコントラクトを指定できます。 これらは、エンドポイント定義によって有効になります。 エンドポイント定義は、 name、 routingType、endpoint の 3 つのフィールドで構成 されます。

サンプル エンドポイント:

{
  "name": "{endpointDefinitionName}",
  "routingType": "Proxy",
  "endpoint": "https://{endpointURL}/"
}

カスタム リソースのビルド

ResourceTypes では、 Azure に追加される新しいカスタム リソースについて説明します。 これらは、基本的な RESTful CRUD メソッドを公開します。 カスタム リソースの作成の詳細

resourceTypes を使用したカスタム リソース プロバイダーのサンプル:

{
  "properties": {
    "resourceTypes": [
      {
        "name": "myCustomResources",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

上記のサンプル用に Azure に追加された API:

カスタム アクションの作成

アクション は、Azure に追加される新しいアクションを記述します。 これらは、リソース プロバイダーの上に公開することも、 resourceType の下に入れ子にすることもできます。 カスタム アクションの作成の詳細

アクションを含むカスタム リソース プロバイダーのサンプル:

{
  "properties": {
    "actions": [
      {
        "name": "myCustomAction",
        "routingType": "Proxy",
        "endpoint": "https://{endpointURL}/"
      }
    ]
  },
  "location": "eastus"
}

上記のサンプル用に Azure に追加された API:

ヘルプを探しています

Azure カスタム リソース プロバイダーの開発に関する質問がある場合は、 Stack Overflow で質問してみてください。 同様の質問が既に質問され、回答されている可能性があるため、投稿する前に最初に確認してください。 タグ azure-custom-providers を追加して、迅速な応答を得ます。

次のステップ

この記事では、カスタム リソース プロバイダーについて説明しました。 次の記事に進み、カスタム リソース プロバイダーを作成します。

• クイックスタート: Azure カスタム リソース プロバイダーの作成とカスタム リソースのデプロイ
• チュートリアル: Azure でカスタム アクションとリソースを作成する
• 方法: Azure REST API にカスタム アクションを追加する
• 方法: Azure REST API にカスタム リソースを追加する