Job Schedule - Create

Service:

Automation

API-versie:

2023-11-01

Maak een taakplanning.

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

URI-parameters

Name	In	Vereist	Type	Description
automationAccountName	path	True	string	De naam van het Automation-account.
jobScheduleId	path	True	string (uuid)	De naam van de taakplanning.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Naam van een Azure-resourcegroep.
subscriptionId	path	True	string	Hiermee haalt u abonnementsreferenties op die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.
api-version	query	True	string	Client-API-versie.

Aanvraagbody

Name	Vereist	Type	Description
properties.runbook	True	RunbookAssociationProperty	Hiermee haalt u het runbook op of stelt u het in.
properties.schedule	True	ScheduleAssociationProperty	Hiermee haalt u de planning op of stelt u deze in.
properties.parameters		object	Hiermee haalt u een lijst met taakeigenschappen op of stelt u deze in.
properties.runOn		string	Hiermee haalt u de hybrid worker-groep op waarop de geplande taak moet worden uitgevoerd.

Antwoorden

Name	Type	Description
201 Created	JobSchedule	Geschapen
Other Status Codes	ErrorResponse	Automatiseringsfoutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Create a job schedule

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name	Description
ErrorResponse	Foutreactie van een bewerkingsfout
JobSchedule	Definitie van de taakplanning.
JobScheduleCreateParameters	De parameters die zijn opgegeven voor de taakplanningsbewerking maken.
RunbookAssociationProperty	De runbookeigenschap die is gekoppeld aan de entiteit.
ScheduleAssociationProperty	De planningseigenschap die is gekoppeld aan de entiteit.

ErrorResponse

Object

Foutreactie van een bewerkingsfout

Name	Type	Description
code	string	Foutcode
message	string	Foutbericht dat aangeeft waarom de bewerking is mislukt.

JobSchedule

Object

Definitie van de taakplanning.

Name	Type	Description
id	string	Hiermee haalt u de id van de resource op.
name	string	Hiermee haalt u de naam van de variabele op.
properties.jobScheduleId	string	Hiermee haalt u de id van de taakplanning op of stelt u deze in.
properties.parameters	object	Hiermee haalt u de parameters van de taakplanning op of stelt u deze in.
properties.runOn	string	Hiermee haalt u de hybrid worker-groep op waarop de geplande taak moet worden uitgevoerd.
properties.runbook	RunbookAssociationProperty	Hiermee haalt u het runbook op of stelt u het in.
properties.schedule	ScheduleAssociationProperty	Hiermee haalt u de planning op of stelt u deze in.
type	string	Resourcetype

JobScheduleCreateParameters

Object

De parameters die zijn opgegeven voor de taakplanningsbewerking maken.

Name	Type	Description
properties.parameters	object	Hiermee haalt u een lijst met taakeigenschappen op of stelt u deze in.
properties.runOn	string	Hiermee haalt u de hybrid worker-groep op waarop de geplande taak moet worden uitgevoerd.
properties.runbook	RunbookAssociationProperty	Hiermee haalt u het runbook op of stelt u het in.
properties.schedule	ScheduleAssociationProperty	Hiermee haalt u de planning op of stelt u deze in.

RunbookAssociationProperty

Object

De runbookeigenschap die is gekoppeld aan de entiteit.

Name	Type	Description
name	string	Hiermee haalt u de naam van het runbook op of stelt u deze in.

ScheduleAssociationProperty

Object

De planningseigenschap die is gekoppeld aan de entiteit.

Name	Type	Description
name	string	Hiermee haalt u de naam van de planning op of stelt u deze in.