첫 번째 사용자 만들기

이 페이지의 내용

Resource

요청 경로 매개변수
요청 쿼리 매개변수
요청 본문 매개변수
응답
요청 예시
응답 예시
응답 헤더
응답 본문

MongoDB Ops Manager v6.0 는 2025 1월에 EOL됩니다. 가능한 한 빨리 상위 MongoDB Ops Manager 버전으로 업그레이드하세요.

첫 번째 MongoDB Ops Manager 사용자를 생성합니다. API 키 없이 이 엔드포인트를 호출 할 수 있습니다 .

중요

예외

MongoDB Ops Manager 가인증 에 LDAP 를 사용하는 경우 이 엔드포인트를 사용할 수 없습니다.
이 엔드포인트는 MongoDB Ops Manager가 Invitation Only Mode 에서 실행되는 경우에만 첫 번째 사용자를 생성할 수 있습니다.

MongoDB Ops Manager 는 이 엔드포인트를 통해 생성된 첫 번째 MongoDB Ops Manager 프로그래밍 방식 API 키에 GLOBAL_OWNER 역할 부여합니다. 반환된 JSON 문서 에는 추가 API 호출을 수행하는 데 사용할 수 있는 첫 번째 프로그래밍 방식 API 키가 포함되어 있습니다.

이 엔드포인트는 프로젝트나 조직을 생성하지 않습니다. 생성된 새 프로그래밍 API 키를 사용 하여 프로젝트 생성 엔드포인트를 호출할 수 있습니다. 해당 엔드포인트는 한 번의 API 호출로 프로젝트와 조직을 만들 수 있습니다. 프로젝트를 생성할 때까지 MongoDB Ops Manager에 로그인할 수 없습니다.

이 엔드포인트 를 사용하여 다음과 같은 주의 사항이 있는 추가 사용자를 만들 수 있습니다.

MongoDB Ops Manager 는 요청 에 역할 을 추가하지 않는 한 해당 후속 사용자에게 GLOBAL_OWNER 역할 을 부여하지 API 않습니다.
MongoDB Ops Manager는 후속 사용자를 위해 프로그래밍 방식 API 키를 생성하지 않습니다.

기본 URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Resource

POST /unauth/users

요청 경로 매개변수

이 엔드포인트는 HTTP 요청 경로 매개변수를 사용하지 않습니다.

요청 쿼리 매개변수

이름	유형	설명
accessList	문자열	첫 번째 MongoDB Ops Manager 사용자의 액세스 목록에 추가하려는 IP 주소입니다. `accessList` 매개변수와 값을 두 개 이상 추가할 수 있습니다.

요청 본문 매개변수

이름

유형

필요성

설명

username

문자열

필수 사항

첫 번째 MongoDB Ops Manager 사용자의 사용자 이름입니다. mms.email.validation 속성 값에 따라 유효성이 검사됩니다.

값	설명
`false`	(기본값) 사용자 아이디는 이메일 주소일 필요는 없습니다.
`loose`	사용자 이름에는 `@` 기호 뒤에 마침표가 포함되어야 합니다.
`strict`	사용자 아이디는 엄격한 이메일 주소 유효성 검사 정규식을 준수해야 합니다.

자세한 내용은 mms.email.validation 참조하십시오.

username 은 일반적으로 이메일 주소 입니다. 이 값을 이메일 주소 로 설정하다 하면 emailAddress 값을 명시적으로 설정하다 필요가 없습니다.

password

문자열

필수 사항

첫 번째 MongoDB Ops Manager 사용자의 비밀번호입니다. 이 필드는 HTTP 응답 본문에 포함되지 않습니다 . MongoDB Ops Manager는 첫 번째 MongoDB Ops Manager 사용자를 생성할 때만 HTTP 요청에서 이를 전송합니다.

emailAddress

문자열

옵션

첫 번째 MongoDB Ops Manager 사용자의 이메일 주소입니다.

firstName

문자열

필수 사항

첫 번째 MongoDB Ops Manager 사용자의 이름입니다.

lastName

문자열

필수 사항

첫 번째 MongoDB Ops Manager 사용자의 성입니다.

응답

