Compartilhar via


Recuperar operações

Observação

As APIs do Cloud Partner Portal estão integradas e continuarão funcionando no Partner Center. A transição apresenta pequenas alterações. Revise as alterações listadas na Referência da API do Portal de Parceiros em Nuvem para garantir que seu código continue funcionando após a transição para o Centro de Parceiros. As APIs de CPP devem ser usadas apenas para produtos existentes que já estavam integrados antes da transição para o Partner Center; novos produtos devem usar as APIs de submissão do Partner Center.

Recupera todas as operações na oferta ou para obter uma operação específica para o operationId especificado. O cliente pode usar parâmetros de consulta para filtrar as 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

Nome Descrição Tipo de dados
publisherId Identificador do editor, por exemplo Contoso fio
offerId Identificador de oferta fio
operationId GUID que identifica exclusivamente a operação na oferta. O operationId pode ser recuperado usando essa API e também é retornado no cabeçalho HTTP da resposta para qualquer operação de execução longa, como a API de oferta de publicação . GUID
versão da API Versão mais recente da API Data (calendário)
Nome Valor
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

Nome Descrição
id GUID que identifica exclusivamente a operação
tipo de submissão Identifica o tipo de operação que está sendo relatada para a oferta, por exemplo Publish/GoLive
createdDateTime Data e hora UTC em que a operação foi criada
lastActionDateTime UTC data e hora em que a última atualização foi feita na operação
estado Status da operação, ou not startedfailed | completedrunning | | . Apenas uma operação pode ter status running por vez.
erro Mensagem de erro para operações com falha

Propriedades da etapa de resposta

Nome Descrição
Período estimado A duração estimada desta operação
id O identificador exclusivo para o processo de etapa
descrição Descrição da etapa
nome do passo O nome amigável para a etapa
estado O status da etapa, notStarted | running | failed | completed
de nuvem para dispositivo Quaisquer notificações ou avisos encontrados durante a etapa. Matriz das cadeias de caracteres
porcentagem de progresso Um número inteiro de 0 a 100 que indica a progressão da etapa

Códigos de status de resposta

Código Descrição
200 OK - A solicitação foi processada com sucesso 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.