Özellik Toplu İşlemi Gönder

  • Makale

Bir özellik toplu işlemi gönderir.

Bir grup özellik işlemi gönderir. İşlemlerin tümü veya hiçbiri işlenmez.

İstek

Yöntem İstek URI'si
POST /Names/{nameId}/$/GetProperties/$/SubmitBatch?api-version=6.0&timeout={timeout}

Parametreler

Ad Tür Gerekli Konum
nameId string Yes Yol
api-version string Yes Sorgu
timeout integer (int64) No Sorgu
PropertyBatchDescriptionList PropertyBatchDescriptionList Yes Gövde

nameId

Tür: dize
Gerekli: Evet

'fabric:' URI şeması olmadan Service Fabric adı.

api-version

Tür: dize
Gerekli: Evet
Varsayılan: 6.0

API'nin sürümü. Bu parametre gereklidir ve değeri '6.0' olmalıdır.

Service Fabric REST API sürümü, API'nin tanıtıldığı veya değiştirildiği çalışma zamanı sürümünü temel alır. Service Fabric çalışma zamanı API'nin birden fazla sürümünü destekler. Bu, API'nin desteklenen en son sürümüdür. Daha düşük bir API sürümü geçirilirse, döndürülen yanıt bu belirtimde belgelenen yanıttan farklı olabilir.

Ayrıca çalışma zamanı, çalışma zamanının geçerli sürümüne kadar desteklenen en son sürümden daha yüksek olan tüm sürümleri kabul edin. Bu nedenle, en son API sürümü 6.0 ise ancak çalışma zamanı 6.1 ise, istemcileri yazmayı kolaylaştırmak için çalışma zamanı bu API için sürüm 6.1'i kabul eder. Ancak API'nin davranışı, belgelenen 6.0 sürümüne göre olacaktır.

timeout

Tür: tamsayı (int64)
Gerekli: Hayır
Varsayılan: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

İşlemi saniyeler içinde gerçekleştirmek için sunucu zaman aşımı. Bu zaman aşımı, istemcinin istenen işlemin tamamlanmasını beklemeye istekli olduğu süreyi belirtir. Bu parametre için varsayılan değer 60 saniyedir.

PropertyBatchDescriptionList

Tür: PropertyBatchDescriptionList
Gerekli: Evet

Gönderilecek özellik toplu işlemlerini açıklar.

Yanıtlar

HTTP Durum Kodu Description Yanıt Şeması
200 (Tamam) Başarılı bir yanıt, özellik toplu işleminin başarılı olduğu anlamına gelir.
 SuccessfulPropertyBatchInfo
409 (Çakışma) 409 yanıtı, özellik toplu işlemlerinden birinin başarısız olduğu anlamına gelir ve hata hakkında daha fazla bilgi içerir. İşlemlerin hiçbiri işlenmedi.
 FailedPropertyBatchInfo
Diğer tüm durum kodları Ayrıntılı hata yanıtı.
 Doku Oluşturucu

Örnekler

Özellik toplu işlemi

Bu örnekte, bir özellik toplu işleminin nasıl gönder altında olduğu gösterilmektedir. Bu toplu işlem bir özelliğin var olmasını sağlar, özelliğin beklenen sıra numarasına sahip olup olmadığını denetler ve özelliği yalnızca önceki koşullar başarılı olursa düzenler. Ardından özelliğin geçerli bilgilerini almak için bir alma işlemi gerçekleştirir. Tüm işlemler başarılı olursa, toplu iş işlemsel bir şekilde işlenir ve 200 durum koduyla bir başarı yanıtı döndürülür. Toplu işlem başarısız olursa 409 durum koduyla başarısız bir yanıt döndürülür. Aşağıdaki başarısız yanıt, özelliğin beklenen sıra numarası olmadığından toplu hata gösteriyor.

İstek

POST http://localhost:19080/Names/samples/apps/$/GetProperties/$/SubmitBatch?api-version=6.0
Gövde
{
  "Operations": [
    {
      "Kind": "CheckExists",
      "PropertyName": "PersistentQueueAppData",
      "Exists": 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 Yanıt

Gövde
{
  "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 Yanıtı

Gövde
{
  "Kind": "Failed",
  "ErrorMessage": "FABRIC_E_PROPERTY_CHECK_FAILED",
  "OperationIndex": "1"
}