REST Resource: sites.versions

Kaynak: Sürüm

Version bir sitenin nasıl görüntüleneceğini belirleyen bir yapılandırma ve statik dosyalar topluluğudur.

JSON gösterimi
{
  "name": string,
  "status": enum (VersionStatus),
  "config": {
    object (ServingConfig)
  },
  "labels": {
    string: string,
    ...
  },
  "createTime": string,
  "createUser": {
    object (ActingUser)
  },
  "finalizeTime": string,
  "finalizeUser": {
    object (ActingUser)
  },
  "deleteTime": string,
  "deleteUser": {
    object (ActingUser)
  },
  "fileCount": string,
  "versionBytes": string
}
Alanlar
name

string

Sürüm için tam nitelikli kaynak adı, şu biçimde:

sites/ SITE_ID /versions/ VERSION_ID

Bu ad, versions.create çağırdığınızda yanıt gövdesinde sağlanır.

status

enum ( VersionStatus )

Sürümün dağıtım durumu.

Başarılı bir dağıtım için, yeni bir sürüm ( CREATED durumu) oluşturmak için versions.create çağırın, istenen tüm dosyaları sürüme yükleyin ve ardından sürümü FINALIZED durumuna güncelleyin .

Sürümü 12 saatten fazla CREATED durumunda bırakırsanız sistemin sürümü otomatik olarak ABANDONED olarak işaretleyeceğini unutmayın.

Ayrıca versions.delete çağırarak bir sürümün durumunu DELETED olarak değiştirebilirsiniz.

config

object ( ServingConfig )

Sitenin davranışına yönelik yapılandırma. Bu yapılandırma firebase.json dosyasında mevcuttur.

labels

map (key: string, value: string)

Ekstra meta veriler ve/veya filtreleme için kullanılan etiketler.

"key": value çiftleri. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

createTime

string ( Timestamp format)

Yalnızca çıktı. Sürümün oluşturulduğu zaman.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğe ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z" .

createUser

object ( ActingUser )

Yalnızca çıktı. Sürümü oluşturan kullanıcıyı tanımlar.

finalizeTime

string ( Timestamp format)

Yalnızca çıktı. Sürümün FINALIZED zaman.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğe ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z" .

finalizeUser

object ( ActingUser )

Yalnızca çıktı. Sürümü FINALIZED kullanıcıyı tanımlar.

deleteTime

string ( Timestamp format)

Yalnızca çıktı. Sürümün DELETED zamanı.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğe ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z" .

deleteUser

object ( ActingUser )

Yalnızca çıktı. Sürümü DELETED kullanıcıyı tanımlar.

fileCount

string ( int64 format)

Yalnızca çıktı. Sürümle ilişkili toplam dosya sayısı.

Bu değer, sürüm FINALIZED sonra hesaplanır.

versionBytes

string ( int64 format)

Yalnızca çıktı. Sürümün toplam depolanan bayt boyutu.

Bu değer, sürüm FINALIZED sonra hesaplanır.

SürümDurumu

Belirli bir sürümün dağıtım yaşam döngüsündeki bilinen mevcut durumu.

Numaralandırmalar
VERSION_STATUS_UNSPECIFIED Varsayılan durum; bilinçli olarak kullanılmamalıdır.
CREATED Sürüm oluşturuldu ve içerik şu anda sürüme ekleniyor.
FINALIZED Tüm içerik sürüme eklenmiştir ve sürüm artık değiştirilemez.
DELETED Sürüm silindi.
ABANDONED Sürüm 12 saat içinde FINALIZED olarak güncellenmedi ve otomatik olarak silindi.
EXPIRED Sürüm, tutulan sürümlerin sayısı için site tarafından yapılandırılmış sınırın dışında olduğundan, sürümün içeriğinin silinmesi planlandı.
CLONING Sürüm başka bir sürümden kopyalanıyor. Tüm içerik hâlâ kopyalanıyor.

Hizmet Yapılandırması

Bir siteye gelen isteklerin içerik sunulmadan önce nasıl yönlendirileceğine ve işleneceğine ilişkin yapılandırma. URL istek yolları, yapılandırmada belirtilen URL modelleriyle eşleştirilir ve ardından Hosting, geçerli yapılandırmayı belirli bir öncelik sırasına göre uygular.

