Targets - Get

Ссылка

Service:: Task Agent

API Version:: 5.0-preview.1

Получение целевого объекта развертывания по его идентификатору в группе развертывания

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

With optional parameters:

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
deploymentGroupId	path	True	integer int32	Идентификатор группы развертывания, к которой принадлежит целевой объект развертывания.
organization	path	True	string	Название организации Azure DevOps.
project	path	True	string	Идентификатор или имя проекта
targetId	path	True	integer int32	Идентификатор возвращаемого целевого объекта развертывания.
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 5.0-preview.1.
$expand	query		DeploymentTargetExpands	Включите эти дополнительные сведения в возвращаемые объекты.

Ответы

Имя	Тип	Описание
200 OK	DeploymentMachine	успешная операция

Безопасность

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.machinegroup_manage	Предоставляет возможность управления группами развертывания и пулами агентов.

Примеры

Get a deployment target by its ID

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "tags": [
    "web"
  ],
  "id": 5,
  "agent": {
    "_links": {
      "self": {
        "href": "https://dev.azure.com/fabrikam/_apis/distributedtask/pools/17/agents/5"
      },
      "web": {
        "href": "https://dev.azure.com/fabrikam/_admin/_AgentPool#_a=agents&poolId=17&agentId=5"
      }
    },
    "maxParallelism": 1,
    "createdOn": "2018-02-19T09:19:41.053Z",
    "authorization": {
      "clientId": "0f386203-17f5-45a6-8c72-d35b54011fe3",
      "publicKey": {
        "exponent": "AQAB",
        "modulus": "6O7UGxhRniv3tmXJ/1kaEkZdbcNQabJBJxj3EhPNsBJuduYZt3OixVTI/X5r1C2ogAr0nQon2UP3HKNQ9bkY7fNAY8VfggOTytu4ZfFcTJABvc5X8pHefWfO2DVqOUJH6HpyOtP5C+b2OGuhzTlEJHv6FrJPWxbK1HEo0w6VQg4CI8VqyCY9pvT6ZTrZTSg1Hp4uGF/kDHtUk0GvYWA2hZJyk/VbX7hH1PhwpRHuIEUsT0TcJzrR+7n0gdLDGeNLYqBMmTXIMm6jv7pUdnOumI9FK9hChw3JbP44jVxlxGbV8kh+IKAX/S3+pdkCNOiKzkXIDtUu/3vWiqx6+v8mIQ=="
      }
    },
    "id": 5,
    "name": "demoTarget1",
    "version": "2.127.0",
    "osDescription": "Microsoft Windows 10.0.14393 ",
    "enabled": true,
    "status": "online"
  }
}

Определения

Имя	Описание
Demand
DeploymentMachine	Целевой объект развертывания.
DeploymentTargetExpands	Включите эти дополнительные сведения в возвращаемые объекты.
IdentityRef
JObject
JToken
PackageVersion
PropertiesCollection	Класс представляет контейнер свойств в виде коллекции пар "ключ-значение". Принимаются значения всех примитивных типов (любой `TypeCode != TypeCode.Object`тип с ), кроме `DBNull` . Значения типа Byte[], Int32, Double, DateType и String сохраняют свой тип, другие примитивы перенастраиваются как String. Byte[] ожидается как строка в кодировке Base64.
ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
TaskAgent
TaskAgentAuthorization	Предоставляет данные, необходимые для авторизации агента с помощью потоков проверки подлинности OAuth 2.0.
TaskAgentCloudRequest
TaskAgentDelaySource
TaskAgentJobRequest
TaskAgentPoolReference
TaskAgentPoolType	Возвращает или задает тип пула.
TaskAgentPublicKey	Представляет часть асимметричного ключа RSA с открытым ключом.
TaskAgentReference
TaskAgentStatus	Возвращает текущее состояние подключения агента.
TaskAgentUpdate
TaskAgentUpdateReason
TaskAgentUpdateReasonType
TaskOrchestrationOwner
TaskResult

