Partilhar via

Esquema YAML do cronograma de trabalho da CLI (v2)

  • Artigo

APLICA-SE A: Azure CLI ml extension v2 (atual)

O esquema JSON de origem pode ser encontrado em https://azuremlschemas.azureedge.net/latest/schedule.schema.json.

Nota

A sintaxe YAML detalhada neste documento é baseada no esquema JSON para a versão mais recente da extensão ML CLI v2. Esta sintaxe é garantida apenas para funcionar com a versão mais recente da extensão ML CLI v2. Você pode encontrar os esquemas para versões de extensão mais antigas em https://azuremlschemasprod.azureedge.net/.

Sintaxe YAML

Chave Tipo Description Valores permitidos
$schema string O esquema YAML.
name string Obrigatório. Nome da agenda.
description string Descrição do horário.
tags objeto Dicionário de tags para o horário.
trigger objeto A configuração de gatilho para definir a regra quando acionar o trabalho. Um dos RecurrenceTrigger ou CronTrigger é obrigatório.
create_job objeto ou cadeia de caracteres Obrigatório. A definição do trabalho que será acionado por um cronograma. Um dos string ou JobDefinition é obrigatório.

Configuração do acionador

Acionador de periodicidade

Chave Tipo Description Valores permitidos
type string Obrigatório. Especifica o tipo de agenda. recurrence
frequency string Obrigatório. Especifica a unidade de tempo que descreve a frequência com que a agenda é acionada. minute, hour, day, week, month
interval integer Obrigatório. Especifica o intervalo no qual a agenda é acionada.
start_time string Descreve a data e hora de início com fuso horário. Se start_time for omitido, o primeiro trabalho será executado instantaneamente e os trabalhos futuros serão acionados com base no cronograma, dizendo start_time será igual ao tempo de trabalho criado. Se a hora de início estiver no passado, o primeiro trabalho será executado no próximo tempo de execução calculado.
end_time string Descreve a data e hora de término com fuso horário. Se end_time for omitido, a agenda continuará a ser executada até ser explicitamente desativada.
timezone string Especifica o fuso horário da recorrência. Se omitido, por padrão é UTC. Consulte o apêndice para valores de fuso horário
pattern objeto Especifica o padrão da recorrência. Se o padrão for omitido, o(s) trabalho(s) será(ão) acionado(s) de acordo com a lógica de start_time, frequência e intervalo.

Esquema de recorrência

O esquema de recorrência define o padrão de recorrência, contendo hours, minutese weekdays.

  • Quando a frequência é day, o padrão pode especificar hours e minutes.
  • Quando a frequência é week e month, o padrão pode especificar hours, minutes e weekdays.
Chave Type Valores permitidos
hours inteiro ou matriz de inteiro 0-23
minutes inteiro ou matriz de inteiro 0-59
week_days string ou matriz de string monday, tuesday, wednesday, thursday, friday, saturday, sunday

CronTrigger

Chave Tipo Description Valores permitidos
type string Obrigatório. Especifica o tipo de agenda. cron
expression string Obrigatório. Especifica a expressão cron para definir como disparar trabalhos. expression usa a expressão crontab padrão para expressar uma agenda recorrente. Uma única expressão é composta por cinco campos delimitados por espaço:MINUTES HOURS DAYS MONTHS DAYS-OF-WEEK
start_time string Descreve a data e hora de início com fuso horário. Se start_time for omitido, o primeiro trabalho será executado instantaneamente e os trabalhos futuros serão acionados com base no cronograma, dizendo start_time será igual ao tempo de trabalho criado. Se a hora de início estiver no passado, o primeiro trabalho será executado no próximo tempo de execução calculado.
end_time string Descreve a data e hora de término com fuso horário. Se end_time for omitido, a agenda continuará a ser executada até ser explicitamente desativada.
timezone string Especifica o fuso horário da recorrência. Se omitido, por padrão é UTC. Consulte o apêndice para valores de fuso horário

Definição da tarefa

