Job Step Executions - Get

Obtém uma execução de etapa de uma execução de trabalho.

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

Parâmetros do URI

Nome Em Obrigatório Tipo Descrição
jobAgentName
path True

string

O nome do agente de trabalho.

jobExecutionId
path True

string (uuid)

O id exclusivo da execução do trabalho

jobName
path True

string

O nome do trabalho a obter.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

serverName
path True

string

O nome do servidor.

stepName
path True

string

O nome da etapa.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Respostas

Nome Tipo Descrição
200 OK

JobExecution

Operação do Azure concluída com sucesso.

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Nome Descrição
user_impersonation personificar a sua conta de utilizador

Exemplos

Get a job step execution

Pedido de amostra

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?api-version=2025-01-01

Resposta da amostra

{
  "name": "step1",
  "type": "Microsoft.Sql/servers/jobAgents/jobs/executions/steps",
  "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",
  "properties": {
    "createTime": "2017-12-27T04:33:15.7189151Z",
    "currentAttemptStartTime": "2017-12-27T04:33:17.4840068Z",
    "currentAttempts": 1,
    "endTime": "2017-12-27T04:33:19.0600862Z",
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "jobVersion": 1,
    "lastMessage": "Step 1 succeeded.",
    "lifecycle": "Succeeded",
    "provisioningState": "Succeeded",
    "startTime": "2017-12-27T04:33:16.176937Z",
    "stepId": 1,
    "stepName": "step1"
  }
}

Definições

Nome Descrição
createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

JobExecution

Uma execução de um trabalho

JobExecutionLifecycle

O estado detalhado da execução do trabalho.

JobExecutionTarget

O destino no qual uma execução de trabalho é executada.

JobTargetType

O tipo do alvo.

ProvisioningState

O estado de provisionamento ARM da execução do trabalho.

systemData

Metadados referentes à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Valor Descrição
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

O erro de gerenciamento de recursos informações adicionais.

Nome Tipo Descrição
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Descrição
additionalInfo

ErrorAdditionalInfo[]

O erro informações adicionais.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O alvo do erro.

ErrorResponse

Resposta de erro

Nome Tipo Descrição
error

ErrorDetail

O objeto de erro.

JobExecution

Uma execução de um trabalho

Nome Tipo Descrição
id

string (arm-id)

ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties.createTime

string (date-time)

A hora em que a execução do trabalho foi criada.

properties.currentAttemptStartTime

string (date-time)

Hora de início da tentativa atual.

properties.currentAttempts

integer (int32)

Número de vezes que a execução do trabalho foi tentada.

properties.endTime

string (date-time)

O tempo que a execução do trabalho foi concluída.

properties.jobExecutionId

string (uuid)

O identificador exclusivo da execução do trabalho.

properties.jobVersion

integer (int32)

O número da versão do trabalho.

properties.lastMessage

string

O último status ou mensagem de erro.

properties.lifecycle

JobExecutionLifecycle

O estado detalhado da execução do trabalho.

properties.provisioningState

ProvisioningState

O estado de provisionamento ARM da execução do trabalho.

properties.startTime

string (date-time)

A hora em que a execução do trabalho começou.

properties.stepId

integer (int32)

O ID da etapa do trabalho.

properties.stepName

string

O nome da etapa do trabalho.

properties.target

JobExecutionTarget

O destino no qual essa execução é executada.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft. Computação/Máquinas Virtuais" ou "Microsoft. ContasArmazenamento/Armazenamento"

JobExecutionLifecycle

O estado detalhado da execução do trabalho.

Valor Descrição
Created

Criado

InProgress

Em curso

WaitingForChildJobExecutions

À Espera DeEmpregoCriançaExecuções

WaitingForRetry

À EsperaParaTentativa

Succeeded

Succeeded

SucceededWithSkipped

ConseguidoComSkipped

Failed

Falha

TimedOut

Tempo Limite Excedido

Canceled

Cancelado

Skipped

Omitida

JobExecutionTarget

O destino no qual uma execução de trabalho é executada.

Nome Tipo Descrição
databaseName

string

O nome do banco de dados.

serverName

string

O nome do servidor.

type

JobTargetType

O tipo do alvo.

JobTargetType

O tipo do alvo.

Valor Descrição
TargetGroup

Grupo-Alvo

SqlDatabase

SqlDatabase

SqlElasticPool

SqlElasticPool

SqlShardMap

SqlShardMap

SqlServer

SqlServer

ProvisioningState

O estado de provisionamento ARM da execução do trabalho.

Valor Descrição
Created

Criado

InProgress

Em curso

Succeeded

Succeeded

Failed

Falha

Canceled

Cancelado

systemData

Metadados referentes à criação e última modificação do recurso.

Nome Tipo Descrição
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.