Operation Statuses - Get

Servizio:

Dev Center

Versione API:

2025-02-01

Ottenere lo stato di un'operazione.

GET {endpoint}/projects/{projectName}/operationstatuses/{operationId}?api-version=2025-02-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (uri)	URI specifico di DevCenter su cui operare.
operationId	path	True	string (uuid) minLength: 36 maxLength: 36 pattern: ^[a-zA-Z0-9]{8}-([a-zA-Z0-9]{4}-){3}[a-zA-Z0-9]{12}$	Nome id operazione.
projectName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-zA-Z0-9][a-zA-Z0-9-_.]{2,62}$	Nome del progetto.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	OperationStatus	La richiesta ha avuto esito positivo.
Other Status Codes	Azure.Core.Foundations.ErrorResponse	Risposta di errore imprevista. Intestazioni x-ms-error-code: string

Sicurezza

OAuth2Auth

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
https://devcenter.azure.com/.default

Esempio

Get the status of an operation.

Esempio di richiesta

HTTP

GET {endpoint}/projects/myProject/operationstatuses/fa067167-e49d-41bd-8dd8-de719b9de3b3?api-version=2025-02-01

Risposta di esempio

Codice di stato:

200

{
  "id": "/projects/myProject/operationStatuses/fa067167-e49d-41bd-8dd8-de719b9de3b3",
  "name": "fa067167-e49d-41bd-8dd8-de719b9de3b3",
  "status": "Running",
  "startTime": "2024-01-24T21:14:58.472Z"
}

Definizioni

Nome	Descrizione
Azure.Core.Foundations.Error	Oggetto error.
Azure.Core.Foundations.ErrorResponse	Risposta contenente i dettagli dell'errore.
Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API REST di Azure - https://aka.ms/AzureRestApiGuidelines#handling-errors.
OperationState	Stato di provisioning della risorsa.
OperationStatus	Stato corrente di un'operazione asincrona.

Azure.Core.Foundations.Error

Object

Oggetto error.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
details	Azure.Core.Foundations.Error[]	Matrice di dettagli sugli errori specifici che hanno causato l'errore segnalato.
innererror	Azure.Core.Foundations.InnerError	Oggetto contenente informazioni più specifiche dell'oggetto corrente sull'errore.
message	string	Rappresentazione leggibile dell'errore.
target	string	Destinazione dell'errore.

Azure.Core.Foundations.ErrorResponse

Object

Risposta contenente i dettagli dell'errore.

Nome	Tipo	Descrizione
error	Azure.Core.Foundations.Error	Oggetto error.

Azure.Core.Foundations.InnerError

Object

Oggetto contenente informazioni più specifiche sull'errore. In base alle linee guida dell'API REST di Azure - https://aka.ms/AzureRestApiGuidelines#handling-errors.

Nome	Tipo	Descrizione
code	string	Uno di un set definito dal server di codici di errore.
innererror	Azure.Core.Foundations.InnerError	Errore interno.

OperationState

Enumerazione

Stato di provisioning della risorsa.

Valore	Descrizione
NotStarted	L'operazione non è stata avviata.
Running	L'operazione è in corso.
Succeeded	L'operazione è stata completata correttamente.
Failed	L'operazione non è riuscita.
Canceled	L'operazione è stata annullata dall'utente.

OperationStatus

Object

Stato corrente di un'operazione asincrona.

Nome	Tipo	Descrizione
endTime	string (date-time)	Ora di fine dell'operazione, in formato RFC3339.
error	Azure.Core.Foundations.Error	Messaggio di errore dell'operazione.
id	string	ID completo per lo stato dell'operazione.
name	string (uuid) minLength: 36 maxLength: 36 pattern: ^[a-zA-Z0-9]{8}-([a-zA-Z0-9]{4}-){3}[a-zA-Z0-9]{12}$	Nome id operazione.
percentComplete	number (double) minimum: 0 maximum: 100	Percentuale dell'operazione completata.
properties		Proprietà dell'operazione personalizzata, popolate solo per un'operazione riuscita.
resourceId	string	ID della risorsa.
startTime	string (date-time)	Ora di inizio dell'operazione, in formato RFC3339.
status	OperationState	Stato di provisioning della risorsa.