az quantum job

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

Note

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

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

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

Команды

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

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

 Extension Preview
az quantum job list

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

 Extension Preview
az quantum job output

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

 Extension Preview
az quantum job show

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

 Extension Preview
az quantum job submit

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

 Extension Preview
az quantum job wait

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

 Extension Preview

az quantum job cancel

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

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

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

az quantum job cancel --job-id
                      --resource-group
                      --workspace-name
                      [--acquire-policy-token]
                      [--change-reference]

Примеры

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

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

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

--job-id -j

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

--resource-group -g

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

--workspace-name -w

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

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

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

Свойство Значение
Группа параметров: Global Policy Arguments
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

az quantum job list

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

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

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

az quantum job list --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

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

az quantum job list -g MyResourceGroup -w MyWorkspace --provider-id quantinuum

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

az quantum job list -g MyResourceGroup -w MyWorkspace --target-id ionq.simulator

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

az quantum job output

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

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

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

az quantum job output --job-id
                      --resource-group
                      --workspace-name
                      [--acquire-policy-token]
                      [--change-reference]

Примеры

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

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

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

--job-id -j

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

--resource-group -g

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

--workspace-name -w

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

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

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

Свойство Значение
Группа параметров: Global Policy Arguments
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

az quantum job show

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

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

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

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

Примеры

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

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

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

--job-id -j

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

--resource-group -g

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

--workspace-name -w

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

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

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

az quantum job submit

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

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

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

az quantum job submit --job-input-file
                      --job-input-format
                      --resource-group
                      --target-id
                      --workspace-name
                      [--acquire-policy-token]
                      [--change-reference]
                      [--entry-point]
                      [--job-name]
                      [--job-output-format]
                      [--job-params]
                      [--shots]
                      [--storage]
                      [--target-capability]

Примеры

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

az quantum job submit -g MyResourceGroup -w MyWorkspace -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 \
   -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

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

az quantum job submit -g MyResourceGroup -w MyWorkspace \
   -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

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

--resource-group -g

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

--target-id -t

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

--workspace-name -w

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

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

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

Свойство Значение
Группа параметров: Global Policy Arguments
--entry-point

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

--job-name

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

--job-output-format

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

--job-params

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

--shots

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

--storage

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

--target-capability

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

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

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False

az quantum job wait

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

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

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

az quantum job wait --job-id
                    --resource-group
                    --workspace-name
                    [--acquire-policy-token]
                    [--change-reference]
                    [--max-poll-wait-secs]

Примеры

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

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

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

--job-id -j

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

--resource-group -g

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

--workspace-name -w

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

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

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

Свойство Значение
Группа параметров: Global Policy Arguments
--max-poll-wait-secs

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

Свойство Значение
Default value: 5
Глобальные параметры
--debug

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

Свойство Значение
Default value: False
--help -h

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

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Default value: False