Megosztás a következőn keresztül:

Frissítési szolgáltatás

Frissítések egy Service Fabric-szolgáltatást a megadott frissítési leírással.

Ez az API lehetővé teszi egy futó Service Fabric-szolgáltatás tulajdonságainak frissítését. A frissíthető tulajdonságok halmaza a szolgáltatás létrehozásakor megadott tulajdonságok részhalmaza. Az aktuális tulajdonságkészlet az API használatával GetServiceDescription szerezhető be. Vegye figyelembe, hogy egy futó szolgáltatás tulajdonságainak frissítése eltér az alkalmazás API-val történő StartApplicationUpgrade frissítésétől. A frissítés egy hosszú ideig futó háttérművelet, amely magában foglalja az alkalmazás egyik verzióról a másikra való áthelyezését, egyszerre egy frissítési tartományt, míg a frissítés azonnal alkalmazza az új tulajdonságokat a szolgáltatásra.

Kérés

Metódus Kérés URI-ja
POST /Services/{serviceId}/$/Update?api-version=6.0&timeout={timeout}

Paraméterek

Név Típus Kötelező Hely
serviceId sztring Igen Elérési út
api-version sztring Igen Lekérdezés
timeout egész szám (int64) No Lekérdezés
ServiceUpdateDescription ServiceUpdateDescription Yes Törzs

serviceId

Típus: sztring
Kötelező: Igen

A szolgáltatás identitása. Ez az azonosító általában a szolgáltatás teljes neve a "fabric:" URI séma nélkül. A 6.0-s verziótól kezdődően a hierarchikus nevek "~" karakterrel vannak elválasztva. Ha például a szolgáltatás neve "fabric:/myapp/app1/svc1", akkor a szolgáltatás identitása a "myapp~app1~svc1" lesz a 6.0-s vagy újabb verziókban, illetve a "myapp/app1/svc1" a korábbi verziókban.

api-version

Típus: sztring
Kötelező: Igen
Alapértelmezett: 6.0

Az API verziója. Ez a paraméter kötelező, értéke pedig "6.0".

A Service Fabric REST API-verziója azon a futtatókörnyezeti verzión alapul, amelyben az API-t bevezették vagy módosították. A Service Fabric-futtatókörnyezet az API több verzióját is támogatja. Ez az API legújabb támogatott verziója. Ha egy alacsonyabb API-verziót ad át, a visszaadott válasz eltérhet az ebben a specifikációban dokumentálttól.

Emellett a futtatókörnyezet minden olyan verziót elfogad, amely magasabb, mint a legújabb támogatott verzió, egészen a futtatókörnyezet aktuális verziójáig. Tehát ha a legújabb API-verzió a 6.0, de ha a futtatókörnyezet 6.1, az ügyfelek írásának megkönnyítése érdekében a futtatókörnyezet elfogadja az API 6.1-es verzióját. Az API viselkedése azonban a dokumentált 6.0-s verziónak megfelelően fog változni.

timeout

Típus: egész szám (int64)
Kötelező: Nem
Alapértelmezett: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

A művelet végrehajtásának kiszolgálói időtúllépése másodpercben. Ez az időtúllépés azt az időtartamot adja meg, amelyet az ügyfél hajlandó megvárni a kért művelet befejezéséig. A paraméter alapértelmezett értéke 60 másodperc.

ServiceUpdateDescription

Típus: ServiceUpdateDescription
Kötelező: Igen

A szolgáltatás frissítéséhez szükséges információk.

Válaszok

HTTP-állapotkód Description Válaszséma
200 (OK) A sikeres művelet a 202-s állapotkódot adja vissza.
Minden más állapotkód A részletes hibaválasz.
 Hálóerror

Példák

Állapot nélküli szolgáltatás

Ez a példa bemutatja, hogyan frissítheti egy állapot nélküli Service Fabric-szolgáltatás elhelyezésével és terheléselosztásával kapcsolatos beállításait.

Kérés

POST http://localhost:19080/Services/test~test1/$/Update?api-version=6.0
Törzs
{
  "ServiceKind": "Stateless",
  "Flags": "1568",
  "PlacementConstraints": "Color==Red",
  "DefaultMoveCost": "High",
  "ScalingPolicies": [
    {
      "ScalingTrigger": {
        "Kind": "AveragePartitionLoad",
        "MetricName": "servicefabric:/_CpuCores",
        "LowerLoadThreshold": "0.500000",
        "UpperLoadThreshold": "0.800000",
        "ScaleIntervalInSeconds": "900"
      },
      "ScalingMechanism": {
        "Kind": "PartitionInstanceCount",
        "MinInstanceCount": "4",
        "MaxInstanceCount": "6",
        "ScaleIncrement": "2"
      }
    }
  ]
}

200 Válasz

Törzs

A választörzs üres.

Állapotalapú szolgáltatás

Ez a példa bemutatja, hogyan frissítheti egy állapotalapú Service Fabric-szolgáltatás elhelyezésével és terheléselosztásával kapcsolatos beállításait.

Kérés

POST http://localhost:19080/Services/test~test2/$/Update?api-version=6.0
Törzs
{
  "ServiceKind": "Stateful",
  "Flags": "40",
  "PlacementConstraints": "Color==Green",
  "StandByReplicaKeepDurationSeconds": "1000"
}

200 Válasz

Törzs

A választörzs üres.