Créer un client
S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government
En tant que partenaire fournisseur de solutions Cloud (CSP), lorsque vous créez un client, vous pouvez passer des commandes pour le compte du client. Lorsque vous créez un client, vous créez également :
- Objet client Microsoft Entra pour le client
- Relation entre le revendeur et le client (utilisée pour les privilèges d’administrateur délégués)
- Nom d’utilisateur et mot de passe à connecter en tant qu’administrateur pour le client
Une fois le client créé, enregistrez les détails de l’ID client et de Microsoft Entra ID.
Important
Si vous êtes un fournisseur indirect et que vous souhaitez créer un client pour un revendeur indirect, consultez Créer un client pour un revendeur indirect.
Prérequis
- Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification d’application et d’application+utilisateur autonomes.
Important
Pour créer un locataire client, vous devez fournir une adresse physique valide pendant le processus de création. Une adresse peut être validée en suivant les étapes décrites dans le scénario Valider une adresse . Si vous créez un client à l’aide d’une adresse non valide dans l’environnement de bac à sable, vous ne pourrez pas supprimer ce locataire client.
Important
Si le passage du mot de passe userCredentials n’est pas accepté.
C#
Pour ajouter un client :
instanciez un nouvel objet Client Veillez à renseigner billingProfile et CompanyProfile.
Ajoutez le nouveau client à votre collection IAggregatePartner.Customers en appelant Create ou CreateAsync.
Exemple en code 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);
Exemple d’application C#
- Application de test de console. Projet : Classe d’exemples sdk de l’Espace partenaires : CreateCustomer.cs
REST
Syntaxe de la requête
| Méthode | URI de demande |
|---|---|
| POST | {baseURL}/v1/customers HTTP/1.1 |
En-têtes de requête
Cette API est idempotente (elle ne génère pas de résultat différent si vous l’appelez plusieurs fois).
Un ID de requête et un ID de corrélation sont requis.
Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.
Corps de la demande
Ce tableau décrit les propriétés requises dans le corps de la requête.
| Nom | Type | Description |
|---|---|---|
| BillingProfile | object | Les informations du profil de facturation du client. |
| CompanyProfile | object | Les informations du profil de l’entreprise du client. |
Profil de facturation
Ce tableau décrit les champs minimum requis de la ressource CustomerBillingProfile nécessaire pour créer un client.
| Nom | Type | Description |
|---|---|---|
| chaîne | L’adresse e-mail du client. | |
| culture | string | Leur culture préférée pour la communication et la devise, comme en-US. Consultez les langues et paramètres régionaux pris en charge dans l’Espace partenaires pour les cultures prises en charge. |
| langue | string | Langue par défaut. Deux codes de langue de caractères (par exemple en ou fr) sont pris en charge. |
| companyName | string | Nom de l’entreprise/de l’organisation inscrite. |
| defaultAddress | Adresse | Adresse inscrite de l’entreprise/de l’organisation du client. Pour plus d’informations sur les limitations de longueur, consultez la ressource Address . |
Profil de la société
Ce tableau décrit les champs minimum requis de la ressource CustomerCompanyProfile nécessaire pour créer un client.
| Nom | Type | Description |
|---|---|---|
| domaine | string | Le nom de domaine du client, tel que contoso.onmicrosoft.com. |
| organizationRegistrationNumber | Chaîne | Numéro d’inscription de l’organisation du client (également appelé numéro INN dans certains pays/régions). Obligatoire uniquement pour l’entreprise/l’organisation du client située dans les pays/régions suivants : Arménie(AM), Azerbaïdjan(AZ), Belarus(BY), Hongrie(HU), Kazakhstan(KZ), Kirghizistan(KG), Moldova(MD), Russie(RU), Tadjikistan(TJ), Ouzbékistan(UZ), Ukraine(UA), Brésil(BR), Inde, Afrique du Sud, Pologne, Émirats arabes unis, Arabie saoudite, Türkiye, Thaïlande, Vietnam, Myanmar, Irak, Soudan du Sud, Venezuela et Chine. Pour l’entreprise/l’organisation du client située dans d’autres pays/régions, il s’agit d’un champ facultatif. |
GDAP par défaut
| Nom | Type | Description |
|---|---|---|
| enableGDAPByDefault | bool | Boolean pour indiquer si nous voulons activer GDAP par défaut ou non. Si la valeur est true, nous allons créer GDAP par défaut. Si la valeur est false, nous ne créons pas LE GDAP. Notez que cela n’est honoré que dans les clouds qui prennent en charge GDAP. Si aucune prise en charge n’est prise en charge, DAP est créé par défaut. |
Exemple de requête
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"
}
}
}
Réponse REST
Si elle réussit, cette API retourne une ressource client pour le nouveau client. Enregistrez les détails de l’ID client et de Microsoft Entra ID pour une utilisation ultérieure avec le Kit de développement logiciel (SDK) de l’Espace partenaires. Vous en aurez besoin pour une utilisation avec la gestion des comptes, par exemple.
Codes d’erreur et de réussite de la réponse
Les réponses sont fournies avec un code d’état HTTP qui indique la réussite ou l’échec et des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.
Exemple de réponse
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
Remarque
Le Kit de développement logiciel (SDK) de l’Espace partenaires pour Java est un projet code source ouvert géré par la communauté partenaire.
Pour créer un client, procédez comme suit.
- Créez une instance des objets CustomerBillingProfile et CustomerCompanyProfile . Veillez à remplir les champs requis.
- Créez le client en appelant la fonction IAggregatePartner.getCustomers().create .
Exemple 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
Remarque
Le Kit de développement logiciel (SDK) de l’Espace partenaires pour PowerShell est un projet code source ouvert géré par la communauté partenaire.
Pour créer un client, exécutez la commande New-PartnerCustomer comme dans l’exemple suivant.
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'
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour