Definitions - Create

リファレンス

Service:: Release

API Version:: 7.1-preview.4

リリース定義の作成

POST https://vsrm.dev.azure.com/{organization}/{project}/_apis/release/definitions?api-version=7.1-preview.4

URI パラメーター

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

要求本文

名前	型	説明
_links	ReferenceLinks	リリース定義の関連リソース、API、およびビューへのリンクを取得します。
artifacts	Artifact[]	成果物の一覧を取得または設定します。
comment	string	コメントを取得または設定します。
createdBy	IdentityRef	作成した ID を取得または設定します。
createdOn	string	作成された日付を取得します。
description	string	説明を取得または設定します。
environments	ReleaseDefinitionEnvironment[]	環境の一覧を取得または設定します。
id	integer	リリース定義の一意識別子を取得します。
isDeleted	boolean	リリース定義が削除されるかどうか。
lastRelease	ReleaseReference	最後のリリースの参照を取得します。
modifiedBy	IdentityRef	変更した ID を取得または設定します。
modifiedOn	string	変更された日付を取得します。
name	string	リリース定義の名前を取得または設定します。
path	string	リリース定義のパスを取得または設定します。
projectReference	ProjectReference	プロジェクト参照を取得または設定します。
properties	PropertiesCollection	プロパティを取得または設定します。
releaseNameFormat	string	リリース名の形式を取得または設定します。
revision	integer	リビジョン番号を取得します。
source	ReleaseDefinitionSource	リリース定義のソースを取得または設定します。
tags	string[]	タグの一覧を取得または設定します。
triggers	ReleaseTriggerBase[]	トリガーの一覧を取得または設定します。
url	string	リリース定義にアクセスするための REST API URL を取得します。
variableGroups	integer[]	変数グループの一覧を取得または設定します。
variables	<string, ConfigurationVariableValue>	変数のディクショナリを取得または設定します。

応答

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

セキュリティ

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_execute	フォルダー、リリース、リリース定義、リリース環境、新しいリリースをキューに登録する機能など、リリース成果物の読み取りと更新を行う機能を付与します。

例

Create release definition

Sample Request

HTTP

POST https://vsrm.dev.azure.com/{organization}/{project}/_apis/release/definitions?api-version=7.1-preview.4

{
  "source": "undefined",
  "revision": 1,
  "description": null,
  "createdBy": null,
  "createdOn": "0001-01-01T00:00:00",
  "modifiedBy": null,
  "modifiedOn": "0001-01-01T00:00:00",
  "isDeleted": false,
  "variables": {},
  "variableGroups": [],
  "environments": [
    {
      "id": 0,
      "name": "PROD",
      "variables": {},
      "variableGroups": [],
      "preDeployApprovals": {
        "approvals": [
          {
            "rank": 1,
            "isAutomated": false,
            "isNotificationOn": false,
            "approver": {
              "displayName": null,
              "id": "aeb95c63-4fac-4948-84ce-711b0a9dda97"
            },
            "id": 0
          }
        ]
      },
      "postDeployApprovals": {
        "approvals": [
          {
            "rank": 1,
            "isAutomated": true,
            "isNotificationOn": false,
            "id": 0
          }
        ]
      },
      "deployPhases": [
        {
          "deploymentInput": {
            "parallelExecution": {
              "parallelExecutionType": "none"
            },
            "skipArtifactsDownload": false,
            "artifactsDownloadInput": {},
            "queueId": 15,
            "demands": [],
            "enableAccessToken": false,
            "timeoutInMinutes": 0,
            "jobCancelTimeoutInMinutes": 1,
            "condition": "succeeded()",
            "overrideInputs": {}
          },
          "rank": 1,
          "phaseType": "agentBasedDeployment",
          "name": "Run on agent",
          "workflowTasks": []
        }
      ],
      "environmentOptions": {
        "emailNotificationType": "OnlyOnFailure",
        "emailRecipients": "release.environment.owner;release.creator",
        "skipArtifactsDownload": false,
        "timeoutInMinutes": 0,
        "enableAccessToken": false,
        "publishDeploymentStatus": false,
        "badgeEnabled": false,
        "autoLinkWorkItems": false,
        "pullRequestDeploymentEnabled": false
      },
      "demands": [],
      "conditions": [],
      "executionPolicy": {
        "concurrencyCount": 0,
        "queueDepthCount": 0
      },
      "schedules": [],
      "retentionPolicy": {
        "daysToKeep": 30,
        "releasesToKeep": 3,
        "retainBuild": true
      },
      "properties": {},
      "preDeploymentGates": {
        "id": 0,
        "gatesOptions": null,
        "gates": []
      },
      "postDeploymentGates": {
        "id": 0,
        "gatesOptions": null,
        "gates": []
      },
      "environmentTriggers": []
    }
  ],
  "artifacts": [],
  "triggers": [],
  "releaseNameFormat": null,
  "tags": [],
  "properties": {},
  "id": 0,
  "name": "Fabrikam-web",
  "projectReference": null,
  "_links": {}
}

