リポジトリの一覧表示と表示

このドキュメントでは、リポジトリ ID の全部または一部で Secure Source Manager リポジトリを検索して表示する方法について説明します。

必要なロール

リポジトリの検索に必要な権限を取得するには、次の IAM ロールを付与するよう管理者に依頼してください。

• Secure Source Manager インスタンスに対する Secure Source Manager インスタンス アクセサー （roles/securesourcemanager.instanceAccessor）
• 検索するリポジトリに対する Secure Source Manager リポジトリ閲覧者 （roles/securesourcemanager.repoReader）

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

注: IAM の基本ロールに、リポジトリを検索する権限も含まれている場合があります。本番環境では基本ロールを付与しないようにしてください。このロールは、開発環境またはテスト環境で付与してください。

Secure Source Manager のロールの付与については、IAM によるアクセス制御とユーザーにインスタンスへのアクセス権を付与するをご覧ください。

リポジトリの一覧表示

ウェブ インターフェース

ウェブ インターフェースから Secure Source Manager インスタンスにアクセスするには、次の URL をブラウザのアドレスバーにコピーします。

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

次のように置き換えます。

• INSTANCE_ID は、インスタンス名に置き換えます。
• PROJECT_NUMBER は、インスタンスの Google Cloudプロジェクト番号に置き換えます。プロジェクトの識別については、プロジェクトの識別をご覧ください。
• LOCATION は、インスタンスのリージョンに置き換えます。

[マイ リポジトリ] タブには、閲覧権限のあるすべてのリポジトリが表示されます。

API

インスタンスの特定のリージョンにあるすべてのリポジトリの詳細を一覧表示するには、次の HTTP メソッドと URL を使用します。

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT_ID: Secure Source Manager が実行されている Google Cloud プロジェクトのプロジェクト ID。
• INSTANCE_ID: インスタンス ID。
• LOCATION: インスタンスが配置されているリージョン。サポートされているロケーションについては、ロケーションをご覧ください。

HTTP メソッドと URL:

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 メソッドと URL を使用します。

リクエストのデータを使用する前に、次のように置き換えます。

• PROJECT_ID: Secure Source Manager が実行されている Google Cloud プロジェクトのプロジェクト ID。
• LOCATION: インスタンスが配置されているリージョン。サポートされているロケーションについては、ロケーションをご覧ください。
• REPOSITORY_ID: リポジトリ ID。

HTTP メソッドと URL:

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 ウェブ インターフェースの [リポジトリ名を検索] 検索バーに、検索キーワードを入力します。

   検索結果には、リポジトリ ID にキーワードが含まれているすべてのリポジトリが表示されます。

2. 表示するリポジトリを選択します。

   リポジトリのページが開きます。

次のステップ

• リポジトリを作成する
• リポジトリ レベルのロールを付与する。
• リポジトリを削除する。