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


az quantum

Note

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

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

Управление рабочими областями Azure Quantum и отправка заданий поставщикам Azure Quantum.

Команды

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

Отправьте задание для выполнения в Azure Quantum и дождитесь результата. Эквивалентно az quantum run.

Extension Preview
az quantum job

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

Extension Preview
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 offerings

Управление предложениями поставщика для Azure Quantum.

Extension Preview
az quantum offerings accept-terms

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

Extension Preview
az quantum offerings list

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

Extension Preview
az quantum offerings show-terms

Отображение условий сочетания поставщика и номера SKU, включая URL-адрес лицензии и состояние принятия.

Extension Preview
az quantum run

Отправьте задание для выполнения в Azure Quantum и дождитесь результата. Эквивалентно az quantum execute.

Extension Preview
az quantum target

Управление целевыми объектами для рабочих областей Azure Quantum.

Extension Preview
az quantum target clear

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

Extension Preview
az quantum target list

Получите список поставщиков и их целевых объектов в рабочей области Azure Quantum.

Extension Preview
az quantum target set

Выберите целевой объект по умолчанию, используемый при отправке заданий в Azure Quantum.

Extension Preview
az quantum target show

Получите идентификатор целевого объекта по умолчанию, который будет использоваться при отправке заданий в Azure Quantum.

Extension Preview
az quantum workspace

Управление рабочими областями Azure Quantum.

Extension Preview
az quantum workspace clear

Очистите рабочую область Azure Quantum по умолчанию.

Extension Preview
az quantum workspace create

Создайте новую рабочую область Azure Quantum.

Extension Preview
az quantum workspace delete

Удалите указанную (или текущую) рабочую область Azure Quantum.

Extension Preview
az quantum workspace keys

Управление ключами API Azure Quantum рабочей области.

Extension Preview
az quantum workspace keys list

Вывод списка ключей API для данной рабочей области (или текущей) Azure Quantum.

Extension Preview
az quantum workspace keys regenerate

Повторно создайте ключ API для данной рабочей области (или текущей) Azure Quantum.

Extension Preview
az quantum workspace list

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

Extension Preview
az quantum workspace quotas

Перечислить квоты для данной (или текущей) рабочей области Azure Quantum.

Extension Preview
az quantum workspace set

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

Extension Preview
az quantum workspace show

Получите сведения о заданной (или текущей) рабочей области Azure Quantum.

Extension Preview
az quantum workspace update

Обновите указанную рабочую область (или текущую) Azure Quantum.

Extension Preview

az quantum execute

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

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

Отправьте задание для выполнения в Azure Quantum и дождитесь результата. Эквивалентно az quantum run.

az quantum execute --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]
                   [--location]
                   [--shots]
                   [--storage]
                   [--target-capability]
                   []

Примеры

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

az quantum execute -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 execute -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 execute -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

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

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

--location
Не рекомендуется

Параметр --location устарел и будет удален в мае 2026 года.

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

--shots

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

--storage

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

--target-capability

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

-l

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

Глобальные параметры
--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 run

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

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

Отправьте задание для выполнения в Azure Quantum и дождитесь результата. Эквивалентно az quantum execute.

az quantum run --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]
               [--location]
               [--shots]
               [--storage]
               [--target-capability]
               []

Примеры

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

az quantum run -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 run -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 run -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

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

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

--location
Не рекомендуется

Параметр --location устарел и будет удален в мае 2026 года.

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

--shots

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

--storage

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

--target-capability

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

-l
Не рекомендуется

Аргумент --location устарел и будет удален в мае 2026 года.

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

Глобальные параметры
--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