Releases - Create

Référence

Service:: Release

API Version:: 7.1-preview.8

Créer une mise en production.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	path	True	string	Nom de l’organisation Azure DevOps.
project	path	True	string	ID de projet ou nom du projet
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1-preview.8 » pour utiliser cette version de l’API.

Corps de la demande

Nom	Type	Description
artifacts	ArtifactMetadata[]	Définit la liste de l’artefact pour créer une mise en production.
definitionId	integer	Définit l’ID de définition pour créer une version.
description	string	Définit la description pour créer une version.
environmentsMetadata	ReleaseStartEnvironmentMetadata[]	Définit la liste des métadonnées d’environnements.
isDraft	boolean	Définit « true » pour créer une mise en production en mode brouillon, « false » sinon.
manualEnvironments	string[]	Définit la liste des environnements en tant que condition manuelle.
properties	PropertiesCollection	La classe représente un conteneur de propriétés en tant que collection de paires clé-valeur. Les valeurs de tous les types primitifs (tout type avec un `TypeCode != TypeCode.Object`) à l’exception de sont `DBNull` acceptées. Les valeurs de type Byte[], Int32, Double, DateType et String conservent leur type. D’autres primitives sont réintégés en tant que String. Byte[] attendu en tant que chaîne encodée en base64.
reason	ReleaseReason	Définit la raison de la création d’une version.
variables	<string, ConfigurationVariableValue>	Définit la liste des variables de mise en production à remplacer au moment du déploiement.

Réponses

Nom	Type	Description
200 OK	Release	opération réussie

Sécurité

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

Nom	Description
vso.release_execute	Accorde la possibilité de lire et de mettre à jour des artefacts de mise en production, y compris les dossiers, les versions, les définitions de version et l’environnement de mise en production, ainsi que la possibilité de mettre en file d’attente une nouvelle version.

Exemples

Sample Request

HTTP

POST https://vsrm.dev.azure.com/fabrikam/MyFirstProject/_apis/release/releases?api-version=7.1-preview.8

{
  "definitionId": 1,
  "description": "Creating Sample release",
  "artifacts": [
    {
      "alias": "Fabrikam.CI",
      "instanceReference": {
        "id": "2",
        "name": null
      }
    }
  ],
  "isDraft": false,
  "reason": "none",
  "manualEnvironments": null
}

Sample Response

Status code:: 200

