Snapshot - Get Operation Status
Uzyskaj stan długotrwałej operacji.
GET {Endpoint}/face/v1.0-preview/operations/{operationId}
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
Endpoint
|
path | True |
string |
Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://westus.api.cognitive.microsoft.com). |
operation
|
path | True |
string uuid |
Identyfikator odwołujący się do określonej operacji tworzenia/stosowania migawki. |
Nagłówek żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
Ocp-Apim-Subscription-Key | True |
string |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Pomyślne wywołanie zwraca stan operacji. |
|
Other Status Codes |
Odpowiedź na błąd. |
Zabezpieczenia
Ocp-Apim-Subscription-Key
Typ:
apiKey
W:
header
Przykłady
Get snapshot operation status example
Przykładowe żądanie
GET {Endpoint}/face/v1.0-preview/operations/a63a3bdd-a1db-4d05-87b8-dbad6850062a
Przykładowa odpowiedź
{
"status": "succeeded",
"createdTime": "2018-12-25T11:41:02.2331413Z",
"lastActionTime": "2018-12-25T11:51:27.8705696Z",
"resourceLocation": "/snapshots/e58b3f08-1e8b-4165-81df-aa9858f233dc",
"message": null
}
Definicje
Nazwa | Opis |
---|---|
APIError |
Informacje o błędzie zwrócone przez interfejs API |
Error |
Treść błędu. |
Operation |
Obiekt stanu operacji. Operacja odnosi się do asynchronicznego zadania zaplecza. |
Operation |
Stan operacji: niestarted, uruchomione, zakończone pomyślnie, zakończone niepowodzeniem. Jeśli operacja jest żądana i oczekuje na wykonanie, stan nie zostanie uruchomiony. Jeśli operacja trwa w zapleczu, stan jest uruchomiony. Stan powodzenia oznacza, że operacja została ukończona pomyślnie, w szczególności w przypadku operacji tworzenia migawki, ilustruje, że migawka jest dobrze wykonana i gotowa do zastosowania, a w przypadku operacji stosowania migawki przedstawia obiekt docelowy został ukończony przez migawkę i jest gotowy do użycia. Stan nie powiódł się często przez edytowanie obiektu źródłowego podczas wykonywania migawki lub edytowania obiektu docelowego podczas stosowania migawki przed ukończeniem, zobacz pole "message", aby sprawdzić przyczynę niepowodzenia. |
APIError
Informacje o błędzie zwrócone przez interfejs API
Nazwa | Typ | Opis |
---|---|---|
error |
Treść błędu. |
Error
Treść błędu.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
|
message |
string |
OperationStatus
Obiekt stanu operacji. Operacja odnosi się do asynchronicznego zadania zaplecza.
Nazwa | Typ | Opis |
---|---|---|
createdTime |
string |
Połączony ciąg daty i godziny UTC, który opisuje godzinę żądania operacji. Np. 2018-12-25T11:41:02.2331413Z. |
finishedTime |
string |
Połączony ciąg daty i godziny UTC, który opisuje godzinę zakończenia operacji. Np. 2018-12-25T11:41:02.2331413Z. |
lastActionTime |
string |
Połączony ciąg daty i godziny UTC, który opisuje czas ostatniej operacji jest aktywnie uruchamiany. Funkcja lastActionTime będzie stale zwiększana do momentu zakończenia operacji. Np. 2018-12-25T11:51:27.8705696Z. |
message |
string |
Pokaż komunikat o niepowodzeniu, gdy operacja zakończy się niepowodzeniem (pominięto, gdy operacja zakończy się pomyślnie). |
resourceLocation |
string |
Po pomyślnym pomyślnym zakończeniu operacji tworzenia migawki identyfikator migawki zostanie uwzględniony w tym polu, a w przypadku operacji stosowania migawki ścieżka do pobrania obiektu docelowego zostanie zwrócona w tym polu. |
status |
Stan operacji: niestarted, uruchomione, zakończone pomyślnie, zakończone niepowodzeniem. Jeśli operacja jest żądana i oczekuje na wykonanie, stan nie zostanie uruchomiony. Jeśli operacja trwa w zapleczu, stan jest uruchomiony. Stan powodzenia oznacza, że operacja została ukończona pomyślnie, w szczególności w przypadku operacji tworzenia migawki, ilustruje, że migawka jest dobrze wykonana i gotowa do zastosowania, a w przypadku operacji stosowania migawki przedstawia obiekt docelowy został ukończony przez migawkę i jest gotowy do użycia. Stan nie powiódł się często przez edytowanie obiektu źródłowego podczas wykonywania migawki lub edytowania obiektu docelowego podczas stosowania migawki przed ukończeniem, zobacz pole "message", aby sprawdzić przyczynę niepowodzenia. |
OperationStatusType
Stan operacji: niestarted, uruchomione, zakończone pomyślnie, zakończone niepowodzeniem. Jeśli operacja jest żądana i oczekuje na wykonanie, stan nie zostanie uruchomiony. Jeśli operacja trwa w zapleczu, stan jest uruchomiony. Stan powodzenia oznacza, że operacja została ukończona pomyślnie, w szczególności w przypadku operacji tworzenia migawki, ilustruje, że migawka jest dobrze wykonana i gotowa do zastosowania, a w przypadku operacji stosowania migawki przedstawia obiekt docelowy został ukończony przez migawkę i jest gotowy do użycia. Stan nie powiódł się często przez edytowanie obiektu źródłowego podczas wykonywania migawki lub edytowania obiektu docelowego podczas stosowania migawki przed ukończeniem, zobacz pole "message", aby sprawdzić przyczynę niepowodzenia.
Nazwa | Typ | Opis |
---|---|---|
failed |
string |
|
notStarted |
string |
|
running |
string |
|
succeeded |
string |