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

# 建立機群
<a name="edge-device-fleet-create"></a>

您可以使用 適用於 Python (Boto3) 的 AWS SDK 或透過 SageMaker AI 主控台 [https://console.aws.amazon.com/sagemaker](https://console.aws.amazon.com/sagemaker/) 以程式設計方式建立機群。

## 建立機群 (Boto3)
<a name="edge-device-fleet-create-boto3"></a>

使用 `CreateDeviceFleet` API 建立機群。指定機群的名稱、 `RoleArn` 欄位 AWS IoT 的角色 ARN，以及您希望裝置存放取樣資料的 Amazon S3 URI。

您可以選擇性地包含機群、標籤和 AWS KMS 金鑰 ID 的描述。

```
import boto3

# Create SageMaker client so you can interact and manage SageMaker resources
sagemaker_client = boto3.client("sagemaker", region_name="aws-region")

sagemaker_client.create_device_fleet(
    DeviceFleetName="sample-fleet-name",
    RoleArn="arn:aws:iam::999999999:role/rolename", # IoT Role ARN
    Description="fleet description",
    OutputConfig={
        S3OutputLocation="s3://bucket/",
        KMSKeyId: "1234abcd-12ab-34cd-56ef-1234567890ab",
    },
        Tags=[
        {
            "Key": "string", 
            "Value" : "string"
         }
     ],
)
```

當您建立裝置機群時，會為您建立 AWS IoT 角色別名。 AWS IoT 角色別名提供一種機制，讓連線的裝置 AWS IoT 使用 X.509 憑證向 進行身分驗證，然後從與 AWS IoT 角色別名相關聯的 IAM 角色取得短期 AWS 憑證。

用 `DescribeDeviceFleet` 以取得角色別名和 ARN。

```
# Print Amazon Resource Name (ARN) and alias that has access 
# to AWS Internet of Things (IoT).
sagemaker_client.describe_device_fleet(DeviceFleetName=device_fleet_name)['IotRoleAlias']
```

使用 `DescribeDeviceFleet` API 來取得您建立的機群的描述。

```
sagemaker_client.describe_device_fleet(
    DeviceFleetName="sample-fleet-name"
)
```

根據預設，它會傳回機群的名稱、裝置機群 ARN、Amazon S3 儲存貯體 URI、IAM 角色、在 中建立的角色別名 AWS IoT、建立機群時的時間戳記，以及上次修改機群時的時間戳記。

```
{ "DeviceFleetName": "sample-fleet-name",
  "DeviceFleetArn": "arn:aws:sagemaker:us-west-2:9999999999:device-fleet/sample-fleet-name",
  "IAMRole": "arn:aws:iam::999999999:role/rolename",
  "Description": "this is a sample fleet",
  "IoTRoleAlias": "arn:aws:iot:us-west-2:9999999999:rolealias/SagemakerEdge-sample-fleet-name"
  "OutputConfig": {
              "S3OutputLocation": "s3://bucket/folder",
              "KMSKeyId": "1234abcd-12ab-34cd-56ef-1234567890ab"
   },
   "CreationTime": "1600977370",
   "LastModifiedTime": "1600977370"}
```

## 建立機群 (主控台)
<a name="edge-device-fleet-create-console"></a>

您可以使用 Amazon SageMaker AI 主控台建立 Edge Manager 封裝任務，網址為 [https://console.aws.amazon.com/sagemaker](https://console.aws.amazon.com/sagemaker/)。

1. 在 SageMaker AI 主控台中，選擇 **Edge Manager**，然後選擇 **Edge 裝置機群**。

1. 選擇**建立裝置機群**。  
![\[主控台中建立裝置機群的位置。\]](http://docs.aws.amazon.com/zh_tw/sagemaker/latest/dg/images/smith/create-device-button-edited.png)

1. 在**裝置機群名稱**欄位中輸入裝置機群的名稱。選擇**下一步**。  
![\[主控台中裝置機群屬性區段內下一步按鈕的位置。\]](http://docs.aws.amazon.com/zh_tw/sagemaker/latest/dg/images/smith/create-device-fleet-filled.png)

1. 在**輸出組態**頁面上，指定要在其中儲存裝置機群範例資料的 Amazon S3 儲存貯體 URI。您也可以選擇性地新增加密金鑰，方法是從下拉式清單中選擇現有的 AWS KMS 金鑰，或輸入金鑰的 ARN。選擇**提交**。  
![\[主控台中範例輸出組態頁面。\]](http://docs.aws.amazon.com/zh_tw/sagemaker/latest/dg/images/smith/create-device-fleet-output-filled.png)

1. 選擇要重新導向至裝置機群詳細資訊的裝置機群名稱。此頁面顯示裝置機群名稱、ARN、描述 (若您提供的話)、建立機群的日期、上次修改機群的時間、Amazon S3 儲存貯體 URI、 AWS KMS 金鑰 ID (若有提供)、 AWS IoT 別名 (若有提供) 和 IAM 角色。如果您已新增標籤，它們會顯示在**裝置機群標籤**區段中。