Recuperar ofertas

Artigo
03/06/2025

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 de Referência da API do Portal do Cloud Partner para garantir que seu código continue funcionando após a transição para o Partner Center. As APIs do 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 do editor.

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

Parâmetros de URI

Name	descrição	de tipo de dados
publisherId	Identificador do publicador, por exemplo, `contoso`	Corda
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

  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 da resposta

Name	descrição
offerTypeId	Identifica o tipo de oferta
publisherId	Identificador que identifica exclusivamente o publicador
estado	Status 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 de versão não pode ser modificada pelo cliente. Ele é incrementado após cada publicação.
definição	Contém uma exibição resumida da definição real da carga de trabalho. Para obter uma definição detalhada, use o Recuperar oferta específica API.
changedTime	Hora UTC em que a oferta foi modificada pela última vez

Códigos de status de resposta

de código	descrição
200	`OK` - A solicitação foi processada com êxito e todas as ofertas sob o publicador foram retornadas 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

Name	descrição
NeverPublished	A oferta nunca foi publicada.
NotStarted	A oferta é nova, mas não foi iniciada.
WaitingForPublisherReview	A oferta está aguardando a aprovação do editor.
Executando	O envio da oferta está sendo processado.
Conseguiu	O envio da oferta concluiu o processamento.
Cancelado	O envio da oferta foi cancelado.
Falhou	Falha no envio da oferta.

Compartilhar via