Jobs - Create Or Update

작업을 만들거나 업데이트합니다.

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

URI 매개 변수

Name In Required Type Description
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 버전입니다.

요청 본문

Name Type Description
properties.description
  • string

작업에 대한 사용자 정의 설명입니다.

properties.schedule

작업의 속성을 예약합니다.

응답

Name Type Description
200 OK

작업이 성공적으로 업데이트되었습니다.

201 Created

작업을 성공적으로 만들었습니다.

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

Sample Request

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-02-01-preview

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

Sample Response

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

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-02-01-preview

{}

Sample Response

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

작업입니다.

Name Type Description
id
  • string

리소스 ID입니다.

name
  • string

리소스 이름입니다.

properties.description
  • string

작업에 대한 사용자 정의 설명입니다.

properties.schedule

작업의 속성을 예약합니다.

properties.version
  • integer

작업 버전 번호입니다.

type
  • string

리소스 종류.

JobSchedule

작업의 속성 예약

Name Type Default Value Description
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 Once

일정 간격 유형

JobScheduleType

일정 간격 유형

Name Type Description
Once
  • string
Recurring
  • string