本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Amazon Lex 的動作、資源與條件索引鍵
Amazon Lex (服務字首：lex) 提供下列服務特有的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。
參考資料：
-
了解如何設定此服務。
-
檢視可供此服務使用的 API 操作清單。
-
了解如何使用 IAM 許可政策來保護此服務及其資源。
Amazon Lex 定義的動作
您可在 IAM 政策陳述式的 Action 元素中指定以下動作。使用政策來授予在 AWS中執行操作的許可。在政策中使用動作時，通常會允許或拒絕存取相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。
「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您使用 IAM 政策中的 Resource 元素限制資源存取，則每種必要的資源類型必須要有 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。
「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。
注意
資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。
如需下表各欄的詳細資訊，請參閱動作資料表。
| 動作 | 描述 | 存取層級 | 資源類型 (*必填項目) | 條件索引鍵 | 相依動作 |
|---|---|---|---|---|---|
| CreateBotVersion | 根據指定機器人的 $LATEST 版本建立新版本 | 寫入 | |||
| CreateIntentVersion | 根據指定意圖的 $LATEST 版本建立新版本 | 寫入 | |||
| CreateSlotTypeVersion | 根據指定插槽類型的 $LATEST 版本建立新版本 | 寫入 | |||
| DeleteBot | 刪除機器人的所有版本 | 寫入 | |||
| DeleteBotAlias | 刪除特定機器人的別名 | 寫入 | |||
| DeleteBotChannelAssociation | 刪除 Amazon Lex 機器人別名及簡訊平台之間的關聯 | 寫入 | |||
| DeleteBotVersion | 刪除機器人的特定版本 | 寫入 | |||
| DeleteIntent | 刪除所有版本的意圖 | 寫入 | |||
| DeleteIntentVersion | 刪除特定版本的意圖 | 寫入 | |||
| DeleteSession | 移除指定機器人、別名和使用者 ID 的工作階段資訊 | 寫入 | |||
| DeleteSlotType | 刪除所有版本的插槽類型 | 寫入 | |||
| DeleteSlotTypeVersion | 刪除特定版本的插槽類型 | 寫入 | |||
| DeleteUtterances | 刪除 Amazon Lex 針對特定機器人及 userID 維護表達用語的資訊 | 寫入 | |||
| GetBot | 針對特定機器人傳回資訊。除了機器人名稱以外，還需要機器人版本或別名 | 讀取 | |||
| GetBotAlias | 傳回關於 Amazon Lex 機器人別名的資訊 | 讀取 | |||
| GetBotAliases | 傳回指定 Amazon Lex 機器人的別名清單 | 清單 | |||
| GetBotChannelAssociation | 傳回 Amazon Lex 機器人別名及簡訊平台之間關聯的相關資訊 | 讀取 | |||
| GetBotChannelAssociations | 傳回與單一機器人相關聯的所有管道清單 | 清單 | |||
| GetBotVersions | 傳回特定機器人所有版本的資訊 | 清單 | |||
| GetBots | 傳回所有機器人 $LATEST 版本的資訊，需使用用戶端提供的篩選條件 | 清單 | |||
| GetBuiltinIntent | 傳回關於內建意圖的資訊 | 讀取 | |||
| GetBuiltinIntents | 取得符合指定條件的內建意圖 | 讀取 | |||
| GetBuiltinSlotTypes | 取得符合指定條件的內建插槽類型 | 讀取 | |||
| GetExport | 以請求的格式匯出 Amazon Lex 資源 | 讀取 | |||
| GetImport | 取得搭配 StartImport 啟動之匯入任務的相關資訊 | 讀取 | |||
| GetIntent | 傳回特定意圖的資訊。除了意圖名稱以外，您還必須指定意圖版本 | 讀取 | |||
| GetIntentVersions | 傳回特定意圖所有版本的資訊 | 清單 | |||
| GetIntents | 傳回所有意圖 $LATEST 版本的資訊，需使用用戶端提供的篩選條件 | 清單 | |||
| GetMigration | 准許檢視進行中或已完成的遷移 | 讀取 | |||
| GetMigrations | 准許檢視從 Amazon Lex v1 到 Amazon Lex v2 的遷移清單 | 清單 | |||
| GetSession | 傳回指定機器人、別名和使用者 ID 的工作階段資訊 | 讀取 | |||
| GetSlotType | 傳回特定版本的插槽類型的相關資訊。除了指定插槽類型名稱以外，您還必須指定插槽類型版本 | 讀取 | |||
| GetSlotTypeVersions | 傳回特定插槽類型所有版本的資訊 | 清單 | |||
| GetSlotTypes | 傳回所有插槽類型 $LATEST 版本的資訊，需使用用戶端提供的篩選條件 | 清單 | |||
| GetUtterancesView | 針對最近一段時間的機器人版本，傳回彙總表達用語資料的檢視 | 清單 | |||
| ListTagsForResource | 列出 Lex 資源的標籤 | 讀取 | |||
| PostContent | 將使用者輸入 (文字或語音) 傳送至 Amazon Lex | 寫入 | |||
| PostText | 將使用者輸入 (僅限文字) 傳送至 Amazon Lex | 寫入 | |||
| PutBot | 建立或更新 Amazon Lex 對話機器人的 $LATEST 版本控制 | 寫入 | |||
| PutBotAlias | 建立或更新特定機器人的別名 | 寫入 | |||
| PutIntent | 建立或更新意圖的 $LATEST 版本控制 | 寫入 | |||
| PutSession | 使用 Amazon Lex 機器人建立新的工作階段或修改現有的工作階段 | 寫入 | |||
| PutSlotType | 建立或更新插槽類型的 $LATEST 版本 | 寫入 | |||
| StartImport | 啟動將資源匯入至 Amazon Lex 的任務 | 寫入 | |||
| StartMigration | 准許遷移從 Amazon Lex v1 到 Amazon Lex v2 的機器人 | 寫入 | |||
| TagResource | 新增或覆寫 Lex 資源的標籤 | 標記 | |||
| UntagResource | 從 Lex 資源中刪除標籤 | 標記 | |||
Amazon Lex 定義的資源類型
此服務會定義下列資源類型，並可用在 IAM 許可政策陳述式的 Resource 元素中。動作表格中的每個動作都代表可使用該動作指定的資源類型。資源類型也能定義您可以在政策中包含哪些條件索引鍵。這些索引鍵都會顯示在「資源類型」資料表的最後一欄。如需下表各欄的詳細資訊，請參閱資源類型資料表。
| 資源類型 | ARN | 條件索引鍵 |
|---|---|---|
| bot |
arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}
|
|
| bot version |
arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}:${BotVersion}
|
|
| bot alias |
arn:${Partition}:lex:${Region}:${Account}:bot:${BotName}:${BotAlias}
|
|
| channel |
arn:${Partition}:lex:${Region}:${Account}:bot-channel:${BotName}:${BotAlias}:${ChannelName}
|
|
| intent version |
arn:${Partition}:lex:${Region}:${Account}:intent:${IntentName}:${IntentVersion}
|
|
| slottype version |
arn:${Partition}:lex:${Region}:${Account}:slottype:${SlotName}:${SlotVersion}
|
Amazon Lex 的條件索引鍵
Amazon Lex 定義了下列條件索引鍵，可用於 IAM 政策的 Condition 元素。您可以使用這些索引鍵來縮小套用政策陳述式的條件。如需下表各欄的詳細資訊，請參閱條件索引鍵表。
若要檢視所有服務都可使用的全域條件鍵，請參閱可用全域條件鍵。
| 條件索引鍵 | 描述 | 類型 |
|---|---|---|
| aws:RequestTag/${TagKey} | 根據請求中的標籤篩選存取 | 字串 |
| aws:ResourceTag/${TagKey} | 篩選附加到 Lex 資源的標籤存取 | 字串 |
| aws:TagKeys | 根據要求中的一組標籤索引鍵篩選存取權 | ArrayOfString |
| lex:associatedIntents | 可讓您依據要求包含的意圖來控制存取權 | ArrayOfString |
| lex:associatedSlotTypes | 可讓您依據要求包含的插槽類型來控制存取權 | ArrayOfString |
| lex:channelType | 可讓您依據要求包含的通道類型來控制存取權 | 字串 |
