다음을 통해 공유

az quantum

  • 미리 보기
  • 참조

참고 항목

이 참조는 Azure CLI(버전 2.41.0 이상)에 대한 양자 확장의 일부입니다. az quantum 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

이 명령 그룹은 미리 보기 상태이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

Azure Quantum 작업 영역을 관리하고 Azure Quantum Providers에 작업을 제출합니다.

명령

Name Description 형식 상태
az quantum execute

Azure Quantum에서 실행할 작업을 제출하고 결과를 기다립니다.

 내선 번호 프리뷰
az quantum job

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

작업 실행이 완료될 때까지 CLI를 대기 상태로 유지합니다.

 내선 번호 프리뷰
az quantum offerings

Azure Quantum에 대한 공급자 제품을 관리합니다.

 내선 번호 프리뷰
az quantum offerings accept-terms

공급자 및 SKU 조합의 조건에 동의하여 작업 영역을 만들 수 있도록 합니다.

 내선 번호 프리뷰
az quantum offerings list

지정된 위치에서 사용할 수 있는 모든 공급자 제품 목록을 가져옵니다.

 내선 번호 프리뷰
az quantum offerings show-terms

라이선스 URL 및 동의 상태 포함하여 공급자 및 SKU 조합의 조건을 표시합니다.

 내선 번호 프리뷰
az quantum run

az quantum execute과 동일합니다.

 내선 번호 프리뷰
az quantum target

Azure Quantum 작업 영역의 대상을 관리합니다.

 내선 번호 프리뷰
az quantum target clear

기본 대상 ID를 지웁니다.

 내선 번호 프리뷰
az quantum target list

Azure Quantum 작업 영역에서 공급자 및 해당 대상 목록을 가져옵니다.

 내선 번호 프리뷰
az quantum target set

Azure Quantum에 작업을 제출할 때 사용할 기본 대상을 선택합니다.

 내선 번호 프리뷰
az quantum target show

Azure Quantum에 작업을 제출할 때 사용할 현재 기본 대상의 대상 ID를 가져옵니다.

 내선 번호 프리뷰
az quantum workspace

Azure Quantum 작업 영역을 관리합니다.

 내선 번호 프리뷰
az quantum workspace clear

기본 Azure Quantum 작업 영역을 지웁다.

 내선 번호 프리뷰
az quantum workspace create

새 Azure Quantum 작업 영역을 만듭니다.

 내선 번호 프리뷰
az quantum workspace delete

지정된(또는 현재) Azure Quantum 작업 영역을 삭제합니다.

 내선 번호 프리뷰
az quantum workspace keys

Azure Quantum 작업 영역 API 키를 관리합니다.

 내선 번호 프리뷰
az quantum workspace keys list

지정된(또는 현재) Azure Quantum 작업 영역에 대한 API 키를 나열합니다.

 내선 번호 프리뷰
az quantum workspace keys regenerate

지정된(또는 현재) Azure Quantum 작업 영역에 대한 API 키를 다시 생성합니다.

 내선 번호 프리뷰
az quantum workspace list

사용 가능한 Azure Quantum 작업 영역 목록을 가져옵니다.

 내선 번호 프리뷰
az quantum workspace quotas

지정된(또는 현재) Azure Quantum 작업 영역에 대한 할당량을 나열합니다.

 내선 번호 프리뷰
az quantum workspace set

이후 명령에 대한 기본 Azure Quantum 작업 영역을 선택합니다.

 내선 번호 프리뷰
az quantum workspace show

지정된(또는 현재) Azure Quantum 작업 영역의 세부 정보를 가져옵니다.

 내선 번호 프리뷰
az quantum workspace update

지정된(또는 현재) Azure Quantum 작업 영역을 업데이트합니다.

 내선 번호 프리뷰

az quantum execute

미리 보기

명령 그룹 'quantum'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

Azure Quantum에서 실행할 작업을 제출하고 결과를 기다립니다.

az quantum execute --location
                   --resource-group
                   --target-id
                   --workspace-name
                   [--entry-point]
                   [--job-input-file]
                   [--job-input-format]
                   [--job-name]
                   [--job-output-format]
                   [--job-params]
                   [--no-build]
                   [--project]
                   [--shots]
                   [--storage]
                   [--target-capability]
                   [<PROGRAM_ARGS>]

