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

AWS IoT TwinMaker 使用 AWS Identity and Access Management (IAM) 服務連結角色。服務連結角色是直接連結至 AWS IoT TwinMaker的唯一IAM角色類型。服務連結角色由預先定義， AWS IoT TwinMaker 並包含服務代表您呼叫其他服 AWS 務所需的所有權限。

服務連結角色可讓您 AWS IoT TwinMaker 更輕鬆地設定，因為您不必手動新增必要的權限。 AWS IoT TwinMaker 定義其服務連結角色的權限，除非另有定義，否則只 AWS IoT TwinMaker 能擔任其角色。定義的權限包括信任原則和權限原則，而且該權限原則無法附加至任何其他IAM實體。

您必須先刪除服務連結角色的相關資源，才能將其刪除。這樣可以保護您的 AWS IoT TwinMaker 資源，因為您無法不小心移除存取資源的權限。

如需支援服務連結角色之其他服務的相關資訊，請參閱使用的AWS 服務，IAM並在服務連結角色欄中尋找具有是的服務。選擇具有連結的是，以檢視該服務的服務連結角色文件。

服務連結角色權限 AWS IoT TwinMaker

AWS IoT TwinMaker 使用名為的服務連結角色 AWSServiceRoleForIoTTwinMaker— AWS IoT TwinMaker 允許呼叫其他 AWS 服務，並代表您同步其資源。

服 AWSServiceRoleForIoTTwinMaker 務連結角色會信任下列服務擔任該角色：

• iottwinmaker.amazonaws.com

名為的角色權限原則 AWSIoTTwinMakerServiceRolePolicy AWS IoT TwinMaker 允許對指定的資源完成下列動作：

• 動作：all your iotsitewise asset and asset-model resources 上的 iotsitewise:DescribeAsset, iotsitewise:ListAssets, iotsitewise:DescribeAssetModel, and iotsitewise:ListAssetModels, iottwinmaker:GetEntity, iottwinmaker:CreateEntity, iottwinmaker:UpdateEntity, iottwinmaker:DeleteEntity, iottwinmaker:ListEntities, iottwinmaker:GetComponentType, iottwinmaker:CreateComponentType, iottwinmaker:UpdateComponentType, iottwinmaker:DeleteComponentType, iottwinmaker:ListComponentTypes

您必須設定許可，以允許您的使用者、群組或角色建立、編輯或刪除服務連結角色。如需詳細資訊，請參閱IAM使用指南中的服務連結角色權限。

建立服務連結角色 AWS IoT TwinMaker

您不需要手動建立一個服務連結角色。當您同步處理 AWS Management Console、或中的資 AWS IoT SiteWise 產和資產模型 (資產同步) 時 AWS CLI，會 AWS API為您 AWS IoT TwinMaker 建立服務連結角色。

若您刪除此服務連結角色，之後需要再次建立，您可以在帳戶中使用相同程序重新建立角色。當您 AWS IoT SiteWise 同步資產和資產模型 (資產同步) 時， AWS IoT TwinMaker 會再次為您建立服務連結角色。

您也可以使用IAM主控台建立具有 「IoT TwinMaker -受管理角色」使用案例的服務連結角色。在 AWS CLI 或中 AWS API，使用iottwinmaker.amazonaws.com服務名稱建立服務連結角色。如需詳細資訊，請參閱IAM使用指南中的建立服務連結角色。如果您刪除此服務連結角色，您可以使用此相同的程序以再次建立該角色。

編輯下列項目的服務連結角色 AWS IoT TwinMaker

AWS IoT TwinMaker 不允許您編輯 AWSServiceRoleForIoTTwinMaker 服務連結角色。因為有各種實體可能會參考服務連結角色，所以您無法在建立角色之後變更角色名稱。但是，您可以使用編輯角色的描述IAM。如需詳細資訊，請參閱IAM使用指南中的編輯服務連結角色。

刪除下列項目的服務連結角色 AWS IoT TwinMaker

若您不再使用需要服務連結角色的功能或服務，我們建議您刪除該角色。如此一來，您就沒有未主動監控或維護的未使用實體。不過，您必須先清除仍在使用服務連結角色的任何serviceLinked工作區，才能手動刪除角色。

注意

當您嘗試刪除資源時，如果 AWS IoT TwinMaker 服務正在使用此角色，則刪除可能會失敗。若此情況發生，請等待數分鐘後並再次嘗試操作。

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

使用IAM主控台 AWS CLI、或刪除 AWSServiceRoleForIoTTwinMaker 服務連結角色。 AWS API如需詳細資訊，請參閱IAM使用指南中的刪除服務連結角色。

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

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