For AI agents: a documentation index is available at https://www.mongodb.com/docs/llms.txt — markdown versions of all pages are available by appending .md to any URL path.
Docs Menu

atlas streams instances describe

Describe an Atlas Stream Processing instance for your project.

To use this command, you must authenticate with a user account, a service account, or an API key with the Project Read Only role.

Command Syntax
atlas streams instances describe <name> [options]
Name
Type
Required
Description

name

string

true

Name of the Atlas Streams processor instance.

Name
Type
Required
Description

-h, --help

false

help for describe

-o, --output

string

false

Output format. Valid values are json, json-path, go-template, or go-template-file. To see the full output, use the -o json option.

--projectId

string

false

Hexadecimal string that identifies the project to use. This option overrides the settings in the configuration file or environment variable.

Name
Type
Required
Description

-P, --profile

string

false

Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.

If the command succeeds, the CLI returns output similar to the following sample. Values in brackets represent your values.

ID NAME CLOUD REGION
<Id> <Name> <DataProcessRegion.CloudProvider> <DataProcessRegion.Region>
# Return an Atlas Stream Processing instance with a specific name:
atlas streams instance describe myProcessor
# Return a JSON-formatted Atlas Stream Processing instance with a specific name:
atlas streams instance describe myProcessor --output json