Job Executions - Create

서비스:: SQL Database

API 버전:: 2023-08-01

탄력적 작업 실행을 시작합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
jobAgentName	path	True	string	작업 에이전트의 이름입니다.
jobName	path	True	string	가져올 작업의 이름입니다.
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName	path	True	string	서버의 이름입니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	JobExecution	작업에 대한 실행을 성공적으로 시작했습니다.
202 Accepted		허용 헤더 Location: string
Other Status Codes	ErrorResponse	오류 응답: *** 400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업 400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업 400 ElasticJobsOperationFailed - 탄력적 작업 관리 작업이 실패했습니다. 400 ElasticJobsOperationFailed - 탄력적 작업 관리 작업이 실패했습니다. 404 JobAgentNotFound - 지정된 작업 에이전트가 지정된 논리 서버에 없습니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

Name

형식

Description

200 OK

JobExecution

작업에 대한 실행을 성공적으로 시작했습니다.

202 Accepted

허용

헤더

Location: string

Other Status Codes

ErrorResponse

오류 응답: ***

400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업
400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업
400 ElasticJobsOperationFailed - 탄력적 작업 관리 작업이 실패했습니다.
400 ElasticJobsOperationFailed - 탄력적 작업 관리 작업이 실패했습니다.
404 JobAgentNotFound - 지정된 작업 에이전트가 지정된 논리 서버에 없습니다.
404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.
404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.
404 ResourceNotFound - 요청된 리소스를 찾을 수 없습니다.
404 OperationIdNotFound - ID가 있는 작업이 없습니다.
409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다.
409 OperationCancelled - 사용자가 작업을 취소했습니다.
409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.
429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.
503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Start a job execution.

샘플 요청

HTTP

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

샘플 응답

상태 코드:: 200

{
  "properties": {
    "jobVersion": 1,
    "jobExecutionId": "5A86BF65-43AC-F258-2524-9E92992F97CA",
    "lifecycle": "Created",
    "provisioningState": "Created",
    "createTime": "2016-09-23T01:00:00Z",
    "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"
}

상태 코드:: 202

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/group1/providers/Microsoft.Sql/locations/westus/jobAgentOperationResults/5555-6666-7777-8888-999999999999?api-version=2017-03-01-preview

정의

Name	Description
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
JobExecution	작업 실행
JobExecutionLifecycle	작업 실행의 자세한 상태입니다.
JobExecutionTarget	작업 실행이 실행되는 대상입니다.
JobTargetType	대상의 형식입니다.
ProvisioningState	작업 실행의 ARM 프로비저닝 상태입니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

JobExecution

Object

작업 실행

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.createTime	string (date-time)	작업 실행이 만들어진 시간입니다.
properties.currentAttemptStartTime	string (date-time)	현재 시도의 시작 시간입니다.
properties.currentAttempts	integer (int32)	작업 실행이 시도된 횟수입니다.
properties.endTime	string (date-time)	작업 실행이 완료된 시간입니다.
properties.jobExecutionId	string (uuid)	작업 실행의 고유 식별자입니다.
properties.jobVersion	integer (int32)	작업 버전 번호입니다.
properties.lastMessage	string	마지막 상태 또는 오류 메시지입니다.
properties.lifecycle	JobExecutionLifecycle	작업 실행의 자세한 상태입니다.
properties.provisioningState	ProvisioningState	작업 실행의 ARM 프로비저닝 상태입니다.
properties.startTime	string (date-time)	작업 실행이 시작된 시간입니다.
properties.stepId	integer (int32)	작업 단계 ID입니다.
properties.stepName	string	작업 단계 이름입니다.
properties.target	JobExecutionTarget	이 실행이 실행되는 대상입니다.
type	string	리소스 종류입니다.

JobExecutionLifecycle

열거형

작업 실행의 자세한 상태입니다.

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

JobExecutionTarget

Object

작업 실행이 실행되는 대상입니다.

Name	형식	Description
databaseName	string	데이터베이스 이름입니다.
serverName	string	서버 이름입니다.
type	JobTargetType	대상의 형식입니다.

JobTargetType

열거형

대상의 형식입니다.

값	Description
TargetGroup
SqlDatabase
SqlElasticPool
SqlShardMap
SqlServer

ProvisioningState

열거형

작업 실행의 ARM 프로비저닝 상태입니다.

값	Description
Created
InProgress
Succeeded
Failed
Canceled