Job Steps - List By Version

Referenz

Dienst:: SQL Database

API-Version:: 2021-11-01

Ruft alle Auftragsschritte in der angegebenen Auftragsversion ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
jobAgentName	path	True	string	Der Name des Auftrags-Agents.
jobName	path	True	string	Der Name des abzurufenden Auftrags.
jobVersion	path	True	integer int32	Die Version des abzurufenden Auftrags.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Name des Servers
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	JobStepListResult	Die Liste der Auftragsschritte wurde erfolgreich abgerufen.
Other Status Codes		Fehlerantworten: *** 404 JobAgentNotFound: Der angegebene Auftrags-Agent ist auf dem angegebenen logischen Server nicht vorhanden. 404 ResourceNotFound: Die angeforderte Ressource wurde nicht gefunden. 404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden. 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

Name

Typ

Beschreibung

200 OK

JobStepListResult

Die Liste der Auftragsschritte wurde erfolgreich abgerufen.

Other Status Codes

Fehlerantworten: ***

404 JobAgentNotFound: Der angegebene Auftrags-Agent ist auf dem angegebenen logischen Server nicht vorhanden.
404 ResourceNotFound: Die angeforderte Ressource wurde nicht gefunden.
404 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden.
404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

Beispiele

List job steps for the specified version of a job.

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/versions/1/steps?api-version=2021-11-01


/**
 * Samples for JobSteps ListByVersion.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ListJobStepsByVersion.json
     */
    /**
     * Sample code: List job steps for the specified version of a job.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listJobStepsForTheSpecifiedVersionOfAJob(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobSteps().listByVersion("group1", "server1", "agent1", "job1",
            1, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "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/versions/1/steps/step1",
      "name": "step1",
      "type": "Microsoft.Sql/servers/jobAgents/jobs/versions/steps"
    },
    {
      "properties": {
        "stepId": 2,
        "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/versions/1/steps/step2",
      "name": "step2",
      "type": "Microsoft.Sql/servers/jobAgents/jobs/versions/steps"
    }
  ]
}

Definitionen

Name	Beschreibung
JobStep	Ein Auftragsschritt.
JobStepAction	Die Aktion, die von einem Auftragsschritt ausgeführt werden soll.
JobStepActionSource	Die Quelle der auszuführenden Aktion.
JobStepActionType	Art der Aktion, die vom Auftragsschritt ausgeführt wird.
JobStepExecutionOptions	Die Ausführungsoptionen eines Auftragsschritts.
JobStepListResult	Eine Liste der Auftragsschritte.
JobStepOutput	Die Ausgabekonfiguration eines Auftragsschritts.
JobStepOutputType	Der Ausgabezieltyp.

JobStep

Ein Auftragsschritt.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.action	JobStepAction	Die Aktionsnutzlast des Auftragsschritts.
properties.credential	string	Die Ressourcen-ID der Auftragsanmeldeinformationen, die zum Herstellen einer Verbindung mit den Zielen verwendet werden.
properties.executionOptions	JobStepExecutionOptions	Ausführungsoptionen für den Auftragsschritt.
properties.output	JobStepOutput	Ausgabezieleigenschaften des Auftragsschritts.
properties.stepId	integer	Der Index des Auftragsschritts innerhalb des Auftrags. Wenn beim Erstellen des Auftragsschritts nicht angegeben, wird er als letzter Schritt erstellt. Wenn beim Aktualisieren des Auftragsschritts nicht angegeben, wird die Schritt-ID nicht geändert.
properties.targetGroup	string	Die Ressourcen-ID der Zielgruppe, für die der Auftragsschritt ausgeführt wird.
type	string	Der Ressourcentyp.

JobStepAction

Die Aktion, die von einem Auftragsschritt ausgeführt werden soll.

Name	Typ	Standardwert	Beschreibung
source	JobStepActionSource	Inline	Die Quelle der auszuführenden Aktion.
type	JobStepActionType	TSql	Art der Aktion, die vom Auftragsschritt ausgeführt wird.
value	string		Der Aktionswert, z. B. der Text des auszuführenden T-SQL-Skripts.

JobStepActionSource

Die Quelle der auszuführenden Aktion.

Name	Typ	Beschreibung
Inline	string

JobStepActionType

Art der Aktion, die vom Auftragsschritt ausgeführt wird.

Name	Typ	Beschreibung
TSql	string

JobStepExecutionOptions

Die Ausführungsoptionen eines Auftragsschritts.

Name	Typ	Standardwert	Beschreibung
initialRetryIntervalSeconds	integer	1	Anfängliche Verzögerung zwischen Wiederholungsversuchen für die Ausführung des Auftragsschritts.
maximumRetryIntervalSeconds	integer	120	Die maximale Wartezeit zwischen Wiederholungen für die Ausführung des Auftragsschritts.
retryAttempts	integer	10	Maximale Anzahl von Wiederholungen des Auftragsschritts, wenn der erste Versuch fehlschlägt.
retryIntervalBackoffMultiplier	number	2	Der Backoff-Multiplizierer für die Zeit zwischen Wiederholungen.
timeoutSeconds	integer	43200	Ausführungstimeout für den Auftragsschritt.

JobStepListResult

Eine Liste der Auftragsschritte.

Name	Typ	Beschreibung
nextLink	string	Link zum Abrufen der nächsten Ergebnisseite.
value	JobStep[]	Array von Ergebnissen.

JobStepOutput

Die Ausgabekonfiguration eines Auftragsschritts.

Name	Typ	Standardwert	Beschreibung
credential	string		Die Ressourcen-ID der Anmeldeinformationen, die zum Herstellen einer Verbindung mit dem Ausgabeziel verwendet werden sollen.
databaseName	string		Die Ausgabezieldatenbank.
resourceGroupName	string		Die Ausgabezielressourcengruppe.
schemaName	string	dbo	Das Zielschema der Ausgabe.
serverName	string		Der Name des Ausgabezielservers.
subscriptionId	string		Die Id des Ausgabezielabonnements.
tableName	string		Die Ausgabezieltabelle.
type	JobStepOutputType	SqlDatabase	Der Ausgabezieltyp.

JobStepOutputType

Der Ausgabezieltyp.

Name	Typ	Beschreibung
SqlDatabase	string

Freigeben über

Job Steps - List By Version

URI-Parameter

Antworten

Beispiele

List job steps for the specified version of a job.

Beispielanforderung

Beispiel für eine Antwort

Definitionen

JobStep

JobStepAction

JobStepActionSource

JobStepActionType

JobStepExecutionOptions

JobStepListResult

JobStepOutput

JobStepOutputType

Zusätzliche Ressourcen