Incorporación como asociado de Azure Event Grid mediante Azure Portal

  • Artículo

En este artículo se describe cómo los proveedores de SaaS de terceros, también conocidos como asociados, se incorporan a Event Grid para poder publicar eventos desde sus servicios y cómo los usuarios finales consumen esos eventos.

Importante

Los asociados pueden publicar eventos en Azure Event Grid y también recibirlos de este servicio. Estas funcionalidades se habilitan a través de la característica Eventos de asociado. Si no está familiarizado con la característica Eventos de asociado, consulte la información general de Eventos de asociado para una introducción detallada de los conceptos clave que son críticos para comprender y seguir los pasos de este artículo.

Proceso de incorporación de asociados

En resumen, la habilitación de los eventos del servicio para que los consuman los usuarios suele implicar el proceso siguiente:

  1. Comunique su interés en convertirse en asociado al equipo de servicio de Event Grid.

  2. Registre el proveedor de recursos de Event Grid con su suscripción de Azure.

  3. Cree un registro de asociado.

  4. Cree un espacio de nombres.

  5. Cree un canal y un tema de asociado en un solo paso.

    Importante

    Es posible que pueda crear un canal de eventos (heredado), que admite temas de asociados. Canal es el nuevo tipo de recurso de enrutamiento y es la opción preferida que admite el envío de eventos a través de temas de asociados. Un canal de eventos es un recurso heredado y pronto quedará en desuso.

  6. Pruebe de manera integral la funcionalidad Eventos de asociado.

En el paso 5, debe decidir qué clase de experiencia de usuario quiere proporcionar. Tiene las siguientes opciones:

  • Proporcione su propia solución, por lo general una experiencia de interfaz gráfica de usuario (GUI) web, hospedada en su dominio con nuestra SDK o API REST para crear un canal (la opción más reciente y recomendable) o un canal de eventos (opción heredada) y su tema de asociado correspondiente. Con esta opción, puede pedirle al usuario la suscripción y el grupo de recursos en el que va a crear un tema de asociado.
  • Use Azure Portal o la CLI de Azure para crear el canal (opción recomendada) o el canal de eventos (opción heredada) y el tema de asociado correspondiente. Con esta opción, debe tener acceso de algún modo a la suscripción de Azure del usuario y al grupo de recursos en el que creará un tema de asociado.

En este artículo se muestra cómo realizar la incorporación como asociado de Azure Event Grid mediante Azure Portal.

Comunique su interés en convertirse en asociado

Póngase en contacto con el equipo de Event Grid en askgrid@microsoft.com para comunicar su interés en convertirse en asociado. Conversaremos con usted para compartir información detallada sobre los casos de uso, los roles, el proceso de incorporación, la funcionalidad y el precio de Eventos de asociado, entre otros.

Requisitos previos

Para completar los pasos restantes, asegúrese de tener lo siguiente:

Registro del proveedor de recursos de Event Grid

A menos que haya usado Event Grid antes, deberá registrar el proveedor de recursos de Event Grid. Si ha usado Event Grid anteriormente, vaya a la siguiente sección.

En Azure Portal, realice los siguientes pasos:

  1. En el menú de la izquierda, seleccione Suscripciones.

  2. Seleccione la suscripción que desea usar para Event Grid en la lista de suscripciones.

  3. En la página Suscripción, seleccione Proveedores de recursos en Configuración del menú izquierdo.

  4. Busque Microsoft.EventGrid y confirme que el estado es No registrado.

  5. Seleccione Microsoft.EventGrid en la lista de proveedores.

  6. Seleccione Registrar en la barra de comandos.

    Image showing the registration of Microsoft.EventGrid provider with the Azure subscription.

  7. Actualice para asegurarse de que el estado de Microsoft.EventGrid se cambia a Registrado.

    Image showing the successful registration of Microsoft.EventGrid provider with the Azure subscription.

