az storage message
큐 스토리지 메시지를 관리합니다.
명령에 대한 인증 매개 변수 --auth-mode, --account-key, --connection-string, --sas-token 중 하나를 지정하세요. 또한 해당 환경 변수를 사용하여 인증 자격 증명(예: AZURE_STORAGE_KEY, AZURE_STORAGE_CONNECTION_STRING 및 AZURE_STORAGE_SAS_TOKEN)을 저장할 수 있습니다.
명령
| 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
지정된 큐에서 모든 메시지를 삭제합니다.
az storage message clear --queue-name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--sas-token]
[--subscription]
[--timeout]
필수 매개 변수
큐 이름입니다.
선택적 매개 변수
스토리지 계정 키. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.
Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 시도합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량에 도달할 수 있습니다.
명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.
계정 연결 문자열을 Storage. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.
SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.
구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.
요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az storage message delete
지정된 메시지를 삭제합니다.
일반적으로 클라이언트는 get_messages 작업을 통해 메시지를 검색한 후 메시지를 처리하고 삭제해야 합니다. 메시지를 삭제하려면 id 및 pop_receipt 두 개의 데이터 항목이 있어야 합니다. ID는 이전 get_messages 작업에서 반환됩니다. pop_receipt 가장 최근의 get_messages() 또는 update_message() 작업에서 반환됩니다. delete_message 작업이 성공하려면 요청에 지정된 pop_receipt get_messages() 또는 update_message() 작업에서 반환된 pop_receipt 일치해야 합니다.
az storage message delete --id
--pop-receipt
--queue-name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--sas-token]
[--subscription]
[--timeout]
필수 매개 변수
삭제할 메시지를 식별하는 메시지 ID입니다.
get_messages() 또는 update_message()에 대한 이전 호출에서 반환된 유효한 팝 영수증 값입니다.
큐 이름입니다.
선택적 매개 변수
스토리지 계정 키. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.
Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 시도합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량에 도달할 수 있습니다.
명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.
계정 연결 문자열을 Storage. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.
SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.
구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.
요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az storage message get
큐 앞에서 하나 이상의 메시지를 검색합니다.
큐에서 메시지를 검색하면 응답에 메시지 내용과 메시지를 삭제하는 데 필요한 pop_receipt 값이 포함됩니다. 메시지는 큐에서 자동으로 삭제되지 않지만 검색된 후에는 visibility_timeout 매개 변수로 지정된 시간 간격 동안 다른 클라이언트에 표시되지 않습니다. 키-암호화 키 또는 확인자 필드가 로컬 서비스 개체에 설정된 경우 메시지가 반환되기 전에 암호 해독됩니다.
az storage message get --queue-name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--num-messages]
[--sas-token]
[--subscription]
[--timeout]
[--visibility-timeout]
필수 매개 변수
큐 이름입니다.
선택적 매개 변수
스토리지 계정 키. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.
Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 시도합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량에 도달할 수 있습니다.
명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.
계정 연결 문자열을 Storage. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.
최대 32까지 큐에서 검색할 메시지 수를 지정하는 0이 아닌 정수 값입니다. 표시 가능한 수가 더 적으면 해당 표시 가능한 메시지가 반환됩니다. 기본적으로 이 작업으로는 메시지에서 단일 메시지가 검색됩니다.
SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.
구독의 이름 또는 ID입니다. 를 사용하여 기본 구독을 구성할 수 az account set -s NAME_OR_ID 있습니다.
요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.
서버 시간을 기준으로 새로운 표시 제한 시간 값(초)을 지정합니다. 새 값은 1초보다 크거나 같아야 하며 7일보다 클 수 없습니다. 메시지의 표시 제한 시간은 만료 시간보다 큰 값으로 설정할 수 있습니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az storage message peek
큐 앞에서 하나 이상의 메시지를 검색하지만 메시지의 표시 여부를 변경하지는 않습니다.
표시되는 메시지만 검색할 수 있습니다. get_messages 호출을 사용하여 메시지를 처음으로 검색하면 dequeue_count 속성이 1로 설정됩니다. 삭제되지 않고 이후에 다시 검색되는 경우 dequeue_count 속성이 증가합니다. 클라이언트는 이 값을 사용하여 메시지가 검색된 횟수를 확인할 수 있습니다. peek_messages 호출은 DequeueCount 값을 증가시키지 않지만 읽을 클라이언트에 대해 이 값을 반환합니다. 키-암호화 키 또는 확인자 필드가 로컬 서비스 개체에 설정된 경우 메시지가 반환되기 전에 암호 해독됩니다.
az storage message peek --queue-name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--num-messages]
[--sas-token]
[--subscription]
[--timeout]
필수 매개 변수
큐 이름입니다.
선택적 매개 변수
스토리지 계정 키. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.
Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 는 저장소 계정 키 또는 SAS 토큰과 함께 사용 해야 합니다. 아무 것도 없는 경우 명령은 인증 된 Azure 계정을 사용 하 여 저장소 계정 키 쿼리를 시도 합니다. 많은 수의 저장소 명령이 실행 되는 경우 API 할당량이 적중 될 수 있습니다.
명령을 실행할 모드입니다. "로그인" 모드는 인증에 대 한 로그인 자격 증명을 직접 사용 합니다. 계정에 대 한 인증 매개 변수가 제공 되지 않은 경우 레거시 "키" 모드는 계정 키에 대 한 쿼리를 시도 합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.
Storage 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.
최대 32까지 큐에서 미리 보려는 메시지 수를 지정하는 0이 아닌 정수 값입니다. 기본적으로 이 작업으로는 메시지에서 단일 메시지를 미리 봅니다.
SAS (공유 액세스 서명)입니다. 저장소 계정 이름과 함께 사용 해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.
구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .
요청 시간 제한 (초)입니다. 서비스에 대 한 각 호출에 적용 됩니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az storage message put
메시지 큐의 뒤에 새 메시지를 추가 합니다.
표시 제한 시간은 메시지를 표시 하지 않을 시간을 지정 합니다. 제한 시간이 만료된 뒤에는 메시지가 표시됩니다. 표시 제한 시간을 지정하지 않으면 기본값 0이 사용됩니다. 메시지 ttl (time to live)은 메시지를 큐에 유지 하는 기간을 지정 합니다. Ttl (time-to-live) 기간이 만료 되 면 메시지는 큐에서 삭제 됩니다. 키 암호화 키 필드가 로컬 서비스 개체에 설정 되어 있으면이 메서드는 업로드 하기 전에 콘텐츠를 암호화 합니다.
az storage message put --content
--queue-name
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--sas-token]
[--subscription]
[--time-to-live]
[--timeout]
[--visibility-timeout]
필수 매개 변수
최대 64KB 크기의 메시지 내용입니다.
큐 이름입니다.
선택적 매개 변수
스토리지 계정 키. 저장소 계정 이름과 함께 사용 해야 합니다. 환경 변수: AZURE_STORAGE_KEY.
Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 는 저장소 계정 키 또는 SAS 토큰과 함께 사용 해야 합니다. 아무 것도 없는 경우 명령은 인증 된 Azure 계정을 사용 하 여 저장소 계정 키 쿼리를 시도 합니다. 많은 수의 저장소 명령이 실행 되는 경우 API 할당량이 적중 될 수 있습니다.
명령을 실행할 모드입니다. "로그인" 모드는 인증에 대 한 로그인 자격 증명을 직접 사용 합니다. 계정에 대 한 인증 매개 변수가 제공 되지 않은 경우 레거시 "키" 모드는 계정 키에 대 한 쿼리를 시도 합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.
Storage 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.
SAS (공유 액세스 서명)입니다. 저장소 계정 이름과 함께 사용 해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.
구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .
메시지에 대한 TTL(time-to-live) 간격(초)을 지정합니다. Ttl (time-to-live)은 임의의 양수가 될 수도 있고 무한대의 경우-1 일 수도 있습니다. 이 매개 변수를 생략한 경우 기본 TTL(time-to-live)은 7일입니다.
요청 시간 제한 (초)입니다. 서비스에 대 한 각 호출에 적용 됩니다.
지정되지 않은 경우 기본값은 0입니다. 서버 시간을 기준으로 새로운 표시 제한 시간 값(초)을 지정합니다. 값은 0 보다 크거나 같아야 하며 7 일 보다 클 수 없습니다. 메시지의 가시성 제한 시간은 만료 시간보다 큰 값으로 설정할 수 없습니다. visibility_timeout은 ttl (time to live) 값 보다 작은 값으로 설정 해야 합니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.
az storage message update
메시지의 표시 제한 시간을 업데이트 합니다.
또한 이 작업을 사용해서 메시지의 콘텐츠를 업데이트할 수도 있습니다. 이 작업을 사용 하 여 큐 메시지의 표시 안 함를 지속적으로 확장할 수 있습니다. 이 기능은 작업자 역할이 큐 메시지를 "임대" 하도록 하려는 경우에 유용할 수 있습니다. 예를 들어 작업자 역할이 get_messages를 호출 하 고 메시지를 처리 하는 데 시간이 더 필요한 경우 처리 될 때까지 메시지의 표시 안 함를 계속 해 서 확장할 수 있습니다. 처리 하는 동안 작업자 역할이 실패 하는 경우 결국 메시지가 다시 표시 되 고 다른 작업자 역할이이를 처리할 수 있게 됩니다. 키 암호화 키 필드가 로컬 서비스 개체에 설정 되어 있으면이 메서드는 업로드 하기 전에 콘텐츠를 암호화 합니다.
az storage message update --id
--pop-receipt
--queue-name
--visibility-timeout
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--connection-string]
[--content]
[--sas-token]
[--subscription]
[--timeout]
필수 매개 변수
업데이트할 메시지를 식별 하는 메시지 id입니다.
Get_messages () 또는 update_message () 작업에 대 한 이전 호출에서 반환 된 유효한 pop 수신 값입니다.
큐 이름입니다.
서버 시간을 기준으로 새로운 표시 제한 시간 값(초)을 지정합니다. 새 값은 0 이상이어야 하며 7일을 초과할 수 없습니다. 메시지의 가시성 제한 시간은 만료 시간보다 큰 값으로 설정할 수 없습니다. 메시지는 삭제 또는 만료되기 전까지 업데이트할 수 있습니다.
선택적 매개 변수
스토리지 계정 키. 저장소 계정 이름과 함께 사용 해야 합니다. 환경 변수: AZURE_STORAGE_KEY.
Storage 계정 이름 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 는 저장소 계정 키 또는 SAS 토큰과 함께 사용 해야 합니다. 아무 것도 없는 경우 명령은 인증 된 Azure 계정을 사용 하 여 저장소 계정 키 쿼리를 시도 합니다. 많은 수의 저장소 명령이 실행 되는 경우 API 할당량이 적중 될 수 있습니다.
명령을 실행할 모드입니다. "로그인" 모드는 인증에 대 한 로그인 자격 증명을 직접 사용 합니다. 계정에 대 한 인증 매개 변수가 제공 되지 않은 경우 레거시 "키" 모드는 계정 키에 대 한 쿼리를 시도 합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.
Storage 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.
최대 64KB 크기의 메시지 내용입니다.
SAS (공유 액세스 서명)입니다. 저장소 계정 이름과 함께 사용 해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.
구독의 이름 또는 ID입니다. 을 사용 하 여 기본 구독을 구성할 수 있습니다 az account set -s NAME_OR_ID .
요청 시간 제한 (초)입니다. 서비스에 대 한 각 호출에 적용 됩니다.
로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.
이 도움말 메시지를 표시하고 종료합니다.
오류만 표시하고, 경고를 표시하지 않습니다.
출력 형식입니다.
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/를 참조하세요.
로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.