Načtení konkrétní nabídky
Poznámka
Rozhraní API portálu partnerů cloudu jsou integrovaná s partnerskými portály a budou v Partnerském centru dál fungovat. Přechod přináší malé změny. Projděte si změny uvedené v referenčních informacích k rozhraní API portálu partnerů cloudu a ujistěte se, že váš kód po přechodu do Partnerského centra dál funguje. Rozhraní API CPP by se měla používat pouze pro stávající produkty, které byly již integrované před přechodem na Partnerské centrum. Nové produkty by měly používat rozhraní API pro odesílání v Partnerském centru.
Načte zadanou nabídku v oboru názvů vydavatele.
Můžete také načíst konkrétní verzi nabídky nebo načíst nabídku v konceptech, zobrazení nebo produkčních slotech. Pokud slot není zadaný, výchozí hodnota je draft
. Při pokusu o načtení nabídky, která nebyla v náhledu nebo publikovaná, dojde k 404 Not Found
chybě.
Upozornění
Toto rozhraní API nenačte hodnoty tajných kódů pro pole typu tajného kódu.
GET https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>?api-version=2017-10-31
GET https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>/versions/<version>?api-version=2017-10-31
GET https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>/slot/<slotId>?api-version=2017-10-31
Parametry identifikátoru URI
Název | Popis | Datový typ |
---|---|---|
publisherId (ID vydavatele) | publisherId. Například Contoso | Řetězec |
offerId | Identifikátor GUID, který jedinečně identifikuje nabídku. | Řetězec |
verze | Načítá se verze nabídky. Ve výchozím nastavení se načte nejnovější verze nabídky. | Integer |
slotId | Slot, ze kterého se má nabídka načíst, může být jeden z: – Draft (výchozí) načte verzi nabídky, která je aktuálně v konceptu. - Preview načte verzi nabídky, která je aktuálně ve verzi Preview. - Production načte verzi nabídky, která je aktuálně v produkčním prostředí. |
enum |
verze-api | Nejnovější verze rozhraní API | Datum |
Hlavička
Název | Hodnota |
---|---|
Typ obsahu | application/json |
Autorizace | Bearer YOUR_TOKEN |
Příklad textu
Odpověď
{
"offerTypeId": "microsoft-azure-virtualmachines",
"publisherId": "contoso",
"status": "failed",
"id": "059afc24-07de-4126-b004-4e42a51816fe",
"version": 5,
"definition": {
"displayText": "Contoso Virtual Machine Offer",
"offer": {
"microsoft-azure-marketplace-testdrive.enabled": false,
"microsoft-azure-marketplace-testdrive.videos": [],
"microsoft-azure-marketplace.title": "Contoso App",
"microsoft-azure-marketplace.summary": "Contoso App makes dev ops a breeze",
"microsoft-azure-marketplace.longSummary": "Contoso App makes dev ops a breeze",
"microsoft-azure-marketplace.description": "Contoso App makes dev ops a breeze",
"microsoft-azure-marketplace.offerMarketingUrlIdentifier": "contosoapp",
"microsoft-azure-marketplace.allowedSubscriptions": [
"59160c40-2e25-4dcf-a2fd-6514cb08bf08"
],
"microsoft-azure-marketplace.usefulLinks": [
{
"linkTitle": "Contoso App for Azure",
"linkUrl": "https://azuremarketplace.microsoft.com"
}
],
"microsoft-azure-marketplace.categoryMap": [
{
"categoryL1": "analytics",
"categoryL2-analytics": [
"visualization-and-reporting"
]
},
{
"categoryL1": "ai-plus-machine-learning",
"categoryL2-ai-plus-machine-learning": [
"bot-services",
"cognitive-services",
"other"
]
}
],
"microsoft-azure-marketplace.smallLogo": "https://publishingapistore.blob.core.windows.net/testcontent/D6191_publishers_contoso/contosovirtualmachine/6218c455-9cbc-450c-9920-f2e7a69ee132.png?sv=2014-02-14&sr=b&sig=6O8MM9dgiJ48VK0MwddkyVbprRAnBszyhVkVHGShhkI%3D&se=2019-03-28T19%3A46%3A50Z&sp=r",
"microsoft-azure-marketplace.mediumLogo": "https://publishingapistore.blob.core.windows.net/testcontent/D6191_publishers_contoso/contosovirtualmachine/557e714b-2f31-4e12-b0cc-e48dd840edf4.png?sv=2014-02-14&sr=b&sig=NwL67NTQf9Gc9VScmZehtbHXpYmxhwZc2foy3o4xavs%3D&se=2019-03-28T19%3A46%3A49Z&sp=r",
"microsoft-azure-marketplace.largeLogo": "https://publishingapistore.blob.core.windows.net/testcontent/D6191_publishers_contoso/contosovirtualmachine/142485da-784c-44cb-9523-d4f396446258.png?sv=2014-02-14&sr=b&sig=xaMxhwx%2FlKYfz33mJGIg8UBdVpsOwVvqhjTJ883o0iY%3D&se=2019-03-28T19%3A46%3A49Z&sp=r",
"microsoft-azure-marketplace.wideLogo": "https://publishingapistore.blob.core.windows.net/testcontent/D6191_publishers_contoso/contosovirtualmachine/48af9013-1df7-4c94-8da8-4626e5039ce0.png?sv=2014-02-14&sr=b&sig=%2BnN7f2tprkrqb45ID6JlT01zXcy1PMTkWXtLKD6nfoE%3D&se=2019-03-28T19%3A46%3A49Z&sp=r",
"microsoft-azure-marketplace.screenshots": [],
"microsoft-azure-marketplace.videos": [],
"microsoft-azure-marketplace.leadDestination": "None",
"microsoft-azure-marketplace.tableLeadConfiguration": {},
"microsoft-azure-marketplace.blobLeadConfiguration": {},
"microsoft-azure-marketplace.salesForceLeadConfiguration": {},
"microsoft-azure-marketplace.crmLeadConfiguration": {},
"microsoft-azure-marketplace.httpsEndpointLeadConfiguration": {},
"microsoft-azure-marketplace.marketoLeadConfiguration": {},
"microsoft-azure-marketplace.privacyURL": "https://azuremarketplace.microsoft.com",
"microsoft-azure-marketplace.termsOfUse": "Terms of use",
"microsoft-azure-marketplace.engineeringContactName": "Jon Doe",
"microsoft-azure-marketplace.engineeringContactEmail": "jondoe@outlook.com",
"microsoft-azure-marketplace.engineeringContactPhone": "555-555-5555",
"microsoft-azure-marketplace.supportContactName": "Jon Doe",
"microsoft-azure-marketplace.supportContactEmail": "jondoe@outlook.com",
"microsoft-azure-marketplace.supportContactPhone": "555-555-5555",
"microsoft-azure-marketplace.publicAzureSupportUrl": "",
"microsoft-azure-marketplace.fairfaxSupportUrl": ""
},
"plans": [
{
"planId": "contososkuidentifier",
"microsoft-azure-virtualmachines.skuTitle": "Contoso App",
"microsoft-azure-virtualmachines.skuSummary": "Contoso App makes dev ops a breeze.",
"microsoft-azure-virtualmachines.skuDescription": "This is a description for the Contoso App that makes dev ops a breeze.",
"microsoft-azure-virtualmachines.hideSKUForSolutionTemplate": false,
"microsoft-azure-virtualmachines.cloudAvailability": [
"PublicAzure"
],
"microsoft-azure-virtualmachines.certificationsFairfax": [],
"virtualMachinePricing": {
"isByol": true,
"freeTrialDurationInMonths": 0
},
"microsoft-azure-virtualmachines.operatingSystemFamily": "Windows",
"microsoft-azure-virtualmachines.windowsOSType": "Other",
"microsoft-azure-virtualmachines.operationSystem": "Contoso App",
"microsoft-azure-virtualmachines.recommendedVMSizes": [
"a0-basic",
"a0-standard",
"a1-basic",
"a1-standard",
"a2-basic",
"a2-standard"
],
"microsoft-azure-virtualmachines.openPorts": [],
"microsoft-azure-virtualmachines.vmImages": {
"1.0.1": {
"osVhdUrl": "http://contosoteststorage.blob.core.windows.net/test/contosoVM.vhd?sv=2014-02-14&sig=WlDo6Q4xwYH%2B5QEJbItPUVdgHhBcrVxPBmntZ2vU96w%3D&st=2016-06-25T18%3A30%3A00Z&se=2017-06-25T18%3A30%3A00Z&sp=rl",
"lunVhdDetails": []
}
},
"regions": [
"DZ",
"AR"
]
}
]
},
"changedTime": "2017-06-07T06:15:39.7349221Z"
}
}
Vlastnosti textu odpovědi
Název | Popis |
---|---|
offerTypeId | Určuje typ nabídky. |
publisherId (ID vydavatele) | Jedinečný identifikátor vydavatele |
status | Stav nabídky. Seznam možných hodnot najdete v části Stav nabídky níže. |
Id | Identifikátor GUID, který jedinečně identifikuje nabídku |
verze | Aktuální verze nabídky. Vlastnost version nemůže být změněna klientem. Po každém publikování se zvýší. |
definice | Skutečná definice úlohy |
changedTime | Datum a čas utc, kdy byla nabídka naposledy změněna |
Stavové kódy odpovědí
Kód | Popis |
---|---|
200 | OK - Požadavek byl úspěšně zpracován a všechny nabídky v rámci vydavatele byly vráceny klientovi. |
400 | Bad/Malformed request – Text odpovědi na chybu může obsahovat další informace. |
403 | Forbidden – Klient nemá přístup k zadanému oboru názvů. |
404 | Not found – Zadaná entita neexistuje. Klient by měl zkontrolovat publisherId, offerId a version (pokud je zadaný). |
Stav nabídky
Název | Popis |
---|---|
Nikdy nepublikováno | Nabídka nebyla nikdy publikována. |
Nezahájené | Nabídka je nová, ale není spuštěná. |
WaitingForPublisherReview | Nabídka čeká na schválení vydavatelem. |
Spuštěno | Probíhá zpracování odeslání nabídky. |
Úspěšný | Odeslání nabídky bylo dokončeno. |
Zrušeno | Odeslání nabídky bylo zrušeno. |
Neúspěšný | Odeslání nabídky se nezdařilo. |