1 つの API キーを取得

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

Resource

GET /orgs/{ORG-ID}/apiKeys/{API-KEY-ID}

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

名前	タイプ	説明
`ORG-ID`	string	API キーを取得する組織の一意の識別子。認証済みユーザーがアクセスできるすべての組織を取得するには、 /orgsエンドポイントを使用します。
`API-KEY-ID`	string	検索する対象の API キーの一意の識別子。認証済みユーザーがアクセスできる指定された組織のすべての API キーを検索するには、 /orgs/{ORG-ID}/apiKeys エンドポイントとなる接続されたデバイスをリクエストします。

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

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

名前	タイプ	説明	default
pageNum	integer	ページ番号（1 インデックスベース）。	`1`
itemsPerPage	integer	1 ページあたりに返す項目の数は最大 500 です。	`100`
pretty	ブール値	レスポンス本体を pretty-print 形式にするかどうかを示します。	`false`
envelope	ブール値	応答をエンベロープでラップするかどうかを示します。一部の API クライアントは、HTTP レスポンスヘッダーまたはステータスコードにアクセスできません。これを修正するには、クエリで `"envelope" : true` を設定します。 1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。 `status`: HTTPレスポンスコード `content`: 期待される応答本体結果のリストを返すエンドポイントの場合、 `results`オブジェクトはエンベロープです。 MongoDB Ops Manager は、レスポンス本体に`status`フィールドを追加します。	なし

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

このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。

応答

応答要素

クエリ要素envelopeをtrueに設定すると、応答はcontentオブジェクトによってラップされます。

HTTP レスポンスでは、次のオブジェクトを含む JSON document が返されます。

名前	タイプ	説明
`id`	string	API キーの一意の識別子
`links`	string	ドキュメントの配列で、サブリソースまたは関連リソースへのリンクを表し、リストページ分けなどが含まれます。詳細については、連携を参照してください。
`desc`	string	API キーの説明
`privateKey`	string	API キーの編集済み秘密キー
`publicKey`	string	API キーの公開キー
`roles`	オブジェクト配列	API キーが持つロール
`roles.{ENTITY-ID}`	string	`{ENTITY-ID}`は、このロールが適用される組織またはプロジェクトを表します。可能な値は`orgId`または`groupId`です。
`roles.roleName`	string	ロールの名前。 `users` リソースは、 MongoDB AtlasまたはMongoDB Ops Managerのいずれかでユーザーが持っているすべてのロールを返します。可能な値は次のとおりです。組織ロール `ORG_OWNER`: `Organization Owner` `ORG_MEMBER`: `Organization Member` `ORG_GROUP_CREATOR`: `Organization Project Creator` `ORG_READ_ONLY`: `Organization Read Only` プロジェクトロールグループとプロジェクトは同義語です。 `GROUP_OWNER` `GROUP_READ_ONLY` `GROUP_DATA_ACCESS_ADMIN` `GROUP_DATA_ACCESS_READ_WRITE` `GROUP_DATA_ACCESS_READ_ONLY` `GROUP_AUTOMATION_ADMIN` `GROUP_BACKUP_ADMIN` `GROUP_MONITORING_ADMIN` `GROUP_OWNER` `GROUP_USER_ADMIN`

リクエストの例

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --header "Accept: application/json" \ --header "Content-Type: application/json" \ --include \ --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/orgs/{ORG-ID}/apiKeys/{API-KEY-ID}?pretty=true"

応答例

応答ヘッダー

HTTP/1.1 401 UnauthorizedContent-Type: application/json;charset=ISO-8859-1Date: {dateInUnixFormat}WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=falseContent-Length: {requestLengthInBytes}Connection: keep-alive

HTTP/1.1 200 OKVary: Accept-EncodingContent-Type: application/jsonStrict-Transport-Security: max-age=300Date: {dateInUnixFormat}Connection: keep-aliveContent-Length: {requestLengthInBytes}X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

レスポンス本体

{  "desc" : "Test Docs Service User",  "id" : "5c47503880eef5662e1cce8d",  "links" : [ {    "href" : "https://<OpsManagerHost>:<Port>/api/public/v1.0/orgs/5980cfc70b6d98229d82e3f6/apiKeys/5c47503880eef5662e1cce8d",    "rel" : "self"  } ],  "privateKey" : "********-****-****-db2c132ca78d",  "publicKey" : "ewmaqvdo",  "roles" : [ {    "orgId" : "5980cfc70b6d97029d82e3f6",    "roleName" : "ORG_MEMBER"  }, {    "groupId" : "{PROJECT-ID}",    "roleName" : "GROUP_READ_ONLY"  }, {    "groupId" : "{PROJECT-ID}",    "roleName" : "GROUP_OWNER"  } ]}