Pull Requests - Create

サービス:

Git

API バージョン:

7.1

pull request を作成します。

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?api-version=7.1

省略可能なパラメーターを含む:

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?supportsIterations={supportsIterations}&api-version=7.1

URI パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前。
repositoryId	path	True	string	プル要求のターゲット ブランチのリポジトリ ID。
project	path		string	プロジェクト ID またはプロジェクト名
api-version	query	True	string	使用する API のバージョン。 このバージョンの API を使用するには、これを '7.1' に設定する必要があります。
supportsIterations	query		boolean	true の場合、pull request への後続のプッシュは個別に確認できます。 この機能が必要ない場合は、パフォーマンス上の理由から大きなプル要求の場合は false に設定します。

要求本文

名前	型	説明
_links	ReferenceLinks	他の関連オブジェクトへのリンク。
artifactId	string	このプル要求を一意に識別する文字列。 プル要求の成果物 ID を生成するには、次のテンプレートを使用します: vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}
autoCompleteSetBy	IdentityRef	設定すると、このプル要求に対してオートコンプリートが有効になり、これが有効になっている ID になります。
closedBy	IdentityRef	プル要求を閉じたユーザー。
closedDate	string (date-time)	pull request が閉じられた (完了、破棄、または外部でマージされた) 日付。
codeReviewId	integer (int32)	プル要求のコード レビュー ID。 内部的に使用されます。
commits	GitCommitRef[]	プル要求に含まれるコミット。
completionOptions	GitPullRequestCompletionOptions	完了時のプル要求のマージ方法に影響するオプション。
completionQueueTime	string (date-time)	pull request が完了するキューに入った最新の日付。 内部的に使用されます。
createdBy	IdentityRef	プル要求を作成したユーザーの ID。
creationDate	string (date-time)	pull request が作成された日付。
description	string	プル要求の説明。
forkSource	GitForkRef	これがフォークからの PR の場合、そのソースに関する情報が含まれます。
hasMultipleMergeBases	boolean	複数のマージベースの警告
isDraft	boolean	下書き/WIP プル要求。
labels	WebApiTagDefinition[]	プル要求に関連付けられているラベル。
lastMergeCommit	GitCommitRef	最新の pull request マージのコミット。 空の場合、最新のマージが進行中であるか、失敗しました。
lastMergeSourceCommit	GitCommitRef	最後の pull request マージ時のソース ブランチの先頭でのコミット。
lastMergeTargetCommit	GitCommitRef	最後の pull request マージ時のターゲット ブランチの先頭でのコミット。
mergeFailureMessage	string	設定した場合、この理由により pull request マージが失敗しました。
mergeFailureType	PullRequestMergeFailureType	pull request マージの失敗の種類 (存在する場合)。
mergeId	string (uuid)	pull request マージの実行に使用されるジョブの ID。 内部的に使用されます。
mergeOptions	GitPullRequestMergeOptions	プル要求のマージの実行時に使用されるオプション。 完了は 1 回だけ行われ、pull request のソース ブランチが変更されるたびに新しいマージが実行されるため、これらは完了オプションとは別です。
mergeStatus	PullRequestAsyncStatus	pull request マージの現在の状態。
pullRequestId	integer (int32)	プル要求の ID。
remoteUrl	string	内部的に使用されます。
repository	GitRepository	プル要求のターゲット ブランチを含むリポジトリ。
reviewers	IdentityRefWithVote[]	投票の状態と共に、pull request のレビュー担当者の一覧。
sourceRefName	string	プル要求のソース ブランチの名前。
status	PullRequestStatus	プル要求の状態。
supportsIterations	boolean	true の場合、この pull request は複数のイテレーションをサポートします。 イテレーションのサポートは、プル要求のソース ブランチへの個々のプッシュを確認できることを意味し、1 回のイテレーションで残されたコメントは、今後のイテレーションにわたって追跡されます。
targetRefName	string	プル要求のターゲット ブランチの名前。
title	string	プル要求のタイトル。
url	string	内部的に使用されます。
workItemRefs	ResourceRef[]	このプル要求に関連付けられている作業項目参照。

