Obtenir la disponibilité par ID

Obtient la disponibilité du produit et de la référence SKU spécifiés à l’aide d’un ID de disponibilité. Un identifiant de disponibilité est mutable, dynamique et réémis régulièrement. Les partenaires doivent toujours être sûrs d’obtenir la disponibilité actuelle lors de l’envoi d’éléments de ligne de panier ou d’exécution d’autres activités qui nécessitent l’ID de disponibilité.

Prérequis

• Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec des informations d’identification de type application seule et application + utilisateur.

• ID de produit.

• ID de référence SKU.

• ID de disponibilité.

C#

Pour obtenir des détails sur une disponibilité spécifique, commencez par utiliser les étapes décrites dans Obtenir une référence SKU par ID pour obtenir l’interface pour les opérations d’une référence SKU spécifique. Dans l’interface résultante, sélectionnez la propriété Availabilities pour obtenir une interface avec les opérations disponibles pour les disponibilités. Ensuite, transmettez l’ID de disponibilité à la méthode ById() pour obtenir les opérations de cette disponibilité spécifique, puis appelez Get() ou GetAsync() pour récupérer les détails de disponibilité.

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

Le SDK Java Partner Center sert à gérer les ressources de Partner Center. Il s’agit d’un projet open source géré par la communauté partenaire et non officiellement pris en charge par Microsoft. Si vous rencontrez un problème, vous pouvez obtenir de l’aide auprès de la communauté ou le signaler dans GitHub.

Pour obtenir des détails sur une disponibilité spécifique, commencez par utiliser les étapes décrites dans Obtenir une référence SKU par ID pour obtenir l’interface pour les opérations d’une référence SKU spécifique. Dans l’interface résultante, sélectionnez la fonction getAvailabilities pour obtenir une interface avec les opérations disponibles pour les disponibilités. Ensuite, transmettez l’ID de disponibilité à la fonction byId() pour obtenir les opérations de cette disponibilité spécifique, puis appelez la fonction get() pour récupérer les détails de la disponibilité.

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

Le module PowerShell Partner Center peut être utilisé pour gérer les ressources de Partner Center. Il s’agit d’un projet open source géré par la communauté partenaire et non officiellement pris en charge par Microsoft. Si vous rencontrez un problème, vous pouvez obtenir de l’aide auprès de la communauté ou le signaler dans GitHub.

Pour obtenir des détails sur une disponibilité spécifique, exécutez Get-PartnerProductAvailability et spécifiez les paramètres AvailabilityId, CountryCode, ProductId et SkuId pour récupérer les détails de disponibilité.

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

Demande REST

Syntaxe de la requête

Paramètre d’URI

Utilisez le chemin d’accès et les paramètres de requête suivants pour obtenir une disponibilité spécifique à l’aide d’un ID de disponibilité.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la requête

Aucune.

Exemple de requête

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

Réponse REST

Si elle réussit, le corps de la réponse contient une ressource de disponibilité .

Codes d’erreur et de réussite de la réponse

Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et des informations de débogage supplémentaires. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez les codes d’erreur de l’Espace partenaires.

Cette méthode retourne les codes d’erreur suivants :

Exemple de réponse pour les réservations de machines virtuelles Azure (plan 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: 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": []
        }
    }
}

Exemple de réponse pour les nouveaux services basés sur des licences commerciales

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",
            "termLifeCycleState": "GA",
            "cancellationPolicies": [
                {
                    "refundOptions": [
                        {
                            "sequenceId": 0,
                            "type": "Full",
                            "expiresAfter": "P1D"
                        }
                    ]
                }
            ]
        },
       …
    ],
    "product": { ... },
    "sku": { ... },
    "links": {
        "self": {
            "uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0K971?country=US",
            "method": "GET",
            "headers": []
        }
    }
}

Instructions de conversion sur trois ans concernant la disponibilité

Quelques unités de conservation de stock de trois ans avec des équipes pour les partenaires européens permettent de passer à des dates anniversaire. La disponibilité actuelle du SKU de l’abonnement inclut des instructions de transfert pour la conversion.

"conversionTransferInstructions": [
        {
          "transferToBigId": "CFQ7TTC0ZSW3:003G",
          "transferTiming": "Immediate",
          "constraintsData": {
            "timingConstraint": {
              "recurrenceInterval": "P1Y",
              "startDateReference": "SubscriptionTermStartDate"
            }
          }
        }
]