Utilice una configuración sencilla para incorporar y operar los dispositivos - Integraciones gestionadas para AWS IoT Device Management
Requisitos previos

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Utilice una configuración sencilla para incorporar y operar los dispositivos

Configure sus dispositivos para que se integren a su centro de integraciones gestionadas creando un elemento gestionado y conectándolo a su centro. En esta sección se describen los pasos para completar el proceso de incorporación del dispositivo mediante una configuración sencilla.

Requisitos previos

Complete estos pasos antes de intentar incorporar un dispositivo:

  • Incorpore un dispositivo hub al hub de integraciones gestionadas.

  • Instale la última versión de AWS CLI desde la Referencia de comandos de Managed Integrations AWS CLI

  • Suscríbase a las notificaciones de eventos de DEVICE_LIFE_CYCLE.

Paso 1: Crea un casillero de credenciales

Cree un casillero de credenciales para su dispositivo.

Para crear un casillero de credenciales

  • Utilice el comando create-credential-locker. La ejecución de este comando activará la creación de todos los recursos de fabricación, incluidos el key pair de claves de configuración de Wi-Fi y el certificado del dispositivo.

    Ejemplo de create-credential-locker

    aws iot-managed-integrations create-credential-locker \
  --name "DEVICE_NAME"

    Respuesta:

    {    
  "Id": "LOCKER_ID"
  "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:credential-locker/LOCKER_ID
  "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
}

    Para obtener más información, consulte el create-credential-lockercomando en la Referencia de AWS CLI comandos de integraciones gestionadas.

Paso 2: Añada el casillero de credenciales a su hub

Agrega el casillero de credenciales a tu hub.

Para añadir un casillero de credenciales a tu hub

  • Usa el siguiente comando para añadir un casillero de credenciales a tu hub.

    aws iotmi --region AWS_REGION --endpoint AWS_ENDPOINT update-managed-thing \
--identifier "HUB_MANAGED_THING_ID" --credential-locker-id "LOCKER_ID"

Paso 3: Crea un elemento gestionado con credenciales.

Cree un elemento gestionado con las credenciales de su dispositivo. Cada dispositivo requiere su propio dispositivo gestionado.

Para crear un elemento gestionado

  • Usa el create-managed-thing comando para crear un elemento gestionado para tu dispositivo.

    Ejemplo de create-managed-thing

    #ZWAVE: 
aws iot-managed-integrations create-managed-thing --role DEVICE \
--authentication-material '900137947003133...' \ #auth material from zwave qr code
--authentication-material-type ZWAVE_QR_BAR_CODE \
--credential-locker-id ${locker_id}

#ZIGBEE:
aws iot-managed-integrations create-managed-thing --role DEVICE \
--authentication-material 'Z:286...$I:A4DC00.' \ #auth material from zigbee qr code
--authentication-material-type ZIGBEE_QR_BAR_CODE \
--credential-locker-id ${locker_id}
    nota

    Hay comandos separados para los dispositivos Z-Wave y Zigbee.

    Respuesta:

    {    
  "Id": "DEVICE_MANAGED_THING_ID"
  "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:managed-thing/DEVICE_MANAGED_THING_ID"
  "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
}

    Para obtener más información, consulte el create-managed-thingcomando en la Referencia de comandos de integraciones AWS CLI administradas.

Paso 4: Conecta el dispositivo y comprueba su estado.

