Docs Menu
Docs Home
/
MongoDB Cloud Manager
/ / / /

招待状 ID を使用して 1 つの組織の招待状を更新

項目一覧

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

指定した Cloud Manager 組織に対して、 {INVITATION-ID}による保留中の招待 1 件を更新します。

組織に対するすべての保留中の招待の ID を取得するには、 「すべての組織の招待状を取得」エンドポイントを使用します。

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

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

PATCH /orgs/{ORG-ID}/invites/{INVITATION-ID}
path 要素
タイプ
必要性
説明
ORG-ID
string
必須
組織を識別する一意な 24 桁の 16 進数のstring 。
招待ID
string
必須
招待を識別するユニークな 24 桁の 16 進数の文字列。

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

名前
タイプ
必要性
説明
default
pretty
ブール値
任意
false
envelope
ブール値
任意

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

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

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

名前
説明
status
HTTPレスポンス コード
content
期待される応答本体
false
Body Parameter
タイプ
必要性
説明
役割
文字列の配列
必須

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

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

重要: Cloud Managerは、招待内のロールをこのリクエストで提供したロールに置き換えます。 このリクエストには、ユーザーに割り当てるすべてのロールを含めてください。

名前
タイプ
説明
createdAt
string
ISO8601 のタイムスタンプ Cloud Manager が招待を送信したときの UTC の日時形式。
expiresAt
string

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

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

id
string
招待を識別するユニークな 24 桁の 16 進数の文字列。
inviterUsername
string
ユーザー名を組織に招待した Cloud Manager ユーザー。
orgId
string
組織を識別する一意な 24 桁の 16 進数のstring 。
orgName
string
組織名。
役割
文字列の配列

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

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

teamIds
文字列の配列
ユーザーが参加するように招待されたチームを識別する一意な 24 桁の 16 進数の文字列。
username
string

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

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

1curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest --include \
2 --header "Accept: application/json" \
3 --header "Content-Type: application/json" \
4 --request PATCH "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invites/{INVITATION-ID}?pretty=true" \
5 --data '
6 {
7 "roles": [
8 "ORG_OWNER"
9 ]
10 }'
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 "createdAt": "2021-02-18T21:05:40Z",
3 "expiresAt": "2021-03-20T21:05:40Z",
4 "id": "{INVITATION-ID}",
5 "inviterUsername": "admin@example.com",
6 "orgId": "{ORG-ID}",
7 "orgName": "{ORG-NAME}",
8 "roles": [
9 "ORG_OWNER"
10 ],
11 "teamIds": [],
12 "username": "wyatt.smith@example.com"
13}

戻る

招待を 1 つ受け取る