Hämta tillgängligheten efter ID

Artikel
11/05/2024

Hämtar tillgängligheten för den angivna produkten och SKU:n med hjälp av ett tillgänglighets-ID. Tillgänglighets-ID:erna är föränderliga och dynamiska. De utfärdas regelbundet igen. Partner bör alltid se till att få den aktuella tillgängligheten när de skickar kundvagnsradsobjekt eller utför andra aktiviteter som kräver tillgänglighets-ID.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.
Ett produkt-ID.
Ett SKU-ID.
Ett tillgänglighets-ID.

C#

Om du vill få information om en specifik tillgänglighet börjar du med stegen i Hämta en SKU per ID för att hämta gränssnittet för en specifik SKU:s åtgärder. I det resulterande gränssnittet väljer du egenskapen Availabilities för att hämta ett gränssnitt med de tillgängliga åtgärderna för Tillgänglighet. Därefter skickar du tillgänglighets-ID:t till metoden ById() för att hämta åtgärderna för den specifika tillgängligheten och anropar sedan Get() eller GetAsync() för att hämta tillgänglighetsinformationen.

IAggregatePartner partnerOperations;
string countryCode;
string productId;
string skuId;
string availabilityId;

// Get the availability details.
var availability = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Availabilities.ById(availabilityId).Get();

Java

Java SDK för Partnercenter kan användas för att hantera Partnercenter-resurser. Det är ett projekt med öppen källkod som underhålls av partnercommunityn och stöds inte officiellt av Microsoft. Du kan få hjälp från communityn eller öppna ett problem på GitHub om du får problem.

Om du vill få information om en specifik tillgänglighet börjar du med stegen i Hämta en SKU per ID för att hämta gränssnittet för en specifik SKU:s åtgärder. I det resulterande gränssnittet väljer du funktionen getAvailabilities för att hämta ett gränssnitt med tillgängliga åtgärder för Tillgänglighet. Därefter skickar du tillgänglighets-ID:t till funktionen byId() för att hämta åtgärderna för den specifika tillgängligheten och anropar sedan funktionen get() för att hämta tillgänglighetsinformationen.

IAggregatePartner partnerOperations;
String countryCode;
String productId;
String skuId;
String availabilityId;

// Get the availability details.
Availability availability = partnerOperations.getProducts().byCountry(countryCode).byId(productId).getSkus().byId(skuId).getAvailabilities().byId(availabilityId).get();

PowerShell

PowerShell-modulen partnercenter kan användas för att hantera Partnercenter-resurser. Det är ett projekt med öppen källkod som underhålls av partnercommunityn och stöds inte officiellt av Microsoft. Du kan få hjälp från communityn eller öppna ett problem på GitHub om du får problem.

Om du vill få information om en specifik tillgänglighet kör du parametrarna Get-PartnerProductAvailability och anger parametrarna AvailabilityId, CountryCode, ProductId och SkuId för att hämta tillgänglighetsinformationen.

Get-PartnerProductAvailability -Product $productId -SkuId $skuId -AvailabilityId $availabilityId

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
GET	{baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code} HTTP/1.1

URI-parameter

Använd följande sökväg och frågeparametrar för att få en specifik tillgänglighet med hjälp av ett tillgänglighets-ID.

Namn	Typ	Obligatoriskt	Beskrivning
produkt-ID	sträng	Ja	En GUID-formaterad sträng som identifierar produkten.
sku-id	sträng	Ja	En GUID-formaterad sträng som identifierar SKU:n.
tillgänglighets-ID	sträng	Ja	En GUID-formaterad sträng som identifierar tillgängligheten.
landskod	sträng	Ja	Ett lands-/region-ID.
IncludeLifeCycleState	sträng	Nej	En strängflagga som kan anges till true för att returnera livscykeltillståndsvärden för licensbaserade erbjudanden i New Commerce. Dessa värden returneras inte om flaggan inte ingår.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Inga.

Exempel på begäran

