다음을 통해 공유

az storage message

  • 미리 보기
  • 참조

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

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

명령에 대한 다음 인증 매개 변수 중 하나를 지정하세요. --auth-mode, --account-key, --connection-string, --sas-token. 해당 환경 변수를 사용하여 인증 자격 증명(예: AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING 및 AZURE_STORAGE_SAS_TOKEN)을 저장할 수도 있습니다.

명령

Name Description 형식 상태
az storage message clear

지정된 큐에서 모든 메시지를 삭제합니다.

 핵심 미리 보기
az storage message delete

지정된 메시지를 삭제합니다.

 핵심 미리 보기
az storage message get

큐 앞에서 하나 이상의 메시지를 검색합니다.

 핵심 미리 보기
az storage message peek

큐 앞에서 하나 이상의 메시지를 검색하지만 메시지의 표시 유형을 변경하지는 않습니다.

 핵심 미리 보기
az storage message put

메시지 큐의 뒷면에 새 메시지를 추가합니다.

 핵심 미리 보기
az storage message update

메시지의 표시 시간 제한을 업데이트합니다.

 핵심 미리 보기

az storage message clear

편집
미리 보기

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

지정된 큐에서 모든 메시지를 삭제합니다.

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

예제

지정된 큐에서 모든 메시지를 삭제합니다.

az storage message clear -q myqueue --account-name mystorageaccount

필수 매개 변수

--queue-name -q

큐 이름입니다.

선택적 매개 변수

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

편집
미리 보기

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

지정된 메시지를 삭제합니다.

az storage message delete --id
                          --pop-receipt
                          --queue-name
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--connection-string]
                          [--queue-endpoint]
                          [--sas-token]
                          [--timeout]

예제

지정된 메시지를 삭제합니다.

az storage message delete --id messageid --pop-receipt popreceiptreturned -q myqueue --account-name mystorageaccount

필수 매개 변수

--id

삭제할 메시지를 식별하는 메시지 ID입니다.

--pop-receipt

:func: 또는 :func:~get_messages~update_message 작업에 대한 이전 호출에서 반환된 유효한 팝 영수증 값입니다.

--queue-name -q

큐 이름입니다.

선택적 매개 변수

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

편집
미리 보기

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

큐 앞에서 하나 이상의 메시지를 검색합니다.

az storage message get --queue-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--num-messages]
                       [--queue-endpoint]
                       [--sas-token]
                       [--timeout]
                       [--visibility-timeout]

예제

큐 앞에서 하나의 메시지를 검색하고 표시 시간 제한을 5분 후로 다시 설정합니다.

az storage message get -q myqueue --visibility-timeout 300 --account-name mystorageaccount

필수 매개 변수

--queue-name -q

큐 이름입니다.

선택적 매개 변수

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

--num-messages

큐에서 검색할 메시지 수를 최대 32개까지 지정하는 0이 아닌 정수 값입니다. 표시되는 메시지가 적으면 표시되는 메시지가 반환됩니다. 기본적으로 이 작업을 사용하여 큐에서 단일 메시지를 검색합니다.

Default value: 1
--queue-endpoint

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

--sas-token

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

--timeout

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

--visibility-timeout

서버 시간을 기준으로 새 표시 시간 제한 값(초)을 지정합니다. 새 값은 1초보다 크거나 같아야 하며 7일보다 클 수 없습니다. 메시지의 표시 시간 제한은 만료 시간보다 나중에 값으로 설정할 수 있습니다.

전역 매개 변수
--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 message peek

편집
미리 보기

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

큐 앞에서 하나 이상의 메시지를 검색하지만 메시지의 표시 유형을 변경하지는 않습니다.

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

예제

큐 앞에서 5개 메시지를 검색합니다(메시지 표시 유형을 변경하지 마세요).

az storage message peek -q myqueue --num-messages 5 --account-name mystorageaccount

필수 매개 변수

--queue-name -q

큐 이름입니다.

선택적 매개 변수

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

--num-messages

큐에서 피킹할 메시지 수를 최대 32개까지 지정하는 0이 아닌 정수 값입니다. 기본적으로 이 작업을 사용하여 큐에서 단일 메시지를 피킹합니다.

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

편집
미리 보기

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

메시지 큐의 뒷면에 새 메시지를 추가합니다.

az storage message put --content
                       --queue-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--queue-endpoint]
                       [--sas-token]
                       [--time-to-live]
                       [--timeout]
                       [--visibility-timeout]

예제

하루 동안 라이브로 표시되는 새 메시지를 추가합니다.

az storage message put -q myqueue --content mymessagecontent --time-to-live 86400 --account-name mystorageaccount

필수 매개 변수

--content

메시지 콘텐츠( 최대 64KB 크기)

--queue-name -q

큐 이름입니다.

선택적 매개 변수

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

--time-to-live

메시지의 TL(Time-to-Live) 간격(초)을 지정합니다. TL(Time to Live)은 양수이거나 무한대는 -1일 수 있습니다. 이 매개 변수를 생략하면 기본 TSL(Time to Live)은 7일입니다.

--timeout

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

--visibility-timeout

지정하지 않으면 기본값은 0입니다. 서버 시간을 기준으로 새 표시 시간 제한 값(초)을 지정합니다. 값은 0보다 크거나 같아야 하며 7일보다 클 수 없습니다. 메시지의 표시 시간 제한은 만료 시간 이후의 값으로 설정할 수 없습니다. visibility_timeout time_to_live 값보다 작은 값으로 설정해야 합니다.

전역 매개 변수
--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 message update

편집
미리 보기

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

메시지의 표시 시간 제한을 업데이트합니다.

az storage message update --id
                          --pop-receipt
                          --queue-name
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--connection-string]
                          [--content]
                          [--queue-endpoint]
                          [--sas-token]
                          [--timeout]
                          [--visibility-timeout]

예제

메시지의 표시 시간 제한 및 콘텐츠를 업데이트합니다.

az storage message update --id messageid --pop-receipt popreceiptreturned -q myqueue
--visibility-timeout 3600 --content newmessagecontent --account-name mystorageaccount

필수 매개 변수

--id

삭제할 메시지를 식별하는 메시지 ID입니다.

--pop-receipt

:func: 또는 :func:~get_messages~update_message 작업에 대한 이전 호출에서 반환된 유효한 팝 영수증 값입니다.

--queue-name -q

큐 이름입니다.

선택적 매개 변수

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

--content

메시지 콘텐츠( 최대 64KB 크기)

--queue-endpoint

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

--sas-token

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

--timeout

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

--visibility-timeout

지정하지 않으면 기본값은 0입니다. 서버 시간을 기준으로 새 표시 시간 제한 값(초)을 지정합니다. 새 값은 0보다 크거나 같아야 하며 7일보다 클 수 없습니다. 메시지의 표시 시간 제한은 만료 시간 이후의 값으로 설정할 수 없습니다. 삭제되거나 만료될 때까지 메시지를 업데이트할 수 있습니다.

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