使用 AWS IoT SiteWise 的服務連結角色 - AWS IoT SiteWise

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

使用 AWS IoT SiteWise 的服務連結角色

AWS IoT SiteWise 使用 AWS Identity and Access Management (IAM) 服務連結的角色。服務連結角色是直接連結至 AWS IoT SiteWise 的一種特殊 IAM 角色類型。服務連結角色由 AWS IoT SiteWise 預先定義,且內含該服務代您呼叫其他 AWS 服務所需的所有許可。

服務連結的角色可讓設定 AWS IoT SiteWise 更為簡單,因為您不必手動新增必要的許可。AWS IoT SiteWise​ 定義其服務連結角色的許可,除非另有定義,否則僅有 AWS IoT SiteWise 可以擔任其角色。定義的許可包括信任政策和許可政策,並且該許可政策不能連接到任何其他 IAM 實體。

您必須先刪除服務連結角色的相關資源,才能將其刪除。如此可保護您 AWS IoT SiteWise 的資源,避免您不小心移除資源的存取許可。

如需關於支援服務連結角色的其他服務資訊,請參閱《可搭配 IAM 運作的 AWS 服務》,尋找 Service-linked roles (服務連結角色) 欄中顯示為 Yes (是) 的服務。選擇具有連結的 Yes (是),以檢視該服務的服務連結角色文件。

AWS IoT SiteWise 的服務連結角色許可

AWS IoT SiteWise使用名為 的服務連結角色AWSServiceRoleForIoTSiteWise。AWS IoT SiteWise使用此服務連結角色以部署閘道 (在上執行)AWS IoT Greengrass) 並執行記錄。

AWSServiceRoleForIoTSiteWise 服務連結角色信任下列服務以擔任角色:

  • iotsitewise.amazonaws.com

所以此AWSServiceRoleForIoTSiteWise角色會使用AWSServiceRoleForIoTSiteWise具備下列權限的政策。此政策允許AWS IoT Greengrass將日誌寫入iotsitewise組, 在, 亞馬遜 CloudWatch 記錄檔。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "greengrass:GetAssociatedRole", "greengrass:GetCoreDefinition", "greengrass:GetCoreDefinitionVersion", "greengrass:GetGroup", "greengrass:GetGroupVersion" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:DescribeLogGroups" ], "Resource": "arn:aws:logs:*:*:log-group:/aws/iotsitewise*" }, { "Effect": "Allow", "Action": [ "logs:CreateLogStream", "logs:DescribeLogStreams", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:*:*:log-group:/aws/iotsitewise*:log-stream:*" } ] }

您可以使用日誌來監控閘道並進行故障診斷。如需詳細資訊,請參閱 監控閘道日誌

若要允許 IAM 實體 (如使用者、群組或角色) 建立、編輯或刪除服務連結角色,請先設定許可。如需詳細資訊,請參閱《IAM 使用者指南》中的服務連結角色許可

為 AWS IoT SiteWise 建立服務連結角色

您不需要手動建立一個服務連結角色。當您在中執行任何作業時AWS IoT SiteWiseconsole, 主控台、AWS IoT SiteWise會為您建立服務連結的身份。

若您刪除此服務連結角色,之後需要再次建立,您可以在帳戶中使用相同程序重新建立角色。當您在中執行任何作業時AWS IoT SiteWiseconsole, 主控台、AWS IoT SiteWise會再次為您建立服務連結角色。

您也可以使用 IAM 主控台或 API 來建立的服務連結角色AWS IoT SiteWise。

  • 若要在 IAM 主控台中執行這項操作,請使用AWSServiceRoleForIoTSiteWise政策和與的信任關係iotsitewise.amazonaws.com

  • 若要使用來執行此操作AWS CLI或 IAM API,使用以下方式建立角色arn:aws:iam::aws:policy/aws-service-role/AWSServiceRoleForIoTSiteWise政策和與的信任關係iotsitewise.amazonaws.com

如需詳細資訊,請參閱《IAM 使用者指南》中的建立服務連結角色

如果您刪除此服務連結角色,您可以使用此相同的程序以再次建立該角色。

為 AWS IoT SiteWise 編輯服務連結角色

AWS IoT SiteWise不允許您編輯 AWSServiceRoleForIoTSiteWise 服務連結角色。因為可能有各種實體會參考服務連結角色,所以您無法在建立角色之後變更其名稱。然而,您可使用 IAM 來編輯角色描述。如需詳細資訊,請參閱《IAM 使用者指南》中的編輯服務連結角色

為 AWS IoT SiteWise 刪除服務連結角色

若您不再使用需要服務連結角色的功能或服務,我們建議您刪除該角色。如此一來,您就沒有未主動監控或維護的未使用實體。然而,在手動刪除服務連結角色之前,您必須先清除資源。

注意

若 AWS IoT SiteWise 服務在您試圖刪除資源時正在使用該角色,刪除可能會失敗。若此情況發生,請等待數分鐘後並再次嘗試。

若要刪除AWS IoT SiteWise所使用的資源 AWSServiceRoleForIoTSiteWise

  1. 停用 AWS IoT SiteWise 的日誌記錄。如需詳細資訊,請參閱變更您的記錄層級 (主控台)變更您的記錄層級 (CLI)

  2. 刪除任何作用中的閘道。

使用 IAM 手動刪除服務連結角色

使用 IAM 主控台,AWS CLI,或AWSAPI 來刪除 AWSServiceRoleForIoTSiteWise 服務連結角色。如需詳細資訊,請參閱 IAM 使用者指南中的刪除服務連結角色

AWS IoT SiteWise 服務連結角色的支援區域

AWS IoT SiteWise 支援在所有提供服務的區域中使用服務連結角色。如需詳細資訊,請參閱 AWS IoT SiteWise 端點和配額