Job Steps - Get

Referencia

Szolgáltatás:: SQL Database

API-verzió:: 2021-11-01

Lekéri a feladatlépést egy feladat aktuális verziójában.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
jobAgentName	path	True	string	A feladatügynök neve.
jobName	path	True	string	A feladat neve.
resourceGroupName	path	True	string	Az erőforrást tartalmazó erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból vagy a portálról szerezheti be.
serverName	path	True	string	A kiszolgáló neve.
stepName	path	True	string	A feladatlépés neve.
subscriptionId	path	True	string	Az Azure-előfizetést azonosító előfizetés-azonosító.
api-version	query	True	string	A kéréshez használni kívánt API-verzió.

Válaszok

Name	Típus	Description
200 OK	JobStep	Sikeresen lekérte a feladatlépést.
Other Status Codes		Hibaválaszok: *** 404 JobAgentNotFound – A megadott feladatügynök nem létezik a megadott logikai kiszolgálón. 404 ResourceNotFound – A kért erőforrás nem található. 404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található 404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és -előfizetésben.

Name

Típus

Description

200 OK

JobStep

Sikeresen lekérte a feladatlépést.

Other Status Codes

Hibaválaszok: ***

404 JobAgentNotFound – A megadott feladatügynök nem létezik a megadott logikai kiszolgálón.
404 ResourceNotFound – A kért erőforrás nem található.
404 SubscriptionDoesNotHaveServer – A kért kiszolgáló nem található
404 ServerNotInSubscriptionResourceGroup – A megadott kiszolgáló nem létezik a megadott erőforráscsoportban és -előfizetésben.

Példák

Get the latest version of a job step.

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


/**
 * Samples for JobSteps Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/GetJobStepByJob.json
     */
    /**
     * Sample code: Get the latest version of a job step.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getTheLatestVersionOfAJobStep(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobSteps().getWithResponse("group1", "server1", "agent1",
            "job1", "step1", 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

Mintaválasz

Állapotkó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"
}

Definíciók

Name	Description
JobStep	Feladatlépés.
JobStepAction	A feladatlépéssel végrehajtandó művelet.
JobStepActionSource	A végrehajtandó művelet forrása.
JobStepActionType	A feladatlépés által végrehajtott művelet típusa.
JobStepExecutionOptions	A feladatlépés végrehajtási lehetőségei.
JobStepOutput	Feladatlépés kimeneti konfigurációja.
JobStepOutputType	A kimeneti cél típusa.

JobStep

Objektum

Feladatlépés.

Name	Típus	Description
id	string	Erőforrás-azonosító.
name	string	Erőforrás neve.
properties.action	JobStepAction	A feladatlépés műveleti hasznos adatai.
properties.credential	string	A célokhoz való csatlakozáshoz használt feladat hitelesítő adatainak erőforrás-azonosítója.
properties.executionOptions	JobStepExecutionOptions	A feladatlépés végrehajtási beállításai.
properties.output	JobStepOutput	A feladatlépés kimeneti céltulajdonságai.
properties.stepId	integer (int32)	A feladatlépés indexe a feladaton belül. Ha nincs megadva a feladatlépés létrehozásakor, akkor az utolsó lépésként lesz létrehozva. Ha a feladatlépés frissítésekor nincs megadva, a lépésazonosító nem módosul.
properties.targetGroup	string	Annak a célcsoportnak az erőforrás-azonosítója, amelyen a feladatlépés végrehajtása történik.
type	string	Erőforrás típusa.

JobStepAction

Objektum

A feladatlépéssel végrehajtandó művelet.

Name	Típus	Alapértelmezett érték	Description
source	JobStepActionSource	Inline	A végrehajtandó művelet forrása.
type	JobStepActionType	TSql	A feladatlépés által végrehajtott művelet típusa.
value	string		A művelet értéke, például a végrehajtandó T-SQL-szkript szövege.

JobStepActionSource

Enumerálás

A végrehajtandó művelet forrása.

Érték	Description
Inline

JobStepActionType

Enumerálás

A feladatlépés által végrehajtott művelet típusa.

Érték	Description
TSql

JobStepExecutionOptions

Objektum

A feladatlépés végrehajtási lehetőségei.

Name	Típus	Alapértelmezett érték	Description
initialRetryIntervalSeconds	integer (int32)	1	Kezdeti késés a feladatlépés végrehajtásához szükséges újrapróbálkozások között.
maximumRetryIntervalSeconds	integer (int32)	120	A feladatlépés végrehajtásához szükséges újrapróbálkozási próbálkozások közötti várakozás maximális időtartama.
retryAttempts	integer (int32)	10	A feladatlépés újrapróbálásának maximális száma, ha az első kísérlet meghiúsul.
retryIntervalBackoffMultiplier	number (float)	2	Az újrapróbálkozások közötti idő visszalépési szorzója.
timeoutSeconds	integer (int32)	43200	A feladatlépés végrehajtási időtúllépése.

JobStepOutput

Objektum

Feladatlépés kimeneti konfigurációja.

Name	Típus	Alapértelmezett érték	Description
credential	string		A kimeneti célhoz való csatlakozáshoz használandó hitelesítő adat erőforrás-azonosítója.
databaseName	string		A kimeneti céladatbázis.
resourceGroupName	string		A kimeneti cél erőforráscsoportja.
schemaName	string	dbo	A kimeneti célséma.
serverName	string		A kimeneti célkiszolgáló neve.
subscriptionId	string (uuid)		A kimeneti cél előfizetésének azonosítója.
tableName	string		A kimeneti céltábla.
type	JobStepOutputType	SqlDatabase	A kimeneti cél típusa.

JobStepOutputType

Enumerálás

A kimeneti cél típusa.

Érték	Description
SqlDatabase

Megosztás a következőn keresztül:

Job Steps - Get

URI-paraméterek

Válaszok

Példák

Get the latest version of a job step.

Mintakérelem

Mintaválasz

Definíciók

JobStep

JobStepAction

JobStepActionSource

JobStepActionType

JobStepExecutionOptions

JobStepOutput

JobStepOutputType

További források