Exporter (0) Imprimer
Développer tout
Ce sujet n'a pas encore été évalué - Évaluez ce sujet

Opération de mise à jour d'enregistrement

Mis à jour: septembre 2012

Met à jour un élément existant dans une table.

La demande peut être spécifiée comme suit. Remplacez <service_name> par le nom du service mobile, <table_name> par le nom de la table à laquelle accéder, et <item_id> par l'ID de l'élément à mettre à jour.

 

Verbe HTTP URI de demande Version HTTP

PATCH

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

HTTP/1.1

Paramètres URI

 

Paramètre d'URI Ce paramètre est obligatoire Description

noscript

Non

Lorsqu'une valeur true est fournie, l'exécution des scripts inscrits est supprimée. Pour supprimer l'exécution de scripts, vous devez également fournir la clé principale du service dans l'en-tête X-ZUMO-MASTER.

En-têtes de demande

Le tableau suivant décrit les en-têtes de la demande.

 

En-tête de demande Ce paramètre est obligatoire  

Accept

Non

Définissez cet en-tête avec application/json.

Content-Length

Oui

Longueur du corps de la demande.

Content-Type

Non

Définissez cet en-tête avec application/json.

X-ZUMO-APPLICATION

Opérateurs conditionnels

Clé de l'application du service mobile. Vous devez spécifier une clé d'application valide, si requise pour accéder à l'opération de table. Il s'agit de l'autorisation d'accès par défaut à l'opération de table.

X-ZUMO-AUTH

Opérateurs conditionnels

Jeton d'authentification généré par le service pour un utilisateur authentifié. Vous devez spécifier le jeton d'un utilisateur authentifié, si requis pour accéder à l'opération de table.

X-ZUMO-MASTER

Opérateurs conditionnels

Clé principale du service. Vous devez inclure cette clé uniquement lorsque l'accès administrateur est requis pour accéder à l'opération de table.

securitySécurité Remarque
La clé principale du service est une information d'identification de sécurité essentielle qui fournit un accès administrateur à votre service de données. Ne la partagez pas avec d'autres personnes et ne la distribuez pas avec votre application. Cette clé doit toujours être distribuée de façon sécurisée sur un canal chiffré.

Corps de la demande

Valeurs mises à jour codée au format JSON (JavaScript Object Notation), ainsi que la valeur facultative id de l'objet.

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse.

Code d'état

Une opération ayant réussi retourne le code d'état 200 (OK).

En-têtes de réponse

La réponse de l'opération inclut les en-têtes suivants. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.

 

En-tête de réponse Description

Content-Length

Longueur du corps de la réponse.

Content-Type

En-tête défini sur application/json.

x-zumo-version

Indique quelle version du runtime a exécuté la demande.

Corps de la réponse

Représentation JSON de l'élément mise à jour.

L'autorisation dépend des spécifications d'autorisation d'accès pour l'opération de table, qui sont résumées comme suit :

 

Autorisation d'accès à l'opération de table En-tête d'autorisation requis

Tout le monde

Aucun

Toute personne avec la clé d'application

X-ZUMO-APPLICATION

Seuls les utilisateurs authentifiés

X-ZUMO-AUTH

Seuls les scripts et les administrateurs

X-ZUMO-MASTER

Les autorisations d'accès pour chaque opération de table sont définies dans le portail de gestion Windows Azure. Pour plus d'informations, consultez Autorisations.

L'exemple d'URI suivant met à jour un élément existant dans la table TodoItem.

PATCH https://todolist.azure-mobile.net/tables/TodoItem/18

La demande est envoyée avec les en-têtes suivants.

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

La demande est envoyée avec l'objet JSON suivant dans le corps :

{"complete":true}

Une fois la demande envoyée, la réponse suivante est retournée.

HTTP/1.1 200 OK
Content-Type: application/json
x-zumo-version: Zumo.Main.0.1.6.527.Runtime
Date: Thu, 20 Sep 2012 15:49:06 GMT
Content-Length: 56

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

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft. Tous droits réservés.