Job - Create

Riferimento

Service:: Automation

API Version:: 2023-11-01

Creare un processo del runbook.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
automationAccountName	path	True	string	Nome dell'account di automazione.
jobName	path	True	string	Nome processo.
resourceGroupName	path	True	string	Nome di un gruppo di risorse di Azure. Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	Ottiene le credenziali di sottoscrizione che consentono di identificare in modo univoco la sottoscrizione Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.
api-version	query	True	string	Versione api client.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
clientRequestId		string	Identifica questa richiesta client specifica.

Corpo della richiesta

Nome	Tipo	Descrizione
properties.parameters	object	Ottiene o imposta i parametri del processo.
properties.runOn	string	Ottiene o imposta il runOn che specifica il nome del gruppo in cui deve essere eseguito il processo.
properties.runbook	RunbookAssociationProperty	Ottiene o imposta il runbook.

Risposte

Nome	Tipo	Descrizione
201 Created	Job	Data di creazione
Other Status Codes	ErrorResponse	Risposta di errore di automazione che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

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

Definizioni

Nome	Descrizione
ErrorResponse	Risposta di errore di un errore dell'operazione
Job	Definizione del processo.
JobCreateParameters	Parametri forniti all'operazione di creazione del processo.
JobProvisioningState	Stato di provisioning corrente del processo.
JobStatus	Ottiene o imposta lo stato del processo.
RunbookAssociationProperty	Proprietà del runbook associata all'entità .

ErrorResponse

Risposta di errore di un errore dell'operazione

Nome	Tipo	Descrizione
code	string	Codice di errore
message	string	Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

Job

Definizione del processo.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa
name	string	nome della risorsa.
properties.creationTime	string	Ottiene o imposta l'ora di creazione del processo.
properties.endTime	string	Ottiene o imposta l'ora di fine del processo.
properties.exception	string	Ottiene o imposta l'eccezione del processo.
properties.jobId	string	Ottiene o imposta l'ID del processo.
properties.lastModifiedTime	string	Ottiene o imposta l'ora dell'ultima modifica del processo.
properties.lastStatusModifiedTime	string	Ottiene o imposta l'ora dell'ultima modifica dello stato del processo.
properties.parameters	object	Ottiene o imposta i parametri del processo.
properties.provisioningState	JobProvisioningState	Stato di provisioning corrente del processo.
properties.runOn	string	Ottiene o imposta il runOn che specifica il nome del gruppo in cui deve essere eseguito il processo.
properties.runbook	RunbookAssociationProperty	Ottiene o imposta il runbook.
properties.startTime	string	Ottiene o imposta l'ora di inizio del processo.
properties.startedBy	string	Ottiene o imposta il processo avviato da .
properties.status	JobStatus	Ottiene o imposta lo stato del processo.
properties.statusDetails	string	Ottiene o imposta i dettagli dello stato del processo.
type	string	Tipo di risorsa.

JobCreateParameters

Parametri forniti all'operazione di creazione del processo.

Nome	Tipo	Descrizione
properties.parameters	object	Ottiene o imposta i parametri del processo.
properties.runOn	string	Ottiene o imposta il runOn che specifica il nome del gruppo in cui deve essere eseguito il processo.
properties.runbook	RunbookAssociationProperty	Ottiene o imposta il runbook.

JobProvisioningState

Stato di provisioning corrente del processo.

Nome	Tipo	Descrizione
Failed	string
Processing	string
Succeeded	string
Suspended	string

JobStatus

Ottiene o imposta lo stato del processo.

Nome	Tipo	Descrizione
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

Proprietà del runbook associata all'entità .

Nome	Tipo	Descrizione
name	string	Ottiene o imposta il nome del runbook.

Share via