API för produktinmatning för containrar

Artikel
04/29/2024

API:et för produktinmatning är ett moderniserat API som förenar alla befintliga api:er för insändning i alla produkter på den kommersiella marknadsplatsen. Mer information om hur du kommer igång finns i API för produktinmatning.

Den här artikeln innehåller vägledning om hur du använder API:erna specifikt för containrar.

Hämta befintliga resurskonfigurationer

Hämta alla resurser i en specifik produkt i ett enda API-anrop.

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

Du kan hämta alla resurskonfigurationer i en specifik produkt med resurstypen "resource-tree" tillsammans med produktens hållbara ID. Den schemaversion som du anger används som högsta möjliga version för var och en av de tillämpliga resurserna för den begärda produkten.

Kommentar

Om du inte känner till produktens varaktiga ID kan du hämta produktresursen först genom att använda produktens externa ID i stället och köra. Mer information finns i Produkt-API: Metod 1: resursträd.

Exempel på GET-anrop:

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

Exempelsvar:

{
  "$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": "product_external_id_example"
    },
    "type": "azureContainer",
    "alias": "product_example"
  },
  { 
    "$schema": "https://schema.mp.microsoft.com/schema/commercial-marketplace-setup/2022-03-01-preview2",
    "id": "commercial-marketplace-setup/12345678-abcd-efgh-1234-12345678901",
    "product": "product/12345678-abcd-efgh-1234-12345678901",
    "sellThroughMicrosoft": true
  },
  {
    "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-03-01-preview2",
    "id": "plan/12345678-abcd-efgh-1234-12345678901/98756328-04e9-55ae-9403-52b6c971a956
  ...
  }, 
     // The response would include all existing resources within this product.
  {
     ...
  }]
}

Synkronisera privata målgrupper

För en liveprodukt kan uppdateringar till privata målgrupper i utkast-, förhandsversions- och livemiljöer utföras samtidigt utan att en publicering krävs. Du kan synkronisera den privata målgruppen med hjälp av resursen "price-and-availability-update-private-audiences" genom att ange vilka målgrupper du vill lägga till eller ta bort från en specifik plan. Detta synkroniserar utkast-, förhandsversions- och livemiljöerna så att de har samma privata målgruppsvärden. Du behöver inte ange den inskickade resursen när du synkroniserar den privata målgruppen.

Om du vill redigera utkastens målgrupper använder du resursen "price-and-availability-plan" och egenskapen "privateAudiences". Detta måste gå igenom det vanliga publiceringsflödet för att värdena ska anges i förhandsversion och live.

Viktigt!

Om din produkt stöder mer än en typ av identifierare för att konfigurera den privata målgruppen (till exempel både klient-ID:n och prenumerations-ID:n) måste du utföra en fullständig publicering om du anger en ny identifierartyp för första gången. Du kan inte synkronisera den privata målgruppen i det här fallet.

Exempelbegäran om att synkronisera konfigurationen av den privata målgruppen: