Jobs - Create Or Update

Référence

Service:: SQL Database

API Version:: 2021-11-01

Crée ou met à jour un travail.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
jobAgentName	path	True	string	Nom de l’agent de travail.
jobName	path	True	string	Nom du travail à obtenir.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
serverName	path	True	string	Le nom du serveur
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Type	Description
properties.description	string	Description définie par l’utilisateur du travail.
properties.schedule	JobSchedule	Planifier les propriétés du travail.

Réponses

Nom	Type	Description
200 OK	Job	Mise à jour réussie du travail.
201 Created	Job	La tâche a été correctement créée.
Other Status Codes		Réponses d’erreur : *** 400 ElasticJobsOperationFailed : échec de l’opération de gestion des travaux élastiques. 400 ElasticJobsOperationFailed : échec de l’opération de gestion des travaux élastiques. 400 InvalidResourceRequestBody : la ressource ou les propriétés de ressource dans le corps de la demande sont vides ou non valides. 400 InvalidDuration : durée non valide. 404 JobAgentNotFound : l’agent de travail spécifié n’existe pas dans le serveur logique spécifié. 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.

Nom

Type

Description

200 OK

Job

Mise à jour réussie du travail.

201 Created

Job

La tâche a été correctement créée.

Other Status Codes

Réponses d’erreur : ***

400 ElasticJobsOperationFailed : échec de l’opération de gestion des travaux élastiques.
400 ElasticJobsOperationFailed : échec de l’opération de gestion des travaux élastiques.
400 InvalidResourceRequestBody : la ressource ou les propriétés de ressource dans le corps de la demande sont vides ou non valides.
400 InvalidDuration : durée non valide.
404 JobAgentNotFound : l’agent de travail spécifié n’existe pas dans le serveur logique spécifié.
404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable
404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.

Exemples

Create a job with all properties specified

Create a job with default properties

Create a job with all properties specified

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

{
  "properties": {
    "description": "my favourite job",
    "schedule": {
      "startTime": "2015-09-24T18:30:01Z",
      "endTime": "2015-09-24T23:59:59Z",
      "type": "Recurring",
      "interval": "PT5M",
      "enabled": true
    }
  }
}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.JobInner;
import com.azure.resourcemanager.sql.models.JobSchedule;
import com.azure.resourcemanager.sql.models.JobScheduleType;
import java.time.OffsetDateTime;

/** Samples for Jobs CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateJobMax.json
     */
    /**
     * Sample code: Create a job with all properties specified.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAJobWithAllPropertiesSpecified(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobs().createOrUpdateWithResponse("group1", "server1", "agent1",
            "job1",
            new JobInner().withDescription("my favourite job")
                .withSchedule(new JobSchedule().withStartTime(OffsetDateTime.parse("2015-09-24T18:30:01Z"))
                    .withEndTime(OffsetDateTime.parse("2015-09-24T23:59:59Z")).withType(JobScheduleType.RECURRING)
                    .withEnabled(true).withInterval("PT5M")),
            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

Sample Response

Status code:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1",
  "name": "job1",
  "type": "Microsoft.Sql/servers/jobAccounts/jobs",
  "properties": {
    "description": "my favourite job",
    "version": 0,
    "schedule": {
      "startTime": "2015-09-24T18:30:01Z",
      "endTime": "2015-09-24T23:59:59Z",
      "type": "Recurring",
      "interval": "PT5M",
      "enabled": true
    }
  }
}

Status code:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1",
  "name": "job1",
  "type": "Microsoft.Sql/servers/jobAccounts/jobs",
  "properties": {
    "description": "my favourite job",
    "version": 0,
    "schedule": {
      "startTime": "2015-09-24T18:30:01Z",
      "endTime": "2015-09-24T23:59:59Z",
      "type": "Recurring",
      "interval": "PT5M",
      "enabled": true
    }
  }
}

Create a job with default properties

Sample Request

HTTP
Java

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

{}


import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.fluent.models.JobInner;

/** Samples for Jobs CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/CreateOrUpdateJobMin.json
     */
    /**
     * Sample code: Create a job with default properties.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createAJobWithDefaultProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getJobs().createOrUpdateWithResponse("group1", "server1", "agent1",
            "job1", new JobInner(), 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

Sample Response

Status code:: 200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1",
  "name": "job1",
  "type": "Microsoft.Sql/servers/jobAccounts/jobs",
  "properties": {
    "description": "",
    "version": 0,
    "schedule": {
      "startTime": "0001-01-01T00:00:00Z",
      "endTime": "9999-12-31T11:59:59Z",
      "type": "Once",
      "enabled": false
    }
  }
}

Status code:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/servers/server1/jobAgents/agent1/jobs/job1",
  "name": "job1",
  "type": "Microsoft.Sql/servers/jobAccounts/jobs",
  "properties": {
    "description": "",
    "version": 0,
    "schedule": {
      "startTime": "0001-01-01T00:00:00Z",
      "endTime": "9999-12-31T11:59:59Z",
      "type": "Once",
      "enabled": false
    }
  }
}

Définitions

Nom	Description
Job	Un travail.
JobSchedule	Propriétés de planification d’un travail.
JobScheduleType	Type d’intervalle de planification

Job

Un travail.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.description	string	Description définie par l’utilisateur du travail.
properties.schedule	JobSchedule	Planifier les propriétés du travail.
properties.version	integer	Numéro de version du travail.
type	string	Type de ressource.

JobSchedule

Propriétés de planification d’un travail.

Nom	Type	Valeur par défaut	Description
enabled	boolean		Indique si la planification est activée ou non.
endTime	string	9999-12-31T11:59:59+00:00	Planifier l’heure de fin.
interval	string		Valeur de l’intervalle périodique de la planification, si scheduleType est récurrent. ISO8601 format de durée.
startTime	string	0001-01-01T00:00:00+00:00	Planifier l’heure de début.
type	JobScheduleType	Once	Type d’intervalle de planification

JobScheduleType

Type d’intervalle de planification

Nom	Type	Description
Once	string
Recurring	string

Partager via

Jobs - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Exemples

Create a job with all properties specified

Sample Request

Sample Response

Create a job with default properties

Sample Request

Sample Response

Définitions

Job

JobSchedule

JobScheduleType

Ressources supplémentaires