顧客のユーザー アカウントを作成する
顧客の新しいユーザー アカウントを作成します。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、アプリとユーザーの資格情報を使用した認証のみがサポートされます。
顧客 ID です (
customer-tenant-id
)。 顧客の ID がわからない場合は、パートナー センターで検索できます。 パートナー センターの ホーム ページから [顧客 ] ワークスペースを選択します。 顧客の一覧から顧客を選択し、[アカウント] を選択します。 顧客の [アカウント] ページで、[顧客アカウントの詳細] セクションで Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id
) と同じです。ユーザー doメイン をフェデレーション do にすることはできませんメイン。
GDAP ロール
次の GDAP ロールのうち少なくとも 1 つが必要です。
- ユーザー管理者
- ディレクトリ ライター
C#
顧客の新しいユーザー アカウントを取得するには:
関連するユーザー情報を使用して、新しい CustomerUser オブジェクトを作成します。
IAggregatePartner.Customers コレクションを使用し、ById() メソッドを呼び出します。
Users プロパティを呼び出した後、Create メソッドを呼び出します。
// string selectedCustomerId;
// IAggregatePartner partnerOperations;
// var SelectedCustomer;
var userToCreate = new CustomerUser()
{
PasswordProfile = new PasswordProfile() { ForceChangePassword = true, Password = "Password!1" },
DisplayName = "TestDisplayName",
FirstName = "TestFirstName",
LastName = "TestLastName",
UsageLocation = "US",
UserPrincipalName = Guid.NewGuid().ToString("N") + "@" + selectedCustomer.CompanyProfile.Domain.ToString()
};
User createdUser = partnerOperations.Customers.ById(selectedCustomerId).Users.Create(userToCreate);
サンプル: コンソール テスト アプリ。 プロジェクト: PartnerSDK.FeatureSamples クラス: CustomerUserCreate.cs
REST 要求
要求の構文
認証方法 | 要求 URI |
---|---|
投稿 | {baseURL}/v1/customers/{customer-tenant-id}/users HTTP/1.1 |
URI パラメーター
次のクエリ パラメーターを使用し、正しい顧客を特定します。
名前 | タイプ | Required | 説明 |
---|---|---|---|
customer-tenant-id | guid | 年 | 値は、GUID 形式 の customer-tenant-id です。これにより、リセラーは、リセラーに属する特定の顧客の結果をフィルター処理できます。 |
user-id | guid | N | 値は、1 つのユーザー アカウントに 属する GUID 形式のユーザー ID です。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
要求本文
なし。
要求の例
POST https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/users HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
{
"usageLocation": "country/region code",
"userPrincipalName": "userid@domain.onmicrosoft.com",
"firstName": "First",
"lastName": "Last",
"displayName": "User name",
"immutableId": "Some unique ID",
"passwordProfile":{
password: "abCD123*",
forceChangePassword: true
},
"attributes": {
"objectType": "CustomerUser"
}
}
REST 応答
成功した場合、このメソッドは GUID を含むユーザー アカウントを返します。
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、エラー コードに関するページを参照してください。
応答の例
HTTP/1.1 200 OK
Content-Length: 31942
Content-Type: application/json
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
Date: June 24 2016 22:00:25 PST
{
"usageLocation": "country/region code",
"id": "4b10bf41-ab11-40e3-8c53-cd67849b50de",
"userPrincipalName": "userid@domain.onmicrosoft.com",
"firstName": "First",
"lastName": "Last",
"displayName": "User name",
"immutableId": "Some unique ID",
"passwordProfile": {
"forceChangePassword": true,
"password": "abCD123*"
},
"lastDirectorySyncTime": null,
"userDomainType": "none",
"state": "active",
"softDeletionTime": null,
"attributes": {
"objectType": "CustomerUser"
}
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示