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
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.