VENDITE: 1-800-867-1389

Operazione di inserimento record

Aggiornamento: giugno 2015

Inserisce una nuova voce in una tabella.

La richiesta può essere specificata come indicato di seguito. Sostituire <service_name> con il nome del servizio mobile e <table_name> con il nome della tabella a cui accedere.

 

Verbo HTTP URI richiesta Versione HTTP

POST

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

HTTP/1.1

 

Parametro URI Obbligatorio Descrizione

noscript

No 

Quando si specifica un valore true, l'esecuzione di script registrati viene eliminata. Per eliminare l'esecuzione di script, è inoltre necessario specificare la chiave master del servizio nell'intestazione X-ZUMO-MASTER.

La tabella seguente descrive le intestazioni delle richieste.

 

Intestazione della richiesta Obbligatorio  

Accept

No 

Impostare questa intestazione su application/json.

Content-Length

Lunghezza del corpo della richiesta.

Content-Type

Impostare questa intestazione su application/json.

X-ZUMO-APPLICATION

Condizionale

Chiave dell'applicazione per il servizio mobile. È necessario specificare una chiave applicazione valida se necessaria per accedere all'operazione di tabella. Si tratta dell'autorizzazione di accesso predefinita dell'operazione di tabella.

X-ZUMO-AUTH

Condizionale

Token di autenticazione generato dal servizio per un utente autenticato. È necessario specificare un token per un utente autenticato se necessario per accedere all'operazione di tabella.

X-ZUMO-MASTER

Condizionale

Chiave master del servizio. È necessario includere questa chiave solo se l'accesso con diritti di amministratore è necessario per accedere all'operazione di tabella.

securitySicurezza - Nota
La chiave master del servizio è una credenziale di sicurezza critica che garantisce l'accesso come amministratore al servizio dati. Non condividerla con nessuno o non distribuirla nell'applicazione. Questa chiave deve essere distribuita sempre in modo sicuro su un canale crittografato.

La voce inserita deve essere un oggetto codificato in formato JSON (JavaScript Object Notation).

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Se un'operazione viene completata correttamente, viene restituito il codice di stato 201 (creazione completata).

La risposta per questa operazione include le intestazioni riportate di seguito; inoltre, possono essere incluse intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

 

Intestazione della risposta Descrizione

Content-Length

Lunghezza del corpo della risposta.

Content-Type

Intestazione impostata su application/json.

Location

URI che rappresenta l'oggetto inserito. Questo URI viene usato in una richiesta GET per restituire la riga di dati inserita.

x-zumo-version

Indica la versione del runtime che ha eseguito la richiesta.

La rappresentazione JSON della voce inserita, la quale include l'ID della voce generata dal servizio mobile.

L'autorizzazione dipende dai requisiti delle autorizzazioni di accesso per l'operazione di tabella, i quali possono essere riepilogati come segue:

 

Autorizzazione di accesso per l'operazione di tabella. Intestazione di autorizzazione necessaria

Tutti

Nessuno

Chiunque con la chiave applicazione

X-ZUMO-APPLICATION

Solo gli utenti autenticati

X-ZUMO-AUTH

Solo script e amministratori

X-ZUMO-MASTER

Le autorizzazioni di accesso per le singole operazioni di tabella vengono impostate nel portale di gestione di Microsoft Azure. Per altre informazioni, vedere Autorizzazioni.

L'URI di esempio seguente inserisce una nuova voce nella tabella TodoItem.

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

La richiesta viene inviata con le intestazioni seguenti.

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

La richiesta viene inviata con l'oggetto JSON seguente nel corpo.

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

Dopo l'invio della richiesta, viene restituita la risposta seguente.

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}

Il documento è risultato utile?
(1500 caratteri rimanenti)
Grazie per i commenti inviati.
Mostra:
© 2015 Microsoft