Jobs - Create Or Update

Odwołanie

Usługa:: SQL Database

Wersja interfejsu API:: 2021-11-01

Tworzy lub aktualizuje zadanie.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
jobAgentName	path	True	string	Nazwa agenta zadania.
jobName	path	True	string	Nazwa zadania do pobrania.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Typ	Opis
properties.description	string	Opis zadania zdefiniowany przez użytkownika.
properties.schedule	JobSchedule	Zaplanuj właściwości zadania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Job	Pomyślnie zaktualizowano zadanie.
201 Created	Job	Pomyślnie utworzono zadanie.
Other Status Codes		Odpowiedzi na błędy: *** 400 ElasticJobsOperationFailed — operacja zarządzania zadaniami elastycznymi nie powiodła się. 400 ElasticJobsOperationFailed — operacja zarządzania zadaniami elastycznymi nie powiodła się. 400 InvalidResourceRequestBody — właściwości zasobu lub zasobu w treści żądania są puste lub nieprawidłowe. 400 InvalidDuration — nieprawidłowy czas trwania. 404 JobAgentNotFound — określony agent zadania nie istnieje na określonym serwerze logicznym. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

Nazwa

Typ

Opis

200 OK

Job

Pomyślnie zaktualizowano zadanie.

201 Created

Job

Pomyślnie utworzono zadanie.

Other Status Codes

Odpowiedzi na błędy: ***

400 ElasticJobsOperationFailed — operacja zarządzania zadaniami elastycznymi nie powiodła się.
400 ElasticJobsOperationFailed — operacja zarządzania zadaniami elastycznymi nie powiodła się.
400 InvalidResourceRequestBody — właściwości zasobu lub zasobu w treści żądania są puste lub nieprawidłowe.
400 InvalidDuration — nieprawidłowy czas trwania.
404 JobAgentNotFound — określony agent zadania nie istnieje na określonym serwerze logicznym.
404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera
404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.

Przykłady

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.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")),
            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

Przykładowa odpowiedź

Kod stanu:: 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
    }
  }
}

Kod stanu:: 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

Przykładowe żądanie

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.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(), 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

Przykładowa odpowiedź

Kod stanu:: 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
    }
  }
}

Kod stanu:: 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
    }
  }
}

Definicje

Nazwa	Opis
Job	Zadanie.
JobSchedule	Planowanie właściwości zadania.
JobScheduleType	Typ interwału harmonogramu

Job

Zadanie.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.description	string	Opis zadania zdefiniowany przez użytkownika.
properties.schedule	JobSchedule	Zaplanuj właściwości zadania.
properties.version	integer	Numer wersji zadania.
type	string	Typ zasobu.

JobSchedule

Planowanie właściwości zadania.

Nazwa	Typ	Domyślna wartość	Opis
enabled	boolean		Określa, czy harmonogram jest włączony.
endTime	string	9999-12-31T11:59:59+00:00	Godzina zakończenia harmonogramu.
interval	string		Wartość interwału cyklicznego harmonogramu, jeśli typ harmonogramu jest cykliczny. format czasu trwania ISO8601.
startTime	string	0001-01-01T00:00:00+00:00	Zaplanuj godzinę rozpoczęcia.
type	JobScheduleType	Once	Typ interwału harmonogramu

JobScheduleType

Typ interwału harmonogramu

Nazwa	Typ	Opis
Once	string
Recurring	string

Udostępnij za pośrednictwem

Jobs - Create Or Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

Create a job with all properties specified

Przykładowe żądanie

Przykładowa odpowiedź

Create a job with default properties

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

Job

JobSchedule

JobScheduleType

Dodatkowe zasoby