O cliente pode usar create_job: azureml:<job_name> diretamente ou pode usar as seguintes propriedades para definir o trabalho.

Chave Tipo Description Valores permitidos
type string Obrigatório. Especifica o tipo de trabalho. Somente o trabalho de pipeline é suportado. pipeline
job string Obrigatório. Defina como fazer referência a um trabalho, pode ser azureml:<job_name> ou um trabalho de pipeline local yaml como file:hello-pipeline.yml.
experiment_name string Nome do experimento para organizar o trabalho em. O registo de execução de cada trabalho será organizado sob a experiência correspondente no separador "Experiências" do estúdio. Se omitido, tomaremos o nome da agenda como valor padrão.
inputs objeto Dicionário de entradas para o trabalho. A chave é um nome para a entrada dentro do contexto do trabalho e o valor é o valor de entrada.
outputs objeto Dicionário de configurações de saída do trabalho. A chave é um nome para a saída dentro do contexto do trabalho e o valor é a configuração de saída.
settings objeto Configurações padrão para o trabalho de pipeline. Consulte Atributos da settings chave para o conjunto de propriedades configuráveis.

Atributos da settings chave

Chave Tipo Description Default value
default_datastore string Nome do armazenamento de dados a ser usado como o armazenamento de dados padrão para o trabalho de pipeline. Esse valor deve ser uma referência a um armazenamento de dados existente no espaço de trabalho usando a azureml:<datastore-name> sintaxe. Todas as saídas definidas na outputs propriedade do trabalho de pipeline pai ou do trabalho de etapa filho serão armazenadas neste armazenamento de dados. Se omitidas, as saídas serão armazenadas no armazenamento de dados de blob do espaço de trabalho.
default_compute string Nome do destino de computação a ser usado como o cálculo padrão para todas as etapas no pipeline. Se a computação for definida no nível da etapa, ela substituirá essa computação padrão para essa etapa específica. Esse valor deve ser uma referência a um cálculo existente no espaço de trabalho usando a azureml:<compute-name> sintaxe.
continue_on_step_failure boolean Se a execução de etapas no pipeline deve continuar se uma etapa falhar. O valor padrão é False, o que significa que, se uma etapa falhar, a execução do pipeline será interrompida, cancelando todas as etapas em execução. False

Entradas de trabalho

Chave Tipo Description Valores permitidos Default value
type string O tipo de entrada de trabalho. Especifique uri_file para dados de entrada que apontem para uma única fonte de arquivo ou uri_folder para dados de entrada que apontem para uma fonte de pasta. uri_file, uri_folder uri_folder
path string O caminho para os dados a serem usados como entrada. Isso pode ser especificado de algumas maneiras:

- Um caminho local para o arquivo ou pasta da fonte de dados, por exemplo, path: ./iris.csv. Os dados serão carregados durante a submissão de trabalho.

- Um URI de um caminho de nuvem para o arquivo ou pasta para usar como entrada. Os tipos de URI suportados são azureml, https, , abfsswasbs, adl. Para obter mais informações sobre como usar o azureml:// formato URI, consulte Sintaxe yaml principal.

- Um ativo de dados registrado existente do Azure Machine Learning para usar como entrada. Para fazer referência a um ativo de dados registrado, use a azureml:<data_name>:<data_version> sintaxe ou azureml:<data_name>@latest (para fazer referência à versão mais recente desse ativo de dados), por exemplo, path: azureml:cifar10-data:1 ou path: azureml:cifar10-data@latest.
mode string Modo de como os dados devem ser entregues ao destino de computação.

Para montagem somente leitura (ro_mount), os dados serão consumidos como um caminho de montagem. Uma pasta será montada como uma pasta e um arquivo será montado como um arquivo. O Azure Machine Learning resolverá a entrada para o caminho de montagem.

Para download o modo, os dados serão baixados para o destino de computação. O Azure Machine Learning resolverá a entrada para o caminho baixado.

