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 轉接器	寫入		aws:RequestTag/${TagKey} aws:TagKeys
CreateAdapterVersion	准許建立 Amazon Textract 轉接器版本	寫入	adapter*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAdapter	准許刪除 Amazon Textract 轉接器	寫入	adapter*
DeleteAdapterVersion	准許刪除 Amazon Textract 轉接器版本	寫入	adapterversion*
DetectDocumentText	准許偵測文件影像中的文字	讀取			s3:GetObject
GetAdapter	准許取得 Amazon Textract 轉接器	讀取	adapter*
GetAdapterVersion	准許取得 Amazon Textract 轉接器版本	讀取	adapterversion*
GetDocumentAnalysis	准許傳回文件分析任務的相關資訊	讀取
GetDocumentTextDetection	准許傳回文件文字偵測任務的相關資訊	讀取
GetExpenseAnalysis	准許傳回成本分析任務的資訊	讀取
GetLendingAnalysis	准許擷取有關出借分析作業的頁面層級資訊	讀取
GetLendingAnalysisSummary	准許擷取有關出借分析作業的摘要資訊	讀取
ListAdapterVersions	准許列出 Amazon Textract 轉接器版本	讀取
ListAdapters	准許列出 Amazon Textract 轉接器	讀取
ListTagsForResource	准許傳回與資源相關聯的標籤清單	讀取	adapter
			adapterversion
StartDocumentAnalysis	准許啟動非同步任務，在提供做為輸入的影像或 pdf 內，偵測真實文件實體的執行個體	寫入			s3:GetObject
StartDocumentTextDetection	准許啟動非同步任務，以偵測文件影像或 pdf 中的文字	寫入			s3:GetObject
StartExpenseAnalysis	准許啟動非同步任務，在提供做為輸入的影像或 pdf 內，偵測發票或收據的執行個體	寫入			s3:GetObject
StartLendingAnalysis	准許啟動非同步作業以偵測出借文件中的實體，將提供的影像或 PDF 作為輸入	寫入			s3:GetObject
TagResource	授予許可來將一或多個標籤新增到資源	標記	adapter
			adapterversion
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	准許從資源移除一或多個標籤	標記	adapter
			adapterversion
				aws:TagKeys
UpdateAdapter	准許更新 Amazon Textract 轉接器	寫入	adapter*

Amazon Textract 定義的資源類型

此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型表。

資源類型	ARN	條件索引鍵
adapter	arn:${Partition}:textract:${Region}:${Account}:/adapters/${AdapterId}	aws:ResourceTag/${TagKey}
adapterversion	arn:${Partition}:textract:${Region}:${Account}:/adapters/${AdapterId}/versions/${AdapterVersion}	aws:ResourceTag/${TagKey}

Amazon Textract 的條件索引鍵

Amazon Textract 定義下列條件索引鍵，可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。

若要檢視所有服務都可使用的全域條件索引鍵，請參閱可用的全域條件索引鍵。

條件索引鍵	描述	類型
aws:RequestTag/${TagKey}	依要求中傳遞的標籤來篩選存取權	字串
aws:ResourceTag/${TagKey}	依與資源關聯的標籤來篩選存取權	字串
aws:TagKeys	依要求中傳遞的標籤金鑰來篩選存取權	ArrayOfString