Recuperare le operazioni
Nota
Le API del portale Cloud Partner sono integrate con e continueranno a lavorare nel Centro per i partner. La transizione introduce piccole modifiche. Esaminare le modifiche elencate in Informazioni di riferimento sull'API del portale Cloud Partner per assicurarsi che il codice continui a funzionare dopo la transizione al Centro per i partner. Le API CPP devono essere usate solo per i prodotti esistenti già integrati prima della transizione al Centro per i partner; i nuovi prodotti devono usare le API di invio al Centro per i partner.
Recupera tutte le operazioni relative all'offerta o per ottenere una particolare operazione per l'operationId specificato. Il client può usare parametri di query per filtrare le operazioni in esecuzione.
GET https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>/operations/<operationId>?api-version=2017-10-31
Parametri URI
| Nome | Descrizione | Tipo di dati |
|---|---|---|
| publisherId | Identificatore dell'editore, per esempio Contoso |
String |
| offerId | Identificatore dell'offerta | String |
| operationId | GUID che identifica in modo univoco l'operazione sull'offerta. OperationId potrebbe essere recuperato usando questa API e viene restituito anche nell'intestazione HTTP della risposta per qualsiasi operazione a esecuzione prolungata, ad esempio l'API Pubblica offerta . | GUID |
| api-version | Ultima versione dell'API | Data |
Intestazione
| Nome | valore |
|---|---|
| Content-Type | application/json |
| Autorizzazione | Bearer YOUR_TOKEN |
Esempio di corpo
Response
Operazioni GET
[
{
"id": "5a63deb5-925b-4ee0-938b-7c86fbf287c5",
"offerId": "56615b67-2185-49fe-80d2-c4ddf77bb2e8",
"offerVersion": 1,
"offerTypeId": "microsoft-azure-virtualmachines",
"publisherId": "contoso",
"submissionType": "publish",
"submissionState": "running",
"publishingVersion": 2,
"slot": "staging",
"version": 636576975611768314,
"definition": {
"metadata": {
"emails": "jdoe@contoso.com"
}
},
"changedTime": "2018-03-26T21:46:01.179948Z"
}
]
Operazione GET
[
{
"status" : "running",
"messages" : [],
"publishingVersion" : 2,
"offerVersion" : 1,
"cancellationRequestState": "canCancel",
"steps": [
{
"estimatedTimeFrame": "< 15 min",
"id": "displaydummycertify",
"stepName": "Validate Pre-Requisites",
"description": "Offer settings provided are validated",
"status": "complete",
"messages":
[
{
"messageHtml": "Step completed.",
"level": "information",
"timestamp": "2017-03-28T19:50:36.500052Z"
}
],
"progressPercentage": 100
},
{
"estimatedTimeFrame": "< 5 day",
"id": "displaycertify",
"stepName": "Certification",
"description": "Your offer is analyzed by our certification systems for issues.",
"status": "blocked",
"messages":
[
{
"messageHtml": "No virtual machine image was found for the plan contoso.",
"level": "error",
"timestamp": "2017-03-28T19:50:39.5506018Z"
},
{
"messageHtml": "This step has not started yet.",
"level": "information",
"timestamp": "2017-03-28T19:50:39.5506018Z"
}
],
"progressPercentage": 0
},
{
"estimatedTimeFrame": "< 1 day",
"id": "displayprovision",
"stepName": "Provisioning",
"description": "Your virtual machine is being replicated in our production systems.",
"status": "notStarted",
"messages": [],
"progressPercentage": 0
},
{
"estimatedTimeFrame": "< 1 hour",
"id": "displaypackage",
"stepName": "Packaging and Lead Generation Registration",
"description": "Your virtual machine is packaged for being shown to your customers. Additionally, we hookup our lead generation systems to send leads for your offer.",
"status": "notStarted",
"messages": [],
"progressPercentage": 0
},
{
"id": "publisher-signoff",
"stepName": "Publisher signoff",
"description": "Offer is available to preview. Ensure that everything looks good before making your offer live.",
"status": "notStarted",
"messages": [],
"progressPercentage": 0
},
{
"estimatedTimeFrame": "~2-5 days",
"id": "live",
"stepName": "Live",
"description": "Offer is publicly visible and is available for purchase.",
"status": "notStarted",
"messages": [],
"progressPercentage": 0
}
],
"previewLinks": [],
"liveLinks": [],
}
}
]
Proprietà del corpo della risposta
| Nome | Descrizione |
|---|---|
| id | GUID che identifica in modo univoco l'operazione |
| submissionType | Identifica il tipo di operazione segnalata per l'offerta, ad esempio Publish/GoLive |
| createdDateTime | Datetime UTC in cui è stata creata l'operazione |
| lastActionDateTime | Datetime UTC in cui è stato eseguito l'ultimo aggiornamento dell'operazione |
| stato | Stato dell'operazione o not started | running | failed | completed. Una sola operazione alla volta può avere lo stato running. |
| Errore | Messaggio di errore per le operazioni non riuscite |
Proprietà del passaggio di risposta
| Nome | Descrizione |
|---|---|
| estimatedTimeFrame | Durata stimata di questa operazione |
| id | Identificatore univoco per il processo di passaggio |
| description | Descrizione del passaggio |
| stepName | Nome descrittivo del passaggio |
| stato | Stato del passaggio, notStarted | running | failed | completed |
| messages | Eventuali notifiche o avvisi rilevati durante il passaggio. Matrice di stringhe |
| progressPercentage | Intero compreso tra 0 e 100 che indica la progressione del passaggio |
Codici di stato della risposta
| Codice | Descrizione |
|---|---|
| 200 | OK: la richiesta è stata elaborata correttamente e l'operazione o le operazioni richieste sono state restituite. |
| 400 | Bad/Malformed request - Il corpo della risposta di errore potrebbe contenere altre informazioni. |
| 403 | Forbidden: il client non ha accesso allo spazio dei nomi specificato. |
| 404 | Not found: l'entità specificata non esiste. |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per