Dela via

CLI-jobbschema (v2) YAML-schema

  • Artikel

GÄLLER FÖR: Azure CLI ml-tillägget v2 (aktuellt)

JSON-källschemat finns på https://azuremlschemas.azureedge.net/latest/schedule.schema.json.

Kommentar

YAML-syntaxen som beskrivs i det här dokumentet baseras på JSON-schemat för den senaste versionen av ML CLI v2-tillägget. Den här syntaxen är garanterad att endast fungera med den senaste versionen av ML CLI v2-tillägget. Du hittar scheman för äldre tilläggsversioner på https://azuremlschemasprod.azureedge.net/.

YAML-syntax

Nyckel Typ Beskrivning Tillåtna värden
$schema sträng YAML-schemat.
name sträng Obligatoriskt. Namnet på schemat.
description sträng Beskrivning av schemat.
tags objekt Ordlista över taggar för schemat.
trigger objekt Utlösarkonfigurationen för att definiera regeln när jobbet ska utlösas. En av RecurrenceTrigger eller CronTrigger krävs.
create_job objekt eller sträng Obligatoriskt. Definitionen av jobbet som utlöses av ett schema. En av string eller JobDefinition krävs.

Utlösarkonfiguration

Återkomstutlösare

Nyckel Typ Beskrivning Tillåtna värden
type sträng Obligatoriskt. Anger schematypen. recurrence
frequency sträng Obligatoriskt. Anger den tidsenhet som beskriver hur ofta schemat utlöses. minute, hour, day, , , weekmonth
interval integer Obligatoriskt. Anger det intervall med vilket schemat utlöses.
start_time sträng Beskriver startdatum och tid med tidszon. Om start_time utelämnas körs det första jobbet omedelbart och de framtida jobben utlöses baserat på schemat och säger att start_time är lika med den tid då jobbet skapades. Om starttiden är tidigare körs det första jobbet vid nästa beräknade körningstid.
end_time sträng Beskriver slutdatum och tid med tidszon. Om end_time utelämnas fortsätter schemat att köras tills det uttryckligen inaktiveras.
timezone sträng Anger tidszonen för upprepningen. Om det utelämnas är UTC som standard. Se bilaga för tidszonsvärden
pattern objekt Anger mönstret för upprepningen. Om mönstret utelämnas utlöses jobben enligt logiken i start_time, frekvens och intervall.

Återkommande schema

Upprepningsschemat definierar upprepningsmönstret som innehåller hours, minutesoch weekdays.

  • När frekvensen är daykan mönstret ange hours och minutes.
  • När frekvensen är week och monthkan mönstret ange hours, minutes och weekdays.
Nyckel Typ Tillåtna värden
hours heltal eller matris med heltal 0-23
minutes heltal eller matris med heltal 0-59
week_days sträng eller strängmatris monday, tuesday, wednesday, thursday, friday, , , saturdaysunday

CronTrigger

Nyckel Typ Beskrivning Tillåtna värden
type sträng Obligatoriskt. Anger schematypen. cron
expression sträng Obligatoriskt. Anger cron-uttrycket för att definiera hur jobb ska utlösas. uttryck använder standard crontab-uttryck för att uttrycka ett återkommande schema. Ett enda uttryck består av fem blankstegsavgränsade fält:MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK
start_time sträng Beskriver startdatum och tid med tidszon. Om start_time utelämnas körs det första jobbet omedelbart och de framtida jobben utlöses baserat på schemat och säger att start_time är lika med den tid då jobbet skapades. Om starttiden är tidigare körs det första jobbet vid nästa beräknade körningstid.
end_time sträng Beskriver slutdatum och tid med tidszon. Om end_time utelämnas fortsätter schemat att köras tills det uttryckligen inaktiveras.
timezone sträng Anger tidszonen för upprepningen. Om det utelämnas är UTC som standard. Se bilaga för tidszonsvärden

Jobbdefinition

Kunden kan använda create_job: azureml:<job_name> eller använda följande egenskaper för att definiera jobbet.