Sample Response

Status code:: 200

{
  "source": "restApi",
  "revision": 1,
  "description": null,
  "createdBy": {
    "displayName": "Chuck Reinhart",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/aeb95c63-4fac-4948-84ce-711b0a9dda97",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aad.YjYxMjE5ZWQtODEwYS03OTU3LWJjYzAtMjQ0YTI5ZDk0ZjFl"
      }
    },
    "id": "aeb95c63-4fac-4948-84ce-711b0a9dda97",
    "uniqueName": "fabfiber@outlook.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=aeb95c63-4fac-4948-84ce-711b0a9dda97",
    "descriptor": "aad.YjYxMjE5ZWQtODEwYS03OTU3LWJjYzAtMjQ0YTI5ZDk0ZjFl"
  },
  "createdOn": "2018-12-11T04:56:42.237Z",
  "modifiedBy": {
    "displayName": "Chuck Reinhart",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/aeb95c63-4fac-4948-84ce-711b0a9dda97",
    "_links": {
      "avatar": {
        "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aad.YjYxMjE5ZWQtODEwYS03OTU3LWJjYzAtMjQ0YTI5ZDk0ZjFl"
      }
    },
    "id": "aeb95c63-4fac-4948-84ce-711b0a9dda97",
    "uniqueName": "fabfiber@outlook.com",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=aeb95c63-4fac-4948-84ce-711b0a9dda97",
    "descriptor": "aad.YjYxMjE5ZWQtODEwYS03OTU3LWJjYzAtMjQ0YTI5ZDk0ZjFl"
  },
  "modifiedOn": "2018-12-11T04:56:42.237Z",
  "isDeleted": false,
  "variables": {},
  "variableGroups": [],
  "environments": [
    {
      "id": 42,
      "name": "PROD",
      "rank": 1,
      "owner": {
        "displayName": "Chuck Reinhart",
        "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/aeb95c63-4fac-4948-84ce-711b0a9dda97",
        "_links": {
          "avatar": {
            "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aad.YjYxMjE5ZWQtODEwYS03OTU3LWJjYzAtMjQ0YTI5ZDk0ZjFl"
          }
        },
        "id": "aeb95c63-4fac-4948-84ce-711b0a9dda97",
        "uniqueName": "fabfiber@outlook.com",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=aeb95c63-4fac-4948-84ce-711b0a9dda97",
        "descriptor": "aad.YjYxMjE5ZWQtODEwYS03OTU3LWJjYzAtMjQ0YTI5ZDk0ZjFl"
      },
      "variables": {},
      "variableGroups": [],
      "preDeployApprovals": {
        "approvals": [
          {
            "rank": 1,
            "isAutomated": false,
            "isNotificationOn": false,
            "approver": {
              "displayName": "Chuck Reinhart",
              "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/aeb95c63-4fac-4948-84ce-711b0a9dda97",
              "_links": {
                "avatar": {
                  "href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aad.YjYxMjE5ZWQtODEwYS03OTU3LWJjYzAtMjQ0YTI5ZDk0ZjFl"
                }
              },
              "id": "aeb95c63-4fac-4948-84ce-711b0a9dda97",
              "uniqueName": "fabfiber@outlook.com",
              "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=aeb95c63-4fac-4948-84ce-711b0a9dda97",
              "descriptor": "aad.YjYxMjE5ZWQtODEwYS03OTU3LWJjYzAtMjQ0YTI5ZDk0ZjFl"
            },
            "id": 124
          }
        ],
        "approvalOptions": {
          "requiredApproverCount": 0,
          "releaseCreatorCanBeApprover": true,
          "autoTriggeredAndPreviousEnvironmentApprovedCanBeSkipped": false,
          "enforceIdentityRevalidation": false,
          "timeoutInMinutes": 0,
          "executionOrder": "beforeGates"
        }
      },
      "deployStep": {
        "id": 125
      },
      "postDeployApprovals": {
        "approvals": [
          {
            "rank": 1,
            "isAutomated": true,
            "isNotificationOn": false,
            "id": 126
          }
        ]
      },
      "deployPhases": [
        {
          "deploymentInput": {
            "parallelExecution": {
              "parallelExecutionType": "none"
            },
            "skipArtifactsDownload": false,
            "artifactsDownloadInput": {
              "downloadInputs": []
            },
            "queueId": 15,
            "demands": [],
            "enableAccessToken": false,
            "timeoutInMinutes": 0,
            "jobCancelTimeoutInMinutes": 1,
            "condition": "succeeded()",
            "overrideInputs": {}
          },
          "rank": 1,
          "phaseType": "agentBasedDeployment",
          "name": "Run on agent",
          "refName": null,
          "workflowTasks": []
        }
      ],
      "environmentOptions": {
        "emailNotificationType": "OnlyOnFailure",
        "emailRecipients": "release.environment.owner;release.creator",
        "skipArtifactsDownload": false,
        "timeoutInMinutes": 0,
        "enableAccessToken": false,
        "publishDeploymentStatus": false,
        "badgeEnabled": false,
        "autoLinkWorkItems": false,
        "pullRequestDeploymentEnabled": false
      },
      "demands": [],
      "conditions": [],
      "executionPolicy": {
        "concurrencyCount": 0,
        "queueDepthCount": 0
      },
      "schedules": [],
      "currentRelease": {
        "id": 0,
        "url": "https://vsrm.dev.azure.com/fabrikam/42fa3371-9e49-4858-8f49-9d4f2d0b32e8/_apis/Release/releases/0",
        "_links": {}
      },
      "retentionPolicy": {
        "daysToKeep": 30,
        "releasesToKeep": 3,
        "retainBuild": true
      },
      "properties": {},
      "preDeploymentGates": {
        "id": 0,
        "gatesOptions": null,
        "gates": []
      },
      "postDeploymentGates": {
        "id": 0,
        "gatesOptions": null,
        "gates": []
      },
      "environmentTriggers": [],
      "badgeUrl": "https://vsrm.dev.azure.com/fabrikam/_apis/public/Release/badge/42fa3371-9e49-4858-8f49-9d4f2d0b32e8/42/42"
    }
  ],
  "artifacts": [],
  "triggers": [],
  "releaseNameFormat": "",
  "tags": [],
  "properties": {},
  "id": 42,
  "name": "Fabrikam-web",
  "path": "\\",
  "projectReference": null,
  "url": "https://vsrm.dev.azure.com/fabrikam/42fa3371-9e49-4858-8f49-9d4f2d0b32e8/_apis/Release/definitions/42",
  "_links": {
    "self": {
      "href": "https://vsrm.dev.azure.com/fabrikam/42fa3371-9e49-4858-8f49-9d4f2d0b32e8/_apis/Release/definitions/42"
    },
    "web": {
      "href": "https://dev.azure.com/fabrikam/42fa3371-9e49-4858-8f49-9d4f2d0b32e8/_release?definitionId=42"
    }
  }
}

