Repositories - List

リファレンス

Service:: Git

API Version:: 7.1-preview.1

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

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1-preview.1

With optional parameters:

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

URI パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前です。
project	path		string	プロジェクト ID またはプロジェクト名
api-version	query	True	string	使用する API のバージョン。このバージョンの API を使用するには、これを '7.1-preview.1' に設定する必要があります。
includeAllUrls	query		boolean	[省略可能]True を指定すると、すべてのリモート URL が含まれます。既定値は false です。
includeHidden	query		boolean	[省略可能]True を指定すると、非表示のリポジトリが含まれます。既定値は false です。
includeLinks	query		boolean	[省略可能]True を指定すると、参照リンクが含まれます。既定値は false です。

応答

名前	型	説明
200 OK	GitRepository[]	成功した操作

セキュリティ

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token 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

Scopes

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

例

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "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"
    }
  ]
}

定義

名前	説明
GitRepository
GitRepositoryRef
ProjectState	プロジェクトの状態。
ProjectVisibility	プロジェクトの可視性。
ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
TeamProjectCollectionReference	TeamProjectCollection の参照オブジェクト。
TeamProjectReference	TeamProject への浅い参照を表します。

GitRepository

名前	型	説明
_links	ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
defaultBranch	string
id	string
isDisabled	boolean	True を指定すると、リポジトリが無効になります。それ以外の場合は false です。
isFork	boolean	True を指定すると、リポジトリがフォークとして作成されます。
isInMaintenance	boolean	True を指定すると、リポジトリはメンテナンス中です。それ以外の場合は false です。
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	TeamProject への浅い参照を表します。
remoteUrl	string
size	integer	リポジトリの圧縮サイズ (バイト)。
sshUrl	string
url	string
validRemoteUrls	string[]
webUrl	string

GitRepositoryRef

名前	型	説明
collection	TeamProjectCollectionReference	このフォークが存在するチームプロジェクトコレクション
id	string
isFork	boolean	リポジトリがフォークとして作成された場合は True
name	string
project	TeamProjectReference	TeamProject への浅い参照を表します。
remoteUrl	string
sshUrl	string
url	string

ProjectState

プロジェクトの状態。

名前	型	説明
all	string	[削除済み] を除く状態に関係なく、すべてのプロジェクト。
createPending	string	プロジェクトは作成のためにキューに登録されていますが、プロセスはまだ開始されていません。
deleted	string	プロジェクトが削除されました。
deleting	string	プロジェクトは削除中です。
new	string	プロジェクトは作成中です。
unchanged	string	プロジェクトは変更されていません。
wellFormed	string	プロジェクトは完全に作成され、使用できる状態になります。

ProjectVisibility

プロジェクトの可視性。

名前	型	説明
private	string	プロジェクトは、明示的なアクセス権を持つユーザーにのみ表示されます。
public	string	プロジェクトはすべてのユーザーに表示されます。

ReferenceLinks

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

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

TeamProjectCollectionReference

TeamProjectCollection の参照オブジェクト。

名前	型	説明
avatarUrl	string	コレクションアバターの URL。
id	string	コレクション ID。
name	string	コレクション名。
url	string	コレクション REST URL。

TeamProjectReference

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

名前	型	説明
abbreviation	string	プロジェクトの省略形。
defaultTeamImageUrl	string	既定のチーム ID イメージへの URL。
description	string	プロジェクトの説明 (存在する場合)。
id	string	プロジェクト識別子。
lastUpdateTime	string	プロジェクトの最終更新時刻。
name	string	プロジェクト名。
revision	integer	プロジェクトリビジョン。
state	ProjectState	プロジェクトの状態。
url	string	オブジェクトの完全なバージョンへの URL。
visibility	ProjectVisibility	プロジェクトの可視性。