Creación de un registro de asociado

  1. Inicie sesión en Azure Portal.

  2. En el panel de navegación de la izquierda, seleccione Todos los servicios, escriba Registros de asociado de Event Grid en la barra de búsqueda y selecciónelo.

  3. En la página Registros de asociado de Event Grid, seleccione + Crear en la barra de comandos o en el vínculo Crear registros de asociado de Event Grid de la página.

    Add partner registration link

  4. En la página Creación de registros de tipo de tema de asociado: aspectos básicos, escriba esta información:

    1. En la sección Detalles del proyecto, siga estos pasos:
      1. Selección la suscripciónde Azure.
      2. Seleccione un grupo de recursos de Azure existente o cree uno nuevo.
    2. En la sección Detalles del registro, siga estos pasos:
      1. En Nombre del registro, escriba un nombre para el registro.
      2. En Nombre de la organización, escriba el nombre de la organización.
    3. En la sección Tipo de recurso de asociado, escriba detalles sobre el tipo de recurso que se mostrarán en la página de creación del tema de asociado:

      1. En Nombre del tipo de recurso de asociado, escriba el nombre del tipo de recurso.

      2. En Nombre para mostrar, escriba un nombre descriptivo para mostrar para el tipo de tema de asociado (recurso).

      3. Escriba una descripción para el tipo de recurso.

      4. Escriba una descripción para el escenario. Debe explicar las maneras o los escenarios en los que se pueden usar los temas de asociados para los recursos.

        Create partner registration

  5. Seleccione Siguiente: Servicio personalizado en la parte inferior de la página. En la pestaña Atención al cliente de la página Creación de registros de asociado, escriba la información que usarán los usuarios suscriptores para ponerse en contacto en caso de problemas con el origen del evento:

    1. Escriba el número de teléfono.

    2. Escriba la extensión del número de teléfono.

    3. Escriba la dirección URL de un sitio web de soporte.

      Create partner registration - customer service

  6. Seleccione Siguiente: Etiquetas en la parte inferior de la página.

  7. En la página Etiquetas, configure estos valores.

    1. Escriba un nombre y un valor para la etiqueta que desea agregar. Este paso es opcional.
    2. Seleccione Revisar y crear en la parte inferior de la página para crear el registro (tipo de tema de asociado).

  8. En la página Revisar y crear, revise toda la configuración y seleccione Crear para crear el registro de asociado.

Creación de un espacio de nombres de asociado

  1. En Azure Portal, seleccione Todos los servicios en el menú de navegación de la izquierda, luego escriba Espacios de nombres de asociado de Event Grid en la barra de búsqueda y, luego, selecciónelo en la lista.

  2. En la página Espacios de nombres de asociado de Event Grid, seleccione + Crear en la barra de herramientas.

    Partner namespaces - Add link

  3. En la página Creación de un espacio de nombres de asociado: aspectos básicos, especifique esta información.

    1. En la sección Detalles del proyecto, siga estos pasos:

      1. Seleccione una suscripción de Azure.
      2. Seleccione un grupo de recursos existente o cree uno nuevo.

    2. En la sección Detalles del espacio de nombres, siga estos pasos:

      1. Escriba el nombre del espacio de nombres.

      2. Seleccione una ubicación para el espacio de nombres.

      3. En Modo de enrutamiento de temas de asociado, seleccione Encabezado de nombre de canal o Atributo de origen en evento.

        • Enrutamiento mediante Encabezado de nombre de canal: con este tipo de enrutamiento, se publican eventos mediante un encabezado http llamado aeg-channel-name donde se proporciona el nombre del canal al que se deben enrutar los eventos. Si selecciona esta opción, creará canales en el espacio de nombres.
        • Enrutamiento mediante Atributo de origen en evento. Este enfoque de enrutamiento se basa en el valor del atributo de contexto source del evento. Si selecciona esta opción, creará canales de eventos que son el equivalente heredado de los canales y que pronto quedarán en desuso.

        Importante

        • No es posible actualizar el modo de enrutamiento una vez creado el espacio de nombres.
        • Canal es el nuevo tipo de recurso de enrutamiento y es la opción preferida. Un canal de eventos es un recurso heredado y pronto quedará en desuso.

    3. En la sección Detalles del registro, siga estos pasos para asociar el espacio de nombres con un registro de asociado.

      1. Seleccione la suscripción en la que existe el registro de asociado.
      2. Seleccione el grupo de recursos que contiene el registro de asociado.
      3. Seleccione el registro de asociado en la lista desplegable.

    4. Seleccione Siguiente: Etiquetas en la parte inferior de la página.

      Create partner namespace - basics page

  4. En la página Etiquetas, agregue etiquetas (opcional).

    1. Escriba un nombre y un valor para la etiqueta que desea agregar. Este paso es opcional.
    2. En la parte inferior de la página, seleccione Revisar y crear.

  5. En la página Revisar y crear, revise los detalles y seleccione Crear.

Crear un canal

