Cómo administrar objetos con el registro

Utiliza la AWS IoT consola, la AWS IoT API o la AWS CLI para interactuar con el registro. En las secciones siguientes se muestra cómo utilizar la CLI para trabajar con el registro.

Al nombrar sus objetos cosa:

• No utilices información de identificación personal en el nombre de tu cosa. El nombre de la cosa puede aparecer en comunicaciones e informes no cifrados.

Creación de un objeto

El siguiente comando muestra cómo utilizar el AWS IoT CreateThing comando de la CLI para crear una cosa. No se puede modificar el nombre de un objeto una vez creado. Para cambiar el nombre de una cosa, cree una nueva, asígnele el nombre nuevo y, a continuación, elimine la antigua.

$ aws iot create-thing --thing-name "MyLightBulb" --attribute-payload "{\"attributes\": {\"wattage\":\"75\", \"model\":\"123\"}}"

El comando CreateThing muestra el nombre y el ARN (nombre de recurso de Amazon) del nuevo objeto:

{
    "thingArn": "arn:aws:iot:us-east-1:123456789012:thing/MyLightBulb",
    "thingName": "MyLightBulb",
    "thingId": "12345678abcdefgh12345678ijklmnop12345678"
}

nota

No es recomendable utilizar datos personales en los nombres de objeto.

Para obtener más información, consulte create-thing en la Referencia de comandos AWS CLI .

Lista de objetos

Puede utilizar el comando ListThings para enumerar todos los objetos en su cuenta:

$ aws iot list-things

{
    "things": [
       {
            "attributes": {
                "model": "123",
                "wattage": "75"
            },
            "version": 1,
            "thingName": "MyLightBulb"
        },
        {
            "attributes": {
                "numOfStates":"3"
             },
            "version": 11,
            "thingName": "MyWallSwitch"
        }
    ]
}

Puede utilizar el comando ListThings para buscar todas las cosas de un tipo específico:

$  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"
        }
    ]
}

Puede utilizar el comando ListThings para buscar todos los objetos que tienen un atributo con un valor específico. Este comando busca hasta tres 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 obtener más información, consulte list-things en la Referencia de comandos AWS CLI .

Describir las cosas

Puede utilizar el comando DescribeThing para mostrar información más detallada sobre una cosa:

$ 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 obtener más información, consulte describe-thing en la AWS CLI Referencia de comandos.

Actualización de un objeto

Puede utilizar el comando UpdateThing para actualizar un objeto. Este comando actualiza solo los atributos de la cosa. El nombre de un objeto no se puede modificar. Para cambiar el nombre de una cosa, cree una nueva, asígnele el nombre nuevo y, a continuación, elimine la antigua.

$ aws iot update-thing --thing-name "MyLightBulb" --attribute-payload "{\"attributes\": {\"wattage\":\"150\", \"model\":\"456\"}}"

El comando UpdateThing no genera una salida. Puede utilizar el comando de DescribeThing para ver el resultado:

$ aws iot describe-thing --thing-name "MyLightBulb"
{
    "attributes": {
        "model": "456",
        "wattage": "150"
    },
    "version": 2,
    "thingName": "MyLightBulb"
}

Para obtener más información, consulte update-thing en la Referencia de comandos de AWS CLI .

Eliminación de un objeto

Puede utilizar el comando DeleteThing para eliminar un objeto:

$ aws iot delete-thing --thing-name "MyThing"

Este comando se devuelve correctamente sin error si la eliminación se realiza correctamente o especifica un objeto que no existe.

Para obtener más información, consulte describe-thing en la Referencia de comandos de AWS CLI .

Asociar un principal a un objeto

Un dispositivo físico debe tener un certificado X.509 para poder comunicarse con AWS IoT él. Puede asociar el certificado de un dispositivo con el objeto del registro que representa a dicho dispositivo. Para asociar un certificado a su objeto, utilice el comando AttachThingPrincipal:

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

El comando AttachThingPrincipal no genera una salida.

Para obtener más información, consulte la Referencia attach-thing-principalde AWS CLI comandos.

Desvincular un principal de un objeto

Puede utilizar el comando DetachThingPrincipal para desvincular un certificado de un objeto:

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

El comando DetachThingPrincipal no genera ninguna salida.

Para obtener más información, consulte la Referencia detach-thing-principalde AWS CLI comandos.