이름	유형	설명
`programmaticApiKey`	객체	MongoDB Ops Manager에서 생성된 첫 번째 프로그래밍 방식 API 키의 세부 정보입니다.
`programmaticApiKey` `.desc`	문자열	첫 번째 프로그래밍 방식 API 키에 대한 설명입니다.
`programmaticApiKey` `.id`	문자열	첫 번째 프로그래밍 방식 API 키의 고유 식별자입니다.
`programmaticApiKey` `.links`	객체 배열	하위 리소스 및/또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 `links` 배열에는 `self` 이라는 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에 설명되어 있습니다.
`programmaticApiKey` `.privateKey`	문자열	첫 번째 프로그래밍 방식 API 키의 비밀번호 역할을 하는 31개의 영숫자 문자 및 대시입니다.
`programmaticApiKey` `.publicKey`	문자열	첫 번째 프로그래밍 방식 API 키의 사용자 이름 역할을 하는 6개의 영숫자 문자입니다.
`programmaticApiKey` `.roles`	객체 배열	첫 번째 프로그래밍 방식 API 키에 할당된 역할 입니다.
`programmaticApiKey` `.roles.roleName`	문자열	할당된 역할 의 이름입니다. MongoDB Ops Manager 는 첫 번째 프로그래밍 방식 API 키에 `Global Owner` 역할 (`GLOBAL_OWNER`)을 부여합니다.
`user`	객체	첫 번째 MongoDB Ops Manager 사용자의 세부 정보입니다.
`user` `.emailAddress`	문자열	첫 번째 MongoDB Ops Manager 사용자의 이메일 주소입니다.
`user` `.firstName`	문자열	첫 번째 MongoDB Ops Manager 사용자의 이름입니다.
`user` `.id`	문자열	첫 번째 MongoDB Ops Manager 사용자의 고유 식별자입니다.
`user` `.lastName`	문자열	첫 번째 MongoDB Ops Manager 사용자의 성입니다.
`user` `.links`	객체 배열	하위 리소스 및/또는 관련 리소스에 대한 하나 이상의 링크입니다. 응답의 모든 `links` 배열에는 `self` 이라는 링크가 하나 이상 포함되어 있습니다. URL간의 관계는 웹 링크 사양에설명되어 있습니다.
`user` `.mobileNumber`	문자열	첫 번째 MongoDB Ops Manager 사용자의 휴대폰 번호입니다.
`user` `.roles`	객체 배열	첫 번째 MongoDB Ops Manager 사용자에게 할당된 역할 입니다.
`user` `.roles.roleName`	문자열	할당된 역할 의 이름입니다. MongoDB Ops Manager 는 첫 번째 MongoDB Ops Manager 사용자에게 `Global Owner` 역할 (`GLOBAL_OWNER`)을 부여합니다.
`user` `.teamIds`	문자열 배열	첫 번째 MongoDB Ops Manager 사용자가 속한 팀의 고유 식별자 목록입니다.
`user` `.username`	문자열	첫 번째 MongoDB Ops Manager 사용자의 사용자 이름입니다.

요청 예시

curl --digest \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --include \
     --request POST "https://<OpsManagerHost>:<Port>/api/public/v1.0/unauth/users?pretty=true&accessList=1.2.3.4&accessList=2.3.4.5" \
     --data '
       {
         "username": "jane.doe@example.com",
         "password": "Passw0rd.",
         "firstName": "Jane",
         "lastName": "Doe"
       }'

응답 예시

응답 헤더

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}

응답 본문

{
  "programmaticApiKey": {
    "desc": "Automatically generated Global API key",
    "id": "{API-KEY}",
    "links": [{
      "href": "http://<OpsManagerHost>:<Port>/api/public/v1.0/orgs/null/apiKeys/{API-KEY}",
      "rel": "self"
    }],
    "privateKey": "private key string",
    "publicKey": "public key string",
    "roles": [{
      "roleName": "GLOBAL_OWNER"
    }]
  },
  "user": {
    "emailAddress": "jane.doe@example.com",
    "firstName": "Jane",
    "id": "{USER-ID}",
    "lastName": "Doe",
    "links": [
      {
       "href" : "https://<OpsManagerHost>:<Port>/api/public/v1.0/users/{USER-ID}",
       "rel" : "self"
      }
    ],
    "roles": [
      {
        "roleName": "GLOBAL_OWNER"
      }
    ],
    "username": "jane.doe@example.com"
  }
}

돌아가기

한 명의 사용자에 대해 역할 업데이트

한 명의 사용자 제거