Tworzenie transferu dla nowego handlu przy użyciu interfejsów API REST Centrum partnerskiego
Partnerzy mogą przenosić nowe subskrypcje handlowe od jednego partnera transakcyjnego do innego. Partner docelowy tworzy żądanie przeniesienia. Partner źródłowy aktualizuje transfer ze szczegółami elementu wiersza. W tym temacie opisano interfejs API wywoływany przez partnera docelowego w celu utworzenia żądania przeniesienia. Ten temat dotyczy tylko rezerwacji planu platformy Azure, planów oszczędnościowych i subskrypcji oraz nowych subskrypcji opartych na licencjach handlowych. Więcej cennych informacji można znaleźć w dokumentacji przenoszenia subskrypcji.
Wymagania wstępne
Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
Identyfikator klienta (
customer-tenant-id
). Jeśli nie znasz identyfikatora klienta, możesz wyszukać go w Centrum partnerskim, wybierając obszar roboczy Klienci , a następnie klienta z listy klienta, a następnie pozycję Konto. Na stronie Konto klienta poszukaj identyfikatora Microsoft w sekcji Informacje o koncie klienta. Identyfikator Microsoft jest taki sam jak identyfikator klienta (customer-tenant-id
).Odpowiednie role: administrator globalny | Agent administracyjny | Agent sprzedaży
Żądanie REST
Składnia żądania
Method | Identyfikator URI żądania |
---|---|
POST | {baseURL}/v1/customers/{customer-id}/transfery HTTP/1.1 |
Parametr identyfikatora URI
Użyj następującego parametru ścieżki, aby zidentyfikować klienta.
Nazwisko | Type | Wymagania | opis |
---|---|---|---|
identyfikator klienta | string | Tak | Identyfikator GUID sformatowany przez klienta, który identyfikuje klienta. |
Nagłówki żądań
Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.
Treść żądania
W tej tabeli opisano właściwości TransferEntity w treści żądania tworzenia nowego żądania przeniesienia handlu.
Właściwość | Type | Wymagania | opis |
---|---|---|---|
sourcePartnerTenantId | string | Tak | Identyfikator GUID sformatowany jako partner-id, który identyfikuje partnera inicjującego transfer. |
sourcePartnerName | string | Tak | Nazwa organizacji partnera, która inicjuje przeniesienie. |
customerEmailId | string | Tak | Ciąg klienta do odbierania powiadomień o utworzeniu przeniesienia. |
customerName | string | Nie | Opcjonalny. Nazwa klienta, którego subskrypcje są przenoszone. |
targetPartnerTenantId | string | Nie | Identyfikator dzierżawy partnera sformatowany za pomocą identyfikatora GUID, który identyfikuje partnera, do którego jest kierowany transfer. Jeśli pominięto, kontekst autoryzacji partnera zostanie rozpoznany jako identyfikator dzierżawy partnera. |
targetPartnerEmailId | string | Nie | Identyfikator dzierżawy partnera sformatowany za pomocą identyfikatora GUID, który identyfikuje partnera, do którego jest kierowany transfer. Jeśli pominięto, kontekst autoryzacji partnera zostanie rozpoznany jako identyfikator dzierżawy partnera. |
transferType | string | Tak | Ciąg definiujący typ transferu. Nowy handel powinien być używany do planowania platformy Azure i nowych subskrypcji opartych na licencjach handlowych. |
Przykład żądania
{
"id": "43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"status": "InProgress",
"transferType": 3,
"customerEmailId": "",
"createdTime": "2024-04-30T18:31:41.5133355Z",
"lastModifiedTime": "2024-05-01T00:51:55Z",
"expirationTime": "2024-05-31T00:00:00Z",
"customerName": "ipdbtrans2",
"customerTenantId": "a624f7f8-408b-49d0-9320-df79e56bed55",
"partnertenantid": "a94dcde1-ecd7-wace-a6ef-ef73ba6b8ba5",
"sourcePartnerName": "Test_Test_IP4_AG",
"sourcePartnerTenantId": "a94dcde1-ecd7-4ace-a6ef-ef73ba6b8ba5",
"targetPartnerName": "Test_Test_DB_AG",
"targetPartnerTenantId": "817512dd-0689-47a0-bbf2-a7f11ae1fc11",
"targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"transferDirection": 2,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "1671774b-679f-4543-a152-1f8b14006c0e",
"lineItems": [{
"id": 0,
"subscriptionId": "d0df8837-6db3-49d8-c2b3-1d94bc1ab42d",
"billingCycle": "unknown",
"quantity": 0,
"productType": 5,
"status": "InProgress"
}],
"links": {
"self": {
"uri": "/customers/a624f7f8-408b-49d0-9320-df79e56bed55/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"method": "GET",
"headers": []
}
}
}
Odpowiedź REST
W przypadku powodzenia ta metoda zwraca wypełniony zasób TransferEnity w treści odpowiedzi.
Kody powodzenia i błędów odpowiedzi
Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i więcej informacji o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów.
Przykład odpowiedzi
HTTP/1.1 201 Created
Content-Length: 138
Content-Type: application/json; charset=utf-8
MS-RequestId: 4fa6dad6-a89f-4875-8247-7294a10ae1cf
MS-CorrelationId: 0e93c70c-977c-4a88-9580-7cf084c73286
X-Locale: en-US,en-US
{
"id": "43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"status": "Pending",
"transferType": 3,
"customerEmailId": "",
"createdTime": "2024-04-30T18:31:41.5133355Z",
"lastModifiedTime": "2024-04-30T18:31:41Z",
"expirationTime": "2024-05-31T00:00:00Z",
"customerName": "ipdbtrans2",
"customerTenantId": "a624f7f8-408b-49d0-9320-df79e56bed55",
"partnertenantid": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"sourcePartnerName": "Test_Test_IP4_AG",
"sourcePartnerTenantId": "a94dcde1-ecd7-4ace-a6ef-ef73ba6b8ba5",
"targetPartnerName": "Test_Test_DB_AG",
"targetPartnerTenantId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"targetPartnerEmailId": "817512d3-0689-47a0-bbf2-a7f11ae1fc11",
"transferDirection": 1,
"ignoreEligibilityCheck": false,
"lastModifiedUser": "7ffdaa28-3b1c-4a61-b580-e1aa6ecf833c",
"links": {
"self": {
"uri": "/customers/a624f7f8-408b-49d0-9320-df79e56bed55/transfers/43fb1d3a-79fe-45a9-863e-9a4acf17b630",
"method": "GET",
"headers": []
}
}
}
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla