Rozhraní API pro příjem dat produktů pro virtuální počítače

Článek
07/09/2024

Rozhraní API pro příjem dat produktů je modernizované rozhraní API, které sjednocuje všechna existující rozhraní API pro odesílání napříč všemi produkty komerčního marketplace. Rozhraní API umožňuje vytvářet, publikovat a spravovat prostředky přidružené k produktům a plánům v rámci účtu Partnerského centra. Používá deklarativní vzor k odesílání požadavků, ve kterém je požadovaný stav označen jako rozdíl od určení jednotlivých kroků pro dosažení požadovaného stavu.

Tento článek obsahuje pokyny, jak začít s rozhraními API pro jakýkoli typ nabídky komerčního marketplace. Rozhraní API pro příjem dat produktů je aktuálně podporované pro SaaS, virtuální počítače, privátní nabídky a typy nabídek kontejnerů a jsou ve verzi Preview. Pokyny specifické pro vaši nabídku najdete v pokynech k rozhraní API pro jednotlivé typy nabídek.

Důležité

Azure Active Directory (Azure AD) Graph je od 30. června 2023 zastaralý. V budoucnu nepracujeme do Azure AD Graphu žádné další investice. Rozhraní Azure AD Graph API nemají žádné závazky sla ani údržby nad rámec oprav souvisejících se zabezpečením. Investice do nových funkcí a funkcí budou provedeny pouze v Microsoft Graphu.

Azure AD Graph vyřadíme v přírůstkových krocích, abyste měli dostatek času na migraci aplikací do rozhraní Microsoft Graph API. Později, kdy budeme oznamovat, zablokujeme vytváření nových aplikací pomocí Azure AD Graphu.

Další informace najdete v tématu Důležité: Vyřazení azure AD Graphu a vyřazení modulu PowerShellu.

Začínáme

K rozhraní API pro příjem dat produktů je možné přistupovat pomocí rozhraní MSGraph API pod názvem "příjem produktů". Základní adresa URL je https://graph.microsoft.com/rp/product-ingestion.

Pokud chcete použít rozhraní API pro příjem dat produktů, musíte nejprve získat následující požadavky:

ID Microsoft Entra a ujistěte se, že máte pro adresář oprávnění globálního správce.
Aplikace Microsoft Entra
Přístupový token Microsoft Entra

Pokud chcete začít, postupujte podle těchto pokynů k onboardingu. Po tomto nastavení můžete získat přístupový token Microsoft Entra pro volání rozhraní API s autorizační hlavičkou pro každou metodu rozhraní API.

Koncepty

Než začnete, musíte porozumět některým základním konceptům.

Zdroje informací

Rozhraní API je strukturované kolem typů prostředků, kde každý typ je popsán pomocí vyhrazené definice schématu, jak odkazuje vlastnost "$schema". Schéma se skládá z vlastností konfigurace daného prostředku. Prostředky jsou zásadní při vytváření a aktualizaci konfigurace různých aspektů daného produktu. Úplný seznam typů prostředků a jejich schémat najdete v referenčních informacích k rozhraní API prostředků.

Trvalé ID

Durable ID je systémový vygenerovaný globální identifikátor sloužící k jedinečné identifikaci jakéhokoli prostředku. Každý prostředek má přidruženou vlastnost ID, která v kombinaci s názvem typu prostředku tvoří trvalé ID prostředku. Trvalé ID se používá při odkazování na prostředky k načtení nebo úpravě.

Formát:

\<resource-type>/\<id>

Příklad:

        { 
            "$schema": "https://schema.mp.microsoft.com/schema/product/2022-03-01-preview3",
            "id": "product/12345678-abcd-efgh-1234-12345678901", // durable ID
            "identity": {
              "externalID": "ds-contoso-image-resize-demo"
            },
            "type": "softwareAsAService", // Product types that can be specified include azureContainer, azureVirtualMachine, softwareAsAService 
            "alias": "Contoso Image Resizing Service"
        }

Externí ID

Externí ID je další jedinečný identifikátor, který lze použít k odkazování na konkrétní produkty nebo plány. Toto je alternativní způsob, jak odkazovat na tyto prostředky místo použití trvalého ID. Externí ID produktu se překládá na jeho "offerID" a externí ID plánu se překládá na jeho "planID", jak je definováno při vytvoření v rámci vlastnosti "identity".

Příklad:

            { 
                "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-03-01-preview2",
                "id": "plan/12345678-abcd-efgh-1234-12345678901/4e0bfefa-b993-4b79-a426-871c3bf236a5",
                "identity": {
                  "externalID": "gold-annual"
                },
                "azureRegions": [
                    "azureGlobal"
                  ],
                "alias": "Gold - Annual payment",
                "product": "product/12345678-abcd-efgh-1234-12345678901",
            }

Metody rozhraní API

Existují čtyři rozhraní API pro správu, která se dají použít k provádění různých akcí, jako je dotazování stávajících prostředků, provádění aktualizací konfigurace a kontrola stavu žádosti.

Poznámka:

Všechny požadavky vyžadují, abyste v rámci odpovědi nastavili požadovanou verzi schématu (parametr dotazu $version).

Typ rozhraní API	Popis	Metoda a cesta HTTP
Dotaz	Načte existující prostředky podle: -Metoda 1: Typ prostředku resource-tree -Metoda 2: durable-id -Metoda 3: Parametry řetězce dotazu	-Metoda 1: `GET resource-tree/<product-durableID>` -Metoda 2: `GET <resource-durableID>` -Metoda 3: `GET <resourceType>?<query parameters>`
Konfigurace odeslání	Odešle žádosti o vytvoření nebo aktualizaci jednoho nebo více prostředků. Po úspěšném zpracování se vrátí ID úlohy, které lze použít k načtení stavu požadavku. Tento typ rozhraní API lze použít k aktualizaci stavu konceptu a publikování změn, synchronizaci soukromých cílových skupin a úpravě stavu životního cyklu prostředků.	`POST configure`
Konfigurace stavu	Načte stav čekajícího požadavku prostřednictvím ID úlohy.	`GET configure/<jobID>/status`
Konfigurace podrobností o stavu	Načte podrobný souhrn dokončeného požadavku, včetně aktualizovaných prostředků, prostřednictvím ID úlohy.	`GET configure/<jobID>`
Zrušit konfiguraci	Zruší zadanou úlohu Konfigurace.	`POST configure/<jobID>/cancel`

Typický pracovní postup

Pokud chcete aktualizovat existující prostředek, je typickým pracovním postupem:

Načtení existující konfigurace prostředků (typ rozhraní API: Dotazování prostřednictvím stromu prostředků)*
Proveďte potřebné aktualizace a pak odešlete požadavek na konfiguraci (typ rozhraní API: Konfigurace odeslání)
Zkontrolujte stav požadavku (typ rozhraní API: Konfigurace stavu a podrobnosti o stavu Konfigurace)

