Recuperare le operazioni
Articolo 06/14/2024
2 contributori
Commenti e suggerimenti
In questo articolo
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
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.