Sprawdzanie spisu elementów wykazu przy użyciu interfejsów API Centrum partnerskiego

Artykuł
09/27/2024

Jak sprawdzić spis dla określonego zestawu elementów wykazu.

Wymagania wstępne

Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
Co najmniej jeden identyfikator produktu. Opcjonalnie można również określić identyfikatory jednostek SKU.
Wszelkie dodatkowe konteksty potrzebne do zweryfikowania spisu jednostek SKU, do których odwołuje się podany identyfikator produktu/jednostki SKU. Te wymagania mogą się różnić w zależności od typu produktu/jednostki SKU i można je określić z właściwości InventoryVariables jednostki SKU.

C#

Aby sprawdzić spis, skompiluj obiekt InventoryCheckRequest przy użyciu obiektu InventoryItem dla każdego elementu do sprawdzenia. Następnie użyj metody dostępu IAggregatePartner.Extensions, ustaw zakres w dół do pozycji Product, a następnie wybierz kraj/region przy użyciu metody ByCountry(). Na koniec wywołaj metodę CheckInventory() za pomocą obiektu InventoryCheckRequest .

IAggregatePartner partnerOperations;
string customerId;
string subscriptionId;
string countryCode;
string productId;

// Build the inventory check request details object.
var inventoryCheckRequest = new InventoryCheckRequest()
{
    TargetItems = new InventoryItem[]{ new InventoryItem { ProductId = productId } },
    InventoryContext = new Dictionary<string, string>()
    {
      { "customerId", customerId },
      { "azureSubscriptionId", subscriptionId }
      { "armRegionName", armRegionName }
    }
};

// Get the inventory results.
var inventoryResults = partnerOperations.Extensions.Product.ByCountry(countryCode).CheckInventory(inventoryCheckRequest);

Żądanie REST

Składnia żądania

Method	Identyfikator URI żądania
POST	{baseURL}/v1/extensions/product/checkInventory?country={country-code} HTTP/1.1

Parametr identyfikatora URI

Użyj następującego parametru zapytania, aby sprawdzić spis.

Nazwisko	Type	Wymagania	opis
kod kraju	string	Tak	Identyfikator kraju/regionu.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Szczegóły żądania spisu 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 włączona do zakupu wystąpień zarezerwowanych platformy Azure. Aby uzyskać szczegółowe informacje na temat procesu rejestracji, zobacz Rejestrowanie subskrypcji .

Przykład żądania

POST https://api.partnercenter.microsoft.com/v1/extensions/product/checkinventory?country=US 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
MS-PartnerCenter-Client: Partner Center .NET SDK
Content-Type: application/json

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

Ważne

Od czerwca 2023 r. najnowsza wersja zestawu .NET SDK Centrum partnerskiego 3.4.0 jest teraz archiwizowana. Możesz pobrać wersję zestawu SDK z usługi GitHub wraz z plikiem readme zawierającym przydatne informacje.

Zachęcamy partnerów do dalszego korzystania z interfejsów API REST Centrum partnerskiego.

Odpowiedź REST

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

Uwaga

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

Kody powodzenia i błędów odpowiedzi

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": true,
        "restrictions": [
            {
                "reasonCode": "NotAvailableForSubscription",
                "description": "Restriction identified of type 'Location' with values 'japanwest'.",
                "properties": {
                    "type": "Location",
                    "values": "japanwest"
                }
            }
        ]
    },
    {
        "productId": "DZH318Z0BQ3P",
        "skuId": "000S",
        "isRestricted": false,
        "restrictions": []
    },
    {
        "productId": "DZH318Z0BQ3P",
        "skuId": "0011",
        "isRestricted": false,
        "restrictions": []
    }
]

Udostępnij za pośrednictwem