定義

名前	説明
ApprovalExecutionOrder	承認の実行順序。
ApprovalOptions
Artifact
ArtifactSourceReference
AuthorizationHeader
Condition
ConditionType	条件の種類を取得または設定します。
ConfigurationVariableValue
DataSourceBindingBase	サービスエンドポイント要求のデータソースのバインドを表します。
Demand
DeployPhase
DeployPhaseTypes	展開フェーズの種類を示します。
EnvironmentExecutionPolicy	Release Management側キューでの環境キューに関するポリシーを定義します。説明されているポリシーが満たされている場合にのみ、環境ランナー [事前デプロイとその他の手順の作成] に送信します。
EnvironmentOptions
EnvironmentRetentionPolicy
EnvironmentTrigger
EnvironmentTriggerType	トリガーの種類を取得または設定します。
IdentityRef
ProcessParameters
ProjectReference
PropertiesCollection	クラスは、キーと値のペアのコレクションとしてプロパティバッグを表します。を除くすべてのプリミティブ型 (を持つ任意の `TypeCode != TypeCode.Object`型) の `DBNull` 値が受け入れられます。 Byte[]、Int32、Double、DateType、String 型の値は型を保持し、他のプリミティブは String として再チューニングされます。 Byte[] は base64 でエンコードされた文字列として必要です。
ReferenceLinks	REST 参照リンクのコレクションを表すクラス。
ReleaseDefinition
ReleaseDefinitionApprovals
ReleaseDefinitionApprovalStep
ReleaseDefinitionDeployStep
ReleaseDefinitionEnvironment
ReleaseDefinitionGate
ReleaseDefinitionGatesOptions
ReleaseDefinitionGatesStep
ReleaseDefinitionShallowReference
ReleaseDefinitionSource	リリース定義のソースを取得または設定します。
ReleaseReason	リリースの理由を取得します。
ReleaseReference
ReleaseSchedule
ReleaseShallowReference
ReleaseTriggerBase
ReleaseTriggerType	リリーストリガーの種類。
ScheduleDays	リリースする曜日。
TaskInputDefinitionBase
TaskInputValidation
TaskSourceDefinitionBase
WorkflowTask

