Approvals - Update

リファレンス

Service:: Release

API Version:: 5.0

承認の状態を更新する

PATCH https://vsrm.dev.azure.com/{organization}/{project}/_apis/release/approvals/{approvalId}?api-version=5.0

URI パラメーター

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

要求本文

名前	型	説明
approvalType	ApprovalType	承認の種類を取得または設定します。
approvedBy	IdentityRef	承認した ID を取得します。
approver	IdentityRef	承認する ID を取得または設定します。
attempt	integer	どのデプロイ試行が属するかを指定する試行を取得または設定します。
comments	string	承認のためのコメントを取得または設定します。
createdOn	string	作成された日付を取得します。
history	ReleaseApprovalHistory[]	この承認に関連付けられているすべての承認を指定する履歴を取得します。
id	integer	このフィールドの一意識別子を取得します。
isAutomated	boolean	承認が自動化されているかどうかを示す値を取得または設定します。
isNotificationOn	boolean
modifiedOn	string	変更された日付を取得します。
rank	integer	承認の順序を指定するランクを取得または設定します。たとえば、同じランクは並列承認を表します。
release	ReleaseShallowReference	この承認が関連付けられているリリースの参照を指定する releaseReference を取得します。
releaseDefinition	ReleaseDefinitionShallowReference	この承認が関連付けられているリリース定義の参照を指定する releaseDefinitionReference を取得します。
releaseEnvironment	ReleaseEnvironmentShallowReference	この承認が関連付けられているリリース環境の参照を指定する releaseEnvironmentReference を取得します。
revision	integer	リビジョン番号を取得します。
status	ApprovalStatus	承認の状態を取得または設定します。
trialNumber	integer
url	string	承認にアクセスするための URL を取得します。

応答

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

セキュリティ

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.release_manage	リリース成果物 (リリース、リリース定義、リリースエンブリオンメントなど) の読み取り、更新、削除、および新しいリリースのキューと承認を行う機能を付与します。

例

Approve a release

Sample Request

HTTP

PATCH https://vsrm.dev.azure.com/fabrikam/MyFirstProject/_apis/release/approvals/{approvalId}?api-version=5.0

{
  "status": "approved",
  "comments": "Good to go!"
}

Sample Response

Status code:: 200

{
  "id": 20,
  "revision": 1,
  "approver": {
    "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabfiber@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=4adb1680-0eac-6149-b5ee-fc8b4f6ca227"
  },
  "approvedBy": {
    "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
    "displayName": "Chuck Reinhart",
    "uniqueName": "fabfiber@outlook.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=4adb1680-0eac-6149-b5ee-fc8b4f6ca227"
  },
  "approvalType": "preDeploy",
  "createdOn": "2017-05-31T18:07:40.45Z",
  "modifiedOn": "2017-05-31T18:08:09.577Z",
  "status": "approved",
  "comments": "Good to go!",
  "isAutomated": false,
  "isNotificationOn": true,
  "trialNumber": 1,
  "attempt": 1,
  "rank": 1,
  "history": [],
  "release": {
    "id": 3,
    "name": "Release-3",
    "url": "https://https://vsrm.dev.azure.com/fabrikamMyFirstProject/_apis/Release/releases/3",
    "_links": {}
  },
  "releaseDefinition": {
    "id": 1,
    "name": "MyShuttle.CD",
    "url": "https://https://vsrm.dev.azure.com/fabrikamd07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1",
    "_links": {}
  },
  "releaseEnvironment": {
    "id": 9,
    "name": "Dev",
    "_links": {}
  },
  "url": "https://https://vsrm.dev.azure.com/fabrikamMyFirstProject/_apis/Release/approvals/20"
}

定義

名前	説明
ApprovalStatus	承認の状態を取得または設定します。
ApprovalType	承認の種類を取得または設定します。
IdentityRef
ProjectReference
ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
ReleaseApproval
ReleaseApprovalHistory
ReleaseDefinitionShallowReference
ReleaseEnvironmentShallowReference
ReleaseShallowReference