応答

名前	型	説明
200 OK	GitPullRequest	成功した操作

セキュリティ

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

スコープ

名前	説明
vso.code_write	ソース コードの読み取り、更新、削除、コミット、変更セット、ブランチ、およびその他のバージョン管理成果物に関するメタデータへのアクセスを許可します。 また、プル要求とコード レビューを作成および管理したり、サービス フックを介してバージョン管理イベントに関する通知を受信したりすることもできます。

例

要求のサンプル

HTTP

POST https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullrequests?api-version=7.1

{
  "sourceRefName": "refs/heads/npaulk/my_work",
  "targetRefName": "refs/heads/new_feature",
  "title": "A new feature",
  "description": "Adding a new feature",
  "reviewers": [
    {
      "id": "d6245f20-2af8-44f4-9451-8107cb2767db"
    }
  ]
}

応答のサンプル

状態コード:

201

{
  "repository": {
    "id": "3411ebc1-d5aa-464f-9615-0b527bc66719",
    "name": "2016_10_31",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719",
    "project": {
      "id": "a7573007-bbb3-4341-b726-0c4148a07853",
      "name": "2016_10_31",
      "description": "test project created on Halloween 2016",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/a7573007-bbb3-4341-b726-0c4148a07853",
      "state": "wellFormed",
      "revision": 7
    },
    "remoteUrl": "https://dev.azure.com/fabrikam/_git/2016_10_31"
  },
  "pullRequestId": 22,
  "codeReviewId": 22,
  "status": "active",
  "createdBy": {
    "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
    "displayName": "Normal Paulk",
    "uniqueName": "fabrikamfiber16@hotmail.com",
    "url": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
  },
  "creationDate": "2016-11-01T16:30:31.6655471Z",
  "title": "A new feature",
  "description": "Adding a new feature",
  "sourceRefName": "refs/heads/npaulk/my_work",
  "targetRefName": "refs/heads/new_feature",
  "mergeStatus": "queued",
  "mergeId": "f5fc8381-3fb2-49fe-8a0d-27dcc2d6ef82",
  "lastMergeSourceCommit": {
    "commitId": "b60280bc6e62e2f880f1b63c1e24987664d3bda3",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/b60280bc6e62e2f880f1b63c1e24987664d3bda3"
  },
  "lastMergeTargetCommit": {
    "commitId": "f47bbc106853afe3c1b07a81754bce5f4b8dbf62",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
  },
  "reviewers": [
    {
      "reviewerUrl": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/reviewers/d6245f20-2af8-44f4-9451-8107cb2767db",
      "vote": 0,
      "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
      "displayName": "Normal Paulk",
      "uniqueName": "fabrikamfiber16@hotmail.com",
      "url": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
      "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
    }
  ],
  "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22"
    },
    "repository": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719"
    },
    "workItems": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/workitems"
    },
    "sourceBranch": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/refs"
    },
    "targetBranch": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/refs"
    },
    "sourceCommit": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/b60280bc6e62e2f880f1b63c1e24987664d3bda3"
    },
    "targetCommit": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
    },
    "createdBy": {
      "href": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
    },
    "iterations": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/iterations"
    }
  },
  "supportsIterations": true,
  "artifactId": "vstfs:///Git/PullRequestId/a7573007-bbb3-4341-b726-0c4148a07853%2f3411ebc1-d5aa-464f-9615-0b527bc66719%2f22"
}

定義

