Recuperar operações
Artigo 03/06/2025
3 colaboradores
Comentários
Neste artigo
Nota
As APIs do Portal do Cloud Partner são integradas e continuarão trabalhando no Partner Center. A transição apresenta pequenas alterações. Examine as alterações listadas no
Recupera todas as operações na oferta ou para obter uma operação específica para a operationId especificada. O cliente pode usar parâmetros de consulta para filtrar operações em execução.
GET https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>/operations/<operationId>?api-version=2017-10-31
Parâmetros de URI
Name
descrição
de tipo de dados
publisherId
Identificador do publicador, por exemplo, Contoso
Corda
offerId
Identificador de oferta
Corda
operationId
GUID que identifica exclusivamente a operação na oferta. A operationId pode ser recuperada usando essa API e também é retornada no cabeçalho HTTP da resposta para qualquer operação de execução prolongada, como a oferta Publicar API.
Guid
api-version
Versão mais recente da API
Data
Name
Value
Tipo de conteúdo
application/json
Autorização
Bearer YOUR_TOKEN
Exemplo de corpo
Resposta
Operações 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"
}
]
Operação 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": [],
}
}
]
Propriedades do corpo da resposta
Name
descrição
id
GUID que identifica exclusivamente a operação
submissionType
Identifica o tipo de operação que está sendo relatada para a oferta, por exemplo, Publish/GoLive
createdDateTime
Datetime UTC quando a operação foi criada
lastActionDateTime
Datetime UTC quando a última atualização foi feita na operação
estado
Status da operação, not started | running | failed | completed. Apenas uma operação pode ter running de status por vez.
erro
Mensagem de erro para operações com falha
Propriedades da etapa de resposta
Name
descrição
estimatedTimeFrame
A duração estimada desta operação
id
O identificador exclusivo para o processo de etapa
descrição
Descrição da etapa
stepName
O nome amigável da etapa
estado
O status da etapa, notStarted | running | failed | completed
Mensagens
Quaisquer notificações ou avisos encontrados durante a etapa. Matriz de cadeias de caracteres
progressPercentage
Um inteiro de 0 a 100 indicando a progressão da etapa
Códigos de status de resposta
de código
descrição
200
OK - A solicitação foi processada com êxito e as operações solicitadas foram retornadas.
400
Bad/Malformed request - O corpo da resposta de erro pode conter mais informações.
403
Forbidden - O cliente não tem acesso ao namespace especificado.
404
Not found - A entidade especificada não existe.