mongocli ops-manager admin backup s3 list

On this page

Syntax

Options
Output
Examples

This version of the documentation is archived and no longer supported. View the current documentation to learn how to upgrade your version of MongoCLI.

Note

You must be a Global Owner to run admin commands.

The admin backup s3 list command retrieves the list of backup S3 blockstore configurations for your Ops Manager deployment. You can also list S3 configurations using the API, or view S3 configurations in the Administration Console.

Syntax

mongocli ops-manager|om admin backup s3 list|ls
     [ --limit <items-per-page> ]
     [ --output|-o <output-format> ]
     [ --page <page-number> ]
     [ --profile|-P <profile-name> ]

Note

Use -h or --help to view the command-line help for this command.

Options

Option	Type	Description	Required?
`--limit`	integer	Number of items to return per page, up to a maximum of 500. Defaults to `100` if not specified.	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 Go template file If omitted, the command returns output in the default format.	no
`--page`	integer	Page number (1-based). Defaults to `1` if not specified.	no
`--profile`, `-P`	string	Name of the profile where the public and private keys for accessing Ops Manager are saved. If omitted, uses the default profile. To learn more about creating a profile, see Configure the MongoDB CLI.	no

Output

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.

NAME    URI                SSL        LOAD FACTOR  AUTH METHOD
<name>  <hostname>:<port>  <boolean>  <integer>    <s3-auth-method>

The default output is a subset of the fields returned by this command. For the complete list of JSON fields returned by the command, see the Public API reference for your MongoDB service:

Ops Manager API

Examples

The following command retrieves the list of S3 blockstore configurations using the default profile, which contains Global Owner Ops Manager credentials. The output is returned in the default format.

mongocli ops-manager admin backup s3 list

The previous command prints the following to the terminal.

NAME               URI                        SSL    LOAD FACTOR   AUTH METHOD
s3BackupExample    mongodb://127.0.0.1:27017  false  1

The following command retrieves the list of S3 blockstore configurations using the default profile, which contains Global Owner Ops Manager credentials. The output is returned in JSON format.

mongocli ops-manager admin backup s3 list -o json

The previous command prints the following to the terminal in JSON format.

{
  "links": [
    {
      "rel": "self",
      "href": "http://example-ops-manager.com:8080/api/public/v1.0/admin/backup/snapshot/s3Configs?pageNum=1\u0026itemsPerPage=100"
    }
  ],
  "results": [
    {
      "id": "s3BackupExample",
      "uri": "mongodb://127.0.0.1:27017",
      "ssl": false,
      "assignmentEnabled": true,
      "encryptedCredentials": false,
      "loadFactor": 1,
      "awsAccessKey": "access",
      "awsSecretKey": "secret",
      "s3BucketEndpoint": "https://s3.us-east-1.amazonaws.com/bucketExample/",
      "s3BucketName": "bucketExample",
      "s3MaxConnections": 50,
      "acceptedTos": true,
      "sseEnabled": false,
      "pathStyleAccessEnabled": false
    }
  ],
  "totalCount": 1
}

Back

Describe a Backup S3 Blockstore Configuration

Create a Backup S3 Blockstore Configuration