API de ingesta de productos para contenedores procesables
La API de ingesta de productos es una API modernizada que unifica todas las API de envío existentes en todos los productos de Marketplace comercial. Consulte Api de ingesta de productos para obtener más información sobre cómo empezar.
En este artículo se proporcionan instrucciones sobre cómo usar las API específicamente para contenedores.
Recuperar las configuraciones de recursos existentes
Recupere todos los recursos de un producto específico en una sola llamada API.
GET resource-tree/<product-durableID>?$version=<schema-version>
Puede recuperar todas las configuraciones de recursos dentro de un producto específico mediante el tipo de recurso "árbol de recursos" junto con el identificador duradero del producto. La versión de esquema que proporcione se usa como la versión máxima admitida para cada uno de los recursos aplicables del producto solicitado.
Nota:
Si no conoce el identificador duradero del producto, puede recuperar primero el recurso del producto mediante el identificador externo del producto en su lugar y ejecutándose. Para más información, consulte Api de producto: método 1: árbol de recursos.
Llamada GET de ejemplo:
Respuesta de ejemplo:
{
"$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.
{
...
}]
}
Sincronización de audiencias privadas
En el caso de un producto activo, las actualizaciones de audiencias privadas en los entornos de borrador, versión preliminar y en directo se pueden realizar al mismo tiempo sin necesidad de publicar. Puede sincronizar la audiencia privada mediante el recurso "price-and-availability-update-private-audiences" especificando qué audiencias desea agregar o quitar de un plan específico. Esto sincronizará los entornos de borrador, versión preliminar y activo para tener los mismos valores de audiencia privada. No es necesario proporcionar el recurso de envío al sincronizar la audiencia privada.
Para editar los borradores de audiencias, use el recurso "price-and-availability-plan" y la propiedad "privateAudiences". Tendrá que pasar por el flujo de publicación normal para que los valores se establezcan en versión preliminar y dinámica.
Importante
Si el producto admite más de un tipo de identificador para configurar la audiencia privada (por ejemplo, los identificadores de inquilino y los identificadores de suscripción), debe realizar una publicación completa si proporciona un nuevo tipo de identificador por primera vez. En este caso, no se puede sincronizar la audiencia privada.
Ejemplo de solicitud para sincronizar la configuración de audiencia privada:
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-preview3",
"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": " c0cab000-5c00-2ae9-acbe-f5f0bb264498 ",
"label": "test 1"
}
],
"remove ":
[
{
"type": "tenant",
"id": " d1cab000-6c06-4ae9-acbe-b5f0bb264498 ",
"label": "test 2"
}
]
}
}
]
}
Configurar propiedades
Defina las categorías y sectores aplicables al producto contenedor, la versión de la aplicación y los contratos legales. Asegúrese de proporcionar detalles completos y precisos sobre el producto en el recurso Propiedades, de modo que se muestre adecuadamente y se ofrezca al conjunto adecuado de clientes. Para más información, consulte Categorías de Appsource.
Propiedades de configuración del cuerpo de la solicitud de ejemplo:
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/property/2022-03-01-preview5",
"id": "property/a8b48be1-a630-41b5-b5a5-c2a9f7789922/public/main",
"product": "product/a8b48be1-a630-41b5-b5a5-c2a9f7789922",
"kind": "azureContainer",
"termsConditions": "standardMicrosoft",
"categories": {
"containers": [
"container-apps",
"container-images"
]
}
}
]
}
Configuración de la lista
La información que proporcione a través de la lista de recursos se muestra en las tiendas en línea de Marketplace comercial de Microsoft. Esto incluye las descripciones del producto, las capturas de pantalla y los recursos de marketing.
Ejemplo del cuerpo de la solicitud que configura la lista:
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/listing/2022-03-01-preview5",
"id": "listing/6d50c7bd-eb19-4d4c-b2f0-beb14aee084b/public/main/default/en-us",
"product": "product/6d50c7bd-eb19-4d4c-b2f0-beb14aee084b",
"kind": "azureContainer",
"title": "ContainerCM0815",
"description": "<div>This offer is in the early stages of development and not for general public consumption. Use is restricted to a limited audience, and has no commercial purpose beyond the testing for which it is intended.</div>",
"searchResultSummary": "Container product",
"shortDescription": "This offer is in the early stages of development and not for general public consumption",
"privacyPolicyLink": "https://www.company.com/privacy",
"generalLinks": [
{
"displayText": "Product link",
"link": "https://www.company.com/mkt",
}
],
"globalSupportWebsite": "https://testprivacyurl.com",
"governmentSupportWebsite": "https://testprivacyurl.com",
"supportContact": {
"name": "Support",
"email": "support@company.com",
"phone": "4255555555"
},
"engineeringContact": {
"name": "Engineering",
"email": "john@company.com",
"phone": "4255555555"
},
"cloudSolutionProviderContact": {
"name": "CSP",
"email": "csp@company.com",
"phone": "4255555555"
},
"languageID": "en-us"
},
{
"$schema": "https://schema.mp.microsoft.com/schema/listing-asset/2022-03-01-preview5",
"product": "product/6d50c7bd-eb19-4d4c-b2f0-beb14aee084b",
"kind": "azure",
"listing": "listing/6d50c7bd-eb19-4d4c-b2f0-beb14aee084b/public/main/default/en-us",
"type": "azureLogoScreenshot",
"languageID": "en-us",
"description": "Image caption",
"displayOrder": 0,
"fileName": "test.png",
"friendlyName": "test.png",
"url": "https://company.com/12345/test.png"
},
{
"$schema": "https://schema.mp.microsoft.com/schema/listing-asset/2022-03-01-preview5",
"product": "product/6d50c7bd-eb19-4d4c-b2f0-beb14aee084b",
"kind": "azure",
"listing": "listing/6d50c7bd-eb19-4d4c-b2f0-beb14aee084b/public/main/default/en-us",
"type": "azureLogoLarge",
"languageID": "en-us",
"description": "",
"displayOrder": 0,
"fileName": "216x216.png",
"friendlyName": "216x216.png",
"url": "https://company.com/12345/216x216.png"
},
{
"$schema": "https://schema.mp.microsoft.com/schema/listing-trailer/2022-03-01-preview5",
"product": "product/6d50c7bd-eb19-4d4c-b2f0-beb14aee084b",
"kind": "azure",
"listing": "listing/6d50c7bd-eb19-4d4c-b2f0-beb14aee084b/public/main/default/en-us",
"streamingUrl": "https://www.youtube.com/watch?v=123",
"assets": {
"en-us": {
"title": "Video",
"imageList": [
{
"url": "https://company.com/12345/trailer.png"
}
]
}
}
}
]
}
Configuración de la audiencia preliminar
Si el producto de contenedor vende a través de Microsoft Marketplace, debe definir una audiencia preliminar, a través de identificadores de suscripción, que pueden revisar la descripción del producto antes de que se publique.
Cuerpo de solicitud de ejemplo que configura la audiencia preliminar:
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-offer/2022-03-01-preview3",
"id": "price-and-availability-offer/a8b48be1-a630-41b5-b5a5-c2a9f7789922",
"product": "product/a8b48be1-a630-41b5-b5a5-c2a9f7789922",
"previewAudiences": [
{
"type": "subscription",
"id": "c2d12fa0-c012-33b0-b0a0-c0a0a0011222",
"label": "Test Subscription"
}
]
}
]
}
Configuración de un plan: configuración técnica
Proporcione un nombre de tipo de extensión de clúster con el formato "PublisherName.ApplicationName". El nombre debe ser único en todas las ofertas y planes. No se puede modificar este valor una vez publicado el plan en versión preliminar. Para más información, consulte Establecimiento de la configuración técnica del plan para una oferta de contenedor basada en aplicaciones de Kubernetes. Para más información, consulte Recursos técnicos de contenedor de Azure.
Cuerpo de solicitud de ejemplo que configura la configuración técnica procesable:
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/container-plan-technical-configuration/2022-03-01-preview3",
"id": "container-plan-technical-configuration/a8b48be1-a630-41b5-b5a5-c2a9f7789922",
"product": "product/a8b48be1-a630-41b5-b5a5-c2a9f7789922",
"plan": "plan/a8b48be1-a630-41b5-b5a5-c2a9f7789922/4db792e6-8e10-439d-9db2-a0e98fa7e174",
"payloadType": " cnab",
"clusterExtensionType": " unique.extension.type",
"cnabReferences": [
{
"tenantID": "421c00000-ac12-451e-b3ff-c5b469a13e2d",
"subscriptionID": "537d2130-be25-451e-b3ff-c5b469a13e2d",
"resourceGroupName": "TestResources",
"registryName": "testregistry",
"repositoryName": "containerrepo",
"tag": "1.0.4",
"digest": "sha256:000193bfefde1e9"
},
]
},
]
}
Configuración de un plan: precio y disponibilidad
Cuerpo de solicitud de ejemplo que configura un plan oculto:
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-plan/2022-03-01-preview4",
"product": "product/a8b48be1-a630-41b5-b5a5-c2a9f7789922",
"plan": "plan/a8b48be1-a630-41b5-b5a5-c2a9f7789922/0abbe45b-c405-4c08-bb14-ec485002084e",
"visibility": "hidden",
"audience": "public"
}
]
}
El contenedor ofrece compatibilidad con varias opciones de facturación. Para más información sobre los modelos de facturación admitidos, consulte Opciones de licencias.
Versiones y actualizaciones de API
| Actualizar | ¿Qué ha cambiado? |
|---|---|
| 1-2024 | Todos los puntos de conexión de esquema se han actualizado de product-ingestion.azureedge.net a schema.mp.microsoft.com |
Pasos siguientes
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente las Cuestiones de GitHub como mecanismo de retroalimentación para el contenido y lo sustituiremos por un nuevo sistema de retroalimentación. Para más información, consulta: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de