リソース: バージョン
Version
は、サイトの表示方法を決定する構成および静的ファイルのコレクションです。
JSON表現 |
---|
{ "name": string, "status": enum ( |
田畑 | |
---|---|
name | 次の形式のバージョンの完全修飾リソース名。 この名前は、 |
status | バージョンのデプロイステータス。 デプロイを成功させるには、 バージョンを 12 時間以上 |
config | サイトの動作の構成。この設定は |
labels | 追加のメタデータやフィルタリングに使用されるラベル。 |
createTime | 出力のみ。バージョンが作成された時刻。 RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の分解能と最大 9 桁の小数点以下を備えています。例: |
createUser | 出力のみ。バージョンを作成したユーザーを識別します。 |
finalizeTime | 出力のみ。バージョンが RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の分解能と最大 9 桁の小数点以下を備えています。例: |
finalizeUser | 出力のみ。バージョン |
deleteTime | 出力のみ。バージョンが RFC3339 UTC「Zulu」形式のタイムスタンプ。ナノ秒の分解能と最大 9 桁の小数点以下を備えています。例: |
deleteUser | 出力のみ。バージョン |
fileCount | 出力のみ。バージョンに関連付けられたファイルの総数。 この値は、バージョンが |
versionBytes | 出力のみ。バージョンの合計保存バイトサイズ。 この値は、バージョンが |
バージョンステータス
デプロイライフサイクルにおける特定のバージョンの現在の既知のステータス。
列挙型 | |
---|---|
VERSION_STATUS_UNSPECIFIED | デフォルトのステータス。意図的に使用すべきではありません。 |
CREATED | バージョンが作成され、現在コンテンツがバージョンに追加されています。 |
FINALIZED | すべてのコンテンツがバージョンに追加されており、バージョンは変更できなくなります。 |
DELETED | バージョンは削除されました。 |
ABANDONED | バージョンは 12 時間以内にFINALIZED に更新されず、自動的に削除されました。 |
EXPIRED | このバージョンは、サイトで構成された保持バージョン数の制限を超えているため、バージョンのコンテンツは削除されるようにスケジュールされています。 |
CLONING | このバージョンは別のバージョンから複製されています。すべてのコンテンツはまだコピー中です。 |
ServingConfig
コンテンツを提供する前に、サイトへの受信リクエストをルーティングおよび処理する方法の構成。 URL リクエスト パスが構成内の指定された URL パターンと照合され、ホスティングは特定の優先順位に従って該当する構成を適用します。
JSON表現 |
---|
{ "headers": [ { object ( |
田畑 | |
---|---|
headers[] | オブジェクトの配列。各オブジェクトは、リクエスト URL パスと一致した場合に、指定されたカスタム応答ヘッダーを適用するようにホスティングをトリガーする URL パターンを指定します。 |
redirects[] | オブジェクトの配列 (リダイレクト ルールと呼ばれます)。各ルールは URL パターンを指定します。このパターンが要求 URL パスに一致すると、指定された宛先パスへのリダイレクトでホスティングが応答します。 |
rewrites[] | オブジェクトの配列 (書き換えルールと呼ばれます)。各ルールは URL パターンを指定します。このパターンがリクエスト URL パスに一致すると、指定された宛先 URL がサービスに与えられたかのようにホスティングが応答します。 |
cleanUrls | アップロードされたファイルからファイル拡張子を削除するかどうかを定義します。 |
trailingSlashBehavior | URL パスの末尾のスラッシュを処理する方法を定義します。 |
i18n | オプション。 i18n 書き換え動作を定義します。 |
ヘッダ
Header
、リクエスト URL パスと一致する場合、指定されたカスタム応答ヘッダーを適用するようにホスティングをトリガーする URL パターンを指定します。
JSON表現 |
---|
{ "headers": { string: string, ... }, // Union field |
田畑 | |
---|---|
headers | 必須。応答に追加する追加ヘッダー。 |
ユニオンフィールドpattern 。必須。このカスタム応答ヘッダーを適用するかどうかを決定するために、要求 URL パスと照合する文字列 URL パターン。 Bash スタイルのグロブまたは RE2 正規表現のいずれかを使用できます。 pattern 次のいずれか 1 つだけです。 | |
glob | リクエスト URL パスと照合するユーザー指定のglob 。 |
regex | リクエスト URL パスと照合するためのユーザー指定の RE2 正規表現。 |
リダイレクト
Redirect
、リクエスト URL パスに一致する場合、ホスティングが指定された宛先パスへのリダイレクトで応答するようにトリガーする URL パターンを指定します。
JSON表現 |
---|
{ "statusCode": integer, "location": string, // Union field |
田畑 | |
---|---|
statusCode | 必須。応答で返されるステータス HTTP コード。有効な 3xx ステータス コードである必要があります。 |
location | 必須。応答の HTTP ロケーション ヘッダーに含める値。 この場所には、セグメントを識別するための |
ユニオンフィールドpattern 。必須。このリダイレクトを適用するかどうかを決定するために、リクエスト URL パスと照合する文字列 URL パターン。 Bash スタイルのグロブまたは RE2 正規表現のいずれかを使用できます。 pattern 次のいずれか 1 つだけです。 | |
glob | リクエスト URL パスと照合するユーザー指定のglob 。 |
regex | リクエスト URL パスと照合するためのユーザー指定の RE2 正規表現。 |
リライト
Rewrite
、リクエスト URL パスに一致する場合、サービスに指定された宛先 URL が与えられたかのようにホスティングが応答するようにトリガーする URL パターンを指定します。
JSON表現 |
---|
{ "functionRegion": string, // Union field |
田畑 | |
---|---|
functionRegion | オプション。書き換えられた Functions 呼び出し用のクラウド リージョンを指定します。指定しない場合、デフォルトは us-central1 になります。 |
ユニオンフィールドpattern 。必須。この書き換えを適用するかどうかを決定するために、リクエスト URL パスと照合する文字列 URL パターン。 Bash スタイルのグロブまたは RE2 正規表現のいずれかを使用できます。 pattern 次のいずれか 1 つだけです。 | |
glob | リクエスト URL パスと照合するユーザー指定のglob 。 |
regex | リクエスト URL パスと照合するためのユーザー指定の RE2 正規表現。 |
ユニオンフィールドのbehavior 。必須。書き換えの動作。 behavior 次のいずれか 1 つだけです。 | |
path | リクエストを書き換える URL パス。 |
function | リクエストをプロキシする関数。エクスポートされた関数名と正確に一致する必要があります。 |
run | リクエストは Cloud Run に転送されます。 |
CloudRunRewrite
リクエストを Cloud Run サービスに送信するように構成されたリライト。 Firebase Hosting 構成の設定または更新時に Cloud Run サービスが存在しない場合、リクエストは失敗します。 Cloud Run サービスからのエラーはすべてエンドユーザーに渡されます(たとえば、サービスを削除すると、そのサービスに送信されたリクエストはすべて404
エラーを受け取ります)。
JSON表現 |
---|
{ "serviceId": string, "region": string, "tag": string } |
田畑 | |
---|---|
serviceId | 必須。 Cloud Run サービスのユーザー定義 ID。 |
region | オプション。 Cloud Run サービスがホストされるユーザー指定のリージョン。 指定しない場合、デフォルトは |
tag | オプション。トラフィックの送信先となるユーザー指定の TrafficConfig タグ。 省略すると、トラフィックはサービス全体の URI に送信されます。 |
トレーリングスラッシュの動作
リクエスト URL パスに末尾のスラッシュを追加するか削除するかを定義します。
列挙型 | |
---|---|
TRAILING_SLASH_BEHAVIOR_UNSPECIFIED | 動作は指定されていません。 ファイルは正確な場所でのみ提供され、末尾のスラッシュはディレクトリ インデックスにのみ追加されます。 |
ADD | 末尾のスラッシュは、ディレクトリ インデックスおよびファイル拡張子で終わらない URL パスに追加されます。 |
REMOVE | 末尾のスラッシュは、ディレクトリ インデックスおよびファイル拡張子で終わらない URL パスから削除されます。 |
I18nConfig
指定すると、i18n 書き換えが有効になります。
JSON表現 |
---|
{ "root": string } |
田畑 | |
---|---|
root | 必須。パブリック ディレクトリ内で国および言語固有のコンテンツが検索されるユーザー指定のパス。 |
メソッド | |
---|---|
| 指定されたバージョンのコンテンツを使用して、指定されたターゲット サイトに新しいバージョンを作成します。 |
| 指定されたサイトの新しいバージョンを作成します。 |
| 指定したバージョンを削除します。 |
| 指定されたサイト用に作成された指定されたバージョンを取得します。 |
| 指定したサイト用に作成されたバージョンを一覧表示します。 |
| 指定されたバージョンの指定されたメタデータを更新します。 |
| コンテンツ ファイルを指定されたバージョンに追加します。 |