リゾルバーの HTTP データ ソース

適用対象: すべての API Management レベル

http-data-source リゾルバー ポリシーは、GraphQL スキーマ内のオブジェクト タイプとフィールドのデータを解決するために HTTP 要求を構成し、必要に応じて HTTP 応答を構成します。 スキーマは API Management に GraphQL API としてインポートする必要があります。

ポリシー ステートメント

<http-data-source> 
    <http-request>
        <get-authorization-context>...get-authorization-context policy configuration...</get-authorization-context>
        <set-backend-service>...set-backend-service policy configuration...</set-backend-service>
        <set-method>...set-method policy configuration...</set-method> 
        <set-url>URL</set-url>
        <include-fragment>...include-fragment policy configuration...</include-fragment>
        <set-header>...set-header policy configuration...</set-header>
        <set-body>...set-body policy configuration...</set-body>
        <authentication-certificate>...authentication-certificate policy configuration...</authentication-certificate>  
    </http-request> 
    <backend>
        <forward-request>...forward-request policy configuration...</forward-request>
    <http-response>
        <set-body>...set-body policy configuration...</set-body>
        <xml-to-json>...xml-to-json policy configuration...</xml-to-json>
        <find-and-replace>...find-and-replace policy configuration...</find-and-replace>
        <publish-event>...publish-event policy configuration...</publish-event>
        <include-fragment>...include-fragment policy configuration...</include-fragment>
    </http-response>
</http-data-source> 

要素

http-request 要素

backend 要素

http-response 要素

使用法

• ポリシー スコープ: GraphQL リゾルバー
• ゲートウェイ: クラシック、v2、従量課金

使用上の注意

• このポリシーを使用してリゾルバーを構成および管理するには、「GraphQL リゾルバーを構成する」を参照してください。
• このポリシーは、スキーマ内の一致する GraphQL 操作の種類の 1 つのフィールドを解決する場合にのみ呼び出されます。

例

GraphQL クエリのリゾルバー

次の例では、バックエンド データ ソースへの HTTP GET 呼び出しを行ってクエリを解決します。

スキーマの例

type Query {
    users: [User]
}

type User {
    id: String!
    name: String!
}

サンプル ポリシー

<http-data-source>
    <http-request>
        <set-method>GET</set-method>
        <set-url>https://data.contoso.com/get/users</set-url>
    </http-request>
</http-data-source>

リキッド テンプレートを使用してリストを返す GraqhQL クエリのリゾルバー

次の例では、set-body ポリシーで使用するためにサポートされている液体テンプレートを使用して、HTTP 応答の一覧をクエリに返します。 また、REST API からの応答の username フィールド名が、GraphQL 応答の name に変更されます。

スキーマの例

type Query {
    users: [User]
}

type User {
    id: String!
    name: String!
}

サンプル ポリシー

<http-data-source>
    <http-request>
        <set-method>GET</set-method>
        <set-url>https://data.contoso.com/users</set-url>
    </http-request>
    <http-response>
        <set-body template="liquid">
            [
                {% JSONArrayFor elem in body %}
                    {
                        "name": "{{elem.username}}"
                    }
                {% endJSONArrayFor %}
            ]
        </set-body>
    </http-response>
</http-data-source>

GraphQL 変化のリゾルバー

次の例では、HTTP データ ソースに POST 要求を行ってデータを挿入する変更を解決します。 HTTP 要求の set-body ポリシー内のポリシー式は、GraphQL クエリで本文として渡される name 引数を変更します。 送信される本文は、次の JSON のようになります。

{
    "name": "the-provided-name"
}

スキーマの例

type Query {
    users: [User]
}

type Mutation {
    makeUser(name: String!): User
}

type User {
    id: String!
    name: String!
}

サンプル ポリシー

<http-data-source>
    <http-request>
        <set-method>POST</set-method>
        <set-url>https://data.contoso.com/user/create </set-url>
        <set-header name="Content-Type" exists-action="override">
            <value>application/json</value>
        </set-header>
        <set-body>@{
            var args = context.GraphQL.Arguments;  
            JObject jsonObject = new JObject();
            jsonObject.Add("name", args["name"])
            return jsonObject.ToString();
        }</set-body>
    </http-request>
</http-data-source>

GraphQL 共用体型のリゾルバー

次の例では、バックエンド データ ソースへの orderByIdHTTP 呼び出しを行ってクエリGETを解決し、顧客 ID と型を含む JSON オブジェクトを返します。 顧客の型は、RegisteredCustomer 型と GuestCustomer 型の和集合です。

スキーマの例

type Query {
  orderById(orderId: Int): Order
}

type Order {
  customerId: Int!
  orderId: Int!  
  customer: Customer
}

enum AccountType {
  Registered
  Guest
}

union Customer = RegisteredCustomer | GuestCustomer

type RegisteredCustomer {
  accountType: AccountType!
  customerId: Int!
  customerGuid: String!
  firstName: String!
  lastName: String!
  isActive: Boolean!
}

type GuestCustomer {
  accountType: AccountType!
  firstName: String!
  lastName: String!
}

サンプル ポリシー

この例では、外部ソースから顧客の結果をモックし、フェッチされた結果を set-body ポリシーにハード コーディングします。 __typename フィールドは、顧客の型を決定するために使用されます。

<http-data-source>
    <http-request>
        <set-method>GET</set-method>
        <set-url>https://data.contoso.com/orders/</set-url>
    </http-request>
    <http-response>
        <set-body>{"customerId": 12345, "accountType": "Registered", "__typename": "RegisteredCustomer" }
        </set-body>
    </http-response>
</http-data-source>

関連ポリシー

• GraphQL リゾルバー

関連するコンテンツ

ポリシーに対する処理の詳細については、次のトピックを参照してください。

• チュートリアル:API を変換および保護する
• ポリシー ステートメントとその設定の一覧に関するポリシー リファレンス
• ポリシー式
• ポリシーの設定または編集
• ポリシー構成を再利用する
• ポリシー スニペットのリポジトリ
• Azure API Management ポリシー ツールキット
• Azure で Microsoft Copilot を使用してポリシーを作成する