REST Resource: projects.locations.httpRoutes

リソース: HttpRoute

HttpRoute は、Mesh またはゲートウェイ リソースによる HTTP トラフィックのルーティング方法を定義するリソースです。

JSON 表現
{
  "name": string,
  "selfLink": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "hostnames": [
    string
  ],
  "meshes": [
    string
  ],
  "gateways": [
    string
  ],
  "labels": {
    string: string,
    ...
  },
  "rules": [
    {
      object (RouteRule)
    }
  ]
}
フィールド
name

string

必須。HttpRoute リソースの名前。パターン projects/*/locations/global/httpRoutes/http_route_name> と一致します。

description

string

省略可。リソースのフリーテキストの説明。最大長は 1,024 文字です。

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"

hostnames[]

string

必須。ホスト名は、リクエストを処理する HttpRoute を選択するために HTTP ホストヘッダーと照合する一連のホストを定義します。ホスト名は、RFC 1123 で定義されているネットワーク ホストの完全修飾ドメイン名です。ただし、IP は許可されません。- ホスト名の先頭にワイルドカード ラベル(*.)を付けることができます。ワイルドカード ラベルは、単独で最初のラベルとして表示される必要があります。

ホスト名は、ネットワーク ホストの末尾にドットを付けない「正確」なドメイン名(例: foo.example.com)、または、先頭に単一のワイルドカード ラベル(例: *.example.com)が付いたドメイン名の「ワイルドカード」にできます。

なお、RFC1035 および RFC1123 に従い、ラベルを小文字の英数字と「-」で作成して、先頭と末尾を英数字にする必要があります。その他の句読点は使用できません。

メッシュまたはゲートウェイに関連付けられたルートには一意のホスト名が必要です。ホスト名が競合する複数のルートを接続しようとすると、構成は拒否されます。

たとえば、ホスト名の *.foo.bar.com*.bar.com を同じメッシュ(または同じスコープのゲートウェイ)に関連付けることは問題ありませんが、2 つのルートの両方を *.bar.com に、または両方を bar.com に関連付けることはできません。

meshes[]

string

省略可。メッシュは、この HttpRoute が接続されているメッシュのリストを、メッシュによって処理されるリクエストをルーティングするルーティング ルールの一つとして定義します。

各メッシュの参照は、パターン projects/*/locations/global/meshes/<mesh_name> と一致している必要があります。

接続するメッシュはのタイプは SIDECAR である必要があります

gateways[]

string

省略可。ゲートウェイは、この HttpRoute が接続されるゲートウェイのリストを定義します。これは、ゲートウェイによって処理されるリクエストをルーティングするルーティング ルールの一つです。

