Méthode : services.addSubnetwork

Pour les producteurs de services, provisionne un nouveau sous-réseau dans le réseau VPC partagé d'un service d'appairage dans la région demandée et avec la taille demandée, exprimée sous la forme d'une plage CIDR (nombre de bits de début du masque de réseau IPv4). La méthode vérifie les plages allouées qui sont attribuées pour rechercher une plage d'adresses IP non contradictoire. Elle réutilise un sous-réseau si les appels ultérieurs contiennent la même longueur de préfixe, la même région et le même nom de sous-réseau. Grâce à cette méthode, le projet locataire du producteur sera un projet de service VPC partagé, selon les besoins. La réponse de l'opération get est de type Subnetwork si l'opération se termine avec succès.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Projet locataire de l'organisation du producteur de services, au format suivant : services/{service}/{collection-id}/{resource-id}. {collection-id} correspond au type de collection de ressources cloud qui représente le projet locataire. Seuls les éléments projects sont acceptés. {resource-id} correspond à l'ID numérique du projet locataire, tel que 123456. {service} correspond au nom du service d'appairage, tel que service-peering.example.com. Ce service doit déjà être activé dans le projet du client de services.

L'autorisation Google IAM suivante est requise pour la ressource parent indiquée :

  • servicenetworking.services.addSubnetwork

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON

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

string

Obligatoire. Nom du réseau VPC du client de services. Le réseau doit disposer d'une connexion privée existante qui a été provisionnée via la méthode connections.create. Le nom doit être au format suivant : projects/{project}/global/networks/{network}, où {project} correspond à un numéro de projet, tel que 12345. {network} correspond au nom d'un réseau VPC du projet.

subnetwork

string

Obligatoire. Nom du nouveau sous-réseau. Pour en savoir plus sur les règles de dénomination, consultez la page consacrée à la ressource subnetwork dans la documentation de l'API Compute.

region

string

Obligatoire. Nom d'une région pour le sous-réseau, telle que europe-west1.

ipPrefixLength

number

Obligatoire. Longueur de préfixe de la plage d'adresses IP du sous-réseau. Utilisez la notation de plage CIDR, telle que 30 pour provisionner un sous-réseau avec une plage CIDR x.x.x.x/30. La plage d'adresses IP est tirée d'un groupe de plages disponibles dans la plage allouée du client de services.

description

string

Description facultative du sous-réseau.

subnetworkUsers[]

string

Liste des membres auxquels le rôle compute.networkUser est attribué sur le sous-réseau.

consumer

string

Obligatoire. Ressource représentant le client de services, telle que projects/123456. Le numéro de projet peut être différent de la valeur indiquée dans le paramètre de réseau du client. Par exemple, le réseau peut faire partie d'un réseau VPC partagé. Dans ce cas, Service Networking vérifie que cette ressource appartient à ce réseau VPC partagé.

requestedAddress

string

Facultatif. Adresse de départ d'une plage. Elle doit être une adresse IPv4 valide au format x.x.x.x. Cette valeur, associée à la plage de préfixes IP, correspond à la plage CIDR du sous-réseau. La plage doit être comprise dans la plage allouée qui est attribuée à la connexion privée. Si la plage CIDR n'est pas disponible, l'appel échoue.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, reportez-vous à la section Présentation de l'authentification.

Essayer