* Stejný pracovní postup lze použít při vytváření nových prostředků, ale místo načítání prostředků (krok 1) použijte referenční tabulku rozhraní RESOURCE API, abyste zajistili, že používáte aktuální schéma pro typ prostředku, který vytváříte.

Tento obrázek shrnuje typický model volání použitý k odeslání žádosti o konfiguraci bez ohledu na to, jestli vytváříte nový nebo upravujete existující prostředek.

Snímek obrazovky znázorňující typický model volání použitý k odeslání žádosti o konfiguraci

Poznámka:

Nezapomeňte si projít všechny další požadavky specifické pro typ nabídky, který spravujete, pomocí pokynů k rozhraní API pro jednotlivé typy nabídek.

Načtení existujících konfigurací prostředků

Před aktualizací existujících prostředků je důležité je nejprve načíst, abyste měli jistotu, že máte nejnovější konfiguraci. Prostředky můžete načíst několika způsoby prostřednictvím volání GET. Pokud chcete načíst všechny prostředky v rámci konkrétního produktu v rámci jednoho volání rozhraní API, podívejte se na metodu 1, která je podrobně popsána níže.

Metoda 1: Strom prostředků

Schema: https://``schema.mp.microsoft.com``/schema/resource-tree/2022-03-01-preview2

GET resource-tree/<product-durableID>?$version=<schema-version>

Všechny konfigurace prostředků v rámci konkrétního produktu můžete načíst pomocí typu prostředku "resource-tree" spolu s trvalým ID produktu.

Nejnovější dostupná verze schématu se může pro každý prostředek lišit. Při provádění požadavku stromu prostředků určuje zadaná verze schématu, která verze se vrátí pro každý prostředek v produktu. Zadaná verze slouží jako limit maximální verze v tom, že vrací nejnovější verzi schématu dostupnou pro všechny prostředky stejné nebo nižší verze. Pokud je například k dispozici nejnovější dostupná verze výpisu plánu "2022-03-01-preview3", zobrazí se odpověď na tuto verzi, pokud jste v požadavku GET stromu prostředků zadali "2022-03-01-preview5". Pokud se však jako verze stromu prostředků vyžádá "2022-03-03-01-preview2", vrátí se v seznamu prostředků plán 2022-03-03-01-preview2, i když je k dispozici nejnovější dostupná verze 2022-03-01-preview3. Doporučujeme použít nejnovější dostupnou verzi jednotlivých prostředků, abyste měli jistotu, že používáte aktualizované schéma s nově podporovanými funkcemi.

Poznámka:

Pokud neznáte trvalé ID produktu, můžete pomocí externího ID produktu načíst prostředek produktu spuštěním GET product?externalID=<product-externalID>&$version=<product-schema-version>příkazu . Tento požadavek využívá parametr řetězce dotazu, který je podrobně popsán v metodě 3 níže. Odpověď bude obsahovat trvalé ID produktu, které můžete použít pro budoucí požadavky.

Když ve výchozím nastavení spustíte volání GET pomocí "resource-tree", získáte zpět koncept verze vašich prostředků. Předáním parametru dotazu targetType však můžete zadat požadovaný cíl pro načtení dat "preview" nebo "live". V následujícím příkladu volání GET vrátí konfiguraci prostředí Preview pro všechny prostředky v rámci produktu "12345678-abcd-eryth-1234-12345678901".

Ukázkové volání GET:

GET https://graph.microsoft.com/rp/product-ingestion/resource-tree/product/12345678-abcd-efgh-1234-12345678901?targetType="preview"&$version=2022-03-01-preview5

Ukázková odpověď:

        {
          "$schema": "https://schema.mp.microsoft.com/schema/resource-tree/2022-03-01-preview2",
          "root": "product/12345678-abcd-efgh-1234-12345678901",
          "target": {
            "targetType": "preview"
          },
          "resources": [
          { 
            "$schema": "https://schema.mp.microsoft.com/schema/product/2022-03-01-preview3",
            "id": "product/12345678-abcd-efgh-1234-12345678901",
            "identity": {
              "externalID": "ds-contoso-image-resize-demo"
            },
            "type": "softwareAsAService",
            "alias": "Contoso Image Resizing Service"
          },
          { 
            "$schema": "https://schema.mp.microsoft.com/schema/property/2022-03-01-preview3",
            "id": "property/12345678-abcd-efgh-1234-12345678901/public/main",
            "product": "product/12345678-abcd-efgh-1234-12345678901",
            "kind": "azureSaaS",
            "termsConditions": "false",
            "categories": {
          "developer-tools-saas": [
            "devService"
          ]
            }
          },
          {
            "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-03-01-preview2",
            "id": "plan/12345678-abcd-efgh-1234-12345678901/4e0bfefa-b993-4b79-a426-871c3bf236a5",
            "product": "product/071b135e-9faf-4ff7-b113-a3f25bb0f468",
          ...
          }, 
              // The response would include all existing resources within this product.
          {
              ...
          }]
        }

Metoda 2: Durable ID

GET <resource-durableID>?$version=<schema-version>

Načtěte konkrétní prostředek pomocí jeho trvalého ID. Po vytvoření prostředku zůstane trvalé ID vždy stejné a dá se použít k načtení nejnovějších změn konceptu tohoto prostředku voláním metody GET. Například následující požadavek vrátí koncept konfigurace tohoto konkrétního produktu pomocí verze schématu "2022-03-01-preview3".

GET product/12345678-abcd-efgh-1234-12345678901?$version=2022-03-01-preview3

Důležité

Tato metoda se používá pouze k načtení konfigurace konceptu. Pokud chcete načíst náhled nebo živá data, použijte metodu "resource-tree", jak je popsáno výše.

Pokud chcete najít trvalé ID pro vaše prostředky, můžete:

Pomocí metody "resource-tree" můžete načíst všechny prostředky v rámci produktu spolu s jednotlivými příslušnými trvalými ID nebo
Načtěte podrobnosti o dokončené žádosti o konfiguraci prostředků, která zahrnuje trvalé ID všech prostředků vytvořených nebo aktualizovaných jako součást požadavku.

Nezapomeňte, že vlastnost ID je trvalým ID příslušného prostředku.

Metoda 3: Parametry řetězce dotazu

GET <resourceType>?<query parameters>&$version=<schema-version>

Tato metoda slouží k dotazování určitých typů prostředků přidružených ke konkrétnímu účtu. Pomocí jednoho volání GET můžete například načíst všechny produkty konkrétního typu produktu. Parametry řetězce dotazu se používají k dotazování podrobností týkajících se vašich produktů, plánů nebo odeslání.

Tato tabulka zobrazuje podporované parametry dotazu pro každý z podporovaných typů prostředků. Ne všechny typy prostředků podporují každý z parametrů dotazu. V této tabulce najdete úplný seznam aktuálně podporovaných řetězců dotazů.