ApprovalExecutionOrder

承認の実行順序。

名前	型	説明
afterGatesAlways	string	ゲートの実行後に常に表示される承認。
afterSuccessfulGates	string	ゲートの正常な実行後に表示される承認。
beforeGates	string	ゲートの前に表示される承認。

ApprovalOptions

名前	型	説明
autoTriggeredAndPreviousEnvironmentApprovedCanBeSkipped	boolean	同じ承認者が前のステージを承認した場合に、承認をスキップできるかどうかを指定します。
enforceIdentityRevalidation	boolean	承認を完了する前に、承認者の ID を再検証するかどうかを指定します。
executionOrder	ApprovalExecutionOrder	承認の実行順序。
releaseCreatorCanBeApprover	boolean	リリースまたは展開を要求するユーザーが承認者に許可するかどうかを指定します。
requiredApproverCount	integer	リリースを先に進めるために必要な承認の数。 '0' は、すべての承認が必要です。
timeoutInMinutes	integer	承認のタイムアウト。承認の既定のタイムアウトは 30 日です。許可される最大タイムアウトは 365 日です。 '0' は、既定のタイムアウト (つまり 30 日) を意味します。

Artifact

名前	型	説明
alias	string	エイリアスを取得または設定します。
definitionReference	<string, ArtifactSourceReference>	定義参照を取得または設定します。例: {"project":{"id":"fed755ea-49c5-4399-acea-fd5b5aa90a6c","name":"myProject"},"definition":{"id":"1","name":"mybuildDefinition"},"connection":{"id":"1","name":"myConnection"}}
isPrimary	boolean	成果物がプライマリかどうかを示します。
isRetained	boolean	成果物がリリースによって保持されるかどうかを示します。
type	string	型を取得または設定します。値には、'Build'、'Jenkins'、'GitHub'、'Nuget'、'Team Build (external)'、'ExternalTFSBuild'、'Git'、'TFVC'、'ExternalTfsXamlBuild' を指定できます。

ArtifactSourceReference

名前	型	説明
id	string	成果物ソースの ID。
name	string	成果物ソースの名前。

AuthorizationHeader

名前	型	説明
name	string
value	string

Condition

名前	型	説明
conditionType	ConditionType	条件の種類を取得または設定します。
name	string	条件の名前を取得または設定します。たとえば、'ReleaseStarted' などです。
value	string	条件の値を取得または設定します。

