Recuperar ofertas

Artigo
06/14/2024

Observação

As APIs do Portal do Cloud Partner são integradas ao Partner Center e continuarão funcionando nele. A transição introduz pequenas alterações. Examine as alterações listadas na API do Portal do Cloud Partner para garantir que seu código continue funcionando após a transição para o Cloud Partner. As APIs do CPP somente devem ser usadas em produtos existentes que já foram integrados antes da transição para o Partner Center. Os novos produtos devem usar as 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 do URI

Nome	Descrição	Data type
publisherId	Identificador do editor, por exemplo `contoso`	String
api-version	Última versão da API	Data

Nome	Valor
Content-Type	`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
publisherId	Identificador que identifica exclusivamente o editor
status	Status da oferta. Para a lista de valores possíveis, consulte Status da oferta abaixo.
ID	GUID que identifica exclusivamente a oferta no namespace do editor.
version	Versão atual da oferta. A propriedade version não pode ser modificada pelo cliente. Isso é 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 API Recuperar oferta específica.
changedTime	Hora em UTC quando a oferta foi modificada pela última vez

Códigos de status de resposta

Código	Descrição
200	`OK` - A solicitação foi processada com êxito e todas as ofertas do editor foram devolvidas ao cliente.
400	`Bad/Malformed request` - O corpo da resposta ao 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
NeverPublished	A oferta nunca foi publicada.
NotStarted	A oferta é nova, mas não foi iniciada.
WaitingForPublisherReview	A oferta aguarda aprovação do editor.
Em execução	O envio da oferta está sendo processado.
Êxito	O envio da oferta concluiu o processamento.
Canceled	O envio da oferta foi cancelado.
Com falha	O envio da oferta falhou.

Compartilhar via