{
  "id": 19,
  "name": "Release-19",
  "status": "active",
  "createdOn": "2017-06-16T01:53:32.777Z",
  "modifiedOn": "2017-06-16T01:53:32.777Z",
  "modifiedBy": {
    "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"
  },
  "createdBy": {
    "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"
  },
  "environments": [
    {
      "id": 73,
      "releaseId": 19,
      "name": "Dev",
      "status": "notStarted",
      "variables": {},
      "preDeployApprovals": [],
      "postDeployApprovals": [],
      "preApprovalsSnapshot": {
        "approvals": [
          {
            "rank": 1,
            "isAutomated": false,
            "isNotificationOn": false,
            "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"
            },
            "id": 0
          }
        ],
        "approvalOptions": {
          "requiredApproverCount": 0,
          "releaseCreatorCanBeApprover": true,
          "autoTriggeredAndPreviousEnvironmentApprovedCanBeSkipped": false,
          "enforceIdentityRevalidation": false,
          "timeoutInMintues": 43200
        }
      },
      "postApprovalsSnapshot": {
        "approvals": [
          {
            "rank": 1,
            "isAutomated": true,
            "isNotificationOn": false,
            "id": 0
          }
        ]
      },
      "deploySteps": [],
      "rank": 1,
      "definitionEnvironmentId": 1,
      "environmentOptions": {
        "emailNotificationType": "OnlyOnFailure",
        "emailRecipients": "release.environment.owner;release.creator",
        "skipArtifactsDownload": false,
        "timeoutInMinutes": 0,
        "enableAccessToken": false,
        "publishDeploymentStatus": false
      },
      "demands": [],
      "conditions": [],
      "workflowTasks": [],
      "deployPhasesSnapshot": [
        {
          "deploymentInput": {
            "parallelExecution": {
              "parallelExecutionType": "none"
            },
            "skipArtifactsDownload": false,
            "timeoutInMinutes": 0,
            "queueId": 2,
            "demands": [],
            "enableAccessToken": false
          },
          "rank": 1,
          "phaseType": "agentBasedDeployment",
          "name": "Run on agent",
          "workflowTasks": [
            {
              "taskId": "e213ff0f-5d5c-4791-802d-52ea3e7be1f1",
              "version": "1.*",
              "name": "PowerShell Script",
              "enabled": true,
              "alwaysRun": false,
              "continueOnError": false,
              "timeoutInMinutes": 0,
              "definitionType": "task",
              "inputs": {
                "scriptType": "inlineScript",
                "scriptName": "",
                "arguments": "",
                "inlineScript": "# You can write your powershell scripts inline here. \n# You can also pass predefined and custom variables to this scripts using arguments\n\n Write-Host \"Hello World\"",
                "workingFolder": "",
                "failOnStandardError": "true"
              }
            }
          ]
        }
      ],
      "owner": {
        "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"
      },
      "schedules": [],
      "release": {
        "id": 19,
        "name": "Release-19",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/releases/19",
        "_links": {
          "web": {
            "href": "https://dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_release?releaseId=19&_a=release-summary"
          },
          "self": {
            "href": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/releases/19"
          }
        }
      },
      "releaseDefinition": {
        "id": 1,
        "name": "MyShuttle.CD",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1",
        "_links": {
          "web": {
            "href": "https://dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_release?definitionId=1"
          },
          "self": {
            "href": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1"
          }
        }
      },
      "releaseCreatedBy": {
        "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "displayName": "Chuck Reinhart"
      },
      "triggerReason": "Manual"
    },
    {
      "id": 74,
      "releaseId": 19,
      "name": "QA",
      "status": "notStarted",
      "variables": {},
      "preDeployApprovals": [],
      "postDeployApprovals": [],
      "preApprovalsSnapshot": {
        "approvals": [
          {
            "rank": 1,
            "isAutomated": true,
            "isNotificationOn": false,
            "id": 0
          }
        ]
      },
      "postApprovalsSnapshot": {
        "approvals": [
          {
            "rank": 1,
            "isAutomated": true,
            "isNotificationOn": false,
            "id": 0
          }
        ]
      },
      "deploySteps": [],
      "rank": 2,
      "definitionEnvironmentId": 2,
      "environmentOptions": {
        "emailNotificationType": "OnlyOnFailure",
        "emailRecipients": "release.environment.owner;release.creator",
        "skipArtifactsDownload": false,
        "timeoutInMinutes": 0,
        "enableAccessToken": false,
        "publishDeploymentStatus": false
      },
      "demands": [],
      "conditions": [
        {
          "result": false,
          "name": "Dev",
          "conditionType": "environmentState",
          "value": "4"
        }
      ],
      "workflowTasks": [],
      "deployPhasesSnapshot": [
        {
          "deploymentInput": {
            "parallelExecution": {
              "parallelExecutionType": "none"
            },
            "skipArtifactsDownload": false,
            "timeoutInMinutes": 0,
            "queueId": 2,
            "demands": [],
            "enableAccessToken": false
          },
          "rank": 1,
          "phaseType": "agentBasedDeployment",
          "name": "Run on agent",
          "workflowTasks": [
            {
              "taskId": "e213ff0f-5d5c-4791-802d-52ea3e7be1f1",
              "version": "1.*",
              "name": "PowerShell Script",
              "enabled": true,
              "alwaysRun": false,
              "continueOnError": false,
              "timeoutInMinutes": 0,
              "definitionType": "task",
              "inputs": {
                "scriptType": "inlineScript",
                "scriptName": "",
                "arguments": "",
                "inlineScript": "# You can write your powershell scripts inline here. \n# You can also pass predefined and custom variables to this scripts using arguments\n\n Write-Host \"Hello World\"",
                "workingFolder": "",
                "failOnStandardError": "true"
              }
            }
          ]
        }
      ],
      "owner": {
        "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"
      },
      "schedules": [],
      "release": {
        "id": 19,
        "name": "Release-19",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/releases/19",
        "_links": {
          "web": {
            "href": "https://dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_release?releaseId=19&_a=release-summary"
          },
          "self": {
            "href": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/releases/19"
          }
        }
      },
      "releaseDefinition": {
        "id": 1,
        "name": "MyShuttle.CD",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1",
        "_links": {
          "web": {
            "href": "https://dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_release?definitionId=1"
          },
          "self": {
            "href": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1"
          }
        }
      },
      "releaseCreatedBy": {
        "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "displayName": "Chuck Reinhart"
      },
      "triggerReason": "After successful deployment of Dev"
    },
    {
      "id": 75,
      "releaseId": 19,
      "name": "PPE",
      "status": "notStarted",
      "variables": {},
      "preDeployApprovals": [],
      "postDeployApprovals": [],
      "preApprovalsSnapshot": {
        "approvals": [
          {
            "rank": 1,
            "isAutomated": true,
            "isNotificationOn": false,
            "id": 0
          }
        ]
      },
      "postApprovalsSnapshot": {
        "approvals": [
          {
            "rank": 1,
            "isAutomated": true,
            "isNotificationOn": false,
            "id": 0
          }
        ]
      },
      "deploySteps": [],
      "rank": 3,
      "definitionEnvironmentId": 3,
      "environmentOptions": {
        "emailNotificationType": "OnlyOnFailure",
        "emailRecipients": "release.environment.owner;release.creator",
        "skipArtifactsDownload": false,
        "timeoutInMinutes": 0,
        "enableAccessToken": false,
        "publishDeploymentStatus": false
      },
      "demands": [],
      "conditions": [
        {
          "result": false,
          "name": "QA",
          "conditionType": "environmentState",
          "value": "4"
        }
      ],
      "workflowTasks": [],
      "deployPhasesSnapshot": [
        {
          "deploymentInput": {
            "parallelExecution": {
              "parallelExecutionType": "none"
            },
            "skipArtifactsDownload": false,
            "timeoutInMinutes": 0,
            "queueId": 2,
            "demands": [],
            "enableAccessToken": false
          },
          "rank": 1,
          "phaseType": "agentBasedDeployment",
          "name": "Run on agent",
          "workflowTasks": [
            {
              "taskId": "e213ff0f-5d5c-4791-802d-52ea3e7be1f1",
              "version": "1.*",
              "name": "PowerShell Script",
              "enabled": true,
              "alwaysRun": false,
              "continueOnError": false,
              "timeoutInMinutes": 0,
              "definitionType": "task",
              "inputs": {
                "scriptType": "inlineScript",
                "scriptName": "",
                "arguments": "",
                "inlineScript": "# You can write your powershell scripts inline here. \n# You can also pass predefined and custom variables to this scripts using arguments\n\n Write-Host \"Hello World\"",
                "workingFolder": "",
                "failOnStandardError": "true"
              }
            }
          ]
        }
      ],
      "owner": {
        "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"
      },
      "schedules": [],
      "release": {
        "id": 19,
        "name": "Release-19",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/releases/19",
        "_links": {
          "web": {
            "href": "https://dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_release?releaseId=19&_a=release-summary"
          },
          "self": {
            "href": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/releases/19"
          }
        }
      },
      "releaseDefinition": {
        "id": 1,
        "name": "MyShuttle.CD",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1",
        "_links": {
          "web": {
            "href": "https://dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_release?definitionId=1"
          },
          "self": {
            "href": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1"
          }
        }
      },
      "releaseCreatedBy": {
        "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "displayName": "Chuck Reinhart"
      },
      "triggerReason": "After successful deployment of QA"
    },
    {
      "id": 76,
      "releaseId": 19,
      "name": "PROD",
      "status": "notStarted",
      "variables": {},
      "preDeployApprovals": [],
      "postDeployApprovals": [],
      "preApprovalsSnapshot": {
        "approvals": [
          {
            "rank": 1,
            "isAutomated": true,
            "isNotificationOn": false,
            "id": 0
          }
        ]
      },
      "postApprovalsSnapshot": {
        "approvals": [
          {
            "rank": 1,
            "isAutomated": true,
            "isNotificationOn": false,
            "id": 0
          }
        ]
      },
      "deploySteps": [],
      "rank": 4,
      "definitionEnvironmentId": 4,
      "environmentOptions": {
        "emailNotificationType": "OnlyOnFailure",
        "emailRecipients": "release.environment.owner;release.creator",
        "skipArtifactsDownload": false,
        "timeoutInMinutes": 0,
        "enableAccessToken": false,
        "publishDeploymentStatus": false
      },
      "demands": [],
      "conditions": [
        {
          "result": false,
          "name": "PPE",
          "conditionType": "environmentState",
          "value": "4"
        }
      ],
      "workflowTasks": [],
      "deployPhasesSnapshot": [
        {
          "deploymentInput": {
            "parallelExecution": {
              "parallelExecutionType": "none"
            },
            "skipArtifactsDownload": false,
            "timeoutInMinutes": 0,
            "queueId": 2,
            "demands": [],
            "enableAccessToken": false
          },
          "rank": 1,
          "phaseType": "agentBasedDeployment",
          "name": "Run on agent",
          "workflowTasks": [
            {
              "taskId": "e213ff0f-5d5c-4791-802d-52ea3e7be1f1",
              "version": "1.*",
              "name": "PowerShell Script",
              "enabled": true,
              "alwaysRun": false,
              "continueOnError": false,
              "timeoutInMinutes": 0,
              "definitionType": "task",
              "inputs": {
                "scriptType": "inlineScript",
                "scriptName": "",
                "arguments": "",
                "inlineScript": "# You can write your powershell scripts inline here. \n# You can also pass predefined and custom variables to this scripts using arguments\n\n Write-Host \"Hello World\"",
                "workingFolder": "",
                "failOnStandardError": "true"
              }
            }
          ]
        }
      ],
      "owner": {
        "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"
      },
      "schedules": [],
      "release": {
        "id": 19,
        "name": "Release-19",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/releases/19",
        "_links": {
          "web": {
            "href": "https://dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_release?releaseId=19&_a=release-summary"
          },
          "self": {
            "href": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/releases/19"
          }
        }
      },
      "releaseDefinition": {
        "id": 1,
        "name": "MyShuttle.CD",
        "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1",
        "_links": {
          "web": {
            "href": "https://dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_release?definitionId=1"
          },
          "self": {
            "href": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1"
          }
        }
      },
      "releaseCreatedBy": {
        "id": "4adb1680-0eac-6149-b5ee-fc8b4f6ca227",
        "displayName": "Chuck Reinhart"
      },
      "triggerReason": "After successful deployment of PPE"
    }
  ],
  "variables": {},
  "variableGroups": [],
  "artifacts": [
    {
      "sourceId": "d07908bc-118f-47d2-8a13-ff75601a6b1a:1",
      "type": "Build",
      "alias": "Fabrikam.CI",
      "definitionReference": {
        "artifactSourceDefinitionUrl": {
          "id": "https://dev.azure.com/fabrikam/_permalink/_build/index?collectionId=13d3daac-03b8-4a23-9cc4-2c3de65dab63&projectId=d07908bc-118f-47d2-8a13-ff75601a6b1a&definitionId=1",
          "name": ""
        },
        "defaultVersionBranch": {
          "id": "",
          "name": ""
        },
        "defaultVersionSpecific": {
          "id": "",
          "name": ""
        },
        "defaultVersionTags": {
          "id": "",
          "name": ""
        },
        "defaultVersionType": {
          "id": "latestType",
          "name": "Latest"
        },
        "definition": {
          "id": "1",
          "name": "Fabrikam.CI"
        },
        "project": {
          "id": "d07908bc-118f-47d2-8a13-ff75601a6b1a",
          "name": "MyFirstProject"
        },
        "version": {
          "id": "2",
          "name": ""
        },
        "artifactSourceVersionUrl": {
          "id": "https://dev.azure.com/fabrikam/_permalink/_build/index?collectionId=13d3daac-03b8-4a23-9cc4-2c3de65dab63&projectId=d07908bc-118f-47d2-8a13-ff75601a6b1a&buildId=2",
          "name": ""
        }
      },
      "isPrimary": true
    }
  ],
  "releaseDefinition": {
    "id": 1,
    "name": "MyShuttle.CD",
    "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1",
    "_links": {
      "self": {
        "href": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/definitions/1"
      },
      "web": {
        "href": "https://dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_release?definitionId=1"
      }
    }
  },
  "description": "Creating Sample release",
  "reason": "manual",
  "releaseNameFormat": "Release-$(rev:r)",
  "keepForever": false,
  "definitionSnapshotRevision": 1,
  "logsContainerUrl": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/releases/19/logs",
  "url": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/releases/19",
  "_links": {
    "self": {
      "href": "https://vsrm.dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_apis/Release/releases/19"
    },
    "web": {
      "href": "https://dev.azure.com/fabrikam/d07908bc-118f-47d2-8a13-ff75601a6b1a/_release?releaseId=19&_a=release-summary"
    }
  },
  "tags": [],
  "projectReference": {
    "id": "d07908bc-118f-47d2-8a13-ff75601a6b1a",
    "name": null
  },
  "properties": {}
}