Demand

Имя	Тип	Описание
name	string
value	string

DeploymentMachine

Целевой объект развертывания.

Имя	Тип	Описание
agent	TaskAgent	Агент развертывания.
id	integer	Идентификатор целевого объекта развертывания.
tags	string[]	Теги целевого объекта развертывания.

DeploymentTargetExpands

Включите эти дополнительные сведения в возвращаемые объекты.

Имя	Тип	Описание
assignedRequest	string	Включите запрос задания, назначенный агенту развертывания.
capabilities	string	Включите возможности агента развертывания.
lastCompletedRequest	string	Включите последний завершенный запрос задания агента развертывания.
none	string	Дополнительные свойства отсутствуют.

IdentityRef

Имя	Тип	Описание
_links	ReferenceLinks	Это поле содержит ноль или более интересных ссылок на тему графа. Эти ссылки можно вызвать для получения дополнительных связей или более подробных сведений об этой теме графа.
descriptor	string	Дескриптор является основным способом ссылки на субъект графа во время работы системы. Это поле однозначно идентифицирует одну и ту же тему графа как в учетных записях, так и в организациях.
directoryAlias	string
displayName	string	Это неуникальное отображаемое имя субъекта графа. Чтобы изменить это поле, необходимо изменить его значение в поставщике источника.
id	string
imageUrl	string
inactive	boolean
isAadIdentity	boolean
isContainer	boolean
isDeletedInOrigin	boolean
profileUrl	string
uniqueName	string
url	string	Этот URL-адрес представляет собой полный маршрут к исходному ресурсу этого субъекта графа.

JObject

Имя	Тип	Описание
item	JToken
type	string

JToken

Имя	Тип	Описание
first	JToken
hasValues	boolean
item	JToken
last	JToken
next	JToken
parent	string
path	string
previous	JToken
root	JToken
type	string

PackageVersion

Имя	Тип	Описание
major	integer
minor	integer
patch	integer

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	Представление ссылок только для чтения. Так как ссылочные ссылки доступны только для чтения, мы хотим предоставить их только для чтения.

TaskAgent

Имя	Тип	Описание
_links	ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
accessPoint	string	Возвращает точку доступа агента.
assignedAgentCloudRequest	TaskAgentCloudRequest	Возвращает облачный запрос агента, связанный в данный момент с этим агентом.
assignedRequest	TaskAgentJobRequest	Возвращает запрос, назначенный данному агенту.
authorization	TaskAgentAuthorization	Возвращает или задает сведения об авторизации для этого агента.
createdOn	string	Возвращает дату создания этого агента.
enabled	boolean	Возвращает или задает значение, указывающее, должен ли этот агент быть включен для выполнения задания.
id	integer	Возвращает идентификатор агента.
lastCompletedRequest	TaskAgentJobRequest	Возвращает последний запрос, выполненный этим агентом.
maxParallelism	integer	Возвращает или задает максимальный параллелизм заданий, разрешенный на этом узле.
name	string	Возвращает имя агента.
oSDescription	string	Возвращает ОС агента.
pendingUpdate	TaskAgentUpdate	Возвращает ожидающее обновление для этого агента.
properties	PropertiesCollection	Класс представляет контейнер свойств в виде коллекции пар "ключ-значение". Принимаются значения всех примитивных типов (любой `TypeCode != TypeCode.Object`тип с ), кроме `DBNull` . Значения типа Byte[], Int32, Double, DateType и String сохраняют свой тип, другие примитивы перенастраиваются как String. Byte[] ожидается как строка в кодировке Base64.
provisioningState	string	Возвращает или задает текущее состояние подготовки этого агента.
status	TaskAgentStatus	Возвращает текущее состояние подключения агента.
statusChangedOn	string	Возвращает дату последнего изменения состояния подключения.
systemCapabilities	object
userCapabilities	object
version	string	Возвращает версию агента.

TaskAgentAuthorization

Предоставляет данные, необходимые для авторизации агента с помощью потоков проверки подлинности OAuth 2.0.

