Freigeben über

Targets - Delete

  • Referenz
Service:
Task Agent
API Version:
5.0-preview.1

Löschen Sie ein Bereitstellungsziel in einer Bereitstellungsgruppe. Dadurch wird der Agent auch aus dem zugeordneten Bereitstellungspool gelöscht.

DELETE https://dev.azure.com/{organization}/{project}/_apis/distributedtask/deploymentgroups/{deploymentGroupId}/targets/{targetId}?api-version=5.0-preview.1

URI-Parameter

Name In Erforderlich Typ Beschreibung
deploymentGroupId
 path True

integer

int32

ID der Bereitstellungsgruppe, in der das Bereitstellungsziel gelöscht wird.
organization
 path True

string

Der Name der Azure DevOps-Organisation.
project
 path True

string

Projekt-ID oder Projektname
targetId
 path True

integer

int32

ID des zu löschenden Bereitstellungsziels.
api-version
 query True

string

Version der zu verwendenden API. Dies sollte auf "5.0-preview.1" festgelegt werden, um diese Version der API zu verwenden.

Antworten

Name Typ Beschreibung
200 OK

Erfolgreicher Vorgang

Sicherheit

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

Name Beschreibung
vso.machinegroup_manage Ermöglicht die Verwaltung von Bereitstellungsgruppen und Agentpools

Beispiele

Delete a deployment target

Sample Request

DELETE https://dev.azure.com/fabrikam/{project}/_apis/distributedtask/deploymentgroups/{deploymentGroupId}/targets/{targetId}?api-version=5.0-preview.1

Sample Response

Status code:
204