Ressource: Version
Eine Version
ist eine Konfiguration und eine Sammlung statischer Dateien, die bestimmen, wie eine Site angezeigt wird.
JSON-Darstellung |
---|
{ "name": string, "status": enum ( |
Felder | |
---|---|
name | Der vollständig qualifizierte Ressourcenname für die Version im Format: Dieser Name wird im Antworttext bereitgestellt, wenn Sie |
status | Der Bereitstellungsstatus der Version. Für eine erfolgreiche Bereitstellung rufen Sie Beachten Sie, dass das System die Version automatisch als Sie können den Status einer Version auch in |
config | Die Konfiguration für das Verhalten der Site. Diese Konfiguration ist in der Datei |
labels | Die Bezeichnungen, die für zusätzliche Metadaten und/oder Filterung verwendet werden. Ein Objekt, das eine Liste von |
createTime | Nur Ausgabe. Der Zeitpunkt, zu dem die Version erstellt wurde. Ein Zeitstempel im RFC3339 UTC „Zulu“-Format mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
createUser | Nur Ausgabe. Identifiziert den Benutzer, der die Version erstellt hat. |
finalizeTime | Nur Ausgabe. Der Zeitpunkt, zu dem die Version Ein Zeitstempel im RFC3339 UTC „Zulu“-Format mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
finalizeUser | Nur Ausgabe. Identifiziert den Benutzer, der die Version |
deleteTime | Nur Ausgabe. Der Zeitpunkt, zu dem die Version Ein Zeitstempel im RFC3339 UTC „Zulu“-Format mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: |
deleteUser | Nur Ausgabe. Identifiziert den Benutzer, der die Version |
fileCount | Nur Ausgabe. Die Gesamtzahl der mit der Version verknüpften Dateien. Dieser Wert wird berechnet, nachdem eine Version |
versionBytes | Nur Ausgabe. Die insgesamt gespeicherte Bytegröße der Version. Dieser Wert wird berechnet, nachdem eine Version |
Versionsstatus
Der aktuell bekannte Status einer bestimmten Version im Bereitstellungslebenszyklus.
Aufzählungen | |
---|---|
VERSION_STATUS_UNSPECIFIED | Der Standardstatus; sollten nicht absichtlich verwendet werden. |
CREATED | Die Version wurde erstellt und Inhalte werden derzeit zur Version hinzugefügt. |
FINALIZED | Der gesamte Inhalt wurde zur Version hinzugefügt und die Version kann nicht mehr geändert werden. |
DELETED | Die Version wurde gelöscht. |
ABANDONED | Die Version wurde nicht innerhalb von 12 Stunden auf FINALIZED aktualisiert und automatisch gelöscht. |
EXPIRED | Die Version liegt außerhalb des von der Site konfigurierten Grenzwerts für die Anzahl der beibehaltenen Versionen, daher ist die Löschung des Inhalts der Version geplant. |
CLONING | Die Version wird von einer anderen Version geklont. Alle Inhalte werden weiterhin kopiert. |
ServingConfig
Die Konfiguration, wie eingehende Anfragen an eine Site weitergeleitet und verarbeitet werden sollen, bevor Inhalte bereitgestellt werden. Die URL-Anforderungspfade werden mit den angegebenen URL-Mustern in der Konfiguration abgeglichen, dann wendet Hosting die entsprechende Konfiguration gemäß einer bestimmten Prioritätsreihenfolge an.
JSON-Darstellung |
---|
{ "headers": [ { object ( |
Felder | |
---|---|
headers[] | Ein Array von Objekten, wobei jedes Objekt ein URL-Muster angibt, das bei Übereinstimmung mit dem Anforderungs-URL-Pfad Hosting dazu veranlasst, die angegebenen benutzerdefinierten Antwortheader anzuwenden. |
redirects[] | Ein Array von Objekten (Umleitungsregeln genannt), wobei jede Regel ein URL-Muster angibt, das bei Übereinstimmung mit dem Anforderungs-URL-Pfad Hosting dazu veranlasst, mit einer Umleitung zum angegebenen Zielpfad zu antworten. |
rewrites[] | Ein Array von Objekten (Rewrite-Regeln genannt), wobei jede Regel ein URL-Muster angibt, das bei Übereinstimmung mit dem Anforderungs-URL-Pfad Hosting dazu veranlasst, zu antworten, als ob dem Dienst die angegebene Ziel-URL gegeben worden wäre. |
cleanUrls | Legt fest, ob die Dateierweiterung aus hochgeladenen Dateien entfernt werden soll. |
trailingSlashBehavior | Definiert, wie mit einem abschließenden Schrägstrich im URL-Pfad umgegangen wird. |
i18n | Optional. Definiert das i18n-Rewrite-Verhalten. |
Header
Ein Header
gibt ein URL-Muster an, das bei Übereinstimmung mit dem Anforderungs-URL-Pfad Hosting dazu veranlasst, die angegebenen benutzerdefinierten Antwortheader anzuwenden.
JSON-Darstellung |
---|
{ "headers": { string: string, ... }, // Union field |
Felder | |
---|---|
headers | Erforderlich. Die zusätzlichen Header, die der Antwort hinzugefügt werden sollen. Ein Objekt, das eine Liste von |
Union- pattern .Erforderlich. Ein Zeichenfolgen-URL-Muster, das mit dem Anforderungs-URL-Pfad abgeglichen wird, um zu bestimmen, ob dieser benutzerdefinierte Antwortheader angewendet werden soll. Kann entweder ein Glob im Bash-Stil oder ein regulärer RE2-Ausdruck sein. pattern kann nur eines der folgenden sein: | |
glob | Der vom Benutzer bereitgestellte Glob , der mit dem Anforderungs-URL-Pfad abgeglichen werden soll. |
regex | Der vom Benutzer bereitgestellte reguläre RE2-Ausdruck, der mit dem Anforderungs-URL-Pfad abgeglichen werden soll. |
Umleiten
Eine Redirect
gibt ein URL-Muster an, das bei Übereinstimmung mit dem Anforderungs-URL-Pfad Hosting dazu veranlasst, mit einer Umleitung zum angegebenen Zielpfad zu antworten.
JSON-Darstellung |
---|
{ "statusCode": integer, "location": string, // Union field |
Felder | |
---|---|
statusCode | Erforderlich. Der Status-HTTP-Code, der in der Antwort zurückgegeben werden soll. Es muss ein gültiger 3xx-Statuscode sein. |
location | Erforderlich. Der Wert, der in den HTTP-Location-Header der Antwort eingefügt werden soll. Der Speicherort kann Erfassungsgruppenwerte aus dem Muster enthalten, wobei ein |
Union- pattern .Erforderlich. Ein Zeichenfolgen-URL-Muster, das mit dem Anforderungs-URL-Pfad abgeglichen wird, um zu bestimmen, ob diese Umleitung angewendet werden soll. Kann entweder ein Glob im Bash-Stil oder ein regulärer RE2-Ausdruck sein. pattern kann nur eines der folgenden sein: | |
glob | Der vom Benutzer bereitgestellte Glob , der mit dem Anforderungs-URL-Pfad abgeglichen werden soll. |
regex | Der vom Benutzer bereitgestellte reguläre RE2-Ausdruck, der mit dem Anforderungs-URL-Pfad abgeglichen werden soll. |
Umschreiben
Ein Rewrite
gibt ein URL-Muster an, das bei Übereinstimmung mit dem Anforderungs-URL-Pfad Hosting dazu veranlasst, so zu reagieren, als ob dem Dienst die angegebene Ziel-URL gegeben worden wäre.
JSON-Darstellung |
---|
{ "functionRegion": string, // Union field |
Felder | |
---|---|
functionRegion | Optional. Geben Sie eine Cloud-Region für neu geschriebene Funktionsaufrufe an. Wenn nicht angegeben, wird standardmäßig us-central1 verwendet. |
Union- pattern .Erforderlich. Ein Zeichenfolgen-URL-Muster, das mit dem Anforderungs-URL-Pfad abgeglichen wird, um zu bestimmen, ob diese Umschreibung angewendet werden soll. Kann entweder ein Glob im Bash-Stil oder ein regulärer RE2-Ausdruck sein. pattern kann nur eines der folgenden sein: | |
glob | Der vom Benutzer bereitgestellte Glob , der mit dem Anforderungs-URL-Pfad abgeglichen werden soll. |
regex | Der vom Benutzer bereitgestellte reguläre RE2-Ausdruck, der mit dem Anforderungs-URL-Pfad abgeglichen werden soll. |
behavior im Unionsfeld.Erforderlich. Das Verhalten des Umschreibens. behavior kann nur eines der folgenden sein: | |
path | Der URL-Pfad, in den die Anfrage umgeschrieben werden soll. |
function | Die Funktion, an die Anfragen weitergeleitet werden. Muss genau mit dem exportierten Funktionsnamen übereinstimmen. |
run | Die Anfrage wird an Cloud Run weitergeleitet. |
CloudRunRewrite
Eine konfigurierte Umschreibung, die Anfragen an einen Cloud Run-Dienst weiterleitet. Wenn der Cloud Run-Dienst beim Festlegen oder Aktualisieren Ihrer Firebase Hosting-Konfiguration nicht vorhanden ist, schlägt die Anfrage fehl. Alle Fehler vom Cloud Run-Dienst werden an den Endbenutzer weitergeleitet (wenn Sie beispielsweise einen Dienst löschen, erhalten alle an diesen Dienst gerichteten Anforderungen einen 404
Fehler).
JSON-Darstellung |
---|
{ "serviceId": string, "region": string, "tag": string } |
Felder | |
---|---|
serviceId | Erforderlich. Benutzerdefinierte ID des Cloud Run-Dienstes. |
region | Optional. Vom Benutzer bereitgestellte Region, in der der Cloud Run-Dienst gehostet wird. Der Standardwert ist |
tag | Optional. Vom Benutzer bereitgestelltes TrafficConfig-Tag, an das Datenverkehr gesendet werden soll. Wenn es weggelassen wird, wird der Datenverkehr an den dienstweiten URI gesendet |
TrailingSlashBehavior
Definiert, ob ein abschließender Schrägstrich zum Anforderungs-URL-Pfad hinzugefügt oder daraus entfernt werden soll.
Aufzählungen | |
---|---|
TRAILING_SLASH_BEHAVIOR_UNSPECIFIED | Es ist kein Verhalten angegeben. Dateien werden nur an ihrem genauen Speicherort bereitgestellt und abschließende Schrägstriche werden nur zu Verzeichnisindizes hinzugefügt. |
ADD | Nachgestellte Schrägstriche werden zu Verzeichnisindizes sowie zu allen URL-Pfaden hinzugefügt , die nicht mit einer Dateierweiterung enden. |
REMOVE | Nachgestellte Schrägstriche werden aus Verzeichnisindizes sowie aus allen URL-Pfaden entfernt , die nicht mit einer Dateierweiterung enden. |
I18nConfig
Sofern vorhanden, sind i18n-Umschreibungen aktiviert.
JSON-Darstellung |
---|
{ "root": string } |
Felder | |
---|---|
root | Erforderlich. Der vom Benutzer angegebene Pfad, in dem im öffentlichen Verzeichnis nach länder- und sprachspezifischen Inhalten gesucht wird. |
Methoden | |
---|---|
| Erstellt eine neue Version auf der angegebenen Zielsite unter Verwendung des Inhalts der angegebenen Version. |
| Erstellt eine neue Version für die angegebene Site. |
| Löscht die angegebene Version. |
| Rufen Sie die angegebene Version ab, die für die angegebene Site erstellt wurde. |
| Listet die Versionen auf, die für die angegebene Site erstellt wurden. |
| Aktualisiert die angegebenen Metadaten für die angegebene Version. |
| Fügt Inhaltsdateien zur angegebenen Version hinzu. |