IoT Platform:Gestione los endpoints de instancia

Requisitos previos

• Para consultar las guías de desarrollo de SDK, consulte Device-side SDKs, IoT Platform SDK y Connect an AMQP client.

• Para ver una comparación de los tipos de instancia, consulte Instance overview.

  Instancia	Región	Descripción	Cómo consultarlo
  Instancia pública heredada	China (Shanghai), Japan (Tokyo), Singapore, Germany (Frankfurt), US (Silicon Valley) y US (Virginia)	En la página Overview de la consola de IoT Platform no se muestra ningún valor para el ID de la instancia.	El panel Development Configurations no está disponible en la consola de IoT Platform. Para conocer los detalles del endpoint, consulte View endpoints for legacy public instances.
  Instancia pública		En la página Overview de la consola de IoT Platform se muestra un valor para el ID de la instancia y hay una página Instance Details disponible. Se crea una instancia pública de forma predeterminada cuando activa IoT Platform.	El panel Development Configurations está disponible en la consola. View endpoints for public and Enterprise Edition instances.
  Instancia Enterprise Edition	China (Shanghai), China (Beijing), China (Shenzhen), Japan (Tokyo), Singapore, Germany (Frankfurt), US (Silicon Valley) y US (Virginia)

Contexto

• Tipos de endpoint

  • Los endpoints se clasifican en endpoints públicos y endpoints de VPC. Los endpoints de VPC reducen la latencia de red y los costos de ancho de banda público, además de mejorar la seguridad y estabilidad de la conexión.

  • Los dispositivos pueden conectarse a IoT Platform mediante MQTT, CoAP o HTTP. Las instancias Premium Enterprise Edition también admiten conexiones VPC, lo que permite a los dispositivos usar el endpoint de VPC de MQTT.

  • Para acceder a IoT Platform desde una instancia ECS dentro de una VPC, configure los endpoints de VPC para las suscripciones del lado del servidor de AMQP y las llamadas a la API de IoT Platform.

• Tipos de instancia

  • Las instancias Standard y Premium Enterprise Edition en China (Shanghai), China (Beijing) y China (Shenzhen) admiten vincular una IP fija al endpoint de MQTT.

  • Las instancias Premium Enterprise Edition requieren crear manualmente un endpoint de MQTT dedicado. También es posible personalizar el número de puerto y el certificado.

Consulte los endpoints de las instancias públicas heredadas

Reemplace los siguientes parámetros en las URL de los endpoints.

Consulte los endpoints de las instancias públicas y Enterprise Edition

1. Inicie sesión en la consola de IoT Platform. En la esquina superior izquierda de la página, seleccione la región donde se encuentra su instancia.

2. En la página Overview, haga clic en el alias de la instancia o en su ID.

3. En la esquina superior derecha de la página Instance Details, haga clic en View Development Configurations.

4. En el panel Development Configurations, haga clic en las pestañas MQTT, CoAP, AMQP u otros protocolos para consultar la información del endpoint. Haga clic en Copy junto al nombre de dominio para copiar la dirección del endpoint. Haga clic en el ícono de ayuda para ver el puerto. Para conocer los detalles de los puertos, consulte Consulte los endpoints de las instancias públicas heredadas.

   Importante

   • Para las instancias Premium Enterprise Edition, debe crear el endpoint de MQTT manualmente. Create a dedicated MQTT endpoint for a Premium Enterprise Edition instance.

   • Para las conexiones de dispositivos mediante HTTPS, solo se admiten los métodos de certificado único por dispositivo y de certificado único por producto basado en prerregistro. Estos métodos utilizan distintos endpoints:

     • Si utiliza el método de certificado único por dispositivo, el endpoint se muestra en la pestaña HTTP.

     • El método de certificado único por producto basado en prerregistro solo es compatible con la región China (Shanghai). El endpoint es iot-auth.cn-shanghai.aliyuncs.com.

   • Si habilitó la autenticación ID² para su instancia Enterprise Edition, no se mostrará la opción ID² Authentication Address en la pestaña Manage ID² del panel Development Configurations. Para conocer el formato de la dirección, consulte Consulte los endpoints de las instancias públicas heredadas.

   El panel Development Configurations tiene dos secciones: Public Endpoint y VPC Network Endpoint. Cada sección contiene pestañas para los protocolos compatibles (MQTT, CoAP, HTTP, AMQP). En estas pestañas encontrará las direcciones de los endpoints, los puertos de conexión y las configuraciones relacionadas. Por ejemplo, la pestaña MQTT muestra la dirección del endpoint, el puerto de conexión y el estado de vinculación de Fixed IP.

