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