名前	説明
ChangeCountDictionary
GitChange
GitCommitRef	Git コミットと関連付けられたメタデータを記述するプロパティを提供します。
GitForkRef	フォーク参照に関する情報。
GitPullRequest	プル要求に関連付けられているすべてのデータを表します。
GitPullRequestCompletionOptions	pull request を完了する方法に関する基本設定。
GitPullRequestMergeOptions	pull request マージの作成時に使用されるオプション。
GitPullRequestMergeStrategy	完了時に pull request をマージするために使用する戦略を指定します。 MergeStrategy が値に設定されていない場合、SquashMerge == false の場合、no-FF マージが作成されます。 MergeStrategy が値に設定されていない場合、SquashMerge == true の場合、pull request コミットはスカッシュされます。 SquashMerge プロパティは非推奨です。 すべてのケースで MergeStrategy を明示的に設定することをお勧めします。 MergeStrategy に明示的な値が指定されている場合、SquashMerge プロパティは無視されます。
GitPushRef
GitRepository
GitRepositoryRef
GitStatus	このクラスには、状態を投稿するサービス/拡張機能のメタデータが含まれています。
GitStatusContext	状態を一意に識別する状態コンテキスト。
GitStatusState	状態の状態。
GitTemplate
GitUserDate	Git 操作のユーザー情報と日付。
IdentityRef
IdentityRefWithVote	プル要求に対する投票を含む ID 情報。
ItemContent
ItemContentType
ProjectState	プロジェクトの状態。
ProjectVisibility	プロジェクトの可視性。
PullRequestAsyncStatus	pull request マージの現在の状態。
PullRequestMergeFailureType	pull request マージの失敗の種類 (存在する場合)。
PullRequestStatus	プル要求の状態。
ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
ResourceRef
TeamProjectCollectionReference	TeamProjectCollection の参照オブジェクト。
TeamProjectReference	TeamProject への浅い参照を表します。
VersionControlChangeType	アイテムに対して行われた変更の種類。
WebApiTagDefinition	ネットワーク経由で送信されるタグ定義の表現。

ChangeCountDictionary

Object

GitChange

Object

名前	型	説明
changeId	integer (int32)	変更のグループ内の変更の ID。
changeType	VersionControlChangeType	アイテムに対して行われた変更の種類。
item	string (T)	現在のバージョン。
newContent	ItemContent	変更後のアイテムの内容。
newContentTemplate	GitTemplate	新しい変更をプッシュするときに使用する新しいコンテンツ テンプレート。
originalPath	string	現在のパスと異なる場合は、アイテムの元のパス。
sourceServerItem	string	サーバー上の項目のパス。
url	string	アイテムを取得する URL。

GitCommitRef

Object

Git コミットと関連付けられたメタデータを記述するプロパティを提供します。

名前	型	説明
_links	ReferenceLinks	関連する REST 参照リンクのコレクション。
author	GitUserDate	コミットの作成者。
changeCounts	ChangeCountDictionary	コミットに含まれる変更の種類 (編集、削除など) の数。
changes	GitChange[]	コミットに含まれる変更の列挙。
comment	string	コミットのコメントまたはメッセージ。
commentTruncated	boolean	完全な Git コミット コメント メッセージからコメントが切り捨てられているかどうかを示します。
commitId	string	コミットの ID (SHA-1)。
commitTooManyChanges	boolean	コミットに含まれる変更が多すぎて表示できないことを示します
committer	GitUserDate	コミットのコミッター。
parents	string[]	このコミットの親コミット ID の列挙。
push	GitPushRef	このコミットに関連付けられているプッシュ。
remoteUrl	string	コミットへのリモート URL パス。
statuses	GitStatus[]	コミットに追加情報を関連付ける可能性があるサービスと拡張機能からの状態メタデータの一覧。
url	string	このリソースの REST URL。
workItems	ResourceRef[]	このコミットに関連付けられている作業項目の一覧。

GitForkRef

Object

フォーク参照に関する情報。

名前	型	説明
_links	ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
creator	IdentityRef
isLocked	boolean
isLockedBy	IdentityRef
name	string
objectId	string
peeledObjectId	string
repository	GitRepository	フォークのリポジトリ ID。
statuses	GitStatus[]	このクラスには、状態を投稿するサービス/拡張機能のメタデータが含まれています。
url	string