Définitions

Nom	Description
ApprovalExecutionOrder	Ordre d’exécution des approbations.
ApprovalOptions
ApprovalStatus	Obtient ou définit le status de l’approbation.
ApprovalType	Obtient ou définit le type d’approbation.
Artifact
ArtifactMetadata
ArtifactSourceReference
AuthorizationHeader
BuildVersion
ConditionType	Obtient ou définit le type de condition.
ConfigurationVariableValue
DataSourceBindingBase	Représente la liaison de la source de données pour la demande de point de terminaison de service.
DeploymentAttempt
DeploymentJob
DeploymentOperationStatus	Obtient la status de l’opération du déploiement.
DeploymentReason	Obtient la raison du déploiement.
DeploymentStatus	Obtient status du déploiement.
DeployPhase
DeployPhaseStatus	État de la phase.
DeployPhaseTypes	Indique le type de phase de déploiement.
EnvironmentOptions
EnvironmentStatus	Obtient les status d’environnement.
GateStatus	État des portes de mise en production.
IdentityRef
IgnoredGate
Issue
ManualIntervention
ManualInterventionStatus	Obtient ou définit le status de l’intervention manuelle.
ProcessParameters
ProjectReference
PropertiesCollection	La classe représente un conteneur de propriétés en tant que collection de paires clé-valeur. Les valeurs de tous les types primitifs (tout type avec un `TypeCode != TypeCode.Object`) à l’exception de sont `DBNull` acceptées. Les valeurs de type Byte[], Int32, Double, DateType et String conservent leur type. D’autres primitives sont réintégés en tant que String. Byte[] attendu en tant que chaîne encodée en base64.
ReferenceLinks	Classe pour représenter une collection de liens de référence REST.
Release
ReleaseApproval
ReleaseApprovalHistory
ReleaseCondition
ReleaseDefinitionApprovals
ReleaseDefinitionApprovalStep
ReleaseDefinitionGate
ReleaseDefinitionGatesOptions
ReleaseDefinitionGatesStep
ReleaseDefinitionShallowReference
ReleaseDeployPhase
ReleaseEnvironment
ReleaseEnvironmentShallowReference
ReleaseGates
ReleaseReason	Obtient le motif de la mise en production.
ReleaseSchedule
ReleaseShallowReference
ReleaseStartEnvironmentMetadata
ReleaseStartMetadata
ReleaseStatus	Obtient status.
ReleaseTask
ScheduleDays	Jours de la semaine à publier.
SourcePullRequestVersion
TaskInputDefinitionBase
TaskInputValidation
TaskSourceDefinitionBase
TaskStatus	État de la tâche de mise en production.
VariableGroup
VariableGroupProjectReference	Une référence de groupe de variables est une référence superficielle au groupe de variables.
VariableGroupProviderData
VariableValue
WorkflowTask
WorkflowTaskReference

ApprovalExecutionOrder

Ordre d’exécution des approbations.

Nom	Type	Description
afterGatesAlways	string	Approbations affichées toujours après l’exécution des portes.
afterSuccessfulGates	string	Approbations affichées après l’exécution réussie des portes.
beforeGates	string	Approbations affichées avant les portes.

ApprovalOptions

Nom	Type	Description
autoTriggeredAndPreviousEnvironmentApprovedCanBeSkipped	boolean	Spécifiez si l’approbation peut être ignorée si le même approbateur a approuvé l’étape précédente.
enforceIdentityRevalidation	boolean	Spécifiez si revalidez l’identité de l’approbateur avant de terminer l’approbation.
executionOrder	ApprovalExecutionOrder	Ordre d’exécution des approbations.
releaseCreatorCanBeApprover	boolean	Spécifiez si l’utilisateur qui demande une mise en production ou un déploiement doit autoriser l’approbateur.
requiredApproverCount	integer	Nombre d’approbations requises pour faire avancer la mise en production. « 0 » désigne toutes les approbations requises.
timeoutInMinutes	integer	Délai d’expiration de l’approbation. Le délai d’expiration par défaut de l’approbation est de 30 jours. Le délai d’expiration maximal autorisé est de 365 jours. « 0 » signifie délai d’attente par défaut, c’est-à-dire 30 jours.

