Schéma YAML plánu úloh CLI (v2)

PLATÍ PRO: Rozšíření Azure CLI ml v2 (aktuální)

Zdrojové schéma JSON najdete na adrese https://azuremlschemas.azureedge.net/latest/schedule.schema.json.

Poznámka:

Syntaxe YAML podrobná v tomto dokumentu je založená na schématu JSON pro nejnovější verzi rozšíření ML CLI v2. Tato syntaxe je zaručena pouze pro práci s nejnovější verzí rozšíření ML CLI v2. Schémata pro starší verze rozšíření najdete na adrese https://azuremlschemasprod.azureedge.net/.

Syntaxe YAML

Klíč Typ Popis Povolené hodnoty
$schema string Schéma YAML.
name string Povinný: Název plánu
description string Popis plánu
tags objekt Slovník značek pro plán
trigger objekt Konfigurace triggeru definující pravidlo, kdy se má aktivovat úloha. Jedna z RecurrenceTrigger nebo CronTrigger je povinná.
create_job objekt nebo řetězec Povinný: Definice úlohy, která se aktivuje podle plánu. Jedna z string nebo JobDefinition je povinná.

Konfigurace triggeru

Trigger opakování

Klíč Typ Popis Povolené hodnoty
type string Povinný: Určuje typ plánu. recurrence
frequency string Povinný: Určuje jednotku času, která popisuje, jak často se plán aktivuje. minute, hour, day, , weekmonth
interval integer Povinný: Určuje interval, ve kterém se plán aktivuje.
start_time string Popisuje počáteční datum a čas pomocí časového pásma. Pokud start_time vynecháte, spustí se první úloha okamžitě a budoucí úlohy se aktivují na základě plánu, takže start_time se rovná času vytvoření úlohy. Pokud je čas spuštění v minulosti, spustí se první úloha při příštím počítaném běhu.
end_time string Popisuje koncové datum a čas s časovým pásmem. Pokud end_time vynecháte, plán se bude dál spouštět, dokud nebude explicitně zakázaný.
timezone string Určuje časové pásmo opakování. Pokud tento parametr vynecháte, je ve výchozím nastavení UTC. Viz dodatek k hodnotám časového pásma.
pattern objekt Určuje způsob opakování. Pokud vzor vynecháte, úlohy se aktivují podle logiky start_time, četnosti a intervalu.

Plán opakování

Plán opakování definuje způsob opakování, který obsahuje hoursminutes, a weekdays.

  • Pokud je dayfrekvence , model může určit hours a minutes.
  • Je-li week frekvence a month, vzor může určit hours, minutes a weekdays.
Klíč Typ Povolené hodnoty
hours celé číslo nebo pole celého čísla 0-23
minutes celé číslo nebo pole celého čísla 0-59
week_days řetězec nebo pole řetězce monday, tuesday, wednesday, thursday, friday, , saturdaysunday

CronTrigger

Klíč Typ Popis Povolené hodnoty
type string Povinný: Určuje typ plánu. cron
expression string Povinný: Určuje výraz cron, který definuje, jak aktivovat úlohy. výraz používá standardní výraz crontab k vyjádření opakujícího se plánu. Jeden výraz se skládá z pěti polí oddělených mezerami:MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK
start_time string Popisuje počáteční datum a čas pomocí časového pásma. Pokud start_time vynecháte, spustí se první úloha okamžitě a budoucí úlohy se aktivují na základě plánu, takže start_time se rovná času vytvoření úlohy. Pokud je čas spuštění v minulosti, spustí se první úloha při příštím počítaném běhu.
end_time string Popisuje koncové datum a čas s časovým pásmem. Pokud end_time vynecháte, plán se bude dál spouštět, dokud nebude explicitně zakázaný.
timezone string Určuje časové pásmo opakování. Pokud tento parametr vynecháte, je ve výchozím nastavení UTC. Viz dodatek k hodnotám časového pásma.

Definice úlohy

Zákazník může přímo použít create_job: azureml:<job_name> nebo může k definování úlohy použít následující vlastnosti.

