SSH 키

Cloud Manager는 2024년 8월 30일부터 더 이상 MongoDB 3.6 및 4.0에 대한 자동화, 백업 및 모니터링을 지원하지 않습니다. MongoDB 배포를 업그레이드하거나 Atlas로 마이그레이션하세요.

참고

그룹과 프로젝트는 동의어입니다. {PROJECT-ID}는 프로젝트 ID와 동일합니다. 기존 그룹의 경우, 그룹/프로젝트 ID는 동일하게 유지됩니다. 이 페이지에서는 설명에 대해 얘기할 때 더욱 친숙한 용어 그룹을 사용합니다. 엔드포인트는 문서에 명시된 대로 유지됩니다.

sshKeys 리소스 에는 Cloud Manager와 cloud 서비스 제공자 의 통합을 통해 서버를 프로비저닝할 때 선택할 수 있는 공개 키가 표시됩니다. 새 서버 를 프로비저닝하면 Cloud Manager 가 서버의 인증된 키 목록에 공개 키를 추가합니다. 프로비저닝된 서버 에 로그 하려면 해당 비공개 키가 있어야 합니다.

Cloud Manager 와 cloud 서비스 제공자 간의 통합에 대한 자세한 내용은 서버 프로비저닝을 참조하세요.

기본 URL: https://cloud.mongodb.com/api/public/v1.0

엔드포인트

프로젝트의 모든 SSH 키 가져오기

GET /groups/{PROJECT-ID}/sshKeys

ID 로 SSH 키 가져오기

GET /groups/{PROJECT-ID}/sshKeys/KEY-ID

이름으로 SSH 키 가져오기

GET /groups/{PROJECT-ID}/sshKeys/byName/KEY-NAME

SSH 키 추가

POST /groups/{PROJECT-ID}/sshKeys

SSH 키 삭제

DELETE /groups/{PROJECT-ID}/sshKeys/KEY-ID

샘플 엔터티

{
  "id" : "545e3e3ae4b08a04fbc21005",
  "name" : "myKey",
  "publicKey" : "<ssh-key>",
  "links" : []
}

엔터티 필드

이름	유형	설명
id	문자열	고유 식별자입니다.
이름	문자열	Cloud Manager Provisioning Settings 에 표시되는 공개 키의 이름입니다. 프로비저닝에 대한 자세한 내용은 프로비저닝 서버를 참조하세요.
publicKey	문자열	공개 키의 내용입니다.

링크

관계	설명
self	나
`http://mms.mongodb.com/group`	SSH 키가 속한 프로젝트

예시

모든 SSH 키 가져오기

요청

curl -u "username:apiKey" --digest -i "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/sshKeys"

응답

응답 헤더

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}

응답 본문

{
  "totalCount" : 1,
  "results" : [ {
    "id" : "545e3e3ae4b08a04fbc21005",
    "name" : "myKey",
    "publicKey" : "<ssh-key>",
    "links" : []
  }, { ...} ],
  "links" : []
}

ID 로 SSH 키 가져오기

요청

curl -u "username:apiKey" --digest -i "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/sshKeys/545e3e3ae4b08a04fbc21005"

응답

응답 헤더

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}

응답 본문

{
  "id" : "545e3e3ae4b08a04fbc21005",
  "name" : "myKey",
  "publicKey" : "<ssh-key>",
  "links" : []
}

SSH 키 추가

요청

curl -u "username:apiKey" --digest -i -H "Content-Type: application/json" -X POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/sshKeys" --data '
{
  "name" : "myKey",
  "publicKey" : "<ssh-key>"
}'

응답

HTTP/1.1 201 Created
{
  "id" : "54c7a8bee4b0b5a9451be44e",
  "name" : "myKey",
  "publicKey" : "<ssh-key>",
  "links" : []
}

SSH 키 삭제

요청

curl -u "username:apiKey" --digest -i -X DELETE "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/sshKeys/545e3e3ae4b08a04fbc21005"

응답

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}

이 엔드포인트는 응답 본문을 반환하지 않습니다.