Typ prostředku	Parametry	Příklady řetězců dotazů
plán	výrobek`` externalID $maxpagesize continuationToken$version``	`GET plan?product=<product-durableID>&$version=<schema-version>` `GET plan?product=<product-durableID>&externalID=<plan-externalID>&$version=<schema-version>` `GET plan?product=<product-durableID>&$maxpagesize=<#>&$version=<schema-version>` `GET plan?product=<product-durableID>&continuationToken=<token>&$version=<schema-version>`
výrobek	externalID type $maxpagesize continuationToken$version`*`	`GET product?externalID=<product-externalID>&$version=<schema-version>` `GET product?type=<product-type>&$version=<schema-version>` `GET product?$maxpagesize=<#>&$version=<schema-version>` `GET product?continuationToken=<token>&$version=<schema-version>`
podání	targetType $maxpagesize continuationToken$version`*`	`GET submission/<product-durableID>?targetType=<environment>&$version=<schema-version>` `GET submission/<product-id>?$maxpagesize=<#>&continuationToken=<token>&$version=<schema-version>`
strom prostředků	targetType$version`*`	`GET resource-tree/<product-durableID>?targetType=<environment>&$version=<schema-version>`

* Parametry produktu a $version jsou vždy povinné.

Funkce jednotlivých podporovaných parametrů dotazu:

product – Při předávání parametru "product" v kontextu typu zdroje "plán" vrátí všechny plány v rámci daného produktu.
externalID – Při předávání parametru externalID v kontextu produktu nebo plánu vrátí konfiguraci příslušného produktu nebo plánu. Na rozdíl od metody resource-tree tento parametr řetězce dotazu vrátí pouze podrobnosti o tomto prostředku, ne všechny prostředky v něm.
type – Při předávání parametru "type" v kontextu typu prostředku "product" vrátí všechny produkty tohoto typu přidružené k vašemu účtu. Například zadáním "type=softwareAsAService" se vrátí všechny vaše produkty SaaS.
targetType – Vrátí data konkrétního prostředí v kontextu použitého typu prostředku. Podporované hodnoty targetType jsou "koncept", "preview" nebo "live".
$maxpagesize – Zadáním maximální velikosti stránky ve formě kladného celého čísla se tento parametr používá k omezení výsledků hledání při dotazování předchozích odeslání.
continuationToken – Tento parametr lze použít s parametrem "$maxpagesize" k dotazování na jinou sadu výsledků dostupných ve vyhledávání. Hodnota "continuationToken" je k dispozici v odpovědi předchozí stránky.
$version – Jedná se o povinný parametr pro všechna volání, určuje, jakou verzi schématu chcete pro odpověď z požadavku, který jste provedli. Nejnovější dostupná verze schématu může být pro každý prostředek odlišná a zadaná verze slouží jako limit maximální verze. Systém vrátí buď přesnou verzi schématu, pokud je k dispozici, nebo nejbližší verzi, která je starší než požadovaná verze. To může pomoct udržet kód funkční i v případě, že dojde k novějším změnám schématu, ale pokud chcete využívat nejnovější funkce, doporučujeme použít nejnovější dostupnou verzi každého schématu.

Dotazování na odeslání

Stávající odeslání produktu můžete načíst provedením GET submission/<product-durableID>. Ve výchozím nastavení získáte zpět všechna aktivní odeslání včetně konceptu odkazu, ale můžete také dotazovat konkrétní prostředí pomocí parametru dotazu targetType: (GET submission/<product-durableID>?targetType=<environment>&$version=<version>).

Důležité

Jakmile se odeslání náhledu nasdílí do "Live", nahradí všechna předchozí odeslání "Live". V takovém případě teď data představují prostředí Preview i Live, dokud se do verze Preview nepublikuje nové odeslání.

Ukázkový požadavek:

GET https://graph.microsoft.com/rp/product-ingestion/submission/12345678-abcd-efgh-1234-12345678901?$version=2022-03-01-preview2

Ukázková odpověď:

Tento příklad ukazuje požadavek GET pro aktivní odeslání přidružené k ID produktu "12345678-abcd-eryth-1234-12345678901". Aktivní odeslání "Live" (odeslání/12345678-abcd-eryth-1234-12345678901/1152921515689847470) bylo nejprve publikováno do náhledu a poté naživo. Když se toto odeslání odeslalo živě 25. ledna 2022, představovalo náhled i živé, dokud se 4. února 2022 nevytvořilo nové odeslání verze Preview (odeslání/ 12345678901/1152921515689848683).

            {
              "value": [
                {
                  "$schema": "https://schema.mp.microsoft.com/schema/submission/2022-03-01-preview2",
                  "id": "submission/12345678-abcd-efgh-1234-12345688901/0",
                  "product": "product/12345678-abcd-efgh-1234-12345678901",
                  "target": {
                    "targetType": "draft"
                  }
                },
                {
                  "$schema": "https://schema.mp.microsoft.com/schema/submission/2022-03-01-preview2",
                  "id": "submission/12345678-abcd-efgh-1234-12345678901/1152921515689847470",
                  "product": "product/12345678-abcd-efgh-1234-12345678901",
                  "target": {
                    "targetType": "live"
                  },
                  "status": "completed",
                  "result": "succeeded",
                  "created": "2022-01-25T07:13:06.4408032Z"
                },
                {
                  "$schema": "https://schema.mp.microsoft.com/schema/submission/2022-03-01-preview2",
                  "id": "submission/12345678-abcd-efgh-1234-12345678901/1152921515689848683",
                  "product": "product/12345678-abcd-efgh-1234-12345678901",
                  "target": {
                    "targetType": "preview"
                  },
                  "status": "completed",
                  "result": "succeeded",
                  "created": "2022-02-04T20:07:22.4220588Z"
                }
              ]
            }

Vytváření nových produktů a prostředků

V rámci jednoho požadavku na konfiguraci můžete vytvořit nové prostředky, včetně nových produktů. Pomocí referenční tabulky rozhraní API prostředků můžete načíst schéma pro typ prostředku, který chcete vytvořit. Tím zajistíte, že používáte nejnovější schéma, a proto nakonfigurujete všechny potřebné vlastnosti pro vytvoření prostředku.

Pokud vytváříte nový produkt, požadavky se liší podle typu produktu. Proto potřebujete poskytnout různé prostředky. Můžete odkazovat na odpovídající dokumentaci ke komerčnímu marketplace pro příslušný typ produktu, abyste měli jistotu, že konfigurujete základní požadavky ve své žádosti. Případně můžete vytvořit žádost o konfiguraci pouze pomocí prostředku produktu. Po vytvoření produktu zavolejte rozhraní API pro konfiguraci podrobností o stavu, které načte vytvořený prostředek produktu, a vyhledejte jeho trvalé ID pro volání rozhraní API pro dotazy stromu prostředků. Odpověď vrátí příslušné podporované prostředky pro typ produktu, který jste vytvořili.