Klíč Typ Popis Povolené hodnoty
type string Povinný: Určuje typ úlohy. Podporuje se jenom úloha kanálu. pipeline
job string Povinný: Definujte, jak odkazovat na úlohu, může to být azureml:<job_name> nebo místní úloha kanálu yaml, například file:hello-pipeline.yml.
experiment_name string Název experimentu pro uspořádání úlohy v části Záznam spuštění každé úlohy se uspořádá pod odpovídajícím experimentem na kartě Experimenty v sadě Studio. Pokud tento parametr vynecháme, jako výchozí hodnotu použijeme název plánu.
inputs objekt Slovník vstupů do úlohy. Klíč je název vstupu v kontextu úlohy a hodnota je vstupní hodnota.
outputs objekt Slovník výstupních konfigurací úlohy Klíč je název výstupu v kontextu úlohy a hodnota je výstupní konfigurace.
settings objekt Výchozí nastavení pro úlohu kanálu Viz Atributy settings klíče pro sadu konfigurovatelných vlastností.

settings Atributy klíče

Klíč Typ Popis Default value
default_datastore string Název úložiště dat, který se má použít jako výchozí úložiště dat pro úlohu kanálu. Tato hodnota musí být odkazem na existující úložiště dat v pracovním prostoru pomocí azureml:<datastore-name> syntaxe. Všechny výstupy definované ve outputs vlastnosti úlohy nadřazeného kanálu nebo podřízených úloh krok budou uloženy v tomto úložišti dat. Pokud tento parametr vynecháte, výstupy se uloží do úložiště dat objektů blob pracovního prostoru.
default_compute string Název cílového výpočetního objektu, který se má použít jako výchozí výpočetní prostředky pro všechny kroky v kanálu. Pokud je výpočetní výkon definovaný na úrovni kroku, přepíše tento výchozí výpočetní výkon pro daný konkrétní krok. Tato hodnota musí být odkazem na existující výpočetní prostředky v pracovním prostoru pomocí azureml:<compute-name> syntaxe.
continue_on_step_failure boolean Jestli má provádění kroků v kanálu pokračovat, pokud jeden krok selže. Výchozí hodnota je False, což znamená, že pokud jeden krok selže, spuštění kanálu se zastaví a zruší všechny spuštěné kroky. False

Vstupy úloh

Klíč Typ Popis Povolené hodnoty Default value
type string Typ vstupu úlohy. Zadejte uri_file vstupní data, která ukazují na jeden zdroj souborů, nebo uri_folder pro vstupní data, která ukazují na zdroj složky. uri_file, uri_folder uri_folder
path string Cesta k datům, která se mají použít jako vstup. Můžete ho zadat několika způsoby:

– Místní cesta k souboru nebo složce zdroje dat, path: ./iris.csvnapříklad . Data se nahrají během odeslání úlohy.

– Identifikátor URI cloudové cesty k souboru nebo složce, které se mají použít jako vstup. Podporované typy identifikátorů URI jsou azureml, , httpswasbs, abfss, adl. Další informace o tom, jak používat formát identifikátoru azureml:// URI, najdete v tématu Syntaxe Core yaml.

– Existující zaregistrovaný datový prostředek Služby Azure Machine Learning, který se použije jako vstup. Pokud chcete odkazovat na registrovaný datový asset, použijte azureml:<data_name>:<data_version> syntaxi nebo azureml:<data_name>@latest (k odkazování na nejnovější verzi tohoto datového assetu), například path: azureml:cifar10-data:1 nebo path: azureml:cifar10-data@latest.
mode string Režim doručení dat do cílového výpočetního objektu

Pro připojení jen pro čtení (ro_mount) budou data spotřebována jako cesta připojení. Složka se připojí jako složka a soubor se připojí jako soubor. Azure Machine Learning přeloží vstup do cesty připojení.

Pro download režim se data stáhnou do cílového výpočetního objektu. Azure Machine Learning přeloží vstup do stažené cesty.

