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

# 使用 CLI 和 SDKs AWS 管理轉接器
<a name="managing-adapters"></a>

 Rekognition 可讓您利用多種運用預先訓練的電腦視覺模型的功能。使用這些模型，您可以執行諸如標籤偵測和內容管制之類的任務。您也可以使用轉接器自訂這些特定型號。

您可以使用 Rekognition 的專案建立和專案管理 API (例如 [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html) 與 [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html)) 來建立和訓練轉接器。以下頁面說明如何使用 API 操作，使用 AWS 主控台、您選擇的 AWS SDK 或 AWS CLI 來建立、訓練和管理轉接器。

訓練轉接器之後，您可以在使用支援的功能執行推論時使用。目前，使用內容管制特徵時支援轉接器。

使用 AWS SDK 訓練轉接器時，您必須以資訊清單檔案的形式提供 Ground-truth 標籤 （影像註釋）。或者，您可使用 Rekognition 主控台來建立和訓練轉接器。

**注意**  
 無法複製轉接器。只能複製 Rekognition 自訂標籤專案版本。

**Topics**
+ [轉接器狀態](#managing-adapters-project-versions-statuses)
+ [建立專案](managing-adapters-create-project.md)
+ [描述專案](managing-adapters-describe-projects.md)
+ [刪除專案](managing-adapters-delete-project.md)
+ [建立專案版本](managing-adapters-create-project-version.md)
+ [描述專案版本](managing-adapters-describe-project.md)
+ [刪除專案版本](managing-adapters-delete-project-version.md)

## 轉接器狀態
<a name="managing-adapters-project-versions-statuses"></a>

自訂管制轉接器 （專案版本） 可以處於下列其中一種狀態：
+ TRAINING\$1IN\$1PROGRESS - 轉接器正在對您作為訓練文件提供的檔案進行訓練。
+ TRAINING\$1COMPLETED - 轉接器已成功完成訓練，可供您檢閱其效能。
+ TRAINING\$1FAILED - 轉接器因為某些原因而無法完成其訓練，請檢閱輸出資訊清單檔案和輸出資訊清單摘要，以取得失敗原因的相關資訊。
+ 刪除 - 轉接器正在刪除中。
+ 已棄用 - 轉接器已針對舊版的內容管制基礎模型進行訓練。其處於寬限期，並在新基礎模型版本的發行後 60 到 90 天內過期。在寬限期內，您仍然可以使用轉接器搭配 [DetectModerationLabels](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DetectModerationLabels.html) 或 [StartMediaAnalysisJob](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartMediaAnalysisJob.html) API 操作進行推論。如需轉接器的過期日期，請參閱自訂管制主控台。
+ EXPIRED - 轉接器已針對舊版的內容管制基礎模型進行訓練，且無法再用於透過 DetectModerationLabels 或 StartMediaAnalysisJob API 操作取得自訂結果。如果在推論請求中指定已過期的轉接器，則會忽略該轉接器，而回應會從最新版本的自訂管制基礎模型傳回。

# 建立專案
<a name="managing-adapters-create-project"></a>

透過 [CreateProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProject.html) 操作，您可以建立一個專案，該專案將容納 Rekognition 的標籤偵測操作的轉接器。專案是一組資源，在 DetectModerationLabels 等標籤偵測作業的情況下，專案可讓您儲存可用來自訂基礎 Rekognition 模型的配接器。當調用 CreateProject 時，您提供要為 ProjectName 引數建立的專案名稱。

 若要使用 AWS 主控台建立專案：
+ 簽署 Rekognition 主控台
+ 按一下**自訂管制**
+ 選擇**建立專案**
+ 選擇**建立新專案**或**新增到現有專案**
+ 新增**專案名稱**
+ 新增**轉接器名稱**
+ 視需要新增描述
+ 選擇您要匯入訓練映像的方式：資訊清單檔案、S3 儲存貯體或從電腦匯入
+ 選擇是否要自動分割訓練資料或匯入資訊清單檔案
+ 選擇是否要自動更新專案
+ 按一下**建立專案**。

若要使用 CLI 和 SDK AWS 建立專案：

1. 如果您尚未這麼做，請安裝並設定 AWS CLI 和 AWS SDKs。如需詳細資訊，請參閱 [步驟 2：設定 AWS CLI 和 AWS SDKs](setup-awscli-sdk.md)。

1. 使用以下程式碼來建立專案。

------
#### [ CLI ]

```
# Request
# Creating Content Moderation Project
aws rekognition create-project \
    --project-name "project-name" \
    --feature CONTENT_MODERATION \
    --auto-update ENABLED
    --profile profile-name
```

------

# 描述專案
<a name="managing-adapters-describe-projects"></a>

您可以使用 [DescribeProjects](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjects.html) API 來取得專案的相關資訊，包括與專案相關聯之所有轉接器的相關資訊。

若要使用 CLI 和 SDK AWS 描述專案：

1. 如果您尚未這麼做，請安裝並設定 AWS CLI 和 AWS SDKs。如需詳細資訊，請參閱 [步驟 2：設定 AWS CLI 和 AWS SDKs](setup-awscli-sdk.md)。

1. 使用下列程式碼來描述專案：

------
#### [ CLI ]

```
# Request
# Getting CONTENT_MODERATION project details 
aws rekognition describe-projects \
    --features CONTENT_MODERATION
    --profile profile-name
```

------

# 刪除專案
<a name="managing-adapters-delete-project"></a>

您可以使用 Rekognition 主控台或呼叫 [DeleteProject](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProject.html) API。若要刪除專案，您必須先刪除每一個相關轉接器。刪除的專案或模型無法取消刪除。

 若要使用 AWS 主控台刪除專案：
+ 簽署 Rekognition 主控台。
+ 按一下**自訂管制**。
+ 您必須刪除專案中的每一個轉接器，才能刪除專案本身。選取轉接器，然後選取**刪除**，以刪除與專案相關聯的所有轉接器。
+ 選取專案，然後選取**刪除**按鈕。

若要使用 CLI 和 SDK AWS 刪除專案：

1. 如果您尚未這麼做，請安裝並設定 AWS CLI 和 AWS SDKs。如需詳細資訊，請參閱 [步驟 2：設定 AWS CLI 和 AWS SDKs](setup-awscli-sdk.md)。

1. 使用下列程序來刪除專案。

------
#### [ CLI ]

```
aws rekognition delete-project 
  --project-arn project_arn \
  --profile profile-name
```

------

# 建立專案版本
<a name="managing-adapters-create-project-version"></a>

您可以使用 [CreateProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateProjectVersion.html) 來訓練用於部署的轉接器。CreateProjectVersion 會先建立與專案關聯的轉接器的新版本，然後開始訓練轉接器。來自 CreateProjectVersion 的回應是模型版本的 Amazon Resource Name (ARN)。訓練需要一段時間才能完成。您可以呼叫 DescribeProjectVersions 來取得目前的狀態。訓練模型時，Rekognition 會使用與專案相關聯的訓練和測試資料集。可以使用主控台來建立資料集。如需詳細資訊，請參閱頁面上的資料集。

 若要使用 Rekognition 主控台建立專案版本：
+  簽署 AWS Rekognition 主控台 
+  按一下自訂管制 
+  選取專案。
+  在「專案詳細資訊」頁面上，選擇**建立轉接器** 
+  在「建立專案」頁面上，填入專案詳細資料、訓練映像和測試映像的必要詳細資料，然後選取**建立專案**。
+  在「為映像指派標籤」頁面上，為映像新增標籤，完成後選取**開始訓練** 

若要使用 CLI 和 SDK AWS 建立專案版本：

1. 如果您尚未這麼做，請安裝並設定 AWS CLI 和 AWS SDKs。如需詳細資訊，請參閱 [步驟 2：設定 AWS CLI 和 AWS SDKs](setup-awscli-sdk.md)。

1. 使用下面的程式碼來建立一個專案版本：

------
#### [ CLI ]

```
# Request
aws rekognition create-project-version \
 --project-arn project-arn \
 --training-data '{Assets=[GroundTruthManifest={S3Object="amzn-s3-demo-source-bucket",Name="manifest.json"}]}' \
 --output-config S3Bucket=amzn-s3-demo-destination-bucket,S3KeyPrefix=my-results \
 --feature-config "ContentModeration={ConfidenceThreshold=70}"
 --profile profile-name
```

------

# 描述專案版本
<a name="managing-adapters-describe-project"></a>

可以使用 [DescribeProjectVersions](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeProjectVersions.html) 來列出並描述與專案相關聯的轉接器。可以在 ProjectVersionArn 中指定最多 10 個模型版本。如果您不指定值，就會傳回專案中所有模型版本的描述。

若要使用 CLI 和 SDK AWS 描述專案版本：

1. 如果您尚未這麼做，請安裝並設定 AWS CLI 和 AWS SDKs。如需詳細資訊，請參閱 [步驟 2：設定 AWS CLI 和 AWS SDKs](setup-awscli-sdk.md)。

1. 請使用下列程式碼來描述專案版本：

------
#### [ CLI ]

```
aws rekognition describe-project-versions 
  --project-arn project_arn \
  --version-names [versions]
```

------

# 刪除專案版本
<a name="managing-adapters-delete-project-version"></a>

您可以使用 [DeleteProjectVersion](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteProjectVersion.html) 操作刪除與專案相關聯的 Rekognition 配接器。如果轉接器正在執行或正在訓練，您就無法刪除轉接器。若要檢查轉接器的狀態，請呼叫 DescribeProjectVersions 操作，並檢查其傳回的狀態欄位。要停止正在執行的轉接器，請呼叫 StopProjectVersion。如果模型正在訓練，請等到完成訓練以刪除模型。您必須刪除專案中的每一個轉接器，才能刪除專案本身。

 若要使用 Rekognition 主控台刪除專案版本：
+ 簽署 Rekognition 主控台
+ 按一下自訂管制
+ 從專案標籤中，您可以看到所有專案和相關聯的轉接器。選取轉接器，然後選取**刪除**。

若要使用 CLI 和 SDK AWS 刪除專案版本：

1. 如果您尚未這麼做，請安裝並設定 AWS CLI 和 AWS SDKs。如需詳細資訊，請參閱 [步驟 2：設定 AWS CLI 和 AWS SDKs](setup-awscli-sdk.md)。

1. 使用下列程式碼來刪除專案版本：

------
#### [ CLI ]

```
# Request
aws rekognition delete-project-version 
  --project-version-arn model_arn \
  --profile profile-name
```

------