ApprovalStatus

Obtient ou définit le status de l’approbation.

Nom	Type	Description
approved	string	Indique que l’approbation est approuvée.
canceled	string	Indique que l’approbation est annulée.
pending	string	Indique que l’approbation est en attente.
reassigned	string	Indique que l’approbation est réaffectée.
rejected	string	Indique que l’approbation est rejetée.
skipped	string	Indique que l’approbation est ignorée.
undefined	string	Indique que l’approbation n’a pas le status défini.

ApprovalType

Obtient ou définit le type d’approbation.

Nom	Type	Description
all	string	Indique toutes les approbations.
postDeploy	string	Indique les approbations qui ont été exécutées après le déploiement.
preDeploy	string	Indique les approbations qui ont été exécutées avant le déploiement.
undefined	string	Indique que le type d’approbation n’est pas défini.

Artifact

Nom	Type	Description
alias	string	Obtient ou définit l’alias.
definitionReference	<string, ArtifactSourceReference>	Obtient ou définit une référence de définition. Par exemple, {"project »:{"id »:"fed755ea-49c5-4399-acea-fd5b5aa90a6c »,"name »:"myProject"},"definition »:{"id »:"1 »,"name »:"mybuildDefinition"},"connection »:{"id »:"1 »,"name »:"myConnection"}}.
isPrimary	boolean	Indique si l’artefact est principal ou non.
isRetained	boolean	Indique si l’artefact est conservé par mise en production ou non.
type	string	Obtient ou définit le type. Il peut avoir la valeur « Build », « Jenkins », « GitHub », « Nuget », « Team Build (externe) », « ExternalTFSBuild », « Git », « TFVC », « ExternalTfsXamlBuild ».

ArtifactMetadata

Nom	Type	Description
alias	string	Définit l’alias de l’artefact.
instanceReference	BuildVersion	Définit instance référence de l’artefact. par exemple, pour l’artefact de build, il s’agit du numéro de build.

ArtifactSourceReference

Nom	Type	Description
id	string	ID de la source de l’artefact.
name	string	Nom de la source de l’artefact.

AuthorizationHeader

Nom	Type	Description
name	string
value	string

BuildVersion

Nom	Type	Description
commitMessage	string	Obtient ou définit le message de validation pour l’artefact.
definitionId	string	Obtient ou définit l’ID de définition.
definitionName	string	Obtient ou définit le nom de la définition.
id	string	Obtient ou définit l’ID de build.
isMultiDefinitionType	boolean	Obtient ou définit si l’artefact prend en charge plusieurs définitions.
name	string	Obtient ou définit le numéro de build.
sourceBranch	string	Obtient ou définit la branche source de l’artefact.
sourcePullRequestVersion	SourcePullRequestVersion	Obtient ou définit la version de la demande de tirage source pour l’artefact.
sourceRepositoryId	string	Obtient ou définit l’ID de dépôt de l’artefact.
sourceRepositoryType	string	Obtient ou définit le type de dépôt de l’artefact.
sourceVersion	string	Obtient ou définit la version source de l’artefact.

ConditionType

Obtient ou définit le type de condition.

Nom	Type	Description
artifact	string	Le type de condition est artefact.
environmentState	string	Le type de condition est état d’environnement.
event	string	Le type de condition est événement.
undefined	string	Le type de condition n’est pas défini.

ConfigurationVariableValue

Nom	Type	Description
allowOverride	boolean	Obtient et définit si une variable peut être remplacée au moment du déploiement ou non.
isSecret	boolean	Obtient ou définit en tant que variable secrète ou non.
value	string	Obtient et définit la valeur de la variable de configuration.

DataSourceBindingBase

Représente la liaison de la source de données pour la demande de point de terminaison de service.

Nom	Type	Description
callbackContextTemplate	string	Format de pagination pris en charge par cette source de données (ContinuationToken/SkipTop).
callbackRequiredTemplate	string	Appels suivants nécessaires ?
dataSourceName	string	Obtient ou définit le nom de la source de données.
endpointId	string	Obtient ou définit l’ID de point de terminaison.
endpointUrl	string	Obtient ou définit l’URL du point de terminaison de service.
headers	AuthorizationHeader[]	Obtient ou définit les en-têtes d’autorisation.
initialContextTemplate	string	Définit la valeur initiale des analyseurs de requête
parameters	object	Obtient ou définit les paramètres de la source de données.
requestContent	string	Obtient ou définit le corps de la requête http
requestVerb	string	Obtient ou définit le verbe de requête http
resultSelector	string	Obtient ou définit le sélecteur de résultats.
resultTemplate	string	Obtient ou définit le modèle de résultat.
target	string	Obtient ou définit la cible de la source de données.

DeploymentAttempt

Nom	Type	Description
attempt	integer	Tentative de déploiement.
deploymentId	integer	ID du déploiement.
hasStarted	boolean	Spécifie si le déploiement a démarré ou non.
id	integer	ID du déploiement.
issues	Issue[]	Tous les problèmes liés au déploiement.
lastModifiedBy	IdentityRef	Identité qui a modifié ce déploiement pour la dernière fois.
lastModifiedOn	string	Heure de la dernière modification de ce déploiement.
operationStatus	DeploymentOperationStatus	Opération de déploiement status.
postDeploymentGates	ReleaseGates	Portes postérieures au déploiement exécutées dans ce déploiement.
preDeploymentGates	ReleaseGates	Portes de prédéploiement exécutées dans ce déploiement.
queuedOn	string	Lorsque ce déploiement a été mis en file d’attente.
reason	DeploymentReason	Raison du déploiement.
releaseDeployPhases	ReleaseDeployPhase[]	Liste des phases de déploiement de mise en production exécutées dans ce déploiement.
requestedBy	IdentityRef	Identité qui a demandé ce déploiement.
requestedFor	IdentityRef	Identité pour ce déploiement demandé.
status	DeploymentStatus	status du déploiement.

DeploymentJob

Nom	Type	Description
job	ReleaseTask	Tâche parente de toutes les tâches exécutées.
tasks	ReleaseTask[]	Liste des tâches exécutées avec dans le travail.

DeploymentOperationStatus

Obtient la status de l’opération du déploiement.

Nom	Type	Description
all	string	L’opération de déploiement status est tout.
approved	string	L’opération de déploiement status est approuvée.
canceled	string	L’opération de déploiement status est annulée.
cancelling	string	L’opération de déploiement status est annulée.
deferred	string	L’opération de déploiement status est différée.
evaluatingGates	string	L’opération de déploiement status est EvaluatingGates.
gateFailed	string	L’opération de déploiement status est GateFailed.
manualInterventionPending	string	L’opération de déploiement status est manuelleintervention en attente.
pending	string	L’opération de déploiement status est en attente.
phaseCanceled	string	L’opération de déploiement status est annulée en phase.
phaseFailed	string	L’opération de déploiement status est en cours d’échec.
phaseInProgress	string	L’opération de déploiement status est en cours.
phasePartiallySucceeded	string	L’opération de déploiement status est partiellement réussie.
phaseSucceeded	string	L’opération de déploiement status est la phase réussie.
queued	string	L’opération de déploiement status est mise en file d’attente.
queuedForAgent	string	L’opération de déploiement status est mise en file d’attente pour l’agent.
queuedForPipeline	string	L’opération de déploiement status est mise en file d’attente pour le pipeline.
rejected	string	L’opération de déploiement status est rejetée.
scheduled	string	L’opération de déploiement status est planifiée.
undefined	string	L’opération de déploiement status n’est pas définie.

