Actualiza los parámetros del dominio multicast

Disponibilidad general con lista de entidades permitidas: El acceso a Cloud Multicast está disponible para clientes Google Cloud seleccionados. Si te interesa, envía un formulario de solicitud de acceso.

En esta página, se describe cómo cambiar el tamaño de la infraestructura de transmisión simultánea para tu dominio actualizando los parámetros de tráfico de las activaciones existentes del dominio de transmisión simultánea zonal para Cloud Multicast.

Para obtener información sobre cómo crear y activar dominios de transmisión simultánea, consulta Crea dominios de transmisión simultánea.

Antes de comenzar

Antes de actualizar los parámetros del dominio de transmisión multidifusión, revisa lo siguiente y planifica la actualización en consecuencia:

• Disponibilidad del servicio durante la actualización: Este procedimiento puede causar una interrupción temporal del servicio mientras Google Cloud reaprovisiona tu infraestructura de multidifusión según los nuevos parámetros que proporcionas.

  • La interrupción del servicio se aplica a la infraestructura de multidifusión para la activación de dominio de multidifusión específica que estás actualizando. Durante la actualización, los productores y consumidores de multicast no pueden enviar ni recibir tráfico para el dominio y la zona de multicast correspondientes.

  • La duración de la interrupción del servicio depende de varios factores, como la escala de tu infraestructura de transmisión por grupos actual, la cantidad de activaciones de rangos de grupos de transmisión por grupos creadas con la activación del dominio y la escala de los nuevos parámetros que proporcionas. En el caso de las configuraciones a gran escala, la actualización puede tardar entre 30 minutos y 1 hora en completarse.

• Cambios en los cargos de facturación después de la actualización: Las activaciones de dominios multicast generan cargos de facturación, como se describe en Facturación. Actualizar los parámetros de tráfico de una activación de dominio de multicast puede afectar los cargos de facturación de tu proyecto. Para obtener más información, comunícate con tuGoogle Cloud representante de ventas.

• Acción requerida por los consumidores de multicast después de la actualización: Después de que se complete la actualización, para comenzar a recibir tráfico nuevamente, los consumidores de multicast deben volver a unirse a los grupos de multicast en el dominio y la zona. Si es necesario, coordínate con el administrador de la red del consumidor de multicast o los propietarios de la aplicación del consumidor de multicast.

Actualiza una activación de dominio multicast

En esta sección, se describe cómo actualizar los parámetros de una activación de dominio de multidifusión que determinan la escala de tu infraestructura de multidifusión.

Si activaste un dominio de multicast en varias zonas, sigue este procedimiento para cada activación de dominio de multicast zonal que desees actualizar.

gcloud

Para actualizar la activación de un dominio de transmisión multidifusión, usa el comando network-services multicast-domain-activations update.

El siguiente comando tarda entre 10 y 30 minutos en completarse. Después de que el comando se complete correctamente, la infraestructura puede tardar varios minutos más en estar lista para recibir y distribuir tráfico de multidifusión. En el caso de las configuraciones a gran escala, todo este proceso puede tardar entre 30 minutos y 1 hora en completarse.

Nota: Si el siguiente comando devuelve un error inesperado, como un error de tiempo de espera, vuelve a ejecutar el comando para completar la actualización.

   gcloud network-services multicast-domain-activations update DOMAIN_ACTIVATION_NAME \
      --location=ZONE \
      --aggr-egress-pps=AGGR_EGRESS_PPS \
      --aggr-ingress-pps=AGGR_INGRESS_PPS \
      --avg-packet-size=AVG_PACKET_SIZE \
      --max-per-group-ingress-pps=MAX_PER_GROUP_INGRESS_PPS \
      --max-per-group-subscribers=MAX_PER_GROUP_SUBSCRIBERS

Reemplaza los siguientes valores:

• DOMAIN_ACTIVATION_NAME: Es el nombre de la activación del dominio de transmisión por multidifusión.
• ZONE: Es la zona en la que se activó el dominio de transmisión multidifusión.