Podobně pokud chcete vytvořit nový prostředek v rámci existujícího produktu, musíte také načíst nejnovější schéma tohoto konkrétního typu prostředku. Ujistěte se, že v rámci požadavku na konfiguraci zadáte závislé prostředky, a to kontrolou závislostí prostředků.

Po vytvoření prostředků pomocí schémat se dozvíte, jak vytvořit požadavek na konfiguraci.

Úprava existujících produktů a prostředků

Aktualizace můžete odeslat pomocí konfigurace datové části. Tato datová část se skládá z jednoho nebo více typů prostředků a vlastnost "$schema" označuje typ prostředku, na který se odkazuje.

Tip

Před publikováním aktualizací doporučujeme nejprve načíst existující prostředky, abyste měli jistotu, že využíváte nejnovější konfiguraci.

Po úpravě prostředků se dozvíte, jak vytvořit požadavek na konfiguraci.

Požadavky na konfiguraci

Můžete upravovat a publikovat ve stejné datové části. Pokud chcete odeslat požadavek na konfiguraci, použijte metodu HTTP POST pro rozhraní API konfigurace. Datová část konfigurace se skládá z pole prostředků, které označují požadované změny. Všechny úpravy mají vliv jenom na verzi konceptu, dokud explicitně nesdílíte prostředek odeslání k publikování změn konceptu. Při publikování do náhledu nebo živého vysílání zahrňte prostředek odeslání a zadejte cílové prostředí. Před odesláním žádosti potřebujete vědět, jak odkazovat na prostředky a porozumět jejich závislostem.

Schema:https://schema.mp.microsoft.com/schema/configure/2022-03-01-preview2

Po odeslání žádosti o konfiguraci získáte zpět objekt stavu konfigurace s ID úlohy, který můžete použít ke sledování průběhu a výsledků vaší žádosti.

Schema: <https://``schema.mp.microsoft.com``/schema/configure-status/2022-03-01-preview2>

Odkazy na prostředky a závislosti

Reference

Pokud chcete odkazovat na existující prostředek v požadavku konfigurace, zadejte typ "$schema" prostředku spolu s trvalým ID prostředku. V případě produktůach

Trvalé ID lze najít ve vlastnosti ID, například pokud se jedná o prostředek produktu, na který chceme odkazovat v jiném prostředku:

            { 
                "$schema": "https://schema.mp.microsoft.com/schema/product/2022-03-01-preview3",
                "id": "product/12345678-abcd-efgh-1234-12345678901",
                "identity": {
                  "externalID": "ds-contoso-image-resize-demo"
                },
                "type": "softwareAsAService",
                "alias": "Contoso Image Resizing Service"
            }

Trvalé ID by bylo "product/071b135e-9faf-4ff7-b113-a3f25bb0f468".

Trvalé ID se pak dá použít v příkladu prostředku výpisu níže tak, že ho nastavíte ve vlastnosti schématu prostředku "product", například takto:

            {
                "$schema": "https://schema.mp.microsoft.com/schema/listing/2022-03-01-preview5", 
                "product": "product/071b135e-9faf-4ff7-b113-a3f25bb0f468", // product durable ID
                  ...
              }

Externí ID prostředků produktu a plánu je definováno v rámci vlastnosti identity.

            {
                "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-03-01-preview2", 
                "alias": "Gold - Annual payment",
                "identity": {"externalID": "gold-annual"},
                "product": "product/071b135e-9faf-4ff7-b113-a3f25bb0f468",
                  ...
              }

Na externí ID plánu "gold-annual" se pak dají odkazovat dalšími dalšími zdroji v následujícím formátu:

              {
                "$schema": "https://schema.mp.microsoft.com/schema/plan-listing/2022-03-01-preview5", 
                "product": "product/071b135e-9faf-4ff7-b113-a3f25bb0f468"}
                "plan": {"externalID": "gold-annual"}
                  ...
              }

Ukázkový požadavek:

V tomto příkladu se datová část konfigurace používá k vytvoření nového produktu SaaS s externím ID ds-contoso-image-resize-demo. Po vytvoření tohoto produktu můžete později na tento produkt odkazovat pomocí jeho trvalého ID nebo externího ID.

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-03-01-preview2

            {
              "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-03-01-preview2"
              "resources": [
                { 
                "$schema": "https://schema.mp.microsoft.com/schema/product/2022-03-01-preview3",
                "identity": {
                  "externalID": "ds-contoso-image-resize-demo"
                },
                "type": "softwareAsAService",
                "alias": " Contoso Image Resizing Service"
              }
              ]
            }

Ukázková odpověď:

            {
  "$schema": "https://schema.mp.microsoft.com/schema/configure-status/2022-03-01-preview2",
  "jobID": "071b135e-9faf-4ff7-b113-a3f25bb0f468",
  "jobStatus": "running",
  "jobResult": "pending",
  "jobStart": "2022-08-18T16:35:56.5917185Z",
  "jobEnd": "0001-01-01T00:00:00",
  "errors": []
}

Id úlohy pak můžete použít prostřednictvím rozhraní API pro konfiguraci stavu ke kontrole stavu vaší žádosti.

Závislosti

Některé prostředky mají závislosti na vytvoření jiného prostředku jako předpokladu. V této situaci používáme vlastnost resourceName ve stejné datové části k označení závislosti prostředku produktu v prostředku plánu při vytváření obou ve stejném požadavku.

Název_prostředku se používá pouze k identifikaci jednotlivých prostředků v rámci nakonfigurované žádosti, kterou provádíte. Hodnota nebude součástí dat prostředků, neukládá se ani není vystavená zákazníkům. Pokud v rámci požadavku konfigurace dojde k nějakým chybám, použije se "resourceName" k vyvolání prostředku, do kterého chyba patří.

Ukázkový požadavek:

V tomto příkladu musí být produkt vytvořen před plánem, a proto se použije vlastnost "resourceName". Vytvořený produkt myNewProduct bude hodnota použitá pro resourceName a odkazovaná v rámci závislého zdroje plánu.

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-03-01-preview2

            {
              "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-03-01-preview2"
              "resources": [
              {
                "$schema": "https://schema.mp.microsoft.com/schema/product/2022-03-01-preview3", 
                "resourceName": "myNewProduct", 
                "alias": "Contoso Image Resizing Service",
                ...
              }, 
              {
                "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-03-01-preview2", 
                "alias": " Gold - Annual payment",
                "product": {"resourceName": "myNewProduct"}
                  ...
              }, 
              }]
            }

Zdroj odeslání

Pokud publikujete ve verzi Preview nebo live, zahrňte do své žádosti prostředek odeslání, který obsahuje:

Vlastnost "product" označující, že se na produkt, který se aktualizuje, jak odkazuje jeho trvalé ID, nebo externí ID
Vlastnost targetType označující cílové prostředí

Při publikování do živého vysílání se jedná o ID odeslání verze Preview, které chcete publikovat:

              {
                "$schema": "https://schema.mp.microsoft.com/schema/submission/2022-03-01-preview2",
                "id": "submission/12345678-abcd-efgh-1234-12345678901/11521167929065",    
                "product": "product/12345678-abcd-efgh-1234-12345678901", 
                "target": { "targetType": "live" }
              }

