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á.
# Gerenciar objetos com o Registro
Você usa o AWS IoT console, a AWS IoT API ou o AWS CLI para interagir com o registro. As seções a seguir mostram como usar a CLI para trabalhar com o registro.
**Ao nomear objetos do objeto:**
+ Não use informações de identificação pessoal nos nomes de objetos. O nome do objeto pode surgir em comunicações e relatórios não criptografados.
**Topics**
+ [Criar um objeto](create-thing.md)
+ [Listar objetos](list-things.md)
+ [Descreva as objetos](search-things.md)
+ [Atualizar um objeto](update-thing.md)
+ [Excluir um objeto](delete-thing.md)
+ [Anexar uma entidade principal a um objeto](attach-thing-principal.md)
+ [Listar coisas associadas a uma entidade principal](list-principal-things.md)
+ [Listar as entidades principais associadas a uma coisa](list-thing-principals.md)
+ [Listar as coisas associadas a uma entidade principal V2](list-principal-things-v2.md)
+ [Listar as entidades principais associadas a uma coisa V2](list-thing-principals-v2.md)
+ [Desanexar uma entidade principal de um objeto](detach-thing-principal.md)
# Criar um objeto
O comando a seguir mostra como usar o AWS IoT **CreateThing** comando da CLI para criar algo. Você não pode mudar o nome de um objeto depois de criá-la. Para alterar o nome de um objeto, crie um objeto, dê o novo nome e exclua o objeto antigo.
```
$ aws iot create-thing \
--thing-type-name "MyLightBulb" \
--attribute-payload "{\"attributes\": {\"wattage\":\"75\", \"model\":\"123\"}}"
```
O comando **CreateThing** exibe o nome e o nome do recurso da Amazon (ARN) do novo objeto:
```
{
"thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyLightBulb",
"thingName": "MyLightBulb",
"thingId": "12345678abcdefgh12345678ijklmnop12345678"
}
```
**nota**
Não recomendamos o uso de informações pessoais identificáveis nos nomes das objetos.
Para obter mais informações, consulte [create-cluster](https://docs.aws.amazon.com//cli/latest/reference/iot/create-thing.html) na Referência do comando AWS CLI .
# Listar objetos
Você pode usar o comando **ListThings** para listar todas as objetos em sua conta:
```
$ aws iot list-things
```
```
{
"things": [
{
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 1,
"thingName": "MyLightBulb"
},
{
"attributes": {
"numOfStates":"3"
},
"version": 11,
"thingName": "MyWallSwitch"
}
]
}
```
Você pode usar o comando **ListThings** para pesquisar todas as objetos associadas a um tipo de objeto específica:
```
$ aws iot list-things --thing-type-name "LightBulb"
```
```
{
"things": [
{
"thingTypeName": "LightBulb",
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 1,
"thingName": "MyRGBLight"
},
{
"thingTypeName": "LightBulb",
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 1,
"thingName": "MySecondLightBulb"
}
]
}
```
Você pode usar o comando **ListThings** para pesquisar todas as objetos que tenham um atributo com um valor específico. Esse comando pesquisa até três atributos.
```
$ aws iot list-things --attribute-name "wattage" --attribute-value "75"
```
```
{
"things": [
{
"thingTypeName": "StopLight",
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 3,
"thingName": "MyLightBulb"
},
{
"thingTypeName": "LightBulb",
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 1,
"thingName": "MyRGBLight"
},
{
"thingTypeName": "LightBulb",
"attributes": {
"model": "123",
"wattage": "75"
},
"version": 1,
"thingName": "MySecondLightBulb"
}
]
}
```
Para obter mais informações, consulte [list-domains](https://docs.aws.amazon.com//cli/latest/reference/iot/list-things.html) na Referência do comando AWS CLI .
# Descreva as objetos
Você pode usar o comando **DescribeThing** para exibir informações mais detalhadas sobre um objeto:
```
$ aws iot describe-thing --thing-name "MyLightBulb"
{
"version": 3,
"thingName": "MyLightBulb",
"thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyLightBulb",
"thingId": "12345678abcdefgh12345678ijklmnop12345678",
"defaultClientId": "MyLightBulb",
"thingTypeName": "StopLight",
"attributes": {
"model": "123",
"wattage": "75"
}
}
```
Você também pode acessar essa API dentro do mecanismo de regras usando a função `get_registry_data()` embutida. Você pode usar essa função para acessar e utilizar dinamicamente as informações do registro de coisas (incluindo atributos, tipos de coisas e associações de grupos) ligando e `ListThingGroupsForThing` APIs diretamente dentro AWS IoT das regras, permitindo o processamento `DescribeThing` e o roteamento de mensagens em tempo real com base nos dados de registro do seu dispositivo. Para obter mais informações, consulte [https://docs.aws.amazon.com//iot/latest/developerguide/iot-sql-functions.html#iot-sql-function-get-registry_data](https://docs.aws.amazon.com//iot/latest/developerguide/iot-sql-functions.html#iot-sql-function-get-registry_data).
Para obter mais informações, consulte [describe-thing](https://docs.aws.amazon.com//cli/latest/reference/iot/describe-thing.html) na Referência de Comandos. AWS CLI
# Atualizar um objeto
Você pode usar o comando **UpdateThing** para atualizar um objeto. Esse comando atualiza apenas os atributos do objeto. Você não pode mudar o nome de um objeto. Para alterar o nome de um objeto, crie um objeto, dê o novo nome e exclua o objeto antigo.
```
$ aws iot update-thing --thing-name "MyLightBulb" --attribute-payload "{\"attributes\": {\"wattage\":\"150\", \"model\":\"456\"}}"
```
O comando **UpdateThing** não produz saída. Você pode usar o comando **DescribeThing** para exibir o resultado:
```
$ aws iot describe-thing --thing-name "MyLightBulb"
{
"attributes": {
"model": "456",
"wattage": "150"
},
"version": 2,
"thingName": "MyLightBulb"
}
```
Para obter mais informações, consulte [update-bucket](https://docs.aws.amazon.com//cli/latest/reference/iot/update-thing.html) na Referência do comando AWS CLI .
# Excluir um objeto
Você pode usar o comando **DeleteThing** para excluir um objeto:
```
$ aws iot delete-thing --thing-name "MyThing"
```
Esse comando retornará com êxito sem erros se a exclusão for bem-sucedida ou se você especificar algo que não existe.
Para obter mais informações, consulte [delete-objects](https://docs.aws.amazon.com//cli/latest/reference/iot/delete-thing.html) na Referência do comando AWS CLI .
# Anexar uma entidade principal a um objeto
Um dispositivo físico pode usar um principal para se comunicar com AWS IoT. Uma entidade principal pode ser um certificado X.509 ou um ID do Amazon Cognito. Você pode associar um certificado ou um ID do Amazon Cognito à coisa no registro que representa seu dispositivo, executando o [attach-thing-principal](https://docs.aws.amazon.com//cli/latest/reference/iot/attach-thing-principal.html)comando.
Para anexar um certificado ou um ID do Amazon Cognito à sua coisa, use o [attach-thing-principal](https://docs.aws.amazon.com//cli/latest/reference/iot/attach-thing-principal.html)comando:
```
$ aws iot attach-thing-principal \
--thing-name "MyLightBulb1" \
--principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847"
```
Para anexar um certificado à sua coisa com um tipo de anexo (anexo exclusivo ou anexo não exclusivo), use o [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-thing-principal.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/attach-thing-principal.html)comando e especifique um tipo no `--thing-principal-type` campo. Um anexo exclusivo significa que sua coisa de IoT é a única coisa anexada ao certificado, e este não pode ser associado a nenhuma outra coisa. Um anexo não exclusivo significa que sua coisa de IoT está anexada ao certificado, e este pode ser associado a outras coisas. Para obter mais informações, consulte [Associando qualquer AWS IoT coisa a uma conexão de cliente MQTT](exclusive-thing.md).
**nota**
Para o recurso [Associando qualquer AWS IoT coisa a uma conexão de cliente MQTT](exclusive-thing.md), só é possível usar o certificado X.509 como entidade principal.
```
$ aws iot attach-thing-principal \
--thing-name "MyLightBulb2" \
--principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847" \
--thing-principal-type "EXCLUSIVE_THING"
```
Se o anexo for bem-sucedido, o comando **AttachThingPrincipal** não produzirá nenhuma saída. Para descrever o anexo, use list-thing-principals-v 2 comandos CLI.
Para obter mais informações, consulte [AttachThingPrincipal](https://docs.aws.amazon.com//iot/latest/apireference/API_AttachThingPrincipal.html) na Referência de APIs de *AWS IoT Core *.
# Listar coisas associadas a uma entidade principal
Para listar as coisas associadas à entidade principal especificada, execute o comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-things.htmls](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-things.htmls). Observe que esse comando não lista o tipo de anexo entre a coisa e o certificado. Para listar o tipo de anexo, use o comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-thingsv2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-thingsv2.html). Para obter mais informações, consulte [Listar as coisas associadas a uma entidade principal V2](list-principal-things-v2.md).
```
$ aws iot list-principal-things \
--principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
```
A saída poderá ser parecida com a seguinte:
```
{
"things": [
"MyLightBulb1",
"MyLightBulb2"
]
}
```
Para obter mais informações, consulte [ListPrincipalThings](https://docs.aws.amazon.com//iot/latest/apireference/API_ListPrincipalThings.html) na Referência de APIs de *AWS IoT Core *.
# Listar as entidades principais associadas a uma coisa
Para listar as entidades principais associadas à coisa especificada, execute o comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principals.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principals.html). Observe que esse comando não lista o tipo de anexo entre a coisa e o certificado. Para listar o tipo de anexo, use o comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principalsv2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principalsv2.html). Para obter mais informações, consulte [Listar as entidades principais associadas a uma coisa V2](list-thing-principals-v2.md).
```
$ aws iot list-thing-principals \
--thing-name "MyLightBulb1"
```
A saída poderá ser parecida com a seguinte:
```
{
"principals": [
"arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8",
"arn:aws:iot:us-east-1:123456789012:cert/1a234b39b4b68278f2e9d84bf97eac2cbf4a1c28b23ea29a44559b9bcf8d395b"
]
}
```
Para obter mais informações, consulte [ListThingPrincipals](https://docs.aws.amazon.com//iot/latest/apireference/API_ListThingPrincipals.html) na Referência de APIs de *AWS IoT Core *.
# Listar as coisas associadas a uma entidade principal V2
Para listar as coisas associadas ao certificado especificado, junto com o tipo de anexo, execute o comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-thingsv2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-principal-thingsv2.html). O tipo de anexo se refere à forma como o certificado é anexado à coisa.
```
$ aws iot list-principal-things-v2 \
--principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
```
A saída poderá ser parecida com a seguinte:
```
{
"PrincipalThingObjects": [
{
"thingPrincipalType": "NON_EXCLUSIVE_THING",
"thing": "arn:aws:iot:us-east-1:123456789012:thing/thing_1"
},
{
"thingPrincipalType": "NON_EXCLUSIVE_THING",
"thing": "arn:aws:iot:us-east-1:123456789012:thing/thing_2"
}
]
}
```
Para obter mais informações, consulte [ListPrincipalThingsV2](https://docs.aws.amazon.com//iot/latest/apireference/API_ListPrincipalThingsV2.html) da *Referência da AWS IoT Core API*.
# Listar as entidades principais associadas a uma coisa V2
Para listar os certificados associados à coisa especificada, junto com o tipo de anexo, execute o comando [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principalsv2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/list-thing-principalsv2.html). O tipo de anexo se refere à forma como o certificado é anexado à coisa.
```
$ aws iot list-thing-principals-v2 \
--thing-name "thing_1"
```
A saída poderá ser parecida com a seguinte:
```
{
"ThingPrincipalObjects": [
{
"thingPrincipalType": "NON_EXCLUSIVE_THING",
"principal": "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
},
{
"thingPrincipalType": "NON_EXCLUSIVE_THING",
"principal": "arn:aws:iot:us-east-1:123456789012:cert/1a234b39b4b68278f2e9d84bf97eac2cbf4a1c28b23ea29a44559b9bcf8d395b"
}
]
}
```
Para obter mais informações, consulte [ListThingsPrincipalV2](https://docs.aws.amazon.com//iot/latest/apireference/API_ListThingPrincipalsV2.html) da *Referência da AWS IoT Core API*.
# Desanexar uma entidade principal de um objeto
Você pode usar o comando `DetachThingPrincipal` para desanexar um certificado de um objeto:
```
$ aws iot detach-thing-principal \
--thing-name "MyLightBulb" \
--principal "arn:aws:iot:us-east-1:123456789012:cert/2e1eb273792174ec2b9bf4e9b37e6c6c692345499506002a35159767055278e8"
```
O comando **DetachThingPrincipal** não produz saída.
Para obter mais informações, consulte [detach-thing-principal](https://docs.aws.amazon.com//iot/latest/apireference/API_DetachThingPrincipal.html) na Referência de APIs de *AWS IoT Core *.