

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Integre AWS IoT SiteWise e AWS IoT TwinMaker
<a name="integrate-tm"></a>

A integração com AWS IoT TwinMaker concede acesso a funcionalidades robustas AWS IoT SiteWise, como `ExecuteQuery` API de recuperação de AWS IoT SiteWise dados e pesquisa avançada de ativos no AWS IoT SiteWise console. Para integrar os serviços e usar esses recursos, você deve primeiro habilitar a integração.

**Topics**
+ [Habilitar a integração](#it-enable)
+ [Integrando e AWS IoT SiteWise AWS IoT TwinMaker](#it-integrate)

## Habilitar a integração
<a name="it-enable"></a>

Os administradores podem usar políticas AWS JSON para especificar quem tem acesso ao quê. Ou seja, qual *entidade principal* pode executar *ações* em quais *recursos* e em que *condições*. O elemento `Action` de uma política JSON descreve as ações que podem ser usadas para permitir ou negar acesso em uma política. Para obter mais informações sobre as ações AWS IoT SiteWise suportadas, consulte [Ações definidas por AWS IoT SiteWise](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiotsitewise.html#awsiotsitewise-actions-as-permissions) na *Referência de Autorização de Serviço*.

*Para obter mais informações sobre funções AWS IoT TwinMaker vinculadas ao serviço, consulte [Funções vinculadas ao serviço AWS IoT TwinMaker no Guia do usuário](https://docs.aws.amazon.com/iot-twinmaker/latest/guide/security_iam_service-with-iam.html#security_iam_service-with-iam-roles-service-linked).AWS IoT TwinMaker *

Antes de integrar AWS IoT SiteWise e AWS IoT TwinMaker, você deve conceder as seguintes permissões que permitem AWS IoT SiteWise a integração com um espaço de trabalho AWS IoT TwinMaker vinculado:
+ `iotsitewise:EnableSiteWiseIntegration`— Permite AWS IoT SiteWise a integração com um AWS IoT TwinMaker espaço de trabalho vinculado. Essa integração permite AWS IoT TwinMaker ler todas as suas informações de modelagem AWS IoT SiteWise por meio de uma função AWS IoT TwinMaker vinculada ao serviço. Para habilitar essa permissão, adicione a seguinte política ao perfil do IAM:

------
#### [ JSON ]

****  

  ```
  {
    "Version":"2012-10-17",		 	 	 
    "Statement": [
      {
        "Effect": "Allow",
        "Action": [
          "iotsitewise:EnableSiteWiseIntegration"
        ],
        "Resource": "*"
      }
    ]
  }
  ```

------

## Integrando e AWS IoT SiteWise AWS IoT TwinMaker
<a name="it-integrate"></a>

Para integrar AWS IoT SiteWise e AWS IoT TwinMaker, você deve ter o seguinte:
+ AWS IoT SiteWise função vinculada ao serviço configurada em sua conta
+ AWS IoT TwinMaker função vinculada ao serviço configurada em sua conta
+ AWS IoT TwinMaker espaço de trabalho com ID `IoTSiteWiseDefaultWorkspace` em sua conta na região.

### Para integrar usando o AWS IoT SiteWise console
<a name="it-integrate-console"></a>

Ao ver o banner **Integração com o AWS IoT TwinMaker** no console, escolha **Conceder permissão**. Os pré-requisitos são criados na conta.

### Para integrar usando o AWS CLI
<a name="it-integrate-cli"></a>

Para integrar AWS IoT SiteWise e AWS IoT TwinMaker usar o AWS CLI, digite os seguintes comandos:

1. Chame `CreateServiceLinkedRole` com um `AWSServiceName` de `iotsitewise.amazonaws.com`.

   ```
   aws iam create-service-linked-role --aws-service-name iotsitewise.amazonaws.com
   ```

1. Chame `CreateServiceLinkedRole` com um `AWSServiceName` de ` iottwinmaker.amazonaws.com`.

   ```
   aws iam create-service-linked-role --aws-service-name iottwinmaker.amazonaws.com
   ```

1. Chame `CreateWorkspace` com um `ID` de `IoTSiteWiseDefaultWorkspace`.

   ```
    aws iottwinmaker create-workspace --workspace-id IoTSiteWiseDefaultWorkspace
   ```