Zasób: wersja
Version
to konfiguracja i zbiór plików statycznych, które określają sposób wyświetlania witryny.
Reprezentacja JSON |
---|
{ "name": string, "status": enum ( |
Pola | |
---|---|
name | W pełni kwalifikowana nazwa zasobu wersji w formacie: Ta nazwa jest podawana w treści odpowiedzi podczas wywoływania |
status | Stan wdrożenia wersji. Aby wdrożenie przebiegło pomyślnie, wywołaj Pamiętaj, że jeśli pozostawisz wersję w stanie Możesz także zmienić status wersji na |
config | Konfiguracja zachowania witryny. Ta konfiguracja istnieje w pliku |
labels | Etykiety używane do dodatkowych metadanych i/lub filtrowania. Obiekt zawierający listę par |
createTime | Tylko wyjście. Czas utworzenia wersji. Znacznik czasu w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundową i maksymalnie dziewięcioma cyframi ułamkowymi. Przykłady: |
createUser | Tylko wyjście. Identyfikuje użytkownika, który utworzył wersję. |
finalizeTime | Tylko wyjście. Czas, w którym wersja została Znacznik czasu w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundową i maksymalnie dziewięcioma cyframi ułamkowymi. Przykłady: |
finalizeUser | Tylko wyjście. Identyfikuje użytkownika, który |
deleteTime | Tylko wyjście. Czas, w którym wersja została Znacznik czasu w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundową i maksymalnie dziewięcioma cyframi ułamkowymi. Przykłady: |
deleteUser | Tylko wyjście. Identyfikuje użytkownika, który |
fileCount | Tylko wyjście. Całkowita liczba plików skojarzonych z wersją. Wartość ta jest obliczana po |
versionBytes | Tylko wyjście. Całkowity rozmiar przechowywanej wersji w bajtach. Wartość ta jest obliczana po |
Stan wersji
Bieżący znany stan określonej wersji w cyklu życia wdrożenia.
Wyliczenia | |
---|---|
VERSION_STATUS_UNSPECIFIED | Stan domyślny; nie należy używać celowo. |
CREATED | Wersja została utworzona i zawartość jest obecnie dodawana do wersji. |
FINALIZED | Cała zawartość została dodana do wersji i wersji nie można już zmienić. |
DELETED | Wersja została usunięta. |
ABANDONED | Wersja nie została zaktualizowana do FINALIZED w ciągu 12 godzin i została automatycznie usunięta. |
EXPIRED | Wersja przekracza skonfigurowany w witrynie limit liczby zachowywanych wersji, więc zawartość wersji została zaplanowana do usunięcia. |
CLONING | Wersja jest klonowana z innej wersji. Cała zawartość jest nadal kopiowana. |
Konfiguracja udostępniania
Konfiguracja sposobu kierowania i przetwarzania żądań przychodzących do witryny przed udostępnieniem zawartości. Ścieżki żądań URL są dopasowywane do określonych wzorców adresów URL w konfiguracji, a następnie Hosting stosuje odpowiednią konfigurację zgodnie z określoną kolejnością priorytetów .
Reprezentacja JSON |
---|
{ "headers": [ { object ( |
Pola | |
---|---|
headers[] | Tablica obiektów, gdzie każdy obiekt określa wzorzec adresu URL, który po dopasowaniu do ścieżki adresu URL żądania powoduje, że Hosting zastosuje określone niestandardowe nagłówki odpowiedzi. |
redirects[] | Tablica obiektów (zwana regułami przekierowań), gdzie każda reguła określa wzorzec adresu URL, który po dopasowaniu do ścieżki adresu URL żądania powoduje, że Hosting odpowiada przekierowaniem do określonej ścieżki docelowej. |
rewrites[] | Tablica obiektów (zwana regułami przepisywania), gdzie każda reguła określa wzorzec adresu URL, który po dopasowaniu do ścieżki adresu URL żądania powoduje, że Hosting reaguje tak, jakby usługa otrzymała określony docelowy adres URL. |
cleanUrls | Określa, czy usunąć rozszerzenie pliku z przesłanych plików. |
trailingSlashBehavior | Definiuje sposób obsługi końcowego ukośnika w ścieżce adresu URL. |
i18n | Opcjonalny. Definiuje zachowanie przepisywania i18n. |
nagłówek
Header
określa wzorzec adresu URL, który, jeśli jest dopasowany do ścieżki adresu URL żądania, powoduje, że Hosting stosuje określone niestandardowe nagłówki odpowiedzi.
Reprezentacja JSON |
---|
{ "headers": { string: string, ... }, // Union field |
Pola | |
---|---|
headers | Wymagany. Dodatkowe nagłówki, które należy dodać do odpowiedzi. Obiekt zawierający listę par |
pattern pola Unii.Wymagany. Wzorzec adresu URL ciągu pasującego do ścieżki adresu URL żądania w celu ustalenia, czy zastosować ten niestandardowy nagłówek odpowiedzi. Może to być glob w stylu Bash lub wyrażenie regularne RE2. pattern może być tylko jednym z następujących: | |
glob | Glob dostarczony przez użytkownika, który ma być zgodny ze ścieżką URL żądania. |
regex | Dostarczone przez użytkownika wyrażenie regularne RE2 pasujące do ścieżki adresu URL żądania. |
Przeadresować
Redirect
określa wzorzec adresu URL, który, jeśli jest dopasowany do ścieżki adresu URL żądania, powoduje, że Hosting odpowiada przekierowaniem do określonej ścieżki docelowej.
Reprezentacja JSON |
---|
{ "statusCode": integer, "location": string, // Union field |
Pola | |
---|---|
statusCode | Wymagany. Kod HTTP stanu, który ma zostać zwrócony w odpowiedzi. Musi to być prawidłowy kod stanu 3xx. |
location | Wymagany. Wartość, która ma zostać umieszczona w nagłówku lokalizacji HTTP odpowiedzi. Lokalizacja może zawierać wartości grupy przechwytywania ze wzorca, używając przedrostka |
pattern pola Unii.Wymagany. Ciągowy wzorzec adresu URL pasujący do ścieżki adresu URL żądania w celu ustalenia, czy zastosować to przekierowanie. Może to być glob w stylu Bash lub wyrażenie regularne RE2. pattern może być tylko jednym z następujących: | |
glob | Glob dostarczony przez użytkownika, który ma być zgodny ze ścieżką URL żądania. |
regex | Dostarczone przez użytkownika wyrażenie regularne RE2 pasujące do ścieżki adresu URL żądania. |
Przepisać
Rewrite
określa wzorzec adresu URL, który, jeśli jest dopasowany do ścieżki adresu URL żądania, powoduje, że Hosting reaguje tak, jakby usługa otrzymała określony docelowy adres URL.
Reprezentacja JSON |
---|
{ "functionRegion": string, // Union field |
Pola | |
---|---|
functionRegion | Opcjonalny. Określ region chmury dla przepisanych wywołań funkcji. Jeśli nie zostanie podany, domyślnie jest to us-central1. |
pattern pola Unii.Wymagany. Wzorzec adresu URL ciągu pasującego do ścieżki adresu URL żądania w celu ustalenia, czy zastosować to przepisanie. Może to być glob w stylu Bash lub wyrażenie regularne RE2. pattern może być tylko jednym z następujących: | |
glob | Glob dostarczony przez użytkownika, który ma być zgodny ze ścieżką URL żądania. |
regex | Dostarczone przez użytkownika wyrażenie regularne RE2 pasujące do ścieżki adresu URL żądania. |
behavior na polu Unii.Wymagany. Zachowanie przepisywania. behavior może być tylko jednym z poniższych: | |
path | Ścieżka URL, do której należy ponownie zapisać żądanie. |
function | Funkcja do wysyłania żądań proxy. Musi dokładnie odpowiadać wyeksportowanej nazwie funkcji. |
run | Żądanie zostanie przekazane do Cloud Run. |
CloudRunRewrite
Skonfigurowane przepisanie, które kieruje żądania do usługi Cloud Run. Jeśli usługa Cloud Run nie istnieje podczas ustawiania lub aktualizowania konfiguracji Firebase Hosting, żądanie nie powiedzie się. Wszelkie błędy usługi Cloud Run przekazywane są użytkownikowi końcowemu (np. jeśli usuniesz usługę, wszelkie żądania kierowane do tej usługi otrzymają błąd 404
).
Reprezentacja JSON |
---|
{ "serviceId": string, "region": string, "tag": string } |
Pola | |
---|---|
serviceId | Wymagany. Zdefiniowany przez użytkownika identyfikator usługi Cloud Run. |
region | Opcjonalny. Region podany przez użytkownika, w którym hostowana jest usługa Cloud Run. Domyślnie |
tag | Opcjonalny. Dostarczony przez użytkownika tag TrafficConfig, do którego można wysyłać ruch. W przypadku pominięcia ruch jest wysyłany do identyfikatora URI obejmującego całą usługę |
TrailingSlashZachowanie
Określa, czy ukośnik końcowy powinien zostać dodany, czy usunięty ze ścieżki adresu URL żądania.
Wyliczenia | |
---|---|
TRAILING_SLASH_BEHAVIOR_UNSPECIFIED | Nie określono żadnego zachowania. Pliki są udostępniane tylko w ich dokładnej lokalizacji, a końcowe ukośniki są dodawane tylko do indeksów katalogów. |
ADD | Końcowe ukośniki są dodawane do indeksów katalogów, a także do dowolnej ścieżki adresu URL, która nie kończy się rozszerzeniem pliku. |
REMOVE | Końcowe ukośniki są usuwane z indeksów katalogów, a także ze wszystkich ścieżek URL, które nie kończą się rozszerzeniem pliku. |
I18nKonfig
Jeśli jest podany, przepisywanie i18n jest włączone.
Reprezentacja JSON |
---|
{ "root": string } |
Pola | |
---|---|
root | Wymagany. Podana przez użytkownika ścieżka, w której będą wyszukiwane treści specyficzne dla kraju i języka w katalogu publicznym. |
Metody | |
---|---|
| Tworzy nową wersję w określonej witrynie docelowej przy użyciu zawartości określonej wersji. |
| Tworzy nową wersję dla określonej witryny. |
| Usuwa określoną wersję. |
| Pobierz określoną wersję utworzoną dla określonej witryny. |
| Wyświetla listę wersji utworzonych dla określonej witryny. |
| Aktualizuje określone metadane dla określonej wersji. |
| Dodaje pliki zawartości do określonej wersji. |