Poznámka:

Pokud zdroj odeslání nezahrnete, změny se projeví jenom ve stavu konceptu.

Publikování ve verzi Preview

Komerční typy produktů podporují prostředí ve verzi Preview a každá aktualizace musí být před zahájením provozu nejprve publikovaná ve verzi Preview. Nemůžete publikovat přímo do živého prostředí.

Důležité

Výjimkou je, když provádíte změny privátní cílové skupiny vašich plánů. Při synchronizaci aktualizací s privátní cílovou skupinou se tyto změny rozšíří na verzi Preview i živě najednou.

Prostředky můžete publikovat ve verzi Preview dvěma způsoby. Pokud je potřeba provést nějaké změny v odeslání verze Preview, proveďte další požadavek GET, proveďte potřebné změny a změny nasdílejte znovu. Při počátečních změnách nemusíte napřed pokračovat.

Metoda 1: Publikování všech konceptů prostředků

Pokud chcete publikovat všechny provedené změny konceptu, můžete odeslat žádost o konfiguraci s prostředkem odeslání, který nastaví prostředí Preview na "targetType". Jak je znázorněno v následujícím příkladu, nemusíte explicitně zadávat všechny prostředky, které vyžadují aktualizaci, protože tato metoda publikuje všechny změny v cílovém prostředí, což v tomto případě je ve verzi Preview. Stačí zadat pouze koncový bod rozhraní API a prostředek odeslání.

Ukázkový požadavek:

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-03-01-preview2

            {
              "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-03-01-preview2"
              "resources": [
              {
            // Below is the submission resource to publish to preview
                "$schema": "https://schema.mp.microsoft.com/schema/submission/2022-03-01-preview2",
                "product": "product/12345678-abcd-efgh-1234-12345678901", // This is the product durable ID
                "target": { "targetType": "preview" }
              }
              ]
            }

Metoda 2: Publikování konkrétních konceptů zdrojů (označovaných také jako modulární publikování)

Případně pokud nejste připravení publikovat všechny koncepty změn v různých prostředcích, stačí poskytnout prostředky, které chcete publikovat, společně s prostředkem pro odeslání, aby se aktivovalo modulární publikování. Tento přístup můžete použít také k provádění změn prostředků a jejich publikování ve stejnou dobu místo jako součást hromadné aktualizace, jak je to provedeno prostřednictvím metody 1. U modulárního publikování se vyžadují všechny prostředky s výjimkou podrobností na úrovni produktu (například výpis, dostupnost, balíčky, prodejce), které platí pro váš typ produktu.

Ukázkový požadavek:

V tomto příkladu jsou prostředky v produktu explicitně poskytovány jako součást modulárního publikování následované zdrojem odeslání.

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-03-01-preview2

            {
              "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-03-01-preview2"
              "resources": [
              {
                "$schema": "https://schema.mp.microsoft.com/schema/product/2022-03-01-preview2", 
                "id": "product/12345678-abcd-efgh-1234-12345678901",
                ...
              },
              {
                "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-03-01-preview2", 
                  ...
              }, 
              // additional resources
              {
                  ...
              },
              // Below is the submission resource to publish to preview
              {
                "$schema": "https://schema.mp.microsoft.com/schema/submission/2022-03-01-preview2",
                "product": "product/12345678-abcd-efgh-1234-12345678901", // This is the product durable ID
                "target": { "targetType": "preview" }
              }
              ]
            }

Publikování do živého prostředí

Po otestování a ověření změn ve verzi Preview můžete změny odeslat do provozu odesláním požadavku s ID odeslání verze Preview a typem targetType nastaveným na "live". Pokud chcete najít ID odeslání verze Preview, které se má začlenit do vaší nakonfigurované žádosti, přečtěte si téma Dotazování na odeslání.

Důležité

Na rozdíl od publikování ve verzi Preview není možné při publikování v reálném prostředí provádět modulární publikování. Proto je důležité před zahájením změn ověřit odeslání náhledu.

Ukázkový požadavek:

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-03-01-preview2

            {
              "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-03-01-preview2"
              "resources": [
              // Below is the submission resource, including the preview submission id, to publish to live.
              {
                "$schema": "https://schema.mp.microsoft.com/schema/submission/2022-03-01-preview2",
                "id": "submission/12345678-abcd-efgh-1234-12345678901/11521167929065",    
                "product": "product/12345678-abcd-efgh-1234-12345678901", // This is the product durable ID
                "target": { "targetType": "live" }
              }
              ]
            }

Kontrola stavu žádosti

Bez ohledu na prostředky, které jsou součástí vaší žádosti o konfiguraci nebo provedené změny, dostanete objekt stavu konfigurace zpět v odpovědi krátce po odeslání požadavku po úspěšném zpracování. Id úlohy je důležité, protože ho můžete později použít ke kontrole stavu požadavku.

Schema: <https://schema.mp.microsoft.com/schema/configure-status/2022-03-01-preview2>

Ukázková odpověď na odeslanou žádost:

            {
                "$schema": "https://schema.mp.microsoft.com/schema/configure-status/2022-03-01-preview2",
                "jobID": "d4261631-c583-4949-a612-5150882632e9",
                "jobStatus": "notStarted",
                "jobResult": "pending",
                "jobStart": "2022-03-01T13:32:43.123456Z",
                "jobEnd": "0001-01-01T00:00:00",
                "errors": []
            }

Stav čekající žádosti

Stav můžete načíst, dokud se úloha nedokončí, pomocí následujícího volání a zadáním "id úlohy" požadavku. Objekt může také obsahovat seznam chyb, pokud došlo k problémům s vaším požadavkem.

GET https://graph.microsoft.com/rp/product-ingestion/configure/<jobID>/status?$version=2022-03-01-preview2

Mějte na paměti, že doba dokončení se může lišit v závislosti na složitosti vaší žádosti.

Souhrn dokončené žádosti

Jakmile je úloha konfigurace žádosti dokončena, buď úspěšně, nebo s chybou, můžete získat seznam prostředků vytvořených nebo aktualizovaných pomocí id úlohy.

Poznámka:

Pokud toto volání provedete před dokončením úlohy, selže. Kromě toho vrátí pouze prostředky, které byly úspěšně dokončeny, nebo v případě zrušení pouze ty, které byly dokončeny před zrušením.

Schema: <https://schema.mp.microsoft.com/schema/configure-detail/2022-03-01-preview2>

GET https://graph.microsoft.com/rp/product-ingestion/configure/<jobID>?$version=2022-03-01-preview2

Ukázkový požadavek:

V následujícím příkladu se požadavek GET používá k načtení souhrnných podrobností o konfiguraci požadavku použitého v předchozím příkladu, který vytvořil nový produkt SaaS. Odpověď je objekt s podrobnostmi konfigurace s polem prostředků obsahujícím prostředek produktu, který byl vytvořen spolu s jeho trvalým ID.

