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

Подписанный URL-адрес (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: 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

Подписанный URL-адрес (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

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

значение по умолчанию: 1

--queue-endpoint

служба хранилища конечную точку службы данных. Необходимо использовать совместно с ключом учетной записи хранения или маркером SAS. Вы можете найти каждую основную конечную точку службы с az storage account showпомощью . Переменная среды: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Подписанный URL-адрес (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

значение по умолчанию: 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

Подписанный URL-адрес (SAS). Необходимо использовать в сочетании с именем учетной записи хранения или конечной точкой службы. Переменная среды: AZURE_STORAGE_SAS_TOKEN.

--timeout

Время ожидания запроса в секундах. Применяется к каждому вызову службы.

Глобальные параметры

--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc

значение по умолчанию: 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

Подписанный URL-адрес (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

значение по умолчанию: 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

Подписанный URL-адрес (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

значение по умолчанию: json

--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

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