C# 또는 파트너 센터 REST API를 통해 파트너 파트너 ID 확인

아티클
03/29/2024

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

PartnerID를 확인하는 방법입니다.

여기에 표시된 기술은 파트너 센터에서 파트너의 Microsoft AI Cloud 파트너 프로그램 프로필을 요청하여 PartnerID를 확인합니다. 요청이 성공하면 식별자가 유효한 것으로 간주됩니다.

필수 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 앱 + 사용자 자격 증명을 사용한 인증만 지원합니다.
확인할 파트너 PartnerID입니다. 이 값을 생략하면 요청은 로그인한 파트너의 Microsoft AI Cloud 파트너 프로그램 프로필을 검색합니다.

C#

파트너의 PartnerID를 확인하려면 먼저 IAggregatePartner.Profiles 속성에서 파트너 프로필 컬렉션 작업에 대한 인터페이스를 검색합니다 . 그런 다음 MpnProfile 속성에서 Microsoft AI Cloud 파트너 프로그램 프로필 작업에 대한 인터페이스를 가져옵니다. 마지막으로 PartnerID를 사용하여 Get 또는 GetAsync 메서드를 호출하여 Microsoft AI Cloud 파트너 프로그램 프로필을 검색합니다. Get 또는 GetAsync 호출에서 PartnerID를 생략하면 요청은 로그인한 파트너의 Microsoft AI Cloud 파트너 프로그램 프로필을 검색하려고 시도합니다.

// IAggregatePartner partnerOperations;
// string partnerMpnId;

var partnerProfile = partnerOperations.Profiles.MpnProfile.Get(partnerMpnId);

샘플: 콘솔 테스트 앱. 프로젝트: 파트너 센터 SDK 샘플 클래스: VerifyPartnerMpnId.cs

REST 요청

요청 구문

메서드	요청 URI
GET	{baseURL}/v1/profiles/mpn?mpnId={mpn-id} HTTP/1.1

URI 매개 변수

파트너를 식별하려면 다음 쿼리 매개 변수를 제공합니다. 이 쿼리 매개 변수를 생략하면 요청은 로그인한 파트너의 Microsoft AI Cloud 파트너 프로그램 프로필을 반환합니다.

이름	종류	필요함	설명
mpn-id	int	아니요	파트너를 식별하는 PartnerID입니다.

요청 헤더

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

요청 본문

없음

요청 예제

GET https://api.partnercenter.microsoft.com/v1/profiles/mpn?mpnId=9999999 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 560df6b9-6e53-4954-aed7-133477ac1194
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Important

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

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

REST 응답

성공하면 응답 본문에 파트너에 대한 MpnProfile 리소스가 포함됩니다.

응답 성공 및 오류 코드

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

응답 예제(성공)

HTTP/1.1 200 OK
Content-Length: 159
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: e39e0ddf-3fd0-4b7e-bb4e-8aebe242d3ee
MS-CV: s2GvkNgZsUSadxQX.0
MS-ServerId: 030011719
Date: Thu, 13 Apr 2017 18:13:40 GMT

{
    "partnerName": "Microsoft Partner", 
    "mpnId": "4391507",
    "profileType": "MpnProfile",
    "links": {
        "self": {
            "uri": "/profiles/mpn",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "MpnProfile"
    }
}

응답 예제(실패)

HTTP/1.1 404 Not Found
Content-Length: 124
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 560df6b9-6e53-4954-aed7-133477ac1194
MS-CV: sLRFZMWm+EKuL47u.0
MS-ServerId: 102030524
Date: Thu, 13 Apr 2017 18:26:51 GMT

{
    "code": 3000,
    "description": "Partner Organization with partner_id 9999999 could not be found",
    "data": [],
    "source": "PartnerFD"
}

다음을 통해 공유