メソッド: services.addSubnetwork

サービス プロデューサーの場合、ピアリングされたサービスの共有 VPC ネットワークの新しいサブネットを、リクエストされたリージョンに、リクエストされた CIDR 範囲(IPv4 ネットワーク マスクの先頭からのビット数)のサイズでプロビジョニングします。このメソッドは、提供された割り当て範囲と照合して競合しない IP アドレス範囲を検索します。後続の呼び出しに同じサブネット名、リージョン、接頭辞長が含まれる場合、このメソッドはサブネットを再利用します。このメソッドを実行すると、プロデューサーのテナント プロジェクトが必要に応じて共有 VPC サービス プロジェクトになります。オペレーションが正常に完了した場合、get オペレーションからのレスポンスのタイプは Subnetwork になります。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。サービス プロデューサー組織内のテナント プロジェクト。形式は services/{service}/{collection-id}/{resource-id} です。{collection-id} は、テナント プロジェクトを表すクラウド リソース コレクションのタイプです。projects のみがサポートされています。{resource-id} はテナント プロジェクトの数値 ID です(例: 123456)。{service} はピアリング サービスの名前です(例: service-peering.example.com)。このサービスは、サービス ユーザーのプロジェクトですでに有効になっている必要があります。

承認には、指定したリソースの parent に対する次の Google IAM 権限が必要です。

  • servicenetworking.services.addSubnetwork

リクエストの本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現

{
  "consumerNetwork": string,
  "subnetwork": string,
  "region": string,
  "ipPrefixLength": number,
  "description": string,
  "subnetworkUsers": [
    string
  ],
  "consumer": string,
  "requestedAddress": string
}
フィールド
consumerNetwork

string

必須。サービス ユーザーの VPC ネットワークの名前。このネットワークは、connections.create メソッドによってプロビジョニングされたプライベート接続をすでに持っている必要があります。形式は projects/{project}/global/networks/{network} にする必要があります。{project} はプロジェクト番号(例: 12345)を表し、{network} はそのプロジェクト内の VPC ネットワークの名前を表します。

subnetwork

string

必須。新しいサブネットの名前。命名要件については、Compute API ドキュメントの subnetwork をご覧ください。

region

string

必須。サブネットのリージョンの名前(例: europe-west1)。

ipPrefixLength

number

必須。サブネットの IP アドレス範囲の接頭辞長。CIDR 範囲表記を使用します。たとえば 30 を指定すると、x.x.x.x/30 CIDR 範囲を持つサブネットがプロビジョニングされます。IP アドレス範囲は、サービス ユーザーによって指定された割り当て範囲内の使用可能な範囲のプールから取得されます。

description

string

サブネットの説明(省略可)。

subnetworkUsers[]

string

サブネットに対する compute.networkUser 役割を付与するメンバーのリスト。

consumer

string

必須。サービス ユーザーを表すリソース(例: projects/123456)。このプロジェクト番号は、consumerNetwork パラメータの値とは異なる場合があります。たとえば、ネットワークが共有 VPC ネットワークの一部である場合があります。そのような場合、Service Networking はこのリソースがその共有 VPC に属していることを検証します。

requestedAddress

string

省略可。範囲の開始アドレス。x.x.x.x 形式の有効な IPv4 アドレスを指定する必要があります。この値と IP 接頭辞範囲を組み合わせたものがサブネットの CIDR 範囲です。範囲は、プライベート接続に対応付けられている割り当て範囲内にある必要があります。CIDR 範囲が使用できない場合、呼び出しは失敗します。

レスポンスの本文

成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

承認スコープ

次の OAuth スコープのいずれかが必要です。

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

詳細については、認証の概要をご覧ください。

今すぐ試す