Enchufe el dispositivo y compruebe su estado.

  • Usa el get-managed-thing comando para comprobar el estado del dispositivo.

    Ejemplo de get-managed-thing

    #KINESIS NOTIFICATION:
{
    "version": "1.0.0",
    "messageId": "4ac684bb7f4c41adbb2eecc1e7991xxx",
    "messageType": "DEVICE_LIFE_CYCLE",
    "source": "aws.iotmanagedintegrations",
    "customerAccountId": "12345678901",
    "timestamp": "2025-06-10T05:30:59.852659650Z",
    "region": "us-east-1",
    "resources": ["XXX"],
    "payload": {
        "deviceDetails": {
            "id": "1e84f61fa79a41219534b6fd57052XXX",
            "arn": "XXX",
            "createdAt": "2025-06-09T06:24:34.336120179Z",
            "updatedAt": "2025-06-10T05:30:59.784157019Z"
        },
        "status": "ACTIVATED"
    }
}
aws iot-managed-integrations get-managed-thing \
--identifier :"DEVICE_MANAGED_THING_ID"

    Respuesta:

    {    
  "Id": "DEVICE_MANAGED_THING_ID"
  "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:managed-thing/MANAGED_THING_ID"
  "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
}

    Para obtener más información, consulta el get-managed-thingcomando en la Referencia de AWS CLI comandos de integraciones gestionadas.

Paso 5: Obtenga las capacidades del dispositivo

Use el get-managed-thing-capabilities comando para obtener su ID de punto final y ver una lista de posibles acciones para su dispositivo.

Para obtener las capacidades de un dispositivo

  • Usa el get-managed-thing-capabilities comando y anota el ID del punto final.

    Ejemplo de get-managed-thing-capabilties

    aws iotmi get-managed-thing-capabilities \
--identifier "DEVICE_MANAGED_THING_ID"

    Respuesta:

    {    
    "ManagedThingId": "1e84f61fa79a41219534b6fd57052cbc",
    "CapabilityReport": {
        "version": "1.0.0",
        "nodeId": "zw.FCB10009+06",
        "endpoints": [
            {
                "id": "ENDPOINT_ID"
                "deviceTypes": [
                    "On/Off Switch"
                ],
                "capabilities": [
                    {
                        "id": "matter.OnOff@1.4",
                        "name": "On/Off",
                        "version": "6",
                        "properties": [
                            "OnOff"
                        ],
                        "actions": [
                            "Off",
                            "On"
                        ],
                        "events": []
                    }
                    ...
}

    Para obtener más información, consulte el get-managed-thing-capabilitiescomando en la Referencia de AWS CLI comandos de integraciones gestionadas.

Paso 6: Enviar un comando al elemento gestionado

Usa el send-managed-thing-command comando para enviar un comando de alternancia a tu objeto gestionado.

Para enviar un comando a tu elemento gestionado

  • Usa el send-managed-thing-command comando para enviar un comando a tu dispositivo gestionado.

    Ejemplo de send-managed-thing-command

    json=$(jq -cr '.|@json') <<EOF
[
  {
    "endpointId": "1",
    "capabilities": [
      {
        "id": "matter.OnOff@1.4",
        "name": "On/Off",
        "version": "1",
        "actions": [
          {
            "name": "Toggle",
            "parameters": {}
          }
        ]
      }
    ]
  }
]
EOF
aws iot-managed-integrations send-managed-thing-command \
--managed-thing-id "DEVICE_MANAGED_THING_ID" --endpoints "ENDPOINT_ID"
    nota

    En este ejemplo se usa jq cli, pero también puedes pasar la cadena completa endpointId

    Respuesta:

    {    
"TraceId": "TRACE_ID"
}

    Para obtener más información, consulte el send-managed-thing-commandcomando en la Referencia de AWS CLI comandos de integraciones administradas.

Paso 7: Elimina lo gestionado de tu hub

Limpia tu hub quitando lo gestionado.

Para eliminar una cosa gestionada

  • Usa el delete-managed-thing comando para eliminar un elemento gestionado del hub de dispositivos.

    Ejemplo de delete-managed-thing

    aws iot-managed-integrations delete-managed-thing \
--identifier "DEVICE_MANAGED_THING_ID"

    Para obtener más información, consulte el delete-managed-thingcomando en la Referencia de AWS CLI comandos de integraciones administradas.

    nota

    Si el dispositivo está atascado en un DELETE_IN_PROGRESS estado, añada la --force bandera al. delete-managed-thing command

    nota

    En el caso de los dispositivos Z-Wave, debe poner el dispositivo en modo de emparejamiento después de ejecutar el comando.