다음을 통해 공유

az quantum job

  • 미리 보기
  • 참조

참고 항목

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

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

Azure Quantum에 대한 작업을 관리합니다.

명령

Name Description 형식 상태
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 job cancel

미리 보기

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

완료되지 않은 경우 Azure Quantum에서 작업을 취소하도록 요청합니다.

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

예제

ID별로 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
기본값: json
--query

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

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 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

예제

Azure Quantum 작업 영역에서 작업 목록을 가져옵니다.

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

필수 매개 변수

--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
기본값: json
--query

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

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 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
기본값: json
--query

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

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 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
기본값: json
--query

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

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 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 --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 job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob

대상에 대한 작업 매개 변수를 사용하여 현재 폴더에서 Q# 프로그램을 제출합니다.

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob --job-params param1=value1 param2=value2

프로그램 매개 변수를 사용하여 Q# 프로그램을 제출합니다(예: n-qubits = 2).

az quantum job submit -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t MyTarget --job-name MyJob -- --n-qubits=2

대상 기능 매개 변수를 사용하여 현재 폴더에서 Q# 프로그램을 제출합니다.

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

현재 폴더의 파일에서 QIR 비트 코드 또는 사람이 읽을 수 있는 LLVM 코드를 제출합니다.

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

필수 매개 변수

--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# 프로그램이 빌드되지 않습니다.

기본값: 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
기본값: json
--query

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

--subscription

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

--verbose

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

az quantum job wait

미리 보기

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

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

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에서 해당 작업의 결과를 쿼리하는 데 걸리는 시간(초)을 폴링합니다.

기본값: 5
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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