GitPullRequest

Object

プル要求に関連付けられているすべてのデータを表します。

名前	型	説明
_links	ReferenceLinks	他の関連オブジェクトへのリンク。
artifactId	string	このプル要求を一意に識別する文字列。 プル要求の成果物 ID を生成するには、次のテンプレートを使用します: vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}
autoCompleteSetBy	IdentityRef	設定すると、このプル要求に対してオートコンプリートが有効になり、これが有効になっている ID になります。
closedBy	IdentityRef	プル要求を閉じたユーザー。
closedDate	string (date-time)	pull request が閉じられた (完了、破棄、または外部でマージされた) 日付。
codeReviewId	integer (int32)	プル要求のコード レビュー ID。 内部的に使用されます。
commits	GitCommitRef[]	プル要求に含まれるコミット。
completionOptions	GitPullRequestCompletionOptions	完了時のプル要求のマージ方法に影響するオプション。
completionQueueTime	string (date-time)	pull request が完了するキューに入った最新の日付。 内部的に使用されます。
createdBy	IdentityRef	プル要求を作成したユーザーの ID。
creationDate	string (date-time)	pull request が作成された日付。
description	string	プル要求の説明。
forkSource	GitForkRef	これがフォークからの PR の場合、そのソースに関する情報が含まれます。
hasMultipleMergeBases	boolean	複数のマージベースの警告
isDraft	boolean	下書き/WIP プル要求。
labels	WebApiTagDefinition[]	プル要求に関連付けられているラベル。
lastMergeCommit	GitCommitRef	最新の pull request マージのコミット。 空の場合、最新のマージが進行中であるか、失敗しました。
lastMergeSourceCommit	GitCommitRef	最後の pull request マージ時のソース ブランチの先頭でのコミット。
lastMergeTargetCommit	GitCommitRef	最後の pull request マージ時のターゲット ブランチの先頭でのコミット。
mergeFailureMessage	string	設定した場合、この理由により pull request マージが失敗しました。
mergeFailureType	PullRequestMergeFailureType	pull request マージの失敗の種類 (存在する場合)。
mergeId	string (uuid)	pull request マージの実行に使用されるジョブの ID。 内部的に使用されます。
mergeOptions	GitPullRequestMergeOptions	プル要求のマージの実行時に使用されるオプション。 完了は 1 回だけ行われ、pull request のソース ブランチが変更されるたびに新しいマージが実行されるため、これらは完了オプションとは別です。
mergeStatus	PullRequestAsyncStatus	pull request マージの現在の状態。
pullRequestId	integer (int32)	プル要求の ID。
remoteUrl	string	内部的に使用されます。
repository	GitRepository	プル要求のターゲット ブランチを含むリポジトリ。
reviewers	IdentityRefWithVote[]	投票の状態と共に、pull request のレビュー担当者の一覧。
sourceRefName	string	プル要求のソース ブランチの名前。
status	PullRequestStatus	プル要求の状態。
supportsIterations	boolean	true の場合、この pull request は複数のイテレーションをサポートします。 イテレーションのサポートは、プル要求のソース ブランチへの個々のプッシュを確認できることを意味し、1 回のイテレーションで残されたコメントは、今後のイテレーションにわたって追跡されます。
targetRefName	string	プル要求のターゲット ブランチの名前。
title	string	プル要求のタイトル。
url	string	内部的に使用されます。
workItemRefs	ResourceRef[]	このプル要求に関連付けられている作業項目参照。

GitPullRequestCompletionOptions

Object

pull request を完了する方法に関する基本設定。

