Данная статья переведена с помощью средств машинного перевода. Чтобы просмотреть ее на английском языке, установите флажок Английский. Вы также можете просматривать английский текст во всплывающем окне, наводя указатель мыши на переведенный текст.
Перевод
Английский

Задание метаданных очереди

 

Классы System.Threading.Tasks.Task и System.Threading.Tasks.Task<TResult> поддерживают отмену через использование токенов отмены в .NET Framework. Метаданные связаны с очередью в виде пар "имя-значение".

Классы System.Threading.Tasks.Task и System.Threading.Tasks.Task<TResult> поддерживают отмену через использование токенов отмены в .NET Framework. Рекомендуется использовать протокол HTTPS.

Метод

URI запроса

Версия HTTP

PUT

https://myaccount.queue.core.windows.net/myqueue?comp=metadata

HTTP/1.1

При построении запроса к эмулированной службе хранилища укажите имя узла эмулятора и порт службы очередей в качестве 127.0.0.1:10001, а затем имя учетной записи эмулированного хранилища:

Метод

URI запроса

Версия HTTP

PUT

http://127.0.0.1:10001/devstoreaccount1/myqueue?comp=metadata

HTTP/1.1

В URI запроса могут быть заданы следующие дополнительные параметры.

Параметр

Описание

timeout

Необязательно. Ядро автоматизации UI маскирует любые отличия в структурах, принадлежащих различным частям UI. Дополнительные сведения см. в разделе Задание времени ожидания для операций службы очередей.

В следующей таблице перечислены обязательные и необязательные заголовки запросов.

Заголовок запроса

Описание

Authorization

Обязательно. Указывает схему проверки подлинности, имя учетной записи и подпись. Дополнительные сведения см. в разделе Проверка подлинности для служб хранения Azure.

Date или x-ms-date

Обязательно. Задает время в формате UTC для запроса. Дополнительные сведения см. в разделе Проверка подлинности для служб хранения Azure.

x-ms-version

Необязательно. Задает версию операции, используемой для этого запроса. Дополнительные сведения см. в разделе Управление версиями для служб хранилища Azure.

x-ms-meta-name:string-value

Необязательно. Пары "имя-значение", которые будут связаны с очередью как метаданные.

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

Обратите внимание, что начиная с версии 2009-09-19, имена метаданных должны соответствовать правилам именования для идентификаторов C#.

x-ms-client-request-id

Необязательно. Клиент создал непрозрачное значение с ограничением символов, равным 1 КБ, которое записывается в журналы аналитики, когда ведение журнала службы аналитики хранилища включено. Настоятельно рекомендуется использовать этот заголовок для корреляции действий на стороне клиента с запросами, которые принимает сервер. Дополнительные сведения см. в разделе Сведения о ведении журнала службы аналитики хранилища и Ведение журнала Azure: Использование журналов для отслеживания запросов к хранилищу.

Отсутствуют.

Request Syntax: PUT https://myaccount.queue.core.windows.net/myqueue?comp=metadata HTTP/1.1 Request Headers: x-ms-version: 2011-08-18 x-ms-date: Fri, 16 Sep 2011 01:47:14 GMT x-ms-meta-meta-sample1: sample1 x-ms-meta-meta-sample2: sample2 Authorization: SharedKey myaccount:u6PSIebDltGW5xHpO77epRpiUhcsTkWMvcM4GTmfqqA=

Ответ включает код состояния HTTP и набор заголовков ответа.

Успешная операция возвращает код состояния 204 (нет контента).

Сведения о кодах состояния см. в разделе Коды состояний и ошибок.

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

Заголовок ответа

Описание

x-ms-request-id

Этот заголовок однозначно определяет выполненный запрос, его также можно использовать для устранения связанных с запросом неполадок. Дополнительные сведения см. в разделе Устранение неполадок при API-операциях.

x-ms-version

Указывает версию службы очередей, которая используется для выполнения запроса. Этот заголовок возвращается для запросов к версии 2009-09-19 и более поздним версиям.

Date

Значение даты и времени в формате UTC, сформированное службой и указывающее время, когда был инициирован ответ.

Отсутствуют.

Вызов этой операции доступен только владельцу учетной записи.

Чтобы удалить метаданные из очереди, вызовите Set Queue Metadata без указания заголовки метаданных.

Показ: