Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Controle o acesso a intervalos de grupos de multicast

Esta página descreve como controlar o acesso a intervalos de grupos de multicast.

A configuração descrita nesta página determina se um projeto de consumidor de multicast pode ativar uma rede VPC de consumidor de multicast para um intervalo de grupos.

Vista geral

Pode atualizar os projetos de consumidor de multicast que podem aceder a um intervalo de grupos de multicast da seguinte forma:

Atualize o intervalo do grupo para permitir todos os projetos.
Atualizar o intervalo do grupo para recusar todos os projetos por predefinição. Opcionalmente, pode fornecer uma lista de projetos específicos a permitir durante este procedimento.
Configure a lista de aceitação de consumidores de multicast: para intervalos de grupos que já negam todos os projetos por predefinição, pode especificar projetos a permitir.

Acerca da revogação e do restauro do acesso a intervalos de grupos

Considere o seguinte antes de atualizar o acesso a um intervalo de grupos de multicast:

Se a sua atualização revogar o acesso de um projeto de consumidor de multicast existente que tenha uma ativação de consumidor de grupo de multicast, a ativação de consumidor de grupo de multicast é desativada, mas o recurso continua a existir no projeto de consumidor de multicast com o estado INACTIVE.Google Cloud
Se conceder acesso a um projeto consumidor de multicast para o qual revogou anteriormente o acesso, o administrador de rede do consumidor de multicast tem de eliminar a respetiva ativação de consumidor de grupo existente e criar uma nova. Não é possível reutilizar recursos INACTIVE existentes.

Atualize o intervalo do grupo para permitir todos os projetos

Esta secção descreve como atualizar um intervalo de grupos de multicast para permitir todos os projetos.

Após concluir este procedimento, qualquer projeto que tenha acesso ao domínio pode usar este intervalo de grupos.

gcloud

Para atualizar um intervalo de grupos de multicast para permitir todos os projetos, use o comando network-services multicast-group-ranges update e especifique as seguintes flags:

--no-require-explicit-accept
Se a lista de aceitação de consumidores de multicast não estiver vazia, também tem de especificar a flag --clear-consumer-accept-list.

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

Substitua GROUP_RANGE_NAME pelo nome do intervalo do grupo de multicast.

API

Para atualizar um intervalo de grupos de multicast para permitir todos os projetos, use o método multicastGroupRanges.patch.

Defina o campo requireExplicitAccept como false. Se a lista de aceitação de consumidores não estiver vazia, também tem de limpar o campo consumerAcceptList definindo o respetivo valor como [].

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

Substitua os seguintes valores:

PROJECT_ID: o ID do projeto do administrador de multicast
GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast

Atualize o intervalo do grupo para recusar todos os projetos por predefinição

Esta secção descreve como atualizar um intervalo de grupos de multicast para negar todos os projetos por predefinição.

No procedimento seguinte, pode fornecer opcionalmente uma lista de projetos específicos que podem aceder ao intervalo de grupos de multicast. Em alternativa, pode especificar projetos para permitir mais tarde, conforme descrito em Configure a lista de aceitação de consumidores de multicast.

gcloud

Para atualizar um intervalo de grupos de multicast para recusar todos os projetos por predefinição, use o 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]

Substitua os seguintes valores:

GROUP_RANGE_NAME: o nome do intervalo de grupos de multicast.
LIST_OF_CONSUMERS: uma lista de projetos de consumidor que podem usar este intervalo de grupos de multicast. Pode especificar até 100 projetos pelo respetivo ID ou nome.

Se um projeto consumidor de multicast existente estiver a usar o intervalo de grupos de multicast e quiser que continue a ter acesso, especifique o projeto na lista. Caso contrário, Google Cloud desativa todas as ativações de consumidor do grupo de multicast existentes para o intervalo de grupos. Se um projeto for adicionado novamente à lista de aceitação de consumidores mais tarde, o administrador da rede de consumidores de multicast tem de criar novas ativações de consumidores de grupos.

Opcionalmente, pode omitir esta flag e especificar projetos a permitir mais tarde, conforme descrito em Configure a lista de aceitação de consumidores.

API

Para atualizar um intervalo de grupos de multicast para recusar todos os projetos por predefinição, use o método multicastGroupRanges.patch.

Defina o campo requireExplicitAccept como true. Opcionalmente, pode definir o 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]
  }

Substitua os seguintes valores:

PROJECT_ID: o ID do projeto do administrador de multicast
GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast
LIST_OF_CONSUMERS: uma lista de projetos de consumidor que podem usar este intervalo de grupos de multicast. Use o seguinte formato: "project-1", "project-2". Pode especificar até 100 projetos pelo respetivo ID ou nome.

Se um projeto consumidor de multicast existente estiver a usar o intervalo de grupos de multicast e quiser que continue a ter acesso, especifique o projeto na lista. Caso contrário, Google Cloud desativa todas as ativações de consumidor do grupo de multicast existentes para o intervalo de grupos. Se um projeto for adicionado novamente à lista de aceitação de consumidores mais tarde, o administrador da rede de consumidores de multicast tem de criar novas ativações de consumidores de grupos.

