/ /

Unsupported Commands in Atlas Clusters

This page compares command support for Free clusters, Flex clusters, M10+ Atlas Core clusters, and M10+ Atlas Infinite clusters in the following sections:

Unsupported Commands lists MongoDB commands and shell methods that Atlas doesn't support, organized by command category.
Unsupported Command Line Options lists mongodump and mongorestore options that Atlas doesn't support.
Limited Commands lists commands that Atlas supports with restrictions for each cluster type.

Atlas requires clients to authenticate to access an Atlas cluster. Atlas provides a curated list of Database User Privileges that grant access to a subset of MongoDB commands. The tables in the Unsupported Commands section list the commands that fall outside this subset for each cluster type.

Atlas Free, Flex, and Infinite clusters don't support all functionality available to other clusters. To learn more, see:

Unsupported Commands

The following tables list the MongoDB commands, shell methods, and privilege actions that Atlas doesn't support, by cluster type. To ensure cluster stability and performance, Atlas automates the functionality that these commands provide. Atlas restricts other commands based on a cluster's tier or database edition.

A indicates that the cluster type doesn't support the command.

Note

If you use an unsupported command or invalid syntax in Free clusters and Flex clusters, Atlas returns the following error message:

 <$command> is not allowed or the syntax is incorrect,
 see the Atlas documentation for more information.

To learn more about valid syntax, see Database Commands

Administrative

Command	Shell Method	Privilege Actions
`applyOps`
`autoCompact`		`compact`
`cloneCollection`
`cloneCollectionAsCapped`
`compact`		`compact`
`dropConnections`		`dropConnections`
`enableFreeMonitoring`
`eval`	`db.eval()`
`fsync`	`db.fsyncLock()`	`fsync`
`fsyncUnlock`	`db.fsyncUnlock()`	`unlock`
`getAuditConfig`
`logApplicationMessage`		`applicationMessage`
`logRotate`		`logRotate`
`reIndex`		`reIndex`
`repairCursor`
`repairDatabase`
`rotateCertificates`		`rotateCertificates`
`setAuditConfig`
`setClusterParameter`
`setDefaultRWConcern`		`setDefaultRWConcern`
`setFeatureCompatibilityVersion`
`setIndexCommitQuorum`
`setLogLevel`
`setParameter`	`db.setLogLevel()` Others that use `setParameter`.	`setParameter`
`shutdown`	`db.shutdownServer()`	`shutdown`

Aggregation

Command	Shell Method	Privilege Actions	Free and Flex	M10+ Core	M10+ Infinite
	`db.collection.getSearchIndexes()`
`mapReduce`
`shardedFinish`

Authentication

Command	Shell Method	Privilege Actions	Free and Flex	M10+ Core	M10+ Infinite
`authenticate`
`authSchemaUpgrade`
`copydbgetnonce`
`copydbsaslstart`

Diagnostic

Command	Shell Method	Privilege Actions
`currentOpCtx`
`dataSize`
`dbHash`		`dbHash`
`forcerror`
`getDiagnosticData`
`getPrevError`
`handshake`
`hostInfo`
`lockInfo`
	`setProfilingLevel`
`validate`

Query Plan Cache

Command	Shell Method	Privilege Actions	Free and Flex	M10+ Core	M10+ Infinite
`$planCacheStats`
`planCacheClear`
`planCacheClearFilters`
`planCacheListFilters`
`planCacheListPlans`
`planCacheListQueryShapes`
`planCacheSetFilter`
`$querySettings`
`removeQuerySettings`
`setQuerySettings`

Replication

Command	Shell Method	Privilege Actions
`appendOplogNote`
`replSetDeclareElectionWinner`
`replSetElect`
`replSetFreeze`	`rs.freeze()`	`replSetStateChange`
`replSetFresh`
`replSetGetConfig`
`replSetGetRBID`
`replSetGetStatus`
`replSetHeartbeat`
`replSetInitiate`	`rs.initiate()`
`replSetMaintenance`		`replSetStateChange`
`replSetReconfig`	`rs.reconfig()`
`replSetResizeOplog`
`replSetRequestVotes`
`replSetStepDown`	`rs.stepDown()`	`replSetStateChange`
`replSetStepUp`
`replSetSyncFrom`	`rs.syncFrom()`	`replSetStateChange`
`replSetUpdatePosition`
`resync`		`resync`

Sessions

Command	Shell Method	Privilege Actions	Free and Flex	M10+ Core	M10+ Infinite
`killAllSessions`
`killAllSessionsByPattern`
`killAnySession`
`killSessions`
`$listLocalSessions`
`$listSessions`

Sharding

Command	Shell Method	Privilege Actions
`_migrateClone`
`_recvChunkAbort`
`_recvChunkCommit`
`_recvChunkStart`
`_recvChunkStatus`
`_transferMods`
	`sh.disableBalancing()` [1]
	`sh.enableBalancing()` [1]
`abortRewriteCollection`		`rewriteCollection`
`cleanupOrphaned`
`getShardMap`
`refineCollectionShardKey` [2]		`refineCollectionShardKey`
`removeShard`		`removeShard`
`reshardCollection`	`sh.reshardCollection()`	`reshardCollection`
`rewriteCollection`		`rewriteCollection`
`unshardCollection`	`sh.unshardCollection()`	`unshardCollection`

[1]	(1, 2) You can use `setAllowMigrations` to control the balancing of a specific collection.

[2]	This command is not supported on global write clusters only.

User and Role Management

Note

As an alternative, see the available Atlas User Roles.