GET http://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318XZXPHL?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 2e12a576-ded5-437e-a5ec-dbfbcbd1624c
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com

Viktigt!

Från och med juni 2023 arkiveras nu den senaste Partner Center .NET SDK-versionen 3.4.0. Du kan ladda ned SDK-versionen från GitHub tillsammans med en readme-fil som innehåller användbar information.

Partner uppmanas att fortsätta att använda REST-API:er för Partnercenter.

REST-svar

Om det lyckas innehåller svarstexten en tillgänglighetsresurs .

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och extra felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och andra parametrar. Den fullständiga listan finns i Felkoder för Partnercenter.

Den här metoden returnerar följande felkoder:

HTTP-statuskod	Felkod	beskrivning
404	400013	Det gick inte att hitta produkten.
404	400018	SKU hittades inte.
404	400019	Det går inte att hitta tillgängligheten. Det här felet kan inträffa när du checkar ut en kundvagn. Partner som får det här felet bör utfärda ett nytt GET för att säkerställa att de har det aktuella tillgänglighets-ID:t och försöka checka ut kundvagnen igen.

Svarsexempel för Azure VM-reservationer (Azure-plan)

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: 2e12a576-ded5-437e-a5ec-dbfbcbd1624c,2e12a576-ded5-437e-a5ec-dbfbcbd1624c
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllc1xEWkgzMThaMEhNS1E=?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:43 GMT
Content-Length: 440

{
    "id": "DZH318XZXPHL",
    "productId": "DZH318Z0BQ3Q",
    "skuId": "0001",
    "catalogItemId": "DZH318Z0BQ3Q:0001:DZH318XZXPHL",
    "defaultCurrency": {
        "code": "USD",
        "symbol": "$"
    },
    "segment": "commercial",
    "country": "US",
    "isPurchasable": true,
    "isRenewable": false,
    "terms": [{
        "duration": "P1Y",
        "description": "1 Year Prepaid"
    }],
    "product": { ... },
    "sku": { ... },
    "links": {
        "self": {
            "uri": "/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318XZXPHL?country=US",
            "method": "GET",
            "headers": []
        }
    }
}

Svarsexempel för nya licensbaserade tjänster för handel

Kommentar

De nya handelsupplevelserna för licensbaserade tjänster innehåller många nya funktioner och är tillgängliga för alla Molnlösningsleverantör (CSP:er). Mer information finns i översikten över nya handelsupplevelser.

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: 70324727-62d8-4195-8f99-70ea25058d02,70324727-62d8-4195-8f99-70ea25058d02
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllcw==?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:37 GMT
Content-Length: 808

{
    "id": "CFQ7TTC0K971",
    "productId": "CFQ7TTC0LH18",
    "skuId": "0001",
    "catalogItemId": "CFQ7TTC0LH18:0001:CFQ7TTC0K971",
    "defaultCurrency": {
        "code": "USD",
        "symbol": "$"
    },
    "segment": "commercial",
    "country": "US",
    "isPurchasable": true,
    "isRenewable": true, 
    "renewalInstructions": [
        {
            "applicableTermIds": [
                "5aeco6mffyxo"
            ],
            "renewalOptions": [
                {
                    "renewToId": "CFQ7TTC0LH18:0001",
                    "isAutoRenewable": true
                }
            ]
        },
	 …
    ],
    "terms": [
        {
            "id": "5aeco6mffyxo",
            "duration": "P1Y",
            "description": "One-Year commitment for monthly/yearly billing",
            "billingCycle": "Annual",
            "cancellationPolicies": [
                {
                    "refundOptions": [
                        {
                            "sequenceId": 0,
                            "type": "Full",
                            "expiresAfter": "P1D"
                        }
                    ]
                }
            ]
        },
       …
    ],
    "product": { ... },
    "sku": { ... },
    "links": {
        "self": {
            "uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0K971?country=US",
            "method": "GET",
            "headers": []
        }
    }
}

Dela via