Method: projects.locations.addressGroups.create

Cria um novo grupo de endereços em um determinado projeto e local.

Solicitação HTTP

POST https://networksecurity.googleapis.com/v1beta1/{parent=projects/*/locations/*}/addressGroups

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O recurso pai do AddressGroup. Precisa estar no formato projects/*/locations/{location}.

A autorização requer a seguinte permissão do IAM no recurso especificado parent:

  • networksecurity.addressGroups.create

Parâmetros de consulta

Parâmetros
addressGroupId

string

Obrigatório. Nome curto do recurso AddressGroup a ser criado. Esse valor precisa ter de 1 a 63 caracteres, contendo apenas letras, números, hifens e sublinhados, e não pode começar com um número. Por exemplo, "authzPolicy".

A autorização requer a seguinte permissão do IAM no recurso especificado addressGroupId:

  • networksecurity.addressGroups.create
requestId

string

Opcional. Um ID de solicitação opcional para identificar solicitações. Especifique um ID de solicitação exclusivo para que, se você precisar repetir sua solicitação, o servidor saberá que a solicitação deve ser ignorada se ela já tiver sido concluída. O servidor vai garantir isso por pelo menos 60 minutos desde a primeira solicitação.

Por exemplo, considere uma situação em que você faz uma solicitação inicial e ela expira. Se você fizer a solicitação novamente com o mesmo ID, o servidor poderá verificar se a operação original com o mesmo ID foi recebida e, em caso afirmativo, vai ignorar a segunda solicitação. Isso evita que os clientes criem compromissos duplicados acidentalmente.

O ID da solicitação precisa ser um UUID válido, com exceção de que o UUID zero não é aceito (00000000-0000-0000-0000-000000000000).

Corpo da solicitação

O corpo da solicitação contém uma instância de AddressGroup.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Operation.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Para saber mais, consulte a Visão geral da autenticação.