Como 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 no nome de sua coisa. O nome do objeto pode surgir em comunicações e relatórios não criptografados.

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 mudar o nome de uma coisa, crie uma coisa nova, dê a ela o novo nome e, em seguida, exclua a coisa antiga.

$ aws iot create-thing --thing-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 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 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"
    }
}

Para obter mais informações, consulte describe-thing na Referência de Comandos. AWS CLI

Atualizar um objeto

Você pode usar o comando UpdateThing para atualizar um objeto. Esse comando atualiza somente os atributos da coisa. Você não pode mudar o nome de um objeto. Para mudar o nome de uma coisa, crie uma coisa nova, dê a ela o novo nome e, em seguida, exclua a coisa antiga.

$ 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 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 na Referência do comando AWS CLI .

Anexar uma entidade principal a um objeto

Um dispositivo físico deve ter um certificado X.509 para se comunicar com ele. AWS IoT Você pode associar o certificado em seu dispositivo com o objeto no registro que representa o dispositivo. Para anexar um certificado ao objeto, use o comando AttachThingPrincipal:

$ aws iot attach-thing-principal --thing-name "MyLightBulb" --principal "arn:aws:iot:us-east-1:123456789012:cert/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847"

O comando AttachThingPrincipal não produz nenhuma saída.

Para obter mais informações, consulte attach-thing-principal na Referência de Comandos. AWS CLI

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/a0c01f5835079de0a7514643d68ef8414ab739a1e94ee4162977b02b12842847"

O comando DetachThingPrincipal não produz saída.

Para obter mais informações, consulte detach-thing-principal na Referência de Comandos. AWS CLI