Vincule una IP fija a un endpoint

Una IP fija garantiza que la resolución DNS permanezca estable cuando IoT Platform escala sus direcciones IP. Si utiliza tarjetas SIM de IoT con planes de datos restringidos a direcciones IP específicas y su operador no admite la configuración de nombres de dominio, agregue la IP fija a la lista de permitidos de IP del operador.

Para vincular una IP fija al endpoint público de MQTT de una instancia:

• Para las instancias públicas, puede asignar dos IP fijas para las conexiones MQTT.

  1. En la esquina superior derecha de la página Instance Details de la instancia pública, haga clic en View Development Configurations.

  2. En el panel Development Configurations, en la pestaña MQTT, haga clic en Set junto a Fixed IP.

  3. En el cuadro de diálogo que aparece, haga clic en OK para obtener dos IP fijas.

  Si ya no necesita las IP fijas para las conexiones MQTT, haga clic en Unbind.

• Para las instancias Premium Enterprise Edition, se asigna automáticamente una IP fija cuando crea manualmente un endpoint público de MQTT. No se admite desvincularla.

Cree un endpoint de MQTT dedicado para instancias Premium Enterprise Edition

Para crear un endpoint de MQTT para una instancia Premium Enterprise Edition:

1. En la esquina superior derecha de la página Instance Details de la instancia Premium Enterprise Edition, haga clic en View Development Configurations.

2. En el panel Development Configurations, en la pestaña MQTT, haga clic en Create.

3. En el cuadro de diálogo Create Endpoint, configure la información del endpoint.

   Parámetro	Descripción
   Puerto personalizado	El número de puerto para las conexiones MQTT. El puerto predeterminado es 1883.
   Habilitar VPC	Sí: habilita las conexiones VPC. Configure la VPC, la zona del vSwitch, el vSwitch y el security group. Esto crea endpoints de MQTT tanto públicos como de VPC. Importante Para habilitar un endpoint de MQTT sobre una VPC, active el servicio PrivateLink. Si PrivateLink no está activado, haga clic en Enable para ir a la consola de VPC y activarlo. No (predeterminado): deshabilita las conexiones VPC. Esto solo crea un endpoint público de MQTT. Importante Si selecciona No, no podrá habilitar conexiones VPC para este endpoint más adelante.
   Autorización	Si habilita las conexiones VPC, otorgue la autorización correspondiente. Haga clic en Authorize. El sistema crea un rol y una política de autorización para permitir que los dispositivos se conecten a IoT Platform a través de la VPC. Service-linked roles.
   VPC	Después de habilitar las conexiones VPC y otorgar la autorización, configure estos parámetros. Seleccione una VPC y un vSwitch existentes. Puede hacer clic en Create VPC o Create vSwitch para crear nuevos recursos. Create a VPC y Create a vSwitch.
   Zona del vSwitch
   vSwitch
   Security group	Después de habilitar las conexiones VPC y otorgar la autorización, configure este parámetro. Seleccione un security group existente. Puede hacer clic en Create Security Group para crear uno. Create a security group.

4. Haga clic en OK.

   Una vez creado el endpoint, el nuevo endpoint aparecerá en MQTT Device Connection.

Personalice el certificado de MQTT para instancias Premium Enterprise Edition

Para personalizar el certificado y el nombre de dominio de las conexiones MQTT hacia una instancia Premium Enterprise Edition:

1. En la esquina superior derecha de la página Instance Details de la instancia Premium Enterprise Edition, haga clic en View Development Configurations.

2. En el panel Development Configurations, en la pestaña MQTT, haga clic en Configure debajo de Custom Certificate.

3. En el cuadro de diálogo Custom Certificate, en Custom Configuration, haga clic en On.

   Nota

   Si Custom Configuration ya está habilitado, omita este paso.

4. Introduzca el contenido del certificado en formato PEM y la clave privada obtenidos de su autoridad certificadora (CA), luego haga clic en OK.

   Aviso

   Actualizar el contenido del certificado o la clave privada después de la configuración inicial puede provocar que falle la verificación del certificado. Esto desconecta los dispositivos de IoT Platform e interrumpe los servicios. Proceda con precaución.

   La página muestra el nombre de dominio personalizado analizado sintácticamente a partir de su certificado. Utilice este nombre de dominio para las conexiones MQTT de los dispositivos.

   Importante

   Configure un registro CNAME con su proveedor de dominio para resolver el nombre de dominio personalizado hacia el endpoint de MQTT predeterminado de la instancia.