Exportar (0) Imprimir
Expandir todo

Insertar operación de registro

Actualizado: junio de 2013

Inserta un nuevo elemento en una tabla.

La solicitud se puede especificar de la manera siguiente. Reemplace <service_name> por el nombre del servicio móvil y <table_name> por el nombre de la tabla a la que se va a acceder.

 

Verbo de HTTP URI de solicitud Versión de HTTP

POST

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

HTTP/1.1

 

Parámetro URI Obligatorio Descripción

noscript

No

Cuando se proporciona un valor de true, se suprime la ejecución de scripts registrados. Para suprimir la ejecución de script, también debe proporcionar la clave maestra de servicio en el encabezado X-ZUMO-MASTER.

La tabla siguiente describe los encabezados de solicitud.

 

Encabezado de solicitud Obligatorio  

Accept

No

Establezca este encabezado en application/json.

Content-Length

La longitud del cuerpo de la solicitud.

Content-Type

No

Establezca este encabezado en application/json.

X-ZUMO-APPLICATION

Conditional

Clave de la aplicación del servicio móvil. Debe especificar una clave de aplicación válida cuando sea necesario para tener acceso a la operación de tabla. Este es el permiso de acceso a la operación de tabla predeterminado.

X-ZUMO-AUTH

Conditional

El token de autenticación generado por el servicio para un usuario autenticado. Debe especificar un token para un usuario autenticado cuando sea necesario para tener acceso a la operación de tabla.

X-ZUMO-MASTER

Conditional

Clave maestra del servicio. Debe incluir solo esta clave cuando el acceso de administrador sea necesario para tener acceso a la operación de tabla.

securityNota de seguridad
La clave maestra de servicio es una credencial crítica de seguridad que proporciona acceso de administrador al servicio de datos. No comparta este secreto con nadie ni lo distribuya con la aplicación. Esta clave debe distribuirse siempre con seguridad a través de un canal cifrado.

El elemento insertado debe ser un objeto codificado en formato de notación de objeto JavaScript (JSON).

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.

Una operación correcta devuelve el código de estado 201 (Creado).

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1.

 

Encabezado de respuesta Descripción

Content-Length

Longitud del cuerpo de la solicitud.

Content-Type

Encabezado establecido en application/json.

Location

URI que representa al objeto insertado. Esta URI se utiliza en una solicitud GET para devolver la fila de datos insertada.

x-zumo-version

Indica la versión del tiempo en ejecución en que se ejecutó la solicitud.

Representación JSON del elemento insertado, que incluye el identificador del elemento generado por el servicio móvil.

La autorización depende de los requisitos de permisos de acceso para la operación de tabla, que se resumen de la manera siguiente:

 

Permiso de acceso de operaciones de tabla Encabezado de autorización obligatorio

Todos

Ninguno

Cualquiera con la clave de aplicación

X-ZUMO-APPLICATION

Solo usuarios autenticados

X-ZUMO-AUTH

Solo scripts y administradores

X-ZUMO-MASTER

Los permisos de acceso para operaciones de tablas individuales se establecen en el Portal de administración de Windows Azure. Para obtener más información, vea Permisos.

La URI de ejemplo siguiente inserta un nuevo elemento en la tabla TodoItem.

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

La solicitud se envía con los encabezados siguientes.

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

La solicitud se envía con el objeto JSON siguiente en el cuerpo.

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

Una vez enviada la solicitud, se devuelve la respuesta siguiente.

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}

Mostrar:
© 2014 Microsoft