Имя	Тип	Описание
authorizationUrl	string	Возвращает или задает конечную точку, используемую для получения маркеров доступа из настроенной службы маркеров.
clientId	string	Возвращает или задает идентификатор клиента для этого агента.
publicKey	TaskAgentPublicKey	Возвращает или задает открытый ключ, используемый для проверки удостоверения этого агента.

TaskAgentCloudRequest

Имя	Тип	Описание
agent	TaskAgentReference
agentCloudId	integer
agentConnectedTime	string
agentData	JObject
agentSpecification	JObject
pool	TaskAgentPoolReference
provisionRequestTime	string
provisionedTime	string
releaseRequestTime	string
requestId	string

TaskAgentDelaySource

Имя	Тип	Описание
delays	string[]
taskAgent	TaskAgentReference

TaskAgentJobRequest

Имя	Тип	Описание
agentDelays	TaskAgentDelaySource[]
agentSpecification	JObject
assignTime	string
data	object
definition	TaskOrchestrationOwner
demands	Demand[]
expectedDuration	string
finishTime	string
hostId	string
jobId	string
jobName	string
lockedUntil	string
matchedAgents	TaskAgentReference[]
orchestrationId	string
owner	TaskOrchestrationOwner
planGroup	string
planId	string
planType	string
poolId	integer
queueId	integer
queueTime	string
receiveTime	string
requestId	integer
reservedAgent	TaskAgentReference
result	TaskResult
scopeId	string
serviceOwner	string

TaskAgentPoolReference

Имя	Тип	Описание
id	integer
isHosted	boolean	Возвращает или задает значение, указывающее, управляется ли этот пул службой.
name	string
poolType	TaskAgentPoolType	Возвращает или задает тип пула.
scope	string
size	integer	Возвращает текущий размер пула.

TaskAgentPoolType

Возвращает или задает тип пула.

Имя	Тип	Описание
automation	string
deployment	string

TaskAgentPublicKey

Представляет часть асимметричного ключа RSA с открытым ключом.

Имя	Тип	Описание
exponent	string[]	Возвращает или задает экспоненту для открытого ключа.
modulus	string[]	Возвращает или задает модуль открытого ключа.

TaskAgentReference

Имя	Тип	Описание
_links	ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
accessPoint	string	Возвращает точку доступа агента.
enabled	boolean	Возвращает или задает значение, указывающее, должен ли этот агент быть включен для выполнения задания.
id	integer	Возвращает идентификатор агента.
name	string	Возвращает имя агента.
oSDescription	string	Возвращает ОС агента.
provisioningState	string	Возвращает или задает текущее состояние подготовки этого агента.
status	TaskAgentStatus	Возвращает текущее состояние подключения агента.
version	string	Возвращает версию агента.

TaskAgentStatus

Возвращает текущее состояние подключения агента.

Имя	Тип	Описание
offline	string
online	string

TaskAgentUpdate

Имя	Тип	Описание
currentState	string	Текущее состояние обновления агента
reason	TaskAgentUpdateReason	Причина обновления агента
requestTime	string	Возвращает дату, в которую было запрошено обновление агента.
requestedBy	IdentityRef	Удостоверение, запрашивающее обновление агента
sourceVersion	PackageVersion	Возвращает или задает версию исходного агента обновления агента.
targetVersion	PackageVersion	Возвращает или задает версию целевого агента обновления агента.

TaskAgentUpdateReason

Имя	Тип	Описание
code	TaskAgentUpdateReasonType

TaskAgentUpdateReasonType

Имя	Тип	Описание
manual	string
minAgentVersionRequired	string

TaskOrchestrationOwner

Имя	Тип	Описание
_links	ReferenceLinks	Класс, представляющий коллекцию ссылок REST.
id	integer
name	string

TaskResult

Имя	Тип	Описание
abandoned	string
canceled	string
failed	string
skipped	string
succeeded	string
succeededWithIssues	string

Поделиться через