• Especifica los siguientes parámetros según tus necesidades para el tráfico de multidifusión en esta zona. Google Cloud usa estos parámetros para determinar la escala de tu infraestructura de multidifusión.

  Antes de especificar estos parámetros, consulta lo siguiente:

  • Revisa las limitaciones del tráfico de multidifusión correspondientes que se describen en la descripción general de Cloud Multicast.

  • Consulta la siguiente información sobre las marcas opcionales y obligatorias:

    • Si especificaste --aggr-egress-pps cuando creaste la activación del dominio de transmisión simultánea, especificar --aggr-egress-pps es opcional. De lo contrario, esta marca es obligatoria.
    • Todas las demás marcas son opcionales.

  Para obtener más información sobre cada marca, consulta lo siguiente:

  • AGGR_EGRESS_PPS: Paquetes de salida agregados por segundo (pps) para todos los grupos de multidifusión del dominio en la zona especificada. La salida hace referencia a los paquetes distribuidos desde la infraestructura de multicast a los consumidores de multicast.

    Puedes ingresar un valor entre 0 y 500,000,000 (500 millones). El valor predeterminado es 1,000,000 (1 millón). Los valores predeterminados para los otros campos se establecen de forma dinámica según el valor que ingreses para esta marca.

    Nota: Si no conoces tu PPS de salida agregado, puedes estimarlo con la siguiente fórmula: AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2.

  • AGGR_INGRESS_PPS: Es el PPS de ingreso agregado para todos los grupos de multidifusión del dominio en la zona especificada. La entrada hace referencia a los paquetes que se envían desde los productores de multidifusión a la infraestructura de multidifusión.

    Puedes ingresar un valor de 0 a 2,000,000 (2 millones). El valor que ingreses para --aggr-ingress-pps no puede ser mayor que el valor de --aggr-egress-pps.

  • AVG_PACKET_SIZE: Es el tamaño promedio de los paquetes en bytes. Puedes ingresar un valor entre 64 y 1,500.

  • MAX_PER_GROUP_INGRESS_PPS: Es la cantidad máxima de PPS de entrada para un solo grupo de multidifusión en el dominio de la zona especificada. Usa esta marca para especificar el grupo de transmisión por multidifusión más activo del dominio, lo que ayuda a Google Cloud determinar con mayor precisión la escala requerida de tu infraestructura de transmisión por multidifusión.

    Puedes ingresar un valor de 0 a 2,000,000 (2 millones). El valor que ingreses para --max-per-group-ingress-pps no puede ser mayor que el valor de --aggr-ingress-pps.

  • MAX_PER_GROUP_SUBSCRIBERS: Es la cantidad máxima de consumidores de multidifusión para un solo grupo de multidifusión en el dominio de la zona especificada. Usa esta marca para especificar el grupo con la mayor cantidad de consumidores de transmisión por multidifusión, lo que ayuda a Google Cloud determinar con mayor precisión la escala requerida de tu infraestructura de transmisión por multidifusión. Si se incluye esta marca, no se aplica un límite en la cantidad de consumidores de multicast para un grupo.

    Puedes ingresar un valor entre 1 y 500.

API

Para actualizar la activación de un dominio de transmisión simultánea, usa el método multicastDomainActivations.patch.

El siguiente comando tarda entre 10 y 30 minutos en completarse. Después de que el comando se complete correctamente, la infraestructura puede tardar varios minutos más en estar lista para recibir y distribuir tráfico de multidifusión. En el caso de las configuraciones a gran escala, todo este proceso puede tardar entre 30 minutos y 1 hora en completarse.

Nota: Si la siguiente solicitud devuelve un error inesperado, como un error de tiempo de espera, vuelve a realizar la solicitud para completar la actualización.

PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/multicastDomainActivations/DOMAIN_ACTIVATION_NAME?updateMask=trafficSpec

