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 |
|---|---|---|---|---|
|
job
|
path | True |
string |
Nazwa agenta zadania. |
|
job
|
path | True |
string |
Nazwa zadania. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
server
|
path | True |
string |
Nazwa serwera. |
|
step
|
path | True |
string |
Nazwa kroku zadania. |
|
subscription
|
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 |
Operacja Azure zakończyła się pomyślnie. |
|
| Other Status Codes |
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 |
|---|---|
|
created |
Typ tożsamości, która utworzyła zasób. |
|
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
|
Error |
Szczegóły błędu. |
|
Error |
Odpowiedź na błąd |
|
Job |
Krok zadania. |
|
Job |
Akcja do wykonania przez krok zadania. |
|
Job |
Źródło akcji do wykonania. |
|
Job |
Typ akcji wykonywanej przez krok zadania. |
|
Job |
Opcje wykonywania kroku zadania. |
|
Job |
Konfiguracja danych wyjściowych kroku zadania. |
|
Job |
Typ miejsca docelowego danych wyjściowych. |
|
system |
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 |
Błąd dodatkowe informacje. |
|
| code |
string |
Kod błędu. |
| details |
Szczegóły błędu. |
|
| message |
string |
Komunikat o błędzie. |
| target |
string |
Cel błędu. |
ErrorResponse
Odpowiedź na błąd
| Nazwisko | Typ | Opis |
|---|---|---|
| error |
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 |
Ł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 |
Opcje wykonywania dla kroku zadania. |
|
| properties.output |
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 |
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 | Inline |
Źródło akcji do wykonania. |
|
| type | 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 | 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 |
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 |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |