Controlar el acceso a intervalos de grupos de multidifusión

En esta página se describe cómo controlar el acceso a los intervalos de grupos de multidifusión.

La configuración descrita en esta página determina si un proyecto consumidor de multicast puede activar una red VPC de consumidor de multicast para un intervalo de grupos.

Información general

Para actualizar los proyectos de consumidor de multidifusión que pueden acceder a un intervalo de grupos de multidifusión, sigue estos pasos:

Acerca de la revocación y la restauración del acceso a intervalos de grupos

Ten en cuenta lo siguiente antes de actualizar el acceso a un intervalo de grupos de multidifusión:

  • Si la actualización revoca el acceso de un proyecto consumidor de multidifusión que tiene una activación de consumidor de grupo de multidifusión, seGoogle Cloud desactiva la activación de consumidor de grupo de multidifusión, pero el recurso sigue existiendo en el proyecto consumidor de multidifusión con el estado INACTIVE.
  • Si das acceso a un proyecto consumidor de multidifusión al que le habías revocado el acceso anteriormente, el administrador de la red del consumidor de multidifusión debe eliminar la activación del consumidor del grupo que ya tenga y crear una nueva. Los recursos de INACTIVE no se pueden reutilizar.

Actualiza el intervalo del grupo para permitir todos los proyectos

En esta sección se describe cómo actualizar un intervalo de grupos de multidifusión para permitir todos los proyectos.

Después de completar este procedimiento, cualquier proyecto que tenga acceso al dominio podrá usar este intervalo de grupos.

gcloud

Para actualizar un intervalo de grupos de multidifusión para permitir todos los proyectos, usa el comando network-services multicast-group-ranges update y especifica las siguientes marcas:

  • --no-require-explicit-accept
  • Si la lista de consumidores de multidifusión no está vacía, también debes especificar la marca --clear-consumer-accept-list.
  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --no-require-explicit-accept \
      --clear-consumer-accept-list

Sustituye GROUP_RANGE_NAME por el nombre del intervalo de grupos de multidifusión.

API

Para actualizar un intervalo de grupos de multidifusión para permitir todos los proyectos, usa el método multicastGroupRanges.patch.

Asigna el valor false al campo requireExplicitAccept. Si la lista de aceptación del consumidor no está vacía, también debes borrar el campo consumerAcceptList asignándole el valor [].

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=requireExplicitAccept,consumerAcceptList
  {
    "requireExplicitAccept": "false",
    "consumerAcceptList": []
  }

Sustituye los siguientes valores:

  • PROJECT_ID: el ID del proyecto de administrador de multidifusión
  • GROUP_RANGE_NAME: el nombre del intervalo de grupos de multidifusión

Actualiza el intervalo del grupo para denegar todos los proyectos de forma predeterminada.

En esta sección se describe cómo actualizar un intervalo de grupos de multidifusión para denegar todos los proyectos de forma predeterminada.

En el siguiente procedimiento, puedes proporcionar una lista de proyectos específicos que puedan acceder al intervalo de grupos de multidifusión. También puedes especificar los proyectos que quieres permitir más adelante, tal como se describe en Configurar la lista de aceptación de consumidores de multidifusión.

gcloud

Para actualizar un intervalo de grupos de multidifusión y denegar todos los proyectos de forma predeterminada, usa el comando network-services multicast-group-ranges update.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --require-explicit-accept \
      [--consumer-accept-list=LIST_OF_CONSUMERS]

Sustituye los siguientes valores:

  • GROUP_RANGE_NAME: el nombre del intervalo de grupos de multidifusión.

  • LIST_OF_CONSUMERS: lista de proyectos de consumidor que pueden usar este intervalo de grupos de multidifusión. Puedes especificar hasta 100 proyectos por su ID o nombre.

    Si un proyecto de consumidor de multidifusión ya está usando el intervalo de grupos de multidifusión y quieres que siga teniendo acceso, especifica el proyecto en la lista. De lo contrario, Google Cloud desactiva todas las activaciones de consumidores de grupos de multidifusión del intervalo de grupos. Si un proyecto se vuelve a añadir a la lista de aceptación del consumidor más adelante, el administrador de la red de consumidores de multidifusión debe crear nuevas activaciones de consumidores de grupos.

    También puedes omitir esta marca y especificar los proyectos que quieras permitir más adelante, tal como se describe en Configurar la lista de elementos aceptados del consumidor.