各ゲートウェイの参照は、パターン projects/*/locations/global/gateways/<gateway_name> と一致している必要があります。

labels

map (key: string, value: string)

省略可。HttpRoute リソースに関連付けられたラベルタグのセット。

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

rules[]

object (RouteRule)

必須。トラフィックのルーティング方法と処理方法を定義するルール。ルールは、そのルールに対して指定された RouteMatch に基づいて順番に照合されます。

RouteRule

トラフィックをマッチングする方法と、トラフィックが一致した場合にトラフィックをルーティングする方法を指定します。

JSON 表現
{
  "matches": [
    {
      object (RouteMatch)
    }
  ],
  "action": {
    object (RouteAction)
  }
}
フィールド
matches[]

object (RouteMatch)

一致のリストは、受信 HTTP リクエストとルールを照合するために使用される条件を定義します。それぞれの一致は独立しています。つまり、一致のいずれかが満たされると、このルールが一致します。

一致フィールドが指定されていない場合、このルールは無条件にトラフィックをマッチングします。

デフォルト ルールを構成する場合、一致が指定されていないルールをルールリストの末尾に追加します。

action

object (RouteAction)

マッチングしたトラフィックのルーティング方法を定義する詳細なルール。

RouteMatch

RouteMatch は、リクエストの一致に使用する仕様を定義します。複数の一致タイプが設定されている場合、すべての種類の一致が満たされる場合にこの RouteMatch が一致します。

JSON 表現
{
  "ignoreCase": boolean,
  "headers": [
    {
      object (HeaderMatch)
    }
  ],
  "queryParameters": [
    {
      object (QueryParameterMatch)
    }
  ],

  // Union field PathMatch can be only one of the following:
  "fullPathMatch": string,
  "prefixMatch": string,
  "regexMatch": string
  // End of list of possible types for union field PathMatch.
}
フィールド
ignoreCase

boolean

prefixMatch と fullPathMatch の一致で大文字と小文字を区別するかどうかを指定します。デフォルト値は false です。

headers[]

object (HeaderMatch)

照合する HTTP リクエスト ヘッダーのリストを指定します。指定されたすべてのヘッダーが一致する必要があります。

queryParameters[]

object (QueryParameterMatch)

照合するクエリ パラメータのリストを指定します。すべてのクエリ パラメータが一致する必要があります。

共用体フィールド PathMatch

PathMatch は次のいずれかになります。

fullPathMatch

string

HTTP リクエストパスの値は、この値と完全に一致する必要があります。

fullPathMatch、prefixMatch、regexMatch のいずれか 1 つだけを使用する必要があります。

prefixMatch

string

HTTP リクエストパスの値は、指定された prefixMatch で始まる必要があります。prefixMatch は / で始まる必要があります。

fullPathMatch、prefixMatch、regexMatch のいずれか 1 つだけを使用する必要があります。

regexMatch

string

HTTP リクエストパスの値は、元の URL で指定されたクエリ パラメータとアンカーを削除した後、regexMatch で指定された正規表現を満たす必要があります。正規表現の文法については、https://github.com/google/re2/wiki/Syntax をご覧ください。

fullPathMatch、prefixMatch、regexMatch のいずれか 1 つだけを使用する必要があります。

HeaderMatch

HTTP リクエスト ヘッダーに基づいてルートルールを選択する方法を指定します。

JSON 表現
{
  "header": string,
  "invertMatch": boolean,

  // Union field MatchType can be only one of the following:
  "exactMatch": string,
  "regexMatch": string,
  "prefixMatch": string,
  "presentMatch": boolean,
  "suffixMatch": string,
  "rangeMatch": {
    object (IntegerRange)
  }
  // End of list of possible types for union field MatchType.
}
フィールド
header

string

照合する HTTP ヘッダーの名前。

invertMatch

boolean

指定すると、一致結果はチェック前に反転されます。デフォルト値は false に設定されています。

共用体フィールド MatchType

MatchType は次のいずれかになります。

exactMatch

string

ヘッダーの値は、exactMatch のコンテンツと完全に一致している必要があります。

regexMatch

string

ヘッダーの値は、regexMatch で指定された正規表現と一致する必要があります。正規表現の文法については、https://github.com/google/re2/wiki/Syntax をご覧ください。

prefixMatch

string

ヘッダーの値は、prefixMatch の内容で始まる必要があります。

presentMatch

boolean

headerName を含むヘッダーが存在する必要があります。ヘッダーに値があるかどうかにかかわらず、照合が行われます。

suffixMatch

string

ヘッダーの値は、suffixMatch の内容で終わる必要があります。

rangeMatch

object (IntegerRange)

指定すると、リクエスト ヘッダー値が範囲内にある場合にルールが一致します。

IntegerRange

整数値の範囲を表します。

JSON 表現
{
  "start": integer,
  "end": integer
}
フィールド
start

integer

範囲の開始(端を含む)

end

integer

範囲の終了(端を含まない)

QueryParameterMatch

リクエストのクエリ パラメータに一致する仕様。

JSON 表現
{
  "queryParameter": string,

  // Union field MatchType can be only one of the following:
  "exactMatch": string,
  "regexMatch": string,
  "presentMatch": boolean
  // End of list of possible types for union field MatchType.
}
フィールド
queryParameter

string

一致するクエリ パラメータの名前。

共用体フィールド MatchType

MatchType は次のいずれかになります。

exactMatch

string

クエリ パラメータの値は、exactMatch の内容と完全に一致する必要があります。

exactlyMatch、regexMatch、presentationMatch のいずれか 1 つだけを設定する必要があります。

regexMatch

string

クエリ パラメータの値は、regexMatch で指定された正規表現と一致する必要があります。正規表現の文法については、https://github.com/google/re2/wiki/Syntax をご覧ください。

exactlyMatch、regexMatch、presentationMatch のいずれか 1 つだけを設定する必要があります。

presentMatch

boolean

パラメータに値があるかどうかに関係なく、リクエストにクエリ パラメータが含まれている場合に、QueryParameterMatcher が一致することを指定します。

exactlyMatch、regexMatch、presentationMatch のいずれか 1 つだけを設定する必要があります。

RouteAction

トラフィックのルーティングと関連ポリシーの適用のための仕様。

JSON 表現
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "redirect": {
    object (Redirect)
  },
  "faultInjectionPolicy": {
    object (FaultInjectionPolicy)
  },
  "requestHeaderModifier": {
    object (HeaderModifier)
  },
  "responseHeaderModifier": {
    object (HeaderModifier)
  },
  "urlRewrite": {
    object (URLRewrite)
  },
  "timeout": string,
  "retryPolicy": {
    object (RetryPolicy)
  },
  "requestMirrorPolicy": {
    object (RequestMirrorPolicy)
  },
  "corsPolicy": {
    object (CorsPolicy)
  },
  "statefulSessionAffinity": {
    object (StatefulSessionAffinityPolicy)
  },
  "directResponse": {
    object (HttpDirectResponse)
  },
  "idleTimeout": string
}
フィールド
destinations[]

object (Destination)

トラフィックの転送先。

redirect

object (Redirect)

設定されている場合、リクエストはこのフィールドで構成されているように転送されます。

faultInjectionPolicy

object (FaultInjectionPolicy)

バックエンド サービスの障害に対するクライアントの復元性をテストするために、トラフィックに導入されたフォールト インジェクションの仕様。フォールト インジェクションの一環として、クライアントがバックエンド サービスにリクエストを送信する際、リクエストをバックエンド サービスに送信する前に、一定の割合のリクエストに遅延が生じる可能性があります。同様に、クライアントからのリクエストも一定の割合で中止される可能性があります。

timeout と retryPolicy は、faultInjectionPolicy で構成されているクライアントで無視されます

requestHeaderModifier

object (HeaderModifier)

リクエストを宛先に配信する前に、一致するリクエストのヘッダーを変更するための仕様。HeaderModifiers が宛先と RouteAction の両方に設定されている場合、マージされます。両者の間の競合は構成上で解決されません。

responseHeaderModifier

object (HeaderModifier)

クライアントにレスポンスを返す前にレスポンスのヘッダーを変更するための仕様。HeaderModifiers が宛先と RouteAction の両方に設定されている場合、マージされます。両者の間の競合は構成上で解決されません。

urlRewrite

object (URLRewrite)

リクエストを宛先に転送する前の書き換え URL の仕様。

timeout

string (Duration format)

選択したルートのタイムアウトを指定します。リクエストが完全に処理されてから(つまり、ストリームの終了時点)、レスポンスが完全に処理されるまでのタイムアウトが計算されます。タイムアウトにはすべての再試行が含まれます。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

retryPolicy

object (RetryPolicy)

このルートに関連付けられた再試行ポリシーを指定します。

requestMirrorPolicy

object (RequestMirrorPolicy)

ルートの宛先に対するリクエストを、別のミラーリング対象の宛先にシャドーイングする方法に関するポリシーを指定します。プロキシは、シャドウの宛先の応答を待たずにレスポンスを返します。シャドウ サービスにトラフィックを送信する前に、host/authority ヘッダーの末尾に -Shadow が付けられます。

corsPolicy

object (CorsPolicy)

クライアント側のクロスオリジン リクエストを許可するための仕様。

statefulSessionAffinity

object (StatefulSessionAffinityPolicy)

省略可。Cookie ベースのステートフル セッション アフィニティを指定します。

directResponse

object (HttpDirectResponse)

省略可。リクエストに関係なく返される静的 HTTP レスポンス オブジェクト。

idleTimeout

string (Duration format)

省略可。選択したルートのアイドル・タイムアウトを指定します。アイドル タイムアウトは、アップストリーム接続とダウンストリーム接続のいずれにおいても送受信されるバイトがない期間として定義されます。設定しない場合、デフォルトのアイドル タイムアウトは 1 時間です。0 秒に設定すると、タイムアウトは無効になります。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

宛先

リクエストのルーティング先となる宛先の仕様。

JSON 表現
{
  "serviceName": string,
  "weight": integer,
  "requestHeaderModifier": {
    object (HeaderModifier)
  },
  "responseHeaderModifier": {
    object (HeaderModifier)
  }
}
フィールド
serviceName

string

トラフィックのルーティング先となる BackendService の URL。

weight

integer

serviceName フィールドで参照されるバックエンドに転送されるリクエストの割合を指定します。これは、- weight/Sum(この宛先リストの重み)として計算されます。ゼロ以外の値の場合、実装がサポートする精度によりますが、ここで定義された正確な割合からのイプシロンが存在する可能性があります。

serviceName が 1 つだけ指定されていて、その重みが 0 より大きい場合、トラフィックの 100% がそのバックエンドに転送されます。

いずれかのサービス名に重みが指定される場合、すべてのサービス名に重みを指定する必要があります。

すべてのサービスに重み付けを指定しない場合は、トラフィックがすべてのサービスに均等に分散されます。

requestHeaderModifier

object (HeaderModifier)

省略可。リクエストを宛先に配信する前に、一致するリクエストのヘッダーを変更するための仕様。HeaderModifiers が宛先と RouteAction の両方に設定されている場合、マージされます。両者の間の競合は構成上で解決されません。

responseHeaderModifier

object (HeaderModifier)

省略可。クライアントにレスポンスを返す前にレスポンスのヘッダーを変更するための仕様。HeaderModifiers が宛先と RouteAction の両方に設定されている場合、マージされます。両者の間の競合は構成上で解決されません。

HeaderModifier

HTTP リクエストと HTTP レスポンス内の HTTP ヘッダーを変更するための仕様。

JSON 表現
{
  "set": {
    string: string,
    ...
  },
  "add": {
    string: string,
    ...
  },
  "remove": [
    string
  ]
}
フィールド
set

map (key: string, value: string)

指定されたマップでヘッダーを完全に上書きするか置き換えます。ここで、key はヘッダーの名前、value はヘッダーの値です。

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

add

map (key: string, value: string)

指定されたマップでヘッダーを追加します。ここで、key はヘッダーの名前、value はヘッダーの値です。

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

remove[]

string

リストで指定されたヘッダー(ヘッダー名での一致)を削除します。

リダイレクト

トラフィックのリダイレクトの仕様。

JSON 表現
{
  "hostRedirect": string,
  "pathRedirect": string,
  "prefixRewrite": string,
  "responseCode": enum (ResponseCode),
  "httpsRedirect": boolean,
  "stripQuery": boolean,
  "portRedirect": integer
}
フィールド
hostRedirect

string

リクエストで指定されたパスではなく、リダイレクト レスポンスで使用されるホストです。

pathRedirect

string

リクエストで指定されたパスではなく、リダイレクト レスポンスで使用されるパスです。pathRedirect を prefixRedirect と一緒に指定することはできません。いずれか 1 つを指定するか、またはどちらも指定しません。どちらも指定されていない場合は、元のリクエストのパスがリダイレクトに使用されます。

prefixRewrite

string

リダイレクト中に、一致した接頭辞(またはパス)をこの値と交換する必要があることを示します。このオプションを使用すると、リクエストに基づいて URL を動的に作成できます。

responseCode

enum (ResponseCode)

リダイレクトに使用する HTTP ステータス コード。

httpsRedirect

boolean

true に設定すると、リダイレクトされるリクエストの URL スキームが https に設定されます。false に設定した場合、リダイレクトされたリクエストの URL スキームはリクエストのものと同じになります。

デフォルトは False に設定されています。

stripQuery

boolean

true に設定すると、リクエストがリダイレクトされる前に、元の URL に付随するクエリ部分が削除されます。false に設定すると、元の URL のクエリ部分が保持されます。

デフォルトは False に設定されています。

portRedirect

integer

リクエストで指定されるポートではなく、リダイレクトされるリクエストで使用されるポート。

ResponseCode

サポートされている HTTP レスポンス コード

列挙型
RESPONSE_CODE_UNSPECIFIED デフォルト値
MOVED_PERMANENTLY_DEFAULT 301 に対応しています。
FOUND 302 に対応しています。
SEE_OTHER 303 に対応しています。
TEMPORARY_REDIRECT 307 に対応しています。この場合、リクエスト メソッドは保持されます。
PERMANENT_REDIRECT 308 に対応しています。この場合、リクエスト メソッドは保持されます。

FaultInjectionPolicy

宛先サービスの障害に対するクライアントの復元性をテストするために、トラフィックに導入されたフォールト インジェクションの仕様。フォールト インジェクションの一環として、クライアントが宛先にリクエストを送信する際、リクエストを宛先サービスに送信する前に、クライアント プロキシにより一定の割合のリクエストに遅延が挿入される可能性があります。同様に、リクエストがクライアント プロキシにより一定の割合で中止される可能性があります。

JSON 表現
{
  "delay": {
    object (Delay)
  },
  "abort": {
    object (Abort)
  }
}
フィールド
delay

object (Delay)

クライアント リクエストに遅延を挿入するための仕様。

abort

object (Abort)

クライアント リクエストを中止するための仕様。

遅延

宛先に送信される前にクライアント リクエストをフォールト インジェクションの一環として遅延させる方法の仕様。

JSON 表現
{
  "fixedDelay": string,
  "percentage": integer
}
フィールド
fixedDelay

string (Duration format)

リクエストを転送する前に固定の遅延を指定します。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

percentage

integer

遅延を挿入するトラフィックの割合。

値は [0, 100] の範囲にする必要があります。

中止

宛先に送信される前にクライアント リクエストをフォールト インジェクションの一環として中止する方法の仕様。

JSON 表現
{
  "httpStatus": integer,
  "percentage": integer
}
フィールド
httpStatus

integer

リクエストの中止に使用される HTTP ステータス コード。

値は 200 以上 599 以下でなければなりません。

percentage

integer

中止されるトラフィックの割合。

値は [0, 100] の範囲にする必要があります。

URLRewrite

リクエストを宛先に転送する前に、リクエストの URL を変更するための仕様。

JSON 表現
{
  "pathPrefixRewrite": string,
  "hostRewrite": string
}
フィールド
pathPrefixRewrite

string

リクエストを選択した宛先に転送する前に、リクエストパスの一致する部分がこの値に置き換えられます。

hostRewrite

string

選択した宛先にリクエストを転送する前に、リクエストのホストヘッダーはこの値に置き換えられます。

RetryPolicy

再試行の仕様。

JSON 表現
{
  "retryConditions": [
    string
  ],
  "numRetries": integer,
  "perTryTimeout": string
}
フィールド
retryConditions[]

string

この再試行ポリシーが適用されるときの条件を 1 つ以上指定します。Valid values are: 5xx: プロキシは、宛先サービスが 5xx レスポンス コードで応答した場合、宛先サービスがまったく応答しない場合に再試行します(切断、リセット、読み取りタイムアウト、接続エラー、拒否されたストリームなど)。

gateway-error: 5xx に似ていますが、レスポンス コード 502、503、504 にのみ適用されます。

reset: 宛先サービスがまったく応答しない場合(切断/リセット/読み取りタイムアウト)に、プロキシが再試行します

connect-failure: プロキシは、接続タイムアウトなどにより宛先への接続に失敗すると再試行します。

retriable-4xx: 再試行可能な 4xx レスポンス コードの場合、プロキシは再試行します。現在、再試行可能なエラーとしてサポートされているのは 409 のみです。

refused-stream: 宛先が REFUSED_STREAM エラーコードでストリームをリセットすると、プロキシが再試行します。このリセットタイプは、再試行しても安全であることを示します。

numRetries

integer

許可される再試行回数を指定します。0 より大きい値である必要があります。指定しない場合、デフォルトで 1 になります。

perTryTimeout

string (Duration format)

再試行ごとのタイムアウトをゼロ以外で指定します。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

RequestMirrorPolicy

ミラーリング対象の別の宛先サービスにリクエストをシャドーイングする方法に関するポリシーを指定します。プロキシはシャドウ サービスからのレスポンスを待ちません。シャドウ サービスにトラフィックを送信する前に、host/authority ヘッダーの末尾に -Shadow が付けられます。

JSON 表現
{
  "destination": {
    object (Destination)
  },
  "mirrorPercent": number
}
フィールド
destination

object (Destination)

リクエストがミラーリングされる宛先。宛先のウェイトは無視されます。

mirrorPercent

number

省略可。目的の宛先にミラーリングされるリクエストの割合。

CorsPolicy

クライアント側のクロスオリジン リクエストを許可するための仕様。

JSON 表現
{
  "allowOrigins": [
    string
  ],
  "allowOriginRegexes": [
    string
  ],
  "allowMethods": [
    string
  ],
  "allowHeaders": [
    string
  ],
  "exposeHeaders": [
    string
  ],
  "maxAge": string,
  "allowCredentials": boolean,
  "disabled": boolean
}
フィールド
allowOrigins[]

string

CORS リクエストを行えるよう許可するオリジンのリストを指定します。オリジンは、allowOrigins 内の項目または allowOriginRegexes 内の項目のいずれかに一致する場合に許可されます。

allowOriginRegexes[]

string

許可されたオリジンと一致する正規表現パターンを指定します。正規表現の文法については、https://github.com/google/re2/wiki/Syntax をご覧ください。

allowMethods[]

string

Access-Control-Allow-Methods ヘッダーの内容を指定します。

allowHeaders[]

string

Access-Control-Allow-Headers ヘッダーの内容を指定します。

exposeHeaders[]

string

Access-Control-Expose-Headers ヘッダーの内容を指定します。

maxAge

string

プリフライト リクエストの結果をキャッシュに保存できる期間を秒単位で指定します。これは Access-Control-Max-Age ヘッダーに変換されます。

allowCredentials

boolean

プリフライト リクエストに応じて、これを true に設定すると、実際のリクエストにユーザー認証情報が含まれている可能性があることが示されます。これが Access-Control-Allow-Credentials ヘッダーに変換されます。

デフォルト値は false です。

disabled

boolean

true の場合、CORS ポリシーは無効になります。デフォルト値は false で、CORS ポリシーが有効であることを示します。

StatefulSessionAffinityPolicy

特定の宛先ホストをエンコードする「GSSA」という名前の「セッション Cookie」を日付プレーンが提供する Cookie ベースのステートフル セッション アフィニティの仕様、およびその Cookie を含むリクエストは、宛先ホストが正常な状態で残っている限り、そのホストに転送されます。

gRPC プロキシレス メッシュ ライブラリまたはサイドカー プロキシがセッション クッキーを管理しますが、クライアント アプリケーション コードは、セッション内の各 RPC から次の RPC に Cookie をコピーする役割を担います。

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

string (Duration format)

必須。データプレーンで生成された Set-Cookie ヘッダーの Cookie TTL 値。Cookie の有効期間は、1 秒以上 86,400 秒(24 時間)以下の値に設定できます。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"

HttpDirectResponse

返される静的 HTTP レスポンス オブジェクト。

JSON 表現
{
  "status": integer,

  // Union field HttpBody can be only one of the following:
  "stringBody": string,
  "bytesBody": string
  // End of list of possible types for union field HttpBody.
}
フィールド
status

integer

必須。HTTP レスポンスの一部として返されるステータス。正の整数で指定する必要があります。

共用体フィールド HttpBody。HTTP レスポンスの一部として返される本文。HttpBody は次のいずれかになります。
stringBody

string

省略可。文字列としてのレスポンス本文。本文の最大文字数は 1,024 文字です。

bytesBody

string (bytes format)

省略可。バイトとしてのレスポンス本文。本文の最大サイズは 4,096 B です。

Base64 でエンコードされた文字列。

メソッド

create

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

delete

1 つの HttpRoute を削除します。

get

1 つの HttpRoute の詳細を取得します。

list

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

patch

単一の HttpRoute のパラメータを更新します。

setIamPolicy

指定したリソースにアクセス制御ポリシーを設定します。

testIamPermissions

呼び出し元が指定されたリソース上で持つ権限を返します。