AWS documentdb documentation change
Summary
Entire documentation file for the $$KEEP system variable was removed, including examples in MongoDB Shell, Node.js, and Python showing how to use $$KEEP with $redact stage in aggregation pipelines for document filtering.
Security assessment
This change removes documentation about a MongoDB aggregation pipeline operator ($$KEEP) used with $redact for document filtering. While $redact can be used for data access control, the removal appears to be routine documentation cleanup or restructuring rather than addressing a specific security vulnerability. There's no evidence of security incidents, vulnerabilities, or weaknesses mentioned in the removed content.
Diff
diff --git a/documentdb/latest/developerguide/KEEP.md b/documentdb/latest/developerguide/KEEP.md index 5277477ef..8b1378917 100644 --- a//documentdb/latest/developerguide/KEEP.md +++ b//documentdb/latest/developerguide/KEEP.md @@ -1 +0,0 @@ -[](/pdfs/documentdb/latest/developerguide/developerguide.pdf#KEEP "Open PDF") @@ -3,143 +1,0 @@ -[Documentation](/index.html)[Amazon DocumentDB](/documentdb/index.html)[Developer Guide](what-is.html) - -Example (MongoDB Shell)Code examples - -# $$KEEP - -The `$$KEEP` system variable is used with the `$redact` stage in the aggregation pipeline to keep the current document or field unchanged and include it in the output. - -**Parameters** - -None - -## Example (MongoDB Shell) - -The following example demonstrates the usage of `$$KEEP` in an Amazon DocumentDB aggregation pipeline. Documents are only kept if access equals "public", otherwise they are removed. - -**Create sample documents** - - - db.articles.insertMany([ - { title: "Article A", access: "public", content: "Visible content" }, - { title: "Article B", access: "private", content: "Hidden content" } - ]); - -**Query example** - - - db.articles.aggregate([ - { - $redact: { - $cond: [ - { $eq: ["$access", "public"] }, - "$$KEEP", - "$$PRUNE" - ] - } - } - ]); - -**Output** - - - [ - { - "_id" : ObjectId("..."), - "title" : "Article A", - "access" : "public", - "content" : "Visible content" - } - ] - -## Code examples - -To view a code example for using the `$$KEEP` command, choose the tab for the language that you want to use: - -Node.js - - - - const { MongoClient } = require('mongodb'); - - async function run() { - const client = new MongoClient( - 'mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0' - ); - - try { - await client.connect(); - const db = client.db('test'); - const articles = db.collection('articles'); - - const pipeline = [ - { - $redact: { - $cond: [ - { $eq: ["$access", "public"] }, - "$$KEEP", - "$$PRUNE" - ] - } - } - ]; - - const results = await articles.aggregate(pipeline).toArray(); - console.log(results); - } finally { - await client.close(); - } - } - - run().catch(console.error); - -Python - - - - from pymongo import MongoClient - - client = MongoClient( - "mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0" - ) - - db = client.test - articles = db.articles - - pipeline = [ - { - "$redact": { - "$cond": [ - {"$eq": ["$access", "public"]}, - "$$KEEP", - "$$PRUNE" - ] - } - } - ] - - results = list(articles.aggregate(pipeline)) - print(results) - - client.close() - - **Javascript is disabled or is unavailable in your browser.** - -To use the Amazon Web Services Documentation, Javascript must be enabled. Please refer to your browser's Help pages for instructions. - -[Document Conventions](/general/latest/gr/docconventions.html) - -$$DESCEND - -$$PRUNE - -Did this page help you? - Yes - -Thanks for letting us know we're doing a good job! - -If you've got a moment, please tell us what we did right so we can do more of it. - -Did this page help you? - No - -Thanks for letting us know this page needs work. We're sorry we let you down. - -If you've got a moment, please tell us how we can make the documentation better.