하나의 문서 업데이트

POST /action/updateOne
AccessToken 이메일 & 비밀번호 Api key Custom jwt

컬렉션에서 단일 문서를 업데이트합니다.

body

  • dataSource 문자열 필수 사항

    연결된 MongoDB Atlas 데이터 소스의 이름입니다. 이는 일반적으로 "mongodb-atlas"이지만 데이터 소스를 생성할 때 다른 이름을 선택한 경우 앱에서 해당 이름이 다를 수 있습니다.

  • database 문자열 필수 사항

    지정된 데이터 소스에 있는 데이터베이스의 이름입니다.

  • 컬렉션 문자열 필수 사항

    지정된 데이터베이스에 있는 컬렉션의 이름입니다.

  • 필터 객체

    문서와 일치하는 MongoDB 쿼리 필터입니다. 데이터 API가 지원하는 모든 쿼리 작업자 목록은 쿼리 작업자를 참조하세요.

  • update 객체 필수 사항

    일치하는 문서에 적용할 MongoDB 업데이트 표현식입니다. 데이터 API가 지원하는 모든 업데이트 연산자 목록은 업데이트 연산자를 참조하세요.

  • 업서트 부울

    true인 경우 업데이트 필터가 기존 문서와 일치하지 않으면 필터 및 지정된 업데이트 작업을 기반으로 새 문서를 삽입합니다.

    기본값은 false 입니다.

body

  • dataSource 문자열 필수 사항

    연결된 MongoDB Atlas 데이터 소스의 이름입니다. 이는 일반적으로 "mongodb-atlas"이지만 데이터 소스를 생성할 때 다른 이름을 선택한 경우 앱에서 해당 이름이 다를 수 있습니다.

  • database 문자열 필수 사항

    지정된 데이터 소스에 있는 데이터베이스의 이름입니다.

  • 컬렉션 문자열 필수 사항

    지정된 데이터베이스에 있는 컬렉션의 이름입니다.

  • 필터 객체

    문서와 일치하는 MongoDB 쿼리 필터입니다. 데이터 API가 지원하는 모든 쿼리 작업자 목록은 쿼리 작업자를 참조하세요.

  • update 객체 필수 사항

    일치하는 문서에 적용할 MongoDB 업데이트 표현식입니다. 데이터 API가 지원하는 모든 업데이트 연산자 목록은 업데이트 연산자를 참조하세요.

  • 업서트 부울

    true인 경우 업데이트 필터가 기존 문서와 일치하지 않으면 필터 및 지정된 업데이트 작업을 기반으로 새 문서를 삽입합니다.

    기본값은 false 입니다.

응답

  • 200

    Updated

    응답 속성 숨기기 응답 속성 표시 객체
    • matchCount 필수 사항

      쿼리 필터하다 와 일치하는 문서 수입니다.

    • 수정된 개수 필수 사항

      수정된 일치하는 문서의 수입니다.

    • upsertedId 문자열

      업서트된 문서 의 _id 값입니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • matchCount 필수 사항

      쿼리 필터하다 와 일치하는 문서 수입니다.

    • 수정된 개수 필수 사항

      수정된 일치하는 문서의 수입니다.

    • upsertedId 문자열

      업서트된 문서 의 _id 값입니다.
  • 400 application/json

    요청 형식이 잘못되었거나 불완전했습니다.

    다음 중 하나입니다.
    ErrorNoAuthenticationSpecified 객체 ErrorMissingAuthenticationParameter 객체
  • 401 application/json

    인증된 사용자에게 이 엔드포인트 액세스 할 수 있는 권한이 없습니다.

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

    제공된 인증 자격 증명 일치하는 사용자가 없음을 나타냅니다.

    • 오류 문자열

      오류를 설명하는 메시지입니다.

      값은 invalid session: error finding user for endpoint입니다.

    • error_code 문자열

      오류 유형입니다.

      값은 InvalidSession입니다.

    • 링크 문자열

      실패한 작업에 대한 로그 항목 의 링크입니다.
POST / 조치/updateOne 
curl -s "https://data.mongodb-api.com/app/$CLIENT_APP_ID/endpoint/data/v1/action/updateOne" \
  -X POST \
  -H "apiKey: $API_KEY" \
  -H 'Content-Type: application/ejson' \
  -H "Accept: application/json" \
  -d '{
    "dataSource": "mongodb-atlas",
    "database": "learn-data-api",
    "collection": "tasks",
    "filter": {
      "_id": { "$oid": "64224f4d089104f1766116a5" }
    },
    "update": {
      "$set": {
        "status": "complete",
        "completedAt": { "$date": { "$numberLong": "1680105272788" } }
      }
    }
  }'
요청 예시 
{
  "filter": {
    "_id": {
      "$oid": "642f1bb5cee4111898828bf6"
    }
  },
  "update": {
    "$set": {
      "status": "complete"
    }
  },
  "upsert": false,
  "database": "todo",
  "collection": "tasks",
  "dataSource": "mongodb-atlas"
}
요청 예시 
{
  "filter": {
    "_id": {
      "$oid": "642f1bb5cee4111898828bf6"
    }
  },
  "update": {
    "$set": {
      "status": "complete"
    }
  },
  "upsert": false,
  "database": "todo",
  "collection": "tasks",
  "dataSource": "mongodb-atlas"
}
응답 예시(200) 
{
  "matchedCount": 1,
  "modifiedCount": 1
}
응답 예시(200) 
{
  "matchedCount": {
    "$numberInt": "1"
  },
  "modifiedCount": {
    "$numberInt": "1"
  }
}
응답 예시(400) 
{
  "error": "no authentication methods were specified",
  "error_code": "InvalidParameter",
  "link": "string"
}
{
  "error": "must specify some form of authentication (either email+password, api-key, or jwt) in the request header or body",
  "error_code": "MissingParameter",
  "link": "string"
}
응답 예시(401) 
{
  "error": "invalid session: error finding user for endpoint",
  "error_code": "InvalidSession",
  "link": "string"
}