Método: services.addSubnetwork

Para produtores de serviços, provisiona uma nova sub-rede na rede VPC compartilhada de um serviço com peering na região solicitada e com o tamanho solicitado expresso como um intervalo CIDR (número de bits principais da máscara de rede ipv4). O método verifica os intervalos alocados atribuídos para localizar um intervalo de endereços IP não conflitantes. O método reutilizará uma sub-rede se as chamadas subsequentes contiverem nome de sub-rede, região e tamanho de prefixo iguais. Esse método fará com que o projeto de locatário do produtor seja um projeto de serviço VPC compartilhado, se necessário. A resposta da operação get será do tipo Subnetwork se a operação for concluída com êxito.

Solicitação HTTP

POST https://servicenetworking.googleapis.com/v1/{parent=services/*/*/*}:addSubnetwork

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

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. Um projeto de locatário na organização do produtor de serviço, no seguinte formato: services/{service}/{collection-id}/{resource-id}. {collection-id} é o tipo de coleção de recursos da nuvem que representa o projeto de locatário. Só há suporte para projects. {resource-id} é o código numérico do projeto de locatário, como 123456. {service} é o nome do serviço de peering, como service-peering.example.com. É necessário que esse serviço já esteja ativado no projeto do consumidor de serviço.

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

  • servicenetworking.services.addSubnetwork

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 

{
  "consumerNetwork": string,
  "subnetwork": string,
  "region": string,
  "ipPrefixLength": number,
  "description": string,
  "subnetworkUsers": [
    string
  ],
  "consumer": string,
  "requestedAddress": string
}
Campos
consumerNetwork

string

Obrigatório. O nome da rede VPC do consumidor de serviço. É necessário que a rede já tenha uma conexão particular provisionada por meio do método connections.create. O nome precisa estar neste formato: projects/{project}/global/networks/{network}, em que {project} é um número de projeto, como 12345, e {network} é o nome de uma rede VPC no projeto.

subnetwork

string

Obrigatório. Um nome para a nova sub-rede. Veja informações sobre os requisitos de nomenclatura em sub-rede, na documentação da API Compute.

region

string

Obrigatório. O nome de uma região para a sub-rede, como europe-west1.

ipPrefixLength

number

Obrigatório. O tamanho do prefixo do intervalo de endereços IP da sub-rede. Use a notação do intervalo CIDR, como 30, para provisionar uma sub-rede com um intervalo CIDR x.x.x.x/30. O intervalo de endereços IP é extraído de um conjunto de intervalos disponíveis no intervalo alocado do consumidor de serviço.

description

string

Uma descrição opcional da sub-rede.

subnetworkUsers[]

string

Uma lista de membros que recebem o papel compute.networkUser na sub-rede.

consumer

string

Obrigatório. Um recurso que representa o consumidor de serviço, como projects/123456. O número do projeto pode ser diferente do valor no parâmetro de rede do consumidor. Por exemplo, a rede pode fazer parte de uma rede VPC compartilhada. Nesses casos, o Service Networking confirma que esse recurso pertence a essa VPC compartilhada.

requestedAddress

string

Opcional. O endereço inicial de um intervalo. O endereço precisa ser um endereço IPv4 válido no formato x.x.x.x. Esse valor combinado com o intervalo de prefixos IP compõe o intervalo CIDR da sub-rede. É necessário que o intervalo esteja dentro do intervalo alocado atribuído à conexão particular. Se o intervalo CIDR não estiver disponível, a chamada falhará.

Corpo da resposta

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

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte a Visão geral da autenticação.

Faça um teste!