

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 订阅和访问包含以下内容的 AWS Data Exchange 产品 APIs
<a name="subscribing-to-API-product"></a>

以下主题描述了使用 AWS Data Exchange 控制台订阅和访问包含 APIs AWS Data Exchange 的产品的完整过程。

有关如何在订阅前评估产品的信息，请参阅[评估包含数据字典和样本的产品](subscriber-getting-started.md#evaluate-products)。

此过程包含以下步骤：

**Topics**
+ [第 1 步：订阅包含以下内容的产品 APIs](#subscribe-to-API-product)
+ [步骤 2：访问 API 产品](#use-API-product)

要练习订阅和访问包含以下内容的产品 APIs，请参阅。[AWS Data Exchange fo APIs r（测试产品）](subscriber-tutorial-api-product.md)

## 第 1 步：订阅包含以下内容的产品 APIs
<a name="subscribe-to-API-product"></a>

如果您订阅了付费产品，则会根据您的 AWS 账单进行计费。您可以访问所有授权的数据集。有关更多信息，请参阅 [在上订阅 AWS Data Exchange 数据产品 AWS Data Exchange](subscribe-to-data-sets.md)。

供应商可能会在其产品中包含 APIs计量成本。如果提供商降低计量成本，则降价会立即生效。如果提供商提高计量成本，而您是现有订阅者，则价格上调将在当月的第一天、提交价格上调后的 90 天或续订时生效（以较早者为准）。提交价格变动后，系统会向现有订阅者发送一封电子邮件。

**Example**  
例如，假设提供商在 5 月 10 日提交了计量成本价格上调。现有订阅者会收到一封关于价格变动的电子邮件。价格上调将于 9 月 1 日生效。



**订阅包含以下内容的产品 APIs**

1. 打开并登录 [AWS Data Exchange 控制台](https://console.aws.amazon.com/dataexchange)。

1. 在左侧导航窗格的**发现数据产品**下，选择**浏览目录**。

   有关更多信息，请参阅[浏览目录](subscriber-getting-started.md#browse-catalog)。

1. 在 “**优化结果**” 下，使用**数据集类型**筛选器并选择 **API** 来查找包含的产品 APIs。

   有关更多信息，请参阅[浏览目录](subscriber-getting-started.md#browse-catalog)。

1. 选择包含的商品 APIs，然后查看其商品详情页面。

   产品详细信息页面上包括产品描述、提供商的联系信息以及产品公开优惠的详细信息。公开优惠信息包括价格和持续时间、计量成本（如果包含在内）、数据订阅协议 (DSA) 和退款政策。您可以查看产品中包含的数据集的名称以及它们 AWS 区域 在哪些名称中可用。您也可以在**类似的产品**下选择一种产品，继续浏览其他产品详细信息页面。

   如果提供商已向您的账户发布自定义优惠 [例如，[专属优惠](subscribe-to-private-offer.md)或[自带订阅 (BYOS) 优惠](subscribe-to-byos-offer.md)]，您也会看到这些详细信息。

   1. 在**公开优惠**下，查看 **API 计量成本**（如果包含在内）。

   1. （可选）在**计量成本计算器**中，选择**选择计量成本**，然后输入单位数量，以显示成本示例。

1. 在右上角，选择**继续订阅**。

1. 选择您的首选价格和持续时间组合，选择是否为该订阅启用自动续订，并查看优惠详细信息，包括 DSA。
**注意**  
有些产品需要订阅验证。有关更多信息，请参阅 [订阅者的订阅验证 AWS Data Exchange](subscription-verification-sub.md)。

1. 查看定价信息，选择定价优惠，然后选择**订阅**。
**注意**  
如果您订阅了付费产品，系统会提示您确认订阅的决定。

1. 在**订阅中包含的数据集**下，查看列出的**数据集**。

   订阅处理完毕后，您可以选择一个数据集来访问您的授权数据，或者选择**查看订阅**，查看您的订阅。

## 步骤 2：访问 API 产品
<a name="use-API-product"></a>

以下主题详细介绍了如何访问包含 API 数据集的产品：

**Topics**
+ [查看 API](#view-the-api)
+ [下载 API 规范](#download-api-spec)
+ [进行 API 调用（控制台）](#make-api-call-console)
+ [进行 API 调用 (AWS CLI)](#make-api-call-cli)

### 查看 API
<a name="view-the-api"></a>

**要查看 API，请按以下步骤操作：**

1. 打开并登录 [AWS Data Exchange 控制台](https://console.aws.amazon.com/dataexchange)。

1. 在左侧导航窗格中的**我的订阅**下，选择**授权数据**。

1. 选择一个数据集。

1. 在**修订**选项卡下，选择一个修订。

1. 在 **API 资产**下，选择该 API。

1. 查看**资产概览**。

1. 按照**集成说明**中的指导调用该 API。

### 下载 API 规范
<a name="download-api-spec"></a>

**要下载 API 规范，请按以下步骤操作：**

1. 打开并登录 [AWS Data Exchange 控制台](https://console.aws.amazon.com/dataexchange)。

1. 在左侧导航窗格中的**我的订阅**下，选择**授权数据**。

1. 选择一个数据集。

1. 在**修订**选项卡下，选择一个修订。

1. 在 **API 资产**下，选择该 API。

1. 在 **OpenAPI 3.0 规范**中，选择**下载 API 规范**。

   该规范将下载到您的本地计算机。然后，您可以将资产导出到第三方工具以生成 SDK。

### 进行 API 调用（控制台）
<a name="make-api-call-console"></a>

您可以在 AWS Data Exchange 控制台中调用单个终端节点。

**要从控制台发出 API 调用，请按以下步骤操作：**

1. 打开并登录 [AWS Data Exchange 控制台](https://console.aws.amazon.com/dataexchange)。

1. 在左侧导航窗格中的**我的订阅**下，选择**授权数据**。

1. 选择一个数据集。

1. 在**修订**选项卡下，选择一个修订。

1. 在 **API 资产**下，选择该 API。

1. 对于**集成说明**：

   1. 选择**复制**，以使用**基本 URL**。

   1. 选择**复制**，以使用**代码结构**。

   1. 按照规范文档中提供的信息调用该 API。

### 进行 API 调用 (AWS CLI)
<a name="make-api-call-cli"></a>

**要进行 API 调用 (AWS CLI)，请按以下步骤操作：**
+ 使用 `send-api-asset` 命令调用 API。

  ```
  $ AWS dataexchange send-api-asset \
    --asset-id $ASSET_ID \
    --data-set-id $DATA_SET_ID \
    --revision-id $REVISION_ID \
    --body "..." \
  {
      "headers": {
          ...
      },
      "body": "..."
  }
  ```