고객 만들기

아티클
04/01/2024

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

CSP(클라우드 솔루션 공급자) 파트너로서 고객을 만들 때 고객을 대신하여 주문을 할 수 있습니다. 고객을 만들 때 다음을 만듭니다.

고객을 위한 Microsoft Entra 테넌트 개체
재판매인과 고객 간의 관계(위임된 관리자 권한에 사용됨)
고객의 관리자로 로그인할 사용자 이름 및 암호

고객이 만들어지면 고객 ID 및 Microsoft Entra ID 세부 정보를 저장합니다.

Important

간접 공급자이고 간접 재판매인에 대한 고객을 만들려는 경우 간접 재판매인에 대한 고객 만들기를 참조하세요.

필수 조건

자격 증명(파트너 센터 인증에서 설명). 이 시나리오는 독립 실행형 앱과 App+사용자 자격 증명을 모두 사용하여 인증을 지원합니다.

Important

고객 테넌트를 만들려면 생성 프로세스 중에 유효한 실제 주소를 제공해야 합니다. 주소 유효성 검사 시나리오에 설명된 단계에 따라 주소의 유효성을 검사할 수 있습니다. 샌드박스 환경에서 잘못된 주소를 사용하여 고객을 만드는 경우 해당 고객 테넌트를 삭제할 수 없습니다.

Important

userCredentials 암호를 전달할 수 없는 경우

C#

고객을 추가하려면 다음을 수행합니다.

새 고객 개체를 인스턴스화합니다. BillingProfile 및 CompanyProfile 을 입력해야 합니다.
Create 또는 CreateAsync를 호출하여 IAggregatePartner.Customers 컬렉션에 새 고객을 추가합니다.

C# 예제

// IAggregatePartner partnerOperations;

var partnerOperations = this.Context.UserPartnerOperations;

var customerToCreate = new Customer()
{
    CompanyProfile = new CustomerCompanyProfile()
    {
        Domain = string.Format(CultureInfo.InvariantCulture,
            "SampleApplication{0}.{1}",
            new Random().Next(),
            this.Context.Configuration.Scenario.CustomerDomainSuffix),
        //// OrganizationRegistrationNumber = "123456" // Please add if in specific country/region that requires
    },
    BillingProfile = new CustomerBillingProfile()
    {
        Culture = "EN-US",
        Email = "gena@wingtiptoys.com",
        Language = "En",
        CompanyName = "Wingtip Toys"
        DefaultAddress = new Address()
        {
            FirstName = "Gena",
            MiddleName = "Coralie",
            LastName = "Soto",
            AddressLine1 = "One Microsoft Way",
            City = "Redmond",
            State = "WA",
            Country = "US",
            PostalCode = "98052",
            PhoneNumber = ""
        }
    }
};

var newCustomer = partnerOperations.Customers.Create(customerToCreate);

C# 샘플 앱

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

REST

요청 구문

메서드	요청 URI
POST	{baseURL}/v1/customers HTTP/1.1

요청 헤더

이 API는 idempotent입니다(여러 번 호출하는 경우 다른 결과를 생성하지 않음).
요청 ID 및 상관 관계 ID가 필요합니다.
자세한 내용은 파트너 센터 REST 헤더를 참조하세요.

요청 본문

이 표에서는 요청 본문의 필수 속성을 설명합니다.

이름	형식	설명
BillingProfile	개체	고객의 청구 프로필 정보입니다.
CompanyProfile	개체	회사의 프로필 정보입니다.

청구 프로필

이 표에서는 새 고객을 만드는 데 필요한 CustomerBillingProfile 리소스의 최소 필수 필드를 설명합니다.