Se você quiser apenas a URL do local de armazenamento do(s) artefato(s) de dados em vez de montar ou baixar os dados em si, você pode usar o direct modo. Isso passará na URL do local de armazenamento como a entrada do trabalho. Nesse caso, você é totalmente responsável por lidar com as credenciais para acessar o armazenamento.		 ro_mount, download, direct ro_mount

Resultados do trabalho

Chave Tipo Description Valores permitidos Default value
type string O tipo de saída do trabalho. Para o tipo padrão uri_folder , a saída corresponderá a uma pasta. uri_folder uri_folder
path string O caminho para os dados a serem usados como entrada. Isso pode ser especificado de algumas maneiras:

- Um caminho local para o arquivo ou pasta da fonte de dados, por exemplo, path: ./iris.csv. Os dados serão carregados durante a submissão de trabalho.

- Um URI de um caminho de nuvem para o arquivo ou pasta para usar como entrada. Os tipos de URI suportados são azureml, https, , abfsswasbs, adl. Para obter mais informações sobre como usar o azureml:// formato URI, consulte Sintaxe yaml principal.

- Um ativo de dados registrado existente do Azure Machine Learning para usar como entrada. Para fazer referência a um ativo de dados registrado, use a azureml:<data_name>:<data_version> sintaxe ou azureml:<data_name>@latest (para fazer referência à versão mais recente desse ativo de dados), por exemplo, path: azureml:cifar10-data:1 ou path: azureml:cifar10-data@latest.
mode string Modo de como o(s) arquivo(s) de saída será(ão) entregue(s) ao armazenamento de destino. Para o modo de montagem de leitura-gravação (rw_mount), o diretório de saída será um diretório montado. Para o modo de upload, o(s) arquivo(s) escrito(s) será(ão) carregado(s) no final do trabalho. rw_mount, upload rw_mount

Observações

O az ml schedule comando pode ser usado para gerenciar modelos do Azure Machine Learning.

Exemplos

Exemplos estão disponíveis no repositório GitHub de exemplos. Um casal é mostrado abaixo.

YAML: Esquema com padrão de recorrência

APLICA-SE A: Azure CLI ml extension v2 (atual)

$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: Programação com expressão cron

APLICA-SE A: Azure CLI ml extension v2 (atual)

$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

Anexo

Fuso horário

A programação atual suporta os seguintes fusos horários. A chave pode ser usada diretamente no Python SDK, enquanto o valor pode ser usado no trabalho YAML. A tabela é organizada por UTC (Tempo Universal Coordenado).

