다음을 통해 공유


az storage queue

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

스토리지 큐를 관리합니다.

명령

Name Description 형식 상태
az storage queue create

지정된 계정 아래에 큐를 만듭니다.

핵심 미리 보기
az storage queue delete

지정된 큐와 해당 큐에 포함된 모든 메시지를 삭제합니다.

핵심 미리 보기
az storage queue exists

큐가 있는지 여부를 나타내는 부울을 반환합니다.

핵심 미리 보기
az storage queue generate-sas

큐에 대한 공유 액세스 서명을 생성합니다. 반환된 서명을 QueueService의 sas_token 매개 변수와 함께 사용합니다.

핵심 미리 보기
az storage queue list

스토리지 계정의 큐를 나열합니다.

핵심 미리 보기
az storage queue metadata

스토리지 큐에 대한 메타데이터를 관리합니다.

핵심 미리 보기
az storage queue metadata show

지정된 큐에 대한 모든 사용자 정의 메타데이터를 반환합니다.

핵심 미리 보기
az storage queue metadata update

지정된 큐에서 사용자 정의 메타데이터를 설정합니다.

핵심 미리 보기
az storage queue policy

스토리지 큐에 대한 공유 액세스 정책을 관리합니다.

핵심 미리 보기
az storage queue policy create

포함하는 개체에 저장된 액세스 정책을 만듭니다.

핵심 미리 보기
az storage queue policy delete

포함하는 개체에 저장된 액세스 정책을 삭제합니다.

핵심 미리 보기
az storage queue policy list

포함된 개체에 저장된 액세스 정책을 나열합니다.

핵심 미리 보기
az storage queue policy show

포함하는 개체에 저장된 액세스 정책을 표시합니다.

핵심 미리 보기
az storage queue policy update

포함하는 개체에 저장된 액세스 정책을 설정합니다.

핵심 미리 보기
az storage queue stats

큐 서비스에 대한 복제본(replica) 관련 통계를 검색합니다. 스토리지 계정에 대해 읽기 액세스 지역 중복 복제본(replica) 활성화된 경우에만 사용할 수 있습니다.

핵심 미리 보기

az storage queue create

미리 보기

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

지정된 계정 아래에 큐를 만듭니다.

az storage queue create --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--fail-on-exist]
                        [--metadata]
                        [--queue-endpoint]
                        [--sas-token]
                        [--timeout]

예제

메타데이터를 사용하여 지정된 계정 아래에 큐를 만듭니다.

az storage queue create -n myqueue --metadata key1=value1 key2=value2 --account-name mystorageaccount

필수 매개 변수

--name -n

큐 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--fail-on-exist

큐가 이미 있는 경우 예외를 throw할지 여부를 지정합니다.

Default value: False
--metadata

공백으로 구분된 키=값 쌍의 메타데이터입니다. 기존 메타데이터를 덮어씁니다.

--queue-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--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 storage queue delete

미리 보기

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

지정된 큐와 해당 큐에 포함된 모든 메시지를 삭제합니다.

az storage queue delete --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--fail-not-exist]
                        [--queue-endpoint]
                        [--sas-token]
                        [--timeout]

예제

지정된 큐를 삭제하고 큐가 없는 경우 예외를 throw합니다.

az storage queue delete -n myqueue --fail-not-exist --account-name mystorageaccount

필수 매개 변수

--name -n

큐 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--fail-not-exist

큐가 없는 경우 예외를 throw할지 여부를 지정합니다.

Default value: False
--queue-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--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 storage queue exists

미리 보기

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

큐가 있는지 여부를 나타내는 부울을 반환합니다.

az storage queue exists --name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--queue-endpoint]
                        [--sas-token]
                        [--timeout]

예제

큐가 있는지 확인합니다.

az storage queue exists -n myqueue --account-name mystorageaccount

필수 매개 변수

--name -n

큐 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--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 storage queue generate-sas

미리 보기

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

큐에 대한 공유 액세스 서명을 생성합니다. 반환된 서명을 QueueService의 sas_token 매개 변수와 함께 사용합니다.

az storage queue generate-sas --name
                              [--account-key]
                              [--account-name]
                              [--connection-string]
                              [--expiry]
                              [--https-only]
                              [--ip]
                              [--permissions]
                              [--policy-name]
                              [--queue-endpoint]
                              [--start]

예제

