Method: sites.versions.list

列出已為指定網站建立的版本。

這份清單包含預設 live 版本以及指定網站任何有效預覽管道的版本。

HTTP 要求

GET https://firebasehosting.googleapis.com/v1beta1/{parent=sites/*}/versions

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

執行個體類型，要列出版本的網站或管道，格式如下：

  • sites/SITE_ID

  • sites/SITE_ID/channels/CHANNEL_ID

查詢參數

參數
pageSize

integer

要傳回的版本數量上限。

如果存在的版本數量少於這個上限，服務可能會傳回較小的數字。
如果未指定，則預設值為 25。值的上限為 100；超過 100 個值會強制轉換為 100。
pageToken

string

先前呼叫 versions.list 的權杖，用於指示伺服器要在哪個位置繼續列出內容。
filter

string

篩選器字串，用來在回應中傳回部分版本。

目前支援的篩選欄位為：name、status 和 createTime。進一步瞭解 Google 的 AIP 160 標準篩選功能。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "versions": [
    {
      object (Version)
    }
  ],
  "nextPageToken": string
}
欄位
versions[]

object (Version)

版本清單 (如果有的話)。
nextPageToken

string

如果此回應中的結果中包含更多結果，則分頁符記。

請在下次呼叫 versions.list 時加入這個權杖。頁面符記僅有效期，請勿儲存。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/firebase.hosting.readonly
  • https://www.googleapis.com/auth/firebase.hosting
  • https://www.googleapis.com/auth/firebase.readonly
  • https://www.googleapis.com/auth/firebase
  • https://www.googleapis.com/auth/cloud-platform.read-only
  • https://www.googleapis.com/auth/cloud-platform

詳情請參閱驗證總覽一文。