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

# 在 AWS Device Farm 中建立裝置集區
<a name="how-to-create-device-pool"></a>

您可以使用 Device Farm 主控台 AWS CLI或 API 來建立裝置集區。

**Topics**
+ [先決條件](#how-to-create-device-pool-prerequisites)
+ [建立裝置集區 （主控台）](#how-to-create-device-pool-console)
+ [建立裝置集區 (AWS CLI)](#how-to-create-device-pool-cli)
+ [建立裝置集區 (API)](#how-to-create-device-pool-api)

## 先決條件
<a name="how-to-create-device-pool-prerequisites"></a>
+ 在 Device Farm 主控台中建立執行。請遵循中的說明進行[在 Device Farm 中建立測試執行](how-to-create-test-run.md) 在您到達 **Select devices (選擇裝置)** 頁面時，請繼續遵循本節中的指示。

## 建立裝置集區 （主控台）
<a name="how-to-create-device-pool-console"></a>

1. 在**專案**頁面上，選擇您的專案。在**專案詳細資訊**頁面中，選擇**專案設定**。在**裝置集區**索引標籤中，選擇**建立裝置集區**。

1. 針對 **Name (名稱)**，輸入可輕鬆識別此裝置集區的名稱。

1. 針對 **Description (描述)**，輸入可輕鬆識別此裝置集區的描述。

1. 如果您想要在此裝置集區中的裝置上使用一或多個選取條件，請執行下列動作：

   1. 選擇**建立動態裝置集區**。

   1. 選擇**新增規則**。

   1. 針對**欄位** （第一個下拉式清單），選擇下列其中一項：
      + 若要依裝置製造商名稱包含裝置，請選擇**裝置製造商**。
      + 若要依裝置形式因素 （平板電腦或手機） 包含裝置，請選擇**形式因素**。
      + 若要根據負載依裝置的可用性狀態包含裝置，請選擇**可用性**。
      + 若要僅包含公有或私有裝置，請選擇**機群類型**。
      + 若要依其作業系統包含裝置，請選擇**平台**。
      + 有些裝置具有關於裝置的額外標籤標籤或描述。您可以選擇**執行個體**標籤，根據裝置標籤內容來尋找裝置。
      + 若要依其作業系統版本包含裝置，請選擇**作業系統版本**。
      + 若要依模型包含裝置，請選擇**模型**。

   1. 針對**運算子** （第二個下拉式清單），選擇邏輯操作 (EQUALS、CONTAINS 等），以根據查詢包含裝置。例如，您可以選擇*可用 EQUALS 可用*，以包含目前狀態為 的裝置`Available`。

   1. 針對**值** （第三個下拉式清單），輸入或選擇您要為**欄位**和**運算子**值指定的值。值會根據您的**欄位**選擇而受限。例如，如果您為 **欄位**選擇**平台**，則唯一可用的選項是 **ANDROID** 和 **IOS**。同樣地，如果您選擇**欄位**的**表單係數**，則唯一可用的選項是 **PHONE** 和 **TABLET**。

   1. 若要新增另一個規則，請選擇**新增規則**。

      在您建立第一個規則之後，系統會選取裝置清單中每個符合規則裝置旁的方塊。在您建立或變更規則之後，系統會選取裝置清單中每個符合合併規則裝置旁的方塊。具有選取方塊的裝置會包含在裝置集區中。具有空白方塊的裝置則會受到排除。

   1. 在**最大裝置**下，輸入您要在裝置集區中使用的裝置數量。如果您未輸入裝置數量上限 (Device Farm)，則 Device Farm 會挑選機群中符合您建立之規則的所有裝置。為了避免產生額外費用，請將此數字設定為符合您實際平行執行和裝置多樣性需求的數量。

   1. 若要刪除規則，請選擇**移除規則**。

1. 如果您想要手動包含或排除個別裝置，請執行下列動作：

   1. 選擇**建立靜態裝置集區**。

   1. 選取或清除每個裝置旁的方塊。只有在您未指定任何規則的情況下，才能選取或清除方塊。

1. 如果您想要包含或排除所有顯示的裝置，請選取或清除清單標頭列中的方塊。如果您只想檢視私有裝置執行個體，請選擇**僅查看私有裝置執行個體**。
**重要**  
雖然您可以使欄標頭列中的方塊來變更顯示裝置的清單，但這不表示只會包含或排除顯示中剩下的裝置。若要確認包含或排除了哪些裝置，請務必清除所有欄標頭列方塊的內容，然後瀏覽方塊。

1. 選擇**建立**。

## 建立裝置集區 (AWS CLI)
<a name="how-to-create-device-pool-cli"></a>

**提示**  
如果您未輸入裝置數量上限 (Device Farm)，則 Device Farm 會挑選機群中符合您建立之規則的所有裝置。為了避免產生額外費用，請將此數字設定為符合您實際平行執行和裝置多樣性需求的數量。
+ 執行 [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-device-pool.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-device-pool.html) 命令。

如需搭配 使用 Device Farm 的詳細資訊 AWS CLI，請參閱 [AWS CLI 參考](cli-ref.md)。

## 建立裝置集區 (API)
<a name="how-to-create-device-pool-api"></a>

**提示**  
如果您未輸入裝置數量上限 (Device Farm)，則 Device Farm 會挑選機群中符合您建立之規則的所有裝置。為了避免產生額外費用，請將此數字設定為符合您實際平行執行和裝置多樣性需求的數量。
+ 呼叫 [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html) API。

如需使用 Device Farm API 的詳細資訊，請參閱 [自動化Device Farm](api-ref.md)。