本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 訂閱和存取包含 APIs AWS Data Exchange 的產品
<a name="subscribing-to-API-product"></a>

下列主題說明 AWS Data Exchange 使用 AWS Data Exchange 主控台訂閱和存取 上包含 APIs的產品的完整程序。

如需有關如何在訂閱之前評估產品的資訊，請參閱[評估包含資料字典和範例的產品](subscriber-getting-started.md#evaluate-products)。

程序包含下列步驟：

**Topics**
+ [

## 步驟 1：訂閱包含 APIs的產品
](#subscribe-to-API-product)
+ [

## 步驟 2：存取 API 產品
](#use-API-product)

若要練習訂閱和存取包含 APIs的產品，請參閱 [AWS Data Exchange 適用於 APIs （測試產品）](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": "..."
  }
  ```