Soumettre le lot de propriété

Soumet un lot de propriété.

Soumet un lot d’opérations immobilières. Soit toutes les opérations ou aucune ne seront engagées.

Requête

Méthode URI de demande
POST /Names/{nameId}/$/GetProperties/$/SubmitBatch?api-version=6.0&timeout={timeout}

Paramètres

Nom Type Obligatoire Emplacement
nameId string Oui Path
api-version string Oui Requête
timeout integer (int64) Non Requête
PropertyBatchDescriptionList PropertyBatchDescriptionList Oui body

nameId

Type: chaîne
Requis: Oui

Le nom De tissu de service, sans le «tissu:» régime URI.


api-version

Type: chaîne
Requis: Oui
Défaut:6.0

Version de l’API. Ce paramètre est nécessaire et sa valeur doit être de 6,0.

Service Fabric REST version API est basé sur la version de durée d’exécution dans laquelle l’API a été introduit ou a été changé. Service Fabric runtime prend en charge plus d’une version de l’API. Il s’agit de la dernière version prise en charge de l’API. Si une version API inférieure est adoptée, la réponse retournée peut être différente de celle documentée dans cette spécification.

En outre, le temps d’exécution accepter toute version qui est supérieure à la dernière version prise en charge jusqu’à la version actuelle de l’exécution. Donc, si la dernière version API est 6.0, mais si le temps d’exécution est de 6.1, afin de le rendre plus facile d’écrire les clients, le temps d’exécution acceptera la version 6.1 pour cette API. Cependant, le comportement de l’API sera selon la version 6.0 documentée.


timeout

Type: intégré (int64)
Requis: Non
Défaut:60
InclusiveMaximum:4294967295
InclusiveMinimum:1

Délai d’attente du serveur pour l’exécution de l’opération en secondes. Il spécifie la durée pendant laquelle le client attend la fin de l’opération demandée. La valeur par défaut de ce paramètre est de 60 secondes.


PropertyBatchDescriptionList

Type: PropertyBatchDescriptionList
Requis: Oui

Décrit les opérations de lot de propriété à soumettre.

Réponses

Code d’état HTTP Description Schéma de réponse
200 (OK) Une réponse réussie signifie que le lot de propriété a réussi.
SuccessfulPropertyBatchInfo
409 (Conflit) Une réponse 409 signifie que l’une des opérations de lot de propriété a échoué, et contient plus d’informations sur la défaillance. Aucune des opérations n’a été commise.
FailedPropertyBatchInfo
Tous les autres codes de statut La réponse détaillée d’erreur.
FabricError (en)

Exemples

Opération de lot de propriété

Cet exemple montre comment soumettre un lot de propriété. Ce lot garantit qu’une propriété existe, vérifie que la propriété a le numéro de séquence prévu, et modifie la propriété seulement si les conditions précédentes réussissent. Il effectue ensuite une opération get pour obtenir les informations actuelles de la propriété. Si toutes les opérations réussissent, le lot est engagé d’une manière transactionnelle et une réponse de réussite est retournée avec 200 code d’état. Si le lot échoue, une réponse a échoué est retournée avec 409 code d’état. La réponse ratée ci-dessous montre la défaillance du lot parce que la propriété n’a pas prévu le numéro de séquence.

Requête

POST http://localhost:19080/Names/samples/apps/$/GetProperties/$/SubmitBatch?api-version=6.0
body
{
  "Operations": [
    {
      "Kind": "CheckExists",
      "PropertyName": "PersistentQueueAppData",
      "Exits": true
    },
    {
      "Kind": "CheckSequence",
      "PropertyName": "PersistentQueueAppData",
      "SequenceNumber": "12"
    },
    {
      "Kind": "Put",
      "PropertyName": "PersistentQueueAppData",
      "Value": {
        "Kind": "Binary",
        "Data": [
          "1",
          "2",
          "3",
          "4",
          "5"
        ]
      },
      "CustomTypeId": "InitializationData"
    },
    {
      "Kind": "Get",
      "PropertyName": "PersistentQueueAppData",
      "IncludeValue": false
    }
  ]
}

200 Réponse

body
{
  "Kind": "Successful",
  "Properties": {
    "3": {
      "Name": "PersistentQueueAppData",
      "Metadata": {
        "TypeId": "Binary",
        "CustomTypeId": "InitializationData",
        "Parent": "fabric:/samples/apps",
        "SizeInBytes": "5",
        "LastModifiedUtcTimestamp": "2017-07-17T05:01:19.049Z",
        "SequenceNumber": "13"
      }
    }
  }
}

409 Réponse

body
{
  "Kind": "Failed",
  "ErrorMessage": "FABRIC_E_PROPERTY_CHECK_FAILED",
  "OperationIndex": "1"
}