Annotated Tags - Create

サービス:

Git

API バージョン:

7.1

注釈付きタグを作成します。

リポジトリには、名前と識別子の両方があります。 識別子はグローバルに一意ですが、複数のプロジェクトに同じ名前のリポジトリが含まれている場合があります。 ID でリポジトリを指定する場合は、プロジェクトを含める必要はありません。 ただし、リポジトリを名前で指定する場合は、プロジェクト (名前または ID) も指定する必要があります。

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

URI パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前。
project	path	True	string	プロジェクト ID またはプロジェクト名
repositoryId	path	True	string	リポジトリの ID または名前。
api-version	query	True	string	使用する API のバージョン。 このバージョンの API を使用するには、これを '7.1' に設定する必要があります。

要求本文

名前	型	説明
message	string	タグ付けメッセージ
name	string	注釈付きタグの名前。
objectId	string	タグの objectId (Sha1Id)。
taggedBy	GitUserDate	ユーザー情報とタグ付けの日付。
taggedObject	GitObject	タグ付けされた git オブジェクト。
url	string

応答

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

セキュリティ

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_manage	ソース コードの読み取り、更新、削除、コミット、変更セット、ブランチ、およびその他のバージョン管理成果物に関するメタデータへのアクセスを許可します。 また、コード リポジトリの作成と管理、プル要求とコード レビューの作成と管理、サービス フックを介したバージョン管理イベントに関する通知の受信を行う機能も付与されます。

例

要求のサンプル

HTTP

POST https://dev.azure.com/fabrikam/c34d5807-1734-4541-ad1c-d16e9ac1faca/_apis/git/repositories/{repositoryId}/annotatedtags?api-version=7.1

{
  "name": "v0.1-beta",
  "taggedObject": {
    "objectId": "c60be62ebf0e86b5aa01dbb98657b4b7e5905234"
  },
  "message": "First beta release"
}

応答のサンプル

状態コード:

201

{
  "name": "refs/tags/v0.1-beta",
  "objectId": "bc57849b33949a15fa3cb889bb82d9ce21d5b6ee",
  "taggedObject": {
    "objectId": "c60be62ebf0e86b5aa01dbb98657b4b7e5905234",
    "objectType": "commit"
  },
  "taggedBy": {
    "name": "Norman Paulk",
    "email": "Fabrikamfiber16@hotmail.com",
    "date": "2017-06-22T05:09:23"
  },
  "message": "First beta release",
  "url": "https://dev.azure.com/fabrikam/c34d5807-1734-4541-ad1c-d16e9ac1faca/_apis/git/repositories/ca93c3a5-87bb-4b5b-a62f-1f971d677c79/annotatedTags/bc57849b33949a15fa3cb889bb82d9ce21d5b6ee"
}

定義

名前	説明
GitAnnotatedTag	Git 注釈付きタグ。
GitObject	Git オブジェクト識別子と型情報。
GitObjectType	オブジェクトの種類 (Commit、Tree、Blob、Tag)
GitUserDate	Git 操作のユーザー情報と日付。

GitAnnotatedTag

Object

Git 注釈付きタグ。

名前	型	説明
message	string	タグ付けメッセージ
name	string	注釈付きタグの名前。
objectId	string	タグの objectId (Sha1Id)。
taggedBy	GitUserDate	ユーザー情報とタグ付けの日付。
taggedObject	GitObject	タグ付けされた git オブジェクト。
url	string

GitObject

Object

Git オブジェクト識別子と型情報。

名前	型	説明
objectId	string	オブジェクト ID (Sha1Id)。
objectType	GitObjectType	オブジェクトの種類 (Commit、Tree、Blob、Tag)

GitObjectType

列挙

オブジェクトの種類 (Commit、Tree、Blob、Tag)

値	説明
bad
blob
commit
ext2
ofsDelta
refDelta
tag
tree

GitUserDate

Object

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

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