Periksa inventarisasi berdasarkan jenis sumber daya menggunakan API Pusat Mitra

Cara memeriksa inventori untuk item katalog yang difilter oleh jenis sumber daya tertentu.

Prasyarat

  • Detail login sebagaimana dijelaskan pada autentikasi Partner Center. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.

  • Satu atau beberapa ID produk. Secara opsional, ID SKU juga dapat ditentukan.

  • Nilai yang valid resourceType (diperlukan). Lihat Jenis sumber daya yang didukung untuk daftar lengkap nilai yang diterima.

  • Konteks tambahan apa pun yang diperlukan untuk memverifikasi inventarisasi SKU yang dirujuk oleh ID produk/SKU yang disediakan. Persyaratan ini dapat bervariasi menurut jenis produk/SKU dan dapat ditentukan dari properti InventoryVariablesSKU.

Permintaan layanan REST

Sintaksis permintaan

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

URI Parameter

Gunakan parameter kueri berikut untuk memeriksa inventori menurut jenis sumber daya.

Name Type Required Description
kode negara string Yes ID negara/wilayah.
resourceTypeValue string Yes Jenis sumber daya untuk memfilter hasil inventori. Lihat Jenis sumber daya yang didukung untuk nilai yang valid.

Jenis sumber daya yang didukung

Nilai jenis sumber daya Description
AppService App Service
Avs Azure VMware Solution
AzureDataExplorer Azure Data Explorer
AzureFiles Azure Files
Backup Azure Backup
BlockBlob Blokir Blob Storage
CopilotCredit Kredit Copilot
CosmosDb Azure Cosmos DB
Databricks Azure Databricks
DataFactory Azure Data Factory
Tuan Rumah Khusus Azure Dedicated Host
FabricCapacity Kapasitas Microsoft Fabric
FoundryAgent Foundry Agen
ManagedDisk Azure Disk Terkelola
MariaDB Azure Database for MariaDB
MDC Microsoft Defender untuk Cloud
MySql Azure Database for MySQL
Nutanix Nutanix
OpenAIPTU Azure OpenAI PTU
PostgreSQL Azure Database for PostgreSQL
RedHat Red Hat
RedHatOsa Red Hat OpenShift di Azure
RedisCache Azure Cache for Redis
SapHana SAP Hana di Azure
Sentinel Microsoft Sentinel
Database SQL Azure SQL Database
Gudang Data Sql Azure SQL Data Warehouse
SuseLinux Linux SUSE
Synapse Azure Synapse Analytics
Mesin Virtual Azure Virtual Machines
VMwareCloudSimple VMware CloudSimple

Tajuk permintaan

Untuk informasi selengkapnya, lihat REST header di Partner Center.

Badan permintaan

Detail permintaan inventori, yang terdiri dari sumber daya InventoryCheckRequest yang berisi satu atau beberapa sumber daya InventoryItem .

Pastikan Langganan Azure yang ditentukan dalam isi permintaan terdaftar dan diaktifkan untuk membeli Azure RI. Lihat Mendaftarkan Langganan untuk detail tentang proses pendaftaran.

Permintaan contoh

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"}}

Respons terhadap REST

Jika berhasil, isi respons berisi kumpulan objek InventoryItem yang diisi dengan detail pembatasan, jika ada yang berlaku.

Note

Jika InventoryItem input mewakili item yang tidak dapat ditemukan dalam katalog, atau tidak sesuai dengan jenis sumber daya yang ditentukan, itu tidak akan disertakan dalam koleksi output.

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan tambahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter tambahan. Untuk daftar lengkapnya, silakan lihat kode kesalahan di Partner Center.

Contoh tanggapan

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": []
    }
]

Produk tidak dikembalikan sebagai respons

Jika produk atau SKU tersedia untuk langganan dan wilayah yang ditentukan tetapi tunduk pada pembatasan, respons mencakup produk dengan isRestricted: true dan detail pembatasan yang berlaku.

Jika produk tidak tersedia untuk langganan dan wilayah yang ditentukan, respons akan menghilangkan produk sepenuhnya.

Important

Perlakukan produk yang hilang dari respons sebagai tidak tersedia hanya untuk langganan dan wilayah yang ditentukan.

Scenario Respons CheckInventoryByResourceType
Produk tidak tersedia untuk langganan/wilayah Produk dihilangkan dari respons
SKU tersedia isRestricted: false
SKU dibatasi di wilayah ini Dikembalikan dengan isRestricted: true

Konten terkait

  • Last updated on