{
  "trafficSpec": {
    "aggrEgressPps": "AGGR_EGRESS_PPS",
    "aggrIngressPps": "AGGR_INGRESS_PPS",
    "avgPacketSize": "AVG_PACKET_SIZE",
    "maxPerGroupIngressPps": "MAX_PER_GROUP_INGRESS_PPS",
    "maxPerGroupSubscribers": "MAX_PER_GROUP_SUBSCRIBERS"
  }
}

Reemplaza los siguientes valores:

• PROJECT_ID: ID del proyecto de administrador de transmisión simultánea
• DOMAIN_ACTIVATION_NAME: Es el nombre de la activación del dominio de transmisión por multidifusión.
• ZONE: Es la zona en la que se activó el dominio de transmisión multidifusión.

• Especifica valores para el objeto trafficSpec según tus necesidades de tráfico de multidifusión en esta zona. Google Cloud usa estos parámetros para determinar la escala de tu infraestructura de multidifusión.

  Antes de especificar estos parámetros, consulta lo siguiente:

  • Revisa las limitaciones del tráfico de multidifusión correspondientes que se describen en la descripción general de Cloud Multicast.

  • Consulta la siguiente información sobre los campos opcionales y obligatorios:

    • Si especificaste aggrEgressPps cuando creaste la activación del dominio de transmisión simultánea, especificar aggrEgressPps es opcional. De lo contrario, este campo es obligatorio.
    • Todos los demás campos de trafficSpec son opcionales.

  Para obtener más información sobre cada campo, consulta lo siguiente:

  • AGGR_EGRESS_PPS: Paquetes de salida agregados por segundo (pps) para todos los grupos de multidifusión del dominio en la zona especificada. La salida hace referencia a los paquetes distribuidos desde la infraestructura de multicast a los consumidores de multicast.

    Puedes ingresar un valor entre 0 y 500,000,000 (500 millones). El valor predeterminado es 1,000,000 (1 millón). Los valores predeterminados para los otros campos se establecen de forma dinámica según el valor que ingreses en este campo.

    Nota: Si no conoces tu PPS de salida agregado, puedes estimarlo con la siguiente fórmula: AGGR_EGRESS_PPS = AGGR_INGRESS_PPS * MAX_PER_GROUP_SUBSCRIBERS / 2.

  • AGGR_INGRESS_PPS: Es el PPS de ingreso agregado para todos los grupos de multidifusión del dominio en la zona especificada. La entrada hace referencia a los paquetes que se envían desde los productores de multidifusión a la infraestructura de multidifusión.

    Puedes ingresar un valor de 0 a 2,000,000 (2 millones). El valor que ingreses para aggrIngressPps no puede ser mayor que el valor de aggrEgressPps.

  • AVG_PACKET_SIZE: Es el tamaño promedio de los paquetes en bytes. Puedes ingresar un valor entre 64 y 1,500.

  • MAX_PER_GROUP_INGRESS_PPS: Es la cantidad máxima de PPS de entrada para un solo grupo de multidifusión en el dominio de la zona especificada. Usa este campo para especificar el grupo de multidifusión más activo del dominio, lo que ayuda a Google Cloud a determinar con mayor precisión la escala requerida de tu infraestructura de multidifusión.

    Puedes ingresar un valor de 0 a 2,000,000 (2 millones). El valor que ingreses para maxPerGroupIngressPps no puede ser mayor que el valor de aggrIngressPps.

  • MAX_PER_GROUP_SUBSCRIBERS: Es la cantidad máxima de consumidores de multidifusión para un solo grupo de multidifusión en el dominio de la zona especificada. Usa este campo para especificar el grupo con la mayor cantidad de consumidores de multidifusión, lo que ayuda a Google Cloud a determinar con mayor precisión la escala requerida de tu infraestructura de multidifusión. Proporcionar esta especificación no impone un límite en la cantidad de consumidores de multicast para un grupo.

    Puedes ingresar un valor entre 1 y 500.