Udostępnij za pośrednictwem

Zasoby TransferEntity

  • Artykuł

Partner inicjuje transfer do obecnego partnera klienta. Bieżący lub źródłowy partner akceptuje transfer i przesyła go do zakończenia procesu transferu.

TransferEntity

Opisuje transferEntity, czyli jednostkę transferową, dla nowych transferów handlowych.

Właściwość Typ Opis
IDENTYFIKATOR string Identyfikator transferEntity, który jest dostarczany po pomyślnym utworzeniu transferEntity.
stan string Status jednostki transferu. Możliwe wartości to "Aktywne" (można je usunąć/przesłać) i "Ukończono" (zostało już ukończone). Zastosowano po pomyślnym utworzeniu transferEntity.
typTransferu string Liczba reprezentująca typ transferu. 3 rozwiązuje problem z modernAzure i 5 rozwiązuje problem z NewCommerce. Partnerzy dokonujący transferów między partnerami związanych z nowymi transferami handlowymi mogą używać jednej z dwóch metod, ale powinni ustandaryzować na metodzie 5.
customerEmailId struna/ciąg Identyfikuje wiadomość e-mail klienta używaną do powiadomień.
czasUtworzenia DateTime Data utworzenia elementu transferEntity w formacie daty i godziny. Zastosowane po pomyślnym utworzeniu podmiotu transferowego.
czasOstatniejModyfikacji Data i Czas Data ostatniej aktualizacji transferEntity w formacie daty i godziny. Zastosowane po pomyślnym utworzeniu elementu transferEntity.
czas zakończenia DateTime Data zakończenia transferEntity, w formacie daty i godziny. Zastosowane po pomyślnym zakończeniu transferu jednostki.
nazwa klienta string Opcjonalny. Nazwa klienta, którego subskrypcje są przenoszone.
customerTenantId string Identyfikator klienta w formacie GUID, który identyfikuje klienta. Zastosowane po pomyślnym utworzeniu jednostki transferowej.
partnertenantid string Identyfikator partnera sformatowany w formacie GUID, który identyfikuje partnera.
sourcePartnerName string Opcjonalny. Nazwa organizacji partnera, która inicjuje przeniesienie.
targetPartnerName string Opcjonalny. Nazwa organizacji partnera, do której jest skierowany transfer.
docelowetypyproduktów string Opcjonalny. Kolekcja ciągów, które określają typy subskrypcji, jakie można zgłosić do przeniesienia. Przyjmuje się, że wszystkie typy mają wartość Null. Wartości mogą obejmować AzureSubscription, AzureReservation, AzureSavingsPlan i OnlineServicesNCE.
targetPartnerTenantId string Identyfikator partnera w formacie GUID, który identyfikuje partnera docelowego transferu.
targetPartnerEmailId struna Identyfikator partnera w formacie GUID, który identyfikuje partnera docelowego transferu. Ten identyfikator jest taki sam jak identyfikator targetPartnerTenantId.
transferDirection string Liczba reprezentująca kierunek transferu. 1 reprezentuje transfer przychodzący dla partnera, który akceptuje przeniesienie. 2 odzwierciedla przelew wychodzący dla partnera, który tworzy przelew.
ignorujSprawdzenieKwalifikacji ciąg znaków Ta wartość powinna być fałszywa.
lastModifiedUser string Identyfikator użytkownika w formacie GUID, który identyfikuje ostatniego użytkownika, który zmodyfikował transfer.
lineItems Tablica obiektów Tablica zasoby TransferLineItem.

TransferLineItem

Reprezentuje jeden element zawarty w nowym transferze handlowymEntity. Partnerzy źródłowi widzą elementy wiersza dotyczące przenoszenia elementów, które próbują przenieść. Partnerzy docelowi widzą nowo utworzone pozycje po ich ukończeniu. Partnerzy docelowi mogą używać identyfikatorów elementów wiersza, aby ułatwić zrozumienie nowo utworzonych subskrypcji, które wynikają z przeniesienia.

Właściwość Typ Opis
IDENTYFIKATOR string Unikatowy identyfikator elementu wiersza transferu. Zastosowane po pomyślnym utworzeniu jednostki transferu.
identyfikator subskrypcji string Identyfikator subskrypcji.
ilość int Liczba licencji lub wystąpień.
billingCycle Objekt Typ cyklu rozliczeniowego ustawiony dla bieżącego okresu.
typ produktu string Ciąg reprezentujący typ przekazanego produktu.
status string Status pozycji wiersza w elemencie transferEntity.

TransferEntity dla tradycyjnych transferów opartych na licencjach

Opisuje podmiot transferowy.