읽기 전용 권한이 있는 큐에 대한 sas 토큰을 생성합니다.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage queue generate-sas -n myqueue --account-name mystorageaccount --permissions r --expiry $end --https-only

IP 범위가 지정된 큐에 대한 sas 토큰을 생성합니다.

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage queue generate-sas -n myqueue --account-name mystorageaccount --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

필수 매개 변수

--name -n

큐 이름입니다.

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--connection-string

스토리지 계정 연결 문자열. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--expiry

SAS가 유효하지 않은 UTC 날짜/시간(Y-m-d'T'H:M'Z')을 지정합니다. 저장된 액세스 정책이 이 값을 지정하는 --policy-name으로 참조되는 경우에는 사용하지 마세요.

--https-only

HTTPS 프로토콜을 사용한 요청만 허용합니다. 생략하면 HTTP 및 HTTPS 프로토콜의 요청이 모두 허용됩니다.

--ip

요청을 수락할 IP 주소 또는 IP 주소 범위를 지정합니다. IPv4 스타일 주소만 지원합니다.

--permissions

SAS가 부여하는 권한입니다. 허용되는 값: (a)dd (p)rocess (r)ead (u)pdate. 저장된 액세스 정책이 이 값을 지정하는 --id로 참조되는 경우에는 사용하지 마세요. 결합할 수 있습니다.

--policy-name

공유의 ACL 내에 저장된 액세스 정책의 이름입니다.

--queue-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--start

SAS가 유효한 UTC 날짜/시간(Y-m-d'T'H:M'Z')을 지정합니다. 저장된 액세스 정책이 이 값을 지정하는 --policy-name으로 참조되는 경우에는 사용하지 마세요. 기본적으로 요청 시간으로 설정됩니다.

전역 매개 변수
--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 storage queue list

미리 보기

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

스토리지 계정의 큐를 나열합니다.

az storage queue list [--account-key]
                      [--account-name]
                      [--auth-mode {key, login}]
                      [--connection-string]
                      [--include-metadata]
                      [--marker]
                      [--num-results]
                      [--prefix]
                      [--queue-endpoint]
                      [--sas-token]
                      [--show-next-marker]
                      [--timeout]

예제

스토리지 계정 'mystorageaccount'(계정 이름)에서 이름이 'myprefix'로 시작하는 큐를 나열합니다.

az storage queue list --prefix myprefix --account-name mystorageaccount

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--include-metadata

큐 메타데이터가 응답에 반환되도록 지정합니다.

Default value: False
--marker

다음 목록 작업과 함께 반환할 컨테이너 목록의 부분을 식별하는 문자열 값입니다. 이 작업은 목록 작업이 현재 페이지와 함께 나열될 모든 컨테이너를 다시 반환하지 않으면 응답 본문 내에서 NextMarker 값을 반환합니다기본. 지정한 경우 이 생성기는 이전 생성기가 중지된 지점에서 결과를 반환하기 시작합니다.

--num-results

반환할 최대 수를 지정합니다. 요청이 num_results 지정하지 않거나 5000보다 큰 값을 지정하는 경우 서버는 최대 5,000개의 항목을 반환합니다. 목록 작업이 파티션 경계를 초과하는 경우 서비스는 결과의 다시 기본 검색하기 위한 연속 토큰을 반환합니다. 모두 반환하려면 "*"를 입력합니다.

Default value: 5000
--prefix

이름을 지정된 접두사로 시작하는 큐만 반환하도록 결과를 필터링합니다.

--queue-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--show-next-marker

지정된 경우 결과에 nextMarker를 표시합니다.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--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 storage queue stats

미리 보기

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

큐 서비스에 대한 복제본(replica) 관련 통계를 검색합니다. 스토리지 계정에 대해 읽기 액세스 지역 중복 복제본(replica) 활성화된 경우에만 사용할 수 있습니다.

az storage queue stats [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--queue-endpoint]
                       [--sas-token]
                       [--timeout]

예제

큐 서비스에 대한 복제본(replica) 관련 통계를 표시합니다.

az storage queue stats --account-name mystorageaccount

선택적 매개 변수

--account-key

스토리지 계정 키. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

--account-name

Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 적중될 수 있습니다.

--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

허용되는 값: key, login
--connection-string

스토리지 계정 연결 문자열. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

--queue-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 를 사용하여 각 서비스 기본 엔드포인트를 az storage account show찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--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를 사용합니다.