DeploymentReason

Obtient la raison du déploiement.

Nom	Type	Description
automated	string	La raison du déploiement est automatisée.
manual	string	La raison du déploiement est manuelle.
none	string	La raison du déploiement est aucune.
redeployTrigger	string	La raison du déploiement est RedeployTrigger.
scheduled	string	La raison du déploiement est planifiée.

DeploymentStatus

Obtient status du déploiement.

Nom	Type	Description
all	string	Le status de déploiement est tout.
failed	string	Échec du déploiement status.
inProgress	string	Le déploiement status est en cours.
notDeployed	string	Le status de déploiement n’est pas déployé.
partiallySucceeded	string	La status de déploiement est partiellement terminée.
succeeded	string	La status de déploiement est réussie.
undefined	string	Le status de déploiement n’est pas défini.

DeployPhase

Nom	Type	Description
name	string	Obtient et définit le nom de la phase de déploiement.
phaseType	DeployPhaseTypes	Indique le type de phase de déploiement.
rank	integer	Obtient et définit le rang de la phase de déploiement.
refName	string	Obtient et définit le nom de référence de la phase de déploiement.
workflowTasks	WorkflowTask[]	Obtient et définit les tâches de workflow pour la phase de déploiement.

DeployPhaseStatus

État de la phase.

Nom	Type	Description
canceled	string	L’exécution de phase a été annulée.
cancelling	string	La phase est en état d’annulation.
failed	string	Échec de l’exécution de la phase.
inProgress	string	Exécution de phase en cours.
notStarted	string	L’exécution de phase n’a pas démarré.
partiallySucceeded	string	L’exécution de la phase a partiellement réussi.
skipped	string	Exécution de phase ignorée.
succeeded	string	L’exécution de la phase a réussi.
undefined	string	La phase status pas définie.

DeployPhaseTypes

Indique le type de phase de déploiement.

Nom	Type	Description
agentBasedDeployment	string	Type de phase qui contient les tâches exécutées sur l’agent.
deploymentGates	string	Type de phase qui contient des tâches qui jouent le rôle de portes pour le déploiement.
machineGroupBasedDeployment	string	Type de phase qui contient les tâches exécutées sur les machines du groupe de déploiement.
runOnServer	string	Type de phase qui contient les tâches exécutées par le serveur.
undefined	string	Type de phase non défini. N’utilisez pas ce paramètre.

EnvironmentOptions

Nom	Type	Description
autoLinkWorkItems	boolean	Obtient et définit en tant qu’éléments de travail de liaison automatique ou non.
badgeEnabled	boolean	Obtient et définit comme badge activé ou non.
publishDeploymentStatus	boolean	Obtient et définit en tant que déploiement de publication status ou non.
pullRequestDeploymentEnabled	boolean	Obtient et définit comme le déploiement de la demande .pull activé ou non.

EnvironmentStatus

Obtient les status d’environnement.

Nom	Type	Description
canceled	string	L’environnement est à l’état annulé.
inProgress	string	L’environnement est en cours d’exécution.
notStarted	string	L’environnement n’est pas démarré.
partiallySucceeded	string	L’environnement est dans un état partiellement réussi.
queued	string	L’environnement est en file d’attente.
rejected	string	L’environnement est à l’état rejeté.
scheduled	string	L’environnement est à l’état planifié.
succeeded	string	L’environnement est à l’état réussi.
undefined	string	L’environnement status pas défini.

GateStatus

État des portes de mise en production.

Nom	Type	Description
canceled	string	L’exécution de la porte a été annulée.
failed	string	L’exécution de la porte a échoué.
inProgress	string	La porte est actuellement en cours.
none	string	La porte n’a pas le status défini.
pending	string	La porte est en attente.
succeeded	string	La porte s’est terminée avec succès.

IdentityRef

Nom	Type	Description
_links	ReferenceLinks	Ce champ contient zéro ou plus de liens intéressants sur le sujet du graphe. Ces liens peuvent être appelés pour obtenir des relations supplémentaires ou des informations plus détaillées sur ce sujet de graphique.
descriptor	string	Le descripteur est le principal moyen de référencer l’objet du graphe pendant l’exécution du système. Ce champ identifie de manière unique le même sujet de graphe pour les comptes et les organisations.
directoryAlias	string	Déconseillé : peut être récupéré en interrogeant l’utilisateur Graph référencé dans l’entrée « auto » du dictionnaire IdentityRef « _links »
displayName	string	Il s’agit du nom d’affichage non unique du sujet du graphique. Pour modifier ce champ, vous devez modifier sa valeur dans le fournisseur source.
id	string
imageUrl	string	Déconseillé : disponible dans l’entrée « avatar » du dictionnaire IdentityRef « _links »
inactive	boolean	Déconseillé : peut être récupéré en interrogeant l’état d’appartenance Graph référencé dans l’entrée « membershipState » du dictionnaire GraphUser « _links »
isAadIdentity	boolean	Déconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Déconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Déconseillé : non utilisé dans la plupart des implémentations préexistantes de ToIdentityRef
uniqueName	string	Déconseillé : utilisez Domain+PrincipalName à la place
url	string	Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphique.

IgnoredGate

Nom	Type	Description
lastModifiedOn	string	Obtient la date à laquelle la porte est ignorée pour la dernière fois.
name	string	Nom de la porte ignorée.

Issue

Nom	Type	Description
data	object	Données de problème.
issueType	string	Type de problème, par exemple erreur, avertissement ou informations.
message	string	Message de problème.

ManualIntervention

Nom	Type	Description
approver	IdentityRef	Obtient ou définit l’identité qui doit approuver.
comments	string	Obtient ou définit des commentaires pour approbation.
createdOn	string	Obtient la date à laquelle il a été créé.
id	integer	Obtient l’identificateur unique pour l’intervention manuelle.
instructions	string	Obtient ou définit des instructions pour l’approbation.
modifiedOn	string	Obtient la date à laquelle il a été modifié.
name	string	Obtient ou définit le nom.
release	ReleaseShallowReference	Obtient releaseReference pour une intervention manuelle.
releaseDefinition	ReleaseDefinitionShallowReference	Obtient releaseDefinitionReference pour une intervention manuelle.
releaseEnvironment	ReleaseEnvironmentShallowReference	Obtient releaseEnvironmentReference pour une intervention manuelle.
status	ManualInterventionStatus	Obtient ou définit le status de l’intervention manuelle.
taskInstanceId	string	Obtenir l’identificateur de instance de tâche.
url	string	Obtient l’URL pour accéder à l’intervention manuelle.

ManualInterventionStatus

Obtient ou définit le status de l’intervention manuelle.

