İş Ortağı Merkezi API'lerini kullanarak kaynak türüne göre envanteri denetleme

Belirli bir kaynak türüne göre filtrelenmiş katalog öğelerinin envanterini denetleme.

Prerequisites

  • Kimlik bilgileri, İş Ortağı Merkezi kimlik doğrulaması bölümünde açıklandığı gibidir. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

  • Bir veya daha fazla ürün kimlikleri. İsteğe bağlı olarak, SKU kimlikleri de belirtilebilir.

  • Geçerli resourceType bir değer (gerekli). Kabul edilen değerlerin tam listesi için bkz. Desteklenen kaynak türleri .

  • Sağlanan ürün/SKU kimliklerinde atıfta bulunulan SKU'ların envanterini doğrulamak için gerekli ek bağlam. Bu gereksinimler ürün/SKU türüne göre farklılık gösterebilir ve SKU'nunInventoryVariables özelliğinden belirlenebilir.

REST isteği

İstek söz dizimi

Method İstenilen URI
POST {baseURL}/v1/extensions/product/checkinventorybyresourcetype?country={country-code}&resourceType={resourceTypeValue} HTTP/1.1

URI parametreleri

Envanteri kaynak türüne göre denetlemek için aşağıdaki sorgu parametrelerini kullanın.

Name Türü Zorunlu Description
ülke kodu Dize Evet Ülke/bölge kimliği.
resourceTypeValue Dize Evet Stok sonuçlarını filtrelemek için kaynak türü. Geçerli değerler için desteklenen kaynak türleri bölümüne bakın.

Desteklenen kaynak türleri

Kaynak türü değeri Description
AppService App Service
Avs Azure VMware Çözümü
AzureDataExplorer Azure Veri Araştırıcısı
AzureFiles Azure Dosyalar
Backup Azure Backup
BlockBlob Blok Blob Depolama
CopilotCredit Copilot Kredisi
CosmosDb Azure Cosmos DB veritabanı
Databricks Azure Databricks
DataFactory Azure Data Factory
DedicatedHost Azure Özel Sunucu
Fabric Kapasitesi Microsoft Fabric Kapasitesi
FoundryAgent Döküm Aracı
ManagedDisk Azure Yönetilen Disk
MariaDB MariaDB için Azure Veritabanı
MDC Bulut için Microsoft Defender
MySql MySQL için Azure Veritabanı
Nutanix Nutanix
OpenAIPTU Azure OpenAI PTU
PostgreSql PostgreSQL için Azure Veritabanı
RedHat Red Hat
RedHatOsa Azure üzerinde Red Hat OpenShift
RedisCache Redis için Azure Cache
SapHana Azure'da SAP HANA
Sentinel Microsoft Sentinel
SqlDatabases Azure SQL veritabanları
SqlDataWarehouse Azure SQL Veri Ambarı
SuseLinux SUSE Linux
Synapse Azure Synapse Analytics
Sanal Makineler Azure Sanal Makineler
VMwareCloudSimple VMware CloudSimple

İstek başlıkları

Daha fazla bilgi için Partner Center REST başlıkları'na bakın.

İstek içeriği

Bir veya daha fazla InventoryItem kaynağı içeren bir InventoryCheckRequest kaynağından oluşan stok isteği ayrıntıları.

İstek gövdesinde belirtilen Azure Aboneliğinin kayıtlı olduğundan ve Azure RI satın almak için etkinleştirildiğinden emin olun. Kayıt işlemiyle ilgili ayrıntılar için bkz. Abonelik Kaydetme .

Örnek talep

POST https://api.partnercenter.microsoft.com/v1/extensions/product/checkinventorybyresourcetype?country=US&resourceType=VirtualMachines HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: d1b1981a-e088-4610-870a-eebec96d6bcd
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Type: application/json

{"TargetItems":[{"ProductId":"DZH318Z0BQ3P"}],"InventoryContext":{"customerId":"d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d","azureSubscriptionId":"3A231FBE-37FE-4410-93FD-730D3D5D4C75","armRegionName":"Europe"}}

REST yanıtı

Başarılı olursa, yanıt gövdesi, varsa geçerli kısıtlama ayrıntılarıyla doldurulmuş InventoryItem nesnelerinden oluşan bir koleksiyon içerir.

Note

InventoryItem girişi katalogda bulunamayan bir öğeyi temsil ederse veya belirtilen kaynak türüne karşılık gelmiyorsa, çıkış koleksiyonuna dahil edilmeyecektir.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. İş Ortağı Merkezi hata kodları.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 1021
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: d1b1981a-e088-4610-870a-eebec96d6bcd
X-Locale: en-US
[
    {
        "productId": "DZH318Z0BQ3P",
        "skuId": "0039",
        "isRestricted": true,
        "restrictions": [
            {
                "reasonCode": "NotAvailableForSubscription",
                "description": "Restriction identified of type 'Location' with values 'japanwest'.",
                "properties": {
                    "type": "Location",
                    "values": "japanwest"
                }
            }
        ]
    },
    {
        "productId": "DZH318Z0BQ3P",
        "skuId": "0038",
        "isRestricted": false,
        "restrictions": []
    }
]

Yanıt olarak iade edilmeyen ürünler

Belirtilen abonelik ve bölge için bir ürün veya SKU kullanılabiliyorsa ancak kısıtlamalara tabiyse, yanıt ürünü ve ilgili kısıtlama ayrıntılarını içerir isRestricted: true .

Belirtilen abonelik ve bölge için bir ürün mevcut değilse, yanıt ürünü tamamen hariç bırakır.

Important

Yanıtta eksik olan bir ürünü yalnızca belirtilen abonelik ve bölge için kullanılamıyor olarak değerlendirin.

Scenario CheckInventoryByResourceType yanıtı
Ürün abonelik/bölge için kullanılamıyor Yanıttan atlanmış ürün
Mevcut SKU isRestricted: false
SKU bu bölgede kısıtlıdır isRestricted: true ile birlikte döndürüldü

İlgili içerik

  • Last updated on