列出及查看存放區

本文說明如何依完整或部分存放區 ID 搜尋及查看 Secure Source Manager 存放區。

必要的角色

如要取得搜尋存放區所需的權限，請要求管理員授予下列 IAM 角色：

• Secure Source Manager 執行個體存取者 (roles/securesourcemanager.instanceAccessor) 在 Secure Source Manager 執行個體上
• Secure Source Manager 存放區讀取者 (roles/securesourcemanager.repoReader) 在要搜尋的存放區中

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

您或許還可透過自訂角色或其他預先定義的角色取得必要權限。

注意： IAM 基本角色也可能包含搜尋存放區的權限。您不應在正式環境中授予基本角色，但可以在開發或測試環境中授予。

如要瞭解如何授予 Secure Source Manager 角色，請參閱「使用 IAM 控管存取權」和「授予使用者執行個體存取權」。

列出存放區

網頁介面

如要透過網頁介面存取 Secure Source Manager 執行個體，請將下列網址複製到瀏覽器的網址列。

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

取代下列項目：

• 將 INSTANCE_ID 替換為執行個體名稱。
• 將 PROJECT_NUMBER 換成執行個體的 Google Cloud 專案編號。如要瞭解如何識別專案，請參閱「識別專案」。
• LOCATION，其中包含執行個體的所在地區。

「我的存放區」分頁會顯示您有權查看的所有存放區。

API

如要列出執行個體中特定區域的所有存放區詳細資料，請使用下列 HTTP 方法和網址。

使用任何要求資料之前，請先替換以下項目：

• PROJECT_ID：執行 Secure Source Manager 的 Google Cloud 專案專案 ID。
• INSTANCE_ID：執行個體 ID。
• LOCATION：執行個體所在的區域。如要瞭解支援的位置，請參閱「位置」。

HTTP 方法和網址：

GET https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories?instance=projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI， 或使用 Cloud Shell，自動登入 gcloud CLI。 您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories?instance=projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。 您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories?instance=projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

{
    "repositories" : [
          {
            "createTime" : "2023-08-09T19:32:15Z",
            "instance" : "projects/012345678901/locations/us-central1/instances/my-instance",
            "name" : "projects/my-project/locations/us-central1/repositories/my-repo",
            "uris" : {
                "api" : "https://my-instance-012345678901-api.us-central1.sourcemanager.dev/v1/projects/my-project/locations/us-central1/repositories/my-repo",
                "gitHttps" : "https://my-instance-012345678901-git.us-central1.sourcemanager.dev/my-project/my-repo.git",
                "html" : "https://my-instance-012345678901.us-central1.sourcemanager.dev/my-project/my-repo"
            }
          }
    ]
}

查看特定存放區的詳細資料

如要列出單一存放區的詳細資料，請使用下列 HTTP 方法和網址。

使用任何要求資料之前，請先替換以下項目：

• PROJECT_ID：執行 Secure Source Manager 的 Google Cloud 專案專案 ID。
• LOCATION：執行個體所在的區域。如要瞭解支援的位置，請參閱「位置」。
• REPOSITORY_ID：存放區 ID。

HTTP 方法和網址：

GET https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID

如要傳送要求，請展開以下其中一個選項：

curl (Linux、macOS 或 Cloud Shell)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI， 或使用 Cloud Shell，自動登入 gcloud CLI。 您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID"

PowerShell (Windows)

注意： 下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。 您可以執行 gcloud auth list 查看目前有效的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/repositories/REPOSITORY_ID" | Select-Object -Expand Content

您應該會收到如下的 JSON 回應：

    {
      "createTime" : "2023-08-09T19:32:15Z",
      "instance" : "projects/012345678901/locations/us-central1/instances/my-instance",
      "name" : "projects/my-project/locations/us-central1/repositories/my-repo",
      "uris" : {
          "api" : "https://my-instance-012345678901-api.us-central1.sourcemanager.dev/v1/projects/my-project/locations/us-central1/repositories/my-repo",
          "gitHttps" : "https://my-instance-012345678901-git.us-central1.sourcemanager.dev/my-project/my-repo.git",
          "html" : "https://my-instance-012345678901.us-central1.sourcemanager.dev/my-project/my-repo"
      }
    }

在網頁介面中查看存放區

您可以在「我的存放區」分頁中依關鍵字搜尋存放區。

1. 在 Secure Source Manager 網頁介面中，於「Search repository names」搜尋列輸入搜尋關鍵字。

   搜尋結果會顯示存放區 ID 包含關鍵字的所有存放區。

2. 選取要查看的存放區。

   存放區頁面隨即開啟。

後續步驟

• 建立存放區。
• 授予存放區層級角色。
• 刪除存放區。