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

En este artículo se describe la forma en que 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.

Proceso de incorporación para asociados

En pocas palabras, permitir que los usuarios consuman los eventos del servicio normalmente implica el siguiente proceso:

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. Crear 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. Channel 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 estará en desuso pronto.

6. Pruebe la funcionalidad de Eventos de Socios de principio a fin.

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

• Proporcione su propia solución, típicamente una experiencia web de interfaz gráfica de usuario (GUI) hospedada en su dominio mediante nuestro SDK y/o API REST para crear un canal (más reciente y recomendado) /canal de eventos (heredado) y su tema 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.
• Utilice el portal de Azure o la CLI para crear el canal (recomendado)/canal de eventos (heredado) y un tema de socio asociado. 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 incorporarse como asociado de Azure Event Grid mediante Azure Portal.

Comunicar 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 socio. 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.

Prerrequisitos

Para completar los pasos restantes, asegúrese de que tiene:

• Una suscripción de Azure. Si no tienes una, crea una cuenta gratuita antes de empezar.
• Un inquilino de Azure.

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.

   

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

   

Creación de un registro de asociado

1. Inicie sesión en Azure Portal.

2. Seleccione Todos los servicios en el panel de navegación izquierdo y escriba Registros de asociados de Event Grid en la barra de búsqueda y selecciónelo.

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

   

4. En la página Create Partner Topic Type Registrations - Basics (Crear registros de tipo de tema de colaborador: Aspectos básicos), escriba la siguiente información:

   1. En la sección Detalles del proyecto , siga estos pasos:
      1. Seleccione la suscripción de Azure.
      2. Seleccione un grupo de recursos de Azure existente o cree un nuevo grupo de recursos.
   2. En la sección Detalles del registro , siga estos pasos:
      1. En Nombre de 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 asociado , escriba los detalles sobre el tipo de recurso que se mostrará en la página de creación del tema de asociado :

      1. En Nombre del tipo de recurso 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.

         

5. Seleccione Siguiente: Servicio personalizado en la parte inferior de la página. En la pestaña Servicio al cliente de la página Crear registro de partners , escriba información que los usuarios suscriptores usarán para ponerse en contacto con usted cuando haya un problema con el origen del evento:

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

   2. Escriba extensión para el número de teléfono.

   3. Introduzca la URL de un sitio web de soporte técnico.

      

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

7. En la página Etiquetas , configure los valores siguientes.

   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, a continuación, seleccione Crear para crear el registro de asociado.

Crear un espacio de nombres de asociado

1. En Azure Portal, seleccione Todos los servicios en el menú de navegación izquierdo, escriba Espacios de nombres de asociados de Event Grid en la barra de búsqueda y 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.

   

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 un grupo de recursos.

   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 de 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 namespace.
         • Atributo de origen en el enrutamiento de eventos. Este enfoque de enrutamiento se basa en el valor del source atributo de contexto en el 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.
         • Channel es el nuevo tipo de recurso de enrutamiento y es la opción preferida. Un canal de eventos es un recurso heredado y estará en desuso pronto.

   3. En la sección Detalles del registro , siga estos pasos para asociar el espacio de nombres a 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 del asociado.
      3. Seleccione el registro de asociado en la lista desplegable.

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

      

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.

   

2. En la página Crear canal: aspectos básicos , siga estos pasos.

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

   2. En el 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 contiene eventos que un controlador va a procesar 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 asociado.

      3. Nombre del tema del asociado.

      4. Especifique la información de origen para el 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.

         

      5. Seleccione Agregar definiciones de tipo de evento para declarar el tipo de eventos que se envían al canal y a su tema asociado asociado. Los tipos de eventos se muestran a los clientes al crear suscripciones a eventos en el tema de socios y se utilizan para seleccionar los tipos específicos de eventos que se enviarán a un destino de gestión de eventos.

         

         

         

   4. Seleccione Siguiente: vínculo 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 socio asociado, marque la casilla junto a Establecer su propio mensaje de activación y escriba el mensaje.
      2. Para la hora de expiración, establezca el tiempo después de que se crea este canal en el que el tema del socio asociado y este canal se eliminarán automáticamente si el usuario final no lo activa. 1.Seleccione Siguiente: Revisar y crear.

      

   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 de tema de asociado:

Administrar un canal

Si ha creado un canal, puede que le interese actualizar la configuración una vez creado el recurso.

1. Vaya a la Configuración del 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.

   

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.

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

   partner-namespace-overview.png

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

3. En la página Create Event Channel - Basics (Crear canal de eventos: aspectos básicos ), especifique la siguiente 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 Especificaciones de Cloud Events 1.0 para obtener una idea de un valor adecuado para el origen. Consulte también este ejemplo de esquema de Cloud Events.

   2. En la sección Detalles de destino , escriba los detalles del tema del 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 del tema del asociado.
      3. Escriba un nombre para tema asociado.

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

      

4. En la página Filtros , agregue filtros. realice los pasos siguientes:

   1. Filtre por 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 propiedades personalizadas dentro de la carga de datos, usando el . como operador de anidamiento. Por ejemplo: data, data.key, data.key1.key2.

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

      

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

   1. La hora de expiración es la hora en la que el tema y su canal de eventos asociado se eliminarán automáticamente si el cliente no lo activa. En caso de que no se proporcione una hora, se usa un valor predeterminado de siete días. Active la casilla para especificar su propia hora de expiración.

   2. Dado que este tema es un recurso que no crea el usuario, una descripción puede ayudar al usuario a comprender la naturaleza de este 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: Revisar y crear.

      

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 temas de asociados que cree en sus suscripciones de Azure, primero tendrán que activar los temas de asociados. Para más información, consulte Activación de un tema de asociado.

Pasos siguientes

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

• Introducción a los eventos de partners para los clientes
• Visión general de los eventos para socios
• Suscribirse a eventos de asociados
• Suscribirse a eventos de Auth0