Nyckel Typ Beskrivning Tillåtna värden
type sträng Obligatoriskt. Anger jobbtypen. Endast pipelinejobb stöds. pipeline
job sträng Obligatoriskt. Definiera hur du refererar till ett jobb, det kan vara azureml:<job_name> eller ett lokalt pipelinejobb som yaml, till exempel file:hello-pipeline.yml.
experiment_name sträng Experimentnamn för att organisera jobbet under. Varje jobbs körningspost ordnas under motsvarande experiment på studiofliken "Experiment". Om det utelämnas tar vi schemanamnet som standardvärde.
inputs objekt Ordlista över indata till jobbet. Nyckeln är ett namn på indata i jobbets kontext och värdet är indatavärdet.
outputs objekt Ordlista över utdatakonfigurationer för jobbet. Nyckeln är ett namn på utdata i jobbets kontext och värdet är utdatakonfigurationen.
settings objekt Standardinställningar för pipelinejobbet. Se Attribut för settings nyckeln för uppsättningen konfigurerbara egenskaper.

Attribut för settings nyckeln

Nyckel Typ Beskrivning Standardvärde
default_datastore sträng Namnet på det datalager som ska användas som standarddatalager för pipelinejobbet. Det här värdet måste vara en referens till ett befintligt datalager på arbetsytan med hjälp av syntaxen azureml:<datastore-name> . Alla utdata som definieras i outputs egenskapen för det överordnade pipelinejobbet eller underordnade stegjobb lagras i det här dataarkivet. Om det utelämnas lagras utdata i arbetsytans blobdatalager.
default_compute sträng Namnet på beräkningsmålet som ska användas som standardberäkning för alla steg i pipelinen. Om beräkning definieras på stegnivå åsidosätter den den här standardberäkningen för det specifika steget. Det här värdet måste vara en referens till en befintlig beräkning på arbetsytan med hjälp av syntaxen azureml:<compute-name> .
continue_on_step_failure boolean Om körningen av steg i pipelinen ska fortsätta om ett steg misslyckas. Standardvärdet är False, vilket innebär att om ett steg misslyckas stoppas pipelinekörningen och alla steg som körs avbryts. False

Jobbindata

Nyckel Typ Beskrivning Tillåtna värden Standardvärde
type sträng Typ av jobbindata. Ange uri_file för indata som pekar på en enda filkälla eller uri_folder för indata som pekar på en mappkälla. uri_file, uri_folder uri_folder
path sträng Sökvägen till de data som ska användas som indata. Detta kan anges på några sätt:

– En lokal sökväg till datakällans fil eller mapp, till exempel path: ./iris.csv. Data laddas upp under jobböverföringen.

– En URI för en molnsökväg till filen eller mappen som ska användas som indata. URI-typer som stöds är azureml, https, wasbs, abfss, adl. Mer information om hur du använder azureml:// URI-formatet finns i Core yaml-syntax.

– En befintlig registrerad Azure Machine Learning-datatillgång som ska användas som indata. Om du vill referera till en registrerad datatillgång använder du syntaxen azureml:<data_name>:<data_version> eller azureml:<data_name>@latest (för att referera till den senaste versionen av den datatillgången), till exempel path: azureml:cifar10-data:1 eller path: azureml:cifar10-data@latest.
mode sträng Läge för hur data ska levereras till beräkningsmålet.

För skrivskyddad montering (ro_mount) används data som en monteringssökväg. En mapp monteras som en mapp och en fil monteras som en fil. Azure Machine Learning löser indata till monteringssökvägen.

För download läge laddas data ned till beräkningsmålet. Azure Machine Learning löser indata till den nedladdade sökvägen.

Om du bara vill ha URL:en för lagringsplatsen för dataartefakterna i stället för att montera eller ladda ned själva data kan du använda direct läget. Detta skickar in URL:en för lagringsplatsen som jobbindata. I det här fallet är du helt ansvarig för att hantera autentiseringsuppgifter för att få åtkomst till lagringen.		 ro_mount, , downloaddirect ro_mount