Właściwość Typ Opis
IDENTYFIKATOR string Identyfikator "transferEntity" dostarczany po pomyślnym utworzeniu "transferEntity".
czasUtworzenia DateTime Data utworzenia elementu transferEntity w formacie daty i godziny. Zastosowanie po pomyślnym utworzeniu transferEntity.
czasOstatniejModyfikacji Data i czas Data ostatniej aktualizacji transferEntity w formacie daty i godziny. Zastosowane po pomyślnym utworzeniu jednostki transferowej.
ostatni modyfikujący użytkownik string Użytkownik, który ostatnio zaktualizował element transferEntity. Zastosowane po pomyślnym utworzeniu podmiotu transferu.
nazwaKlienta string Opcjonalny. Nazwa klienta, którego subskrypcje są przenoszone.
customerTenantId string Identyfikator klienta w formacie GUID, który identyfikuje klienta. Zastosowane po pomyślnym utworzeniu jednostki transferowej.
partnertenantid ciąg znaków Identyfikator partnera sformatowany w formacie GUID, który identyfikuje partnera.
sourcePartnerName string Opcjonalny. Nazwa organizacji partnera, która inicjuje przeniesienie.
sourcePartnerTenantId string Identyfikator partnera sformatowany w formacie GUID, który identyfikuje partnera inicjującego transfer.
targetPartnerName string Opcjonalny. Nazwa organizacji partnera, do której skierowany jest transfer.
targetPartnerTenantId string Identyfikator partnera w formacie GUID, który identyfikuje partnera docelowego transferu.
lineItems Tablica obiektów Tablica zasobów typu TransferLineItem.
status string Status jednostki transferu. Możliwe wartości to "Aktywne" (można je usunąć/przesłać) i "Ukończono" (zostało już ukończone). Zastosowanie po pomyślnym utworzeniu transferEntity.

TransferLineItem na potrzeby tradycyjnych transferów opartych na licencjach

Reprezentuje jeden element zawarty w elemencie transferEntity.

Własność Typ Opis
ID string Unikatowy identyfikator elementu wiersza transferu. Zastosowane po pomyślnym utworzeniu jednostki transferu.
identyfikatorSubskrypcji string Identyfikator subskrypcji.
ilość int Liczba licencji lub wystąpień.
billingCycle Objekt Typ cyklu rozliczeniowego ustawiony dla bieżącego okresu.
przyjaznaNazwa string Opcjonalny. Przyjazna nazwa elementu, zdefiniowana przez partnera, w celu ułatwienia rozróżniania.
partnerIdOnRecord string PartnerId zapisany w rekordzie zakupu, który ma miejsce po zaakceptowaniu przeniesienia.
Identyfikator oferty string Identyfikator oferty.
elementy dodatkowe Lista obiektów TransferLineItem Kolekcja pozycji transferEntity dla dodatków, które są przenoszone wraz z przekazywaną subskrypcją podstawową. Zastosowane po pomyślnym utworzeniu transferEntity.
błąd transferu sznurek Zastosowane po zaakceptowaniu obiektu transferEntity w przypadku wystąpienia błędu.
status string Status pozycji wiersza w elemencie transferEntity.

WynikPrzesłaniaTransferu

Reprezentuje wynik zaakceptowanego transferu dla tradycyjnych transferów opartych na licencjach.

Właściwość Typ Opis
zamówienia Lista obiektów Order. Kolekcja zamówień.
błędy transferu Lista obiektów TransferError. Kolekcja błędów transferu.

TransferError

Reprezentuje błąd, który występuje po zaakceptowaniu tradycyjnego transferu opartego na licencjach.

Własność Typ Opis
transferGroupId string Identyfikator grupy zamówień zamówienia, w którym wystąpił błąd.
kod int Kod błędu.
opis string Opis błędu.
lineItems Lista elementów TransferLineItem Kolekcja pozycji transferEntity, które są częścią błędu transferu.

TransferErrorCode

[Enum/dotnet/api/system.enum) z wartościami wskazującymi typ błędu zamówienia dla tradycyjnych transferów opartych na licencjach.

Wartość Pozycja Opis
BrakTokenuPartnera 800001 Brak tokenu partnera w kontekście żądania.
InvalidInput 800002 Niewłaściwe dane żądania.
ServiceException 800003 Nieoczekiwany błąd usługi.
InvalidOfferId 800004 Nieprawidłowy identyfikator oferty.
BłądTworzeniaZamówienia 800005 Tworzenie zamówienia nie powiodło się.
MpnIdNotFound 800015 Nie można odnaleźć identyfikatora Partnera.
Nieprawidłowy ID sprzedawcy pośredniego MPN 800016 PartnerID nie jest prawidłowym odsprzedawcą pośrednim.
IdentyfikatorPrzelewuNieZnaleziony 900100 Nie można odnaleźć żądania przeniesienia.
Przenoszenie niedozwolone, jeśli status to W toku 900101 Żądanie przeniesienia jest już w toku.
PrzeniesienieNiedozwoloneJeśliStatusJestZakończony 900102 Żądanie przeniesienia zostało już ukończone.
TransferCreateOrderError 900103 Zamówienie przeniesienia nie powiedzie się.
Przelew przetworzony przez inne żądanie 900104 Przelew jest przetwarzany przez inne żądanie.