Manual Interventions - Get
特定のリリースの手動介入と手動介入 ID を取得します。
GET https://vsrm.dev.azure.com/{organization}/{project}/_apis/Release/releases/{releaseId}/manualinterventions/{manualInterventionId}?api-version=7.1
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
manual
|
path | True |
integer (int32) |
手動介入の ID。 |
organization
|
path | True |
string |
Azure DevOps 組織の名前。 |
project
|
path | True |
string |
プロジェクト ID またはプロジェクト名 |
release
|
path | True |
integer (int32) |
リリースの ID。 |
api-version
|
query | True |
string |
使用する API のバージョン。 このバージョンの API を使用するには、これを '7.1' に設定する必要があります。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
成功した操作 |
セキュリティ
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.release | フォルダー、リリース、リリース定義、リリース環境など、リリース成果物を読み取る機能を付与します。 |
例
Get manual intervention
要求のサンプル
GET https://vsrm.dev.azure.com/fabrikam/A13d3daac-03b8-4a23-9cc4-2c3de65dab63/_apis/Release/releases/{releaseId}/manualinterventions/{manualInterventionId}?api-version=7.1
応答のサンプル
{
"id": 1,
"status": "pending",
"taskInstanceId": "c6500104-7b44-4188-9e1c-8a0a0714152e",
"comments": null,
"instructions": "",
"createdOn": "2017-08-28T13:11:10.007Z",
"modifiedOn": "2017-08-28T13:11:10.007Z",
"release": {
"id": 37,
"name": "Release-1",
"_links": {}
},
"releaseDefinition": {
"id": 29,
"name": "Fabrikam-web-with-MI",
"_links": {}
},
"releaseEnvironment": {
"id": 100,
"name": "PROD",
"_links": {}
},
"name": "Manual Intervention"
}
定義
名前 | 説明 |
---|---|
Identity |
|
Manual |
|
Manual |
手動介入の状態を取得または設定します。 |
Project |
|
Reference |
REST 参照リンクのコレクションを表すクラス。 |
Release |
|
Release |
|
Release |
IdentityRef
名前 | 型 | 説明 |
---|---|---|
_links |
このフィールドには、グラフの件名に関する興味深いリンクが 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 は、このグラフの件名のソース リソースへの完全なルートです。 |
ManualIntervention
名前 | 型 | 説明 |
---|---|---|
approver |
承認する必要がある ID を取得または設定します。 |
|
comments |
string |
承認のコメントを取得または設定します。 |
createdOn |
string (date-time) |
作成日を取得します。 |
id |
integer (int32) |
手動介入の一意識別子を取得します。 |
instructions |
string |
承認の手順を取得または設定します。 |
modifiedOn |
string (date-time) |
変更された日付を取得します。 |
name |
string |
名前を取得または設定します。 |
release |
手動操作の releaseReference を取得します。 |
|
releaseDefinition |
手動操作用の releaseDefinitionReference を取得します。 |
|
releaseEnvironment |
手動操作用の releaseEnvironmentReference を取得します。 |
|
status |
手動介入の状態を取得または設定します。 |
|
taskInstanceId |
string (uuid) |
タスク インスタンス識別子を取得します。 |
url |
string |
手動介入にアクセスするための URL を取得します。 |
ManualInterventionStatus
手動介入の状態を取得または設定します。
値 | 説明 |
---|---|
approved |
手動による介入が承認されます。 |
canceled |
手動による介入は取り消されます。 |
pending |
手動による介入は保留中です。 |
rejected |
手動による介入は拒否されます。 |
unknown |
手動介入には、状態が設定されていません。 |
ProjectReference
名前 | 型 | 説明 |
---|---|---|
id |
string (uuid) |
このフィールドの一意識別子を取得します。 |
name |
string |
プロジェクトの名前を取得します。 |
ReferenceLinks
REST 参照リンクのコレクションを表すクラス。
名前 | 型 | 説明 |
---|---|---|
links |
object |
リンクの読み取りビュー。 参照リンクは読み取り専用であるため、読み取り専用として公開する必要があります。 |
ReleaseDefinitionShallowReference
名前 | 型 | 説明 |
---|---|---|
_links |
リリース定義の関連リソース、API、およびビューへのリンクを取得します。 |
|
id |
integer (int32) |
リリース定義の一意識別子を取得します。 |
name |
string |
リリース定義の名前を取得または設定します。 |
path |
string |
リリース定義のパスを取得または設定します。 |
projectReference |
プロジェクト参照を取得または設定します。 |
|
url |
string |
リリース定義にアクセスするための REST API URL を取得します。 |
ReleaseEnvironmentShallowReference
名前 | 型 | 説明 |
---|---|---|
_links |
リリース環境の関連リソース、API、およびビューへのリンクを取得します。 |
|
id |
integer (int32) |
リリース環境の一意識別子を取得します。 |
name |
string |
リリース環境の名前を取得または設定します。 |
url |
string |
リリース環境にアクセスするための REST API URL を取得します。 |
ReleaseShallowReference
名前 | 型 | 説明 |
---|---|---|
_links |
リリースの関連リソース、API、およびビューへのリンクを取得します。 |
|
id |
integer (int32) |
リリースの一意識別子を取得します。 |
name |
string |
リリースの名前を取得または設定します。 |
url |
string |
リリースにアクセスするための REST API URL を取得します。 |