REST Resource: sites.versions

Kaynak: Sürüm

Version, bir sitenin nasıl görüntüleneceğini belirleyen statik dosya koleksiyonu ve yapılandırmadır.

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 şu biçimde tam nitelikli kaynak adı:

sites/SITE_ID/versions/VERSION_ID

Bu ad, versions.create adlı kullanıcıyı ç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 versions.create çağrısı yaparak yeni bir sürüm (CREATED durumu) oluşturun, ilgili sürüme istenen tüm dosyaları yükleyin, ardından sürümü FINALIZED olarak güncelleyin.

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

Ayrıca, versions.delete numaralı telefonu arayarak bir sürümün durumunu DELETED olarak değiştirebilirsiniz.
config

object (ServingConfig)

Site davranışı için yapılandırma. Bu yapılandırma firebase.json dosyasında mevcuttur.
labels

map (key: string, value: string)

Ek meta veri ve/veya filtreleme için kullanılan etiketler.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
createTime

string (Timestamp format)

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

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
createUser

object (ActingUser)

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

string (Timestamp format)

Yalnızca çıkış. Sürümün FINALIZED olduğu zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
finalizeUser

object (ActingUser)

Yalnızca çıkış. Sürüm için FINALIZED kullanıcıyı tanımlar.
deleteTime

string (Timestamp format)

Yalnızca çıkış. Sürümün DELETED olduğu zaman.

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
deleteUser

object (ActingUser)

Yalnızca çıkış. Sürüm için DELETED kullanıcıyı tanımlar.
fileCount

string (int64 format)

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

Bu değer, sürüm FINALIZED olduğunda hesaplanır.
versionBytes

string (int64 format)

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

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

Sürüm Durumu

Dağıtım yaşam döngüsünde belirli bir sürümün bilinen mevcut durumu.

Sıralamalar
VERSION_STATUS_UNSPECIFIED Varsayılan durum; kasıtlı olarak kullanılmamalıdır.
CREATED Sürüm oluşturuldu ve içerik şu anda sürüme ekleniyor.
FINALIZED Sürüme tüm içerik eklendi ve sürüm artık değiştirilemez.
DELETED Sürüm silindi.
ABANDONED Bu sürüm 12 saat içinde FINALIZED olarak güncellenmediği için otomatik olarak silindi.
EXPIRED Bu sürüm, saklanan sürüm sayısına ilişkin site tarafından yapılandırılan sınırın dışında. Bu nedenle, sürümün içeriğinin silinmesi planlandı.
CLONING Bu sürüm başka bir sürümden kopyalanıyor. Tüm içerik hâlâ kopyalanıyor.

Sunum Yapılandırması

Bir siteye gelen isteklerin içerik yayınlanmadan önce nasıl yönlendirileceği ve işlenmesi gerektiğine ilişkin yapılandırma. URL isteği yolları, yapılandırmada belirtilen URL kalıplarıyla eşleştirilir. Ardından Hosting, geçerli yapılandırmayı belirli bir öncelik sırasına göre uygular.

ziyaret edin.
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'si yoluyla eşleşmesi durumunda, belirtilen özel yanıt başlıklarını uygulamak için Hosting'i tetikleyen bir URL kalıbı belirttiği bir nesne dizisi.
redirects[]

object (Redirect)

Her kuralın, istek URL'si yoluyla eşleştirilmesi durumunda, belirtilen hedef yola bir yönlendirmeyle yanıt vermesi için Hosting'i tetikleyen bir URL kalıbı belirttiği bir nesne dizisi (yönlendirme kuralları denir).
rewrites[]

object (Rewrite)

Her kuralın, istek URL'si yoluyla eşleştirilmesi durumunda, hizmete belirtilen hedef URL verilmiş gibi yanıt vermesi için Hosting'i tetikleyen bir URL kalıbı belirttiği bir nesne dizisi (yeniden yazma kuralları olarak adlandırılır).
cleanUrls

boolean

Dosya uzantısının yüklenen dosyalardan bırakılıp bırakı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 yoluyla eşleştirilmesi durumunda, belirtilen özel yanıt başlıklarını uygulamak için Hosting'i tetikleyen bir URL kalıbı 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)

Zorunlu. Yanıta eklenecek ek üstbilgiler.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
Birleştirme alanı pattern.
Zorunlu. Bu özel yanıt başlığının uygulanıp uygulanmayacağını belirlemek için istek URL'si yoluyla eşleştirilecek dize URL kalıbı. Bash stili bir glob veya RE2 normal ifadesi olabilir.

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

string

İstek URL'si yoluyla eşleşecek kullanıcı tarafından sağlanan glob.
regex

string

İstek URL'si yoluyla eşleşecek kullanıcı tarafından sağlanan RE2 normal ifadesi.

Yönlendirme

Redirect, istek URL'si yoluyla eşleştirilmesi durumunda, belirtilen hedef yola yönlendirme ile yanıt vermesi için Hosting'i tetikleyen bir URL kalıbı 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

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

string

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

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

"glob": "/:capture*",
"statusCode": 301,
"location": "https://example.com/foo/:capture"
Birleştirme alanı pattern.
Zorunlu. Bu yönlendirmenin uygulanıp uygulanmayacağını belirlemek için istek URL'si yoluyla eşleştirilecek dize URL kalıbı. Bash stili bir glob veya RE2 normal ifadesi olabilir.

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

string

İstek URL'si yoluyla eşleşecek kullanıcı tarafından sağlanan glob.
regex

string

İstek URL'si yoluyla eşleşecek kullanıcı tarafından sağlanan RE2 normal ifadesi.

Yeniden yazma

Rewrite, istek URL'si yoluyla eşleştirilmesi durumunda Hosting'i, hizmete belirtilen hedef URL verilmiş gibi yanıt vermesi için tetikleyen bir URL kalıbı 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 Functions çağrıları için bir Cloud bölgesi belirtin. Sağlanmazsa varsayılan olarak us-central1 olur.
Birleştirme alanı pattern.
Zorunlu. Bu yeniden yazma işleminin uygulanıp uygulanmayacağını belirlemek için istek URL'si yoluyla eşleştirilecek dize URL kalıbı. Bash stili bir glob veya RE2 normal ifadesi olabilir.

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

string

İstek URL'si yoluyla eşleşecek kullanıcı tarafından sağlanan glob.
regex

string

İstek URL'si yoluyla eşleşecek kullanıcı tarafından sağlanan RE2 normal ifadesi.
Birleştirme alanı behavior.
Zorunlu. 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 yönlendirilir.

CloudRunReWrite

İstekleri bir Cloud Run hizmetine yönlendiren yapılandırılmış bir yeniden yazma işlemi. Firebase Hosting 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 bu hizmete yönlendirilen tüm istekler 404 hatası alır).

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

string

Zorunlu. 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ğlanmazsa varsayılan olarak us-central1 değerine ayarlanır.
tag

string

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

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

Sondaki Eğik Çizgi Davranışı

İstek URL'si yoluna eğik çizginin eklenip eklenmeyeceğini tanımlar.

Sıralamalar
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 Sondaki eğik çizgiler, dizin dizinlerine ve bir dosya uzantısıyla bitmeyen URL yollarına eklenir.
REMOVE Sondaki eğik çizgiler hem dizin dizinlerinden hem de dosya uzantısıyla bitmeyen URL yolundan kaldırılır.

i18nConfig

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

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

string

Zorunlu. Herkese açık 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ş 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.