GET https://graph.microsoft.com/rp/product-ingestion/configure/071b135e-9faf-4ff7-b113-a3f25bb0f468?$version=2022-03-01-preview2

Ukázková odpověď:

            {
"$schema": "https://schema.mp.microsoft.com/schema/configure-detail/2022-03-01-preview2",
"resources": [
{ 
                "$schema": "https://schema.mp.microsoft.com/schema/product/2022-03-01-preview2",
                "id": "product/12345678-abcd-efgh-1234-12345678901",
                "identity": {
                  "externalID": "ds-contoso-image-resize-demo "
                },
                "type": "softwareAsAService",
                "alias": "Contoso Image Resizing Service"
              }
]
}

Zrušení žádosti o konfiguraci

Před dokončením úlohy se můžete pokusit ji v případě potřeby zrušit. U dlouhotrvajících požadavků, jako je publikování ve verzi Preview nebo live, může být žádost o zrušení zamítnuta, pokud je úloha dostatečně daleko při úplném zpracování.

Pokud chcete zrušit úlohu, proveďte volání POST do koncového bodu zrušení a zadejte ID úlohy požadavku, který chcete zrušit.

POST https://graph.microsoft.com/rp/product-ingestion/configure<jobID>/cancel?$version=2022-03-01-preview2

Ukázkový požadavek:

POST <https://graph.microsoft.com/rp/product-ingestion/configure/d4261631-c583-4949-a612-5150882632e9/cancel?$version=2022-03-01-preview2>

Ukázková odpověď úspěšné žádosti o zrušení:

            {
                "$schema": "https://schema.mp.microsoft.com/schema/configure-status/2022-03-01-preview2",
                "jobID": "d4261631-c583-4949-a612-5150882632e9",
                "jobStatus": "completed",
                "jobResult": "cancelled",
                "jobStart": "2022-03-01-T13:32:43.123456Z",
                "jobEnd": "2022-03-01T17:34:21.5225132Z",
                "errors": []
            }

Ukázková odpověď v případě, že zrušení není povolené: HTTP Status code: 400

Obsah:

            {
              "error": {
                "code": "badRequest",
                "message": "Cannot cancel job, job has already completed.",
                "details": []
              }
}

Důležité

Nezapomeňte, že zrušení platí jenom pro prostředky, které ještě nebyly zpracovány. Některé prostředky už možná dokončily zpracování a budou odrážet nejnovější aktualizace konfigurace bez ohledu na zrušení požadavku.

Můžete načíst souhrn žádosti o konfiguraci po zrušení a ověřit, které prostředky (pokud nějaké) už byly před zrušením zpracovány.

Synchronizace privátních cílových skupin

U živého produktu je možné aktualizace soukromých cílových skupin v konceptech, náhledu a živých prostředích provádět současně bez nutnosti publikování. Privátní cílovou skupinu můžete synchronizovat pomocí prostředku "price-and-availability-update-private-audiences" zadáním cílových skupin, které chcete přidat nebo odebrat z konkrétního plánu. Tím se synchronizují koncepty, verze Preview a živá prostředí, aby měly stejné hodnoty privátní cílové skupiny. Při synchronizaci privátní cílové skupiny nemusíte zadávat prostředek odeslání.

Pokud chcete upravit koncepty cílových skupin, použijte prostředek price-and-availability-plan a vlastnost privateAudiences. Bude potřeba projít běžným tokem publikování, aby se hodnoty nastavily ve verzi Preview a živě.

Důležité

Pokud váš produkt podporuje více než jeden typ identifikátoru pro konfiguraci privátní cílové skupiny (například ID tenanta i ID předplatného), musíte provést úplné publikování, pokud poprvé zadáte nový typ identifikátoru. V tomto případě nemůžete synchronizovat privátní cílovou skupinu. Ukázkový požadavek na synchronizaci konfigurace privátní cílové skupiny:

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-03-01-preview2

        {
          "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-03-01-preview2"
          "resources": [
          {
            "$schema": "https://schema.mp.microsoft.com/schema/price-and-availability-update-private-audiences/2022-03-01-preview2",
            "product": "product/12345678-abcd-efgh-1234-12345678901", // product durable ID
            "plan": "plan/12345678-abcd-efgh-1234-12345678901/7e70b11f-809e-4c45-ae2f-1fb3ceaca33b", //plan durable ID 
            "privateAudiences":
            {
              "add ":
              [
                  {
            "type": "tenant",
                    "id": "4c2bdcdc-f10e-468d-8a2a-0832e089215b",
                    "label": "test 1"
                  }
              ],
              "remove ":
              [
                {
            "type": "subscription",
                    "id": "412c45bf-c99a-4e96-b683-77b0aa2dd09e",
                    "label": "test 2"
                }
              ]
            }
          }
          ]
        }

Konfigurace správy potenciálních zákazníků

Připojte svůj systém pro správu vztahů se zákazníky (CRM) s produktem komerčního marketplace, abyste mohli dostávat kontaktní informace zákazníků, když zákazník vyjadřuje zájem nebo nasadí váš produkt. Toto připojení můžete kdykoli změnit během vytváření produktu nebo po jeho vytvoření. Další informace najdete v tématu Získání potenciálních zákazníků.

Ukázkový požadavek na konfiguraci správy potenciálních zájemců:

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-03-01-preview2

        {
          "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-03-01-preview2"
          "resources": [
            {
            "$schema": "https://schema.mp.microsoft.com/schema/customer-leads/2022-03-01-preview3",
            "id": "customer-leads/a0c6484f-b4fb-4129-ac6b-35f2b5628089",
            "product": "product/a0c6484f-b4fb-4129-ac6b-35f2b5628089",
            "leadDestination": "httpsEndpoint",
            "httpsEndpointLeadConfiguration": {
              "httpsEndpointUrl": "https://www.your-crm.com/triggers/invoke"
            }
          }  
          ]
        }

Stavy životního cyklu prostředků

Existují různé akce, které můžete provést namapovat na stav životního cyklu prostředku. Ne všechny prostředky mají stav životního cyklu a ne všechny stavy životního cyklu jsou podporovány všemi prostředky. Pokud chcete zjistit, jestli má prostředek stav životního cyklu a jaké hodnoty jsou podporovány, můžete zkontrolovat schéma prostředků existence vlastnosti "lifecycleState". Níže jsou podrobně popsány různé podporované stavy životního cyklu.

Odstraněné

Konkrétní prostředky můžete odstranit tak, že vlastnost lifecycleState aktualizujete na "odstraněno". Můžete odstranit jenom koncepty prostředků, které ještě nebyly publikovány. Tuto akci nelze vrátit zpět.

Ukázkový požadavek:

