

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# AWS Data Exchange APIsテスト製品)
<a name="subscriber-tutorial-api-product"></a>

AWS Data Exchange for APIs (テスト製品) は、API データセットを含む製品を操作する方法を理解するためにサブスクライバーが利用できる無料の AWS Data Exchange 製品です。この製品をテスト目的で使用したり、API ベースのデータを取得するためにプロバイダーに API 呼び出しを行う方法を学習したりできます。

AWS Data Exchange for APIs (テスト製品) には、米国東部 (バージニア北部) リージョンにある API **AWS Data Exchange (テスト製品) の という名前APIs ** データセットが含まれています。

**Topics**
+ [APIs AWS Data Exchange の へのサブスクライブ (テスト製品)](subscribe-to-API-test-product.md)
+ [API の表示](tutorial-view-api.md)
+ [API 仕様のダウンロード](tutorial-download-api-spec.md)
+ [API コールを実行する](tutorial-make-api-call-console.md)

# での APIs (テスト製品) AWS Data Exchange の へのサブスクライブ AWS Data Exchange
<a name="subscribe-to-API-test-product"></a>

次の手順は、 AWS Data Exchange カタログを参照して for APIs (テスト製品) AWS Data Exchange を検索してサブスクライブする方法を示しています。

**AWS Data Exchange APIs (テスト製品) を検索してサブスクライブするには**

1. [AWS Data Exchange コンソール](https://console.aws.amazon.com/dataexchange) を開いてサインインします。

1. 左側のナビゲーションペインにある **[データ製品の検出]** で **[カタログを参照]** を選択します。

1. 検索フィールドに **AWS Data Exchange for APIs** を入力して、**[Enter]** キーを押します。

1. **API 用AWS Data Exchange (テスト製品)** を選択し、その詳細ページを表示します。

   1. (オプション) サンプルをダウンロードするには、「**データディクショナリとサンプル**」タブを選択し、サンプル名 (**ADX for API sample.json**) の横にあるオプションボタンを選択し、「**ダウンロード**」を選択します。

1. 右上隅にある **[サブスクリプションを続行する]** を選択します。

1. **製品オファーを選択します。**
**注記**  
AWS Data Exchange for APIs (テスト製品) は無料製品です。

1. **サブスクリプション条件**、**データセット**、**サポート情報**を確認してください。

1. サブスクリプションについて **[オファーの自動更新]** を有効にするかどうかを選択します。
**注記**  
AWS Data Exchange for APIs (テスト製品) ではサブスクリプションの検証は必要ありませんが、一部の製品では検証が必要です。詳細については、「[のサブスクライバーのサブスクリプション検証 AWS Data Exchange](subscription-verification-sub.md)」を参照してください。

1. **[サブスクライブ]** を選択します。

**[サブスクライブ]** を選択してからサブスクリプションがアクティブになるまでは、数分かかる場合があります。サブスクリプションがアクティブになる前にこのページから移動しても、サブスクリプションの処理は停止されませんが、

# AWS Data Exchange API の表示
<a name="tutorial-view-api"></a>

次のステップを使用して、 for API (テスト製品) AWS Data Exchange で APIs を表示できます。

**API を表示するには**

1. [AWS Data Exchange コンソール](https://console.aws.amazon.com/dataexchange) を開いてサインインします。

1. 左側のナビゲーションペインにある **[マイサブスクリプション]** で **[権限を持つデータ]** を選択します。

1. **API 用 **AWS Data Exchange** (テスト製品)** というタイトルの製品を選択し、次に **API 用AWS Data Exchange ** データセットを選択します。

1. **[リビジョン]** タブで、リビジョンを選択します。

1. **[API アセット]** で、API を選択します。

1. **アセットの概要を表示します**。

1. **[統合に関する注意事項]** にあるガイドラインに従って API を呼び出します。

# AWS Data Exchange API 仕様のダウンロード
<a name="tutorial-download-api-spec"></a>

次のステップを使用して、 for API (テスト製品) AWS Data Exchange を使用して APIs 仕様をダウンロードできます。

**API 仕様をダウンロードする**

1. [AWS Data Exchange コンソール](https://console.aws.amazon.com/dataexchange) を開いてサインインします。

1. 左側のナビゲーションペインにある **[マイサブスクリプション]** で **[権限を持つデータ]** を選択します。

1. **API 用 **AWS Data Exchange** (テスト製品)** というタイトルの製品を選択し、次に **API 用AWS Data Exchange ** データセットを選択します。

1. **[リビジョン]** タブで、リビジョンを選択します。

1. **[API アセット]** で、API を選択します。

1. **[OpenAPI 3.0 仕様]** で、**[API 仕様をダウンロード]** を選択します。

   お使いのローカルコンピュータに仕様がダウンロードされます。その後、SDK 生成のためにアセットをサードパーティーツールにエクスポートできます。

# AWS Data Exchange API コールの実行
<a name="tutorial-make-api-call-console"></a>

 AWS Data Exchange コンソールで 1 つのエンドポイントを呼び出すことができます。

**コンソールから API コールを実行する**

1. [AWS Data Exchange コンソール](https://console.aws.amazon.com/dataexchange) を開いてサインインします。

1. 左側のナビゲーションペインにある **[マイサブスクリプション]** で **[権限を持つデータ]** を選択します。

1. 「**API 用 **AWS Data Exchange** (テスト製品)**」というタイトルの製品を選択し、次に「**API 用AWS Data Exchange **」データセットを選択します。

1. **[リビジョン]** タブで、リビジョンを選択します。

1. **[API アセット]** で、API を選択します。

   API リクエストを構造化するためのサンプル **Code 構造**と **OpenApi 3.0 仕様**が表示されます。これを で使用 AWS Command Line Interface して API を呼び出すことができます。

1. 「**統合メモ**」で、「**コピー**」を選択して**コード構造**をコピーし、 AWS CLIに貼り付けます。

1. 仕様書に記載されている情報を使用して、サンプル値を必要なパラメータのキーと値のペアに置き換えます。

   API 用AWS Data Exchange (テスト製品) の API リクエストの例を以下に示します。

   ```
   aws dataexchange send-api-asset \
     --data-set-id 8d494cba5e4720e5f6072e280daf70a8 \
     --revision-id b655d5be3da04fcbdca21a5a2932d789 \
     --asset-id 8550cfab16b444a794402f2c3f11eae1 \
     --method POST \
     --path "someresource" \
     --query-string-parameters 'param1=value1,param2=value2' \
     --request-headers 'header=header_value' \
     --body "{\"body_param\":\"body_param_value\"}"
   ```