프로젝트 에서 Atlas 데이터베이스 사용자 만들기

POST /api/v1/atlas/projects/{project_id}/database-users
베어러 인증

사람이 호출한 사람의 위임된 토큰 또는 쌍을 이루는 Agent Engine 서비스 계정을 사용하여 Atlas 관리자 API POST /groups/{id}/databaseUsers를 프록시합니다. Agent Engine API 키는 허용되지 않습니다. 선택한 클러스터 범위가 지정된 관리자에 readWriteAnyDatabase 권한을 부여하여 플랫폼 런타임이 다른 클러스터에 대한 액세스 부여하지 않고도 프로젝트 범위의 저장 및 메모리 데이터베이스를 초기화할 수 있도록 합니다. 비밀번호는 오류 응답이나 로그에 에코되지 않습니다. 유효하지 않은 project_id는 Atlas 호출 전에 거부됩니다.

경로 매개변수

  • PROJECT_ID 문자열 필수 사항

    Atlas 프로젝트 ID

application/json
body 객체 필수 사항

생성할 데이터베이스 사용자

다음 중 하나입니다.
객체-1 객체 객체

응답

  • 406

    지원되지 않거나 잘못된 API 버전, 선택한 게시된 계약에서 사용할 수 없는 작업 또는 허용되지 않는 표현(지원되지 않는 미디어 유형 매개변수 또는 제외된 SSE 포함). 기존 인증, 권한 부여 및 속도 제한 실패가 우선적으로 적용됩니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • badRequestDetail 객체

      표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.

      badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
      • 필드 배열[객체]

        유효성 검사 에 실패한 필드입니다.

        필드 속성 숨기기 필드 속성 표시 객체

        필드 및 해당 유효성 검사 실패.

        • description 문자열 필수 사항

          사람이 읽을 수 있는 유효성 검사 실패.

        • 필드 문자열 필수 사항

          잘못된 요청 필드 의 이름 또는 경로입니다.

    • 세부 정보 문자열 필수 사항

      사람이 읽을 수 있는 오류 세부 정보.

    • 오류 integer 필수 사항

      HTTP status code.

    • 오류 코드 문자열 필수 사항

      기계가 읽을 수 있는 오류 코드입니다.

    • 매개변수 array[string]

      오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.

    • 이유 문자열 필수 사항

      HTTP 상태 이유 구문입니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • badRequestDetail 객체

      표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.

      badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
      • 필드 배열[객체]

        유효성 검사 에 실패한 필드입니다.

        필드 속성 숨기기 필드 속성 표시 객체

        필드 및 해당 유효성 검사 실패.

        • description 문자열 필수 사항

          사람이 읽을 수 있는 유효성 검사 실패.

        • 필드 문자열 필수 사항

          잘못된 요청 필드 의 이름 또는 경로입니다.

    • 세부 정보 문자열 필수 사항

      사람이 읽을 수 있는 오류 세부 정보.

    • 오류 integer 필수 사항

      HTTP status code.

    • 오류 코드 문자열 필수 사항

      기계가 읽을 수 있는 오류 코드입니다.

    • 매개변수 array[string]

      오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.

    • 이유 문자열 필수 사항

      HTTP 상태 이유 구문입니다.
  • 201

    생성됨

    응답 속성 숨기기 응답 속성 표시 객체
    • 사용자 이름 문자열
    응답 속성 숨기기 응답 속성 표시 객체
    • 사용자 이름 문자열
  • 400

    잘못된 요청

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 401

    승인되지 않음

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 402

    ATLAS_PAYMENT_METHOD_REQUIRED

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 403

    ATLAS_PERMISSION_REQUIRED, ATLAS_SERVICE_ACCOUNT_NOT_PAIRED 또는 FORBIDDEN

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 404

    NOT_FOUND

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 409

    충돌

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 413

    요청 본문이 너무 큼

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 500

    INTERNAL_ERROR

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 502

    잘못된 게이트웨이

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 503

    위임된 토큰 새로 고침이 이미 진행 중인 경우 PLATFORM_OAUTH_NOT_CONFIGURED 또는 SERVICE_UNAVAILABLE

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
POST /api/v1/atlas/projects/{project_id}/database-users 
curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/atlas/projects/{project_id}/database-users' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json"
요청 예시 
{}
{
  "cluster_name": "string",
  "password": "string",
  "username": "string"
}
응답 예시(406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
응답 예시(406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
응답 예시(201) 
{
  "username": "string"
}
응답 예시(201) 
{
  "username": "string"
}
응답 예시(400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(402) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(402) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(409) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(409) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(413) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(413) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(503) 
{
  "code": "string",
  "error": "string",
  "success": true
}
응답 예시(503) 
{
  "code": "string",
  "error": "string",
  "success": true
}