Utilice la configuración guiada por el usuario 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 la configuración guiada por el usuario 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 guiada por el usuario.

Requisitos previos

Complete estos pasos antes de intentar incorporar un dispositivo:

Requisito previo: active el modo de emparejamiento en su dispositivo Z Wave

Habilite el modo de emparejamiento en el dispositivo Z-Wave. El modo de emparejamiento puede variar para cada dispositivo Z-Wave, así que consulta las instrucciones del dispositivo para configurar correctamente el modo de emparejamiento. Por lo general, es un botón que el usuario debe presionar.

Paso 1: iniciar la detección del dispositivo

Inicie la detección de dispositivos en su hub para obtener un ID de trabajo de detección que se utilizará para integrar el dispositivo.

Para iniciar la detección de dispositivos

  • Utilice el start-device-discoverycomando para obtener el ID del trabajo de detección.

    Ejemplo de start-device-discovery

    #For Zigbee
  aws iot-managed-integrations start-device-discovery --discovery-type ZIGBEE \
  --controller-identifier HUB_MANAGED_THING_ID
  
  #For Zwave
  aws iot-managed-integrations start-device-discovery --discovery-type ZWAVE \
  --controller-identifier HUB_MANAGED_THING \
  --authentication-material-type ZWAVE_INSTALL_CODE \
  --authentication-material 13333
  
  #For Cloud
  aws iot-managed-integrations start-device-discovery --discovery-type CLOUD \
  --account-association-id C2C_ASSOCIATION_ID \
  
  #For Custom
  aws iot-managed-thing start-device-discovery --discovery-type CUSTOM \
  --controller-identifier HUB_MANAGED_THING_ID \
  --custom-protocol-detail NAME : NON_EMPTY_STRING \

    Respuesta:

    {
      "Id": DISCOVERY_JOB_ID,
      "StartedAt": "2025-06-03T14:43:12.726000-07:00"
  }
    nota

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

    Para obtener más información, consulte la start-device-discoveryAPI en la Referencia de comandos de integraciones AWS CLI gestionadas.

Paso 2: consulte el ID del trabajo de detección

Utilice el list-discovered-devices comando para obtener el material de autenticación de su dispositivo.

Para consultar su ID de trabajo de descubrimiento

  • Use el ID del trabajo de detección con el list-discovered-devices comando para obtener el material de autenticación de su dispositivo.

    aws iot-managed-integrations list-discovered-devices --identifier DISCOVERY_JOB_ID

Respuesta:

"Items": [
    {
        "DeviceTypes": [],
        "DiscoveredAt": "2025-06-03T14:43:37.619000-07:00",
        "AuthenticationMaterial": AUTHENTICATION_MATERIAL
    }
]

Paso 3: Crea un elemento gestionado para tu dispositivo

Usa el create-managed-thing comando para crear un elemento gestionado para tu 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

    aws iot-managed-integrations create-managed-thing \
  --role  DEVICE --authentication-material-type DISCOVERED_DEVICE \
  --authentication-material "AUTHENTICATION_MATERIAL"

    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 AWS CLI comandos de integraciones administradas.

Paso 4: consulta el elemento gestionado

Puede comprobar si un elemento gestionado está activado mediante el get-managed-thing comando.

Para consultar un elemento gestionado

  • Utilice el get-managed-thing comando para comprobar si el estado de aprovisionamiento del elemento gestionado está establecido en. ACTIVATED

    Ejemplo de get-managed-thing

    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/DEVICE_MANAGED_THING_ID,
      "Role": "DEVICE",
      "ProvisioningStatus": "ACTIVATED",
      "MacAddress": "MAC_ADDRESS",
      "ParentControllerId": "PARENT_CONTROLLER_ID",
      "CreatedAt": "2025-06-03T14:46:35.149000-07:00",
      "UpdatedAt": "2025-06-03T14:46:37.500000-07:00",
      "Tags": {}
  }

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

Paso 5: Obtenga las capacidades de gestión

Para ver una lista de las acciones disponibles de un elemento gestionado, utilice elget-managed-thing-capabiltiies.

Para obtener las capacidades de un dispositivo

  • Utilice el get-managed-thing-capabilities comando para obtener el ID del punto final. Anote también la lista de posibles acciones.

    Ejemplo de get-managed-thing-capabilities

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

    Respuesta:

    {
      "ManagedThingId": "DEVICE_MANAGED_THING_ID",
      "CapabilityReport": {
          "version": "1.0.0",
          "nodeId": "zb.539D+4A1D",
          "endpoints": [
              {
                  "id": "1",
                  "deviceTypes": [
                      "Unknown Device"
                  ],
                  "capabilities": [
                      {
                          "id": "matter.OnOff@1.4",
                          "name": "On/Off",
                          "version": "6",
                          "properties": [
                              "OnOff",
                              "OnOff",
                              "OnTime",
                              "OffWaitTime"
                          ],
                          "actions": [
                              "Off",
                              "On",
                              "Toggle",
                              "OffWithEffect",
                              "OnWithRecallGlobalScene",
                              "OnWithTimedOff"
                          ],
                          ...
  }

    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

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

Envía un comando al elemento gestionado mediante una acción de alternancia.

  • Usa el send-managed-thing-command comando para enviar un comando de alternancia.

    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: Compruebe el estado de las cosas gestionadas

Compruebe el estado del elemento gestionado para comprobar que la acción de conmutación se ha realizado correctamente.

Para comprobar el estado del dispositivo de un elemento gestionado

  • Usa el get-managed-thing-state comando para validar que la acción de alternancia se realizó correctamente.

    Ejemplo de get-managed-thing-state

    
  aws iot-managed-integrations get-managed-thing-state --managed-thing-id DEVICE_MANAGED_THING_ID

    Respuesta:

    {
      "Endpoints": [
          {
              "endpointId": "1",
              "capabilities": [
                  {
                      "id": "matter.OnOff@1.4",
                      "name": "On/Off",
                      "version": "1.4",
                      "properties": [
                          {
                              "name": "OnOff",
                              "value": {
                                  "propertyValue": true,
                                  "lastChangedAt": "2025-06-03T21:50:39.886Z"
                              }
                          }
                      ]
                  }
              ]
          }
      ]
  }

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

Paso 8: Elimina lo gestionado de tu hub

Limpia tu hub quitando lo gestionado.

Para eliminar una cosa gestionada

  • Utilice el delete-managed-thingcomando para eliminar un elemento gestionado.

    Ejemplo de delete-managed-thing

    aws iot-managed-integrations delete-managed-thing \
  --identifier MANAGED_THING_ID

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

    nota

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

    nota

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