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

az quantum

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

Note

Эта ссылка является частью квантового расширения для 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
                   --location
                   --resource-group
                   --target-id
                   --workspace-name
                   [--entry-point]
                   [--job-name]
                   [--job-output-format]
                   [--job-params]
                   [--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

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

--location -l

Location. Значения из 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.

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

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

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

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

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

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

--location -l

Location. Значения из 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.

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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