API

Para actualizar un intervalo de grupos de multidifusión y denegar todos los proyectos de forma predeterminada, usa el método multicastGroupRanges.patch.

Asigna el valor true al campo requireExplicitAccept. También puedes definir el campo consumerAcceptList.

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=requireExplicitAccept,consumerAcceptList
  {
    "requireExplicitAccept": "true",
    "consumerAcceptList": [LIST_OF_CONSUMERS]
  }

Sustituye los siguientes valores:

  • PROJECT_ID: el ID del proyecto de administrador de multidifusión
  • GROUP_RANGE_NAME: el nombre del intervalo de grupos de multidifusión

  • LIST_OF_CONSUMERS: lista de proyectos de consumidor que pueden usar este intervalo de grupos de multidifusión. Utiliza el siguiente formato: "project-1", "project-2". Puedes especificar hasta 100 proyectos por su ID o nombre.

    Si un proyecto de consumidor de multidifusión ya está usando el intervalo de grupos de multidifusión y quieres que siga teniendo acceso, especifica el proyecto en la lista. De lo contrario, Google Cloud desactiva todas las activaciones de consumidores de grupos de multidifusión del intervalo de grupos. Si un proyecto se vuelve a añadir a la lista de aceptación del consumidor más adelante, el administrador de la red de consumidores de multidifusión debe crear nuevas activaciones de consumidores de grupos.

    También puede omitir consumerAcceptList del cuerpo de la solicitud y de la máscara de actualización, y especificar los proyectos que se permitirán más adelante, tal como se describe en Configurar la lista de aceptación de consumidores.

Configurar la lista de aceptación de consumidores de multidifusión

En esta sección se describe cómo configurar la lista de aceptación de consumidores de multidifusión para un intervalo de grupos de multidifusión.

Si el intervalo de grupos de multidifusión deniega todos los proyectos de forma predeterminada, puede configurar la lista de aceptados del consumidor de la siguiente manera:

Definir una nueva lista de aceptación

En esta sección se describe cómo definir una nueva lista de aceptación de consumidores de multidifusión para un intervalo de grupos de multidifusión.

Sigue los pasos de esta sección si vas a configurar la lista de aceptación de consumidores de multidifusión por primera vez o si quieres sustituir la lista de aceptación de consumidores actual. Si quieres conservar la lista y añadir o quitar un proyecto consumidor de multidifusión, consulta Añadir un proyecto a la lista de aceptación o Quitar un proyecto de la lista de aceptación.

gcloud

Para definir la lista de aceptación de un intervalo de grupos de multidifusión, usa el comando network-services multicast-group-ranges update.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --consumer-accept-list=LIST_OF_CONSUMERS

Sustituye los siguientes valores:

  • GROUP_RANGE_NAME: el nombre del grupo de multidifusión range
  • LIST_OF_CONSUMERS: uno o varios proyectos de consumidor que pueden usar este intervalo de grupos de multidifusión. Puedes especificar hasta 100 proyectos por su ID o nombre.

API

Para definir la lista de aceptación de un intervalo de grupos de multidifusión, usa el método multicastGroupRanges.patch.

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=consumerAcceptList
  {
    "consumerAcceptList": [LIST_OF_CONSUMERS]
  }

Sustituye los siguientes valores:

  • PROJECT_ID: el ID del proyecto de administrador de multidifusión
  • GROUP_RANGE_NAME: el nombre del grupo de multidifusión range
  • LIST_OF_CONSUMERS: uno o varios proyectos de consumidor que pueden usar este intervalo de grupos de multidifusión. Utiliza el siguiente formato: "project-1", "project-2". Puedes especificar hasta 100 proyectos por su ID o nombre.

Añadir un proyecto a la lista de aceptados

En esta sección se describe cómo añadir un proyecto de consumidor de multidifusión a la lista de elementos permitidos de un intervalo de grupos de multidifusión.

gcloud

Para añadir un proyecto de consumidor de multidifusión a la lista de aceptación, usa el comando network-services multicast-group-ranges update.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --add-consumer-accept-list=LIST_OF_CONSUMERS

