Sprawdzanie spisu według typu zasobu przy użyciu interfejsów API Centrum partnerskiego

Jak sprawdzić spis elementów wykazu filtrowanych według określonego typu zasobu.

Wymagania wstępne

  • Poświadczenia opisane w sekcji Uwierzytelnianie w Centrum partnerskim. Ten scenariusz wspiera autoryzację zarówno przy użyciu samodzielnych poświadczeń aplikacji, jak i połączenia poświadczeń aplikacji i użytkownika.

  • Co najmniej jeden identyfikator produktu. Opcjonalnie można również określić identyfikatory jednostek SKU.

  • Prawidłowa resourceType wartość (wymagana). Zobacz Obsługiwane typy zasobów , aby uzyskać pełną listę akceptowanych wartości.

  • Wszelkie dodatkowe informacje potrzebne do zweryfikowania stanów magazynowych jednostek SKU wskazanych przez podane identyfikatory produktu/SKU. Te wymagania mogą się różnić w zależności od typu produktu/jednostki SKU i można je określić na podstawie właściwości jednostki SKUInventoryVariables.

Żądanie REST

Składnia żądania

Metoda Żądanie URI
POST {baseURL}/v1/extensions/product/checkinventorybyresourcetype?country={country-code}&resourceType={resourceTypeValue} HTTP/1.1

Parametry identyfikatora URI

Użyj następujących parametrów zapytania, aby sprawdzić spis według typu zasobu.

Name Typ Required Description
kod kraju ciąg Yes Identyfikator kraju/regionu.
resourceTypeValue ciąg Yes Typ zasobu do filtrowania wyników spisu. Zobacz Obsługiwane typy zasobów , aby uzyskać prawidłowe wartości.

Obsługiwane typy zasobów

Wartość typu zasobu Description
AppService App Service
Avs Rozwiązanie Azure VMware
AzureDataExplorer Azure Data Explorer
AzureFiles Azure Files
Backup Azure Backup
BlockBlob Blokuj Blob Storage
CopilotCredit Kredyt Copilot
CosmosDb Azure Cosmos DB
Databricks Azure Databricks
DataFactory Azure Data Factory
Dedykowany Gospodarz Azure Dedicated Host
FabricCapacity Pojemność usługi Microsoft Fabric
FoundryAgent Foundry Agent
ManagedDisk Dysk zarządzany platformy Azure
MariaDB Azure Database for MariaDB
MDC Microsoft Defender dla Chmury
MySql Azure Database for MySQL
Nutanix Nutanix
OpenAIPTU Azure OpenAI PTU
PostgreSQL Azure Database for PostgreSQL
RedHat Red Hat
RedHatOsa Red Hat OpenShift w Azure
RedisCache Azure Cache for Redis
SapHana Oprogramowanie SAP HANA na platformie Azure
Sentinel Microsoft Sentinel
Bazy danych SQL bazy danych Azure SQL
SqlDataWarehouse Azure SQL Data Warehouse
SuseLinux SUSE Linux
Synapse Azure Synapse Analytics
Maszyny wirtualne Azure Virtual Machines
VMwareCloudSimple VMware CloudSimple

Nagłówki zapytań

Aby uzyskać więcej informacji, zapoznaj się z Nagłówkami Centrum partnerskiego REST.

Treść żądania

Szczegóły żądania inwentaryzacji, składające się z zasobu InventoryCheckRequest zawierającego co najmniej jeden zasób InventoryItem.

Upewnij się, że subskrypcja platformy Azure określona w treści żądania jest zarejestrowana i ma włączoną możliwość zakupu wystąpień zarezerwowanych platformy Azure. Aby uzyskać szczegółowe informacje na temat procesu rejestracji, zobacz Rejestrowanie subskrypcji .

Przykład zapytania

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

Odpowiedź REST

W przypadku powodzenia treść odpowiedzi zawiera kolekcję obiektów InventoryItem wypełnionych szczegółami ograniczeń, jeśli istnieją.

Note

Jeśli wejściowy element InventoryItem reprezentuje element, którego nie można odnaleźć w wykazie lub nie odpowiada określonemu typowi zasobu, nie zostanie uwzględniony w kolekcji wyjściowej.

Kody sukcesu i błędów w odpowiedziach

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów Centrum partnerskiego.

Przykład odpowiedzi

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

Produkty nie zostały zwrócone w odpowiedzi

Jeśli produkt lub SKU jest dostępny w ramach określonej subskrypcji i regionu, ale podlega ograniczeniom, odpowiedź zawiera produkt z isRestricted: true oraz szczegóły dotyczące mających zastosowanie ograniczeń.

Jeśli produkt nie jest dostępny dla określonej subskrypcji i regionu, odpowiedź całkowicie pomija produkt.

Important

Traktuj produkt, którego brakuje w odpowiedzi jako niedostępny tylko dla określonej subskrypcji i regionu.

Scenario Odpowiedź dla CheckInventoryByResourceType
Produkt jest niedostępny dla subskrypcji/regionu Produkt pominięty w odpowiedzi
SKU jest dostępne isRestricted: false
Kod SKU objęty ograniczeniami regionalnymi Zwrócone przez isRestricted: true

Treści powiązane

  • Last updated on