Job - Create

참조

서비스:: Automation

API 버전:: 2023-11-01

Runbook의 작업을 만듭니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/jobs/{jobName}?api-version=2023-11-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
automationAccountName	path	True	string	자동화 계정의 이름입니다.
jobName	path	True	string	작업 이름입니다.
resourceGroupName	path	True	string	Azure 리소스 그룹의 이름입니다. regex 패턴: `^[-\w\._]+$`
subscriptionId	path	True	string	Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명을 가져옵니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.
api-version	query	True	string	클라이언트 API 버전.

요청 헤더

Name	필수	형식	Description
clientRequestId		string	이 특정 클라이언트 요청을 식별합니다.

요청 본문

Name	형식	Description
properties.parameters	object	작업의 매개 변수를 가져오거나 설정합니다.
properties.runOn	string	작업을 실행할 그룹 이름을 지정하는 runOn을 가져오거나 설정합니다.
properties.runbook	RunbookAssociationProperty	Runbook을 가져오거나 설정합니다.

응답

Name	형식	Description
201 Created	Job	생성일
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 자동화 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Create job

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/ContoseAutomationAccount/jobs/foo?api-version=2023-11-01

{
  "properties": {
    "runbook": {
      "name": "TestRunbook"
    },
    "parameters": {
      "key01": "value01",
      "key02": "value02"
    },
    "runOn": ""
  }
}

샘플 응답

상태 코드:: 201

{
  "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/ContoseAutomationAccount/jobs/jobName",
  "name": "foo",
  "type": "Microsoft.Automation/AutomationAccounts/Jobs",
  "properties": {
    "jobId": "5b8a3960-e8ab-45f6-bec6-567df8467d1a",
    "runbook": {
      "name": "TestRunbook"
    },
    "provisioningState": "Processing",
    "creationTime": "2018-02-01T05:53:30.243+00:00",
    "endTime": null,
    "exception": null,
    "lastModifiedTime": "2018-02-01T05:53:30.243+00:00",
    "lastStatusModifiedTime": "2018-02-01T05:53:30.243+00:00",
    "startTime": null,
    "status": "New",
    "statusDetails": "None",
    "parameters": {
      "tag01": "value01",
      "tag02": "value02"
    },
    "runOn": ""
  }
}

정의

Name	Description
ErrorResponse	작업 실패에 대한 오류 응답
Job	작업의 정의입니다.
JobCreateParameters	작업 만들기 작업에 제공된 매개 변수입니다.
JobProvisioningState	작업의 현재 프로비전 상태입니다.
JobStatus	작업의 상태 가져오거나 설정합니다.
RunbookAssociationProperty	엔터티와 연결된 Runbook 속성입니다.

ErrorResponse

작업 실패에 대한 오류 응답

Name	형식	Description
code	string	오류 코드
message	string	작업이 실패한 이유를 나타내는 오류 메시지입니다.

Job

작업의 정의입니다.

Name	형식	Description
id	string	리소스에 대한 정규화된 리소스 ID
name	string	리소스의 이름입니다.
properties.creationTime	string	작업의 생성 시간을 가져오거나 설정합니다.
properties.endTime	string	작업의 종료 시간을 가져오거나 설정합니다.
properties.exception	string	작업의 예외를 가져오거나 설정합니다.
properties.jobId	string	작업의 ID를 가져오거나 설정합니다.
properties.lastModifiedTime	string	작업의 마지막으로 수정된 시간을 가져오거나 설정합니다.
properties.lastStatusModifiedTime	string	작업의 마지막 상태 수정된 시간을 가져오거나 설정합니다.
properties.parameters	object	작업의 매개 변수를 가져오거나 설정합니다.
properties.provisioningState	JobProvisioningState	작업의 현재 프로비전 상태입니다.
properties.runOn	string	작업을 실행할 그룹 이름을 지정하는 runOn을 가져오거나 설정합니다.
properties.runbook	RunbookAssociationProperty	Runbook을 가져오거나 설정합니다.
properties.startTime	string	작업의 시작 시간을 가져오거나 설정합니다.
properties.startedBy	string	시작 작업을 가져오거나 설정합니다.
properties.status	JobStatus	작업의 상태 가져오거나 설정합니다.
properties.statusDetails	string	작업의 상태 세부 정보를 가져오거나 설정합니다.
type	string	리소스 형식입니다.

JobCreateParameters

작업 만들기 작업에 제공된 매개 변수입니다.

Name	형식	Description
properties.parameters	object	작업의 매개 변수를 가져오거나 설정합니다.
properties.runOn	string	작업을 실행할 그룹 이름을 지정하는 runOn을 가져오거나 설정합니다.
properties.runbook	RunbookAssociationProperty	Runbook을 가져오거나 설정합니다.

JobProvisioningState

작업의 현재 프로비전 상태입니다.

Name	형식	Description
Failed	string
Processing	string
Succeeded	string
Suspended	string

JobStatus

작업의 상태 가져오거나 설정합니다.

Name	형식	Description
Activating	string
Blocked	string
Completed	string
Disconnected	string
Failed	string
New	string
Removing	string
Resuming	string
Running	string
Stopped	string
Stopping	string
Suspended	string
Suspending	string

RunbookAssociationProperty

엔터티와 연결된 Runbook 속성입니다.

Name	형식	Description
name	string	Runbook의 이름을 가져오거나 설정합니다.

다음을 통해 공유