mongocli atlas whitelist describe

On this page

The whitelist describe command retrieves details about the specified whitelist entry in the specified Atlas project. You can also retrieve details about a whitelist entry through the Atlas UI or API.


mongocli atlas cluster describe <whitelist-entry>
     [ --output|-o <output-format> ]
     [ --profile|-P <profile-name> ]
     [ --projectId <project-ID> ]


Option Type Description Required?
<whitelist-entry> string IP address, CIDR block, or AWS security group ID of the whitelist entry to retrieve. yes
--output, -o string

Command output format. Valid values are:

  • json for output in JSON format
  • go-template for custom output using the Go template
  • go-template-file for custom output specified using Go template file

If omitted, the command returns output in the default format.

--profile, -P string Name of the profile where the public and private keys for the project are set. If omitted, uses the default profile. To learn more about creating a profile, see Configure the MongoDB CLI. no
--projectId string Unique identifier of the project that contains the cluster to update. If omitted, uses the project ID in the profile or environment variable. no


The command prints the following fields in the specified format to the terminal if the command succeeds. If the command prints an error, see Troubleshooting for recommended solutions.

Field Description
groupId Unique identifier of the project.
cidrBlock Whitelist entry in Classless Inter-Domain Routing (CIDR) notation. Mutually exclusive with awsSecurityGroup and ipAddress.
ipAddress Whitelisted IP address. Mutually exclusive with awsSecurityGroup and ciderBlock.
deleteAfter Date in ISO 8601 format after which Atlas deletes the whitelist entry.
awsSecurityGroup Whitelisted ID of an AWS security group. Mutually exclusive with cidrBlock and ipAddress.
comment Description of the whitelist entry.


The following example uses the mongocli atlas whitelist describe command to retrieve details about the whitelist entry It uses the default profile to access the Atlas project that contains the whitelist.

mongocli atlas whitelist describe --output json --projectId 5e1234c17a3e5a48f5497de3

The example command prints the following fields to the terminal. To learn more about these fields, see Output.

 "groupId": "5e1234c17a3e5a48f5497de3",
 "cidrBlock": "",
 "ipAddress": "",
 "comment": "Sample"