Sustituye los siguientes valores:

  • GROUP_RANGE_NAME: el nombre del grupo de multidifusión range
  • LIST_OF_CONSUMERS: uno o varios proyectos de consumidor de multidifusión que se añadirán a la lista de aceptación para que puedan usar este intervalo de grupos de multidifusión.

API

Para añadir un proyecto de consumidor de multidifusión a la lista de aceptados, obtén la lista actual y, a continuación, haz una solicitud de API para actualizarla:

  1. Para obtener la lista de aceptación actual del intervalo de grupos, sigue las instrucciones que se indican en Ver intervalos de grupos de multidifusión. Copia la lista de elementos aceptados para usarla en el siguiente paso.

  2. Para actualizar la lista de aceptación, usa el método multicastGroupRanges.patch.

    PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=consumerAcceptList
{
  "consumerAcceptList": [UPDATED_LIST_OF_CONSUMERS]
}

    Sustituye los siguientes valores:

    • PROJECT_ID: el ID del proyecto de administrador de multidifusión
    • GROUP_RANGE_NAME: el nombre del grupo de multidifusión range
    • UPDATED_LIST_OF_CONSUMERS: la lista de proyectos actualizada que incluye los proyectos que se van a conservar y los nuevos proyectos que se van a añadir. Utiliza el siguiente formato: "project-1", "project-2". La API sustituye toda la lista de aceptación de consumidores por la lista que proporciones.

Quitar un proyecto de la lista de aceptados

En esta sección se describe cómo quitar un proyecto consumidor de multidifusión de la lista de aceptación de un intervalo de grupos de multidifusión.

gcloud

Para quitar un proyecto de consumidor de multidifusión de la lista de aceptados, usa el comando network-services multicast-group-ranges update.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --remove-consumer-accept-list=LIST_OF_CONSUMERS

Sustituye los siguientes valores:

  • GROUP_RANGE_NAME: el nombre del grupo de multidifusión range
  • LIST_OF_CONSUMERS: uno o varios proyectos de consumidor de multidifusión que se van a quitar de la lista de aceptación de consumidores para que no puedan usar este intervalo de grupos de multidifusión.

API

Para quitar un proyecto consumidor de multidifusión de la lista de aceptados, obtén la lista actual y, a continuación, haz una solicitud a la API para actualizarla:

  1. Para obtener la lista de aceptación actual del intervalo de grupos, sigue las instrucciones que se indican en Ver intervalos de grupos de multidifusión. Copia la lista de elementos aceptados para usarla en el siguiente paso.

  2. Para actualizar la lista de aceptación, usa el método multicastGroupRanges.patch.

    PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=consumerAcceptList
{
  "consumerAcceptList": [UPDATED_LIST_OF_CONSUMERS]
}

    Sustituye los siguientes valores:

    • PROJECT_ID: el ID del proyecto de administrador de multidifusión
    • GROUP_RANGE_NAME: el nombre del grupo de multidifusión range
    • UPDATED_LIST_OF_CONSUMERS: la lista de proyectos actualizada que incluye los proyectos que quieres conservar y excluye los que quieres quitar. Utiliza el siguiente formato: "project-1", "project-2". La API sustituye toda la lista de aceptación del consumidor por la lista que proporciones.

Borrar la lista de aceptados

En esta sección se describe cómo borrar la lista de aceptación de un intervalo de grupos de multidifusión.

gcloud

Para borrar la lista de aceptación de consumidores de un intervalo de grupos de multidifusión, usa el comando network-services multicast-group-ranges update.

  gcloud network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      --clear-consumer-accept-list

Sustituye GROUP_RANGE_NAME por el nombre del intervalo de grupos de multidifusión.

API

Para borrar la lista de aceptación de consumidores de un intervalo de grupos de multidifusión, usa el método multicastGroupRanges.patch.

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/global/multicastGroupRanges/GROUP_RANGE_NAME?updateMask=consumerAcceptList
  {
    "consumerAcceptList": []
  }

Sustituye los siguientes valores:

  • PROJECT_ID: el ID del proyecto de administrador de multidifusión
  • GROUP_RANGE_NAME: el nombre del intervalo de grupos de multidifusión