Approvals - Update

サービス:: Approvals And Checks

API バージョン:: 7.1

承認を更新します。

PATCH https://dev.azure.com/{organization}/{project}/_apis/pipelines/approvals?api-version=7.1

URI パラメーター

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

要求本文

名前	型	説明
body	ApprovalUpdateParameters[]

応答

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

セキュリティ

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.build_execute	ビルドの結果、定義、要求など、ビルド成果物にアクセスする機能と、ビルドをキューに入れ、ビルドプロパティを更新する機能、およびサービスフックを介してビルドイベントに関する通知を受信する機能を付与します。
vso.pipelineresources_use	保護されたリソース (エージェントプール、環境、キュー、リポジトリ、セキュリティで保護されたファイル、サービス接続、変数グループ) を使用するパイプラインの要求を承認する権限を付与します。

例

要求のサンプル

HTTP

PATCH https://dev.azure.com/{organization}/{project}/_apis/pipelines/approvals?api-version=7.1

[
  {
    "approvalId": "aab27959-a5be-4ee3-97ca-f19b3602cd2f",
    "comment": "Approving",
    "status": "approved"
  }
]

応答のサンプル

状態コード:: 200

request-Context: appId=cid-v1:a892bfef-0287-4640-9f5e-cffc90fbcf94
access-Control-Expose-Headers: Request-Context

{
  "count": 1,
  "value": [
    {
      "id": "aab27959-a5be-4ee3-97ca-f19b3602cd2f",
      "steps": [
        {
          "assignedApprover": {
            "displayName": "User Name",
            "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
            "uniqueName": "uniqueName",
            "descriptor": "Descriptor"
          },
          "actualApprover": {
            "displayName": "User Name",
            "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
            "uniqueName": "uniqueName",
            "descriptor": "Descriptor"
          },
          "status": "approved",
          "comment": "Approving",
          "lastModifiedOn": "2020-11-19T09:57:54.252505Z",
          "order": 1,
          "lastModifiedBy": {
            "displayName": "User Name",
            "id": "3b3db741-9d03-4e32-a7c0-6c3dfc2013c1",
            "uniqueName": "uniqueName",
            "descriptor": "Descriptor"
          },
          "initiatedOn": "2020-11-19T09:51:16.7045043Z",
          "history": []
        }
      ],
      "status": "approved",
      "createdOn": "2020-11-19T09:51:16.703Z",
      "lastModifiedOn": "2020-11-19T09:57:54.252505Z",
      "executionOrder": "anyOrder",
      "minRequiredApprovers": 1,
      "blockedApprovers": [],
      "_links": {
        "self": {
          "href": "https://dev.azure.com/fabrikam/d6b3e0ea-8197-4dec-831b-50e2e06ff95f/_apis/pipelines/approvals/aab27959-a5be-4ee3-97ca-f19b3602cd2f"
        }
      }
    }
  ]
}

定義

名前	説明
Approval
ApprovalExecutionOrder	承認者がアクション可能になる順序。
ApprovalPermissions	承認オブジェクトに対する現在のユーザーアクセス許可。
ApprovalStatus	承認の全体的な状態。
ApprovalStep	1 つの承認ステップのデータ。
ApprovalStepHistory	1 つの承認ステップ履歴のデータ。
ApprovalUpdateParameters	承認オブジェクトまたはその個々のステップを更新するデータ。
IdentityRef
ReferenceLinks	REST 参照リンクのコレクションを表すクラス。

Approval

Object

名前	型	説明
_links	ReferenceLinks	承認オブジェクトにアクセスするためのリンクを取得します。
blockedApprovers	IdentityRef[]	承認が許可されていない ID。
createdOn	string (date-time)	承認が作成された日付。
executionOrder	ApprovalExecutionOrder	承認者がアクション可能になる順序。
id	string (uuid)	承認の一意識別子。
instructions	string	承認者の指示。
lastModifiedOn	string (date-time)	承認が最後に変更された日付。
minRequiredApprovers	integer (int32)	承認全体が承認済みと見なされるために承認する必要がある承認者の最小数。
permissions	ApprovalPermissions	承認オブジェクトに対する現在のユーザーアクセス許可。
status	ApprovalStatus	承認の全体的な状態。
steps	ApprovalStep[]	承認に関連付けられているステップの一覧。

ApprovalExecutionOrder

列挙

承認者がアクション可能になる順序。

値	説明
anyOrder	承認者が任意の順序で承認できることを示します。
inSequence	承認者が順次 (割り当てられた順序) でのみ承認できることを示します。

ApprovalPermissions

列挙

承認オブジェクトに対する現在のユーザーアクセス許可。

値	説明
none
view
update
reassign
resourceAdmin
queueBuild

ApprovalStatus

列挙

承認の全体的な状態。

値	説明
undefined
uninitiated	承認が未承認であることを示します。特定の承認者がまだアクションを実行できない場合に、順番に実行する場合に使用されます。
pending	承認が保留中であることを示します。
approved	承認が承認されたことを示します。
rejected	承認が拒否されたことを示します。
skipped	承認がスキップされたことを示します。
canceled	承認が取り消されたことを示します。
timedOut	承認がタイムアウトであることを示します。
failed
completed
all

ApprovalStep

Object

1 つの承認ステップのデータ。

名前	型	説明
actualApprover	IdentityRef	承認した ID。
assignedApprover	IdentityRef	承認する必要がある ID。
comment	string	この手順に関連付けられているコメント。
history	ApprovalStepHistory[]	承認ステップの履歴
initiatedOn	string (date-time)	このステップが開始されたタイムスタンプ。
lastModifiedBy	IdentityRef	この手順が最後に変更された ID。
lastModifiedOn	string (date-time)	このステップが最後に変更されたタイムスタンプ。
order	integer (int32)	承認者が承認を許可される順序。
permissions	ApprovalPermissions	ステップの現在のユーザーアクセス許可。
status	ApprovalStatus	この手順の現在の状態。

ApprovalStepHistory

Object

1 つの承認ステップ履歴のデータ。

名前	型	説明
assignedTo	IdentityRef	この承認が割り当てられた ID
comment	string	このステップ履歴に関連付けられているコメント。
createdBy	IdentityRef	このステップ履歴が作成された ID。
createdOn	string (date-time)	このステップ履歴が作成されたタイムスタンプ。

ApprovalUpdateParameters

Object

承認オブジェクトまたはその個々のステップを更新するデータ。

名前	型	説明
approvalId	string (uuid)	更新する承認の ID。
assignedApprover	IdentityRef	現在の承認者。
comment	string	コメントを取得または設定します。
reassignTo	IdentityRef	再割り当てされた承認者。
status	ApprovalStatus	状態を取得または設定します。

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 は、このグラフの件名のソースリソースへの完全なルートです。

ReferenceLinks

Object

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

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

フィードバック

このページはお役に立ちましたか?