Job Executions - Create Or Update

Referentie

Service:: SQL Database

API-versie:: 2021-11-01

Hiermee wordt een taakuitvoering gemaakt of bijgewerkt.

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

URI-parameters

Name	In	Vereist	Type	Description
jobAgentName	path	True	string	De naam van de taakagent.
jobExecutionId	path	True	string uuid	De taakuitvoerings-id voor het maken van de taakuitvoering.
jobName	path	True	string	De naam van de taak die u wilt ophalen.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Antwoorden

Name	Type	Description
200 OK	JobExecution	Er bestaat al een taakuitvoering voor de taak met de opgegeven id.
201 Created	JobExecution	Een uitvoering voor de taak is gestart.
202 Accepted		Geaccepteerd
Other Status Codes		Foutreacties: *** 400 ElasticJobsOperationFailed - Beheerbewerking voor elastische taken is mislukt. 400 ElasticJobsOperationFailed - Beheerbewerking voor elastische taken is mislukt. 404 JobAgentNotFound - De opgegeven taakagent bestaat niet op de opgegeven logische server. 404 ResourceNotFound - De aangevraagde resource is niet gevonden. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ServerNotInSubscriptionResourceGroup: de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 OperationIdNotFound - De bewerking met id bestaat niet. 409 OperationCancelled : de bewerking is geannuleerd door de gebruiker. 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren. 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Voorbeelden

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

Voorbeeldrespons

Statuscode:: 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"
}

Statuscode:: 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"
}

Statuscode:: 202

Definities

Name	Description
JobExecution	Een uitvoering van een taak
JobExecutionLifecycle	De gedetailleerde status van de taakuitvoering.
JobExecutionTarget	Het doel waarop een taak wordt uitgevoerd.
JobTargetType	Het type doel.
ProvisioningState	De ARM-inrichtingsstatus van de taakuitvoering.

JobExecution

Object

Een uitvoering van een taak

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.createTime	string	Het tijdstip waarop de taakuitvoering is gemaakt.
properties.currentAttemptStartTime	string	Begintijd van de huidige poging.
properties.currentAttempts	integer	Het aantal keren dat de taak is uitgevoerd.
properties.endTime	string	Het tijdstip waarop de uitvoering van de taak is voltooid.
properties.jobExecutionId	string	De unieke id van de taakuitvoering.
properties.jobVersion	integer	Het versienummer van de taak.
properties.lastMessage	string	Het laatste status- of foutbericht.
properties.lifecycle	JobExecutionLifecycle	De gedetailleerde status van de taakuitvoering.
properties.provisioningState	ProvisioningState	De ARM-inrichtingsstatus van de taakuitvoering.
properties.startTime	string	Het tijdstip waarop de taakuitvoering is gestart.
properties.stepId	integer	De taakstap-id.
properties.stepName	string	De naam van de taakstap.
properties.target	JobExecutionTarget	Het doel waarop deze uitvoering wordt uitgevoerd.
type	string	Resourcetype.

JobExecutionLifecycle

Enumeration

De gedetailleerde status van de taakuitvoering.

Waarde	Description
Canceled
Created
Failed
InProgress
Skipped
Succeeded
SucceededWithSkipped
TimedOut
WaitingForChildJobExecutions
WaitingForRetry

JobExecutionTarget

Object

Het doel waarop een taak wordt uitgevoerd.

Name	Type	Description
databaseName	string	De naam van de database.
serverName	string	De servernaam.
type	JobTargetType	Het type doel.

JobTargetType

Enumeration

Het type doel.

Waarde	Description
SqlDatabase
SqlElasticPool
SqlServer
SqlShardMap
TargetGroup

ProvisioningState

Enumeration

De ARM-inrichtingsstatus van de taakuitvoering.

Waarde	Description
Canceled
Created
Failed
InProgress
Succeeded

Delen via

Job Executions - Create Or Update

URI-parameters

Antwoorden

Voorbeelden

Create job execution.

Voorbeeldaanvraag

Voorbeeldrespons

Definities

JobExecution

JobExecutionLifecycle

JobExecutionTarget

JobTargetType

ProvisioningState

Aanvullende resources