ConditionType

条件の種類を取得または設定します。

名前	型	説明
artifact	string	条件の種類は成果物です。
environmentState	string	条件の種類は環境の状態です。
event	string	条件の種類は event です。
undefined	string	条件の種類は未定義です。

ConfigurationVariableValue

名前	型	説明
allowOverride	boolean	デプロイ時に変数をオーバーライドできるかどうかを取得および設定します。
isSecret	boolean	変数がシークレットかどうかを取得または設定します。
value	string	構成変数の値を取得および設定します。

DataSourceBindingBase

サービスエンドポイント要求のデータソースのバインドを表します。

名前	型	説明
callbackContextTemplate	string	このデータソースでサポートされている改ページ位置の形式 (ContinuationToken/SkipTop)。
callbackRequiredTemplate	string	後続の呼び出しが必要ですか?
dataSourceName	string	データソースの名前を取得または設定します。
endpointId	string	エンドポイント ID を取得または設定します。
endpointUrl	string	サービスエンドポイントの URL を取得または設定します。
headers	AuthorizationHeader[]	承認ヘッダーを取得または設定します。
initialContextTemplate	string	クエリパラメーターの初期値を定義します
parameters	object	データソースのパラメーターを取得または設定します。
requestContent	string	http 要求本文を取得または設定します
requestVerb	string	http 要求動詞を取得または設定します
resultSelector	string	結果セレクターを取得または設定します。
resultTemplate	string	結果テンプレートを取得または設定します。
target	string	データソースのターゲットを取得または設定します。

Demand

名前	型	説明
name	string	需要の名前を取得および設定します。
value	string	需要の値を取得および設定します。

DeployPhase

名前	型	説明
name	string	展開フェーズの名前を取得および設定します。
phaseType	DeployPhaseTypes	展開フェーズの種類を示します。
rank	integer	デプロイフェーズのランクを取得および設定します。
refName	string	展開フェーズの参照名を取得および設定します。
workflowTasks	WorkflowTask[]	展開フェーズのワークフロータスクを取得および設定します。

DeployPhaseTypes

展開フェーズの種類を示します。

名前	型	説明
agentBasedDeployment	string	エージェントで実行されるタスクを含むフェーズの種類。
deploymentGates	string	デプロイを進めるゲートとして機能するタスクを含むフェーズの種類。
machineGroupBasedDeployment	string	展開グループコンピューターで実行されるタスクを含むフェーズの種類。
runOnServer	string	サーバーによって実行されるタスクを含むフェーズの種類。
undefined	string	フェーズの種類が定義されていません。これは使用しないでください。

EnvironmentExecutionPolicy

Release Management側キューでの環境キューに関するポリシーを定義します。説明されているポリシーが満たされている場合にのみ、環境ランナー [事前デプロイとその他の手順の作成] に送信します。

名前	型	説明
concurrencyCount	integer	このポリシーでは、環境ランナーを使用する環境の数を決定します。
queueDepthCount	integer	EnvironmentQueue テーブル内のキューの深さ。このテーブルでは、環境ランナーが (ポリシーに従って) 別の環境を実行するための空き時間になるまで環境エントリを保持します。

EnvironmentOptions

名前	型	説明
autoLinkWorkItems	boolean	自動リンクの作業項目を取得および設定します。
badgeEnabled	boolean	バッジが有効かどうかを取得および設定します。
publishDeploymentStatus	boolean	発行の展開の状態を取得および設定します。
pullRequestDeploymentEnabled	boolean	取得し、 .pull request 展開が有効かどうかを設定します。

EnvironmentRetentionPolicy

名前	型	説明
daysToKeep	integer	環境を保持する日数を取得および設定します。
releasesToKeep	integer	保持するリリースの数を取得および設定します。
retainBuild	boolean	保持するビルドとしてを取得および設定します。

EnvironmentTrigger

名前	型	説明
definitionEnvironmentId	integer	このトリガーが適用される定義環境 ID。
releaseDefinitionId	integer	このトリガーが適用される ReleaseDefinition ID。
triggerContent	string	トリガーの内容を取得または設定します。
triggerType	EnvironmentTriggerType	トリガーの種類を取得または設定します。

