Job Steps - Get

Pobiera krok zadania w bieżącej wersji zadania.

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

Parametry identyfikatora URI

Nazwisko W Wymagane Typ Opis
jobAgentName
path True

string

Nazwa agenta zadania.

jobName
path True

string

Nazwa zadania.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

serverName
path True

string

Nazwa serwera.

stepName
path True

string

Nazwa kroku zadania.

subscriptionId
path True

string (uuid)

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwisko Typ Opis
200 OK

JobStep

Operacja Azure zakończyła się pomyślnie.

Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwisko Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Get the latest version of a job step.

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "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"
  }
}

Definicje

Nazwisko Opis
createdByType

Typ tożsamości, która utworzyła zasób.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

JobStep

Krok zadania.

JobStepAction

Akcja do wykonania przez krok zadania.

JobStepActionSource

Źródło akcji do wykonania.

JobStepActionType

Typ akcji wykonywanej przez krok zadania.

JobStepExecutionOptions

Opcje wykonywania kroku zadania.

JobStepOutput

Konfiguracja danych wyjściowych kroku zadania.

JobStepOutputType

Typ miejsca docelowego danych wyjściowych.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Typ tożsamości, która utworzyła zasób.

Wartość Opis
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwisko Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwisko Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Błąd dodatkowe informacje.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Cel błędu.

ErrorResponse

Odpowiedź na błąd

Nazwisko Typ Opis
error

ErrorDetail

Obiekt błędu.

JobStep

Krok zadania.

Nazwisko Typ Opis
id

string (arm-id)

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nazwa zasobu

properties.action

JobStepAction

Ładunek akcji kroku zadania.

properties.credential

string

Identyfikator zasobu poświadczenia zadania, który będzie używany do łączenia się z obiektami docelowymi.

properties.executionOptions

JobStepExecutionOptions

Opcje wykonywania dla kroku zadania.

properties.output

JobStepOutput

Wyjściowe właściwości docelowe kroku zadania.

properties.stepId

integer (int32)

Indeks kroku zadania w ramach zadania. Jeśli nie zostanie określony podczas tworzenia kroku zadania, zostanie on utworzony jako ostatni krok. Jeśli nie zostanie określony podczas aktualizowania kroku zadania, identyfikator kroku nie zostanie zmodyfikowany.

properties.targetGroup

string

Identyfikator zasobu grupy docelowej, dla którego zostanie wykonany krok zadania.

systemData

systemData

Metadane Azure Resource Manager zawierające informacje createdBy i modifiedBy.

type

string

Typ zasobu. Np. "Microsoft. Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts"

JobStepAction

Akcja do wykonania przez krok zadania.

Nazwisko Typ Domyślna wartość Opis
source

JobStepActionSource

Inline

Źródło akcji do wykonania.

type

JobStepActionType

TSql

Typ akcji wykonywanej przez krok zadania.

value

string

Wartość akcji, na przykład tekst skryptu T-SQL do wykonania.

JobStepActionSource

Źródło akcji do wykonania.

Wartość Opis
Inline

W linii

JobStepActionType

Typ akcji wykonywanej przez krok zadania.

Wartość Opis
TSql

TSql

JobStepExecutionOptions

Opcje wykonywania kroku zadania.

Nazwisko Typ Domyślna wartość Opis
initialRetryIntervalSeconds

integer (int32)

1

Początkowe opóźnienie między ponowną próbą wykonania kroku zadania.

maximumRetryIntervalSeconds

integer (int32)

120

Maksymalny czas oczekiwania między ponowną próbą wykonania kroku zadania.

retryAttempts

integer (int32)

10

Maksymalna liczba powtórzeń kroku zadania w przypadku niepowodzenia pierwszej próby.

retryIntervalBackoffMultiplier

number (float)

2

Mnożnik wycofywania dla czasu między ponowną próbą.

timeoutSeconds

integer (int32)

43200

Limit czasu wykonywania dla kroku zadania.

JobStepOutput

Konfiguracja danych wyjściowych kroku zadania.

Nazwisko Typ Domyślna wartość Opis
credential

string

Identyfikator zasobu poświadczenia do użycia w celu nawiązania połączenia z miejscem docelowym danych wyjściowych.

databaseName

string

Wyjściowa docelowa baza danych.

resourceGroupName

string

Wyjściowa docelowa grupa zasobów.

schemaName

string

dbo

Schemat docelowy danych wyjściowych.

serverName

string

Nazwa wyjściowego serwera docelowego.

subscriptionId

string (uuid)

Wyjściowy identyfikator subskrypcji docelowej.

tableName

string

Tabela docelowa danych wyjściowych.

type

JobStepOutputType

SqlDatabase

Typ miejsca docelowego danych wyjściowych.

JobStepOutputType

Typ miejsca docelowego danych wyjściowych.

Wartość Opis
SqlDatabase

SqlDatabase

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwisko Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string (date-time)

Znacznik czasu ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.