Opcionalmente, pode omitir consumerAcceptList do corpo do pedido e da máscara de atualização, e especificar projetos a permitir posteriormente, conforme descrito em Configure a lista de aceitação de consumidores.

Configure a lista de aceitação de consumidores de multicast

Esta secção descreve como configurar a lista de aceitação de consumidores de multicast para um intervalo de grupos de multicast.

Se o intervalo do grupo de multicast recusar todos os projetos por predefinição, pode configurar a lista de aceitação do consumidor da seguinte forma:

Defina uma nova lista de aceitação
Adicione um projeto à lista de aceitação
Remova um projeto da lista de aceitação
Limpe a lista de aceitação

Defina uma nova lista de aceitação

Esta secção descreve como definir uma nova lista de aceitação de consumidores de multicast para um intervalo de grupos de multicast.

Siga os passos nesta secção se estiver a configurar a lista de aceitação de consumidores de multicast pela primeira vez ou se quiser substituir a lista de aceitação de consumidores existente. Se quiser manter a lista existente e adicionar ou remover um projeto consumidor de multicast, consulte os artigos Adicione um projeto à lista de aceitação ou Remova um projeto da lista de aceitação.

gcloud

Para definir a lista de aceitação para um intervalo de grupos de multicast, use o 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

Substitua os seguintes valores:

GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast
LIST_OF_CONSUMERS: um ou mais projetos de consumidor que podem usar este intervalo de grupos de multicast. Pode especificar até 100 projetos pelo respetivo ID ou nome.

API

Para definir a lista de aceitação de um intervalo de grupos de multicast, use o 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]
  }

Substitua os seguintes valores:

PROJECT_ID: o ID do projeto do administrador de multicast
GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast
LIST_OF_CONSUMERS: um ou mais projetos de consumidor que podem usar este intervalo de grupos de multicast. Use o seguinte formato: "project-1", "project-2". Pode especificar até 100 projetos pelo respetivo ID ou nome.

Adicione um projeto à lista de aceitação

Esta secção descreve como adicionar um projeto consumidor de multicast à lista de aceitação para um intervalo de grupos de multicast.

gcloud

Para adicionar um projeto do consumidor de multicast à lista de aceitação, use o 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

Substitua os seguintes valores:

GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast
LIST_OF_CONSUMERS: um ou mais projetos de consumidor de multicast a adicionar à lista de aceitação para que possam usar este intervalo de grupos de multicast.

API

Para adicionar um projeto de consumidor de multicast à lista de aceitação, obtenha a lista de aceitação atual e, em seguida, faça um pedido de API para atualizar a lista:

Para obter a lista de aceitação atual do intervalo de grupos, siga as instruções em Ver intervalos de grupos de multicast. Copie a lista de aceitação para a poder usar no passo seguinte.
Para atualizar a lista de aceitação, use o 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]
}
```
Substitua os seguintes valores:
- PROJECT_ID: o ID do projeto do administrador de multicast
- GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast
- UPDATED_LIST_OF_CONSUMERS: a lista atualizada de projetos que inclui os projetos existentes a manter e quaisquer novos projetos a adicionar. Use o seguinte formato: "project-1", "project-2". A API substitui toda a lista de aceitação de consumidores pela lista que fornece.

Remova um projeto da lista de aceitação

Esta secção descreve como remover um projeto consumidor de multicast da lista de aceitação para um intervalo de grupos de multicast.

gcloud

Para remover um projeto consumidor de multicast da lista de aceitação, use o 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

Substitua os seguintes valores:

GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast
LIST_OF_CONSUMERS: um ou mais projetos de consumidor de multicast a remover da lista de aceitação de consumidores para que não possam usar este intervalo de grupos de multicast.

API

Para remover um projeto consumidor de multicast da lista de aceitação, obtenha a lista de aceitação atual e, em seguida, faça um pedido de API para atualizar a lista:

Para obter a lista de aceitação atual do intervalo de grupos, siga as instruções em Ver intervalos de grupos de multicast. Copie a lista de aceitação para a poder usar no passo seguinte.
Para atualizar a lista de aceitação, use o 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]
}
```
Substitua os seguintes valores:
- PROJECT_ID: o ID do projeto do administrador de multicast
- GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast
- UPDATED_LIST_OF_CONSUMERS: a lista atualizada de projetos que inclui os projetos existentes a manter e exclui todos os projetos que quer remover. Use o seguinte formato: "project-1", "project-2". A API substitui toda a lista de aceitação de consumidores pela lista que fornecer.

Limpe a lista de aceitação

Esta secção descreve como limpar a lista de aceitação de um intervalo de grupos de multicast.

gcloud

Para limpar a lista de aceitação de consumidores para um intervalo de grupos de multicast, use o comando network-services multicast-group-ranges update.

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

Substitua GROUP_RANGE_NAME pelo nome do intervalo de grupos de multicast.

API

Para limpar a lista de aceitação de consumidores para um intervalo de grupos de multicast, use o método multicastGroupRanges.patch.

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

Substitua os seguintes valores:

PROJECT_ID: o ID do projeto do administrador de multicast
GROUP_RANGE_NAME: o nome do intervalo do grupo de multicast