Pokud chcete místo připojení nebo stahování samotných dat pouze adresu URL umístění úložiště artefaktů dat, můžete použít direct režim. Tím se předá adresa URL umístění úložiště jako vstup úlohy. V tomto případě jste plně zodpovědní za zpracování přihlašovacích údajů pro přístup k úložišti.
ro_mount, , downloaddirect ro_mount

Výstupy úloh

Klíč Typ Popis Povolené hodnoty Default value
type string Typ výstupu úlohy. Pro výchozí uri_folder typ bude výstup odpovídat složce. uri_folder uri_folder
path string Cesta k datům, která se mají použít jako vstup. Můžete ho zadat několika způsoby:

– Místní cesta k souboru nebo složce zdroje dat, path: ./iris.csvnapříklad . Data se nahrají během odeslání úlohy.

– Identifikátor URI cloudové cesty k souboru nebo složce, které se mají použít jako vstup. Podporované typy identifikátorů URI jsou azureml, , httpswasbs, abfss, adl. Další informace o tom, jak používat formát identifikátoru azureml:// URI, najdete v tématu Syntaxe Core yaml.

– Existující zaregistrovaný datový prostředek Služby Azure Machine Learning, který se použije jako vstup. Pokud chcete odkazovat na registrovaný datový asset, použijte azureml:<data_name>:<data_version> syntaxi nebo azureml:<data_name>@latest (k odkazování na nejnovější verzi tohoto datového assetu), například path: azureml:cifar10-data:1 nebo path: azureml:cifar10-data@latest.
mode string Režim doručení výstupních souborů do cílového úložiště Pro režim připojení pro čtení i zápis (rw_mount) bude výstupní adresář připojeným adresářem. V režimu nahrávání se soubory zapsané nahrají na konci úlohy. rw_mount, upload rw_mount

Poznámky

Tento az ml schedule příkaz se dá použít ke správě modelů Azure Machine Learning.

Příklady

Příklady jsou k dispozici v příkladech v úložišti GitHub. Níže je uvedeno několik.

YAML: Plán se vzorem opakování

PLATÍ PRO: Rozšíření Azure CLI ml v2 (aktuální)

$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: Plánování pomocí výrazu cron

PLATÍ PRO: Rozšíření Azure CLI ml v2 (aktuální)

$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

Dodatek

Časové pásmo

Aktuální plán podporuje následující časová pásma. Klíč lze použít přímo v sadě Python SDK, zatímco hodnotu je možné použít v úloze YAML. Tabulka je uspořádaná podle standardu UTC (Coordinated Universal Time).

