Job - Create

Referensi

Service:: Automation

API Version:: 2023-11-01

Buat pekerjaan runbook.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
automationAccountName	path	True	string	Nama akun automasi.
jobName	path	True	string	Nama pekerjaan.
resourceGroupName	path	True	string	Nama grup Sumber Daya Azure. Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	Mendapatkan kredensial langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.
api-version	query	True	string	Versi Api Klien.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
clientRequestId		string	Mengidentifikasi permintaan klien khusus ini.

Isi Permintaan

Nama	Jenis	Deskripsi
properties.parameters	object	Mendapatkan atau mengatur parameter pekerjaan.
properties.runOn	string	Mendapatkan atau mengatur runOn yang menentukan nama grup tempat pekerjaan akan dijalankan.
properties.runbook	RunbookAssociationProperty	Mendapatkan atau mengatur runbook.

Respons

Nama	Jenis	Deskripsi
201 Created	Job	Dibuat
Other Status Codes	ErrorResponse	Respons kesalahan automasi yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Create job

Sample Request

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

Sample Response

Status code:: 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": ""
  }
}

Definisi

Nama	Deskripsi
ErrorResponse	Respons kesalahan kegagalan operasi
Job	Definisi pekerjaan.
JobCreateParameters	Parameter yang disediakan untuk membuat operasi pekerjaan.
JobProvisioningState	Status penyediaan pekerjaan saat ini.
JobStatus	Mendapatkan atau menetapkan status pekerjaan.
RunbookAssociationProperty	Properti runbook yang terkait dengan entitas.

ErrorResponse

Respons kesalahan kegagalan operasi

Nama	Jenis	Deskripsi
code	string	Kode kesalahan
message	string	Pesan kesalahan yang menunjukkan mengapa operasi gagal.

Job

Definisi pekerjaan.

Nama	Jenis	Deskripsi
id	string	Id sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya
name	string	Nama sumber daya.
properties.creationTime	string	Mendapatkan atau mengatur waktu pembuatan pekerjaan.
properties.endTime	string	Mendapatkan atau mengatur waktu akhir pekerjaan.
properties.exception	string	Mendapatkan atau menetapkan pengecualian pekerjaan.
properties.jobId	string	Mendapatkan atau mengatur id pekerjaan.
properties.lastModifiedTime	string	Mendapatkan atau mengatur waktu terakhir pekerjaan yang dimodifikasi.
properties.lastStatusModifiedTime	string	Mendapatkan atau mengatur waktu modifikasi status terakhir pekerjaan.
properties.parameters	object	Mendapatkan atau mengatur parameter pekerjaan.
properties.provisioningState	JobProvisioningState	Status penyediaan pekerjaan saat ini.
properties.runOn	string	Mendapatkan atau mengatur runOn yang menentukan nama grup tempat pekerjaan akan dijalankan.
properties.runbook	RunbookAssociationProperty	Mendapatkan atau mengatur runbook.
properties.startTime	string	Mendapatkan atau mengatur waktu mulai pekerjaan.
properties.startedBy	string	Mendapatkan atau mengatur pekerjaan yang dimulai oleh.
properties.status	JobStatus	Mendapatkan atau menetapkan status pekerjaan.
properties.statusDetails	string	Mendapatkan atau mengatur detail status pekerjaan.
type	string	Jenis sumber daya.

JobCreateParameters

Parameter yang disediakan untuk membuat operasi pekerjaan.

Nama	Jenis	Deskripsi
properties.parameters	object	Mendapatkan atau mengatur parameter pekerjaan.
properties.runOn	string	Mendapatkan atau mengatur runOn yang menentukan nama grup tempat pekerjaan akan dijalankan.
properties.runbook	RunbookAssociationProperty	Mendapatkan atau mengatur runbook.

JobProvisioningState

Status penyediaan pekerjaan saat ini.

Nama	Jenis	Deskripsi
Failed	string
Processing	string
Succeeded	string
Suspended	string

JobStatus

Mendapatkan atau menetapkan status pekerjaan.

Nama	Jenis	Deskripsi
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

Properti runbook yang terkait dengan entitas.

Nama	Jenis	Deskripsi
name	string	Mendapatkan atau mengatur nama runbook.

Bagikan melalui