V následujícím příkladu se odstraní základní plán konceptu.

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-03-01-preview2

        {
          "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-03-01-preview2"
          "resources": [
            {
            "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-03-01-preview2",
            "id": "plan/9f8af57f-ab07-461b-8404-50e10e5e80fb/7e70b11f-809e-4c45-ae2f-1fb3ceaca33b",
            "product": "product/9f8af57f-ab07-461b-8404-50e10e5e80fb",
            "identity": { "externalID": "basic" },
            "alias": "basic plan"
            "lifecycleState": "deleted"
            }
          ]
        }

Zastaralé

Vyřazení odebere prostředek z komerčního marketplace. Pokud chcete přestat používat, nastavte vlastnost lifecycleState na zastaralé prostředky, které ji podporují. Existují různé úrovně vyřazení. Všechny typy produktů podporují vyřazení celého produktu a individuálních plánů v rámci tohoto produktu. Pokud chcete později obnovit zastaralý prostředek, přečtěte si stav životního cyklu "obecně k dispozici".

Ukázkový požadavek na vyřazení produktu:

V následujícím příkladu je živé odeslání produktu nastavené na vyřazení. Po použití této změny se automaticky publikuje, aby se projevila.

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-03-01-preview2

            {
              "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-03-01-preview2"
              "resources": [
                {
                "$schema": "https://schema.mp.microsoft.com/schema/submission/2022-03-01-preview2 ",
                "id": "submission/9f8af57f-ab07-461b-8404-50e10e5e80fb/1152921515689848683",
                "product": "product/9f8af57f-ab07-461b-8404-50e10e5e80fb",
                "target": {
                    "targetType": "live"
                  },
                "lifecycleState": "deprecated"
                }
              ]
            }

Při vyřazení plánů je nutné změnit vlastnost "lifecycleState" na "zastaralé" a změny se pak musí publikovat ve verzi Preview, aby se vyřazení projevilo. Liší se od vyřazení na úrovni produktu, ve kterém se vyřazení automaticky nakonfiguruje v živém prostředí.

Ukázkový požadavek na vyřazení plánu:

V následujícím příkladu je plán v rámci produktu SaaS nastavený na vyřazení. Nezapomeňte, že pokud chcete tuto změnu použít, můžete později publikovat pomocí prostředku pro odeslání.

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-03-01-preview2

            {
              "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-03-01-preview2"
              "resources": [
                {
                "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-03-01-preview2 ",
                "id": "plan/9f8af57f-ab07-461b-8404-50e10e5e80fb/7e70b11f-809e-4c45-ae2f-1fb3ceaca33b",
                "product": "product/9f8af57f-ab07-461b-8404-50e10e5e80fb",
                "identity": { "externalID": "basic" },
                "alias": "basic plan"
                "lifecycleState": "deprecated"
                }
              ]
            }

Existují další formy vyřazení, které se liší v závislosti na typu produktu. Přečtěte si další informace o vyřazení SaaS, virtuálních počítačů a kontejnerů.

Obecně dostupné

generallyAvailable je výchozí stav životního cyklu pro všechny prostředky. Jakmile je prostředek zastaralý, můžete ho obnovit tak, že změníte vlastnost lifecycleState zpět na "generallyAvailable". Pokud chcete obnovit zastaralý produkt, musíte ho publikovat do náhledu a pak živě. Příklady pro SaaS, virtuální počítače a kontejnery najdete v příslušných článcích.

Ukázkový požadavek na obnovení plánu:

V následujícím příkladu je plán určený k obnovení. Pokud chcete tuto změnu použít, budete později muset publikovat veškerý způsob, jak žít pomocí prostředku odeslání.

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-03-01-preview2

            {
              "$schema": "https://schema.mp.microsoft.com/schema/configure/2022-03-01-preview2"
              "resources": [
                {
                "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-03-01-preview2 ",
                "id": "plan/9f8af57f-ab07-461b-8404-50e10e5e80fb/7e70b11f-809e-4c45-ae2f-1fb3ceaca33b",
                "product": "product/9f8af57f-ab07-461b-8404-50e10e5e80fb",
                "identity": { "externalID": "basic" },
                "alias": "basic plan"
                "lifecycleState": "generallyAvailable"
                }
              ]
            }

Referenční informace k rozhraní API prostředků

Následující verze schématu platí jenom pro verzi Preview a změní se, jakmile bude rozhraní API obecně dostupné.

Poznámka:

Existující dostupné prostředky a jejich verze můžete zobrazit tady: resources-index

Typ prostředku	Popis	Schéma
nastavení komerčního marketplace	Popisuje transakční konfiguraci produktů na komerčním marketplace.	https://schema.mp.microsoft.com/schema/commercial-marketplace-setup/2022-03-01-preview2
potenciální zákazníci	Umožňuje připojení k systému CRM pro příjem potenciálních zákazníků.	https://schema.mp.microsoft.com/schema/customer-leads/2022-03-01-preview3
soupis	To zahrnuje popisy vašeho produktu, které se zobrazí v obchodech komerčního marketplace Microsoftu.	https://schema.mp.microsoft.com/schema/listing/2022-03-01-preview5
výpis majetku	Snímky obrazovky a marketingové prostředky propojené s prostředkem výpisu	https://schema.mp.microsoft.com/schema/listing-asset/2022-03-01-preview5
výpis přívěsu	Video assety propojené s prostředkem výpisu	https://schema.mp.microsoft.com/schema/listing-trailer/2022-03-01-preview5
integrace Microsoft365	Povolení a výběr typů Microsoftu 365	https://schema.mp.microsoft.com/schema/microsoft365-integration/2022-03-01-preview2
plán	Chcete-li vytvořit plány, na které se pak odkazuje prostředky na úrovni plánu, které nakonfigurujete, jako je například výpis plánu.	https://schema.mp.microsoft.com/schema/plan/2022-03-01-preview2
plan-listing	Definujte název a popis plánu tak, jak chcete, aby se zobrazovaly na komerčním marketplace.	https://schema.mp.microsoft.com/schema/plan-listing/2022-03-01-preview5
price-and-availability-custom-meter	Definujte vlastní měřiče sdílené napříč vašimi plány.	https://schema.mp.microsoft.com/schema/price-and-availability-custom-meter/2022-03-01-preview3
nabídka cen a dostupnosti	Před publikováním produktu definujte omezenou cílovou skupinu, která může produkt zkontrolovat.	https://schema.mp.microsoft.com/schema/price-and-availability-offer/2022-03-01-preview3
price-and-availability-plan	Nakonfigurujte trhy, ve které je tento plán dostupný, v požadovaném modelu zpeněžení, cenách a fakturačních podmínkách.	https://schema.mp.microsoft.com/schema/price-and-availability-plan/2022-03-01-preview4
price-and-availability-update-private-audiences	Aktualizace soukromých cílových skupin v konceptech, verzi Preview a živých prostředích je možné provádět současně bez nutnosti publikování.	https://schema.mp.microsoft.com/schema/price-and-availability-update-private-audiences/2022-03-01-preview3
private-and-availability-private-offer-plan	Slouží ke konfiguraci absolutních cenových podrobností o cenách produktů/plánů používaných v rámci privátní nabídky.	https://schema.mp.microsoft.com/schema/price-and-availability-private-offer-plan/2022-07-01
soukromá nabídka	Definuje název a typ privátní nabídky s podmínkami a podrobnostmi nabídky spolu s zahrnutými produkty/plánem a jejich cenami.	https://schema.mp.microsoft.com/schema/private-offer/2022-07-01
výrobek	Toto je hlavní prostředek, definuje název a typ produktu, všechny prostředky na to odkazují.	https://schema.mp.microsoft.com/schema/product/2022-03-01-preview3
vlastnost	Definujte kategorie a odvětví, které se vztahují na vaši nabídku, verzi vaší aplikace a právní smlouvy.	https://schema.mp.microsoft.com/schema/property/2022-03-01-preview5
distributor	Nakonfigurujte partnery v programu Cloud Solution Provider (CSP), pro který chcete produkt zpřístupnit.	https://schema.mp.microsoft.com/schema/reseller/2022-03-01-preview2
strom prostředků	Popisuje seznam prostředků pro daný produkt v aktuálním stavu pro zadané cílové prostředí.	https://schema.mp.microsoft.com/schema/resource-tree/2022-03-01-preview2
software jako služba – technická konfigurace	Technické podrobnosti, které pomáhají komerčnímu marketplace Microsoftu připojit se k vašemu řešení	https://schema.mp.microsoft.com/schema/software-as-a-service-technical-configuration/2022-03-01-preview3
podání	Můžete použít k aktivaci různých akcí u vašeho produktu a k označení stavu publikování vašeho produktu nechtěných prostředí (koncept, náhled a živé).	https://schema.mp.microsoft.com/schema/submission/2022-03-01-preview2
virtual-machine-plan-technical-configuration	Technické podrobnosti popisující virtuální počítač a umístění image	https://schema.mp.microsoft.com/schema/virtual-machine-plan-technical-configuration/2022-03-01-preview3
container-plan-technical-configuration	Technické podrobnosti popisující vlastnosti image kontejneru	https://schema.mp.microsoft.com/schema/container-plan-technical-configuration/2022-03-01-preview3