UTC Key Hodnota
UTC -12:00 DATELINE_STANDARD_TIME "Dateline Standard Time"
UTC -11:00 UTC_11 "UTC-11"
UTC – 10:00 ALEUTIAN_STANDARD_TIME Aleutian Standard Time
UTC – 10:00 HAWAIIAN_STANDARD_TIME "Havajský standardní čas"
UTC -09:30 MARQUESAS_STANDARD_TIME "Marquesas Standard Time"
UTC -09:00 ALASKAN_STANDARD_TIME "Aljaška standardní čas"
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 "Tichomoří – standardní čas"
UTC -07:00 US_MOUNTAIN_STANDARD_TIME "US Mountain Standard Time"
UTC -07:00 MOUNTAIN_STANDARD_TIME_MEXICO "Horská standardní doba (Mexiko)"
UTC -07:00 MOUNTAIN_STANDARD_TIME "Horská standardní doba"
UTC -06:00 CENTRAL_AMERICA_STANDARD_TIME "Střední Amerika – standardní čas"
UTC -06:00 CENTRAL_STANDARD_TIME "Centrální standardní čas"
UTC -06:00 EASTER_ISLAND_STANDARD_TIME "Velikonoční ostrov Standardní čas"
UTC -06:00 CENTRAL_STANDARD_TIME_MEXICO "Central Standard Time (Mexiko)"
UTC -06:00 CANADA_CENTRAL_STANDARD_TIME "Kanada – střed standardní čas"
UTC -05:00 SA_PACIFIC_STANDARD_TIME "SA Pacific Standard Time"
UTC -05:00 EASTERN_STANDARD_TIME_MEXICO "Východní standardní čas (Mexiko)"
UTC -05:00 EASTERN_STANDARD_TIME "Východní standardní čas"
UTC -05:00 HAITI_STANDARD_TIME "Haiti – standardní čas"
UTC -05:00 CUBA_STANDARD_TIME "Kuba – standardní čas"
UTC -05:00 US_EASTERN_STANDARD_TIME "USA – východ – standardní čas"
UTC -05:00 TURKS_AND_CAICOS_STANDARD_TIME "Turks And Caicos Standardní čas"
UTC -04:00 PARAGUAY_STANDARD_TIME "Paraguay – standardní čas"
UTC -04:00 ATLANTIC_STANDARD_TIME "Atlantic Standard Time"
UTC -04:00 VENEZUELA_STANDARD_TIME "Venezuelský standardní čas"
UTC -04:00 CENTRAL_BRAZILIAN_STANDARD_TIME "Střední brazilský standardní čas"
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. Jižní Amerika Standardní čas"
UTC -03:00 SA_EASTERN_STANDARD_TIME "SA Eastern Standard Time"
UTC -03:00 ARGENTINA_STANDARD_TIME "Argentina Standard Time"
UTC -03:00 GREENLAND_STANDARD_TIME "Greenland Standard Time"
UTC -03:00 MONTEVIDEO_STANDARD_TIME "Montevideo Standardní čas"
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 "Azores Standard Time"
UTC -01:00 CAPE_VERDE_STANDARD_TIME "Kapverdský standardní čas"
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 "Maroko Standardní čas"
UTC +01:00 W_EUROPE_STANDARD_TIME "W. Evropský standardní čas"
UTC +01:00 CENTRAL_EUROPE_STANDARD_TIME "Střední Evropa – standardní čas"
UTC +01:00 ROMANCE_STANDARD_TIME "Romantika standardního času"
UTC +01:00 CENTRAL_EUROPEAN_STANDARD_TIME "Středoevropský standardní čas"
UTC +01:00 W_CENTRAL_AFRICA_STANDARD_TIME "W. Střední Afrika – standardní čas"
UTC +02:00 NAMIBIA_STANDARD_TIME "Namibie – standardní čas"
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 "Střední východ – standardní čas"
UTC +02:00 EGYPT_STANDARD_TIME "Egypt Standardní čas"
UTC +02:00 E_EUROPE_STANDARD_TIME "E. Evropský standardní čas"
UTC +02:00 SYRIA_STANDARD_TIME "Sýrie – standardní čas"
UTC +02:00 WEST_BANK_STANDARD_TIME "Standardní čas západní banky"
UTC +02:00 SOUTH_AFRICA_STANDARD_TIME "Jihoafrická republika – standardní čas"
UTC +02:00 FLE_STANDARD_TIME "FLE Standardní čas"
UTC +02:00 ISRAEL_STANDARD_TIME "Izrael – standardní čas"
UTC +02:00 KALININGRAD_STANDARD_TIME "Kaliningrad – standardní čas"
UTC +02:00 LIBYA_STANDARD_TIME "Libye standardní čas"
UTC +03:00 TÜRKIYE_STANDARD_TIME "Türkiye Standard Time"
UTC +03:00 ARABIC_STANDARD_TIME "Arabský standardní čas"
UTC +03:00 ARAB_STANDARD_TIME "Arabský standardní čas"
UTC +03:00 BELARUS_STANDARD_TIME "Bělorusko Standardní čas"
UTC +03:00 RUSSIAN_STANDARD_TIME "Ruský standardní čas"
UTC +03:00 E_AFRICA_STANDARD_TIME "E. Afrika Standardní čas"
UTC +03:30 IRAN_STANDARD_TIME "Írán – standardní čas"
UTC +04:00 ARABIAN_STANDARD_TIME "Arabský standardní čas"
UTC +04:00 ASTRAKHAN_STANDARD_TIME "Astrakhan Standard Time"
UTC +04:00 AZERBAIJAN_STANDARD_TIME "Ázerbájdžán – standardní čas"
UTC +04:00 RUSSIA_TIME_ZONE_3 "Rusko – časové pásmo 3"
UTC +04:00 MAURITIUS_STANDARD_TIME "Mauricius Standardní čas"
UTC +04:00 GEORGIAN_STANDARD_TIME "Georgian Standard Time"
UTC +04:00 CAUCASUS_STANDARD_TIME "Bělošský standardní čas"
UTC +04:30 AFGHANISTAN_STANDARD_TIME "Afghánistán – standardní čas"
UTC +05:00 WEST_ASIA_STANDARD_TIME "Západní Asie – standardní čas"
UTC +05:00 EKATERINBURG_STANDARD_TIME "Ekaterinburg Standard Time"
UTC +05:00 PAKISTAN_STANDARD_TIME "Pákistán – standardní čas"
UTC +05:30 INDIA_STANDARD_TIME "Indie – standardní čas"
UTC +05:30 SRI_LANKA_STANDARD_TIME "Srí Lanka Standardní čas"
UTC +05:45 NEPAL_STANDARD_TIME "Nepál – standardní čas"
UTC +06:00 CENTRAL_ASIA_STANDARD_TIME "Střední Asie – standardní čas"
UTC +06:00 BANGLADESH_STANDARD_TIME "Bangladéš – standardní čas"
UTC +06:30 MYANMAR_STANDARD_TIME "Myanmar – standardní čas"
UTC +07:00 N_CENTRAL_ASIA_STANDARD_TIME "N. Střední Asie – standardní čas"
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. Mongolsko standardní čas"
UTC +07:00 NORTH_ASIA_STANDARD_TIME "Severní Asie – standardní čas"
UTC +07:00 TOMSK_STANDARD_TIME "Tomsk Standard Time"
UTC + 08:00 CHINA_STANDARD_TIME "Čína – standardní čas"
UTC + 08:00 NORTH_ASIA_EAST_STANDARD_TIME "Severní Asie – východ – standardní čas"
UTC + 08:00 SINGAPORE_STANDARD_TIME "Singapur – standardní čas"
UTC + 08:00 W_AUSTRALIA_STANDARD_TIME "W. Austrálie ( standardní čas)
UTC + 08:00 TAIPEI_STANDARD_TIME "Tchaj-pej – standardní čas"
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 "Severní Korea – standardní čas"
UTC +09:00 TRANSBAIKAL_STANDARD_TIME "Transbaikal Standard Time"
UTC +09:00 TOKYO_STANDARD_TIME "Tokyo Standard Time"
UTC +09:00 KOREA_STANDARD_TIME "Korea Standard Time"
UTC +09:00 YAKUTSK_STANDARD_TIME "Yakutsk Standard Time"
UTC +09:30 CEN_AUSTRALIA_STANDARD_TIME "Cen. Austrálie ( standardní čas)
UTC +09:30 AUS_CENTRAL_STANDARD_TIME "AUS Central Standard Time"
UTC +10:00 E_AUSTRALIAN_STANDARD_TIME "E. Austrálie ( standardní čas)
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 "Tasmania Standard Time"
UTC +10:00 VLADIVOSTOK_STANDARD_TIME "Směrodatný čas"
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 "Rusko – časové pásmo 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 Standardní čas"
UTC +11:00 CENTRAL_PACIFIC_STANDARD_TIME "Střední Tichomoří – standardní čas"
UTC +12:00 RUSSIA_TIME_ZONE_11 "Rusko – časové pásmo 11"
UTC +12:00 NEW_ZEALAND_STANDARD_TIME "Nový Zéland Standardní čas"
UTC +12:00 UTC_12 "UTC+12"
UTC +12:00 FIJI_STANDARD_TIME "Fiji Standard Time"
UTC +12:00 KAMCHATKA_STANDARD_TIME "Kamchatka Standardní čas"
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"