Docs Menu
Docs Home
/ /
Atlas CLI
/ / /

atlas streams instances update

On this page

  • Syntax
  • Arguments
  • Options
  • Inherited Options
  • Output
  • Examples

Updates an Atlas Stream Processing instance for your project.

Before updating an Atlas Streams Processing instance, you must first stop all processes associated with it. To use this command, you must authenticate with a user account or an API key with the Project Owner role.

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

name

string

true

Name of the Atlas Stream Processing instance. After creation, you can't change the name of the instance. The name can contain ASCII letters, numbers, and hyphens.

Name
Type
Required
Description

-h, --help

false

help for update

-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.

--provider

string

true

Cloud service provider that applies to the provisioned Atlas Stream Processing instance. This value defaults to "AWS".

-r, --region

string

true

Human-readable label that identifies the physical location of your Atlas Stream Processing instance. The region can affect network latency and performance if it is far from your source or sink.

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.

Atlas Streams Processor Instance '<Name>' successfully updated.
# Modify the Atlas Stream Processing instance configuration with the name MyInstance:
atlas streams instance update MyInstance --provider AWS --region VIRGINIA_USA

Back

list