예제

현재 폴더에서 Q# 프로그램을 제출하고 결과를 기다립니다.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

작업 및 프로그램 매개 변수가 있는 현재 폴더에서 Q# 프로그램을 제출하고 기다립니다.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

대상 기능 매개 변수가 있는 현재 폴더에서 Q# 프로그램을 제출하고 기다립니다.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --target-capability MyTargetCapability

필수 매개 변수

--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에 필요합니다. Q# 작업에서 무시됩니다.

--job-input-file

제출할 입력 파일의 위치입니다. QIR, QIO 및 통과 작업에 필요합니다. Q# 작업에서 무시됩니다.

--job-input-format

제출할 파일의 형식입니다. Q# 작업에서 이 매개 변수를 생략합니다.

--job-name

이 프로그램 실행에 제공할 이름입니다.

--job-output-format

예상된 작업 출력 형식입니다. Q# 작업에서 무시됩니다.

--job-params

키=값 쌍, json 문자열 또는 @{file} json 콘텐츠의 목록으로 대상에 전달된 작업 매개 변수입니다.

--no-build

[사용되지 않음] 지정한 경우 제출하기 전에 Q# 프로그램이 빌드되지 않습니다.

Default value: False
--project

[사용되지 않음] 제출할 Q# 프로젝트의 위치입니다. 기본값은 현재 폴더입니다.

--shots

지정된 대상에서 Q# 프로그램을 실행할 횟수입니다.

--storage

지정된 경우 Azure Storage의 커넥트ionString을 사용하여 작업 데이터 및 결과를 저장합니다.

--target-capability

컴파일러에 전달된 대상 기능 매개 변수입니다.

<PROGRAM_ARGS>

다음의 --name=value --로 지정된 Q# 작업에서 예상하는 인수 목록입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az quantum run

미리 보기

명령 그룹 'quantum'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

az quantum execute과 동일합니다.

az quantum run --location
               --resource-group
               --target-id
               --workspace-name
               [--entry-point]
               [--job-input-file]
               [--job-input-format]
               [--job-name]
               [--job-output-format]
               [--job-params]
               [--no-build]
               [--project]
               [--shots]
               [--storage]
               [--target-capability]
               [<PROGRAM_ARGS>]

예제

현재 폴더에서 Q# 프로그램을 제출하고 결과를 기다립니다.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

작업 및 프로그램 매개 변수가 있는 현재 폴더에서 Q# 프로그램을 제출하고 기다립니다.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

대상 기능 매개 변수가 있는 현재 폴더에서 Q# 프로그램을 제출하고 기다립니다.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --target-capability MyTargetCapability

필수 매개 변수

--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에 필요합니다. Q# 작업에서 무시됩니다.

--job-input-file

제출할 입력 파일의 위치입니다. QIR, QIO 및 통과 작업에 필요합니다. Q# 작업에서 무시됩니다.

--job-input-format

제출할 파일의 형식입니다. Q# 작업에서 이 매개 변수를 생략합니다.

--job-name

이 프로그램 실행에 제공할 이름입니다.

--job-output-format

예상된 작업 출력 형식입니다. Q# 작업에서 무시됩니다.

--job-params

키=값 쌍, json 문자열 또는 @{file} json 콘텐츠의 목록으로 대상에 전달된 작업 매개 변수입니다.

--no-build

[사용되지 않음] 지정한 경우 제출하기 전에 Q# 프로그램이 빌드되지 않습니다.

Default value: False
--project

[사용되지 않음] 제출할 Q# 프로젝트의 위치입니다. 기본값은 현재 폴더입니다.

--shots

지정된 대상에서 Q# 프로그램을 실행할 횟수입니다.

--storage

지정된 경우 Azure Storage의 커넥트ionString을 사용하여 작업 데이터 및 결과를 저장합니다.

--target-capability

컴파일러에 전달된 대상 기능 매개 변수입니다.

<PROGRAM_ARGS>

다음의 --name=value --로 지정된 Q# 작업에서 예상하는 인수 목록입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

오류만 표시하고, 경고를 표시하지 않습니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.