Een klantaccount verwijderen uit de integratie-sandbox

Artikel
03/15/2024

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud for US Government

In dit artikel wordt uitgelegd hoe u de relatie tussen de partner en het klantaccount kunt verbreken en het quotum voor testen in de sandbox voor productieintegratie (tip) kunt herwinnen.

Belangrijk

Wanneer u een klantaccount verwijdert, worden alle resources die zijn gekoppeld aan die klanttenant verwijderd.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als App+User-referenties.
Een klant-id (customer-tenant-id). Als u de id van de klant niet weet, kunt u deze opzoeken in partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in 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).
Alle gereserveerde vm-instanties en software-inkooporders van Azure moeten worden geannuleerd voordat een klant uit de sandbox voor tipintegratie wordt verwijderd.

C#

Een klant verwijderen uit de tip-integratie-sandbox:

Geef de referenties van uw Tip-account door aan de methode CreatePartnerOperations om een IPartner-interface voor partnerbewerkingen op te halen.
Gebruik de bewerkingsinterface van de partner om de verzameling rechten op te halen:
1. Roep de methode Customers.ById() aan met de klant-id om de klant op te geven.
2. Roep de eigenschap Rechten aan .
3. Roep de methode Get of GetAsync aan om de rechtenverzameling op te halen.
Zorg ervoor dat alle Azure Reserved Virtual Machine Instances en software-inkooporders voor die klant worden geannuleerd. Voor elk recht in de verzameling:
1. Gebruik de entitlement.ReferenceOrder.Id om een lokale kopie van de bijbehorende order op te halen uit de verzameling orders van de klant.
2. Stel de eigenschap Order.Status in op Geannuleerd.
3. Gebruik de methode Patch() om de bestelling bij te werken.

Alle bestellingen annuleren. In het volgende codevoorbeeld wordt bijvoorbeeld een lus gebruikt om elke order te peilen totdat de status 'Geannuleerd' is.

// IPartnerCredentials tipAccountCredentials;
// Customer tenant Id to be deleted.
// string customerTenantId;

IPartner tipAccountPartnerOperations = PartnerService.Instance.CreatePartnerOperations(tipAccountCredentials);

// Get all entitlements whose order must be canceled.
ResourceCollection<Entitlement> entitlements = tipAccountPartnerOperations.Customers.ById(customerTenantId).Entitlements.Get();

// Cancel all orders
foreach (var entitlement in entitlements)
{
    var order = tipAccountPartnerOperations.Customers.ById(customerTenantId).Orders.ById(entitlement.ReferenceOrder.Id).Get();
    order.Status = "Cancelled";
    order = tipAccountPartnerOperations.Customers.ById(customerTenantId).Orders.ById(order.Id).Patch(order);
}

// Keep polling until the status of all orders is "Cancelled".
bool proceed = true;
do
{
    // Check if all the orders were canceled.
    foreach (var entitlement in entitlements)
    {
        var order = tipAccountPartnerOperations.Customers.ById(customerTenantId).Orders.ById(entitlement.ReferenceOrder.Id).Get();
        if (!order.Status.Equals("Cancelled", StringComparison.OrdinalIgnoreCase))
        {
            proceed = false;
        }
    }

    // Wait for a few seconds.
    Thread.Sleep(5000);
}
while (proceed == false);

tipAccountPartnerOperations.Customers.ById(customerTenantId).Delete();

Zorg ervoor dat alle orders worden geannuleerd door de methode Delete voor de klant aan te roepen.

Voorbeeld: Consoletest-app. Project: PartnerCentrum PartnerCenterSDK.FeaturesSamples Klasse: DeleteCustomerFromTipAccount.cs

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
DELETE	{baseURL}/v1/customers/{customer-tenant-id} HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter om een klant te verwijderen.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	GUID	J	De waarde is een klant-tenant-id in GUID-indeling waarmee de reseller de resultaten kan filteren op een bepaalde klant die bij de reseller hoort.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen.

Voorbeeld van aanvraag

DELETE https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id> HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Content-Length: 0

REST-antwoord

Als dit lukt, retourneert deze methode een leeg antwoord.

Geslaagde respons- en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die een geslaagde of mislukte status aangeeft en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partner Center REST-foutcodes voor de volledige lijst.

Voorbeeld van antwoord

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
Date: Wed, 16 Mar 2016 00:43:02 GMT

Delen via