다음을 통해 공유

Microsoft 클라우드 계약에 대한 고객 동의 확인 가져오기

  • 아티클

적용 대상: 파트너 센터

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

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

필수 조건

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

    Important

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

    파트너는 파트너 센터 REST API를 계속 사용하는 것이 좋습니다.

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

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

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

.NET(버전 1.4 이상)

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

  • IAggregatePartner.Customers 컬렉션을 사용하고 지정된 고객 식별자를 사용하여 ById 메서드를 호출합니다.

  • Agreements 속성을 가져오고 ByAgreementType 메서드를 호출하여 결과를 Microsoft 클라우드 계약으로 필터링합니다.

  • Get 또는 GetAsync 메서드를 호출합니다.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCloudAgreement";

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

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

.NET(버전 1.9 - 1.13)

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

IAggregatePartner.Customers 컬렉션을 사용하고 지정된 고객 식별자를 사용하여 ById 메서드를 호출합니다. 그런 다음, Agreements 속성을 가져와서 Get 또는 GetAsync 메서드를 호출합니다.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var agreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Get();

Java

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

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

IAggregatePartner.getCustomers 함수를 사용하고 지정된 고객의 식별자를 사용하여 byId 함수를 호출합니다. 그런 다음 getAgreements 함수를 가져와서 get 함수를 호출합니다.

// IAggregatePartner partnerOperations;
// String selectedCustomerId;

ResourceCollection<Agreement> agreements = partnerOperations.getCustomers().byId(selectedCustomerId).getAgreements().get();

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

PowerShell

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

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

Get-PartnerCustomerAgreement 명령을 사용합니다.

Get-PartnerCustomerAgreement -CustomerId '14876998-c0dc-46e6-9d0c-65a57a6c32ec'

REST 요청

이전에 제공된 고객 동의 확인을 검색하려면 다음 지침을 참조하세요.

관련 인증 정보를 사용하여 새 계약 리소스를 만듭니다.

요청 구문

메서드 요청 URI
GET {baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

URI 매개 변수

다음 쿼리 매개 변수를 사용하여 확인 중인 고객을 지정합니다.

속성 Type 필수 설명
CustomerTenantId GUID Y 값은 고객을 지정할 수 있는 CustomerTenantId 형식의 GUID입니다.

요청 헤더

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

요청 본문

없음

요청 예제

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

REST 응답

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

응답 성공 및 오류 코드

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

응답 예제

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2018-07-28T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://learn.microsoft.com/partner-center/agreements"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2017-08-01T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://learn.microsoft.com/partner-center/agreements"
        }
    ]
}