Поделиться через


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.

Команды

Имя Описание Тип Состояние
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

Имя учетной записи хранения. Связанная переменная среды: 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

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью 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

Идентификатор сообщения, определяющий сообщение для удаления.

--pop-receipt

Допустимое значение всплывающего уведомления, возвращаемое из предыдущего вызова :func:~get_messages или :func:~update_message операции.

--queue-name -q

Имя очереди.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

Имя учетной записи хранения. Связанная переменная среды: 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

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью 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

Имя учетной записи хранения. Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

Допустимые значения: key, login
--connection-string

Строка подключения учетной записи хранения. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--num-messages

Ненулевое целочисленное значение, указывающее количество сообщений, извлекаемых из очереди, не более 32. Если меньше видимых, возвращаются видимые сообщения. По умолчанию одно сообщение извлекается из очереди с этой операцией.

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

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью 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

Имя учетной записи хранения. Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

Допустимые значения: key, login
--connection-string

Строка подключения учетной записи хранения. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--num-messages

Целочисленное значение ненулевого значения, указывающее количество сообщений, которые нужно просмотреть из очереди, не более 32. По умолчанию одно сообщение выводится из очереди с помощью этой операции.

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

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью 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

Содержимое сообщения размером до 64 КБ.

--queue-name -q

Имя очереди.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

Имя учетной записи хранения. Связанная переменная среды: 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

Укажите интервал времени в реальном времени для сообщения в секундах. Время жизни может быть любым положительным числом или -1 для бесконечности. Если этот параметр опущен, время жизни по умолчанию составляет 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

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью 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

Идентификатор сообщения, определяющий сообщение для удаления.

--pop-receipt

Допустимое значение всплывающего уведомления, возвращаемое из предыдущего вызова :func:~get_messages или :func:~update_message операции.

--queue-name -q

Имя очереди.

Необязательные параметры

--account-key

Ключ учетной записи хранения. Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_KEY.

--account-name

Имя учетной записи хранения. Связанная переменная среды: AZURE_STORAGE_ACCOUNT. Необходимо использовать в сочетании с ключом учетной записи хранения или токеном SAS. Если они отсутствуют, команда попытается запросить ключ учетной записи хранения с помощью учетной записи Azure, прошедшей проверку подлинности. Если выполняется большое количество команд хранения, квота API может быть достигнута.

--auth-mode

Режим выполнения команды. Режим входа будет напрямую использовать учетные данные входа для проверки подлинности. Устаревший режим "ключ" попытается запросить ключ учетной записи, если параметры проверки подлинности для учетной записи не указаны. Переменная среды: AZURE_STORAGE_AUTH_MODE.

Допустимые значения: key, login
--connection-string

Строка подключения учетной записи хранения. Переменная среды: AZURE_STORAGE_CONNECTION_STRING.

--content

Содержимое сообщения размером до 64 КБ.

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

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.