Jobbutdata

Nyckel Typ Beskrivning Tillåtna värden Standardvärde
type sträng Typ av jobbutdata. För standardtypen uri_folder motsvarar utdata en mapp. uri_folder uri_folder
path sträng Sökvägen till de data som ska användas som indata. Detta kan anges på några sätt:

– En lokal sökväg till datakällans fil eller mapp, till exempel path: ./iris.csv. Data laddas upp under jobböverföringen.

– En URI för en molnsökväg till filen eller mappen som ska användas som indata. URI-typer som stöds är azureml, https, wasbs, abfss, adl. Mer information om hur du använder azureml:// URI-formatet finns i Core yaml-syntax.

– En befintlig registrerad Azure Machine Learning-datatillgång som ska användas som indata. Om du vill referera till en registrerad datatillgång använder du syntaxen azureml:<data_name>:<data_version> eller azureml:<data_name>@latest (för att referera till den senaste versionen av den datatillgången), till exempel path: azureml:cifar10-data:1 eller path: azureml:cifar10-data@latest.
mode sträng Läge för hur utdatafiler levereras till mållagringen. För skrivskyddat monteringsläge (rw_mount) är utdatakatalogen en monterad katalog. För uppladdningsläge laddas de filer som skrivs upp i slutet av jobbet. rw_mount, upload rw_mount

Kommentarer

Kommandot az ml schedule kan användas för att hantera Azure Machine Learning-modeller.

Exempel

Exempel är tillgängliga i GitHub-exempellagringsplatsen. Ett par visas nedan.

YAML: Schemalägg med upprepningsmönster

GÄLLER FÖR: Azure CLI ml-tillägget v2 (aktuellt)

$schema: https://azuremlschemas.azureedge.net/latest/schedule.schema.json
name: simple_recurrence_job_schedule
display_name: Simple recurrence job schedule
description: a simple hourly recurrence job schedule

trigger:
  type: recurrence
  frequency: day #can be minute, hour, day, week, month
  interval: 1 #every day
  schedule:
    hours: [4,5,10,11,12]
    minutes: [0,30]
  start_time: "2022-07-10T10:00:00" # optional - default will be schedule creation time
  time_zone: "Pacific Standard Time" # optional - default will be UTC

create_job: ./simple-pipeline-job.yml
# create_job: azureml:simple-pipeline-job

YAML: Schemalägg med cron-uttryck

GÄLLER FÖR: Azure CLI ml-tillägget v2 (aktuellt)

$schema: https://azuremlschemas.azureedge.net/latest/schedule.schema.json
name: simple_cron_job_schedule
display_name: Simple cron job schedule
description: a simple hourly cron job schedule

trigger:
  type: cron
  expression: "0 * * * *"
  start_time: "2022-07-10T10:00:00" # optional - default will be schedule creation time
  time_zone: "Pacific Standard Time" # optional - default will be UTC

# create_job: azureml:simple-pipeline-job
create_job: ./simple-pipeline-job.yml

Bilaga

Tidszon

Aktuellt schema stöder följande tidszoner. Nyckeln kan användas direkt i Python SDK, medan värdet kan användas i YAML-jobbet. Tabellen ordnas efter UTC(Coordinated Universal Time).