UTC Key valor
UTC -12:00 DATELINE_STANDARD_TIME "Hora padrão da linha de data"
UTC -11:00 UTC_11 "UTC-11"
UTC - 10:00 ALEUTIAN_STANDARD_TIME Hora Padrão Aleuta
UTC - 10:00 HAWAIIAN_STANDARD_TIME "Hora padrão havaiana"
UTC -09:30 MARQUESAS_STANDARD_TIME "Hora Padrão das Marquesas"
UTC -09:00 ALASKAN_STANDARD_TIME "Hora Padrão do Alasca"
UTC -09:00 UTC_09 "UTC-09"
UTC -08:00 PACIFIC_STANDARD_TIME_MEXICO "Hora Padrão do Pacífico (México)"
UTC -08:00 UTC_08 "UTC-08"
UTC -08:00 PACIFIC_STANDARD_TIME "Hora Padrão do Pacífico"
UTC -07:00 US_MOUNTAIN_STANDARD_TIME "Hora Padrão da Montanha dos EUA"
UTC -07:00 MOUNTAIN_STANDARD_TIME_MEXICO "Hora Padrão da Montanha (México)"
UTC -07:00 MOUNTAIN_STANDARD_TIME "Hora Padrão da Montanha"
UTC -06:00 CENTRAL_AMERICA_STANDARD_TIME "Hora Padrão da América Central"
UTC -06:00 CENTRAL_STANDARD_TIME "Hora Padrão Central"
UTC -06:00 EASTER_ISLAND_STANDARD_TIME "Hora Padrão da Ilha de Páscoa"
UTC -06:00 CENTRAL_STANDARD_TIME_MEXICO "Hora Padrão Central (México)"
UTC -06:00 CANADA_CENTRAL_STANDARD_TIME "Hora Padrão Central do Canadá"
UTC -05:00 SA_PACIFIC_STANDARD_TIME "Hora Padrão do Pacífico SA"
UTC -05:00 EASTERN_STANDARD_TIME_MEXICO "Hora Padrão do Leste (México)"
UTC -05:00 EASTERN_STANDARD_TIME "Hora Padrão do Leste"
UTC -05:00 HAITI_STANDARD_TIME "Hora Padrão do Haiti"
UTC -05:00 CUBA_STANDARD_TIME "Hora Padrão de Cuba"
UTC -05:00 US_EASTERN_STANDARD_TIME "Hora Padrão do Leste dos EUA"
UTC -05:00 TURKS_AND_CAICOS_STANDARD_TIME "Hora Padrão de Turks e Caicos"
UTC -04:00 PARAGUAY_STANDARD_TIME "Hora Padrão do Paraguai"
UTC -04:00 ATLANTIC_STANDARD_TIME "Hora Padrão do Atlântico"
UTC -04:00 VENEZUELA_STANDARD_TIME "Hora Padrão da Venezuela"
UTC -04:00 CENTRAL_BRAZILIAN_STANDARD_TIME "Hora Padrão Central Brasileira"
UTC -04:00 SA_WESTERN_STANDARD_TIME "Hora Padrão Ocidental SA"
UTC -04:00 PACIFIC_SA_STANDARD_TIME "Hora Padrão Pacific SA"
UTC -03:30 NEWFOUNDLAND_STANDARD_TIME "Hora Padrão da Terra Nova"
UTC -03:00 TOCANTINS_STANDARD_TIME "Hora Padrão do Tocantins"
UTC -03:00 E_SOUTH_AMERICAN_STANDARD_TIME "E. Hora Padrão da América do Sul"
UTC -03:00 SA_EASTERN_STANDARD_TIME "SA Hora Padrão do Leste"
UTC -03:00 ARGENTINA_STANDARD_TIME "Hora Padrão Argentina"
UTC -03:00 GREENLAND_STANDARD_TIME "Hora padrão da Gronelândia"
UTC -03:00 MONTEVIDEO_STANDARD_TIME "Hora Padrão de Montevidéu"
UTC -03:00 SAINT_PIERRE_STANDARD_TIME "Hora Padrão de São Pierre"
UTC -03:00 BAHIA_STANDARD_TIM "Hora Padrão da Bahia"
UTC -02:00 UTC_02 "UTC-02"
UTC -02:00 MID_ATLANTIC_STANDARD_TIME "Hora Padrão do Atlântico Médio"
UTC -01:00 AZORES_STANDARD_TIME "Hora Padrão dos Açores"
UTC -01:00 CAPE_VERDE_STANDARD_TIME "Hora Padrão de Cabo Verde"
UTC UTC UTC
UTC +00:00 GMT_STANDARD_TIME "Hora padrão GMT"
UTC +00:00 GREENWICH_STANDARD_TIME "Hora Padrão de Greenwich"
UTC +01:00 MOROCCO_STANDARD_TIME "Hora Padrão de Marrocos"
UTC +01:00 W_EUROPE_STANDARD_TIME "W. Hora Padrão da Europa"
UTC +01:00 CENTRAL_EUROPE_STANDARD_TIME "Hora Padrão da Europa Central"
UTC +01:00 ROMANCE_STANDARD_TIME "Hora padrão do romance"
UTC +01:00 CENTRAL_EUROPEAN_STANDARD_TIME "Hora Padrão da Europa Central"
UTC +01:00 W_CENTRAL_AFRICA_STANDARD_TIME "W. Hora Padrão da África Central"
UTC +02:00 NAMIBIA_STANDARD_TIME "Hora Padrão da Namíbia"
UTC +02:00 JORDAN_STANDARD_TIME "Hora padrão da Jordânia"
UTC +02:00 GTB_STANDARD_TIME "Hora Padrão GTB"
UTC +02:00 MIDDLE_EAST_STANDARD_TIME "Hora Padrão do Médio Oriente"
UTC +02:00 EGYPT_STANDARD_TIME "Hora Padrão do Egito"
UTC +02:00 E_EUROPE_STANDARD_TIME "E. Hora Padrão da Europa"
UTC +02:00 SYRIA_STANDARD_TIME "Hora padrão da Síria"
UTC +02:00 WEST_BANK_STANDARD_TIME "Hora padrão da Cisjordânia"
UTC +02:00 SOUTH_AFRICA_STANDARD_TIME "Hora Padrão da África do Sul"
UTC +02:00 FLE_STANDARD_TIME "Hora Padrão FLE"
UTC +02:00 ISRAEL_STANDARD_TIME "Hora Padrão de Israel"
UTC +02:00 KALININGRAD_STANDARD_TIME "Hora padrão de Kaliningrado"
UTC +02:00 LIBYA_STANDARD_TIME "Hora padrão da Líbia"
UTC +03:00 TÜRKIYE_STANDARD_TIME "Hora Padrão de Türkiye"
UTC +03:00 ARABIC_STANDARD_TIME "Hora padrão árabe"
UTC +03:00 ARAB_STANDARD_TIME "Hora Padrão Árabe"
UTC +03:00 BELARUS_STANDARD_TIME "Hora Padrão da Bielorrússia"
UTC +03:00 RUSSIAN_STANDARD_TIME "Hora padrão russa"
UTC +03:00 E_AFRICA_STANDARD_TIME "E. Hora Padrão de África"
UTC +03:30 IRAN_STANDARD_TIME "Hora Padrão do Irão"
UTC +04:00 ARABIAN_STANDARD_TIME "Hora padrão árabe"
UTC +04:00 ASTRAKHAN_STANDARD_TIME "Hora Padrão de Astrakhan"
UTC +04:00 AZERBAIJAN_STANDARD_TIME "Hora Padrão do Azerbaijão"
UTC +04:00 RUSSIA_TIME_ZONE_3 "Rússia Fuso horário 3"
UTC +04:00 MAURITIUS_STANDARD_TIME "Hora Padrão das Maurícias"
UTC +04:00 GEORGIAN_STANDARD_TIME "Hora padrão da Geórgia"
UTC +04:00 CAUCASUS_STANDARD_TIME "Hora padrão do Cáucaso"
UTC +04:30 AFGHANISTAN_STANDARD_TIME "Hora padrão do Afeganistão"
UTC +05:00 WEST_ASIA_STANDARD_TIME "Hora Padrão da Ásia Ocidental"
UTC +05:00 EKATERINBURG_STANDARD_TIME "Hora Padrão de Ekaterinburg"
UTC +05:00 PAKISTAN_STANDARD_TIME "Hora Padrão do Paquistão"
UTC +05:30 INDIA_STANDARD_TIME "Hora Padrão da Índia"
UTC +05:30 SRI_LANKA_STANDARD_TIME "Hora Padrão do Sri Lanka"
UTC +05:45 NEPAL_STANDARD_TIME "Hora Padrão do Nepal"
UTC +06:00 CENTRAL_ASIA_STANDARD_TIME "Hora Padrão da Ásia Central"
UTC +06:00 BANGLADESH_STANDARD_TIME "Hora padrão de Bangladesh"
UTC +06:30 MYANMAR_STANDARD_TIME "Hora Padrão de Mianmar"
UTC +07:00 N_CENTRAL_ASIA_STANDARD_TIME "Não. Hora Padrão da Ásia Central"
UTC +07:00 SE_ASIA_STANDARD_TIME "Hora Padrão SE Ásia"
UTC +07:00 ALTAI_STANDARD_TIME "Hora padrão de Altai"
UTC +07:00 W_MONGOLIA_STANDARD_TIME "W. Hora Padrão da Mongólia"
UTC +07:00 NORTH_ASIA_STANDARD_TIME "Hora Padrão do Norte da Ásia"
UTC +07:00 TOMSK_STANDARD_TIME "Hora padrão de Tomsk"
UTC +08:00 CHINA_STANDARD_TIME "Hora Padrão da China"
UTC +08:00 NORTH_ASIA_EAST_STANDARD_TIME "Hora Padrão do Leste da Ásia do Norte"
UTC +08:00 SINGAPORE_STANDARD_TIME "Hora Padrão de Singapura"
UTC +08:00 W_AUSTRALIA_STANDARD_TIME "W. Hora Padrão da Austrália"
UTC +08:00 TAIPEI_STANDARD_TIME "Hora Padrão de Taipei"
UTC +08:00 ULAANBAATAR_STANDARD_TIME "Hora Padrão de Ulaanbaatar"
UTC +08:45 AUS_CENTRAL_W_STANDARD_TIME "Aus Central W. Hora Padrão"
UTC +09:00 NORTH_KOREA_STANDARD_TIME "Hora padrão da Coreia do Norte"
UTC +09:00 TRANSBAIKAL_STANDARD_TIME "Hora Padrão Transbaikal"
UTC +09:00 TOKYO_STANDARD_TIME "Hora Padrão de Tóquio"
UTC +09:00 KOREA_STANDARD_TIME "Hora Padrão da Coreia"
UTC +09:00 YAKUTSK_STANDARD_TIME "Hora padrão de Yakutsk"
UTC +09:30 CEN_AUSTRALIA_STANDARD_TIME "Cen. Hora Padrão da Austrália"
UTC +09:30 AUS_CENTRAL_STANDARD_TIME "Hora Padrão Central AUS"
UTC +10:00 E_AUSTRALIAN_STANDARD_TIME "E. Hora Padrão da Austrália"
UTC +10:00 AUS_EASTERN_STANDARD_TIME "AUS Hora Padrão do Leste"
UTC +10:00 WEST_PACIFIC_STANDARD_TIME "Hora Padrão do Pacífico Oeste"
UTC +10:00 TASMANIA_STANDARD_TIME "Hora Padrão da Tasmânia"
UTC +10:00 VLADIVOSTOK_STANDARD_TIME "Hora Padrão de Vladivostok"
UTC +10:30 LORD_HOWE_STANDARD_TIME "Hora Padrão de Lord Howe"
UTC +11:00 BOUGAINVILLE_STANDARD_TIME "Hora Padrão de Bougainville"
UTC +11:00 RUSSIA_TIME_ZONE_10 "Rússia Fuso horário 10"
UTC +11:00 MAGADAN_STANDARD_TIME "Hora Padrão de Magadan"
UTC +11:00 NORFOLK_STANDARD_TIME "Hora Padrão de Norfolk"
UTC +11:00 SAKHALIN_STANDARD_TIME "Hora Padrão de Sacalina"
UTC +11:00 CENTRAL_PACIFIC_STANDARD_TIME "Hora Padrão do Pacífico Central"
UTC +12:00 RUSSIA_TIME_ZONE_11 "Rússia Fuso horário 11"
UTC +12:00 NEW_ZEALAND_STANDARD_TIME "Hora Padrão da Nova Zelândia"
UTC +12:00 UTC_12 "UTC+12"
UTC +12:00 FIJI_STANDARD_TIME "Hora padrão de Fiji"
UTC +12:00 KAMCHATKA_STANDARD_TIME "Hora Padrão de Kamchatka"
UTC +12:45 CHATHAM_ISLANDS_STANDARD_TIME "Hora Padrão das Ilhas Chatham"
UTC +13:00 TONGA__STANDARD_TIME "Hora Padrão de Tonga"
UTC +13:00 SAMOA_STANDARD_TIME "Hora Padrão de Samoa"
UTC +14:00 LINE_ISLANDS_STANDARD_TIME "Hora Padrão das Ilhas da Linha"