JSON gösterimi
{
  "headers": [
    {
      object (Header)
    }
  ],
  "redirects": [
    {
      object (Redirect)
    }
  ],
  "rewrites": [
    {
      object (Rewrite)
    }
  ],
  "cleanUrls": boolean,
  "trailingSlashBehavior": enum (TrailingSlashBehavior),
  "i18n": {
    object (I18nConfig)
  }
}
Alanlar
headers[]

object ( Header )

Her nesnenin, istek URL yolu ile eşleştirildiğinde Hosting'i belirtilen özel yanıt başlıklarını uygulaması için tetikleyen bir URL modelini belirttiği bir nesne dizisi.

redirects[]

object ( Redirect )

Her kuralın, istek URL yolu ile eşleştirildiğinde Hosting'in belirtilen hedef yola bir yönlendirme ile yanıt vermesini tetikleyen bir URL modelini belirttiği bir nesne dizisi (yönlendirme kuralları olarak adlandırılır).

rewrites[]

object ( Rewrite )

Her kuralın, istek URL yolu ile eşleştirildiğinde, Hosting'in hizmete belirtilen hedef URL verilmiş gibi yanıt vermesini tetikleyen bir URL modelini belirttiği bir nesne dizisi (yeniden yazma kuralları olarak adlandırılır).

cleanUrls

boolean

Dosya uzantısının yüklenen dosyalardan çıkarılıp çıkarılmayacağını tanımlar.

trailingSlashBehavior

enum ( TrailingSlashBehavior )

URL yolunda sondaki eğik çizginin nasıl işleneceğini tanımlar.

i18n

object ( I18nConfig )

İsteğe bağlı. i18n yeniden yazma davranışını tanımlar.

Header , istek URL yolu ile eşleştirildiğinde Hosting'in belirtilen özel yanıt başlıklarını uygulamasını tetikleyen bir URL modelini belirtir.

JSON gösterimi
{
  "headers": {
    string: string,
    ...
  },

  // Union field pattern can be only one of the following:
  "glob": string,
  "regex": string
  // End of list of possible types for union field pattern.
}
Alanlar
headers

map (key: string, value: string)

Gerekli. Yanıta eklenecek ek başlıklar.

"key": value çiftleri. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

Birleşim alanı pattern .
Gerekli. Bu özel yanıt üstbilgisinin uygulanıp uygulanmayacağını belirlemek için istek URL yolu ile eşleştirilecek bir dize URL modeli. Bash tarzı bir glob veya RE2 düzenli ifadesi olabilir.

pattern aşağıdakilerden yalnızca biri olabilir:
glob

string

İstek URL yolu ile eşleşecek kullanıcı tarafından sağlanan küre .

regex

string

İstek URL yolu ile eşleşecek, kullanıcı tarafından sağlanan RE2 normal ifadesi.

Yönlendir

Redirect , istek URL yolu ile eşleştirildiğinde Hosting'in belirtilen hedef yola bir yönlendirme ile yanıt vermesini tetikleyen bir URL modelini belirtir.

JSON gösterimi
{
  "statusCode": integer,
  "location": string,

  // Union field pattern can be only one of the following:
  "glob": string,
  "regex": string
  // End of list of possible types for union field pattern.
}
Alanlar
statusCode

integer

Gerekli. Yanıtta döndürülecek durum HTTP kodu. Geçerli bir 3xx durum kodu olmalıdır.

location

string

Gerekli. Yanıtın HTTP konum başlığına yerleştirilecek değer.

Konum, segmenti tanımlamak için bir : öneki ve URL'nin geri kalanını yakalamak için isteğe bağlı bir * kullanarak kalıptan yakalama grubu değerlerini içerebilir. Örneğin:

"glob": "/:capture*",
"statusCode": 301,
"location": "https://example.com/foo/:capture"

Birleşim alanı pattern .
Gerekli. Bu yönlendirmenin uygulanıp uygulanmayacağını belirlemek için istek URL yolu ile eşleştirilecek bir dize URL modeli. Bash tarzı bir glob veya RE2 düzenli ifadesi olabilir.

pattern aşağıdakilerden yalnızca biri olabilir:
glob

string

İstek URL yolu ile eşleşecek kullanıcı tarafından sağlanan küre .

regex

string

İstek URL yolu ile eşleşecek, kullanıcı tarafından sağlanan RE2 normal ifadesi.

Yeniden yazmak

Rewrite , istek URL yolu ile eşleştirildiğinde Hosting'in, hizmete belirtilen hedef URL verilmiş gibi yanıt vermesini tetikleyen bir URL modelini belirtir.

