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

# 輸入資訊清單檔案
<a name="sms-input-data-input-manifest"></a>

輸入資訊清單檔案的每一行均為項目，包含要標籤的物件或物件的參考。項目也可包含上一步工作的標籤，對於某些任務類型，則包含其他資訊。

輸入資料與資訊清單檔案必須儲存在 Amazon Simple Storage Service (Amazon S3)。各有特定的儲存和存取需求，如下所示：
+ 包含輸入資料的 Amazon S3 儲存貯體必須位於執行 Amazon SageMaker Ground Truth 的相同 AWS 區域中。您必須允許 Amazon SageMaker AI 存取 Amazon S3 儲存貯體所存放的資料，使之能夠讀取資料。如需更多相關資訊了解 Amazon S3 儲存貯體，請參閱[使用 Amazon S3 儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html)。
+ 資訊清單檔案必須與資料檔案位於相同的 AWS 區域，但不需要與資料檔案位於相同的位置。它可以存放在任何可供您在建立標籤工作時指派給 Ground Truth 的 AWS Identity and Access Management (IAM) 角色存取的 Amazon S3 儲存貯體中。

**注意**  
3D 點雲與影片影格[任務類型](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-task-types.html)具有不同的輸入資訊清單需求及屬性。  
如需 [3D 點雲任務類型](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-point-cloud.html)的資訊，請參閱[3D 點雲標籤工作的輸入資訊清單檔案](sms-point-cloud-input-manifest.md)。  
如需[影片影格任務類型](https://docs.aws.amazon.com/sagemaker/latest/dg/sms-video-task-types.html)的資訊，請參閱[建立影片影格輸入資訊清單檔案](sms-video-manual-data-setup.md#sms-video-create-manifest)。

資訊清單是 UTF-8 編碼的檔案，其中每一行都是完成且有效的 JSON 物件。每一行都由標準分行符號 (\$1n 或 \$1r\$1n) 分隔。由於每一行都必須為有效的 json 物件，您不能有未逸出的分行符號。如需資料格式的更多相關資訊，請參閱 [JSON 行](http://jsonlines.org/)。

資訊清單檔案中的每個 JSON 物件不能超過 10 萬個字元。物件內的單一屬性不能超過 20,000 個字元。屬性名稱的開頭不可為 `$` (貨幣符號)。

資訊清單檔案中的每個 JSON 物件必須包含下列其中一個索引鍵：`source-ref` 或 `source`。鍵的值會解譯為如下：
+ `source-ref` – 物件來源是數值所指定的 Amazon S3 物件。當物件是二進位物件 (例如映像) 時，請使用此值。
+ `source` – 物件的來源即為數值。當物件為文字值時，請使用此值。



下列範例顯示儲存於 Amazon S3 儲存貯體檔案的資訊清單檔案：

```
{"source-ref": "S3 bucket location 1"}
{"source-ref": "S3 bucket location 2"}
   ...
{"source-ref": "S3 bucket location n"}
```

將映像檔案的 `source-ref` 金鑰用於邊界框、影像分類 (單一與多重標籤)、語意分割與影片剪輯影片分類標籤工作。3D 點雲與影片影格標籤工作也會使用 `source-ref` 金鑰，但是這些標籤工作要求輸入資訊清單檔案的其他資訊。如需更多資訊，請參閱[3D 點雲輸入資料](sms-point-cloud-input-data.md)及[影片影格輸入資料](sms-video-frame-input-data-overview.md)。

下列範例顯示儲存於資訊清單輸入資料的資訊清單檔案：

```
{"source": "Lorem ipsum dolor sit amet"}
{"source": "consectetur adipiscing elit"}
   ...
{"source": "mollit anim id est laborum"}
```

請將 `source` 金鑰用於單一與多標籤文字分類及具名實體辨識標籤工作。

您可以在資訊清單檔案中包含其他鍵值對。這些鍵值對在傳遞到輸出檔案時會保持不變。當您希望在您的應用程式之間傳遞資訊時，這會很有幫助。如需詳細資訊，請參閱[標籤工作輸出資料](sms-data-output.md)。