Microsoft 고객 계약에 대한 고객 동의 확인 받기

아티클
03/09/2025

적용 대상: 파트너 센터

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

계약 리소스는 현재 Microsoft 퍼블릭 클라우드의 파트너 센터에서만 지원됩니다.

이 문서에서는 고객이 Microsoft 고객 계약에 동의했는지 확인하는 방법을 설명합니다.

필수 구성 요소

파트너 센터 .NET SDK를 사용하는 경우 버전 1.14 이상이 필요합니다.

중요하다

2023년 6월 현재 최신 파트너 센터 .NET SDK 릴리스 3.4.0이 보관됩니다. GitHub 에서 유용한 정보를 포함하는 리드미 파일와 함께 SDK 릴리스를다운로드할 수 있습니다.

파트너는 파트너 센터 REST API계속 사용하는 것이 좋습니다.
파트너 센터 인증에 설명된 대로 자격 증명. 이 시나리오는 App+사용자 인증만 지원합니다.
고객 ID(customer-tenant-id)입니다. 고객의 ID를 모르는 경우, 파트너 센터에서 고객 작업 영역을 선택한 다음, 고객 목록에서 고객을 선택하고, 마지막으로 계정 을 조회할 수 있습니다. 고객의 계정 페이지에서 고객 계정 정보 섹션 내에서 Microsoft ID를 찾으세요. Microsoft ID는 고객 ID(customer-tenant-id)와 동일합니다.

.NET

이전에 제공된 고객 동의 확인을 검색하려면 다음을 수행합니다.

IAggregatePartner.Customers 컬렉션을 사용하고 지정된 고객 식별자를 사용하여 ById 메서드를 호출합니다.
Agreements 속성을 가져오고 ByAgreementType 메서드를 호출하여 결과를 Microsoft 고객 계약으로 필터링합니다.
Get 또는 GetAsync 메서드를 호출합니다.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCustomerAgreement";

var customerAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

전체 샘플은 콘솔 테스트 앱 프로젝트의 GetCustomerAgreements 클래스에서 찾을 수 있습니다.

REST 요청

이전에 제공된 고객 동의 확인을 검색하려면 다음을 수행합니다.

고객에 대한 Agreements 컬렉션을 검색하는 REST 요청을 만듭니다.
agreementType 쿼리 매개 변수를 사용하여 결과 범위를 Microsoft 고객 계약으로만 지정합니다.

요청 구문

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

메서드	요청 URI
가져오기	{baseURL}/v1/customers/{customer-tenant-id}/agreements?agreementType={agreement-type} HTTP/1.1

URI 매개 변수

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

이름	유형	필수	묘사
고객-테넌트-아이디	GUID	예	값은 고객을 지정할 수 있는 고객테넌트ID 형식의 GUID입니다.
계약 유형	문자열	아니요	이 매개 변수는 모든 규약 메타데이터를 반환합니다. 이 매개 변수를 사용하여 쿼리 응답의 범위를 특정 계약 유형으로 지정합니다. 지원되는 값은 다음과 같습니다. MicrosoftCloudAgreement MicrosoftCloudAgreement 형식의 규약 메타데이터만 포함하는. MicrosoftCustomerAgreement 형식의 규약 메타데이터만 포함하는 MicrosoftCustomerAgreement. 모든 규약 메타데이터를 반환하는 . (코드에 예기치 않은 규약 형식을 처리하는 데 필요한 논리가 없는 한 사용하지 마세요.) 참고: URI 매개 변수를 지정하지 않으면 쿼리가 기본적으로 이전 버전과의 호환성을 위해 MicrosoftCloudAgreement로 설정됩니다. Microsoft는 언제든지 새 계약 형식의 계약 메타데이터를 도입할 수 있습니다.

요청 헤더

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

요청 본문

없음.

요청 예제

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

REST 응답

성공하면 이 메서드는 응답 본문에 Agreement 리소스 컬렉션을 반환합니다.

응답 성공 및 오류 코드

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

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

응답 예제

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "dateAgreed":"2019-08-26T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@example.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"aaaabbbb-0000-cccc-1111-dddd2222eeee",
            "dateAgreed":"2019-08-27T00:00:00",
            "type":"MicrosoftCustomerAgreement",
            "agreementLink":"https://aka.ms/customeragreement"
        }
    ]
}

다음을 통해 공유