REST Resource: organizations.locations.firewallEndpoints

リソース: FirewallEndpoint

Endpoint オブジェクトを説明するメッセージ

JSON 表現
{
  "name": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "state": enum (State),
  "reconciling": boolean,
  "associatedNetworks": [
    string
  ],
  "associations": [
    {
      object (AssociationReference)
    }
  ],
  "billingProjectId": string,
  "type": enum (Type),

  // Union field settings can be only one of the following:
  "firstPartyEndpointSettings": {
    object (FirstPartyEndpointSettings)
  },
  "thirdPartyEndpointSettings": {
    object (ThirdPartyEndpointSettings)
  }
  // End of list of possible types for union field settings.
}
フィールド
name

string

変更不可。ID。リソースの名前

description

string

省略可。ファイアウォール エンドポイントの説明。最大文字数は 2,048 文字です。

createTime

string (Timestamp format)

出力専用。タイムスタンプの作成

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

updateTime

string (Timestamp format)

出力専用。タイムスタンプの更新

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒まで、小数点以下は最大 9 桁。例: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z"

labels

map (key: string, value: string)

省略可。ラベルを Key-Value ペアとして使用

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }

state

enum (State)

出力専用。エンドポイントの現在の状態。

reconciling

boolean

出力専用。調整が進行中かどうかについては、https://google.aip.dev/128 を参照することをおすすめします。

associatedNetworks[]
(deprecated)

string

出力専用。ローカル ゾーンでこのエンドポイントに関連付けられているネットワークのリスト。これは、このエンドポイントを指す FirewallEndpointAssociations のプロジェクションです。トラフィック ルーティングが完全に構成されると、このリストにネットワークが表示されます。形式: projects/{project}/global/networks/{name}

associations[]

object (AssociationReference)

出力専用。このエンドポイントに関連付けられている FirewallEndpointAssociations のリスト。関連付けは、トラフィック ルーティングが完全に構成されてからのみ、このリストに表示されます。

billingProjectId

string

必須。エンドポイントの稼働時間の使用量に請求されるプロジェクト。

type

enum (Type)

省略可。エンドポイントのタイプ

共用体フィールド settings。エンドポイント タイプに固有の設定。settings は次のいずれかになります。
firstPartyEndpointSettings

object (FirstPartyEndpointSettings)

省略可。ファースト パーティのファイアウォール エンドポイントのファイアウォール エンドポイント設定。

thirdPartyEndpointSettings

object (ThirdPartyEndpointSettings)

省略可。サードパーティのファイアウォール エンドポイントのファイアウォール エンドポイントの設定。

FirstPartyEndpointSettings

この型にはフィールドがありません。

次の ID: 1

ThirdPartyEndpointSettings

次の ID: 2

JSON 表現
{
  "targetFirewallAttachment": string
}
フィールド
targetFirewallAttachment

string

省略可。ターゲット ファイアウォール アタッチメントの URL。

状態

エンドポイントの状態。

列挙型
STATE_UNSPECIFIED 未設定。
CREATING 作成中
ACTIVE 構成の更新を処理する。
DELETING 削除中
INACTIVE 停止またはエラー状態である。

AssociationReference

これは FirewallEndpointAssociation メッセージのサブセットであり、コンシューマが使用するフィールドが含まれています。

JSON 表現
{
  "name": string,
  "network": string
}
フィールド
name

string

出力専用。FirewallEndpointAssociation のリソース名。形式: projects/{project}/locations/{location}/firewallEndpointAssociations/{id}

network

string

出力専用。関連付けられた VPC ネットワーク。形式: projects/{project}/global/networks/{name}

タイプ

ファイアウォール エンドポイントのタイプ。

列挙型
TYPE_UNSPECIFIED 未設定。
FIRST_PARTY 自社のファイアウォール エンドポイント。
THIRD_PARTY サードパーティのファイアウォール エンドポイント。

メソッド

create

指定されたプロジェクトとロケーションで新しい FirewallEndpoint を作成します。

delete

1 つのエンドポイントを削除します。

get

1 つのエンドポイントの詳細を取得します。

list

指定されたプロジェクトとロケーションの FirewallEndpoint を一覧で表示します。

patch

1 つのエンドポイントを更新します。