Atualizar um documento

POSTAR /action/updateOne
Token de acesso E-mail e senha Api key Custom jwt

Atualizar um único documento em uma collection.

corpo, corpo

  • dataSource string Obrigatório

    O nome de uma fonte de dados vinculada do MongoDB Atlas. Normalmente é "mongodb-atlas", embora isso possa mudar em seu aplicativo se você tiver escolhido outro nome ao criar a fonte de dados.

  • database string Obrigatório

    O nome de um banco de dados na fonte de dados especificada.

  • collection string Obrigatório

    O nome de uma collection no banco de dados especificado.

  • filtro, filtro objeto

    Um filtro de queries do MongoDB que corresponda aos documentos. Para obter uma lista de todos os operadores de query compatíveis com a Data API, consulte Operadores de query.

  • update objeto Obrigatório

    Uma expressão de atualização do MongoDB para aplicar aos documentos correspondentes. Para ver uma lista de todos os operadores de atualização compatíveis com a API de dados, consulte Operadores de atualização.

  • upsert booleano

    Quando true, se o filtro de atualização não corresponder a nenhum documento existente, insira um novo documento com base no filtro e na operação de atualização especificada.

    O valor padrão é false.

corpo, corpo

  • dataSource string Obrigatório

    O nome de uma fonte de dados vinculada do MongoDB Atlas. Normalmente é "mongodb-atlas", embora isso possa mudar em seu aplicativo se você tiver escolhido outro nome ao criar a fonte de dados.

  • database string Obrigatório

    O nome de um banco de dados na fonte de dados especificada.

  • collection string Obrigatório

    O nome de uma collection no banco de dados especificado.

  • filtro, filtro objeto

    Um filtro de queries do MongoDB que corresponda aos documentos. Para obter uma lista de todos os operadores de query compatíveis com a Data API, consulte Operadores de query.

  • update objeto Obrigatório

    Uma expressão de atualização do MongoDB para aplicar aos documentos correspondentes. Para ver uma lista de todos os operadores de atualização compatíveis com a API de dados, consulte Operadores de atualização.

  • upsert booleano

    Quando true, se o filtro de atualização não corresponder a nenhum documento existente, insira um novo documento com base no filtro e na operação de atualização especificada.

    O valor padrão é false.

Respostas

  • 200

    Atualizado

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • matchedCount Obrigatório

      O número de documentos correspondidos pelo filtro de query.

    • modifiedCount Obrigatório

      O número de documentos correspondentes que foram modificados.

    • upsertedId string

      O valor de _id do documento atualizado e inserido.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • matchedCount Obrigatório

      O número de documentos correspondidos pelo filtro de query.

    • modifiedCount Obrigatório

      O número de documentos correspondentes que foram modificados.

    • upsertedId string

      O valor de _id do documento atualizado e inserido.
  • 400 aplicação/json

    A solicitação estava malformada ou incompleta.

    Um dos seguintes:
    objeto ErrorNoAuthenticationSpecified objeto ErrorMissingAuthenticationParameter
  • 401 aplicação/json

    O usuário autenticado não tem permissão para acessar este endpoint.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto

    Indica que nenhum usuário correspondeu às credenciais de autenticação fornecidas.

    • Erro string

      Uma mensagem que descreve o erro.

      O valor é invalid session: error finding user for endpoint.

    • error_code string

      O tipo de erro.

      O valor é InvalidSession.

    • link string

      Um link para uma entrada de registro da operação com falha.
POST /ação/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" } }
      }
    }
  }'
exemplo de solicitação 
{
  "filter": {
    "_id": {
      "$oid": "642f1bb5cee4111898828bf6"
    }
  },
  "update": {
    "$set": {
      "status": "complete"
    }
  },
  "upsert": false,
  "database": "todo",
  "collection": "tasks",
  "dataSource": "mongodb-atlas"
}
exemplo de solicitação 
{
  "filter": {
    "_id": {
      "$oid": "642f1bb5cee4111898828bf6"
    }
  },
  "update": {
    "$set": {
      "status": "complete"
    }
  },
  "upsert": false,
  "database": "todo",
  "collection": "tasks",
  "dataSource": "mongodb-atlas"
}
Exemplos de resposta (200) 
{
  "matchedCount": 1,
  "modifiedCount": 1
}
Exemplos de resposta (200) 
{
  "matchedCount": {
    "$numberInt": "1"
  },
  "modifiedCount": {
    "$numberInt": "1"
  }
}
Exemplos de resposta (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"
}
Exemplos de resposta (401) 
{
  "error": "invalid session: error finding user for endpoint",
  "error_code": "InvalidSession",
  "link": "string"
}