Navigation

mongocli cloud-manager maintenanceWindow create

The maintenanceWindow create command creates one Cloud Manager maintenance window for the specified project. You can also create a maintenance window through the API.

mongocli cloud-manager|cm maintenanceWindow create
--startDate <start-date>
--endDate <end-date>
--alertType <alert-type>
[ --desc <description> ]
[ --output|-o <output-format> ]
[ --profile|-P <profile-name> ]
[ --projectId <project-ID> ]
Option
Type
Description
Required?
--startDate
string
Timestamp in ISO 8601 date and time format in UTC when the maintenance window starts.
yes
--endDate
string
Timestamp in ISO 8601 date and time format in UTC when the maintenance window ends.
yes
--alertType
string
Comma-separated list of alert types to silence during maintenance window. For example: HOST,REPLICA_SET,CLUSTER,AGENT,BACKUP
yes
--desc
string
Description of the maintenance window.
no
--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 the Go template file

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

no
--profile, -P
string
Name of the profile where the public and private keys for the project are saved. 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. 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.

Maintenance window <window-id> successfully created.

The following example uses the mongocli cm maintenanceWindow create command to create a maintenance window. It uses a profile called myCm and specifies JSON output.

mongocli cm maintenanceWindow create \
--startDate 2020-10-23T22:00:00Z \
--endDate 2020-10-24T22:00:00Z \
--alertType HOST,BACKUP \
--desc "One-day maintenance window" \
-P myCm -o json

The above command produces the following output. For more information about these fields, see Output.

{
"id": "5f7cb0eec902201990cb1506",
"groupId": "5f1f39ffc902201990f53873",
"created": "2020-10-06T18:01:18Z",
"startDate": "2020-10-23T22:00:00Z",
"endDate": "2020-10-24T22:00:00Z",
"updated": "2020-10-06T18:05:29Z",
"alertTypeNames": [
"BACKUP",
"HOST"
],
"description": "One-day maintenance window"
}
Give Feedback