本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Amazon Textract 的動作、資源和條件索引鍵
Amazon Textract （服務字首：textract) 提供下列服務特定的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。
參考資料：
-
了解如何設定此服務。
-
檢視此服務可用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
Amazon Textract 定義的動作
您可以在 IAM 政策陳述式的 Action元素中指定下列動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時，通常會允許或拒絕存取具有相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在 IAM 政策中使用 Resource元素限制資源存取，則必須為每個必要的資源類型包含 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊，請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| AnalyzeDocument | 准許在提供做為輸入的影像內偵測真實文件實體的執行個體 | 讀取 |
s3:GetObject |
||
| AnalyzeExpense | 准許在提供做為輸入的影像內偵測真實文件實體的執行個體 | 讀取 |
s3:GetObject |
||
| AnalyzeID | 准許從提供作為輸入的身分文件中偵測相關資訊 | 讀取 |
s3:GetObject |
||
| CreateAdapter | 准許建立 Amazon Textract 轉接器 | 寫入 | |||
| CreateAdapterVersion | 准許建立 Amazon Textract 轉接器版本 | 寫入 | |||
| DeleteAdapter | 准許刪除 Amazon Textract 轉接器 | 寫入 | |||
| DeleteAdapterVersion | 准許刪除 Amazon Textract 轉接器版本 | 寫入 | |||
| DetectDocumentText | 准許偵測文件影像中的文字 | 讀取 |
s3:GetObject |
||
| GetAdapter | 准許取得 Amazon Textract 轉接器 | 讀取 | |||
| GetAdapterVersion | 准許取得 Amazon Textract 轉接器版本 | 讀取 | |||
| GetDocumentAnalysis | 准許傳回文件分析任務的相關資訊 | 讀取 | |||
| GetDocumentTextDetection | 准許傳回文件文字偵測任務的相關資訊 | 讀取 | |||
| GetExpenseAnalysis | 准許傳回成本分析任務的資訊 | 讀取 | |||
| GetLendingAnalysis | 准許擷取有關出借分析作業的頁面層級資訊 | 讀取 | |||
| GetLendingAnalysisSummary | 准許擷取有關出借分析作業的摘要資訊 | 讀取 | |||
| ListAdapterVersions | 准許列出 Amazon Textract 轉接器版本 | 讀取 | |||
| ListAdapters | 准許列出 Amazon Textract 轉接器 | 讀取 | |||
| ListTagsForResource | 准許傳回與資源相關聯的標籤清單 | 讀取 | |||
| StartDocumentAnalysis | 准許啟動非同步任務，在提供做為輸入的影像或 pdf 內，偵測真實文件實體的執行個體 | 寫入 |
s3:GetObject |
||
| StartDocumentTextDetection | 准許啟動非同步任務，以偵測文件影像或 pdf 中的文字 | 寫入 |
s3:GetObject |
||
| StartExpenseAnalysis | 准許啟動非同步任務，在提供做為輸入的影像或 pdf 內，偵測發票或收據的執行個體 | 寫入 |
s3:GetObject |
||
| StartLendingAnalysis | 准許啟動非同步任務，以偵測貸款文件中的實體，將提供的映像或 PDF 作為輸入 | 寫入 |
s3:GetObject |
||
| TagResource | 授予許可來將一或多個標籤新增到資源 | 標記 | |||
| UntagResource | 准許從資源移除一或多個標籤 | 標記 | |||
| UpdateAdapter | 准許更新 Amazon Textract 轉接器 | 寫入 |
Amazon Textract 定義的資源類型
下列資源類型由此服務定義，可用於 IAM 許可政策陳述式的 Resource元素。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| adapter |
arn:${Partition}:textract:${Region}:${Account}:/adapters/${AdapterId}
|
|
| adapterversion |
arn:${Partition}:textract:${Region}:${Account}:/adapters/${AdapterId}/versions/${AdapterVersion}
|
Amazon Textract 的條件索引鍵
Amazon Textract 定義下列條件索引鍵，可用於 IAM 政策的 Condition元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵，請參閱可用全域條件鍵。
| 條件索引鍵 | 描述 | Type |
|---|---|---|
| aws:RequestTag/${TagKey} | 依要求中傳遞的標籤來篩選存取權 | 字串 |
| aws:ResourceTag/${TagKey} | 依與資源關聯的標籤來篩選存取權 | 字串 |
| aws:TagKeys | 依要求中傳遞的標籤索引鍵來篩選存取權 | ArrayOfString |
