Actualiza los parámetros del dominio de transmisión por multidifusión

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

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

Antes de comenzar

Antes de actualizar los parámetros del dominio de multidifusión, revisa lo siguiente y planifica tu 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 proporciones.

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

  • La duración de la interrupción del servicio depende de varios factores, como la escala de tu infraestructura de transmisión por multidifusión actual, la cantidad de activaciones de rangos de grupos de transmisión por multidifusión creadas con la activación del dominio y la escala de los nuevos parámetros que proporciones. 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 transmisión por multidifusión 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 transmisiones simultáneas después de la actualización: Una vez que se complete la actualización, para volver a recibir tráfico, los consumidores de transmisiones simultáneas deben volver a unirse a los grupos de transmisiones simultáneas 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 la activación de un 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 transmisión por multidifusión en varias zonas, sigue este procedimiento para cada activación de dominio de transmisión por multidifusión 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 correspondientes para el tráfico de multidifusión que se describen en la descripción general de la multidifusión.

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

    • Si especificaste --aggr-egress-pps anteriormente cuando creaste la activación del dominio de transmisión multidifusión, 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 de 0 a 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 los PPS de salida agregados, puedes estimarlos 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 ingresas para --aggr-ingress-pps no puede ser mayor que el valor de --aggr-egress-pps.

  • AVG_PACKET_SIZE: Es el tamaño promedio del paquete 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 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 --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 receptores 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 multidifusión, lo que ayuda a Google Cloud determinar con mayor precisión la escala requerida de tu infraestructura de 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 multidifusión, 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 el 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 del 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 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 correspondientes para el tráfico de multidifusión que se describen en la descripción general de la multidifusión.

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

    • Si especificaste aggrEgressPps anteriormente cuando creaste la activación del dominio de multidifusión, 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 de 0 a 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 los PPS de salida agregados, puedes estimarlos 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 del paquete 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 receptores 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 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.