Nom	Type	Description
approved	string	L’intervention manuelle est approuvée.
canceled	string	L’intervention manuelle est annulée.
pending	string	L’intervention manuelle est en attente.
rejected	string	L’intervention manuelle est rejetée.
unknown	string	L’intervention manuelle n’a pas le status défini.

ProcessParameters

Nom	Type	Description
dataSourceBindings	DataSourceBindingBase[]	Représente la liaison de la source de données pour la demande de point de terminaison de service.
inputs	TaskInputDefinitionBase[]
sourceDefinitions	TaskSourceDefinitionBase[]

ProjectReference

Nom	Type	Description
id	string	Obtient l’identificateur unique de ce champ.
name	string	Obtient le nom du projet.

PropertiesCollection

La classe représente un conteneur de propriétés en tant que collection de paires clé-valeur. Les valeurs de tous les types primitifs (tout type avec un TypeCode != TypeCode.Object) à l’exception de sont DBNull acceptées. Les valeurs de type Byte[], Int32, Double, DateType et String conservent leur type. D’autres primitives sont réintégés en tant que String. Byte[] attendu en tant que chaîne encodée en base64.

Nom	Type	Description
count	integer	Nombre de propriétés dans la collection.
item	object
keys	string[]	Ensemble de clés dans la collection.
values	string[]	Ensemble de valeurs dans la collection.

ReferenceLinks

Classe pour représenter une collection de liens de référence REST.

Nom	Type	Description
links	object	Vue en lecture seule des liens. Étant donné que les liens de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

Release

Nom	Type	Description
_links	ReferenceLinks	Obtient des liens pour accéder à la version.
artifacts	Artifact[]	Obtient ou définit la liste des artefacts.
comment	string	Obtient ou définit un commentaire.
createdBy	IdentityRef	Obtient ou définit l’identité qui a créé.
createdFor	IdentityRef	Obtient ou définit l’identité pour laquelle la version a été créée.
createdOn	string	Obtient la date à laquelle il a été créé.
definitionSnapshotRevision	integer	Obtient le numéro de révision de la définition instantané.
description	string	Obtient ou définit la description de la mise en production.
environments	ReleaseEnvironment[]	Obtient la liste des environnements.
id	integer	Obtient l’identificateur unique de ce champ.
keepForever	boolean	Indique s’il faut exclure la mise en production des stratégies de rétention.
logsContainerUrl	string	Obtient l’URL du conteneur des journaux.
modifiedBy	IdentityRef	Obtient ou définit l’identité qui a été modifiée.
modifiedOn	string	Obtient la date à laquelle il a été modifié.
name	string	Obtient le nom.
poolName	string	Obtient le nom du pool.
projectReference	ProjectReference	Obtient ou définit une référence de projet.
properties	PropertiesCollection	La classe représente un conteneur de propriétés en tant que collection de paires clé-valeur. Les valeurs de tous les types primitifs (tout type avec un `TypeCode != TypeCode.Object`) à l’exception de sont `DBNull` acceptées. Les valeurs de type Byte[], Int32, Double, DateType et String conservent leur type. D’autres primitives sont réintégés en tant que String. Byte[] attendu en tant que chaîne encodée en base64.
reason	ReleaseReason	Obtient la raison de la mise en production.
releaseDefinition	ReleaseDefinitionShallowReference	Obtient releaseDefinitionReference qui spécifie la référence de la définition de mise en production à laquelle cette version est associée.
releaseDefinitionRevision	integer	Obtient ou définit la révision de la définition de mise en production.
releaseNameFormat	string	Obtient le format de nom de mise en production.
status	ReleaseStatus	Obtient status.
tags	string[]	Obtient ou définit la liste des balises.
triggeringArtifactAlias	string
variableGroups	VariableGroup[]	Obtient la liste des groupes de variables.
variables	<string, ConfigurationVariableValue>	Obtient ou définit le dictionnaire des variables.

ReleaseApproval

Nom	Type	Description
approvalType	ApprovalType	Obtient ou définit le type d’approbation.
approvedBy	IdentityRef	Obtient l’identité qui a approuvé.
approver	IdentityRef	Obtient ou définit l’identité qui doit approuver.
attempt	integer	Obtient ou définit la tentative qui spécifie à quelle tentative de déploiement elle appartient.
comments	string	Obtient ou définit des commentaires pour approbation.
createdOn	string	Obtient la date à laquelle il a été créé.
history	ReleaseApprovalHistory[]	Obtient l’historique qui spécifie toutes les approbations associées à cette approbation.
id	integer	Obtient l’identificateur unique de ce champ.
isAutomated	boolean	Obtient ou définit à mesure que l’approbation est automatisée ou non.
modifiedOn	string	Obtient la date à laquelle il a été modifié.
rank	integer	Obtient ou définit le classement qui spécifie l’ordre de l’approbation. Par exemple, le même rang désigne l’approbation parallèle.
release	ReleaseShallowReference	Obtient releaseReference qui spécifie la référence de la version à laquelle cette approbation est associée.
releaseDefinition	ReleaseDefinitionShallowReference	Obtient releaseDefinitionReference qui spécifie la référence de la définition de version à laquelle cette approbation est associée.
releaseEnvironment	ReleaseEnvironmentShallowReference	Obtient releaseEnvironmentReference qui spécifie la référence de l’environnement de mise en production auquel cette approbation est associée.
revision	integer	Obtient le numéro de révision.
status	ApprovalStatus	Obtient ou définit le status de l’approbation.
url	string	Obtient l’URL pour accéder à l’approbation.

ReleaseApprovalHistory

Nom	Type	Description
approver	IdentityRef	Identité de l’approbateur.
changedBy	IdentityRef	Identité de l’objet qui a modifié l’approbation.
comments	string	Commentaires de l’historique des approbations.
createdOn	string	Heure à laquelle cette approbation a été créée.
modifiedOn	string	Heure à laquelle cette approbation a été modifiée.
revision	integer	Révision de l’historique des approbations.

ReleaseCondition

Nom	Type	Description
conditionType	ConditionType	Obtient ou définit le type de condition.
name	string	Obtient ou définit le nom de la condition. Par exemple, « ReleaseStarted ».
result	boolean	Résultat de la condition de mise en production.
value	string	Obtient ou définit la valeur de la condition.

ReleaseDefinitionApprovals

Nom	Type	Description
approvalOptions	ApprovalOptions	Obtient ou définit les options d’approbation.
approvals	ReleaseDefinitionApprovalStep[]	Obtient ou définit les approbations.

ReleaseDefinitionApprovalStep

Nom	Type	Description
approver	IdentityRef	Obtient et définit l’approbateur.
id	integer	ID de l’étape d’approbation ou de déploiement.
isAutomated	boolean	Indique si l’approbation est automatisée.
isNotificationOn	boolean	Indique si le jeu de notification d’approbation.
rank	integer	Obtient ou définit le rang de l’étape d’approbation.

ReleaseDefinitionGate

Nom	Type	Description
tasks	WorkflowTask[]	Obtient ou définit le flux de travail des portes.

ReleaseDefinitionGatesOptions

