Jobs - Create Or Update

リファレンス

Service:: SQL Database

API Version:: 2021-11-01

ジョブを作成または更新します。

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

URI パラメーター

名前	/	必須	型	説明
jobAgentName	path	True	string	ジョブエージェントの名前。
jobName	path	True	string	取得するジョブの名前。
resourceGroupName	path	True	string	リソースが含まれているリソースグループの名前。この値は、Azure リソースマネージャー API またはポータルから取得できます。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求で使用する API のバージョン。

要求本文

名前	型	説明
properties.description	string	ジョブのユーザー定義の説明。
properties.schedule	JobSchedule	ジョブのプロパティをスケジュールします。

応答

名前	型	説明
200 OK	Job	ジョブが正常に更新されました。
201 Created	Job	ジョブが正常に作成されました。
Other Status Codes		エラー応答: *** 400 ElasticJobsOperationFailed - エラスティックジョブ管理操作に失敗しました。 400 ElasticJobsOperationFailed - エラスティックジョブ管理操作に失敗しました。 400 InvalidResourceRequestBody - 要求本文のリソースまたはリソースのプロパティが空または無効です。 400 InvalidDuration - 期間が無効です。 404 JobAgentNotFound - 指定されたジョブエージェントが、指定された論理サーバーに存在しません。 404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした 404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。

名前

型

説明

200 OK

Job

ジョブが正常に更新されました。

201 Created

Job

ジョブが正常に作成されました。

Other Status Codes

エラー応答: ***

400 ElasticJobsOperationFailed - エラスティックジョブ管理操作に失敗しました。
400 ElasticJobsOperationFailed - エラスティックジョブ管理操作に失敗しました。
400 InvalidResourceRequestBody - 要求本文のリソースまたはリソースのプロパティが空または無効です。
400 InvalidDuration - 期間が無効です。
404 JobAgentNotFound - 指定されたジョブエージェントが、指定された論理サーバーに存在しません。
404 SubscriptionDoesNotHaveServer - 要求されたサーバーが見つかりませんでした
404 ServerNotInSubscriptionResourceGroup - 指定されたサーバーが、指定されたリソースグループとサブスクリプションに存在しません。

例

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
    }
  }
}

定義

名前	説明
Job	ジョブ。
JobSchedule	ジョブのプロパティのスケジュール設定。
JobScheduleType	スケジュール間隔の種類

Job

ジョブ。

名前	型	説明
id	string	リソースの ID
name	string	リソース名。
properties.description	string	ジョブのユーザー定義の説明。
properties.schedule	JobSchedule	ジョブのプロパティをスケジュールします。
properties.version	integer	ジョブのバージョン番号。
type	string	リソースの種類。

JobSchedule

ジョブのプロパティのスケジュール設定。

名前	型	既定値	説明
enabled	boolean		スケジュールが有効になっているかどうか。
endTime	string	9999-12-31T11:59:59+00:00	終了時刻をスケジュールします。
interval	string		ScheduleType が定期的な場合は、スケジュールの定期的な間隔の値。期間形式ISO8601します。
startTime	string	0001-01-01T00:00:00+00:00	開始時刻をスケジュールします。
type	JobScheduleType	Once	スケジュール間隔の種類

JobScheduleType

スケジュール間隔の種類

名前	型	説明
Once	string
Recurring	string

Share via

Jobs - Create Or Update

URI パラメーター

要求本文

応答

例

Create a job with all properties specified

Sample Request

Sample Response

Create a job with default properties

Sample Request

Sample Response

定義

Job

JobSchedule

JobScheduleType

その他のリソース