EnvironmentTriggerType

トリガーの種類を取得または設定します。

名前	型	説明
deploymentGroupRedeploy	string	環境トリガーの種類は、デプロイグループの再デプロイです。
rollbackRedeploy	string	環境トリガーの種類は Rollback です。
undefined	string	環境トリガーの種類は未定義です。

IdentityRef

名前	型	説明
_links	ReferenceLinks	このフィールドには、グラフの件名に関する 0 個以上の興味深いリンクが含まれています。これらのリンクを呼び出して、このグラフの主題に関する追加のリレーションシップや詳細情報を取得できます。
descriptor	string	記述子は、システムの実行中にグラフの件名を参照する主な方法です。このフィールドは、アカウントと組織の両方で同じグラフの件名を一意に識別します。
directoryAlias	string	非推奨 - IdentityRef "_links" ディクショナリの "self" エントリで参照されている 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 は、このグラフの件名のソースリソースへの完全なルートです。

ProcessParameters

名前	型	説明
dataSourceBindings	DataSourceBindingBase[]	サービスエンドポイント要求のデータソースのバインドを表します。
inputs	TaskInputDefinitionBase[]
sourceDefinitions	TaskSourceDefinitionBase[]

ProjectReference

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

PropertiesCollection

クラスは、キーと値のペアのコレクションとしてプロパティバッグを表します。を除くすべてのプリミティブ型 (を持つ任意の TypeCode != TypeCode.Object型) の DBNull 値が受け入れられます。 Byte[]、Int32、Double、DateType、String 型の値は型を保持し、他のプリミティブは String として再チューニングされます。 Byte[] は base64 でエンコードされた文字列として必要です。

名前	型	説明
count	integer	コレクション内のプロパティの数。
item	object
keys	string[]	コレクション内のキーのセット。
values	string[]	コレクション内の値のセット。

ReferenceLinks

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

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

ReleaseDefinition

名前	型	説明
_links	ReferenceLinks	リリース定義の関連リソース、API、およびビューへのリンクを取得します。
artifacts	Artifact[]	成果物の一覧を取得または設定します。
comment	string	コメントを取得または設定します。
createdBy	IdentityRef	作成した ID を取得または設定します。
createdOn	string	作成日を取得します。
description	string	説明を取得または設定します。
environments	ReleaseDefinitionEnvironment[]	環境の一覧を取得または設定します。
id	integer	リリース定義の一意識別子を取得します。
isDeleted	boolean	リリース定義を削除するかどうか。
lastRelease	ReleaseReference	最後のリリースの参照を取得します。
modifiedBy	IdentityRef	変更した ID を取得または設定します。
modifiedOn	string	変更された日付を取得します。
name	string	リリース定義の名前を取得または設定します。
path	string	リリース定義のパスを取得または設定します。
projectReference	ProjectReference	プロジェクト参照を取得または設定します。
properties	PropertiesCollection	プロパティを取得または設定します。
releaseNameFormat	string	リリース名の形式を取得または設定します。
revision	integer	リビジョン番号を取得します。
source	ReleaseDefinitionSource	リリース定義のソースを取得または設定します。
tags	string[]	タグの一覧を取得または設定します。
triggers	ReleaseTriggerBase[]	トリガーの一覧を取得または設定します。
url	string	リリース定義にアクセスするための REST API URL を取得します。
variableGroups	integer[]	変数グループの一覧を取得または設定します。
variables	<string, ConfigurationVariableValue>	変数のディクショナリを取得または設定します。

ReleaseDefinitionApprovals

名前	型	説明
approvalOptions	ApprovalOptions	承認オプションを取得または設定します。
approvals	ReleaseDefinitionApprovalStep[]	承認を取得または設定します。

ReleaseDefinitionApprovalStep

名前	型	説明
approver	IdentityRef	承認者を取得および設定します。
id	integer	承認またはデプロイステップの ID。
isAutomated	boolean	承認を自動化するかどうかを示します。
isNotificationOn	boolean	承認通知が設定されているかどうかを示します。
rank	integer	承認ステップのランクを取得または設定します。

