Job Schedule - Create

Referenz

Dienst:: Automation

API-Version:: 2023-11-01

Erstellen Sie einen Auftragszeitplan.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
automationAccountName	path	True	string	Der Name des Automation-Kontos.
jobScheduleId	path	True	string uuid	Der Name des Auftragszeitplans.
resourceGroupName	path	True	string	Name einer Azure-Ressourcengruppe. RegEx-Muster: `^[-\w\._]+$`
subscriptionId	path	True	string	Ruft die Abonnementanmeldeinformationen ab, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Client-API-Version.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties.runbook	True	RunbookAssociationProperty	Ruft das Runbook ab oder legt es fest.
properties.schedule	True	ScheduleAssociationProperty	Ruft den Zeitplan ab oder legt den Zeitplan fest.
properties.parameters		object	Ruft eine Liste von Auftragseigenschaften ab oder legt diese fest.
properties.runOn		string	Ruft die Hybrid workergruppe ab, für die der geplante Auftrag ausgeführt werden soll, oder legt diese fest.

Antworten

Name	Typ	Beschreibung
201 Created	JobSchedule	Erstellt
Other Status Codes	ErrorResponse	Automatisierungsfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Beispiele

Create a job schedule

Beispielanforderung

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/ContoseAutomationAccount/jobSchedules/0fa462ba-3aa2-4138-83ca-9ebc3bc55cdc?api-version=2023-11-01

{
  "properties": {
    "schedule": {
      "name": "ScheduleNameGoesHere332204b5-debe-4348-a5c7-6357457189f2"
    },
    "runbook": {
      "name": "TestRunbook"
    },
    "parameters": {
      "jobscheduletag01": "jobschedulevalue01",
      "jobscheduletag02": "jobschedulevalue02"
    }
  }
}

Beispiel für eine Antwort

Statuscode:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/ContoseAutomationAccount/jobSchedules/0fa462ba-3aa2-4138-83ca-9ebc3bc55cdc",
  "properties": {
    "jobScheduleId": "0fa462ba-3aa2-4138-83ca-9ebc3bc55cdc",
    "runbook": {
      "name": "TestRunbook"
    },
    "schedule": {
      "name": "ScheduleNameGoesHere332204b5-debe-4348-a5c7-6357457189f2"
    },
    "runOn": null,
    "parameters": {
      "jobscheduletag01": "jobschedulevalue01",
      "jobscheduletag02": "jobschedulevalue02"
    }
  }
}

Definitionen

Name	Beschreibung
ErrorResponse	Fehlerantwort eines Vorgangsfehlers
JobSchedule	Definition des Auftragszeitplans.
JobScheduleCreateParameters	Die Parameter, die für den Vorgang zum Erstellen des Auftragszeitplans angegeben werden.
RunbookAssociationProperty	Die runbook-Eigenschaft, die der Entität zugeordnet ist.
ScheduleAssociationProperty	Die der Entität zugeordnete schedule-Eigenschaft.

ErrorResponse

Fehlerantwort eines Vorgangsfehlers

Name	Typ	Beschreibung
code	string	Fehlercode
message	string	Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

JobSchedule

Definition des Auftragszeitplans.

Name	Typ	Beschreibung
id	string	Ruft die ID der Ressource ab.
name	string	Ruft den Namen der Variablen ab.
properties.jobScheduleId	string	Ruft die ID des Auftragszeitplans ab oder legt sie fest.
properties.parameters	object	Ruft die Parameter des Auftragszeitplans ab oder legt diese fest.
properties.runOn	string	Ruft die Hybrid workergruppe ab, für die der geplante Auftrag ausgeführt werden soll, oder legt diese fest.
properties.runbook	RunbookAssociationProperty	Ruft das Runbook ab oder legt es fest.
properties.schedule	ScheduleAssociationProperty	Ruft den Zeitplan ab oder legt den Zeitplan fest.
type	string	Ressourcentyp

JobScheduleCreateParameters

Die Parameter, die für den Vorgang zum Erstellen des Auftragszeitplans angegeben werden.

Name	Typ	Beschreibung
properties.parameters	object	Ruft eine Liste von Auftragseigenschaften ab oder legt diese fest.
properties.runOn	string	Ruft die Hybrid workergruppe ab, für die der geplante Auftrag ausgeführt werden soll, oder legt diese fest.
properties.runbook	RunbookAssociationProperty	Ruft das Runbook ab oder legt es fest.
properties.schedule	ScheduleAssociationProperty	Ruft den Zeitplan ab oder legt den Zeitplan fest.

RunbookAssociationProperty

Die runbook-Eigenschaft, die der Entität zugeordnet ist.

Name	Typ	Beschreibung
name	string	Ruft den Namen des Runbooks ab oder legt den Namen fest.

ScheduleAssociationProperty

Die der Entität zugeordnete schedule-Eigenschaft.

Name	Typ	Beschreibung
name	string	Ruft den Namen des Zeitplans ab oder legt den Namen fest.

Freigeben über