Получение номера SKU по идентификатору
Возвращает номер SKU для указанного продукта с помощью указанного идентификатора SKU.
Необходимые условия
Учетные данные, как описано в аутентификации Центра партнеров. Этот сценарий поддерживает аутентификацию с использованием как автономных учетных данных приложения, так и учетных данных приложения и пользователя.
Идентификатор продукта.
Идентификатор SKU.
C#
Чтобы получить сведения о конкретном номере SKU, выполните действия, описанные в получить продукт по идентификатору, чтобы получить интерфейс для операций конкретного продукта. В результирующем интерфейсе выберите свойство Skus, чтобы получить интерфейс с доступными операциями для SKU. Передайте идентификатор SKU в метод ById() и вызовите Get() или GetAsync() для получения сведений об номере SKU.
IAggregatePartner partnerOperations;
string countryCode;
string productId;
string skuId;
// Get the SKU details.
var sku = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Get();
ЗАПРОС REST
Синтаксис запроса
Метод | URI запроса |
---|---|
ПОЛУЧИТЬ | {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code} HTTP/1.1 |
Параметр URI
Используйте следующий путь и параметры запроса, чтобы получить номер SKU для указанного продукта с помощью указанного идентификатора SKU.
Имя | Тип | Обязательно | Описание |
---|---|---|---|
идентификатор продукта | струна | Да | Строка, определяющая продукт. |
идентификатор SKU | струна | Да | Строка, идентифицирующая номер SKU. |
код страны | струна | Да | Идентификатор страны или региона. |
Заголовки запросов
Для получения дополнительной информации см. заголовки REST Центра партнёров.
Текст запроса
Нет.
Пример запроса
GET http://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3V/skus/00G1?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e0ae69a5-6322-4d7e-809d-59e02b51d71f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
MS-PartnerCenter-Application: Partner Center .NET SDK Samples
Host: api.partnercenter.microsoft.com
Важный
По состоянию на июнь 2023 г. последняя версия пакета SDK для .NET для Центра партнеров 3.4.0 теперь архивируется. Вы можете скачать выпуск пакета SDK из GitHubвместе с файлом ReadMe, который содержит полезные сведения.
Партнерам рекомендуется продолжать использовать интерфейсы REST API центра партнеров.
ответ REST
В случае успешного выполнения текст ответа содержит ресурс SKU.
Коды успешных ответов и ошибок
Каждый ответ содержит код состояния HTTP, указывающий на успешность или сбой и дополнительные сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и дополнительных параметров. Для получения полного списка см. в коды ошибок Центра партнеров.
Этот метод возвращает следующие коды ошибок:
Код состояния HTTP | Код ошибки | Описание |
---|---|---|
404 | 400013 | Продукт не найден. |
404 | 400018 | Sku не найден. |
Пример ответа для резервирования виртуальных машин Azure (план Azure)
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e0ae69a5-6322-4d7e-809d-59e02b51d71f,e0ae69a5-6322-4d7e-809d-59e02b51d71f
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNWXHNrdXNcMDBHMQ==?=
X-Powered-By: ASP.NET
Date: Thu, 15 Mar 2018 17:43:25 GMT
Content-Length: 1108
{
"id": "00G1",
"productId": "DZH318Z0BQ3V",
"title": "Reserved VM Instance, Standard_D32s_v3, US West 2, 3 Years",
"description": "Reserved Virtual Machines Instance, Standard_D32s_v3, US West 2, 3 Years",
"minimumQuantity": 1,
"maximumQuantity": 999999999,
"isTrial": false,
"supportedBillingCycles": [
"one_time"
],
"purchasePrerequisites": [
"AzureSubscriptionRegistration",
"InventoryCheck"
],
"inventoryVariables": [
"CustomerId",
"AzureSubscriptionId"
],
"provisioningVariables": [
"Scope",
"SubscriptionId"
],
"dynamicAttributes": {
"armSkuName": "Standard_D32s_v3",
"cores": "32",
"ram": "128",
"skuDisplayName": "D32s v3",
"category": "General purpose",
"armRegionName": "westus2",
"duration": "3Years",
"region": "US West 2",
"diskType": "Ssd"
},
"links": {
"availabilities": {
"uri": "/products/DZH318Z0BQ3V/skus/00G1/availabilities?country=us",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/DZH318Z0BQ3V/skus/00G1?country=us",
"method": "GET",
"headers": []
}
}
}
Пример ответа для новых коммерческих лицензионных сервисов
Заметка
Новые коммерческие возможности для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщиков облачных решений (CSPS). Дополнительные сведения см. в разделе «Обзор возможностей новой коммерции».
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee,bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 18b41adf-29b5-48eb-b14f-c9683a4e5b7d,18b41adf-29b5-48eb-b14f-c9683a4e5b7d
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTVTXHNrdXM=?=
X-Powered-By: ASP.NET
Date: Thu, 15 Mar 2018 21:06:03 GMT
Content-Length: 50917
{
"id": "0001",
"productId": "CFQ7TTC0LH18",
"title": "Microsoft 365 Business Basic",
"description": "Best for businesses that need professional email, cloud file storage, and online meetings & chat. Desktop versions of Office apps like Excel, Word, and PowerPoint not included. For businesses with up to 300 employees.",
"minimumQuantity": 1,
"maximumQuantity": 300,
"isTrial": false,
"supportedBillingCycles": [
"annual",
"monthly"
],
"purchasePrerequisites": [
"MicrosoftCloudAgreement"
],
"inventoryVariables": [],
"provisioningVariables": [],
"actions": [
"Refund"
],
"dynamicAttributes": {
"isMicrosoftProduct": true,
"hasConstraints": true,
"isAddon": false,
"prerequisiteSkus": [],
"isSoftwareAssuranceApplicable": false,
"upgradeTargetOffers": [
"CFQ7TTC0LDPB:0001",
"CFQ7TTC0LF8Q:0001"
…
],
"provisioningId": "3b555118-da6a-4418-894f-7df1e2096870",
"internal": false
},
"links": {
"availabilities": {
"uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/CFQ7TTC0LH18/skus/0001?country=US",
"method": "GET",
"headers": []
}
}
}