JSON gösterimi
{
  "functionRegion": string,

  // Union field pattern can be only one of the following:
  "glob": string,
  "regex": string
  // End of list of possible types for union field pattern.

  // Union field behavior can be only one of the following:
  "path": string,
  "function": string,
  "run": {
    object (CloudRunRewrite)
  }
  // End of list of possible types for union field behavior.
}
Alanlar
functionRegion

string

İsteğe bağlı. Yeniden yazılan İşlev çağrıları için bir Bulut bölgesi belirtin. Sağlanmazsa, varsayılan olarak us-central1'e ayarlanır.

Birleşim alanı pattern .
Gerekli. Bu yeniden yazmanın uygulanıp uygulanmayacağını belirlemek için istek URL yolu ile eşleştirilecek bir dize URL modeli. Bash tarzı bir glob veya RE2 düzenli ifadesi olabilir.

pattern aşağıdakilerden yalnızca biri olabilir:
glob

string

İstek URL yolu ile eşleşecek kullanıcı tarafından sağlanan küre .

regex

string

İstek URL yolu ile eşleşecek, kullanıcı tarafından sağlanan RE2 normal ifadesi.

Birleşim alanı behavior .
Gerekli. Yeniden yazma davranışı.

behavior aşağıdakilerden yalnızca biri olabilir:
path

string

İsteğin yeniden yazılacağı URL yolu.

function

string

Proxy isteklerine yönelik işlev. Dışa aktarılan işlev adıyla tam olarak eşleşmelidir.

run

object ( CloudRunRewrite )

İstek Cloud Run'a iletilecek.

CloudRunYeniden Yaz

İstekleri bir Cloud Run hizmetine yönlendiren yapılandırılmış bir yeniden yazma. Firebase Barındırma yapılandırmanızı ayarlarken veya güncellerken Cloud Run hizmeti mevcut değilse istek başarısız olur. Cloud Run hizmetindeki tüm hatalar son kullanıcıya iletilir (örneğin, bir hizmeti silerseniz o hizmete yönlendirilen istekler 404 hatası alır).

JSON gösterimi
{
  "serviceId": string,
  "region": string,
  "tag": string
}
Alanlar
serviceId

string

Gerekli. Cloud Run hizmetinin kullanıcı tanımlı kimliği.

region

string

İsteğe bağlı. Cloud Run hizmetinin barındırıldığı, kullanıcı tarafından sağlanan bölge.

Sağlanmadığı takdirde varsayılan olarak us-central1 ayarlanır.

tag

string

İsteğe bağlı. Trafiğin gönderileceği kullanıcı tarafından sağlanan TrafficConfig etiketi.

Atlandığında trafik hizmet genelindeki URI'ye gönderilir

Sondaki Eğik Çizgi Davranışı

İstek URL yoluna eğik çizginin eklenmesi mi yoksa kaldırılması mı gerektiğini tanımlar.

Numaralandırmalar
TRAILING_SLASH_BEHAVIOR_UNSPECIFIED

Herhangi bir davranış belirtilmedi.

Dosyalar yalnızca tam konumlarında sunulur ve sondaki eğik çizgiler yalnızca dizin dizinlerine eklenir.

ADD Dizin indekslerine ve dosya uzantısıyla bitmeyen URL yollarına eğik çizgiler eklenir .
REMOVE Dizin indekslerinden ve dosya uzantısıyla bitmeyen URL yollarından sondaki eğik çizgiler kaldırılır .

I18nYapılandırma

Sağlanırsa i18n yeniden yazmaları etkinleştirilir.

JSON gösterimi
{
  "root": string
}
Alanlar
root

string

Gerekli. Genel dizinde ülkeye ve dile özgü içeriğin aranacağı, kullanıcı tarafından sağlanan yol.

Yöntemler

clone

Belirtilen sürümün içeriğini kullanarak belirtilen hedef sitede yeni bir sürüm oluşturur.

create

Belirtilen site için yeni bir sürüm oluşturur.

delete

Belirtilen sürümü siler.

get

Belirtilen site için oluşturulmuş olan belirtilen sürümü alın.

list

Belirtilen site için oluşturulmuş sürümleri listeler.

patch

Belirtilen sürüm için belirtilen meta verileri günceller.

populateFiles

İçerik dosyalarını belirtilen sürüme ekler.