속성	형식	설명
이메일	string	고객 이메일 주소입니다.
culture	string	통신 및 통화에 대한 선호 문화(예: `en-US`. 지원되는 문화권에 대해서는 파트너 센터에서 지원되는 언어 및 로캘을 참조하세요.
언어	string	기본 언어입니다. 두 문자 언어 코드(예 `en` : 또는 `fr`)가 지원됩니다.
companyName	string	등록된 회사/조직 이름입니다.
defaultAddress	주소	고객 회사/조직의 등록된 주소입니다. 길이 제한에 대한 자세한 내용은 주소 리소스를 참조하세요.

회사 프로필

이 표에서는 새 고객을 만드는 데 필요한 CustomerCompanyProfile 리소스의 최소 필수 필드를 설명합니다.

속성	형식	설명
도메인	string	contoso.onmicrosoft.com와 같은 고객 도메인 이름입니다.
organizationRegistrationNumber	문자열	고객의 조직 등록 번호(특정 국가/지역의 INN 번호라고도 함)입니다. 아르메니아(AM), 아제르바이잔(AZ), 벨라루스(BY), 헝가리(HU), 카자흐스탄(KZ), 키르기스스탄(KG), 몰도바(MD), 러시아(RU), 타지키스탄(TJ), 우즈베키스탄(UZ), 우크라이나(UA), 브라질(BR), 인도, 인도 남아프리카 공화국, 폴란드, 아랍에미리트, 사우디아라비아, 튀르키예, 태국, 베트남, 미얀마, 이라크, 남수단, 베네수엘라 및 중국. 다른 국가/지역에 있는 고객의 회사/조직의 경우 선택적 필드입니다.

기본적으로 GDAP

속성	형식	설명
enableGDAPByDefault	bool	기본적으로 GDAP를 사용하도록 설정할지 여부를 나타내는 부울입니다. true이면 기본적으로 GDAP를 만듭니다. false이면 GDAP를 만들지 않습니다. GDAP를 지원하는 클라우드에서만 적용됩니다. 지원되지 않는 경우 DAP는 기본적으로 만들어집니다.

요청 예제

POST https://api.partnercenter.microsoft.com/v1/customers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 789
Expect: 100-continue
Connection: Keep-Alive

{
    "enableGDAPByDefault": false,
    "CompanyProfile": {
        "Domain": "xyz.onmicrosoft.com"
    },
    "BillingProfile": {
        "Culture": "EN-US",
        "Email": "gena@wingtiptoys.com",
        "Language": "en",
        "CompanyName": "Wingtip Toys",
        "DefaultAddress": {
            "FirstName": "Gena",
            "LastName": "Soto",
            "AddressLine1": "One Microsoft Way",
            "City": "Redmond",
            "State": "WA",
            "PostalCode": "98052",
            "Country": "US"
        }
    }
}

REST 응답

성공하면 이 API는 새 고객에 대한 고객 리소스를 반환합니다. 파트너 센터 SDK에서 나중에 사용할 수 있는 고객 ID 및 Microsoft Entra ID 세부 정보를 저장합니다. 예를 들어 계정 관리와 함께 사용하려면 이러한 항목이 필요합니다.

응답 성공 및 오류 코드

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

응답 예제

HTTP/1.1 201 Created
Content-Length: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CV: ObwhuhD2tUKJoM+Z.0
MS-ServerId: 202010223
Date: Tue, 14 Feb 2017 20:06:02 GMT

{
    "id": "dfd8cc0a-c592-468c-8461-869a38d24738",
    "commerceId": "0a4ce58a-6f96-4273-8035-d9c7d31b9ba4",
    "companyProfile": {
        "tenantId": "dfd8cc0a-c592-468c-8461-869a38d24738",
        "domain": "xyz.onmicrosoft.com",
        "attributes": {
            "objectType": "CustomerCompanyProfile"
        }
    },
    "billingProfile": {
        "id": "d17c0275-da92-5c33-9032-782ef1d0b69b",
        "email": "gena@wingtiptoys.com",
        "culture": "en-US",
        "language": "en",
        "companyName": "Wingtip Toys",
        "defaultAddress": {
            "country": "US",
            "city": "Redmond",
            "state": "WA",
            "addressLine1": "One Microsoft Way",
            "postalCode": "98052",
            "firstName": "Gena",
            "lastName": "Soto",
            "phoneNumber": ""
        },
        "attributes": {
            "etag": "5920358838484612121",
            "objectType": "CustomerBillingProfile"
        }
    },
    "enableGDAPByDefault": false,
    "relationshipToPartner": "none",
    "userCredentials": {
        "userName": "admin",
        "password": "=;;n.=s9Z"
    },
    "attributes": {
        "objectType": "Customer"
    }
}

Java

참고 항목

Java용 파트너 센터 SDK는 파트너 커뮤니티에서 기본 오픈 소스 프로젝트입니다.

다음 단계를 사용하여 새 고객을 만듭니다.

CustomerBillingProfile 및 CustomerCompanyProfile 개체의 새 인스턴스를 만듭니다. 필수 필드를 채워야 합니다.
IAggregatePartner.getCustomers().create 함수를 호출 하여 고객을 만듭니 다.

Java 예제

// IAggregatePartner partnerOperations;

Address address = new Address();

address.setFirstName( "Gena" );
address.setLastName( "Soto" );
address.setAddressLine1( "One Microsoft Way" );
address.setCity( "Redmond" );
address.setState( "WA" );
address.setCountry( "US" );
address.setPostalCode( "98052" );
address.setPhoneNumber( "4255550101" );

CustomerBillingProfile billingProfile = new CustomerBillingProfile();

billingProfile.setCulture( "en-US" );
billingProfile.setEmail( "gena@wingtiptoys.com" );
billingProfile.setLanguage( "en" );
billingProfile.setCompanyName( "Wingtip Toys" );
billingProfile.setDefaultAddress( address );

CustomerCompanyProfile companyProfile = new CustomerCompanyProfile();

companyProfile.setDomain( "WingtipToys" + Math.abs( new Random().nextInt() ) + ".onmicrosoft.com" );

Customer customerToCreate = new Customer();

customerToCreate.setBillingProfile( billingProfile );
customerToCreate.setCompanyProfile( companyProfile );

Customer newCustomer = partnerOperations.getCustomers().create( customerToCreate );

PowerShell

참고 항목

PowerShell용 파트너 센터 SDK는 파트너 커뮤니티에서 기본 오픈 소스 프로젝트입니다.

고객을 만들려면 다음 예제와 같이 New-PartnerCustomer 명령을 실행합니다.

New-PartnerCustomer -BillingAddressLine1 '1 Microsoft Way' -BillingAddressCity 'Redmond' -BillingAddressCountry 'US' -BillingAddressPostalCode '98052' -BillingAddressState 'WA' -ContactEmail 'gena@wingtiptoys.com' -ContactFirstName 'Gena' -ContactLastName 'Soto' -Culture 'en-US' -Domain 'newcustomer.onmicrosoft.com' -Language 'en' -Name 'New Customer'

고객 만들기

필수 조건

C#

C# 예제

C# 샘플 앱

REST

요청 구문

요청 헤더

요청 본문

청구 프로필

회사 프로필

기본적으로 GDAP

요청 예제

REST 응답

응답 성공 및 오류 코드

응답 예제

Java

Java 예제

PowerShell

피드백

피드백

추가 리소스