ReleaseDefinitionDeployStep

名前	型	説明
id	integer	承認またはデプロイステップの ID。
tasks	WorkflowTask[]	この定義の手順の一覧。

ReleaseDefinitionEnvironment

名前	型	説明
badgeUrl	string	BadgeUrl を取得または設定します。 BadgeUrl は、リリース定義環境でバッジが有効になる場合に使用されます。
conditions	Condition[]	環境条件を取得または設定します。
currentRelease	ReleaseShallowReference	現在のリリース参照を取得または設定します。
demands	Demand[]	要求を取得または設定します。
deployPhases	DeployPhase[]	環境のデプロイフェーズを取得または設定します。
deployStep	ReleaseDefinitionDeployStep	deploystep を取得または設定します。
environmentOptions	EnvironmentOptions	環境オプションを取得または設定します。
environmentTriggers	EnvironmentTrigger[]	環境のトリガーを取得または設定します。
executionPolicy	EnvironmentExecutionPolicy	環境実行ポリシーを取得または設定します。
id	integer	ReleaseDefinitionEnvironment の ID を取得および設定します。
name	string	ReleaseDefinitionEnvironment の名前を取得および設定します。
owner	IdentityRef	ReleaseDefinitionEnvironment の所有者を取得および設定します。
postDeployApprovals	ReleaseDefinitionApprovals	デプロイ後の承認を取得または設定します。
postDeploymentGates	ReleaseDefinitionGatesStep	デプロイ後のゲートを取得または設定します。
preDeployApprovals	ReleaseDefinitionApprovals	展開前の承認を取得または設定します。
preDeploymentGates	ReleaseDefinitionGatesStep	デプロイ前ゲートを取得または設定します。
processParameters	ProcessParameters	環境プロセスパラメーターを取得または設定します。
properties	PropertiesCollection	環境のプロパティを取得または設定します。
queueId	integer	キュー ID を取得または設定します。
rank	integer	ReleaseDefinitionEnvironment のランクを取得および設定します。
retentionPolicy	EnvironmentRetentionPolicy	環境のアイテム保持ポリシーを取得または設定します。
schedules	ReleaseSchedule[]	スケジュールを取得または設定します
variableGroups	integer[]	変数グループを取得または設定します。
variables	<string, ConfigurationVariableValue>	変数を取得および設定します。

ReleaseDefinitionGate

名前	型	説明
tasks	WorkflowTask[]	ゲートワークフローを取得または設定します。

ReleaseDefinitionGatesOptions

名前	型	説明
isEnabled	boolean	ゲートが有効かどうかを取得または設定します。
minimumSuccessDuration	integer	ゲートの評価が成功した後の安定した結果の最小期間を取得または設定します。
samplingInterval	integer	ゲートの再評価までの時間を取得または設定します。
stabilizationTime	integer	評価前の遅延を取得または設定します。
timeout	integer	ゲートが失敗した後のタイムアウトを取得または設定します。

ReleaseDefinitionGatesStep

名前	型	説明
gates	ReleaseDefinitionGate[]	ゲートを取得または設定します。
gatesOptions	ReleaseDefinitionGatesOptions	ゲートオプションを取得または設定します。
id	integer	ReleaseDefinitionGateStep の ID。

ReleaseDefinitionShallowReference

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

ReleaseDefinitionSource

リリース定義のソースを取得または設定します。

名前	型	説明
ibiza	string	Ibiza から作成された ReleaseDefinition を示します。
portalExtensionApi	string	PortalExtension API から作成された ReleaseDefinition を示します。
restApi	string	REST API を使用して作成された ReleaseDefinition を示します。
undefined	string	ReleaseDefinition ソースが定義されていないことを示します。
userInterface	string	UI を使用して作成された ReleaseDefinition を示します。

ReleaseReason

リリースの理由を取得します。

名前	型	説明
continuousIntegration	string	継続的インテグレーションによってトリガーされるリリースを示します。
manual	string	手動でトリガーされたリリースを示します。
none	string	リリースによってトリガーされた理由が設定されていないことを示します。
pullRequest	string	PullRequest によってトリガーされたリリースを示します。
schedule	string	スケジュールによってトリガーされるリリースを示します。

