Een abonnement bijwerken op ID

van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Werkt een abonnement bij op ID.

Voer in Partner Center deze bewerking uit door eerst een klant te selecteren. Selecteer vervolgens het betreffende abonnement dat u wilt bijwerken. Wijzig tot slot de gewenste waarden en selecteer vervolgens Verzenden.

Vereiste voorwaarden

Inloggegevens zoals beschreven in Partner Center-authenticatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
Een klant-ID (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door eerst de werkruimte Klanten te selecteren, dan de klant uit de klantenlijst en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-ID is hetzelfde als de klant-ID (customer-tenant-id).
Een abonnements-id.

C#

Als u de waarden van het abonnement van een klant wilt bijwerken, haalt u eerst het abonnement op en wijzigt u vervolgens de gewenste eigenschappen van het abonnement. Zodra de wijziging is aangebracht, gebruikt u uw IAggregatePartner.Customers verzameling en roept u de ById() methode aan. Roep vervolgens de eigenschap Subscriptions aan, gevolgd door de methode ById(). Voltooi ten slotte door de Patch()-methode aan te roepen.

// IAggregatePartner partnerOperations;
// var customerId;
// var subscriptionId;

//retrieving the subscription, for the purpose of the sample
ResourceCollection<Subscription> customerSubscriptions = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.Get();
Subscription selectedSubscription = customerSubscriptions.Items.FirstOrDefault(sub => sub.Status == SubscriptionStatus.Active);

//update selected subscription; a variety of fields can be updated, but quantity is used as an example below
selectedSubscription.Quantity++;

var updatedSubscription = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscription.Id).Patch(selectedSubscription);

Voorbeeld van: Console-test-app. Project: PartnerSDK.FeatureVoorbeeld Klasse: UpdateSubscription.cs

REST-aanvraag

Aanvraagsyntaxis

Methode	URI-aanvraag
LAP	{baseURL}/v1/klanten/{customer-tenant-id}/abonnementen/{subscription-id} HTTP/1.1

URI-parameter

Deze tabel bevat de vereiste queryparameter om het abonnement bij te werken.

Naam	Typologie	Verplicht	Beschrijving
klant-huurder-id	Handleiding	Ja	Een GUID (Globally Unique Identifier) die overeenkomt met de klant.
abonnement-ID	Handleiding	Ja	Een GUID dat hoort bij het abonnement.

Headers aanvragen

Voor meer informatie, zie Partner Center REST headers.

Inhoud van het verzoek

Een volledige abonnementsresource is vereist in de aanvraagtekst. Zorg ervoor dat de gewenste eigenschappen worden bijgewerkt.

Als de autoRenewEnabled van een abonnement is ingesteld op true, instructies voor de volgende termijn heeft of instructies voor de volgende facturering heeft, zijn deze kenmerken vereist als onderdeel van de hoofdtekst van de PATCH-aanvraag. Als deze kenmerken niet zijn opgegeven, wordt autoRenewEnabled per ongeluk ingesteld op onwaar of worden de volgende termijn-/factureringsinstructies verwijderd. Dit is alleen van toepassing als er minimale informatie in de payload zit. Als er eerder een Get-aanroep is gedaan en het antwoord wordt gewijzigd en doorgegeven aan de API, worden de vereiste velden in de aanvraag ingevuld.

Opmerking

Partner-ID's zijn alleen relevant voor distributeurs die de vaste partner voor het abonnement van hun klant definiëren. Partners met directe facturering zien partnerID als nul. Distributeurs die werkzaam zijn op de EU-/EVA-markten, kunnen meerdere wederverkopers aan één abonnement hebben toegewezen. Alle partner-id's in het abonnement moeten voldoen aan de validatievereisten voordat u een abonnement bijwerkt. Meer informatie over EU/EVA aanvullende resellers vindt u in de documentatie voor abonnementsbeheer.

Vraag voorbeeld #1a

PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/subscriptions/<id-for-subscription> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3831
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

