Поделиться через

az quantum job

  • Предварительный просмотр
  • Ссылка

Примечание.

Эта ссылка является частью расширения квантовых для Azure CLI (версия 2.41.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az quantum job. Подробнее о расширениях.

Группа команд "quantum" находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Управление заданиями для Azure Quantum.

Команды

Имя Описание Тип Состояние
az quantum job cancel

Запрос на отмену задания в Azure Quantum, если он не завершен.

 Расширение Предварительный просмотр
az quantum job list

Получение списка заданий в рабочей области Quantum.

 Расширение Предварительный просмотр
az quantum job output

Получите результаты выполнения задания.

 Расширение Предварительный просмотр
az quantum job show

Получение состояния и сведений о задании.

 Расширение Предварительный просмотр
az quantum job submit

Отправьте программу или канал для запуска в Azure Quantum.

 Расширение Предварительный просмотр
az quantum job wait

Поместите ИНТЕРФЕЙС командной строки в состояние ожидания до завершения выполнения задания.

 Расширение Предварительный просмотр

az quantum job cancel

Предварительный просмотр

Группа команд "quantum" находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Запрос на отмену задания в Azure Quantum, если он не завершен.

az quantum job cancel --job-id
                      --location
                      --resource-group
                      --workspace-name

Примеры

Отмена задания Azure Quantum по идентификатору.

az quantum job cancel -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy

Обязательные параметры

--job-id -j

Уникальный идентификатор задания в формате GUID.

--location -l

Местоположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Quantum. Вы можете настроить рабочую область по умолчанию с помощью az quantum workspace set.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az quantum job list

Предварительный просмотр

Группа команд "quantum" находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Получение списка заданий в рабочей области Quantum.

az quantum job list --location
                    --resource-group
                    --workspace-name
                    [--created-after]
                    [--created-before]
                    [--item-type]
                    [--job-name]
                    [--job-type]
                    [--order]
                    [--orderby]
                    [--provider-id]
                    [--skip]
                    [--status]
                    [--target-id]
                    [--top]

Примеры

Получение списка заданий из рабочей области Azure Quantum.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation

Вывод списка заданий, которые использовали поставщика microsoft-elements.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --provider-id microsoft-elements

Вывод списка заданий, выполняемых в целевом объекте microsoft.dft.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --target-id microsoft.dft

Список заданий, успешно завершенных.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --status Succeeded

Список заданий, созданных после 15 января 2025 г.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --created-after 2025-01-15

Список заданий, имена которых начинаются с "Создать...".

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --job-name Generate

Пропустите первые 50 заданий, начните с 51-го задания и списка 10 заданий.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --skip 50 --top 10

Сортировка списка заданий по идентификатору целевого объекта и отображение в табличном формате.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Target -o table

Сортировка списка заданий по имени задания в порядке убывания отображается в табличном формате.

az quantum job list -g MyResourceGroup -w MyWorkspace -l MyLocation --orderby Name --order desc -o table

Обязательные параметры

--location -l

Местоположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Quantum. Вы можете настроить рабочую область по умолчанию с помощью az quantum workspace set.

Необязательные параметры

--created-after

Задания, созданные после указанной даты.

--created-before

Задания, созданные до перечисления этой даты.

--item-type

Тип элемента, который должен быть указан, "job" или "session".

--job-name

Понятное имя, чтобы дать этому запуску программы.

--job-type

Тип задания, который будет указан в списке, например QuantumComputing.

--order

Как упорядочить список: asc или desc.

--orderby

Поле, в котором нужно упорядочить список.

--provider-id -p

Идентификатор поставщика Azure Quantum.

--skip

Сколько заданий пропускать при возврате списка заданий.

--status

Состояние заданий, которые нужно перечислить.

--target-id -t

Подсистема выполнения для заданий квантовых вычислений. Если рабочая область настроена с набором поставщиков, каждая из них включает один или несколько целевых объектов. Вы можете настроить целевой объект по умолчанию с помощью az quantum target set.

--top

Количество заданий, перечисленных на странице.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az quantum job output

Предварительный просмотр

Группа команд "quantum" находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Получите результаты выполнения задания.

az quantum job output --job-id
                      --location
                      --resource-group
                      --workspace-name
                      [--item]

Примеры

Печать результатов успешного задания Azure Quantum.

az quantum job output -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy -o table

Обязательные параметры

--job-id -j

Уникальный идентификатор задания в формате GUID.

--location -l

Местоположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Quantum. Вы можете настроить рабочую область по умолчанию с помощью az quantum workspace set.

Необязательные параметры

--item

Индекс элемента в задании пакетной обработки.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az quantum job show

Предварительный просмотр

Группа команд "quantum" находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Получение состояния и сведений о задании.

az quantum job show --job-id
                    --location
                    --resource-group
                    --workspace-name

Примеры

Получение состояния задания Azure Quantum.

az quantum job show -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --query status

Обязательные параметры

--job-id -j

Уникальный идентификатор задания в формате GUID.

--location -l

Местоположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Quantum. Вы можете настроить рабочую область по умолчанию с помощью az quantum workspace set.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az quantum job submit

Предварительный просмотр

Группа команд "quantum" находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Отправьте программу или канал для запуска в Azure Quantum.

az quantum job submit --job-input-file
                      --job-input-format
                      --location
                      --resource-group
                      --target-id
                      --workspace-name
                      [--entry-point]
                      [--job-name]
                      [--job-output-format]
                      [--job-params]
                      [--shots]
                      [--storage]
                      [--target-capability]

Примеры

Отправьте бит-код QIR из файла в текущей папке.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

Отправьте сквозное задание Quil в симулятор Rigetti.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t rigetti.sim.qvm --job-name MyJob --job-input-file MyProgram.quil \
   --job-input-format rigetti.quil.v1 --job-output-format rigetti.quil-results.v1

Отправьте канал Qiskit в симулятор IonQ с парам заданий.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t ionq.simulator --job-name MyJobName --job-input-file MyCircuit.json \
   --job-input-format ionq.circuit.v1 --job-output-format ionq.quantum-results.v1 \
   --job-params count=100 content-type=application/json

Обязательные параметры

--job-input-file

Расположение входного файла для отправки.

--job-input-format

Формат файла для отправки.

--location -l

Местоположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--target-id -t

Подсистема выполнения для заданий квантовых вычислений. Если рабочая область настроена с набором поставщиков, каждая из них включает один или несколько целевых объектов. Вы можете настроить целевой объект по умолчанию с помощью az quantum target set.

--workspace-name -w

Имя рабочей области Quantum. Вы можете настроить рабочую область по умолчанию с помощью az quantum workspace set.

Необязательные параметры

--entry-point

Точка входа для программы QIR или канала. Требуется для заданий QIR.

--job-name

Понятное имя, чтобы дать этому запуску программы.

--job-output-format

Ожидаемый формат выходных данных задания.

--job-params

Параметры задания, передаваемые целевому объекту в виде списка пар key=value, строки json или @{file} с содержимым JSON.

--shots

Количество раз запуска программы в заданном целевом объекте.

--storage

Если задано, функция ConnectionString службы хранилища Azure используется для хранения данных заданий и результатов.

--target-capability

Параметр целевой возможности, переданный компилятору.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az quantum job wait

Предварительный просмотр

Группа команд "quantum" находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Поместите ИНТЕРФЕЙС командной строки в состояние ожидания до завершения выполнения задания.

az quantum job wait --job-id
                    --location
                    --resource-group
                    --workspace-name
                    [--max-poll-wait-secs]

Примеры

Дождитесь завершения задания, проверьте 60 секунд.

az quantum job wait -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -j yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy --max-poll-wait-secs 60 -o table

Обязательные параметры

--job-id -j

Уникальный идентификатор задания в формате GUID.

--location -l

Местоположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--workspace-name -w

Имя рабочей области Quantum. Вы можете настроить рабочую область по умолчанию с помощью az quantum workspace set.

Необязательные параметры

--max-poll-wait-secs

Время опроса в секундах, чтобы запросить Azure Quantum для результатов соответствующего задания.

Default value: 5
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.