Adatvesztési folyamat beolvasásaGet Data Loss Progress

A StartDataLoss API használatával elindított partíciós adatvesztési művelet előrehaladásának beolvasása.Gets the progress of a partition data loss operation started using the StartDataLoss API.

Lekérdezi a StartDataLoss-vel elindított adatvesztési művelet állapotát a OperationId használatával.Gets the progress of a data loss operation started with StartDataLoss, using the OperationId.

KérésRequest

MódszerMethod Kérés URI-jaRequest URI
GETGET /Faults/Services/{serviceId}/$/GetPartitions/{partitionId}/$/GetDataLossProgress?api-version=6.0&OperationId={OperationId}&timeout={timeout}

ParaméterekParameters

Name (Név)Name TípusType KötelezőRequired HelyLocation
serviceId sztringstring IgenYes ÚtvonalPath
partitionId karakterlánc (UUID)string (uuid) IgenYes ÚtvonalPath
api-version sztringstring IgenYes LekérdezésQuery
OperationId karakterlánc (UUID)string (uuid) IgenYes LekérdezésQuery
timeout egész szám (Int64)integer (int64) NemNo LekérdezésQuery

serviceId

Típus: karakterláncType: string
Kötelező: igenRequired: Yes

A szolgáltatás identitása.The identity of the service. Ez az azonosító általában a szolgáltatás teljes neve a "Fabric:" URI-séma nélkül.This ID is typically the full name of the service without the 'fabric:' URI scheme. Az 6,0-es verziótól kezdődően a hierarchikus nevek a "~" karakterrel vannak tagolva.Starting from version 6.0, hierarchical names are delimited with the "~" character. Ha például a szolgáltatás neve "Fabric:/SajátPr/App1/svc1", a szolgáltatás identitása a korábbi verziókban a következő: "SajátPr ~ App1 ~ svc1", 6.0 + és "SajátPr/App1/svc1".For example, if the service name is "fabric:/myapp/app1/svc1", the service identity would be "myapp~app1~svc1" in 6.0+ and "myapp/app1/svc1" in previous versions.


partitionId

Típus: karakterlánc (UUID)Type: string (uuid)
Kötelező: igenRequired: Yes

A partíció identitása.The identity of the partition.


api-version

Típus: karakterláncType: string
Kötelező: igenRequired: Yes
Alapértelmezett:6.0Default: 6.0

Az API verziója.The version of the API. Ezt a paramétert kötelező megadni, és az értéke csak "6,0" lehet.This parameter is required and its value must be '6.0'.

A Service Fabric REST API verziója azon futtatókörnyezet-verzión alapul, amelyben az API-t bevezették vagy módosították.Service Fabric REST API version is based on the runtime version in which the API was introduced or was changed. Service Fabric futtatókörnyezet az API több verzióját is támogatja.Service Fabric runtime supports more than one version of the API. Ez az API legújabb támogatott verziója.This is the latest supported version of the API. Ha a rendszer alacsonyabb API-verziót ad át, a visszaadott válasz különbözhet az ebben a specifikációban dokumentált értéktől.If a lower API version is passed, the returned response may be different from the one documented in this specification.

Emellett a futtatókörnyezet minden olyan verziót elfogad, amely a legújabb támogatott verziónál magasabb, mint a futtatókörnyezet aktuális verziója.Additionally the runtime accept any version that is higher than the latest supported version up to the current version of the runtime. Tehát ha a legújabb API-verzió a 6,0-as, de ha a futtatókörnyezet 6,1, az ügyfelek írásához a futtatókörnyezet az adott API-hoz tartozó 6,1-as verziót fogja elfogadni.So if the latest API version is 6.0, but if the runtime is 6.1, in order to make it easier to write the clients, the runtime will accept version 6.1 for that API. Az API viselkedése azonban a dokumentált 6,0-es verziónak megfelelően fog történni.However the behavior of the API will be as per the documented 6.0 version.


OperationId

Típus: karakterlánc (UUID)Type: string (uuid)
Kötelező: igenRequired: Yes

Az API hívását azonosító GUID.A GUID that identifies a call of this API. Ezt a rendszer átadja a megfelelő GetProgress API-nakThis is passed into the corresponding GetProgress API


timeout

Típus: egész szám (Int64)Type: integer (int64)
Kötelező: nemRequired: No
Alapértelmezett:60Default: 60
InclusiveMaximum:4294967295InclusiveMaximum: 4294967295
InclusiveMinimum:1InclusiveMinimum: 1

A kiszolgáló időtúllépése másodpercben a művelet végrehajtására.The server timeout for performing the operation in seconds. Ez az időkorlát azt az időtartamot adja meg, ameddig az ügyfélnek várnia kell, amíg a kért művelet befejeződik.This timeout specifies the time duration that the client is willing to wait for the requested operation to complete. A paraméter alapértelmezett értéke 60 másodperc.The default value for this parameter is 60 seconds.

VálaszokResponses

HTTP-állapotkódHTTP Status Code LeírásDescription VálaszsémaResponse Schema
200 (OK)200 (OK) A partíció adatvesztési műveletének előrehaladásával kapcsolatos információk.Information about the progress of the partition data loss operation.
PartitionDataLossProgressPartitionDataLossProgress
Minden egyéb állapotkódAll other status codes A hiba részletes válasza.The detailed error response.
FabricErrorFabricError

PéldákExamples

Információt kér a partíciós adatvesztési műveletről.Gets information about a partition data loss operation. Ebben az esetben a művelet befejezve állapottal rendelkezik.In this case the operation has a State of Completed

Ez a lehetséges kimenetre mutat példát, amikor a GetDataLossProgress elérte a befejezett állapotot.This shows an example of possible output when GetDataLossProgress has reached a State of Completed. Ha az állapot egy futó értékkel rendelkezik, csak az állapot mező értéke lesz.If the State has a value of Running, only the State field will have a value.

KérésRequest

GET http://localhost:19080/Faults/Services/fabric:/myapp/myservice/$/GetPartitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/GetDataLossProgress?api-version=6.0&OperationId=7216486c-1ee9-4b00-99b2-92b26fcb07f5

200 válasz200 Response

TörzsBody
{
  "State": "Completed",
  "InvokeDataLossResult": {
    "ErrorCode": "0",
    "SelectedPartition": {
      "ServiceName": "fabric:/myapp/myservice",
      "PartitionId": "1daae3f5-7fd6-42e9-b1ba-8c05f873994d"
    }
  }
}

Adatok lekérése a partíciós adatvesztési műveletről.Get information about a partition data loss operation. Ebben az esetben a művelet a Futtatás állapotaIn this case the operation is a State of Running

Itt látható egy példa a kimenetre, ha egy adatvesztési művelet futó állapotban van.This shows an example of output when a data loss operation is in a Running State. Ha az állapot egy futó értékkel rendelkezik, csak az állapot mező értéke lesz.If the State has a value of Running, only the State field will have a value.

KérésRequest

GET http://localhost:19080/Faults/Services/fabric:/myapp/myservice/$/GetPartitions/1daae3f5-7fd6-42e9-b1ba-8c05f873994d/$/GetDataLossProgress?api-version=6.0&OperationId=7216486c-1ee9-4b00-99b2-92b26fcb07f5

200 válasz200 Response

TörzsBody
{
  "State": "Running"
}