Command	Shell Method	Privilege Actions
`createRole`	`db.createRole()`	`createRole`
`createUser`	`db.createUser()`	`createUser`
`dropAllRolesFromDatabase`	`db.dropAllRoles()`	`dropRole`
`dropAllUsersFromDatabase`	`db.dropAllUsers()`	`dropUser`
`dropRole`	`db.dropRole()`	`dropRole`
`dropUser`	`db.dropUser()`	`dropUser`
`getUser` [3]	`db.getUser()` and `db.getUsers()` [3]
`grantPrivilegesToRole`
`grantRolesToRole`
`grantRolesToUser`	`db.grantRolesToUser()`	`grantRole`
`invalidateUserCache`		`invalidateUserCache`
`revokePrivilegesFromRole`	`db.revokePrivilegesFromRole()`	`revokeRole`
`revokeRolesFromRole`	`db.revokeRolesFromRole()`	`revokeRole`
`revokeRolesFromUser`	`db.revokeRolesFromUser()`	`revokeRole`
`updateRole`	`db.updateRole()`
`updateUser`	`db.updateUser()`
`usersInfo`

[3]	(1, 2) You can call `getUser` for your own user account.

Unsupported Command Line Options

Atlas doesn't support the following command line tool options. A indicates that the cluster type doesn't support the option.

Option	Command Line Tool	Free and Flex	M10+ Core	M10+ Infinite
--restoreDbUsersAndRoles	`mongorestore`
--oplogReplay	`mongorestore`
--preserveUUID	`mongorestore`
--dumpDbUsersAndRoles	`mongodump`
--oplog	`mongodump`

Limited Commands

Atlas supports the following commands with limits.

Free and Flex

You can run the following commands with limits in Free clusters and Flex clusters:

Command

Limit

aggregate

Limits the maxTimeMs parameter to 300 seconds (300000).
Ignores the allowDiskUse parameter.
Doesn't support $accumulator and $function operators.
Doesn't support the $$USER_ROLES system variable.

count

Doesn't support the $where operator.
Limits the count operation on the local database to the system.replset and oplog.rs collections.

dbStats

Free clusters and Flex clusters don't allow the dbStats command on the local and config databases.

To learn more, see Operational Limits.

distinct

Doesn't support $where operator.

find

Doesn't support the $where operator.
Doesn't support the $$USER_ROLES system variable.
Ignores the allowDiskUse parameter.
Limits the find operation on the local database to the oplog.rs collection.
Limits the find operation to using an equality condition when querying the ns field in the oplog.rs collection on the local database.
{ "ns" : "test.foo" }

getParameter

Limits execution to these two documents:

{ "getParameter": 1, "authSchemaVersion": 1 }
{ "getParameter": 1, "authenticationMechanisms": 1 }

db.killOp()

Limits the db.killOp() method to the MongoDB user who ran the operation.

collection.updateOne()

Doesn't support the $$USER_ROLES system variable.

collection.updateMany()

Doesn't support the $$USER_ROLES system variable.

findAndModify

Doesn't support the $$USER_ROLES system variable.

serverStatus

Limits response to the following fields:

$clusterTime.clusterTime
$clusterTime.operationTime
$clusterTime.signature.hash
$clusterTime.signature.keyId
$clusterTime.signature
asserts.msg
asserts.regular
asserts.rollovers
asserts.user
asserts.warning
atlasVersion.gitVersion
atlasVersion.version
connections.available
connections.current
connections.totalCreated
extra_info.note
extra_info.page_faults
host
localTime
mem.bits
mem.mapped
mem.mappedWithJournal
mem.resident
mem.supported
mem.virtual
metrics.atlas.bytesInWrites
metrics.atlas.connectionPool.totalCreated
network.bytesIn
network.bytesOut
network.numRequests
ok
opcounters.command
opcounters.delete
opcounters.getmore
opcounters.insert
opcounters.query
opcounters.update
opcountersRepl.command
opcountersRepl.delete

opcountersRepl.getmore
opcountersRepl.insert
opcountersRepl.query
opcountersRepl.update
pid
process
repl.electionId
repl.hosts[]
repl.ismaster
repl.lastWrite.lastWriteDate
repl.lastWrite.majorityOpTime.t
repl.lastWrite.majorityOpTime.ts
repl.lastWrite.majorityWriteDate
repl.lastWrite.opTime.t
repl.lastWrite.opTime.ts
repl.me
repl.primary
repl.rbid
repl.secondary
repl.setName
repl.setVersion
repl.tags.nodeType
repl.tags.provider
repl.tags.region
repl.tags
storageEngine.backupCursorOpen
storageEngine.dropPendingIdents
storageEngine.name
storageEngine.oldestRequiredTimestampForCrashRecovery
storageEngine.persistent
storageEngine.readOnly
storageEngine.supportsCommittedReads
storageEngine.supportsPendingDrops
storageEngine.supportsSnapshotReadConcern
uptime
uptimeEstimate
uptimeMillis
version

M10+ Core

Atlas limits the db.killOp() method to the MongoDB user who ran the operation.

Atlas doesn't support the killAllSessions command unless the database user has:

the killAnySession privilege, or
the killOpSession role.

Atlas supports the following sharding commands on only M30+ sharded Atlas Core clusters.

Command	Shell Method	Privilege Action
`abortRewriteCollection`		`rewriteCollection`
`reshardCollection`	`sh.reshardCollection()`	`reshardCollection`
`rewriteCollection`		`rewriteCollection`
`unshardCollection`	`sh.unshardCollection()`	`unshardCollection`

M10+ Infinite

Atlas limits the db.killOp() method to the MongoDB user who ran the operation.

Atlas doesn't support the killAllSessions command unless the database user has:

the killAnySession privilege, or
the killOpSession role.

Atlas Infinite clusters only support the profile command when the database profiler level is 0.

Contact Support

Contact Atlas support if your use case requires access to a command that the Atlas database user privileges don't currently support.

Back

Free Cluster Limits

Supported Commands