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.

# Configuración sencilla para incorporar y operar dispositivos
<a name="managedintegrations-sdk-v2-cookbook-ss"></a>

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
<a name="managedintegrations-sdk-v2-cookbook-ss-prereq"></a>

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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/)
+ Suscríbase a las notificaciones de eventos de [DEVICE\$1LIFE\$1CYCLE](managedintegrations-notifications.md#managedintegrations-notification-setup).

**Topics**
+ [Requisitos previos](#managedintegrations-sdk-v2-cookbook-ss-prereq)
+ [Paso 1: Crea un casillero de credenciales](#managedintegrations-sdk-v2-cookbook-credential-locker)
+ [Paso 2: Añada el casillero de credenciales a su hub](#managedintegrations-sdk-v2-cookbook-add-to-hub)
+ [Paso 3: Crea un elemento gestionado con credenciales.](#managedintegrations-sdk-v2-cookbook-ss-create-managed-thing)
+ [Paso 4: Conecta el dispositivo y comprueba su estado.](#managedintegrations-sdk-v2-cookbook-ss-check-device-status)
+ [Paso 5: Obtenga las capacidades del dispositivo](#managedintegrations-sdk-v2-cookbook-ss-check-device-capabilities)
+ [Paso 6: Enviar un comando al elemento gestionado](#managedintegrations-sdk-v2-cookbook-ss-control-device)
+ [Paso 7: Elimine lo gestionado de su hub](#managedintegrations-sdk-v2-cookbook-clean-up)

## Paso 1: Crea un casillero de credenciales
<a name="managedintegrations-sdk-v2-cookbook-credential-locker"></a>

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-locker](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-credential-locker.html)comando en la *Referencia de AWS CLI comandos* de integraciones gestionadas.

## Paso 2: Añada el casillero de credenciales a su hub
<a name="managedintegrations-sdk-v2-cookbook-add-to-hub"></a>

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.
<a name="managedintegrations-sdk-v2-cookbook-ss-create-managed-thing"></a>

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-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-managed-thing.html)comando en la Referencia de comandos de integraciones AWS CLI administradas.*

## Paso 4: Conecta el dispositivo y comprueba su estado.
<a name="managedintegrations-sdk-v2-cookbook-ss-check-device-status"></a>

**Enchufe el dispositivo y compruebe su estado.**
+ Usa el `get-managed-thing` comando para comprobar el estado del dispositivo. Lo que gestionas debe estar ACTIVADO. ProvisioningStatus Para obtener más información ProvisioningStatus, consulte [Aprovisionamiento de dispositivos](https://docs.aws.amazon.com/iot-mi/latest/devguide/device-provisioning.html).

  **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, consulte el [get-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing.html)comando en la Referencia de AWS CLI *comandos* de integraciones administradas.

## Paso 5: Obtenga las capacidades del dispositivo
<a name="managedintegrations-sdk-v2-cookbook-ss-check-device-capabilities"></a>

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-capabilities](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing-capabilities.html)comando en la *Referencia de AWS CLI comandos* de integraciones gestionadas.

## Paso 6: Enviar un comando al elemento gestionado
<a name="managedintegrations-sdk-v2-cookbook-ss-control-device"></a>

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-command](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/send-managed-thing-command.html)comando en la Referencia de AWS CLI *comandos* de integraciones administradas.

## Paso 7: Elimine lo gestionado de su hub
<a name="managedintegrations-sdk-v2-cookbook-clean-up"></a>

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-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/delete-managed-thing.html)comando 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.