名前	型	説明
autoCompleteIgnoreConfigIds	integer[] (int32)	自動完了が待機しないポリシー構成 ID の一覧。 省略可能なポリシーにのみ適用されます (isBlocking == false)。 オートコンプリートは、必要なポリシーを常に待機します (isBlocking == true)。
bypassPolicy	boolean	true の場合、プル要求の完了時にポリシーが明示的にバイパスされます。
bypassReason	string	ポリシーがバイパスされる場合、バイパスが使用された理由に関してこの理由が格納されます。
deleteSourceBranch	boolean	true の場合、pull request のソース ブランチは完了後に削除されます。
mergeCommitMessage	string	設定した場合、これはマージ コミットのコミット メッセージとして使用されます。
mergeStrategy	GitPullRequestMergeStrategy	完了時に pull request をマージするために使用する戦略を指定します。 MergeStrategy が値に設定されていない場合、SquashMerge == false の場合、no-FF マージが作成されます。 MergeStrategy が値に設定されていない場合、SquashMerge == true の場合、pull request コミットはスカッシュされます。 SquashMerge プロパティは非推奨です。 すべてのケースで MergeStrategy を明示的に設定することをお勧めします。 MergeStrategy に明示的な値が指定されている場合、SquashMerge プロパティは無視されます。
squashMerge	boolean	SquashMerge は非推奨です。 MergeStrategy の値を明示的に設定する必要があります。 MergeStrategy が任意の値に設定されている場合、スカッシュマージ値は無視されます。 MergeStrategy が設定されていない場合、このフラグが false の場合はマージ戦略が早送りされず、true の場合はスカッシュになります。
transitionWorkItems	boolean	true の場合、pull request にリンクされている作業項目を次の論理状態 (アクティブ -> 解決済み) に移行しようとします。
triggeredByAutoComplete	boolean	true の場合、現在の完了試行はオートコンプリートによってトリガーされました。 内部的に使用されます。

GitPullRequestMergeOptions

Object

pull request マージの作成時に使用されるオプション。

名前	型	説明
conflictAuthorshipCommits	boolean	true の場合、マージ中に適用された競合の解決は、git の責任などに関する authorship 情報を保持するために個別のコミットに配置されます。
detectRenameFalsePositives	boolean
disableRenames	boolean	true の場合、名前の変更の検出はマージ中に実行されません。

GitPullRequestMergeStrategy

列挙

完了時に pull request をマージするために使用する戦略を指定します。 MergeStrategy が値に設定されていない場合、SquashMerge == false の場合、no-FF マージが作成されます。 MergeStrategy が値に設定されていない場合、SquashMerge == true の場合、pull request コミットはスカッシュされます。 SquashMerge プロパティは非推奨です。 すべてのケースで MergeStrategy を明示的に設定することをお勧めします。 MergeStrategy に明示的な値が指定されている場合、SquashMerge プロパティは無視されます。

値	説明
noFastForward	2 つの親、高速順方向のマージ。 ソース ブランチは変更されません。 これが既定の動作です。
rebase	ターゲット ブランチ HEAD コミットの上にソース ブランチをリベースし、ターゲット ブランチを早送りします。 ソース ブランチは、リベース操作中に更新されます。
rebaseMerge	ターゲット ブランチ HEAD コミットの上にソース ブランチをリベースし、上位 2 つの高速マージを作成します。 ソース ブランチは、リベース操作中に更新されます。
squash	プル要求からのすべての変更を単一親コミットに配置します。

GitPushRef

Object

名前	型	説明
_links	ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
date	string (date-time)
pushId	integer (int32)
pushedBy	IdentityRef
url	string

GitRepository

Object

名前	型	説明
_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

Object

名前	型	説明
collection	TeamProjectCollectionReference	このフォークが存在する Team Project Collection
id	string (uuid)
isFork	boolean	True リポジトリがフォークとして作成された場合
name	string
project	TeamProjectReference	TeamProject への浅い参照を表します。
remoteUrl	string
sshUrl	string
url	string

GitStatus

Object

このクラスには、状態を投稿するサービス/拡張機能のメタデータが含まれています。

