Pobieranie stanu oferty

2025-06-21

Uwaga / Notatka

Interfejsy API portalu Cloud Partner Portal są zintegrowane z Partner Center i będą nadal w nim działać. Przejście wprowadza niewielkie zmiany. Przejrzyj zmiany wymienione w Dokumentacja interfejsu API portalu Cloud Partner Portal, aby upewnić się, że kod będzie nadal działać po przejściu do Centrum partnerskiego. Interfejsy API CPP powinny być używane tylko dla istniejących produktów, które zostały już zintegrowane przed przejściem do Centrum partnerskiego; nowe produkty powinny używać interfejsów API przesyłania w Centrum partnerskim.

Pobiera bieżący stan oferty.

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

Parametry identyfikatora URI

Nazwa	Opis	Typ danych
publisherId (identyfikator wydawcy)	Identyfikator wydawcy, na przykład `Contoso`	Sznurek
Identyfikator oferty	Identyfikator GUID jednoznacznie identyfikujący ofertę	Sznurek
wersja API	Najnowsza wersja API	Data kalendarzowa

Nazwa	Wartość
Typ zawartości	`application/json`
Autoryzacja	`Bearer YOUR_TOKEN`

Przykład ciała

Odpowiedź

  {
      "status": "succeeded",
      "messages": [],
      "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": "2018-03-16T17:50:45.7215661Z"
              }
          ],       
          "progressPercentage": 100
      },
      {
          "estimatedTimeFrame": "~2-3 days",
          "id": "displaycertify",
          "stepName": "Certification",
          "description": "Your offer is analyzed by our certification systems for issues.",
          "status": "notStarted",
          "messages": [],
          "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 being packaged for customers. Additionally, lead systems are being configured and set up.",
          "status": "notStarted",
          "messages": [],
          "progressPercentage": 0
      },
      {
          "estimatedTimeFrame": "< 1 hour",
          "id": "publisher-signoff",
          "stepName": "Publisher signoff",
          "description": "Offer is available to preview. Ensure that everything looks good before making your offer live.",
          "status": "complete",
          "messages": [],
          "progressPercentage": 0
      },
      {
          "estimatedTimeFrame": "~2-5 days",
          "id": "live",
          "stepName": "Live",
          "description": "Offer is publicly visible and is available for purchase.",
          "status": "complete",
          "messages": [],
          "progressPercentage": 0
      }
      ],
      "previewLinks": [],
      liveLinks": [],
  }

Właściwości treści odpowiedzi

Nazwa	Opis
stan	Status oferty. Aby zapoznać się z listą możliwych wartości, zobacz Stan oferty poniżej.
wiadomości	Tablica wiadomości skojarzonych z ofertą
kroki	Tablica kroków, przez które przechodzi oferta podczas publikowania oferty
estimatedTimeFrame (szacowany okres czasu)	Szacunkowy czas potrzebny na wykonanie tego kroku, w przyjaznym formacie
id	Identyfikator kroku
stepName (nazwa kroku)	Nazwa kroku
opis	Opis kroku
stan	Stan kroku. Aby zapoznać się z listą możliwych wartości, zobacz Stan kroku poniżej.
wiadomości	Tablica komunikatów związanych z krokiem
processPercentage (procent procesu)	Procent ukończenia kroku
previewLinks (Linki w wersji zapoznawczej)	Obecnie niezaimplementowane
Linki na żywo	Obecnie niezaimplementowane
powiadomienieWiadomości e-mail	Przestarzałe dla ofert migrowanych do Centrum partnerskiego. Wiadomości e-mail z powiadomieniami o przeniesionych ofertach będą wysyłane na adres e-mail podany w polu Dane kontaktowe sprzedawcy w ustawieniach konta. W przypadku ofert, które nie zostały przeniesione, jest to rozdzielana przecinkami lista adresów e-mail, które mają być powiadamiane o postępie operacji.

Kody stanu odpowiedzi

Kod	Opis
200	`OK` - Zapytanie zostało pomyślnie przetworzone, a aktualny status oferty został zwrócony.
400	`Bad/Malformed request` - Treść odpowiedzi na błąd może zawierać więcej informacji.
404	`Not found` - Określona jednostka nie istnieje.

Stan oferty

Nazwa	Opis
Nigdy nie opublikowano	Oferta nigdy nie została opublikowana.
Nierozpoczęty	Oferta jest nowa i nie rozpoczęta.
Oczekiwanie na wydawcęRecenzja	Oferta oczekuje na zatwierdzenie przez wydawcę.
Bieganie	Składanie ofert jest w trakcie przetwarzania.
Udało się	Złożenie oferty zostało zakończone.
Anulowane	Złożenie oferty zostało anulowane.
Nie powiodło się	Przesłanie oferty nie powiodło się.

Stan kroku

Nazwa	Opis
Nierozpoczęty	Krok nie został rozpoczęty.
W toku	Krok jest uruchomiony.
Oczekiwanie na wydawcęRecenzja	Krok polega na oczekiwaniu na zatwierdzenie przez wydawcę.
Oczekiwanie na zatwierdzenie	Krok polega na oczekiwaniu na zatwierdzenie procesu.
Zablokowany	Krok jest zablokowany.
Odrzucone	Krok został odrzucony.
Ukończ	Krok jest zakończony.
Anulowane	Krok został anulowany.

Udostępnij za pośrednictwem