Recuperar ofertas

Artigo
03/06/2025

Observação

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

Recupera uma lista resumida de ofertas em um namespace de editor.

GET https://cloudpartner.azure.com/api/publishers/<publisherId>/offers?api-version=2017-10-31

Parâmetros de URI

Nome	Descrição	Tipo de dados
editorId	Identificador do editor, por exemplo, `contoso`	String
API-versão	Versão mais recente da API	Data

Nome	valor
Tipo de conteúdo	`application/json`
Autorização	`Bearer YOUR_TOKEN`

Exemplo de corpo

Resposta

  200 OK 
  [ 
      {  
          "offerTypeId": "microsoft-azure-virtualmachines",
          "publisherId": "contoso",
          "status": "published",
          "id": "059afc24-07de-4126-b004-4e42a51816fe",
          "version": 1,
          "definition": {
              "displayText": "Contoso Virtual Machine"
          },
          "changedTime":"2017-05-23T23:33:47.8802283Z"
      }
  ]

Propriedades do corpo de resposta

Nome	Descrição
offerTypeId	Identifica o tipo de oferta
editorId	Identificador que identifica exclusivamente o editor
Situação	Estado da oferta. Para obter a lista de valores possíveis, consulte Status da oferta abaixo.
ID	GUID que identifica exclusivamente a oferta no namespace do editor.
Versão	Versão atual da oferta. A propriedade version não pode ser modificada pelo cliente. É incrementado após cada publicação.
Definição	Contém uma visão resumida da definição real da carga de trabalho. Para obter uma definição detalhada, use a oferta específica do Retrieve API.
changedTime	Hora UTC quando a oferta foi modificada pela última vez

Códigos de status de resposta

Código	Descrição
200	`OK` - O pedido foi processado com sucesso e todas as ofertas sob a editora foram devolvidas ao cliente.
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.

Status da oferta

Nome	Descrição
Nunca Publicado	A oferta nunca foi publicada.
NotStarted	A oferta é nova, mas não foi iniciada.
WaitingForPublisherReview	A oferta aguarda a aprovação do editor.
Em execução	A submissão de ofertas está a ser processada.
Bem sucedido	O envio da oferta foi concluído o processamento.
Cancelado	A submissão da oferta foi cancelada.
Falhou	Falha no envio da oferta.

Partilhar via