ApprovalStatus

承認の状態を取得または設定します。

名前	型	説明
approved	string
canceled	string
pending	string
reassigned	string
rejected	string
skipped	string
undefined	string

ApprovalType

承認の種類を取得または設定します。

名前	型	説明
all	string
postDeploy	string
preDeploy	string
undefined	string

IdentityRef

名前	型	説明
_links	ReferenceLinks	このフィールドには、グラフの件名に関する 0 個以上の興味深いリンクが含まれています。これらのリンクを呼び出して、このグラフの件名に関する追加のリレーションシップまたは詳細情報を取得できます。
descriptor	string	記述子は、システムの実行中にグラフの件名を参照する主な方法です。このフィールドは、アカウントと組織の両方で同じグラフの件名を一意に識別します。
directoryAlias	string
displayName	string	これは、グラフの件名の一意でない表示名です。このフィールドを変更するには、ソースプロバイダーでその値を変更する必要があります。
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	この URL は、このグラフの件名のソースリソースへの完全なルートです。

ProjectReference

名前	型	説明
id	string	このフィールドの一意識別子を取得します。
name	string	プロジェクトの名前を取得します。

ReferenceLinks

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

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

ReleaseApproval

名前	型	説明
approvalType	ApprovalType	承認の種類を取得または設定します。
approvedBy	IdentityRef	承認した ID を取得します。
approver	IdentityRef	承認する ID を取得または設定します。
attempt	integer	どのデプロイ試行が属するかを指定する試行を取得または設定します。
comments	string	承認のためのコメントを取得または設定します。
createdOn	string	作成された日付を取得します。
history	ReleaseApprovalHistory[]	この承認に関連付けられているすべての承認を指定する履歴を取得します。
id	integer	このフィールドの一意識別子を取得します。
isAutomated	boolean	承認が自動化されているかどうかを示す値を取得または設定します。
isNotificationOn	boolean
modifiedOn	string	変更された日付を取得します。
rank	integer	承認の順序を指定するランクを取得または設定します。たとえば、同じランクは並列承認を表します。
release	ReleaseShallowReference	この承認が関連付けられているリリースの参照を指定する releaseReference を取得します。
releaseDefinition	ReleaseDefinitionShallowReference	この承認が関連付けられているリリース定義の参照を指定する releaseDefinitionReference を取得します。
releaseEnvironment	ReleaseEnvironmentShallowReference	この承認が関連付けられているリリース環境の参照を指定する releaseEnvironmentReference を取得します。
revision	integer	リビジョン番号を取得します。
status	ApprovalStatus	承認の状態を取得または設定します。
trialNumber	integer
url	string	承認にアクセスするための URL を取得します。

ReleaseApprovalHistory

名前	型	説明
approver	IdentityRef
changedBy	IdentityRef
comments	string
createdOn	string
modifiedOn	string
revision	integer

ReleaseDefinitionShallowReference

名前	型	説明
_links	ReferenceLinks	リリース定義の関連リソース、API、およびビューへのリンクを取得します。
id	integer	リリース定義の一意識別子を取得します。
name	string	リリース定義の名前を取得または設定します。
path	string	リリース定義のパスを取得または設定します。
projectReference	ProjectReference	プロジェクト参照を取得または設定します。
url	string	リリース定義にアクセスするための REST API URL を取得します。

ReleaseEnvironmentShallowReference

名前	型	説明
_links	ReferenceLinks	リリース環境の関連リソース、API、およびビューへのリンクを取得します。
id	integer	リリース環境の一意識別子を取得します。
name	string	リリース環境の名前を取得または設定します。
url	string	リリース環境にアクセスするための REST API URL を取得します。

ReleaseShallowReference

名前	型	説明
_links	ReferenceLinks	リリースの関連リソース、API、およびビューへのリンクを取得します。
id	integer	リリースの一意識別子を取得します。
name	string	リリースの名前を取得または設定します。
url	string	リリースにアクセスするための REST API URL を取得します。

次の方法で共有