Microsoft 고객 계약에 대한 고객의 직접 서명(직접 동의) 상태 가져오기

아티클
01/02/2025

적용 대상: 파트너 센터

적용 안 됨: 21Vianet에서 운영하는 파트너 센터 | 미국 정부용 Microsoft 클라우드 파트너 센터

DirectSignedCustomerAgreementStatus 리소스는 현재 Microsoft 퍼블릭 클라우드에서만 Partner Center에서 지원됩니다.

이 문서에서는 고객이 Microsoft 고객 계약에 직접 동의한 상태를 검색하는 방법을 설명합니다.

필수 구성 요소

파트너 센터 인증설명된 대로 자격 증명. 이 시나리오에서는 App+User 자격 증명으로만 인증을 지원합니다.
고객 ID(customer-tenant-id)입니다. 고객의 ID를 모르는 경우, 파트너 센터에서 고객 작업 영역을 선택하고 고객 목록에서 고객을 선택한 다음, 계정매뉴를 참조하여 찾을 수 있습니다. 고객의 계정 페이지에서 고객 계정 정보 섹션의 Microsoft ID를 확인합니다. Microsoft ID는 고객 ID(customer-tenant-id)와 동일합니다.
간접 공급자 또는 직접 청구 협력사는 고객과 활성 재판매 관계가 있어야 계약의 직접 서명 상태를 확인할 수 있습니다.

C#

고객이 Microsoft 고객 계약에 직접 동의한 상태를 검색하려면 고객 식별자를 사용하여 IAggregatePartner.Customers.ById 메서드를 호출합니다. 그러면 Agreements 속성을 사용하여 ICustomerAgreementCollection 인터페이스를 가져올 수 있습니다. 마지막으로 GetDirectSignedCustomerAgreementStatus() 또는 GetDirectSignedCustomerAgreementStatusAsync() 호출하여 상태를 검색합니다.

// IAggregatePartner partnerOperations;
// string customerId;
var customerDirectSigningStatus = partnerOperations.Customers.ById(selectedCustomerId).Agreements.GetDirectSignedCustomerAgreementStatus();

샘플: 콘솔 샘플 앱. 프로젝트: SdkSamples 클래스: GetDirectSignedCustomerAgreementStatus.cs

REST 요청

고객이 Microsoft 고객 계약에 직접 동의한 상태를 확인하기 위해, 고객의 DirectSignedCustomerAgreementStatus를 검색하려면 REST 요청을 생성합니다.

요청 구문

다음 요청 구문을 사용합니다.

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

URI 매개 변수

요청에 다음 URI 매개 변수를 사용할 수 있습니다.

이름	유형	필수	묘사
고객-테넌트-ID	GUID	예	값은 사용자가 고객의 테넌트 ID를 지정할 수 있도록 하는 GUID 형식의 CustomerTenantId입니다.

요청 헤더

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

요청 본문

없음.

요청의 예시

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/directSignedMicrosoftCustomerAgreementStatus HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST 응답

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

리소스에는 고객의 직접 서명(직접 승인) 상태를 나타내는 isSigned 속성이 있습니다.

true 값은 고객이 직접 계약에 서명(수락됨)했음을 나타냅니다.
false 값은 계약 고객이 직접 서명(수락) 않았음을 나타냅니다.

응답 성공 및 오류 코드

각 응답에는 성공 또는 실패 및 더 많은 디버깅 정보를 나타내는 HTTP 상태 코드가 함께 제공됩니다.

네트워크 추적 도구를 사용하여 이 코드, 오류 유형 및 기타 매개 변수를 읽습니다. 전체 목록은파트너 센터 REST 오류 코드를 참조하세요.

응답 예제

HTTP/1.1 200 OK
Content-Length: 20
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

{"isSigned":true}

다음을 통해 공유