ID로 고객 가져오기

아티클
08/12/2023

적용 대상: 파트너 센터 | 21Vianet에서 운영되는 파트너 센터 | Microsoft Cloud for US Government 파트너 센터

고객 ID에 해당하는 고객 리소스를 가져옵니다.

전제 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오에서는 앱+사용자 자격 증명 또는 앱 전용 인증을 지원합니다.
고객 ID (customer-tenant-id). 고객의 ID를 모르는 경우 파트너 센터에서 조회할 수 있습니다. 파트너 센터 홈페이지에서 고객 작업 영역을 선택합니다. 고객 목록에서 고객을 선택한 다음, 계정을 선택합니다. 고객의 계정 페이지에서 고객 계정 세부 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-id)와 동일합니다.

Important

고객 ID 가져오기 API 호출은 파트너가 고객 테넌트에 대한 DAP 액세스 권한이 없는 경우 응답에서 다음 특성을 다시 반환하지 않습니다. 그렇지 않으면 응답 샘플에 나열된 모든 특성을 반환합니다.

CompanyProfileAddress
CompanyProfileEmail
사용자 지정도메인

GDAP 역할

CompanyProfileAddress, CompanyProfileEmail에 대한 고객 조직 가져오기 및 CustomDomain에 대한 고객 사용자 지정 도메인 가져오기를 호출하려면 다음 GDAP 역할 중 하나 이상이 필요합니다.

전역 관리자
디렉터리 작성자
전역 읽기 권한자

C#

ID로 고객을 가져오려면 IAggregatePartner.Customers 컬렉션을 사용하고 ById() 메서드를 호출한 다음 Get() 또는 GetAsync() 메서드를 호출합니다.

// IAggregatePartner partnerOperations;
// string customerIdToRetrieve;

Customer customerInfo = partnerOperations.Customers.ById(customerIdToRetrieve).Get();

샘플: 콘솔 테스트 앱. 프로젝트: PartnerSDK.FeatureSamples 클래스: CustomerInformation.cs

Java

파트너 센터 Java SDK를 사용하여 파트너 센터 리소스를 관리할 수 있습니다. 파트너 커뮤니티에서 유지 관리하며 Microsoft에서 공식적으로 지원하지 않는 오픈 소스 프로젝트입니다. 문제가 발생한 경우 커뮤니티에서 도움을 받거나 GitHub에서 문제를 열 수 있습니다.

ID로 고객을 가져오려면 IAggregatePartner.getCustomers 함수를 사용하고 byId() 함수를 호출한 다음 get() 함수를 호출합니다.

// IAggregatePartner partnerOperations;
// String customerIdToRetrieve;

Customer customerInfo = partnerOperations.getCustomers().byId(customerIdToRetrieve).get();

PowerShell

파트너 센터 PowerShell 모듈을 사용하여 파트너 센터 리소스를 관리할 수 있습니다. 파트너 커뮤니티에서 유지 관리하며 Microsoft에서 공식적으로 지원하지 않는 오픈 소스 프로젝트입니다. 문제가 발생한 경우 커뮤니티에서 도움을 받거나 GitHub에서 문제를 열 수 있습니다.

ID로 고객을 가져오려면 Get-PartnerCustomer 명령을 실행하고 CustomerId 매개 변수를 지정합니다.

Get-PartnerCustomer -CustomerId '2ca7de6c-c05c-46b5-b689-32e53573a97a'

REST 요청

요청 구문

메서드	요청 URI
가져오기	{baseURL}/v1/customers/{customer-tenant-id} HTTP/1.1

URI 매개 변수

특정 고객에게 다음 쿼리 매개 변수를 사용합니다.

입력	종류	필수	설명
customer-tenant-id	guid	Y	값은 재판매인이 재판매인에 속한 지정된 고객에 대한 결과를 필터링할 수 있도록 하는 GUID 형식 의 customer-tenant-id 입니다.

요청 헤더

자세한 내용은 파트너 센터 REST 헤더를 참조하세요.

Request body

없음.

요청 예제

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: a176c585-b5de-4d65-824c-67a6deb45cd9
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

REST 응답

성공하면 이 메서드는 응답 본문에 Customer 리소스를 반환합니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패와 추가 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다. 네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 추가 매개 변수를 읽을 수 있습니다. 전체 목록은 오류 코드를 참조하세요.

응답 예제

HTTP/1.1 200 OK
Content-Length: 1530
Content-Type: application/json; charset=utf-8
MS-CorrelationId: a176c585-b5de-4d65-824c-67a6deb45cd9
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

{
  "id": "eebd1b55-5360-4438-a11d-5c06918c3014",
  "commerceId": "99e6a635-48e7-424d-9059-c9db944e3c54",
  "companyProfile": {
    "tenantId": "eebd1b55-5360-4438-a11d-5c06918c3014",
    "domain": "abcdefgh1234.onmicrosoft.com",
    "companyName": "1kl as kjk",
    "address": {
      "country": "US",
      "region": "wa",
      "city": "redmond",
      "addressLine1": "1 ms way",
      "postalCode": "98052",
      "phoneNumber": "1234567890"
    },
    "email": "a@a.com",
    "links": {
      "self": {
        "uri": "/customers/eebd1b55-5360-4438-a11d-5c06918c3014/profiles/company",
        "method": "GET",
        "headers": []
      }
    },
    "attributes": {
      "objectType": "CustomerCompanyProfile"
    }
  },
  "billingProfile": {
    "id": "eeada110-69d6-4cc9-b093-75feb7ca9d3f",
    "firstName": "d0d89d776d03471c819bf772191ed728",
    "lastName": "kjkAJJAAAAAAAAAAAAAAAAAAAA",
    "email": "a@a.com",
    "culture": "en-US",
    "language": "en",
    "companyName": "1kl as kjkAAAAAAAAAAAAAAAJJJJJJJJJJJAAAAAJJJJJJJJJJJAAJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJJAJJJJJAJJAAAAJAJJAAAAAAAAAAAAAAAAAAAA",
    "defaultAddress": {
      "country": "US",
      "city": "redmond",
      "state": "WA",
      "addressLine1": "1 ms way",
      "postalCode": "98052",
      "firstName": "1kl as",
      "lastName": "kjk",
      "phoneNumber": "1234567890"
    },
    "links": {
      "self": {
        "uri": "/customers/eebd1b55-5360-4438-a11d-5c06918c3014/profiles/billing",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "etag": "-4242348048554929329",
      "objectType": "CustomerBillingProfile"
    }
  },
  "relationshipToPartner": "reseller",
  "allowDelegatedAccess": true,
  "customDomains": [
    "abcdefgh1234.onmicrosoft.com"
  ],
  "links": {
    "self": {
      "uri": "/customers/eebd1b55-5360-4438-a11d-5c06918c3014",
      "method": "GET",
      "headers": []
    }
  },
  "attributes": {
    "objectType": "Customer"
  }
}

다음을 통해 공유