Job Steps - Get

Obtém uma etapa de trabalho na versão atual de um trabalho.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/jobAgents/{jobAgentName}/jobs/{jobName}/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.

jobName
path True

string

O nome da tarefa.

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 do trabalho.

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

JobStep

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 the latest version of a job step.

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

Resposta da amostra

{
  "name": "step1",
  "type": "Microsoft.Sql/servers/jobAgents/jobs/steps",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/steps/step1",
  "properties": {
    "action": {
      "type": "TSql",
      "source": "Inline",
      "value": "select 2"
    },
    "credential": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/credentials/cred1",
    "executionOptions": {
      "initialRetryIntervalSeconds": 11,
      "maximumRetryIntervalSeconds": 222,
      "retryAttempts": 42,
      "retryIntervalBackoffMultiplier": 3,
      "timeoutSeconds": 1234
    },
    "output": {
      "type": "SqlDatabase",
      "credential": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/credentials/cred0",
      "databaseName": "database3",
      "resourceGroupName": "group3",
      "schemaName": "myschema1234",
      "serverName": "server3",
      "subscriptionId": "3501b905-a848-4b5d-96e8-b253f62d735a",
      "tableName": "mytable5678"
    },
    "stepId": 1,
    "targetGroup": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/targetGroups/targetGroup1"
  }
}

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

JobStep

Um passo de trabalho.

JobStepAction

A ação a ser executada por uma etapa de trabalho.

JobStepActionSource

A origem da ação a ser executada.

JobStepActionType

Tipo de ação sendo executada pela etapa de trabalho.

JobStepExecutionOptions

As opções de execução de uma etapa de trabalho.

JobStepOutput

A configuração de saída de uma etapa de trabalho.

JobStepOutputType

O tipo de destino de saída.

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.

JobStep

Um passo de 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.action

JobStepAction

A carga útil da ação da etapa de trabalho.

properties.credential

string

O ID do recurso da credencial de trabalho que será usada para se conectar aos destinos.

properties.executionOptions

JobStepExecutionOptions

Opções de execução para a etapa do trabalho.

properties.output

JobStepOutput

Propriedades de destino de saída da etapa de trabalho.

properties.stepId

integer (int32)

O índice da etapa do trabalho dentro do trabalho. Se não for especificado ao criar a etapa de trabalho, ela será criada como a última etapa. Se não for especificado ao atualizar a etapa de trabalho, a ID da etapa não será modificada.

properties.targetGroup

string

A ID do recurso do grupo-alvo no qual a etapa de trabalho será 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"

JobStepAction

A ação a ser executada por uma etapa de trabalho.

Nome Tipo Valor predefinido Descrição
source

JobStepActionSource

Inline

A origem da ação a ser executada.

type

JobStepActionType

TSql

Tipo de ação sendo executada pela etapa de trabalho.

value

string

O valor da ação, por exemplo, o texto do script T-SQL a ser executado.

JobStepActionSource

A origem da ação a ser executada.

Valor Descrição
Inline

Em linha

JobStepActionType

Tipo de ação sendo executada pela etapa de trabalho.

Valor Descrição
TSql

TSql

JobStepExecutionOptions

As opções de execução de uma etapa de trabalho.

Nome Tipo Valor predefinido Descrição
initialRetryIntervalSeconds

integer (int32)

1

Atraso inicial entre novas tentativas para a execução da etapa do trabalho.

maximumRetryIntervalSeconds

integer (int32)

120

A quantidade máxima de tempo de espera entre novas tentativas para a execução da etapa de trabalho.

retryAttempts

integer (int32)

10

Número máximo de vezes que a etapa do trabalho será repetida se a primeira tentativa falhar.

retryIntervalBackoffMultiplier

number (float)

2

O multiplicador de backoff para o tempo entre as tentativas.

timeoutSeconds

integer (int32)

43200

Tempo limite de execução para a etapa de trabalho.

JobStepOutput

A configuração de saída de uma etapa de trabalho.

Nome Tipo Valor predefinido Descrição
credential

string

A ID do recurso da credencial a ser usada para se conectar ao destino de saída.

databaseName

string

O banco de dados de destino de saída.

resourceGroupName

string

O grupo de recursos de destino de saída.

schemaName

string

dbo

O esquema de destino de saída.

serverName

string

O nome do servidor de destino de saída.

subscriptionId

string (uuid)

A ID da assinatura de destino de saída.

tableName

string

A tabela de destino de saída.

type

JobStepOutputType

SqlDatabase

O tipo de destino de saída.

JobStepOutputType

O tipo de destino de saída.

Valor Descrição
SqlDatabase

SqlDatabase

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.