Adott ajánlat lekérése
Feljegyzés
A Cloud Partner Portal API-k integrálva vannak a Partnerközpontban, és továbbra is működni fognak. Az áttűnés kis változásokat vezet be. Tekintse át a Cloud Partner Portal API-referenciájában felsorolt módosításokat, hogy a kód továbbra is működjön a Partnerközpontra való áttérés után. A CPP API-kat csak olyan meglévő termékekhez szabad használni, amelyek már integrálva voltak a Partnerközpontra való áttérés előtt; az új termékeknek a Partnerközpont beküldési API-jait kell használniuk.
Lekéri a megadott ajánlatot a közzétevő névterében.
Lekérheti az ajánlat egy adott verzióját, vagy lekérheti az ajánlatot piszkozatban, nézetben vagy éles tárolóhelyeken. Ha nincs megadva egy pont, az alapértelmezett érték a következő draft
. Ha megkísérli lekérni a nem előzetes verziójú vagy közzétett ajánlatot, az hibát fog eredményezni 404 Not Found
.
Figyelmeztetés
A titkos kód típusú mezők titkos értékeit ez az API nem kéri le.
GET https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>?api-version=2017-10-3
URI-paraméterek
Név | Leírás | Adattípus |
---|---|---|
publisherId | publisherId. Például: Contoso | Sztring |
offerId | Guid, amely egyedileg azonosítja az ajánlatot. | Sztring |
Verzió | A lekért ajánlat verziója. Alapértelmezés szerint a rendszer lekéri a legújabb ajánlatverziót. | Egész |
slotId | Az ajánlat lekérésének helye a következő lehet: - Draft (alapértelmezett) a jelenleg piszkozatban lévő ajánlatverziót kéri le. - Preview lekéri a jelenleg előzetes verzióban elérhető ajánlatverziót. - Production lekéri az éles környezetben jelenleg elérhető ajánlatverziót. |
Enum |
api-verzió | Az API legújabb verziója | Dátum |
Fejléc
Név | Érték |
---|---|
Content-Type | application/json |
Engedélyezés | Bearer YOUR_TOKEN |
Példa törzsre
Válasz
{
"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=abcDEF123456GHI...%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=abcDEF123456GHI...%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=abcDEF123456GHI...%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=abcDEF123456GHI...%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=abcDEF123456GHI...%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"
}
}
Választörzs tulajdonságai
Név | Leírás |
---|---|
offerTypeId | Az ajánlat típusát azonosítja |
publisherId | A közzétevő egyedi azonosítója |
status | Az ajánlat állapota. A lehetséges értékek listáját az Ajánlat állapota című témakörben találja. |
Id | GUID, amely egyedileg azonosítja az ajánlatot |
Verzió | Az ajánlat aktuális verziója. A verziótulajdonságot az ügyfél nem módosíthatja. Minden közzététel után növekszik. |
definíció | A számítási feladat tényleges definíciója |
changedTime | UTC dátumidő az ajánlat legutóbbi módosításának időpontjához |
Válaszállapot-kódok
Kód | Leírás |
---|---|
200 | OK - A kérés feldolgozása sikeresen megtörtént, és a közzétevő összes ajánlata visszakerült az ügyfélhez. |
400 | Bad/Malformed request – A hibaválasz törzse további információkat tartalmazhat. |
403 | Forbidden - Az ügyfél nem rendelkezik hozzáféréssel a megadott névtérhez. |
404 | Not found - A megadott entitás nem létezik. Az ügyfélnek ellenőriznie kell a publisherId, az offerId és a verziót (ha meg van adva). |
Ajánlat állapota
Név | Leírás |
---|---|
NeverPublished | Az ajánlat még soha nem lett közzétéve. |
NotStarted | Az ajánlat új, de még nem indult el. |
WaitingForPublisherReview | Az ajánlat a közzétevő jóváhagyására vár. |
Futó | Az ajánlatbeküldés feldolgozása folyamatban van. |
Sikeres | Az ajánlatbeküldés feldolgozása befejeződött. |
Visszavont | Az ajánlat beküldése megszakadt. |
Sikertelen | Az ajánlat beküldése nem sikerült. |