AWS IoT Greengrass V2 的動作、資源和條件索引鍵

AWS IoT Greengrass V2 （服務字首：greengrass) 提供下列服務特有的資源、動作和條件內容索引鍵，可用於 IAM 許可政策。

參考資料：

• 了解如何設定此服務。

• 檢視此服務可用的 API 操作清單。

• 了解如何使用 IAM 許可政策來保護此服務及其資源。

AWS IoT Greengrass V2 定義的動作

您可以在 IAM 政策陳述式的 Action元素中指定下列動作。使用政策來授予在 AWS中執行操作的許可。當您在政策中使用 動作時，通常會允許或拒絕存取具有相同名稱的 API 操作或 CLI 命令。不過，在某些情況下，單一動作可控制對多個操作的存取。或者，某些操作需要多種不同的動作。

「動作」資料表的資源類型欄會指出每個動作是否支援資源層級的許可。如果此欄沒有值，您必須在政策陳述式的 Resource 元素中指定政策適用的所有資源 ("*")。如果資料欄包含資源類型，則您可以在具有該動作的陳述式中指定該類型的 ARN。如果動作具有一或多個必要資源，呼叫者必須具有對這些資源使用動作的許可。表格中的必要資源會以星號 (*) 表示。如果您在 IAM 政策中使用 Resource元素限制資源存取，則必須為每個必要的資源類型包含 ARN 或模式。某些動作支援多種資源類型。如果資源類型是選用 (未顯示為必要)，則您可以選擇使用其中一種選用資源類型。

「動作」資料表的條件索引鍵欄包含您可以在政策陳述式的 Condition 元素中指定的索引鍵。如需有關與服務資源相關聯之條件索引鍵的詳細資訊，請參閱「資源類型」資料表的條件索引鍵欄。

注意

資源條件索引鍵會列在資源類型資料表中。您可以在「動作」資料表的資源類型 (*必填) 欄中找到適用於動作的資源類型連結。「資源類型」資料表中的資源類型包括條件索引鍵欄，其中包含套用至「動作」資料表中動作的資源條件索引鍵。

如需下表各欄的詳細資訊，請參閱動作資料表。

動作	描述	存取層級	資源類型 (*必填項目)	條件索引鍵	相依動作
AssociateServiceRoleToAccount	准許將角色與您的帳戶建立關聯。 AWS IoT Greengrass 使用此角色存取您的 Lambda 函數和 AWS IoT 資源	許可管理			iam:PassRole
BatchAssociateClientDeviceWithCoreDevice	准許將用戶端裝置清單與核心裝置建立關聯	寫入	coreDevice*
BatchDisassociateClientDeviceFromCoreDevice	准許解除用戶端裝置清單與核心裝置的關聯	寫入	coreDevice*
CancelDeployment	准許取消部署	寫入	deployment*		iot:CancelJob iot:DeleteThingShadow iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow iot:UpdateJob iot:UpdateThingShadow
CreateComponentVersion	准許建立元件	寫入	component*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateDeployment	准許建立部署	寫入		aws:RequestTag/${TagKey} aws:TagKeys	iot:CancelJob iot:CreateJob iot:DeleteThingShadow iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow iot:UpdateJob iot:UpdateThingShadow
DeleteComponent	准許刪除元件	寫入	componentVersion*
DeleteCoreDevice	准許刪除 AWS IoT Greengrass 核心裝置，這是 AWS IoT 物件。此操作會從核心裝置清單中移除核心裝置。此操作不會刪除 AWS IoT 物件	寫入	coreDevice*		iot:DescribeJobExecution
DeleteDeployment	准許刪除部署。若要刪除作用中部署，需要先將其取消	寫入	deployment*		iot:DeleteJob
DescribeComponent	准許擷取元件版本的中繼資料	讀取	componentVersion*
DisassociateServiceRoleFromAccount	准許取消服務角色與帳戶的關聯。如果沒有服務角色，部署不會運作	寫入
GetComponent	准許取得元件版本的配方	讀取	componentVersion*
GetComponentVersionArtifact	准許取得預先簽署的 URL 來下載公有元件成品	讀取	componentVersion*
GetConnectivityInfo	准許擷取 Greengrass 核心裝置的連線資訊	讀取	connectivityInfo*		iot:GetThingShadow
GetCoreDevice	准許擷取 AWS IoT Greengrass 核心裝置的中繼資料	讀取	coreDevice*
GetDeployment	准許取得部署	讀取	deployment*		iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow
GetServiceRoleForAccount	准許擷取連接到帳戶的服務角色	讀取
ListClientDevicesAssociatedWithCoreDevice	准許擷取與 AWS IoT Greengrass 核心裝置相關聯的用戶端裝置分頁清單	清單	coreDevice*
ListComponentVersions	准許擷取元件所有版本的分頁清單	列出	component*
ListComponents	准許擷取元件摘要的分頁清單	清單
ListCoreDevices	准許擷取 AWS IoT Greengrass 核心裝置的分頁清單	清單
ListDeployments	准許擷取部署的分頁清單	清單			iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow
ListEffectiveDeployments	准許擷取 AWS IoT Greengrass 傳送至 AWS IoT Greengrass 核心裝置的部署任務分頁清單	清單	coreDevice*		iot:DescribeJob iot:DescribeJobExecution iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow
ListInstalledComponents	准許擷取 AWS IoT Greengrass 核心裝置執行的元件分頁清單	清單	coreDevice*
ListTagsForResource	准許列出資源的標籤	讀取	component
			componentVersion
			coreDevice
			deployment
				aws:RequestTag/${TagKey} aws:TagKeys
ResolveComponentCandidates	准許列出符合部署元件、版本和平台需求的元件	列出	componentVersion*
TagResource	准許將標籤新增至資源	標記	component
			componentVersion
			coreDevice
			deployment
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	授予許可來從資源中移除標籤	標記	component
			componentVersion
			coreDevice
			deployment
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateConnectivityInfo	准許更新 Greengrass 核心的連線資訊。任何裝置只要屬於具有此核心的群組，將會收到此資訊，以尋找核心的位置並連接到核心	寫入	connectivityInfo*		iot:GetThingShadow iot:UpdateThingShadow

AWS IoT Greengrass V2 定義的資源類型

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

資源類型	ARN	條件索引鍵
connectivityInfo	arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/things/${ThingName}/connectivityInfo
component	arn:${Partition}:greengrass:${Region}:${Account}:components:${ComponentName}	aws:ResourceTag/${TagKey}
componentVersion	arn:${Partition}:greengrass:${Region}:${Account}:components:${ComponentName}:versions:${ComponentVersion}	aws:ResourceTag/${TagKey}
coreDevice	arn:${Partition}:greengrass:${Region}:${Account}:coreDevices:${CoreDeviceThingName}	aws:ResourceTag/${TagKey}
deployment	arn:${Partition}:greengrass:${Region}:${Account}:deployments:${DeploymentId}	aws:ResourceTag/${TagKey}

AWS IoT Greengrass V2 的條件索引鍵

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

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

條件索引鍵	描述	Type
aws:RequestTag/${TagKey}	檢查請求中所含的標籤鍵/值對，以篩選存取權	字串
aws:ResourceTag/${TagKey}	檢查與特定資源相關聯的標籤鍵/值對，以篩選存取權	字串
aws:TagKeys	檢查請求中傳遞的標籤索引鍵，以篩選存取權	ArrayOfString