Была ли эта страница полезной?
Ваш отзыв об этом контенте важен для нас. Расскажите нам о том, что вы думаете.
Дополнительный отзыв?
1500 символов осталось
Экспорт (0) Печать
Развернуть все

Операция вставки записи

Обновлено: Июнь 2015 г.

Вставляет новый элемент в таблицу.

Запрос можно указать следующим образом. Замените <service_name> именем своей мобильной службы, а <table_name> именем запрашиваемой таблицы.

 

HTTP-команда URI запроса Версия HTTP

POST

https://<service_name>.azure-mobile.net/tables/<table_name>

HTTP/1.1

 

Параметр URI Обязательно Описание

noscript

Нет 

Если предоставлено значение true, выполнение зарегистрированных скриптов запрещено. Чтобы подавить выполнение скриптов, необходимо также задать главный ключ службы в заголовке X-ZUMO-MASTER.

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

 

Заголовок запроса Обязательно  

Accept

Нет 

Задайте для этого заголовка значение application/json.

Content-Length

Да

Длина текста запроса.

Content-Type

Да

Задайте для этого заголовка значение application/json.

X-ZUMO-APPLICATION

Условные

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

X-ZUMO-AUTH

Условные

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

X-ZUMO-MASTER

Условные

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

securityПримечание o безопасности.
Главный ключ службы — это важная часть учетных данных безопасности, обеспечивающая доступ к службе данных на уровне администратора. Не делитесь этим секретом ни с кем и не распространяйте с приложением. Этот ключ всегда необходимо безопасно распространять по зашифрованному каналу.

Вставленный элемент должен быть объектом, кодированным в формате JSON.

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

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

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

 

Заголовок ответа Описание

Content-Length

Длина текста ответа.

Content-Type

Для заголовка задано значение application/json.

Location

URI, представляющий вставленный объект. Этот URI используется в запросе GET для возврата вставленной строки данных.

x-zumo-version

Показывает, какой версией среды выполнения выполнен этот запрос.

JSON-представление вставленного элемента, которое включает идентификатор элемента, сформированного мобильной службой.

Авторизация зависит от описанных ниже требований к разрешениям на доступ для табличной операции.

 

Разрешения на доступ к табличной операции Обязательный заголовок авторизации

Все

Нет

Любой с ключом приложения

X-ZUMO-APPLICATION

Только прошедшие проверку пользователи

X-ZUMO-AUTH

Только скрипты и администраторы

X-ZUMO-MASTER

Разрешение доступа для отдельных табличных операций устанавливаются на портале управления Microsoft Azure. Дополнительные сведения см. в Разрешения.

Следующий пример URI вставляет новый элемент в таблицу TodoItem.

POST https://todolist.azure-mobile.net/tables/TodoItem

Запрос передается со следующими заголовками.

Accept: application/json
X-ZUMO-APPLICATION: UzMAOXRlJdZyqibeUqCMoZZMrUXIRs92
Content-Type: application/json
Host: todolist.azure-mobile.net
Content-Length: 49

Запрос содержит следующий JSON-объект.

{"text":"Complete the tutorial","complete":false}

После отправки запроса возвращается следующий ответ.

HTTP/1.1 201 Created
Content-Type: application/json
x-zumo-version: Zumo.Main.0.1.6.527.Runtime
Date: Thu, 20 Sep 2012 05:59:27 GMT
Content-Length: 57

{"text":"Complete the tutorial","complete":false,"id":18}

Показ:
© 2015 Microsoft