고객 조직 가져오기

적용 대상: 파트너 센터

고객 조직 리소스를 가져옵니다.

필수 조건

• 자격 증명(파트너 센터 인증에서 설명). 이 시나리오에서는 앱+사용자 자격 증명 또는 인증을 지원합니다.

• 고객 ID (customer-tenant-id). 고객의 ID를 모르는 경우 파트너 센터에서 찾아볼 수 있습니다. 파트너 센터 홈페이지에서 고객 작업 영역을 선택합니다. 고객 목록에서 고객을 선택한 다음, 계정을 선택합니다. 고객 계정 페이지의 고객 계정 세부 정보 섹션에서 Microsoft ID를 찾습니다. Microsoft ID는 고객 ID(customer-tenant-id)와 동일합니다.

GDAP 역할

다음 GDAP 역할 중 하나 이상이 필요합니다.

• 디렉터리 작성자
• 전역 판독기

REST 요청

요청 구문

URI 매개 변수

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

요청 헤더

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

요청 본문

없음

요청 예제

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/organization HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

[
  {
    "street": "1 Microsoft Way",
    "countryLetterCode": "US",
    "postalCode": "98052-8300",
    "city": "Redmond",
    "state": "WA",
    "displayName": "Contoso",
    "technicalNotificationMails": [
      "test@contoso.com"
    ]
  }
]

관련 콘텐츠

• 고객의 사용자 지정 도메인 가져오기