Si seleccionó Encabezado de nombre de canal como modo de enrutamiento de temas de asociado, cree un canal mediante los pasos de esta sección.

  1. Vaya a la página Información general del espacio de nombres del asociado que creó y seleccione + Canal en la barra de comandos.

    Image showing the selection of Create Channel button on the command bar of the Event Grid Partner Namespace page.

  2. En la página Creación de un canal: Aspectos básicos, siga estos pasos.

    1. Escriba un nombre para el canal. El nombre del canal debe ser único en la región en la que se crea.

    2. Como tipo de canal, seleccione Tema de asociado.

      Los temas de asociados son recursos que contienen eventos publicados. Seleccione Tema de asociado si desea reenviar eventos a un tema de asociado que contenga eventos que va a procesar un controlador más adelante.

    3. Si seleccionó Tema de asociado, escriba los detalles siguientes:

      1. Identificador de la suscripción en la que se creará el tema de asociado.

      2. Grupo de recursos en el que se creará el tema de asociado.

      3. Nombre del tema de asociado.

      4. Especifique la información de origen del tema del asociado. El origen es información contextual sobre el origen de los eventos proporcionados por el asociado que puede ver el usuario final. Esta información es útil si el usuario final está considerando la posibilidad de activar un tema de asociado, por ejemplo.

        Image showing the Create Channel - Basics page.

      5. Seleccione Agregar definiciones de tipo de evento para declarar el tipo de eventos que se envían al canal y al tema de su asociado asignado. Los tipos de eventos se muestran a los clientes al crear suscripciones de eventos en el tema del asociado y se usan para seleccionar los tipos de eventos específicos que se van a enviar a un destino de controlador de eventos.

        Screenshot that shows the Event Types Definitions section with Add event types definitions option selected.

        Screenshot that shows the definition of a sample event type.

        Screenshot that shows a list with the event type definition that was added.

    4. Seleccione el vínculo Siguiente: Características adicionales en la parte inferior de la página.

    5. En la página Características adicionales, siga estos pasos:

      1. Para establecer su propio mensaje de activación que pueda ayudar al usuario final a activar el tema del asociado, active la casilla situada junto a Establecer su propio mensaje de activación y escriba el mensaje.
      2. Como Tiempo de expiración, establezca una hora posterior a la creación de este canal en la que se crea el tema del asociado y este canal se eliminará automáticamente si el usuario final no lo activa. 1. Seleccione Siguiente:Revisar y crear.

      Image showing the Create Channel - Additional Features page.

    6. En la página Revisar y crear, revise toda la configuración del canal y seleccione Crear en la parte inferior de la página.

      Opción Tema de asociado: Image showing the Create Channel - Review + create page.

Administración de un canal

Si ha creado un canal, es posible que le interese actualizar la configuración una vez que se haya creado el recurso.

  1. Vaya a Configuración en el canal. Puede actualizar el mensaje para la activación del tema de asociado, la hora de expiración si no está activada y las definiciones de tipos de eventos.

    Screenshot that shows the Configuration page of a channel.

Importante

No olvide guardar los cambios antes de salir de la página de configuración.

Creación de un canal de eventos

Si seleccionó Atributo de origen en evento como modo de enrutamiento de temas de asociado, cree un canal de eventos mediante los pasos de esta sección.

Importante

  • Canal es el nuevo tipo de recurso de enrutamiento y es la opción preferida.

  1. Vaya a la página Información general del espacio de nombres que creó.

    Partner namespace - overview page partner-namespace-overview.png

  2. Seleccione + Canal de eventos en la barra de herramientas.

  3. En la página Creación de un canal de eventos: aspectos básicos, especifique esta información.

    1. En la sección Detalles del canal, siga estos pasos:

      1. En Nombre del canal de eventos, escriba un nombre para el canal de eventos.
      2. Escriba el origen. Consulte las especificaciones de CloudEvents 1.0 para obtener una idea de un valor adecuado para el origen. Consulte también este ejemplo de esquema de CloudEvents.

    2. En la sección Detalles del destino, escriba los detalles del tema de asociado de destino que se creará para este canal de eventos.

      1. Escriba el id. de la suscripción en la que se creará el tema de asociado.
      2. Escriba el nombre del grupo de recursos en el que se creará el recurso de tema de asociado.
      3. Escriba un nombre para el tema de asociado.

    3. Seleccione Siguiente: Filtros en la parte inferior de la página.

      Create event channel - basics page

  4. En la página Filtros, agregue filtros. siga estos pasos:

    1. Filtre según los atributos de cada evento. Solo se entregan los eventos que coinciden con todos los filtros. Se pueden especificar hasta 25 filtros. Las comparaciones no distinguen entre mayúsculas y minúsculas. Las claves válidas usadas para los filtros varían en función del esquema de eventos. En el ejemplo siguiente, eventid, source, eventtype y eventtypeversioin se pueden usar para las claves. También puede usar las propiedades personalizadas dentro de la carga de datos al usar . como el operador anidado. Por ejemplo: data, data.key, data.key1.key2.

    2. Seleccione Siguiente: Características adicionales en la parte inferior de la página.

      Create event channel - filters page

  5. En la página Características adicionales, puede establecer un plazo de expiración y una descripción para el tema de asociado.

    1. El plazo de expiración es el plazo después del cual se eliminarán automáticamente el tema y su canal de eventos asociado si no los activa el cliente. Si no se proporciona un plazo, se usa un valor predeterminado de siete días. Active la casilla para especificar su propio plazo de expiración.

    2. Como este tema es un recurso no creado por el usuario, una descripción puede ayudar al usuario a entender la naturaleza del tema. Si no se establece ninguna, se proporcionará una descripción genérica. Active la casilla para establecer su propia descripción de tema de asociado.

    3. Seleccione Siguiente: Review + create (Revisar y crear).

      Create event channel - additional features page

  6. En Revisar y crear, revise la configuración y seleccione Crear para crear el canal de eventos.

Activación de un tema de asociado

Antes de que los usuarios puedan suscribirse a los temas de asociado que cree en sus suscripciones de Azure, primero tendrán que activarlos. Para más información, consulte Activación de un tema de asociado.

Pasos siguientes

Consulte los siguientes artículos para más información sobre la característica Eventos de asociado: