Ta bort ett kundkonto från sandbox-miljön för integrering

Artikel
07/17/2024

Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Den här artikeln beskriver hur du bryter relationen mellan partnern och kundkontot och återfår kvoten för testning i sandbox-integrering (Tips).

Viktigt

När du tar bort ett kundkonto rensas alla resurser som är associerade med kundklientorganisationen.

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 kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden i kundlistan och sedan Konto. På kundens kontosida letar du upp Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID:t (customer-tenant-id).
Alla Azure Reserved Virtual Machine Instances och order om programvaruinköp måste avbrytas innan du tar bort en kund från sandbox-miljön för Tip-integrering.

C#

Så här tar du bort en kund från sandbox-miljön för Tip-integrering:

Skicka dina autentiseringsuppgifter för tipskontot till metoden CreatePartnerOperations för att hämta ett IPartner-gränssnitt till partneråtgärder.
Använd partneråtgärdsgränssnittet för att hämta samlingen med rättigheter:
1. Anropa metoden Customers.ById() med kundidentifieraren för att ange kunden.
2. Anropa egenskapen Berättiganden .
3. Anropa metoden Get eller GetAsync för att hämta berättigandesamlingen .
Kontrollera att alla Azure Reserved Virtual Machine Instances och inköpsorder för den kunden har avbrutits. För varje berättigande i samlingen:
1. Använd entitlement.ReferenceOrder.Id för att hämta en lokal kopia av motsvarande Order från kundens beställningssamling.
2. Ange egenskapen Order.Status till "Cancelled".
3. Använd metoden Patch() för att uppdatera ordern.

Avbryt alla beställningar. Följande kodexempel använder till exempel en loop för att avsöka varje order tills dess status är "Cancelled".

// 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();

Kontrollera att alla beställningar avbryts genom att anropa metoden Ta bort för kunden.

Exempel: Konsoltestapp. Projekt: Partnercenter PartnerCenterSDK.FeaturesSamples Class: DeleteCustomerFromTipAccount.cs

REST-begäran

Begärandesyntax

Metod	URI för förfrågan
DELETE	{baseURL}/v1/customers/{customer-tenant-id} HTTP/1.1

URI-parameter

Använd följande frågeparameter för att ta bort en kund.

Namn	Typ	Obligatorisk	Beskrivning
customer-tenant-id	GUID	Y	Värdet är ett GUID-formaterat kund-klient-ID som gör att återförsäljaren kan filtrera resultatet för en viss kund som tillhör återförsäljaren.

Begärandehuvuden

Mer information finns i REST-huvuden i Partnercenter.

Begärandetext

Inga.

Exempel på begäran

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-svar

Om det lyckas returnerar den här metoden ett tomt svar.

Svarsframgång och felkoder

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

Exempel på svar

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

Dela via