Udostępnij za pośrednictwem

Pobieranie szczegółów transferu według identyfikatora

  • Artykuł

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).

  • Identyfikator transferu dla istniejącego transferu.

Odpowiednie role: agent Administracja

Żądanie REST

Składnia żądania

Method Identyfikator URI żądania
GET {baseURL}/v1/customers/{customer-id}/transfer/{transfer-id} HTTP/1.1

Parametr identyfikatora URI

Użyj następującego parametru ścieżki, aby zidentyfikować klienta i określić transfer, który ma zostać zaakceptowany.

Nazwisko Type Wymagania opis
identyfikator klienta string Tak Identyfikator GUID sformatowany przez klienta, który identyfikuje klienta.
identyfikator transferu string Tak Identyfikator transferu sformatowany w formacie GUID, który identyfikuje transfer.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Przykład żądania

GET /v1/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/46e8ed67-8adf-4f65-b3d8-d31318080556 HTTP/1.1
Authorization: Bearer <token>
Connection: keep-alive
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Accept: application/json

Odpowiedź REST

Jeśli ta metoda powiedzie się, ta metoda zwraca wypełniony zasób TransferEntity 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 dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów.

Przykład odpowiedzi w toku

HTTP/1.1 200 OK
Content-Length: 1501
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
X-Locale: en-US
Date: Fri, 17 May 2024 18:25:25 GMT

{
        "id": "96978f5b-ee35-486f-96e9-a17ed4a1d87d",
        "status": "InProgress",
        "transferType": 3,
        "customerEmailId": "",
        "createdTime": "2024-04-09T22:45:06.7851706Z",
        "lastModifiedTime": "2024-04-10T17:26:56Z",
        "customerName": "legacytomodern09022021",
        "customerTenantId": "425829ba-6938-4b55-af29-fbbd28ebeebf",
        "partnertenantid": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "sourcePartnerName": "test",
        "sourcePartnerTenantId": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "targetPartnerName": "TEST_TEST_CSPIntegrationTest2T19Q3",
        "targetPartnerTenantId": "35ae17a4-532a-4895-9dc1-baeb7279eedd",
        "targetPartnerEmailId": "35ae17a4-532a-4895-9dc1-baeb7279eedd",
        "transferDirection": 2,
        "ignoreEligibilityCheck": false,
        "lastModifiedUser": "fec7ff82-163d-4763-afb1-6947d2b0db28",
        "lineItems": [
            {
                "id": 0,
                "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
                "billingCycle": "unknown",
                "quantity": 0,
                "productType": 0,
                "status": "InProgress"
            },
            {
                "id": 0,
                "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
                "billingCycle": "unknown",
                "quantity": 0,
                "productType": 5,
                "status": "InProgress"
            }
        ],
        "links": {
            "self": {
                "uri": "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/transfers/96978f5b-ee35-486f-96e9-a17ed4a1d87d",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "TransferEntity"
        }
    }

Przykład odpowiedzi w toku

HTTP/1.1 200 OK
Content-Length: 1501
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
X-Locale: en-US
Date: Fri, 17 May 2024 18:25:25 GMT

{
        "id": "2d9a20f4-532d-438d-b694-bb7ab4585508",
        "status": "Pending",
        "transferType": 3,
        "customerEmailId": "",
        "createdTime": "2024-05-09T18:53:13.8486497Z",
        "lastModifiedTime": "2024-05-09T18:53:14Z",
        "customerName": "legacytomodern09022021",
        "customerTenantId": "425829ba-6938-4b55-af29-fbbd28ebeebf",
        "partnertenantid": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "sourcePartnerName": "test",
        "sourcePartnerTenantId": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "targetPartnerName": "TEST_TEST_CSPIntegrationTest2T19Q3",
        "targetPartnerTenantId": "35ae17a4-532a-4895-9dc1-baeb7279eedd",
        "targetPartnerEmailId": "35ae17a4-532a-4895-9dc1-baeb7279eedd",
        "transferDirection": 2,
        "ignoreEligibilityCheck": false,
        "lastModifiedUser": "35ebf490-ac97-44af-9048-d3cdac1e4c84",
        "links": {
            "self": {
                "uri": "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/transfers/2d9a20f4-532d-438d-b694-bb7ab4585508",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "TransferEntity"
        }
    }

Przykład odpowiedzi dla ukończonych

HTTP/1.1 200 OK
Content-Length: 1501
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 0d61b5ce-b396-4f5e-a50b-e8779d0d23cc
X-Locale: en-US
Date: Fri, 17 May 2024 18:25:25 GMT

{
        "id": "1c53f090-7a5d-454f-bffa-696650863e79",
        "status": "Complete",
        "transferType": 3,
        "customerEmailId": "",
        "createdTime": "2024-04-24T19:29:58.4656093Z",
        "lastModifiedTime": "2024-04-24T19:38:22Z",
        "completedTime": "2024-04-24T19:36:12.7197415Z",
        "customerName": "legacytomodern09022021",
        "customerTenantId": "425829ba-6938-4b55-af29-fbbd28ebeebf",
        "partnertenantid": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "sourcePartnerName": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "sourcePartnerTenantId": "736ee76b-2635-4b33-a942-25ed0673f31e",
        "targetPartnerName": "TEST_TEST_CSPIntegrationTest2T19Q3",
        "targetPartnerTenantId": "35ae17a4-532a-4895-9dc1-baeb7279eedd",
        "targetPartnerEmailId": "35ae17a4-532a-4895-9dc1-baeb7279eedd",
        "transferDirection": 2,
        "ignoreEligibilityCheck": false,
        "lastModifiedUser": "f430373f-96d2-4ba5-b3ab-6b5dc69ae44f",
        "lineItems": [
            {
                "id": 0,
                "subscriptionId": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
                "billingCycle": "unknown",
                "quantity": 0,
                "productType": 0
            },
            {
                "id": 1,
                "orderId": "bc857bb7-45ad-4667-b369-14126df2f74c",
                "billingCycle": "unknown",
                "quantity": 0,
                "productType": 1
            }
        ],
        "links": {
            "self": {
                "uri": "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/transfers/1c53f090-7a5d-454f-bffa-696650863e79",
                "method": "GET",
                "headers": []
            }
        },
        "attributes": {
            "objectType": "TransferEntity"
        }
    }