Job Target Executions - List By Step

Ссылка

Служба:: SQL Database

Версия API:: 2021-11-01

Списки целевые выполнения шага задания.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/jobs/{jobName}/executions/{jobExecutionId}/steps/{stepName}/targets?api-version=2021-11-01

С использованием необязательных параметров:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/jobs/{jobName}/executions/{jobExecutionId}/steps/{stepName}/targets?createTimeMin={createTimeMin}&createTimeMax={createTimeMax}&endTimeMin={endTimeMin}&endTimeMax={endTimeMax}&isActive={isActive}&$skip={$skip}&$top={$top}&api-version=2021-11-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
jobAgentName	path	True	string	Имя агента задания.
jobExecutionId	path	True	string uuid	Идентификатор выполнения задания
jobName	path	True	string	Имя получаемого задания.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
serverName	path	True	string	Имя сервера.
stepName	path	True	string	Имя шага этапа.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.
$skip	query		integer int64	Количество элементов в коллекции, которые необходимо пропустить.
$top	query		integer int64	Количество элементов, возвращаемых из коллекции.
createTimeMax	query		string date-time	Если этот параметр указан, включаются только выполнения заданий, созданные до указанного времени.
createTimeMin	query		string date-time	Если этот параметр указан, включаются только выполнения заданий, созданных в указанное время или после него.
endTimeMax	query		string date-time	Если этот параметр указан, включаются только выполнения заданий, завершенных до указанного времени.
endTimeMin	query		string date-time	Если этот параметр указан, включаются только выполнения заданий, завершенных в указанное время или после него.
isActive	query		boolean	Если этот параметр указан, включаются только активные или только завершенные выполнения заданий.

Ответы

Имя	Тип	Описание
200 OK	JobExecutionListResult	Целевые выполнения успешно получены.
Other Status Codes		Ответы об ошибках: *** 404 JobAgentNotFound — указанный агент задания не существует на указанном логическом сервере. 404 ResourceNotFound — запрошенный ресурс не найден. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден. 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

Имя

Тип

Описание

200 OK

JobExecutionListResult

Целевые выполнения успешно получены.

Other Status Codes

Ответы об ошибках: ***

404 JobAgentNotFound — указанный агент задания не существует на указанном логическом сервере.
404 ResourceNotFound — запрошенный ресурс не найден.
404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден.
404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке.

Примеры

List job step target executions

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/5A86BF65-43AC-F258-2524-9E92992F97CA/steps/step1/targets?api-version=2021-11-01


import java.util.UUID;

/**
 * Samples for JobTargetExecutions ListByStep.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ListJobExecutionTargetsByStep.json
     */
    /**
     * Sample code: List job step target executions.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listJobStepTargetExecutions(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobTargetExecutions().listByStep("group1", "server1", "agent1",
            "job1", UUID.fromString("5A86BF65-43AC-F258-2524-9E92992F97CA"), "step1", null, null, null, null, null,
            null, null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Пример ответа

Код состояния:: 200

{
  "value": [
    {
      "properties": {
        "jobVersion": 1,
        "stepName": "step1",
        "stepId": 1,
        "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
        "lifecycle": "Succeeded",
        "provisioningState": "Succeeded",
        "createTime": "2017-07-01T04:33:17.5133333Z",
        "startTime": "2017-07-01T04:33:18.1230403Z",
        "endTime": "2017-07-01T04:33:18.7031029Z",
        "currentAttempts": 1,
        "currentAttemptStartTime": "2017-07-01T04:33:18.2391013Z",
        "lastMessage": "Step 1 succeeded execution on target (server 'server1', database 'database1').",
        "target": {
          "type": "SqlDatabase",
          "serverName": "server1",
          "databaseName": "database1"
        }
      },
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/5555-6666-7777-8888-999999999999/steps/step1/targets/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "name": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
      "type": "Microsoft.Sql/servers/jobAgents/jobs/executions/steps/targets"
    }
  ]
}

Определения

Имя	Описание
JobExecution	Выполнение задания
JobExecutionLifecycle	Подробное состояние выполнения задания.
JobExecutionListResult	Список выполнений заданий.
JobExecutionTarget	Целевой объект, в который выполняется выполнение задания.
JobTargetType	Тип цели.
ProvisioningState	Состояние подготовки ARM для выполнения задания.

JobExecution

Выполнение задания

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.createTime	string	Время создания задания.
properties.currentAttemptStartTime	string	Время начала текущей попытки.
properties.currentAttempts	integer	Количество попыток выполнения задания.
properties.endTime	string	Время завершения выполнения задания.
properties.jobExecutionId	string	Уникальный идентификатор выполнения задания.
properties.jobVersion	integer	Номер версии задания.
properties.lastMessage	string	Последнее состояние или сообщение об ошибке.
properties.lifecycle	JobExecutionLifecycle	Подробное состояние выполнения задания.
properties.provisioningState	ProvisioningState	Состояние подготовки ARM для выполнения задания.
properties.startTime	string	Время начала выполнения задания.
properties.stepId	integer	Идентификатор шага задания.
properties.stepName	string	Имя шага задания.
properties.target	JobExecutionTarget	Целевой объект, на который выполняется это выполнение.
type	string	Тип ресурса.

JobExecutionLifecycle

Подробное состояние выполнения задания.

Имя	Тип	Описание
Canceled	string
Created	string
Failed	string
InProgress	string
Skipped	string
Succeeded	string
SucceededWithSkipped	string
TimedOut	string
WaitingForChildJobExecutions	string
WaitingForRetry	string

JobExecutionListResult

Список выполнений заданий.

Имя	Тип	Описание
nextLink	string	Ссылка для получения следующей страницы результатов.
value	JobExecution[]	Массив результатов.

JobExecutionTarget

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

Имя	Тип	Описание
databaseName	string	Имя базы данных.
serverName	string	Имя сервера.
type	JobTargetType	Тип цели.

JobTargetType

Тип цели.

Имя	Тип	Описание
SqlDatabase	string
SqlElasticPool	string
SqlServer	string
SqlShardMap	string
TargetGroup	string

ProvisioningState

Состояние подготовки ARM для выполнения задания.

Имя	Тип	Описание
Canceled	string
Created	string
Failed	string
InProgress	string
Succeeded	string

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

Job Target Executions - List By Step

Параметры URI

Ответы

Примеры

List job step target executions

Образец запроса

Пример ответа

Определения

JobExecution

JobExecutionLifecycle

JobExecutionListResult

JobExecutionTarget

JobTargetType

ProvisioningState

Дополнительные ресурсы