UTC Tangent Värde
UTC -12:00 DATELINE_STANDARD_TIME "Dateline Standard Time"
UTC -11:00 UTC_11 "UTC-11"
UTC – 10:00 ALEUTIAN_STANDARD_TIME Aleutian standardtid
UTC – 10:00 HAWAIIAN_STANDARD_TIME "Hawaiian Standard Time"
UTC -09:30 MARQUESAS_STANDARD_TIME "Marquesas Standard Time"
UTC -09:00 ALASKAN_STANDARD_TIME "Alaskan Standard Time"
UTC -09:00 UTC_09 "UTC-09"
UTC -08:00 PACIFIC_STANDARD_TIME_MEXICO "Pacific Standard Time (Mexiko)"
UTC -08:00 UTC_08 "UTC-08"
UTC -08:00 PACIFIC_STANDARD_TIME "Pacific Standard Time"
UTC -07:00 US_MOUNTAIN_STANDARD_TIME "US Mountain Standard Time"
UTC -07:00 MOUNTAIN_STANDARD_TIME_MEXICO "Mountain Standard Time (Mexiko)"
UTC -07:00 MOUNTAIN_STANDARD_TIME "Mountain Standard Time"
UTC -06:00 CENTRAL_AMERICA_STANDARD_TIME "Standardtid för Centralamerika"
UTC -06:00 CENTRAL_STANDARD_TIME "Central standardtid"
UTC -06:00 EASTER_ISLAND_STANDARD_TIME "Påsköns standardtid"
UTC -06:00 CENTRAL_STANDARD_TIME_MEXICO "Central standardtid (Mexiko)"
UTC -06:00 CANADA_CENTRAL_STANDARD_TIME "Canada Central Standard Time"
UTC -05:00 SA_PACIFIC_STANDARD_TIME "SA Pacific Standard Time"
UTC -05:00 EASTERN_STANDARD_TIME_MEXICO "Eastern Standard Time (Mexiko)"
UTC -05:00 EASTERN_STANDARD_TIME "Eastern Standard Time"
UTC -05:00 HAITI_STANDARD_TIME "Haitis standardtid"
UTC -05:00 CUBA_STANDARD_TIME "Kuba, standardtid"
UTC -05:00 US_EASTERN_STANDARD_TIME "US Eastern Standard Time"
UTC -05:00 TURKS_AND_CAICOS_STANDARD_TIME "Turks och Caicos standardtid"
UTC -04:00 PARAGUAY_STANDARD_TIME "Paraguays standardtid"
UTC -04:00 ATLANTIC_STANDARD_TIME "Atlantic Standard Time"
UTC -04:00 VENEZUELA_STANDARD_TIME "Venezuelas standardtid"
UTC -04:00 CENTRAL_BRAZILIAN_STANDARD_TIME "Central brasiliansk standardtid"
UTC -04:00 SA_WESTERN_STANDARD_TIME "SA Western Standard Time"
UTC -04:00 PACIFIC_SA_STANDARD_TIME "Pacific SA Standard Time"
UTC -03:30 NEWFOUNDLAND_STANDARD_TIME "Newfoundland Standard Time"
UTC -03:00 TOCANTINS_STANDARD_TIME "Tocantins Standard Time"
UTC -03:00 E_SOUTH_AMERICAN_STANDARD_TIME "E. Sydamerika, standardtid"
UTC -03:00 SA_EASTERN_STANDARD_TIME "SA Eastern Standard Time"
UTC -03:00 ARGENTINA_STANDARD_TIME "Argentinas standardtid"
UTC -03:00 GREENLAND_STANDARD_TIME "Grönlands standardtid"
UTC -03:00 MONTEVIDEO_STANDARD_TIME "Montevideo Standard Time"
UTC -03:00 SAINT_PIERRE_STANDARD_TIME "Saint Pierre Standard Time"
UTC -03:00 BAHIA_STANDARD_TIM "Bahia Standard Time"
UTC -02:00 UTC_02 "UTC-02"
UTC -02:00 MID_ATLANTIC_STANDARD_TIME "Mid-Atlantic Standard Time"
UTC -01:00 AZORES_STANDARD_TIME "Azorernas standardtid"
UTC -01:00 CAPE_VERDE_STANDARD_TIME "Kap Verdes standardtid"
UTC UTC UTC
UTC +00:00 GMT_STANDARD_TIME "GMT Standard Time"
UTC +00:00 GREENWICH_STANDARD_TIME "Greenwich Standard Time"
UTC +01:00 MOROCCO_STANDARD_TIME "Marocko, standardtid"
UTC +01:00 W_EUROPE_STANDARD_TIME "W. Europa, standardtid"
UTC +01:00 CENTRAL_EUROPE_STANDARD_TIME "Centraleuropa, standardtid"
UTC +01:00 ROMANCE_STANDARD_TIME "Romansk standardtid"
UTC +01:00 CENTRAL_EUROPEAN_STANDARD_TIME "Centraleuropeiska standardtid"
UTC +01:00 W_CENTRAL_AFRICA_STANDARD_TIME "W. Centralafrika, standardtid"
UTC +02:00 NAMIBIA_STANDARD_TIME "Namibias standardtid"
UTC +02:00 JORDAN_STANDARD_TIME "Jordan Standard Time"
UTC +02:00 GTB_STANDARD_TIME "GTB Standard Time"
UTC +02:00 MIDDLE_EAST_STANDARD_TIME "Mellanöstern, standardtid"
UTC +02:00 EGYPT_STANDARD_TIME "Egypten, standardtid"
UTC +02:00 E_EUROPE_STANDARD_TIME "E. Europa, standardtid"
UTC +02:00 SYRIA_STANDARD_TIME "Syrien, standardtid"
UTC +02:00 WEST_BANK_STANDARD_TIME "Standardtid på Västbanken"
UTC +02:00 SOUTH_AFRICA_STANDARD_TIME "Sydafrika, standardtid"
UTC +02:00 FLE_STANDARD_TIME "FLE Standard Time"
UTC +02:00 ISRAEL_STANDARD_TIME "Israel Standard Time"
UTC +02:00 KALININGRAD_STANDARD_TIME "Standardtid för Kaliningrad"
UTC +02:00 LIBYA_STANDARD_TIME "Libyens standardtid"
UTC +03:00 TÜRKIYE_STANDARD_TIME "Türkiye Standard Time"
UTC +03:00 ARABIC_STANDARD_TIME "Arabisk standardtid"
UTC +03:00 ARAB_STANDARD_TIME "Arabisk standardtid"
UTC +03:00 BELARUS_STANDARD_TIME "Vitrysslands standardtid"
UTC +03:00 RUSSIAN_STANDARD_TIME "Rysk standardtid"
UTC +03:00 E_AFRICA_STANDARD_TIME "E. Afrikas standardtid"
UTC +03:30 IRAN_STANDARD_TIME "Iran Standard Time"
UTC +04:00 ARABIAN_STANDARD_TIME "Arabisk standardtid"
UTC +04:00 ASTRAKHAN_STANDARD_TIME "Astrakhan Standard Time"
UTC +04:00 AZERBAIJAN_STANDARD_TIME "Azerbajdzjans standardtid"
UTC +04:00 RUSSIA_TIME_ZONE_3 "Ryssland Tidszon 3"
UTC +04:00 MAURITIUS_STANDARD_TIME "Mauritius standardtid"
UTC +04:00 GEORGIAN_STANDARD_TIME "Georgisk standardtid"
UTC +04:00 CAUCASUS_STANDARD_TIME "Kaukasus, standardtid"
UTC +04:30 AFGHANISTAN_STANDARD_TIME "Afghanistans standardtid"
UTC +05:00 WEST_ASIA_STANDARD_TIME "West Asia Standard Time"
UTC +05:00 EKATERINBURG_STANDARD_TIME "Ekaterinburg, standardtid"
UTC +05:00 PAKISTAN_STANDARD_TIME "Pakistans standardtid"
UTC +05:30 INDIA_STANDARD_TIME "Indien, standardtid"
UTC +05:30 SRI_LANKA_STANDARD_TIME "Sri Lanka Standard Time"
UTC +05:45 NEPAL_STANDARD_TIME "Nepals standardtid"
UTC +06:00 CENTRAL_ASIA_STANDARD_TIME "Central Asia Standard Time"
UTC +06:00 BANGLADESH_STANDARD_TIME "Bangladesh standardtid"
UTC +06:30 MYANMAR_STANDARD_TIME "Myanmars standardtid"
UTC +07:00 N_CENTRAL_ASIA_STANDARD_TIME "N. Centralasiens standardtid"
UTC +07:00 SE_ASIA_STANDARD_TIME "SE Asia Standard Time"
UTC +07:00 ALTAI_STANDARD_TIME "Altai Standard Time"
UTC +07:00 W_MONGOLIA_STANDARD_TIME "W. Mongoliets standardtid"
UTC +07:00 NORTH_ASIA_STANDARD_TIME "North Asia Standard Time"
UTC +07:00 TOMSK_STANDARD_TIME "Tomsk Standard Time"
UTC +08.00 CHINA_STANDARD_TIME "China Standard Time"
UTC +08.00 NORTH_ASIA_EAST_STANDARD_TIME "North Asia East Standard Time"
UTC +08.00 SINGAPORE_STANDARD_TIME "Singapore Standard Time"
UTC +08.00 W_AUSTRALIA_STANDARD_TIME "W. Australien, standardtid"
UTC +08.00 TAIPEI_STANDARD_TIME "Taipei Standard Time"
UTC +08.00 ULAANBAATAR_STANDARD_TIME "Ulaanbaatar Standard Time"
UTC +08:45 AUS_CENTRAL_W_STANDARD_TIME "Aus Central W. Standard Time"
UTC +09:00 NORTH_KOREA_STANDARD_TIME "Nordkoreas standardtid"
UTC +09:00 TRANSBAIKAL_STANDARD_TIME "Transbaikal standardtid"
UTC +09:00 TOKYO_STANDARD_TIME "Tokyos standardtid"
UTC +09:00 KOREA_STANDARD_TIME "Koreas standardtid"
UTC +09:00 YAKUTSK_STANDARD_TIME "Yakutsk Standard Time"
UTC +09:30 CEN_AUSTRALIA_STANDARD_TIME "Cen. Australien, standardtid"
UTC +09:30 AUS_CENTRAL_STANDARD_TIME "AUS Central Standard Time"
UTC +10:00 E_AUSTRALIAN_STANDARD_TIME "E. Australien, standardtid"
UTC +10:00 AUS_EASTERN_STANDARD_TIME "AUS Eastern Standard Time"
UTC +10:00 WEST_PACIFIC_STANDARD_TIME "West Pacific Standard Time"
UTC +10:00 TASMANIA_STANDARD_TIME "Tasmaniens standardtid"
UTC +10:00 VLADIVOSTOK_STANDARD_TIME "Vladivostok Standard Time"
UTC +10:30 LORD_HOWE_STANDARD_TIME "Lord Howe Standard Time"
UTC +11:00 BOUGAINVILLE_STANDARD_TIME "Bougainville Standard Time"
UTC +11:00 RUSSIA_TIME_ZONE_10 "Ryssland Tidszon 10"
UTC +11:00 MAGADAN_STANDARD_TIME "Magadan Standard Time"
UTC +11:00 NORFOLK_STANDARD_TIME "Norfolk Standard Time"
UTC +11:00 SAKHALIN_STANDARD_TIME "Sakhalin Standard Time"
UTC +11:00 CENTRAL_PACIFIC_STANDARD_TIME "Central Pacific Standard Time"
UTC +12:00 RUSSIA_TIME_ZONE_11 "Rysslands tidszon 11"
UTC +12:00 NEW_ZEALAND_STANDARD_TIME "Nyzeeländskt standardtid"
UTC +12:00 UTC_12 "UTC+12"
UTC +12:00 FIJI_STANDARD_TIME "Fijis standardtid"
UTC +12:00 KAMCHATKA_STANDARD_TIME "Kamchatka Standard Time"
UTC +12:45 CHATHAM_ISLANDS_STANDARD_TIME "Chatham Islands Standard Time"
UTC +13:00 TONGA__STANDARD_TIME "Tonga Standard Time"
UTC +13:00 SAMOA_STANDARD_TIME "Samoa Standard Time"
UTC +14:00 LINE_ISLANDS_STANDARD_TIME "Line Islands Standard Time"