Operazione

Articolo
08/05/2023

Rappresenta lo stato corrente di un'operazione di lunga esecuzione. Esempi di operazioni di lunga esecuzione includono l'avvio, l'arresto e l'eliminazione di un'entità Origin.

Questo argomento presenta informazioni generali sull'entità Operation e mostra come eseguire varie operazioni con l'API REST di Servizi multimediali.

Proprietà dell'entità operation
Operazioni di query
Codici di errore delle operazioni

Importante

Quando si accede alle entità in Servizi multimediali, è necessario impostare valori e campi di intestazione specifici nelle richieste HTTP.
Per altre informazioni, vedere Configurare lo sviluppo di API REST di Servizi multimediali e connettersi a Servizi multimediali con l'API REST di Servizi multimediali.

Proprietà dell'entità Operation

`Property`	Tipo	Descrizione
`Id` Sola lettura.	string	ID operazione, assegnato da Servizi multimediali alla creazione di un'operazione. Il formato è: `nb:opid:UUID:<GUID>`.
`ErrorCode` Sola lettura.	string	Codice di errore dell'operazione non riuscita. Per informazioni sui possibili codici di errore, vedere Codici di errore dell'operazione.
`ErrorMessage` Sola lettura.	string	Messaggio di errore dettagliato dell'operazione non riuscita.
`State` Sola lettura.	string	Stato corrente. I valori possibili sono: - Completato - Non riuscito - InProgress
`TargetEntityId` Sola lettura.	string	Id della destinazione dell'azione.

Operazioni di query

Esegue una query sull'operazione specificata.

Metodo	URI richiesta	Versione HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Operations>('OperationId')	HTTP/1.1

Richiesta di esempio

Per ottenere la versione più recente x-ms-version:, vedere Servizi multimediali REST.

GET api/Operations('nb:opid:UUID:ab66eff9-8945-4323-9f91-d257a695899b') HTTP/1.1  
MaxDataServiceVersion: 3.0;NetFx  
Content-Type: application/json;odata=minimalmetadata  
Accept: application/json;odata=minimalmetadata  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
Host: <host URI>  
Content-Length: 0

Se l'esito è positivo, nel corpo della risposta viene restituito un codice di stato 200 OK insieme al messaggio di stato, come illustrato nel seguente esempio.

Risposta di esempio

HTTP/1.1 200 OK  
Cache-Control: no-cache  
Content-Length: 280  
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8  
Server: Microsoft-IIS/7.5  
request-id: c3f3501a-8563-4cff-8aeb-66f68f9bdb8b  
x-ms-request-id: c3f3501a-8563-4cff-8aeb-66f68f9bdb8b  
X-Content-Type-Options: nosniff  
DataServiceVersion: 3.0;  
X-Powered-By: ASP.NET  
Date: Wed, 15 Jan 2014 19:31:13 GMT  
  
{"odata.metadata":"https://wamsbayclus001rest-hs.cloudapp.net/api/$metadata#Operations/@Element","Id":"nb:opid:UUID:ab66eff9-8945-4323-9f91-d257a695899b","State":"Succeeded","TargetEntityId":"nb:chid:UUID:1e518dbc-91ef-4044-a8bd-d20769dae833","ErrorCode":null,"ErrorMessage":null}

Codici di errore delle operazioni

Di seguito sono elencati i codici di errore delle operazioni.

Codice di errore	Descrizione
BadRequest	Viene inviato quando non è applicabile alcun altro errore oppure l'errore esatto è sconosciuto.
InsufficientCapacity	Il data center non dispone di capacità sufficiente.
InternalError	Si sono verificati errori imprevisti nel servizio.
InvalidIdentifierFormat	Il formato dell'Id entità non è valido.
InvalidOperation	La richiesta non è valida nello stato corrente dell'entità.
InvalidResourceName	Il nome specificato per l'entità Origin non è valido.
OperationInProgress	Nell'entità specificata è in già in corso un'altra operazione.
OperationNotFound	Il record dell'operazione non viene trovato per l'ID operazione specificato. L'operazione potrebbe essere stata rimossa dopo un intervallo di tempo o l'ID non è corretto.
ResourceNameTaken	Si è tentato di creare una nuova entità Origin con un nome già in uso.
ResourceNotFound	La risorsa specificata non è stata trovata.
ExceededResourceQuota	La richiesta supera il limite di quota della risorsa.
Timeout	L'operazione asincrona è scaduta.
DeleteNotAllowedOnDefaultOrigin	Si è tentato di eliminare l'entità Origin denominata Default.
SettingsUpdateInProgress	È già in corso un aggiornamento.

Condividi tramite