Docs Menu
Docs Home
/
MongoDB Ops Manager
/ / / /

1 人のユーザーのロールを更新

項目一覧

  • Resource
  • 必須のロール
  • リクエスト パス パラメーター
  • リクエスト クエリ パラメータ
  • リクエスト ボディ パラメータ
  • 応答
  • リクエストの例
  • 応答例
  • 応答ヘッダー
  • レスポンス本体

注意

グループとプロジェクトは同義語です。 あなたの {PROJECT-ID}はプロジェクト ID と同じです。 既存のグループの場合、グループ/プロジェクト ID は同じままです。 このページでは、説明を参照するときに、より一般的な用語の グループ を使用します。 エンドポイントは ドキュメントに記載されているままです。

組織またはプロジェクト内でユーザーのロールを追加、更新、または削除します。 デフォルトでは、ペイロード内の新しい非グローバル組織とプロジェクト ロールは、最初に組織またはプロジェクトへの招待をユーザーに送信します。 ユーザーを組織またはプロジェクトに直接追加できるのは、 mms.user.bypassInviteForExistingUsersの設定をtrueに設定している場合のみです。

ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

PATCH /users/{USER-ID}

この APIエンドポイントを使用するには、適切なオーナー ロールが必要です。

レベル
必要なロール

組織

プロジェクト

重要

自分のユーザー アカウントはいつでも更新できます。

組織またはプロジェクトを所有している場合は、その組織またはプロジェクトのメンバーシップを持つ全ユーザーのユーザー ロールを更新できます。 その他のユーザープロファイル情報は変更できません。

名前
タイプ
必要性
説明

USER-ID

string

必須

検索するユーザーの一意の識別子。 ユーザーのUSER-IDを取得するには、 「 1 つのプロジェクトのすべてのユーザーを取得 」を参照してください。

次のクエリ パラメータは 任意です。

名前
タイプ
必要性
説明
default

pretty

ブール値

任意

レスポンス本体を pretty-print に含めるかどうかを示すフラグ 形式。

false

envelope

ブール値

任意

応答をエンベロープでラップするかどうかを示すフラグ。

一部のAPIクライアントは、 HTTPレスポンス ヘッダーまたはステータス コードにアクセスできません。 これを修正するには、クエリでenvelope=trueを設定します。

1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。

名前
説明

status

HTTPレスポンス コード

content

期待される応答本体

false

名前
タイプ
必要性
説明

roles

オブジェクトの配列

必須

MongoDB Ops Manager ユーザーに割り当てられたロール。

roles
.orgId

string

任意

MongoDB Ops Manager ユーザーが指定されたロールを持つ組織の一意の識別子。

roles
.groupId

string

任意

MongoDB Ops Manager ユーザーが指定されたロールを持つプロジェクトの一意の識別子。

GLOBAL_で始まるロールにはgroupIdは必要ありません。 これらのロールはプロジェクトには関連付けられていません。

roles
.roleName

string

任意

ロールの名前。 指定できる値は以下のとおりです。

説明

ORG_MEMBER

ORG_READ_ONLY

ORG_GROUP_CREATOR

ORG_OWNER

GROUP_AUTOMATION_ADMIN

GROUP_BACKUP_ADMIN

GROUP_MONITORING_ADMIN

GROUP_OWNER

GROUP_READ_ONLY

GROUP_USER_ADMIN

GROUP_DATA_ACCESS_ADMIN

GROUP_DATA_ACCESS_READ_ONLY

GROUP_DATA_ACCESS_READ_WRITE

GLOBAL_AUTOMATION_ADMIN

GLOBAL_BACKUP_ADMIN

GLOBAL_MONITORING_ADMIN

GLOBAL_OWNER

GLOBAL_READ_ONLY

GLOBAL_USER_ADMIN

JSON document には、次の各要素が含まれています。

Name
タイプ
説明

emailAddress

string

MongoDB Ops Manager ユーザーのメールアドレス。

firstName

string

MongoDB Ops Manager ユーザーの名。

id

string

MongoDB Ops Manager ユーザーの一意の識別子です。

lastName

string

MongoDB Ops Manager ユーザーの姓。

links

オブジェクト配列

関連するサブリソース へのリンク。 応答内のすべてのlinks配列には、自己と呼ばれるリンクが少なくとも 1 つ含まれています。 URL の関係は、 Web リンク仕様 で説明されています。

mobileNumber

string

MongoDB Ops Manager ユーザーのモバイル番号。

roles

空の配列

MongoDB Ops Manager ユーザーに割り当てられたロール。

roles
.groupId

string

指定されたロールを持つユーザーを持つプロジェクトの一意の識別子です。

GLOBAL_で始まるロールにはgroupIdは必要ありません。 これらのロールはプロジェクトには関連付けられていません。

roles
.orgId

string

指定されたロールを持つユーザーが所属する組織の一意の識別子です。

roles
.roleName

string

ロールの名前。 指定できる値は以下のとおりです。

説明

ORG_MEMBER

ORG_READ_ONLY

ORG_GROUP_CREATOR

ORG_OWNER

GROUP_AUTOMATION_ADMIN

GROUP_BACKUP_ADMIN

GROUP_MONITORING_ADMIN

GROUP_OWNER

GROUP_READ_ONLY

GROUP_USER_ADMIN

GROUP_DATA_ACCESS_ADMIN

GROUP_DATA_ACCESS_READ_ONLY

GROUP_DATA_ACCESS_READ_WRITE

GLOBAL_AUTOMATION_ADMIN

GLOBAL_BACKUP_ADMIN

GLOBAL_MONITORING_ADMIN

GLOBAL_OWNER

GLOBAL_READ_ONLY

GLOBAL_USER_ADMIN

username

string

MongoDB Ops Manager ユーザーのユーザー名。

1curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
2 --header "Accept: application/json" \
3 --header "Content-Type: application/json" \
4 --include \
5 --request PATCH "https://<OpsManagerHost>:<Port>/api/public/v1.0/users/{USER-ID}" \
6 --data '
7 {
8 "roles": [{
9 "groupId": "{GROUP-ID}",
10 "roleName": "{ROLE}"
11 }]
12 }'
HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive
HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
1{
2 "id": "{USER-ID}",
3 "username": "jane",
4 "emailAddress": "jane@qa.example.com",
5 "firstName": "Jane",
6 "lastName": "D'oh",
7 "links": [{
8 "href": "https://<OpsManagerHost>:<Port>/api/public/v1.0/users/{USER-ID}",
9 "rel": "self"
10 },
11 {
12 "href": "https://<OpsManagerHost>:<Port>/api/public/v1.0/users/{USER-ID}/accessList",
13 "rel": "http://mms.mongodb.com/accessList"
14 }],
15 "roles": [{
16 "orgId": "{ORG-ID}",
17 "roleName": "ORG_MEMBER"
18 },{
19 "groupId": "{PROJECT-ID}",
20 "roleName": "GROUP_READ_ONLY"
21 }],
22 "teamIds": []
23}

戻る

作成