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

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

服務連結角色可讓您更 AWS IoT TwinMaker 輕鬆地設定，因為您不必手動新增必要的許可。 AWS IoT TwinMaker 會定義其服務連結角色的許可，除非另有定義，否則 AWS IoT TwinMaker 只能擔任其角色。定義的許可包括信任政策和許可政策，該許可政策無法連接到任何其他 IAM 實體。

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

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

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

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

The 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 CLI或 AWS API 中同步 AWS IoT SiteWise 資產和資產模型 （資產同步） 時， 會為您 AWS IoT TwinMaker 建立服務連結角色。

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

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

編輯 的服務連結角色 AWS IoT TwinMaker

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

刪除 的服務連結角色 AWS IoT TwinMaker

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

注意

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

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

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

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

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