Repositories - List

Git リポジトリを取得します。

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1
GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?includeLinks={includeLinks}&includeAllUrls={includeAllUrls}&includeHidden={includeHidden}&api-version=7.1

URI パラメーター

Name / 必須 型 説明
organization
path True

string

Azure DevOps 組織の名前。

project
path

string

プロジェクト ID またはプロジェクト名

api-version
query True

string

使用する API のバージョン。 このバージョンの API を使用するには、これを '7.1' に設定する必要があります。

includeAllUrls
query

boolean

[省略可能]True を指定すると、すべてのリモート URL が含まれます。 既定値は false です。

includeHidden
query

boolean

[省略可能]True を指定すると、非表示のリポジトリが含まれます。 既定値は false です。

includeLinks
query

boolean

[省略可能]参照リンクを含める場合は True。 既定値は false です。

応答

Name 型 説明
200 OK

GitRepository[]

成功した操作

セキュリティ

oauth2

型: oauth2
フロー: accessCode
Authorization URL (承認 URL): https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL (トークン URL): https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

スコープ

Name 説明
vso.code コミット、変更セット、ブランチ、およびその他のバージョン管理成果物に関するソース コードとメタデータを読み取る機能を付与します。 また、コードを検索し、サービス フックを使用してバージョン管理イベントに関する通知を受け取る機能も付与されます。

例

要求のサンプル

GET https://dev.azure.com/fabrikam/_apis/git/repositories?api-version=7.1

応答のサンプル

{
  "count": 3,
  "value": [
    {
      "id": "5febef5a-833d-4e14-b9c0-14cb638f91e6",
      "name": "AnotherRepository",
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6",
      "project": {
        "id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
        "name": "Fabrikam-Fiber-Git",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
        "state": "wellFormed"
      },
      "remoteUrl": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_git/AnotherRepository"
    },
    {
      "id": "278d5cd2-584d-4b63-824a-2ba458937249",
      "name": "Fabrikam-Fiber-Git",
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249",
      "project": {
        "id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
        "name": "Fabrikam-Fiber-Git",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
        "state": "wellFormed"
      },
      "defaultBranch": "refs/heads/master",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git"
    },
    {
      "id": "66efb083-777a-4cac-a350-a24b046be6be",
      "name": "TestGit",
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/66efb083-777a-4cac-a350-a24b046be6be",
      "project": {
        "id": "281f9a5b-af0d-49b4-a1df-fe6f5e5f84d0",
        "name": "TestGit",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/281f9a5b-af0d-49b4-a1df-fe6f5e5f84d0",
        "state": "wellFormed"
      },
      "defaultBranch": "refs/heads/master",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/TestGit"
    }
  ]
}

定義

Name 説明
GitRepository
GitRepositoryRef
ProjectState

プロジェクトの状態。

ProjectVisibility

プロジェクトの可視性。

ReferenceLinks

REST 参照リンクのコレクションを表すクラス。

TeamProjectCollectionReference

TeamProjectCollection の参照オブジェクト。

TeamProjectReference

TeamProject への浅い参照を表します。

GitRepository

Name 型 説明
_links

ReferenceLinks

REST 参照リンクのコレクションを表すクラス。

defaultBranch

string

id

string (uuid)

isDisabled

boolean

True の 場合は、リポジトリが無効です。 それ以外の場合は False。

isFork

boolean

True の 場合は、リポジトリがフォークとして作成されました。

isInMaintenance

boolean

True の 場合は、リポジトリがメンテナンス中です。 それ以外の場合は False。

name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

TeamProject への浅い参照を表します。

remoteUrl

string

size

integer (int64)

リポジトリの圧縮サイズ (バイト)。

sshUrl

string

url

string

validRemoteUrls

string[]

webUrl

string

GitRepositoryRef

Name 型 説明
collection

TeamProjectCollectionReference

このフォークが存在する Team Project Collection

id

string (uuid)

isFork

boolean

True リポジトリがフォークとして作成された場合

name

string

project

TeamProjectReference

TeamProject への浅い参照を表します。

remoteUrl

string

sshUrl

string

url

string

ProjectState

プロジェクトの状態。

値 説明
deleting

プロジェクトは削除中です。

new

プロジェクトは作成中です。

wellFormed

プロジェクトが完全に作成され、使用する準備が整いました。

createPending

プロジェクトは作成のためにキューに登録されていますが、プロセスはまだ開始されていません。

all

[削除済み] を除く、状態に関係なく、すべてのプロジェクト。

unchanged

プロジェクトは変更されていません。

deleted

プロジェクトが削除されました。

ProjectVisibility

プロジェクトの可視性。

値 説明
private

プロジェクトは、明示的なアクセス権を持つユーザーにのみ表示されます。

public

プロジェクトはすべてのユーザーに表示されます。

REST 参照リンクのコレクションを表すクラス。

Name 型 説明
links

object

リンクの読み取りビュー。 参照リンクは読み取り専用であるため、読み取り専用として公開する必要があります。

TeamProjectCollectionReference

TeamProjectCollection の参照オブジェクト。

Name 型 説明
avatarUrl

string

コレクションアバターの URL。

id

string (uuid)

コレクション ID。

name

string

コレクション名。

url

string

コレクション REST URL。

TeamProjectReference

TeamProject への浅い参照を表します。

Name 型 説明
abbreviation

string

プロジェクトの省略形。

defaultTeamImageUrl

string

既定のチーム ID イメージの URL。

description

string

プロジェクトの説明 (ある場合)。

id

string (uuid)

プロジェクト識別子。

lastUpdateTime

string (date-time)

プロジェクトの最終更新時刻。

name

string

プロジェクト名。

revision

integer (int64)

プロジェクトのリビジョン。

state

ProjectState

プロジェクトの状態。

url

string

オブジェクトの完全なバージョンへの URL。

visibility

ProjectVisibility

プロジェクトの可視性。