Docs Menu
Docs Home
/
MongoDB Cloud Manager
/
API
/
リソース
/
プロジェクトとユーザー
/
プロジェクト

1 つのプロジェクト招待を作成

項目一覧

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

指定した Cloud Manager プロジェクトへの保留中の招待の詳細を取得します。

必須のロール

Project User Adminロールを使用して、このエンドポイントを正常に呼び出すことができます。

Resource

ベース URL: https://cloud.mongodb.com/api/public/v 1.0

POST /groups/{GROUP-ID}/invites/{INVITATION-ID}

リクエスト パス パラメーター

path 要素
タイプ
必要性
説明

グループ ID

string

必須

プロジェクトを識別するユニークな 24 桁の 16 進数の文字列。

リクエスト クエリ パラメータ

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

名前
タイプ
必要性
説明
default

pretty

ブール値

任意

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

false

envelope

ブール値

任意

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

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

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

名前
説明

status

HTTPレスポンス コード

content

期待される応答本体

false

リクエスト ボディ パラメータ

名前
タイプ
説明

役割

文字列の配列

招待されたユーザーに割り当てる Cloud Managerロール。

ユーザーが招待を承諾した場合、Cloud Manager はこれらのロールをユーザーに割り当てます。

username

string

Cloud Manager が招待を送信したメールアドレス。 ユーザーは、この招待を承諾した場合、このメールアドレスを Cloud Manager のユーザー名として使用します。

応答

名前
タイプ
説明

createdAt

string

ISO8601 のタイムスタンプ Cloud Manager が招待を送信したときの UTC の日時形式。

expiresAt

string

ISO8601 のタイムスタンプ 招待の有効期限が切れる UTC の日時形式。

Cloud Manager プロジェクトへの招待を承諾するには、ユーザーは 30 日間があります。

グループ ID

string

プロジェクトを識別するユニークな 24 桁の 16 進数の文字列。

groupName

string

プロジェクトの名前。

id

string

招待を識別するユニークな 24 桁の 16 進数の文字列。

inviterUsername

string

ユーザー名をプロジェクトに招待した Cloud Manager ユーザー。

役割

文字列の配列

招待されたユーザーに割り当てる Cloud Managerロール。

ユーザーが招待を承諾した場合、Cloud Manager はこれらのロールをユーザーに割り当てます。

username

string

Cloud Manager が招待を送信したメールアドレス。

ユーザーが招待を承諾した場合、Cloud Manager のユーザー名としてこのメールアドレスを使用します。

リクエストの例

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest --include \
     --header "Accept: application/json" \
     --request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{GROUP-ID}/invites?pretty=true"

応答例

応答ヘッダー

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 201 Created
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  "createdAt": "2021-02-18T18:51:46Z",
3  "expiresAt": "2021-03-20T18:51:46Z",
4  "groupId": "{GROUP-ID}",
5  "groupName": "group",
6  "id": "{INVITATION-ID}",
7  "inviterUsername": "admin@example.com",
8  "roles": [
9    "GROUP_OWNER"
10  ],
11  "username": "jane.smith@example.com"
12}

戻る

ユーザーを削除します。

次へ

削除招待