ReleaseReference

名前	型	説明
_links	ReferenceLinks	リリースにアクセスするためのリンクを取得します。
artifacts	Artifact[]	成果物の一覧を取得します。
createdBy	IdentityRef	リリースを作成した ID を取得します。
createdOn	string	このリリースが作成された日付を取得します。
description	string	説明を取得します。
id	integer	リリースの ID。
modifiedBy	IdentityRef	リリースを変更した ID を取得します。
name	string	リリースの名前を取得します。
reason	ReleaseReason	リリースの理由を取得します。
releaseDefinition	ReleaseDefinitionShallowReference	リリース定義の浅い参照を取得します。

ReleaseSchedule

名前	型	説明
daysToRelease	ScheduleDays	リリースする曜日。
jobId	string	Team Foundation ジョブ定義ジョブ ID。
scheduleOnlyWithChanges	boolean	関連付けられた成果物が変更されたか、リリース定義が変更された場合にのみ、このスケジュールをリリースする必要があるかどうかを判断するフラグ。
startHours	integer	開始するローカルタイムゾーン時間。
startMinutes	integer	開始するローカルタイムゾーン分。
timeZoneId	string	リリーススケジュールのタイムゾーン ID ('UTC' など)。

ReleaseShallowReference

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

ReleaseTriggerBase

名前	型	説明
triggerType	ReleaseTriggerType	リリーストリガーの種類。

ReleaseTriggerType

リリーストリガーの種類。

名前	型	説明
artifactSource	string	成果物ベースのリリーストリガー。
containerImage	string	コンテナーイメージベースのリリーストリガー。
package	string	パッケージベースのリリーストリガー。
pullRequest	string	Pull request ベースのリリーストリガー。
schedule	string	スケジュールベースのリリーストリガー。
sourceRepo	string	ソースリポジトリベースのリリーストリガー。
undefined	string	リリーストリガーの種類が設定されていません。

ScheduleDays

リリースする曜日。

名前	型	説明
all	string	週のすべての曜日にスケジュールされます。
friday	string	金曜日に予定されています。
monday	string	月曜日に予定されています。
none	string	スケジュールされた日が設定されていません。
saturday	string	土曜日に予定されています。
sunday	string	日曜日に予定されています。
thursday	string	木曜日に予定されています。
tuesday	string	火曜日に予定されています。
wednesday	string	水曜日に予定されています。

TaskInputDefinitionBase

名前	型	説明
aliases	string[]
defaultValue	string
groupName	string
helpMarkDown	string
label	string
name	string
options	object
properties	object
required	boolean
type	string
validation	TaskInputValidation
visibleRule	string

TaskInputValidation

名前	型	説明
expression	string	条件式
message	string	検証が失敗した場合にユーザーが修正する方法を説明するメッセージ

TaskSourceDefinitionBase

名前	型	説明
authKey	string
endpoint	string
keySelector	string
selector	string
target	string

WorkflowTask

名前	型	説明
alwaysRun	boolean	タスクが常に実行されるかどうかを取得または設定します。
condition	string	タスクの条件を取得または設定します。
continueOnError	boolean	エラーが発生した場合にタスクの実行を続行する場合に取得または設定します。
definitionType	string	タスク定義の種類を取得または設定します。例: 'Agent'、DeploymentGroup'、'Server'、または 'ServerGate' です。
enabled	boolean	タスクが有効かどうかを取得または設定します。
environment	object	タスク環境変数を取得または設定します。
inputs	object	タスクの入力を取得または設定します。
name	string	タスクの名前を取得します。値の設定も可能です。
overrideInputs	object	タスクのオーバーライド入力を取得または設定します。
refName	string	タスクの参照名を取得または設定します。
retryCountOnTaskFailure	integer	タスクの retryCount を取得または設定します。
taskId	string	タスクの ID を取得または設定します。
timeoutInMinutes	integer	タスクのタイムアウトを取得または設定します。
version	string	タスクのバージョンを取得または設定します。

次の方法で共有