Job Executions - Create Or Update

Reference

Služba:: SQL Database

Verze rozhraní API:: 2021-11-01

Vytvoří nebo aktualizuje provádění úlohy.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
jobAgentName	path	True	string	Název agenta úloh.
jobExecutionId	path	True	string uuid	ID spuštění úlohy, ve které se má vytvořit spuštění úlohy.
jobName	path	True	string	Název úlohy, kterou chcete získat.
resourceGroupName	path	True	string	Název skupiny prostředků, která prostředek obsahuje. Tuto hodnotu můžete získat z rozhraní API Resource Manager Azure nebo z portálu.
serverName	path	True	string	Název serveru.
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	JobExecution	Spuštění úlohy s daným ID již existovalo.
201 Created	JobExecution	Spuštění úlohy se úspěšně spustilo.
202 Accepted		Přijato
Other Status Codes		Chybové odpovědi: *** 400 ElasticJobsOperationFailed – Operace správy elastických úloh selhala. 400 ElasticJobsOperationFailed – Operace správy elastických úloh selhala. 404 JobAgentNotFound – Zadaný agent úloh na zadaném logickém serveru neexistuje. 404 ResourceNotFound – Požadovaný prostředek se nenašel. 404 SubscriptionDoesNotHaveServer – Požadovaný server se nenašel. 404 ServerNotInSubscriptionResourceGroup – zadaný server v zadané skupině prostředků a předplatném neexistuje. 404 OperationIdNotFound – operace s ID neexistuje. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad maximální počet požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

Create job execution.

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/5A86BF65-43AC-F258-2524-9E92992F97CA?api-version=2021-11-01


import java.util.UUID;

/**
 * Samples for JobExecutions CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateJobExecution.json
     */
    /**
     * Sample code: Create job execution.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createJobExecution(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobExecutions().createOrUpdate("group1", "server1", "agent1",
            "job1", UUID.fromString("5A86BF65-43AC-F258-2524-9E92992F97CA"), 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

Ukázková odpověď

Stavový kód:: 200

{
  "properties": {
    "jobVersion": 1,
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "lifecycle": "Created",
    "provisioningState": "Created",
    "createTime": "2017-12-18T19:02:00.8707045Z",
    "currentAttempts": 0,
    "lastMessage": "Job execution created."
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/5555-6666-7777-8888-999999999999",
  "name": "5555-6666-7777-8888-999999999999",
  "type": "Microsoft.Sql/servers/jobAgents/executions"
}

Stavový kód:: 201

{
  "properties": {
    "jobVersion": 1,
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "lifecycle": "Created",
    "provisioningState": "Created",
    "createTime": "2017-05-04T19:02:00.8707045Z",
    "currentAttempts": 0,
    "lastMessage": "Job execution created."
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1/executions/5555-6666-7777-8888-999999999999",
  "name": "5555-6666-7777-8888-999999999999",
  "type": "Microsoft.Sql/servers/jobAgents/executions"
}

Stavový kód:: 202

Definice

Name	Description
JobExecution	Spuštění úlohy
JobExecutionLifecycle	Podrobný stav provádění úlohy.
JobExecutionTarget	Cíl, na který se provádí spuštění úlohy.
JobTargetType	Typ cíle.
ProvisioningState	Stav zřizování ARM při provádění úlohy.

JobExecution

Spuštění úlohy

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.createTime	string	Čas vytvoření spuštění úlohy.
properties.currentAttemptStartTime	string	Počáteční čas aktuálního pokusu.
properties.currentAttempts	integer	Kolikrát došlo k pokusu o spuštění úlohy.
properties.endTime	string	Čas dokončení provádění úlohy.
properties.jobExecutionId	string	Jedinečný identifikátor spuštění úlohy.
properties.jobVersion	integer	Číslo verze úlohy.
properties.lastMessage	string	Poslední stav nebo chybová zpráva.
properties.lifecycle	JobExecutionLifecycle	Podrobný stav provádění úlohy.
properties.provisioningState	ProvisioningState	Stav zřizování ARM při provádění úlohy.
properties.startTime	string	Čas, kdy spuštění úlohy začalo.
properties.stepId	integer	ID kroku úlohy.
properties.stepName	string	Název kroku úlohy.
properties.target	JobExecutionTarget	Cíl, na který se toto spuštění provádí.
type	string	Typ prostředku.

JobExecutionLifecycle

Podrobný stav provádění úlohy.

Name	Typ	Description
Canceled	string
Created	string
Failed	string
InProgress	string
Skipped	string
Succeeded	string
SucceededWithSkipped	string
TimedOut	string
WaitingForChildJobExecutions	string
WaitingForRetry	string

JobExecutionTarget

Cíl, na který se provádí spuštění úlohy.

Name	Typ	Description
databaseName	string	název databáze,
serverName	string	Název serveru.
type	JobTargetType	Typ cíle.

JobTargetType

Typ cíle.

Name	Typ	Description
SqlDatabase	string
SqlElasticPool	string
SqlServer	string
SqlShardMap	string
TargetGroup	string

ProvisioningState

Stav zřizování ARM při provádění úlohy.

Name	Typ	Description
Canceled	string
Created	string
Failed	string
InProgress	string
Succeeded	string

Sdílet prostřednictvím