Nom	Type	Description
isEnabled	boolean	Obtient ou définit comme les portes activées ou non.
minimumSuccessDuration	integer	Obtient ou définit la durée minimale des résultats stables après une évaluation réussie des portes.
samplingInterval	integer	Obtient ou définit le délai entre la réévaluation des portes.
stabilizationTime	integer	Obtient ou définit le délai avant l’évaluation.
timeout	integer	Obtient ou définit le délai d’expiration après lequel les portes échouent.

ReleaseDefinitionGatesStep

Nom	Type	Description
gates	ReleaseDefinitionGate[]	Obtient ou définit les portes.
gatesOptions	ReleaseDefinitionGatesOptions	Obtient ou définit les options de porte.
id	integer	ID du ReleaseDefinitionGateStep.

ReleaseDefinitionShallowReference

Nom	Type	Description
_links	ReferenceLinks	Obtient les liens vers les ressources, LES API et les vues associées pour la définition de mise en production.
id	integer	Obtient l’identificateur unique de la définition de mise en production.
name	string	Obtient ou définit le nom de la définition de mise en production.
path	string	Obtient ou définit le chemin d’accès de la définition de mise en production.
projectReference	ProjectReference	Obtient ou définit une référence de projet.
url	string	Obtient l’URL de l’API REST pour accéder à la définition de mise en production.

ReleaseDeployPhase

Nom	Type	Description
deploymentJobs	DeploymentJob[]	Travaux de déploiement de la phase.
errorLog	string	Journaux des erreurs d’exécution de phase.
manualInterventions	ManualIntervention[]	Liste des informations d’exécution des tâches d’intervention manuelle en phase.
name	string	Nom de la phase.
phaseId	string	ID de la phase.
phaseType	DeployPhaseTypes	Type de la phase.
rank	integer	Classement de la phase.
runPlanId	string	Exécuter l’ID de plan de la phase.
startedOn	string	Heure de début de phase.
status	DeployPhaseStatus	État de la phase.

ReleaseEnvironment

Nom	Type	Description
conditions	ReleaseCondition[]	Obtient la liste des conditions.
createdOn	string	Obtient la date à laquelle il a été créé.
definitionEnvironmentId	integer	Obtient l’ID d’environnement de définition.
deployPhasesSnapshot	DeployPhase[]	Obtient la liste des phases de déploiement instantané.
deploySteps	DeploymentAttempt[]	Obtient les étapes de déploiement.
environmentOptions	EnvironmentOptions	Obtient les options d’environnement.
id	integer	Obtient l’identificateur unique de ce champ.
modifiedOn	string	Obtient la date à laquelle il a été modifié.
name	string	Obtient le nom.
nextScheduledUtcTime	string	Obtient l’heure UTC planifiée suivante.
owner	IdentityRef	Obtient l’identité propriétaire de l’environnement de mise en production.
postApprovalsSnapshot	ReleaseDefinitionApprovals	Obtient la liste des approbations post-déploiement instantané.
postDeployApprovals	ReleaseApproval[]	Obtient la liste des approbations post-déploiement.
postDeploymentGatesSnapshot	ReleaseDefinitionGatesStep	Les portes post-déploiement instantané données.
preApprovalsSnapshot	ReleaseDefinitionApprovals	Obtient la liste des approbations préalables au déploiement instantané.
preDeployApprovals	ReleaseApproval[]	Obtient la liste des approbations préalables au déploiement.
preDeploymentGatesSnapshot	ReleaseDefinitionGatesStep	Les portes de prédéploiement instantané données.
processParameters	ProcessParameters	Obtient les paramètres de processus.
rank	integer	Obtient le classement.
release	ReleaseShallowReference	Obtient une référence de mise en production qui spécifie la référence de la version à laquelle cet environnement de mise en production est associé.
releaseCreatedBy	IdentityRef	Obtient l’identité qui a créé la mise en production.
releaseDefinition	ReleaseDefinitionShallowReference	Obtient releaseDefinitionReference qui spécifie la référence de la définition de mise en production à laquelle cet environnement de mise en production est associé.
releaseId	integer	Obtient l’ID de mise en production.
scheduledDeploymentTime	string	Obtient l’heure de déploiement planifiée de l’environnement de mise en production.
schedules	ReleaseSchedule[]	Obtient la liste des planifications.
status	EnvironmentStatus	Obtient les status d’environnement.
timeToDeploy	number	Obtient le temps de déploiement.
triggerReason	string	Obtient la raison du déclencheur.
variableGroups	VariableGroup[]	Obtient la liste des groupes de variables.
variables	<string, ConfigurationVariableValue>	Obtient le dictionnaire des variables.

ReleaseEnvironmentShallowReference

Nom	Type	Description
_links	ReferenceLinks	Obtient les liens vers les ressources, LES API et les vues associées pour l’environnement de mise en production.
id	integer	Obtient l’identificateur unique de l’environnement de mise en production.
name	string	Obtient ou définit le nom de l’environnement de mise en production.
url	string	Obtient l’URL de l’API REST pour accéder à l’environnement de mise en production.

ReleaseGates

Nom	Type	Description
deploymentJobs	DeploymentJob[]	Contient les détails du travail de portail de chaque évaluation.
id	integer	ID des portes de mise en production.
ignoredGates	IgnoredGate[]	Liste des portes ignorées.
lastModifiedOn	string	Heure de la dernière modification des portes.
runPlanId	string	Exécuter l’ID de plan des portes.
stabilizationCompletedOn	string	Date et heure de la stabilisation des portes terminées.
startedOn	string	Heure de début de l’évaluation des portes.
status	GateStatus	État des portes de mise en production.
succeedingSince	string	Date et heure auxquelles toutes les portes ont été exécutées avec succès.

ReleaseReason

Obtient le motif de la mise en production.

Nom	Type	Description
continuousIntegration	string	Indique la mise en production déclenchée par l’intégration continue.
manual	string	Indique la mise en production déclenchée manuellement.
none	string	Indique que la raison déclenchée par la mise en production n’est pas définie.
pullRequest	string	Indique la mise en production déclenchée par PullRequest.
schedule	string	Indique la mise en production déclenchée par la planification.

ReleaseSchedule

Nom	Type	Description
daysToRelease	ScheduleDays	Jours de la semaine à publier.
jobId	string	Id de travail de définition de travail Team Foundation.
scheduleOnlyWithChanges	boolean	Indicateur permettant de déterminer si cette planification doit être mise en production uniquement si l’artefact associé a été modifié ou si la définition de mise en production a été modifiée.
startHours	integer	Heure de début du fuseau horaire local.
startMinutes	integer	Minute de fuseau horaire local pour démarrer.
timeZoneId	string	ID de fuseau horaire de la planification de mise en production, par exemple « UTC ».

ReleaseShallowReference

Nom	Type	Description
_links	ReferenceLinks	Obtient les liens vers les ressources, LES API et les vues associées pour la version.
id	integer	Obtient l’identificateur unique de la mise en production.
name	string	Obtient ou définit le nom de la version.
url	string	Obtient l’URL de l’API REST pour accéder à la version.

ReleaseStartEnvironmentMetadata

Nom	Type	Description
definitionEnvironmentId	integer	Définit l’ID d’environnement de définition de mise en production.
variables	<string, ConfigurationVariableValue>	Définit la liste des variables d’environnement à remplacer au moment du déploiement.

ReleaseStartMetadata