名前	型	説明
_links	ReferenceLinks	参照リンク。
context	GitStatusContext	状態のコンテキスト。
createdBy	IdentityRef	状態を作成した ID。
creationDate	string (date-time)	状態の作成日時。
description	string	状態の説明。 通常、状態の現在の状態について説明します。
id	integer (int32)	状態識別子。
state	GitStatusState	状態の状態。
targetUrl	string	状態の詳細を含む URL。
updatedDate	string (date-time)	状態の最終更新日時。

GitStatusContext

Object

状態を一意に識別する状態コンテキスト。

名前	型	説明
genre	string	ステータスのジャンル。 通常、状態を生成するサービス/ツールの名前は空にすることができます。
name	string	状態の名前識別子を null または空にすることはできません。

GitStatusState

列挙

状態の状態。

値	説明
error	エラーが発生した状態。
failed	状態が失敗しました。
notApplicable	状態はターゲット オブジェクトには適用されません。
notSet	状態が設定されていません。 既定の状態。
pending	保留中の状態。
succeeded	状態が成功しました。

GitTemplate

Object

名前	型	説明
name	string	テンプレートの名前
type	string	テンプレートの種類

GitUserDate

Object

Git 操作のユーザー情報と日付。

名前	型	説明
date	string (date-time)	Git 操作の日付。
email	string	Git 操作を実行しているユーザーの電子メール アドレス。
imageUrl	string	ユーザーのアバターの URL。
name	string	Git 操作を実行しているユーザーの名前。

IdentityRef

Object

名前	型	説明
_links	ReferenceLinks	このフィールドには、グラフの件名に関する興味深いリンクが 0 個以上含まれています。 これらのリンクを呼び出して、このグラフの件名に関する追加のリレーションシップや詳細情報を取得できます。
descriptor	string	記述子は、システムの実行中にグラフの件名を参照する主な方法です。 このフィールドは、アカウントと組織の両方で同じグラフの件名を一意に識別します。
directoryAlias	string	非推奨 - IdentityRef "_links" ディクショナリの "自己" エントリで参照されている Graph ユーザーにクエリを実行することで取得できます
displayName	string	これは、グラフの件名の一意でない表示名です。 このフィールドを変更するには、ソース プロバイダーでその値を変更する必要があります。
id	string
imageUrl	string	非推奨 - IdentityRef "_links" ディクショナリの "アバター" エントリで使用できます
inactive	boolean	非推奨 - GraphUser "_links" ディクショナリの "membershipState" エントリで参照されている Graph メンバーシップの状態を照会することで取得できます
isAadIdentity	boolean	非推奨 - 記述子のサブジェクト型 (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) から推論できます
isContainer	boolean	非推奨 - 記述子のサブジェクト型 (Descriptor.IsGroupType) から推論できます
isDeletedInOrigin	boolean
profileUrl	string	非推奨 - ToIdentityRef の既存のほとんどの実装では使用されていません
uniqueName	string	非推奨 - 代わりに Domain+PrincipalName を使用する
url	string	この URL は、このグラフの件名のソース リソースへの完全なルートです。

IdentityRefWithVote

Object

プル要求に対する投票を含む ID 情報。