{
    "Id": "83ef9d05-4169-4ef9-9657-0e86b1eab1de",
    "FriendlyName": "nickname",
    "Quantity": 2,
    "UnitType": "none",
    "ParentSubscriptionId": null,
    "CreationDate": "2015-11-25T06:41:12Z",
    "EffectiveStartDate": "2015-11-24T08:00:00Z",
    "CommitmentEndDate": "2016-12-12T08:00:00Z",
    "Status": "active",
    "AutoRenewEnabled": false,
    "BillingType": "none",
    "partnerId": "5357564",
    "additionalPartnerIds": ["517285","5357563"],
    "ContractType": "subscription",
    "OrderId": "6183db3d-6318-4e52-877e-25806e4971be",
    "Attributes": {
        "Etag": "<etag>",
        "ObjectType": "Subscription"
    }
}

Vraag voorbeeld #1b: Nieuw commerce-abonnement om de beschrijvende naam bij te werken

De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle Cloud Solution Provider-partners (CSP's). Zie Overzicht van nieuwe commerce-ervaringen voor meer informatie.

PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/subscriptions/<subscription-id> HTTP/1.1 
Authorization: Bearer <token> 
Accept: application/json 
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3831 
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd 
Content-Type: application/json 
Content-Length: 1029 
Expect: 100-continue 
Connection: Keep-Alive 
 
{ 
    "id": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e", 
    "offerId": "CFQ7TTC0LH18:0001:CFQ7TTC0K971", 
    "offerName": "Microsoft 365 Business Basic", 
    "friendlyName": "nickname", //originally Microsoft 365 Business Basic 
    "productType": { 
        "id": "OnlineServicesNCE", 
        "displayName": "OnlineServicesNCE" 
    }, 
    "quantity": 1, 
    "unitType": "Licenses", 
    "hasPurchasableAddons": false, 
    "creationDate": "2021-01-14T16:57:15.0966728Z", 
    "effectiveStartDate": "2021-01-14T16:57:14.498252Z", 
    "commitmentEndDate": "2022-01-13T00:00:00Z", 
    "status": "active",  
    "autoRenewEnabled": true, //must be included if set to true; see note in Request Body section 
    "isTrial": false, 
    "billingType": "license", 
    "billingCycle": "monthly", 
    "termDuration": "P1Y", 
    "renewalTermDuration": "", 
    "refundOptions": [ 
        { 
            "type": "Full", 
            "expiresAt": "2021-01-15T00:00:00Z" 
        } 
    ], 
    "isMicrosoftProduct": true, 
    "partnerId": "5357564",
    "additionalPartnerIds": ["517285","5357563"],
    "attentionNeeded": false, 
    "actionTaken": false, 
    "contractType": "subscription", 
    "links": { 
        "product": { 
            "uri": "/products/CFQ7TTC0LH18?country=US", 
            "method": "GET", 
            "headers": [] 
        }, 
        "sku": { 
            "uri": "/products/CFQ7TTC0LH18/skus/0001?country=US", 
            "method": "GET", 
            "headers": [] 
        }, 
        "availability": { 
            "uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0K971?country=US", 
            "method": "GET", 
            "headers": [] 
        }, 
        "self": { 
            "uri": "/customers/d8202a51-69f9-4228-b900-d0e081af17d7/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e", 
            "method": "GET", 
            "headers": [] 
        } 
    }, 
    "publisherName": "Microsoft Corporation", 
    "orderId": "34b37d7340cc", 
    "attributes": { 
        "objectType": "Subscription" 
    } 
}

REST-antwoord

Als dit lukt, retourneert deze methode een HTTP-status 200 statuscode en bijgewerkte eigenschappen van de abonnementsresource in de antwoordtekst.

Geslaagde antwoorden en foutcodes

Elk antwoord retourneert een HTTP-statuscode die aangeeft dat er is geslaagd of gefaald en andere foutopsporingsinformatie. Gebruik een hulpprogramma voor netwerktracering om de statuscode, het fouttype en andere parameters te lezen. Zie Foutcodes voor de volledige lijst.

Wanneer de patchbewerking langer duurt dan de verwachte tijd, verzendt het Partnercentrum een HTTP-status 202 statuscode en een locatieheader die verwijst naar de locatie waar het abonnement moet worden opgehaald. U kunt het abonnement regelmatig opvragen om de status te controleren.

Antwoordvoorbeelden

Voorbeeld van een reactie #1a

Geslaagde aanvraag met een HTTP-status 200 statuscode:

PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/subscriptions/<subscriptionID> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-Contract-Version: v1
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3831
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Type: application/json
Content-Length: 1029
Expect: 100-continue
Connection: Keep-Alive

{
    "Id": "83ef9d05-4169-4ef9-9657-0e86b1eab1de",
    "FriendlyName": "nickname",
    "Quantity": 1,
    "UnitType": "none",
    "ParentSubscriptionId": null,
    "CreationDate": "2015-11-25T06:41:12Z",
    "EffectiveStartDate": "2015-11-24T08:00:00Z",
    "CommitmentEndDate": "2016-12-12T08:00:00Z",
    "Status": "active",
    "AutoRenewEnabled": true,
    "BillingType": "none",
    "partnerId": "5357564",
    "additionalPartnerIds": ["517285","5357563"],
    "ContractType": "subscription",
    "Links": {
        "Offer": {
            "Uri": "/v1/offers/0CCA44D6-68E9-4762-94EE-31ECE98783B9",
            "Method": "GET",
            "Headers": []
        },
        "Entitlement": {
            "Uri": "/entitlements?key=<key>",
            "Method": "GET",
            "Headers": []
        },
        "Self": {
            "Uri": "/subscriptions?key=<key>",
            "Method": "GET",
            "Headers": []
        }
    },
    "OrderId": "6183db3d-6318-4e52-877e-25806e4971be",
    "Attributes": {
        "Etag": "<etag>",
        "ObjectType": "Subscription"
    }
}

Voorbeeld van een reactie #1b: nieuw commerce-abonnement om de beschrijvende naam bij te werken

PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/subscriptions/<subscription-id> HTTP/1.1 
Authorization: Bearer <token> 
Accept: application/json 
MS-RequestId: ca7c39f7-1a80-43bc-90d8-ee7d1cad3831 
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd 
Content-Type: application/json 
Content-Length: 1029 
Expect: 100-continue 
Connection: Keep-Alive 
 
{ 
    "id": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e", 
    "offerId": "CFQ7TTC0LH18:0001:CFQ7TTC0K971", 
    "offerName": "Microsoft 365 Business Basic", 
    "friendlyName": "nickname",  
    "productType": { 
        "id": "OnlineServicesNCE", 
        "displayName": "OnlineServicesNCE" 
    }, 
    "quantity": 1, 
    "unitType": "Licenses", 
    "hasPurchasableAddons": false, 
    "creationDate": "2021-01-14T16:57:15.0966728Z", 
    "effectiveStartDate": "2021-01-14T16:57:14.498252Z", 
    "commitmentEndDate": "2022-01-13T00:00:00Z", 
    "status": "active",  
    "autoRenewEnabled": true, 
    "isTrial": false, 
    "billingType": "license", 
    "billingCycle": "monthly", 
    "termDuration": "P1Y", 
    "renewalTermDuration": "", 
    "refundOptions": [ 
        { 
            "type": "Full", 
            "expiresAt": "2021-01-15T00:00:00Z" 
        } 
    ], 
    "isMicrosoftProduct": true, 
    "partnerId": "5357564",
    "additionalPartnerIds": ["517285","5357563"],
    "attentionNeeded": false, 
    "actionTaken": false, 
    "contractType": "subscription", 
    "links": { 
        "product": { 
            "uri": "/products/CFQ7TTC0LH18?country=US", 
            "method": "GET", 
            "headers": [] 
        }, 
        "sku": { 
            "uri": "/products/CFQ7TTC0LH18/skus/0001?country=US", 
            "method": "GET", 
            "headers": [] 
        }, 
        "availability": { 
            "uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0K971?country=US", 
            "method": "GET", 
            "headers": [] 
        }, 
        "self": { 
            "uri": "/customers/d8202a51-69f9-4228-b900-d0e081af17d7/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e", 
            "method": "GET", 
            "headers": [] 
        } 
    }, 
    "publisherName": "Microsoft Corporation", 
    "orderId": "34b37d7340cc", 
    "attributes": { 
        "objectType": "Subscription" 
    } 
}

Antwoordvoorbeeld 2

Geslaagde aanvraag met een HTTP-status 202 statuscode:

PATCH https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/subscriptions/<subscriptionID> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 01880c1b-1966-40f0-d470-501a66d9948b
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
Content-Type: application/json
Content-Length: 1432
Connection: Keep-Alive
Location: /customers/<customer-tenant-id>/subscriptions/<subscriptionID>

Feedback

Is deze pagina nuttig?

Last updated on 2025-12-24