Doprovodné materiály k rozhraní API pro jednotlivé typy produktů

Rozhraní API pro příjem dat produktů bude v budoucnu dostupné pro jiné typy produktů. Vzhledem k tomu, že se podporuje více typů produktů, budou k dispozici další pokyny specifické pro jednotlivé typy produktů.

Typ produktu	Zdroje specifické pro typ produktu
Soukromé nabídky	Vytváření a správa privátních nabídek prostřednictvím rozhraní API pro příjem dat produktů
SaaS	Vytváření a správa nabídek SaaS prostřednictvím rozhraní API pro příjem dat produktů
Virtual Machines	Vytváření a správa nabídek virtuálních počítačů prostřednictvím rozhraní API pro příjem dat produktů
Kontejnery	Vytváření a správa nabídek kontejnerů prostřednictvím rozhraní API pro příjem dat produktů

Verze a aktualizace rozhraní API

Aktualizace	Co se změnilo?
12-2024	Všechny koncové body schématu byly aktualizovány z product-ingestion.azureedge.net na schema.mp.microsoft.com
12-2022	K dispozici je nová verze schématu 2022-03-01-preview3 rozhraní API pro příjem dat pro zákazníky, která při konfiguraci potenciálních zákazníků přijímá ID klienta a clientSecret a přestane zachytávat pole ID serveru a kontaktních e-mailových polí. Přejděte na novou verzi a zadejte ID klienta a clientSecret a pokračujte v konfiguraci konektoru Marketo pro nabídky marketplace. Nová adresa URL schématu: `https://schema.mp.microsoft.com/schema/customer-leads/2022-03-01-preview3`
09-2022	Podpora verze Preview kontejneru je vydaná ve verzi 2022-03-01-preview4.
08-2022	Podpora verze Preview softwaru jako služby je vydána ve verzi 2022-03-01-preview3
08-2022	Veřejná verze privátní nabídky ve verzi 2022-07-01
05-2022	Podpora verze Preview virtuálního počítače je vydaná ve verzi 2022-03-01-preview2

Sdílet prostřednictvím

Rozhraní API pro příjem dat produktů pro virtuální počítače

Začínáme

Koncepty

Zdroje informací

Trvalé ID

Externí ID

Metody rozhraní API

Typický pracovní postup

Načtení existujících konfigurací prostředků

Metoda 1: Strom prostředků

Metoda 2: Durable ID

Metoda 3: Parametry řetězce dotazu

Dotazování na odeslání

Vytváření nových produktů a prostředků

Úprava existujících produktů a prostředků

Požadavky na konfiguraci

Odkazy na prostředky a závislosti

Reference

Závislosti

Zdroj odeslání

Publikování ve verzi Preview

Metoda 1: Publikování všech konceptů prostředků

Metoda 2: Publikování konkrétních konceptů zdrojů (označovaných také jako modulární publikování)

Publikování do živého prostředí

Kontrola stavu žádosti

Stav čekající žádosti

Souhrn dokončené žádosti

Zrušení žádosti o konfiguraci

Synchronizace privátních cílových skupin

Konfigurace správy potenciálních zákazníků

Stavy životního cyklu prostředků

Odstraněné

Zastaralé

Obecně dostupné

Referenční informace k rozhraní API prostředků

Doprovodné materiály k rozhraní API pro jednotlivé typy produktů

Verze a aktualizace rozhraní API

Váš názor

Další materiály

Sdílet prostřednictvím

Rozhraní API pro příjem dat produktů pro virtuální počítače

Začínáme

Koncepty

Zdroje informací

Trvalé ID

Externí ID

Metody rozhraní API

Typický pracovní postup

Načtení existujících konfigurací prostředků

Metoda 1: Strom prostředků

Metoda 2: Durable ID

Metoda 3: Parametry řetězce dotazu

Dotazování na odeslání

Vytváření nových produktů a prostředků

Úprava existujících produktů a prostředků

Požadavky na konfiguraci

Odkazy na prostředky a závislosti

Reference

Závislosti

Zdroj odeslání

Publikování ve verzi Preview

Metoda 1: Publikování všech konceptů prostředků

Metoda 2: Publikování konkrétních konceptů zdrojů (označovaných také jako modulární publikování)

Publikování do živého prostředí

Kontrola stavu žádosti

Stav čekající žádosti

Souhrn dokončené žádosti

Zrušení žádosti o konfiguraci

Synchronizace privátních cílových skupin

Konfigurace správy potenciálních zákazníků

Stavy životního cyklu prostředků

Odstraněné

Zastaralé

Obecně dostupné

Referenční informace k rozhraní API prostředků

Doprovodné materiály k rozhraní API pro jednotlivé typy produktů

Verze a aktualizace rozhraní API

Související obsah

Váš názor

Další materiály