名前	型	説明
_links	ReferenceLinks	このフィールドには、グラフの件名に関する興味深いリンクが 0 個以上含まれています。 これらのリンクを呼び出して、このグラフの件名に関する追加のリレーションシップや詳細情報を取得できます。
descriptor	string	記述子は、システムの実行中にグラフの件名を参照する主な方法です。 このフィールドは、アカウントと組織の両方で同じグラフの件名を一意に識別します。
directoryAlias	string	非推奨 - IdentityRef "_links" ディクショナリの "自己" エントリで参照されている Graph ユーザーにクエリを実行することで取得できます
displayName	string	これは、グラフの件名の一意でない表示名です。 このフィールドを変更するには、ソース プロバイダーでその値を変更する必要があります。
hasDeclined	boolean	このレビュー担当者がこの pull request のレビューを拒否したかどうかを示します。
id	string
imageUrl	string	非推奨 - IdentityRef "_links" ディクショナリの "アバター" エントリで使用できます
inactive	boolean	非推奨 - GraphUser "_links" ディクショナリの "membershipState" エントリで参照されている Graph メンバーシップの状態を照会することで取得できます
isAadIdentity	boolean	非推奨 - 記述子のサブジェクト型 (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) から推論できます
isContainer	boolean	非推奨 - 記述子のサブジェクト型 (Descriptor.IsGroupType) から推論できます
isDeletedInOrigin	boolean
isFlagged	boolean	このレビュー担当者にこのプル要求に対する注意のフラグが設定されているかどうかを示します。
isReapprove	boolean	投票が変更されなかった場合でも、この承認投票を処理する必要があるかどうかを示します。
isRequired	boolean	これがこのプル要求に必要なレビュー担当者であるかどうかを示します。 ブランチには、プル要求に特定のレビュー担当者が必要なポリシーを含めることができます。
profileUrl	string	非推奨 - ToIdentityRef の既存のほとんどの実装では使用されていません
reviewerUrl	string	この ID に関する情報を取得する URL
uniqueName	string	非推奨 - 代わりに Domain+PrincipalName を使用する
url	string	この URL は、このグラフの件名のソース リソースへの完全なルートです。
vote	integer (int16)	pull request に投票する: 10 - 承認 5 - 提案 0 で承認 - 投票 -5 なし - 作成者の -10 を待つ - 却下
votedFor	IdentityRefWithVote[]	このレビュー担当者が投稿したグループまたはチーム。 グループとチームは pull request のレビュー担当者にできますが、直接投票することはできません。 グループまたはチームのメンバーが投票すると、その投票はグループまたはチームの投票にロールアップされます。 VotedFor は、このような投票の一覧です。

ItemContent

Object

名前	型	説明
content	string
contentType	ItemContentType

ItemContentType

列挙

値	説明
base64Encoded
rawText

ProjectState

列挙

プロジェクトの状態。

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

ProjectVisibility

列挙

プロジェクトの可視性。

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

PullRequestAsyncStatus

列挙

pull request マージの現在の状態。

値	説明
conflicts	競合のため、プル要求のマージに失敗しました。
failure	プル要求のマージに失敗しました。
notSet	状態が設定されていません。 既定の状態。
queued	プル要求のマージがキューに入れられます。
rejectedByPolicy	プル要求のマージがポリシーによって拒否されました。
succeeded	プル要求のマージに成功しました。

PullRequestMergeFailureType

列挙

pull request マージの失敗の種類 (存在する場合)。

値	説明
caseSensitive	大文字と小文字の不一致が原因で、プル要求のマージに失敗しました。
none	型が設定されていません。 既定の型。
objectTooLarge	オブジェクトが大きすぎるため、プル要求のマージに失敗しました。
unknown	プル要求のマージ エラーの種類が不明です。

PullRequestStatus

列挙

プル要求の状態。

値	説明
abandoned	プル要求は破棄されます。
active	プル要求がアクティブです。
all	すべての状態を含めるために pull request 検索条件で使用されます。
completed	プル要求が完了しました。
notSet	状態が設定されていません。 既定の状態。

ReferenceLinks

Object

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

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

ResourceRef

Object

名前	型	説明
id	string
url	string

TeamProjectCollectionReference

Object

TeamProjectCollection の参照オブジェクト。

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

TeamProjectReference

Object

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

名前	型	説明
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	プロジェクトの可視性。

VersionControlChangeType

列挙

アイテムに対して行われた変更の種類。

値	説明
add
all
branch
delete
edit
encoding
lock
merge
none
property
rename
rollback
sourceRename
targetRename
undelete

WebApiTagDefinition

Object

ネットワーク経由で送信されるタグ定義の表現。

名前	型	説明
active	boolean	タグ定義がアクティブかどうか。
id	string (uuid)	タグ定義の ID。
name	string	タグ定義の名前。
url	string	タグ定義のリソース URL。