Sdílet prostřednictvím

Job Steps - Get

  • Reference
Služba:
SQL Database
Verze rozhraní API:
2021-11-01

Získá krok úlohy v aktuální verzi úlohy.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
jobAgentName
 path True

string

Název agenta úloh.
jobName
 path True

string

Název úlohy.
resourceGroupName
 path True

string

Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu.
serverName
 path True

string

Název serveru.
stepName
 path True

string

Název kroku úlohy.
subscriptionId
 path True

string

ID předplatného, které identifikuje předplatné Azure.
api-version
 query True

string

Verze rozhraní API, která se má použít pro požadavek.

Odpovědi

Name Typ Description
200 OK

JobStep

Krok úlohy se úspěšně načetl.
Other Status Codes

Chybové odpovědi: ***

  • 404 JobAgentNotFound – Zadaný agent úlohy na zadaném logickém serveru neexistuje.

  • 404 ResourceNotFound – Požadovaný prostředek nebyl nalezen.

  • 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen.

  • 404 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném.

Příklady

Get the latest version of a job step.

Ukázkový požadavek

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=2021-11-01

Ukázková odpověď

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

Definice

Name Description
JobStep

Krok úlohy.
JobStepAction

Akce, která se má provést krokem úlohy.
JobStepActionSource

Zdroj akce, která se má provést.
JobStepActionType

Typ akce, kterou provádí krok úlohy
JobStepExecutionOptions

Možnosti spuštění kroku úlohy.
JobStepOutput

Výstupní konfigurace kroku úlohy.
JobStepOutputType

Typ výstupního cíle.

JobStep

Objekt

Krok úlohy.

Name Typ Description
id

string

ID prostředku.
name

string

Název prostředku
properties.action

JobStepAction

Datová část akce kroku úlohy.
properties.credential

string

ID prostředku přihlašovacích údajů úlohy, které se použijí pro připojení k cílům.
properties.executionOptions

JobStepExecutionOptions

Možnosti spuštění kroku úlohy
properties.output

JobStepOutput

Výstupní cílové vlastnosti kroku úlohy.
properties.stepId

integer (int32)

Index kroku úlohy v rámci úlohy. Pokud při vytváření kroku úlohy nezadáte, vytvoří se jako poslední krok. Pokud není zadáno při aktualizaci kroku úlohy, ID kroku se nezmění.
properties.targetGroup

string

ID prostředku cílové skupiny, na které se bude krok úlohy spouštět.
type

string

Typ zdroje.

JobStepAction

Objekt

Akce, která se má provést krokem úlohy.

Name Typ Default value Description
source

JobStepActionSource

Inline

Zdroj akce, která se má provést.
type

JobStepActionType

TSql

Typ akce, kterou provádí krok úlohy
value

string

Hodnota akce, například text skriptu T-SQL, který se má spustit.

JobStepActionSource

Výčet

Zdroj akce, která se má provést.

Hodnota Description
Inline

JobStepActionType

Výčet

Typ akce, kterou provádí krok úlohy

Hodnota Description
TSql

JobStepExecutionOptions

Objekt

Možnosti spuštění kroku úlohy.

Name Typ Default value Description
initialRetryIntervalSeconds

integer (int32)

1

Počáteční prodleva mezi opakovanými pokusy o spuštění kroku úlohy.
maximumRetryIntervalSeconds

integer (int32)

120

Maximální doba čekání mezi opakovanými pokusy o spuštění kroku úlohy.
retryAttempts

integer (int32)

10

Maximální počet opakování kroku úlohy, pokud první pokus selže.
retryIntervalBackoffMultiplier

number (float)

2

Násobitel backoff pro dobu mezi opakovanými pokusy.
timeoutSeconds

integer (int32)

43200

Časový limit spuštění kroku úlohy

JobStepOutput

Objekt

Výstupní konfigurace kroku úlohy.

Name Typ Default value Description
credential

string

ID prostředku přihlašovacích údajů, které se mají použít pro připojení k výstupnímu cíli.
databaseName

string

Výstupní cílová databáze.
resourceGroupName

string

Výstupní cílová skupina prostředků.
schemaName

string

dbo

Výstupní cílové schéma.
serverName

string

Název výstupního cílového serveru.
subscriptionId

string (uuid)

ID výstupního cílového předplatného.
tableName

string

Výstupní cílová tabulka.
type

JobStepOutputType

SqlDatabase

Typ výstupního cíle.

JobStepOutputType

Výčet

Typ výstupního cíle.

Hodnota Description
SqlDatabase