Nom	Type	Description
artifacts	ArtifactMetadata[]	Définit la liste de l’artefact pour créer une mise en production.
definitionId	integer	Définit l’ID de définition pour créer une version.
description	string	Définit la description pour créer une version.
environmentsMetadata	ReleaseStartEnvironmentMetadata[]	Définit la liste des métadonnées d’environnements.
isDraft	boolean	Définit « true » pour créer une mise en production en mode brouillon, « false » sinon.
manualEnvironments	string[]	Définit la liste des environnements en tant que condition manuelle.
properties	PropertiesCollection	La classe représente un conteneur de propriétés en tant que collection de paires clé-valeur. Les valeurs de tous les types primitifs (tout type avec un `TypeCode != TypeCode.Object`) à l’exception de sont `DBNull` acceptées. Les valeurs de type Byte[], Int32, Double, DateType et String conservent leur type. D’autres primitives sont réintégés en tant que String. Byte[] attendu en tant que chaîne encodée en base64.
reason	ReleaseReason	Définit la raison de la création d’une version.
variables	<string, ConfigurationVariableValue>	Définit la liste des variables de mise en production à remplacer au moment du déploiement.

ReleaseStatus

Obtient status.

Nom	Type	Description
abandoned	string	Le status de mise en production est abandonné.
active	string	Le status de mise en production est actif.
draft	string	La mise en production est à l’état brouillon.
undefined	string	La mise en production status pas définie.

ReleaseTask

Nom	Type	Description
agentName	string	Nom de l’agent sur lequel la tâche s’est exécutée.
finishTime	string	Heure de fin de la tâche de mise en production.
id	integer	ID de la tâche de mise en production.
issues	Issue[]	Liste des problèmes qui se sont produits lors de l’exécution de la tâche.
lineCount	integer	Nombre de lignes que la tâche de publication du journal a.
logUrl	string	URL du journal de la tâche.
name	string	Nom de la tâche.
percentComplete	integer	L’exécution de la tâche est terminée.
rank	integer	Classement de la tâche de mise en production.
resultCode	string	Code de résultat de la tâche.
startTime	string	ID de la tâche de mise en production.
status	TaskStatus	État de la tâche de mise en production.
task	WorkflowTaskReference	Référence sur les tâches de flux de travail.
timelineRecordId	string	ID d’enregistrement de chronologie de la tâche de mise en production.

ScheduleDays

Jours de la semaine à publier.

Nom	Type	Description
all	string	Planifié tous les jours de la semaine.
friday	string	Prévu le vendredi.
monday	string	Prévu le lundi.
none	string	Jour planifié non défini.
saturday	string	Prévu le samedi.
sunday	string	Prévu le dimanche.
thursday	string	Prévu le jeudi.
tuesday	string	Prévu le mardi.
wednesday	string	Prévu le mercredi.

SourcePullRequestVersion

Nom	Type	Description
iterationId	string	ID d’itération de demande de tirage pour lequel la mise en production publiera status.
pullRequestId	string	ID de demande de tirage pour lequel la mise en production publiera status.
pullRequestMergedAt	string	Date et heure de la création de la fusion de la demande de tirage. Il est nécessaire de conserver chronologie enregistrement des versions créées par une demande de tirage.
sourceBranch	string	Branche source de la demande de tirage.
sourceBranchCommitId	string	ID de validation de branche source de la demande de tirage pour laquelle la mise en production publiera status.
targetBranch	string	Branche cible de la demande de tirage.

TaskInputDefinitionBase

Nom	Type	Description
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

Nom	Type	Description
expression	string	Expression conditionnelle
message	string	Message expliquant comment l’utilisateur peut corriger si la validation échoue

TaskSourceDefinitionBase

Nom	Type	Description
authKey	string
endpoint	string
keySelector	string
selector	string
target	string

TaskStatus

État de la tâche de mise en production.

Nom	Type	Description
canceled	string	L’exécution de la tâche a été annulée.
failed	string	L’exécution de la tâche a échoué.
failure	string	L’exécution de la tâche a échoué.
inProgress	string	La tâche est actuellement en cours.
partiallySucceeded	string	L’exécution de la tâche a partiellement réussi.
pending	string	La tâche est en attente status.
skipped	string	Exécution de la tâche ignorée.
succeeded	string	La tâche a été terminée avec succès.
success	string	La tâche a été terminée avec succès.
unknown	string	La tâche n’a pas le status défini.

VariableGroup

Nom	Type	Description
createdBy	IdentityRef	Obtient ou définit l’identité créée.
createdOn	string	Obtient la date à laquelle il a été créé.
description	string	Obtient ou définit la description.
id	integer	Obtient l’identificateur unique de ce champ.
isShared	boolean	Indique si un groupe de variables est partagé ou non avec un autre projet.
modifiedBy	IdentityRef	Obtient ou définit l’identité qui a été modifiée.
modifiedOn	string	Obtient la date à laquelle il a été modifié.
name	string	Obtient ou définit le nom.
providerData	VariableGroupProviderData	Obtient ou définit les données du fournisseur.
type	string	Obtient ou définit le type.
variableGroupProjectReferences	VariableGroupProjectReference[]	toutes les références de projet où le groupe de variables est partagé avec d’autres projets.
variables	<string, VariableValue>	Obtient et définit le dictionnaire de variables.

VariableGroupProjectReference

Une référence de groupe de variables est une référence superficielle au groupe de variables.

Nom	Type	Description
description	string	Obtient ou définit la description du groupe de variables.
name	string	Obtient ou définit le nom du groupe de variables.
projectReference	ProjectReference	Obtient ou définit les références de projet du groupe de variables.

VariableGroupProviderData

VariableValue

Nom	Type	Description
isReadOnly	boolean	Obtient ou définit si la variable est en lecture seule ou non.
isSecret	boolean	Obtient ou définit car la variable est secrète ou non.
value	string	Obtient ou définit la valeur.

WorkflowTask

Nom	Type	Description
alwaysRun	boolean	Obtient ou définit comme la tâche s’exécute toujours ou non.
condition	string	Obtient ou définit la condition de tâche.
continueOnError	boolean	Obtient ou définit lorsque la tâche continue à s’exécuter en cas d’erreur ou non.
definitionType	string	Obtient ou définit le type de définition de tâche. Exemple :- 'Agent', DeploymentGroup', 'Server' ou 'ServerGate'.
enabled	boolean	Obtient ou définit la tâche activée ou non.
environment	object	Obtient ou définit les variables d’environnement de tâche.
inputs	object	Obtient ou définit les entrées de tâche.
name	string	Obtient ou définit le nom de la tâche.
overrideInputs	object	Obtient ou définit les entrées de remplacement de tâche.
refName	string	Obtient ou définit le nom de référence de la tâche.
retryCountOnTaskFailure	integer	Obtient ou définit la tâche retryCount.
taskId	string	Obtient ou définit l’ID de la tâche.
timeoutInMinutes	integer	Obtient ou définit le délai d’expiration de la tâche.
version	string	Obtient ou définit la version de la tâche.

WorkflowTaskReference

Nom	Type	Description
id	string	Identificateur de tâche.
name	string	Nom de la tâche.
version	string	Version de la tâche.

Partager via