From 2f44fe94c4843cdfa14e2fd74d75b969215a0159 Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Wed, 24 Sep 2025 16:33:22 +0100 Subject: [PATCH 01/14] Update L1 generation to use x-gen-operation-id-override --- internal/cli/api/api.go | 12 ++++++++++-- internal/cli/auth/login_test.go | 2 +- internal/store/store_test.go | 2 +- tools/cmd/api-generator/commands.go.tmpl | 5 +++-- tools/cmd/api-generator/convert_commands.go | 21 ++++++++++++--------- tools/shared/api/api.go | 1 + 6 files changed, 28 insertions(+), 15 deletions(-) diff --git a/internal/cli/api/api.go b/internal/cli/api/api.go index 244436dc17..90dacdd43e 100644 --- a/internal/cli/api/api.go +++ b/internal/cli/api/api.go @@ -98,7 +98,15 @@ func createAPICommandGroupToCobraCommand(group shared_api.Group) *cobra.Command //nolint:gocyclo func convertAPIToCobraCommand(command shared_api.Command) (*cobra.Command, error) { // command properties - commandName := strcase.ToLowerCamel(command.OperationID) + var commandName = strcase.ToLowerCamel(command.OperationID) + var commandAliases = command.Aliases + + // Prefer to use shortOperationID if present + if command.ShortOperationID != "" { + commandName = strcase.ToLowerCamel(command.ShortOperationID) + commandAliases = append(commandAliases, strcase.ToLowerCamel(command.OperationID)) + } + shortDescription, longDescription := splitShortAndLongDescription(command.Description) // flag values @@ -114,7 +122,7 @@ func convertAPIToCobraCommand(command shared_api.Command) (*cobra.Command, error cmd := &cobra.Command{ Use: commandName, - Aliases: command.Aliases, + Aliases: commandAliases, Short: shortDescription, Long: longDescription, Annotations: map[string]string{ diff --git a/internal/cli/auth/login_test.go b/internal/cli/auth/login_test.go index a6f924bcd5..ac5221afa5 100644 --- a/internal/cli/auth/login_test.go +++ b/internal/cli/auth/login_test.go @@ -284,7 +284,7 @@ func TestLoginOpts_setUpProfile_Success(t *testing.T) { TrackAsk(gomock.Any(), opts). DoAndReturn(func(_ []*survey.Question, answer any, _ ...survey.AskOpt) error { if o, ok := answer.(*LoginOpts); ok { - o.Output = "json" //nolint:goconst + o.Output = "json" } return nil }) diff --git a/internal/store/store_test.go b/internal/store/store_test.go index 8e04548412..f7278b92dc 100644 --- a/internal/store/store_test.go +++ b/internal/store/store_test.go @@ -168,7 +168,7 @@ func TestWithContext(t *testing.T) { t.Fatalf("New() unexpected error: %v", err) } - if c.ctx != context.Background() { //nolint: usetesting // we test this value + if c.ctx != context.Background() { t.Errorf("New() got %v; expected %v", c.ctx, t.Context()) } diff --git a/tools/cmd/api-generator/commands.go.tmpl b/tools/cmd/api-generator/commands.go.tmpl index aa6470d14d..518a092cf5 100644 --- a/tools/cmd/api-generator/commands.go.tmpl +++ b/tools/cmd/api-generator/commands.go.tmpl @@ -33,8 +33,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Commands: []shared_api.Command{ {{- range .Commands }} { - OperationID: `{{ .OperationID }}`, - Aliases: {{if not .Aliases}} nil {{else}} []string{ {{ range $i, $alias := .Aliases }}{{if $i}},{{end}}`{{ $alias }}`{{end}} } {{end}}, + OperationID: `{{ .OperationID }}`, + ShortOperationID: `{{ .ShortOperationID }}`, + Aliases: {{if not .Aliases}} nil {{else}} []string{ {{ range $i, $alias := .Aliases }}{{if $i}},{{end}}`{{ $alias }}`{{end}} } {{end}}, Description: `{{ .Description }}`, RequestParameters: shared_api.RequestParameters{ URL: `{{ .RequestParameters.URL }}`, diff --git a/tools/cmd/api-generator/convert_commands.go b/tools/cmd/api-generator/convert_commands.go index 1a0cbc6589..32d24a4a6f 100644 --- a/tools/cmd/api-generator/convert_commands.go +++ b/tools/cmd/api-generator/convert_commands.go @@ -101,6 +101,7 @@ func extractSunsetDate(extensions map[string]any) *time.Time { type operationExtensions struct { skip bool operationID string + shortOperationID string operationAliases []string } @@ -108,6 +109,7 @@ func extractExtensionsFromOperation(operation *openapi3.Operation) operationExte ext := operationExtensions{ skip: false, operationID: operation.OperationID, + shortOperationID: "", operationAliases: []string{}, } @@ -131,6 +133,11 @@ func extractExtensionsFromOperation(operation *openapi3.Operation) operationExte } } + if shortOperationID, ok := operation.Extensions["x-xgen-operation-id-override"].(string); ok && shortOperationID != "" { + ext.shortOperationID = shortOperationID + ext.operationAliases = append(ext.operationAliases, strcase.ToLowerCamel(operation.OperationID)) + } + return ext } @@ -141,6 +148,7 @@ func operationToCommand(now time.Time, path, verb string, operation *openapi3.Op } operationID := extensions.operationID + shortOperationID := extensions.shortOperationID aliases := extensions.operationAliases httpVerb, err := api.ToHTTPVerb(verb) @@ -167,21 +175,16 @@ func operationToCommand(now time.Time, path, verb string, operation *openapi3.Op return nil, fmt.Errorf("failed to clean description: %w", err) } - if overrides := extractOverrides(operation.Extensions); overrides != nil { - if overriddenOperationID, ok := overrides["operationId"].(string); ok && overriddenOperationID != "" { - operationID = overriddenOperationID - } - } - watcher, err := extractWatcherProperties(operation.Extensions) if err != nil { return nil, err } command := api.Command{ - OperationID: operationID, - Aliases: aliases, - Description: description, + OperationID: operationID, + ShortOperationID: strcase.ToLowerCamel(shortOperationID), + Aliases: aliases, + Description: description, RequestParameters: api.RequestParameters{ URL: path, QueryParameters: parameters.query, diff --git a/tools/shared/api/api.go b/tools/shared/api/api.go index 4fae9962f1..7c031d802a 100644 --- a/tools/shared/api/api.go +++ b/tools/shared/api/api.go @@ -31,6 +31,7 @@ type Group struct { type Command struct { OperationID string + ShortOperationID string Aliases []string Description string RequestParameters RequestParameters From 4910323fa9da3b862243ac00994464f3298f660d Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Wed, 24 Sep 2025 16:33:36 +0100 Subject: [PATCH 02/14] Update test snapshots --- .../testdata/.snapshots/00-spec.yaml-commands.snapshot | 10 ++++++---- .../.snapshots/01-missing-tag.yaml-commands.snapshot | 10 ++++++---- .../02-multiple-content-types.yaml-commands.snapshot | 10 ++++++---- .../03-nested-parameter-types.yaml-commands.snapshot | 5 +++-- .../04-spec-with-overrides.yaml-commands.snapshot | 5 +++-- .../.snapshots/05-examples.yaml-commands.snapshot | 10 ++++++---- ...with-cli-specific-extensions.yaml-commands.snapshot | 5 +++-- .../.snapshots/07-sunset.yaml-commands.snapshot | 5 +++-- .../.snapshots/08-watchers.yaml-commands.snapshot | 10 ++++++---- ...bility-level-private-preview.yaml-commands.snapshot | 5 +++-- ...ability-level-public-preview.yaml-commands.snapshot | 5 +++-- .../11-stability-level-upcoming.yaml-commands.snapshot | 5 +++-- 12 files changed, 51 insertions(+), 34 deletions(-) diff --git a/tools/cmd/api-generator/testdata/.snapshots/00-spec.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/00-spec.yaml-commands.snapshot index 2115906375..420dcb4eb7 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/00-spec.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/00-spec.yaml-commands.snapshot @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns, adds, edits, and removes database deployments. Changes to cluster configurations can affect costs. This resource requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `createCluster`, - Aliases: nil, + OperationID: `createCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can create clusters with asymmetrically-sized shards. Each project supports up to 25 database deployments. To use this resource, the requesting API Key must have the Project Owner role. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcluster. @@ -109,8 +110,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listClusters`, - Aliases: nil, + OperationID: `listClusters`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details for all clusters in the specific project to which you have access. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting API Key must have the Project Read Only role. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclusters. diff --git a/tools/cmd/api-generator/testdata/.snapshots/01-missing-tag.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/01-missing-tag.yaml-commands.snapshot index bc3c2bd810..141fc54467 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/01-missing-tag.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/01-missing-tag.yaml-commands.snapshot @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: ``, Commands: []shared_api.Command{ { - OperationID: `createCluster`, - Aliases: nil, + OperationID: `createCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can create clusters with asymmetrically-sized shards. Each project supports up to 25 database deployments. To use this resource, the requesting API Key must have the Project Owner role. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcluster. @@ -109,8 +110,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listClusters`, - Aliases: nil, + OperationID: `listClusters`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details for all clusters in the specific project to which you have access. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting API Key must have the Project Read Only role. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclusters. diff --git a/tools/cmd/api-generator/testdata/.snapshots/02-multiple-content-types.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/02-multiple-content-types.yaml-commands.snapshot index ee238bb601..085d09d93d 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/02-multiple-content-types.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/02-multiple-content-types.yaml-commands.snapshot @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns, adds, edits, and removes database deployments. Changes to cluster configurations can affect costs. This resource requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `createCluster`, - Aliases: nil, + OperationID: `createCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can create clusters with asymmetrically-sized shards. Each project supports up to 25 database deployments. To use this resource, the requesting API Key must have the Project Owner role. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcluster. @@ -109,8 +110,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listClusters`, - Aliases: nil, + OperationID: `listClusters`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details for all clusters in the specific project to which you have access. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting API Key must have the Project Read Only role. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclusters. diff --git a/tools/cmd/api-generator/testdata/.snapshots/03-nested-parameter-types.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/03-nested-parameter-types.yaml-commands.snapshot index d40773cd52..22300f67c5 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/03-nested-parameter-types.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/03-nested-parameter-types.yaml-commands.snapshot @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns, adds, edits, and removes database deployments. Changes to cluster configurations can affect costs. This resource requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `getCollStatsLatencyNamespaceClusterMeasurements`, - Aliases: nil, + OperationID: `getCollStatsLatencyNamespaceClusterMeasurements`, + ShortOperationID: ``, + Aliases: nil, Description: `Get a list of the Coll Stats Latency cluster-level measurements for the given namespace. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespaceclustermeasurements. diff --git a/tools/cmd/api-generator/testdata/.snapshots/04-spec-with-overrides.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/04-spec-with-overrides.yaml-commands.snapshot index 1097914506..698e2eb296 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/04-spec-with-overrides.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/04-spec-with-overrides.yaml-commands.snapshot @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns, adds, edits, and removes database deployments. Changes to cluster configurations can affect costs. This resource requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `createClusterX`, - Aliases: nil, + OperationID: `createClusterX`, + ShortOperationID: ``, + Aliases: nil, Description: `OVERRIDDEN This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcluster. diff --git a/tools/cmd/api-generator/testdata/.snapshots/05-examples.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/05-examples.yaml-commands.snapshot index 2115906375..420dcb4eb7 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/05-examples.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/05-examples.yaml-commands.snapshot @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns, adds, edits, and removes database deployments. Changes to cluster configurations can affect costs. This resource requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `createCluster`, - Aliases: nil, + OperationID: `createCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can create clusters with asymmetrically-sized shards. Each project supports up to 25 database deployments. To use this resource, the requesting API Key must have the Project Owner role. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcluster. @@ -109,8 +110,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listClusters`, - Aliases: nil, + OperationID: `listClusters`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details for all clusters in the specific project to which you have access. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting API Key must have the Project Read Only role. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclusters. diff --git a/tools/cmd/api-generator/testdata/.snapshots/06-spec-with-cli-specific-extensions.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/06-spec-with-cli-specific-extensions.yaml-commands.snapshot index 185d6c8d08..c468aad869 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/06-spec-with-cli-specific-extensions.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/06-spec-with-cli-specific-extensions.yaml-commands.snapshot @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns, adds, edits, and removes database deployments. Changes to cluster configurations can affect costs. This resource requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `createCluster`, - Aliases: []string{`createDatabase`, `createServer`}, + OperationID: `createCluster`, + ShortOperationID: ``, + Aliases: []string{`createDatabase`, `createServer`}, Description: `Creates one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can create clusters with asymmetrically-sized shards. Each project supports up to 25 database deployments. To use this resource, the requesting API Key must have the Project Owner role. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcluster. diff --git a/tools/cmd/api-generator/testdata/.snapshots/07-sunset.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/07-sunset.yaml-commands.snapshot index fa613bd082..42d6c094c0 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/07-sunset.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/07-sunset.yaml-commands.snapshot @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns, adds, edits, and removes database deployments. Changes to cluster configurations can affect costs. This resource requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `listClusters`, - Aliases: nil, + OperationID: `listClusters`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details for all clusters in the specific project to which you have access. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting API Key must have the Project Read Only role. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclusters. diff --git a/tools/cmd/api-generator/testdata/.snapshots/08-watchers.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/08-watchers.yaml-commands.snapshot index a1ef8192af..344f4de731 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/08-watchers.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/08-watchers.yaml-commands.snapshot @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns, adds, edits, and removes database deployments. Changes to cluster configurations can affect costs. This resource requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `createCluster`, - Aliases: []string{`createDatabase`, `createServer`}, + OperationID: `createCluster`, + ShortOperationID: ``, + Aliases: []string{`createDatabase`, `createServer`}, Description: `Creates one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can create clusters with asymmetrically-sized shards. Each project supports up to 25 database deployments. To use this resource, the requesting API Key must have the Project Owner role. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcluster. @@ -128,8 +129,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCluster`, - Aliases: nil, + OperationID: `getCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting API Key must have the Project Read Only role. This feature is not available for serverless clusters. diff --git a/tools/cmd/api-generator/testdata/.snapshots/09-stability-level-private-preview.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/09-stability-level-private-preview.yaml-commands.snapshot index 417675d96c..8eecb0500d 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/09-stability-level-private-preview.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/09-stability-level-private-preview.yaml-commands.snapshot @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns, adds, and edits Charts Dashboard instances. This resource applies only to projects with a Charts tenant, and requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `exportChartsDashboard`, - Aliases: nil, + OperationID: `exportChartsDashboard`, + ShortOperationID: ``, + Aliases: nil, Description: `Exports the specified Charts dashboard. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-exportchartsdashboard. diff --git a/tools/cmd/api-generator/testdata/.snapshots/10-stability-level-public-preview.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/10-stability-level-public-preview.yaml-commands.snapshot index 6b5793d2da..19f28584a8 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/10-stability-level-public-preview.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/10-stability-level-public-preview.yaml-commands.snapshot @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns, adds, and edits Charts Dashboard instances. This resource applies only to projects with a Charts tenant, and requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `exportChartsDashboard`, - Aliases: nil, + OperationID: `exportChartsDashboard`, + ShortOperationID: ``, + Aliases: nil, Description: `Exports the specified Charts dashboard. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-exportchartsdashboard. diff --git a/tools/cmd/api-generator/testdata/.snapshots/11-stability-level-upcoming.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/11-stability-level-upcoming.yaml-commands.snapshot index dba2fcadc2..8d1f9a3f74 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/11-stability-level-upcoming.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/11-stability-level-upcoming.yaml-commands.snapshot @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns, adds, and edits Charts Dashboard instances. This resource applies only to projects with a Charts tenant, and requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `exportChartsDashboard`, - Aliases: nil, + OperationID: `exportChartsDashboard`, + ShortOperationID: ``, + Aliases: nil, Description: `Exports the specified Charts dashboard. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-exportchartsdashboard. From 0d0fe79e85b00af2bbdfce396e40bcde4e81721a Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Wed, 24 Sep 2025 16:42:41 +0100 Subject: [PATCH 03/14] Ran make gen-api-commands --- internal/api/commands.go | 2210 +++++++++++++++++++++++--------------- 1 file changed, 1326 insertions(+), 884 deletions(-) diff --git a/internal/api/commands.go b/internal/api/commands.go index e082c2d769..71aac85209 100644 --- a/internal/api/commands.go +++ b/internal/api/commands.go @@ -29,8 +29,9 @@ var Commands = shared_api.GroupedAndSortedCommands{ Description: `Returns and edits custom DNS configurations for MongoDB Cloud database deployments on AWS. The resource requires your Project ID. If you use the VPC peering on AWS and you use your own DNS servers instead of Amazon Route 53, enable custom DNS. Before 31 March 2020, applications deployed within AWS using custom DNS services and VPC-peered with MongoDB Cloud couldn't connect over private IP addresses. Custom DNS resolved to public IP addresses. AWS internal DNS resolved to private IP addresses. Applications deployed with custom DNS services in AWS should use Private IP for Peering connection strings.`, Commands: []shared_api.Command{ { - OperationID: `getAwsCustomDns`, - Aliases: nil, + OperationID: `getAwsCustomDns`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the custom DNS configuration for AWS clusters in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getawscustomdns. @@ -89,8 +90,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `toggleAwsCustomDns`, - Aliases: nil, + OperationID: `toggleAwsCustomDns`, + ShortOperationID: ``, + Aliases: nil, Description: `Enables or disables the custom DNS configuration for AWS clusters in the specified project. Enable custom DNS if you use AWS VPC peering and use your own DNS servers. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-toggleawscustomdns. @@ -155,8 +157,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns access logs for authentication attempts made to Atlas database deployments. To view database access history, you must have either the Project Owner or Organization Owner role.`, Commands: []shared_api.Command{ { - OperationID: `listAccessLogsByClusterName`, - Aliases: nil, + OperationID: `listAccessLogsByClusterName`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the access logs of one cluster identified by the cluster's name. Access logs contain a list of authentication requests made against your cluster. You can't use this feature on tenant-tier clusters (M0, M2, M5). To use this resource, the requesting Service Account or API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listaccesslogsbyclustername. @@ -275,8 +278,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAccessLogsByHostname`, - Aliases: nil, + OperationID: `listAccessLogsByHostname`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the access logs of one cluster identified by the cluster's hostname. Access logs contain a list of authentication requests made against your clusters. You can't use this feature on tenant-tier clusters (M0, M2, M5). To use this resource, the requesting Service Account or API Key must have the Project Monitoring Admin role or the Project Database Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listaccesslogsbyhostname. @@ -401,8 +405,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and edits the conditions that trigger alerts and how MongoDB Cloud notifies users. This collection remains under revision and may change.`, Commands: []shared_api.Command{ { - OperationID: `createAlertConfiguration`, - Aliases: nil, + OperationID: `createAlertConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one alert configuration for the specified project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. @@ -464,8 +469,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAlertConfiguration`, - Aliases: nil, + OperationID: `deleteAlertConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one alert configuration from the specified project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. @@ -537,8 +543,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getAlertConfiguration`, - Aliases: nil, + OperationID: `getAlertConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the specified alert configuration from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. @@ -610,8 +617,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAlertConfigurationMatchersFieldNames`, - Aliases: nil, + OperationID: `listAlertConfigurationMatchersFieldNames`, + ShortOperationID: ``, + Aliases: nil, Description: `Get all field names that the matchers.fieldName parameter accepts when you create or update an Alert Configuration. You can successfully call this endpoint with any assigned role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listalertconfigurationmatchersfieldnames. @@ -655,8 +663,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listAlertConfigurations`, - Aliases: nil, + OperationID: `listAlertConfigurations`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all alert configurations for one project. These alert configurations apply to any component in the project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -748,8 +757,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAlertConfigurationsByAlertId`, - Aliases: nil, + OperationID: `listAlertConfigurationsByAlertId`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all alert configurations set for the specified alert. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. @@ -851,8 +861,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `toggleAlertConfiguration`, - Aliases: nil, + OperationID: `toggleAlertConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Enables or disables the specified alert configuration in the specified project. The resource enables the specified alert configuration if currently enabled. The resource disables the specified alert configuration if currently disabled. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. @@ -927,8 +938,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateAlertConfiguration`, - Aliases: nil, + OperationID: `updateAlertConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one alert configuration in the specified project. Alert configurations define the triggers and notification methods for alerts. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. @@ -1009,8 +1021,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and acknowledges alerts that MongoDB Cloud triggers based on the alert conditions that you define. This collection remains under revision and may change.`, Commands: []shared_api.Command{ { - OperationID: `acknowledgeAlert`, - Aliases: nil, + OperationID: `acknowledgeAlert`, + ShortOperationID: ``, + Aliases: nil, Description: `Confirms receipt of one existing alert. This alert applies to any component in one project. Acknowledging an alert prevents successive notifications. You receive an alert when a monitored component meets or exceeds a value you set until you acknowledge the alert. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. @@ -1089,8 +1102,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getAlert`, - Aliases: nil, + OperationID: `getAlert`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one alert. This alert applies to any component in one project. You receive an alert when a monitored component meets or exceeds a value you set. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alerts from One Project endpoint to retrieve all alerts to which the authenticated user has access. @@ -1162,8 +1176,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAlerts`, - Aliases: nil, + OperationID: `listAlerts`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all alerts. These alerts apply to all components in one project. You receive an alert when a monitored component meets or exceeds a value you set. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -1265,8 +1280,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAlertsByAlertConfigurationId`, - Aliases: nil, + OperationID: `listAlertsByAlertConfigurationId`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all open alerts that the specified alert configuration triggers. These alert configurations apply to the specified project only. Alert configurations define the triggers and notification methods for alerts. Open alerts have been triggered but remain unacknowledged. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return All Alert Configurations for One Project endpoint to retrieve all alert configurations to which the authenticated user has access. @@ -1374,8 +1390,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes Atlas Search indexes for the specified cluster. Also returns and updates user-defined analyzers for the specified cluster.`, Commands: []shared_api.Command{ { - OperationID: `createAtlasSearchDeployment`, - Aliases: nil, + OperationID: `createAtlasSearchDeployment`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates Search Nodes for the specified cluster. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createatlassearchdeployment. @@ -1469,8 +1486,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createAtlasSearchIndex`, - Aliases: nil, + OperationID: `createAtlasSearchIndex`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one Atlas Search index on the specified collection. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. Only clusters running MongoDB v4.2 or later can use Atlas Search. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createatlassearchindex. @@ -1539,8 +1557,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createAtlasSearchIndexDeprecated`, - Aliases: nil, + OperationID: `createAtlasSearchIndexDeprecated`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one Atlas Search index on the specified collection. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. Only clusters running MongoDB v4.2 or later can use Atlas Search. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createatlassearchindexdeprecated. @@ -1609,8 +1628,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAtlasSearchDeployment`, - Aliases: nil, + OperationID: `deleteAtlasSearchDeployment`, + ShortOperationID: ``, + Aliases: nil, Description: `Deletes the Search Nodes for the specified cluster. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteatlassearchdeployment. @@ -1700,8 +1720,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAtlasSearchIndex`, - Aliases: nil, + OperationID: `deleteAtlasSearchIndex`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one Atlas Search index that you identified with its unique ID. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteatlassearchindex. @@ -1780,8 +1801,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAtlasSearchIndexByName`, - Aliases: nil, + OperationID: `deleteAtlasSearchIndexByName`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one Atlas Search index that you identified with its database, collection, and name. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This deletion is eventually consistent. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteatlassearchindexbyname. @@ -1880,8 +1902,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAtlasSearchIndexDeprecated`, - Aliases: nil, + OperationID: `deleteAtlasSearchIndexDeprecated`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one Atlas Search index that you identified with its unique ID. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteatlassearchindexdeprecated. @@ -1960,8 +1983,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getAtlasSearchDeployment`, - Aliases: nil, + OperationID: `getAtlasSearchDeployment`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the Search Nodes for the specified cluster. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlassearchdeployment. @@ -2044,8 +2068,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getAtlasSearchIndex`, - Aliases: nil, + OperationID: `getAtlasSearchIndex`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one Atlas Search index that you identified with its unique ID. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting API Key must have the Project Data Access Read Write role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlassearchindex. @@ -2124,8 +2149,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getAtlasSearchIndexByName`, - Aliases: nil, + OperationID: `getAtlasSearchIndexByName`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one Atlas Search index that you identified with its database, collection name, and index name. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting API Key must have the Project Data Access Read Write role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlassearchindexbyname. @@ -2224,8 +2250,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getAtlasSearchIndexDeprecated`, - Aliases: nil, + OperationID: `getAtlasSearchIndexDeprecated`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one Atlas Search index in the specified project. You identify this index using its unique ID. Atlas Search index contains the indexed fields and the analyzers used to create the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlassearchindexdeprecated. @@ -2304,8 +2331,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAtlasSearchIndexes`, - Aliases: nil, + OperationID: `listAtlasSearchIndexes`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all Atlas Search indexes on the specified collection. Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listatlassearchindexes. @@ -2394,8 +2422,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAtlasSearchIndexesCluster`, - Aliases: nil, + OperationID: `listAtlasSearchIndexesCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all Atlas Search indexes on the specified cluster. Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listatlassearchindexescluster. @@ -2464,8 +2493,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAtlasSearchIndexesDeprecated`, - Aliases: nil, + OperationID: `listAtlasSearchIndexesDeprecated`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all Atlas Search indexes on the specified collection. Atlas Search indexes contain the indexed fields and the analyzers used to create the indexes. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Write role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listatlassearchindexesdeprecated. @@ -2554,8 +2584,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateAtlasSearchDeployment`, - Aliases: nil, + OperationID: `updateAtlasSearchDeployment`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the Search Nodes for the specified cluster. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateatlassearchdeployment. @@ -2649,8 +2680,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateAtlasSearchIndex`, - Aliases: nil, + OperationID: `updateAtlasSearchIndex`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one Atlas Search index that you identified with its unique ID. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateatlassearchindex. @@ -2729,8 +2761,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateAtlasSearchIndexByName`, - Aliases: nil, + OperationID: `updateAtlasSearchIndexByName`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one Atlas Search index that you identified with its database, collection name, and index name. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateatlassearchindexbyname. @@ -2829,8 +2862,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateAtlasSearchIndexDeprecated`, - Aliases: nil, + OperationID: `updateAtlasSearchIndexDeprecated`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one Atlas Search index that you identified with its unique ID. Atlas Search indexes define the fields on which to create the index and the analyzers to use when creating the index. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateatlassearchindexdeprecated. @@ -2915,8 +2949,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and edits database auditing settings for MongoDB Cloud projects.`, Commands: []shared_api.Command{ { - OperationID: `getAuditingConfiguration`, - Aliases: nil, + OperationID: `getAuditingConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the auditing configuration for the specified project. The auditing configuration defines the events that MongoDB Cloud records in the audit log. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature isn't available for M0, M2, M5, or serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getauditingconfiguration. @@ -2975,8 +3010,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateAuditingConfiguration`, - Aliases: nil, + OperationID: `updateAuditingConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the auditing configuration for the specified project. The auditing configuration defines the events that MongoDB Cloud records in the audit log. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature isn't available for M0, M2, M5, or serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateauditingconfiguration. @@ -3041,8 +3077,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Manages Cloud Backup snapshots, snapshot export buckets, restore jobs, and schedules. This resource applies only to clusters that use Cloud Backups.`, Commands: []shared_api.Command{ { - OperationID: `cancelBackupRestoreJob`, - Aliases: nil, + OperationID: `cancelBackupRestoreJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Cancels one cloud backup restore job of one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-cancelbackuprestorejob. @@ -3121,8 +3158,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createBackupExportJob`, - Aliases: nil, + OperationID: `createBackupExportJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Exports one backup Snapshot for dedicated Atlas cluster using Cloud Backups to an Export Bucket. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createbackupexportjob. @@ -3202,8 +3240,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createBackupRestoreJob`, - Aliases: nil, + OperationID: `createBackupRestoreJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Restores one snapshot of one cluster from the specified project. Atlas takes on-demand snapshots immediately and scheduled snapshots at regular intervals. If an on-demand snapshot with a status of queued or inProgress exists, before taking another snapshot, wait until Atlas completes completes processing the previously taken on-demand snapshot. @@ -3275,8 +3314,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createExportBucket`, - Aliases: nil, + OperationID: `createExportBucket`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates a Snapshot Export Bucket for an AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. Once created, an snapshots can be exported to the Export Bucket and its referenced AWS S3 Bucket, Azure Blob Storage Container, or Google Cloud Storage Bucket. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createexportbucket. @@ -3342,8 +3382,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createServerlessBackupRestoreJob`, - Aliases: nil, + OperationID: `createServerlessBackupRestoreJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Restores one snapshot of one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -3415,8 +3456,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAllBackupSchedules`, - Aliases: nil, + OperationID: `deleteAllBackupSchedules`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes all cloud backup schedules for the specified cluster. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteallbackupschedules. @@ -3482,8 +3524,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteExportBucket`, - Aliases: nil, + OperationID: `deleteExportBucket`, + ShortOperationID: ``, + Aliases: nil, Description: `Deletes an Export Bucket. Auto export must be disabled on all clusters in this Project exporting to this Export Bucket before revoking access. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteexportbucket. @@ -3542,8 +3585,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteReplicaSetBackup`, - Aliases: nil, + OperationID: `deleteReplicaSetBackup`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes the specified snapshot. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletereplicasetbackup. @@ -3637,8 +3681,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteShardedClusterBackup`, - Aliases: nil, + OperationID: `deleteShardedClusterBackup`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one snapshot of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteshardedclusterbackup. @@ -3717,8 +3762,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `disableDataProtectionSettings`, - Aliases: nil, + OperationID: `disableDataProtectionSettings`, + ShortOperationID: ``, + Aliases: nil, Description: `Disables the Backup Compliance Policy settings with the specified project. As a prerequisite, a support ticket needs to be file first, instructions in https://www.mongodb.com/docs/atlas/backup/cloud-backup/backup-compliance-policy/. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disabledataprotectionsettings. @@ -3794,8 +3840,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getBackupExportJob`, - Aliases: nil, + OperationID: `getBackupExportJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one Cloud Backup Snapshot Export Job associated with the specified Atlas cluster. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getbackupexportjob. @@ -3864,8 +3911,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getBackupRestoreJob`, - Aliases: nil, + OperationID: `getBackupRestoreJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one cloud backup restore job for one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getbackuprestorejob. @@ -3944,8 +3992,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getBackupSchedule`, - Aliases: nil, + OperationID: `getBackupSchedule`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the cloud backup schedule for the specified cluster within the specified project. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getbackupschedule. @@ -4021,8 +4070,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getDataProtectionSettings`, - Aliases: nil, + OperationID: `getDataProtectionSettings`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the Backup Compliance Policy settings with the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdataprotectionsettings. @@ -4088,8 +4138,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getExportBucket`, - Aliases: nil, + OperationID: `getExportBucket`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one Export Bucket associated with the specified Project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getexportbucket. @@ -4155,8 +4206,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getReplicaSetBackup`, - Aliases: nil, + OperationID: `getReplicaSetBackup`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one snapshot from the specified cluster. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getreplicasetbackup. @@ -4235,8 +4287,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getServerlessBackup`, - Aliases: nil, + OperationID: `getServerlessBackup`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one snapshot of one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -4308,8 +4361,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getServerlessBackupRestoreJob`, - Aliases: nil, + OperationID: `getServerlessBackupRestoreJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one restore job for one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -4391,8 +4445,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getShardedClusterBackup`, - Aliases: nil, + OperationID: `getShardedClusterBackup`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one snapshot of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getshardedclusterbackup. @@ -4471,8 +4526,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listBackupExportJobs`, - Aliases: nil, + OperationID: `listBackupExportJobs`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all Cloud Backup Snapshot Export Jobs associated with the specified Atlas cluster. To use this resource, the requesting Service Account or API Key must have the Project Atlas Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listbackupexportjobs. @@ -4571,8 +4627,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listBackupRestoreJobs`, - Aliases: nil, + OperationID: `listBackupRestoreJobs`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all cloud backup restore jobs for one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Backup Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listbackuprestorejobs. @@ -4671,8 +4728,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listExportBuckets`, - Aliases: nil, + OperationID: `listExportBuckets`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all Export Buckets associated with the specified Project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listexportbuckets. @@ -4768,8 +4826,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listReplicaSetBackups`, - Aliases: nil, + OperationID: `listReplicaSetBackups`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all snapshots of one cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listreplicasetbackups. @@ -4868,8 +4927,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listServerlessBackupRestoreJobs`, - Aliases: nil, + OperationID: `listServerlessBackupRestoreJobs`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all restore jobs for one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -4971,8 +5031,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listServerlessBackups`, - Aliases: nil, + OperationID: `listServerlessBackups`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all snapshots of one serverless instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -5074,8 +5135,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listShardedClusterBackups`, - Aliases: nil, + OperationID: `listShardedClusterBackups`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all snapshots of one sharded cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role or Project Backup Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listshardedclusterbackups. @@ -5144,8 +5206,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `takeSnapshot`, - Aliases: nil, + OperationID: `takeSnapshot`, + ShortOperationID: ``, + Aliases: nil, Description: `Takes one on-demand snapshot for the specified cluster. Atlas takes on-demand snapshots immediately and scheduled snapshots at regular intervals. If an on-demand snapshot with a status of queued or inProgress exists, before taking another snapshot, wait until Atlas completes completes processing the previously taken on-demand snapshot. @@ -5237,8 +5300,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateBackupSchedule`, - Aliases: nil, + OperationID: `updateBackupSchedule`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the cloud backup schedule for one cluster within the specified project. This schedule defines when MongoDB Cloud takes scheduled snapshots and how long it stores those snapshots. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatebackupschedule. @@ -5314,8 +5378,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateDataProtectionSettings`, - Aliases: nil, + OperationID: `updateDataProtectionSettings`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the Backup Compliance Policy settings for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatedataprotectionsettings. @@ -5408,8 +5473,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateSnapshotRetention`, - Aliases: nil, + OperationID: `updateSnapshotRetention`, + ShortOperationID: ``, + Aliases: nil, Description: `Changes the expiration date for one cloud backup snapshot for one cluster in the specified project. The requesting API Key must have the Project Backup Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatesnapshotretention. @@ -5514,8 +5580,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Manages the Cloud Migration Service. Source organizations, projects, and MongoDB clusters reside on Cloud Manager or Ops Manager. Destination organizations, projects, and MongoDB clusters reside on MongoDB Cloud. Source databases can't use any authentication except SCRAM-SHA.`, Commands: []shared_api.Command{ { - OperationID: `createLinkToken`, - Aliases: nil, + OperationID: `createLinkToken`, + ShortOperationID: ``, + Aliases: nil, Description: `Create one link-token that contains all the information required to complete the link. MongoDB Atlas uses the link-token for push live migrations only. Live migration (push) allows you to securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createlinktoken. @@ -5570,8 +5637,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createPushMigration`, - Aliases: nil, + OperationID: `createPushMigration`, + ShortOperationID: ``, + Aliases: nil, Description: `Migrate one cluster that Cloud or Ops Manager manages to MongoDB Atlas. @@ -5646,8 +5714,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `cutoverMigration`, - Aliases: nil, + OperationID: `cutoverMigration`, + ShortOperationID: ``, + Aliases: nil, Description: `Cut over the migrated cluster to MongoDB Atlas. Confirm when the cut over completes. When the cut over completes, MongoDB Atlas completes the live migration process and stops synchronizing with the source cluster. Your API Key must have the Organization Owner role to successfully call this resource. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-cutovermigration. @@ -5716,8 +5785,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteLinkToken`, - Aliases: nil, + OperationID: `deleteLinkToken`, + ShortOperationID: ``, + Aliases: nil, Description: `Remove one organization link and its associated public API key. MongoDB Atlas uses the link-token for push live migrations only. Live migrations (push) let you securely push data from Cloud Manager or Ops Manager into MongoDB Atlas. Your API Key must have the Organization Owner role to successfully call this resource. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletelinktoken. @@ -5762,8 +5832,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getPushMigration`, - Aliases: nil, + OperationID: `getPushMigration`, + ShortOperationID: ``, + Aliases: nil, Description: `Return details of one cluster migration job. Each push live migration job uses one migration host. Your API Key must have the Organization Member role to successfully call this resource. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpushmigration. @@ -5832,8 +5903,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getValidationStatus`, - Aliases: nil, + OperationID: `getValidationStatus`, + ShortOperationID: ``, + Aliases: nil, Description: `Return the status of one migration validation job. Your API Key must have the Organization Owner role to successfully call this resource. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getvalidationstatus. @@ -5892,8 +5964,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listSourceProjects`, - Aliases: nil, + OperationID: `listSourceProjects`, + ShortOperationID: ``, + Aliases: nil, Description: `Return all projects that you can migrate to the specified organization. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listsourceprojects. @@ -5948,8 +6021,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `validateMigration`, - Aliases: nil, + OperationID: `validateMigration`, + ShortOperationID: ``, + Aliases: nil, Description: `Verifies whether the provided credentials, available disk space, MongoDB versions, and so on meet the requirements of the migration request. If the check passes, the migration can proceed. Your API Key must have the Organization Owner role to successfully call this resource. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-validatemigration. @@ -6021,8 +6095,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, authorizes, and removes AWS IAM roles in Atlas.`, Commands: []shared_api.Command{ { - OperationID: `authorizeCloudProviderAccessRole`, - Aliases: nil, + OperationID: `authorizeCloudProviderAccessRole`, + ShortOperationID: ``, + Aliases: nil, Description: `Grants access to the specified project for the specified access role. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This API endpoint is one step in a procedure to create unified access for MongoDB Cloud services. This is not required for GCP service account access. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-authorizecloudprovideraccessrole. @@ -6091,8 +6166,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createCloudProviderAccessRole`, - Aliases: nil, + OperationID: `createCloudProviderAccessRole`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one access role for the specified cloud provider. Some MongoDB Cloud features use these cloud provider access roles for authentication. To use this resource, the requesting Service Account or API Key must have the Project Owner role. For the GCP provider, if the project folder is not yet provisioned, Atlas will now create the role asynchronously. An intermediate role with status IN_PROGRESS will be returned, and the final service account will be provisioned. Once the GCP project is set up, subsequent requests will create the service account synchronously. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcloudprovideraccessrole. @@ -6151,8 +6227,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deauthorizeCloudProviderAccessRole`, - Aliases: nil, + OperationID: `deauthorizeCloudProviderAccessRole`, + ShortOperationID: ``, + Aliases: nil, Description: `Revokes access to the specified project for the specified access role. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deauthorizecloudprovideraccessrole. @@ -6231,8 +6308,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCloudProviderAccessRole`, - Aliases: nil, + OperationID: `getCloudProviderAccessRole`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the access role with the specified id and with access to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcloudprovideraccessrole. @@ -6301,8 +6379,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listCloudProviderAccessRoles`, - Aliases: nil, + OperationID: `listCloudProviderAccessRoles`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all cloud provider access roles with access to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listcloudprovideraccessroles. @@ -6367,8 +6446,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, starts, or ends a cluster outage simulation.`, Commands: []shared_api.Command{ { - OperationID: `endOutageSimulation`, - Aliases: nil, + OperationID: `endOutageSimulation`, + ShortOperationID: ``, + Aliases: nil, Description: `Ends a cluster outage simulation. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-endoutagesimulation. @@ -6451,8 +6531,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getOutageSimulation`, - Aliases: nil, + OperationID: `getOutageSimulation`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one outage simulation for one cluster. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getoutagesimulation. @@ -6521,8 +6602,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `startOutageSimulation`, - Aliases: nil, + OperationID: `startOutageSimulation`, + ShortOperationID: ``, + Aliases: nil, Description: `Starts a cluster outage simulation. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startoutagesimulation. @@ -6615,8 +6697,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes database deployments. Changes to cluster configurations can affect costs. This resource requires your Project ID.`, Commands: []shared_api.Command{ { - OperationID: `autoScalingConfiguration`, - Aliases: nil, + OperationID: `autoScalingConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the internal configuration of AutoScaling for sharded clusters. This endpoint can be used for diagnostic purposes to ensure that sharded clusters updated from older APIs have gained support for AutoScaling each shard independently. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-autoscalingconfiguration. @@ -6685,8 +6768,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createCluster`, - Aliases: nil, + OperationID: `createCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can create clusters with asymmetrically-sized shards. Each project supports up to 25 database deployments. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature is not available for serverless clusters. @@ -6787,8 +6871,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteCluster`, - Aliases: nil, + OperationID: `deleteCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one cluster from the specified project. The cluster must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This feature is not available for serverless clusters. @@ -6891,8 +6976,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCluster`, - Aliases: nil, + OperationID: `getCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This feature is not available for serverless clusters. @@ -6978,8 +7064,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getClusterAdvancedConfiguration`, - Aliases: nil, + OperationID: `getClusterAdvancedConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the advanced configuration details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. Advanced configuration details include the read/write concern, index and oplog limits, and other database settings. This feature isn't available for M0 free clusters, M2 and M5 shared-tier clusters, flex clusters, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getclusteradvancedconfiguration. @@ -7055,8 +7142,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getClusterStatus`, - Aliases: nil, + OperationID: `getClusterStatus`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the status of all changes that you made to the specified cluster in the specified project. Use this resource to check the progress MongoDB Cloud has made in processing your changes. The response does not include the deployment of new dedicated clusters. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getclusterstatus. @@ -7125,8 +7213,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getSampleDatasetLoadStatus`, - Aliases: nil, + OperationID: `getSampleDatasetLoadStatus`, + ShortOperationID: ``, + Aliases: nil, Description: `Checks the progress of loading the sample dataset into one cluster. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getsampledatasetloadstatus. @@ -7185,8 +7274,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `grantMongoDbEmployeeAccess`, - Aliases: nil, + OperationID: `grantMongoDbEmployeeAccess`, + ShortOperationID: ``, + Aliases: nil, Description: `Grants MongoDB employee cluster access for the given duration and at the specified level for one cluster. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-grantmongodbemployeeaccess. @@ -7255,8 +7345,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listCloudProviderRegions`, - Aliases: nil, + OperationID: `listCloudProviderRegions`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the list of regions available for the specified cloud provider at the specified tier. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listcloudproviderregions. @@ -7365,8 +7456,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listClusters`, - Aliases: nil, + OperationID: `listClusters`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details for all clusters in the specific project to which you have access. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This feature is not available for serverless clusters. @@ -7482,8 +7574,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listClustersForAllProjects`, - Aliases: nil, + OperationID: `listClustersForAllProjects`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details for all clusters in all projects to which you have access. Clusters contain a group of hosts that maintain the same data set. The response does not include multi-cloud clusters. To use this resource, the requesting Service Account or API Key can have any cluster-level role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclustersforallprojects. @@ -7557,8 +7650,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `loadSampleDataset`, - Aliases: nil, + OperationID: `loadSampleDataset`, + ShortOperationID: ``, + Aliases: nil, Description: `Requests loading the MongoDB sample dataset into the specified cluster. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-loadsampledataset. @@ -7636,8 +7730,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `pinFeatureCompatibilityVersion`, - Aliases: nil, + OperationID: `pinFeatureCompatibilityVersion`, + ShortOperationID: ``, + Aliases: nil, Description: `Pins the Feature Compatibility Version (FCV) to the current MongoDB version and sets the pin expiration date. If an FCV pin already exists for the cluster, calling this method will only update the expiration date of the existing pin and will not repin the FCV. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pinfeaturecompatibilityversion. @@ -7706,8 +7801,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `revokeMongoDbEmployeeAccess`, - Aliases: nil, + OperationID: `revokeMongoDbEmployeeAccess`, + ShortOperationID: ``, + Aliases: nil, Description: `Revokes a previously granted MongoDB employee cluster access. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-revokemongodbemployeeaccess. @@ -7776,8 +7872,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `testFailover`, - Aliases: nil, + OperationID: `testFailover`, + ShortOperationID: ``, + Aliases: nil, Description: `Starts a failover test for the specified cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. A failover test checks how MongoDB Cloud handles the failure of the cluster's primary node. During the test, MongoDB Cloud shuts down the primary node and elects a new primary. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-testfailover. @@ -7853,8 +7950,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `unpinFeatureCompatibilityVersion`, - Aliases: nil, + OperationID: `unpinFeatureCompatibilityVersion`, + ShortOperationID: ``, + Aliases: nil, Description: `Unpins the current fixed Feature Compatibility Version (FCV). This feature is not available for clusters on rapid release. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-unpinfeaturecompatibilityversion. @@ -7923,8 +8021,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateCluster`, - Aliases: nil, + OperationID: `updateCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can update clusters with asymmetrically-sized shards. To update a cluster's termination protection, the requesting Service Account or API Key must have the Project Owner role. For all other updates, the requesting Service Account or API Key must have the Project Cluster Manager role. You can't modify a paused cluster (paused : true). You must call this endpoint to set paused : false. After this endpoint responds with paused : false, you can call it again with the changes you want to make to the cluster. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatecluster. @@ -8032,8 +8131,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateClusterAdvancedConfiguration`, - Aliases: nil, + OperationID: `updateClusterAdvancedConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the advanced configuration details for one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. Advanced configuration details include the read/write concern, index and oplog limits, and other database settings. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. This feature isn't available for M0 free clusters, M2 and M5 shared-tier clusters, flex clusters, or serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateclusteradvancedconfiguration. @@ -8109,8 +8209,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `upgradeSharedCluster`, - Aliases: nil, + OperationID: `upgradeSharedCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Upgrades a shared-tier cluster to a Flex or Dedicated (M10+) cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. Each project supports up to 25 clusters. @@ -8178,8 +8279,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, and edits pinned namespaces for the specified cluster or process. Also returns collection level latency metric data.`, Commands: []shared_api.Command{ { - OperationID: `getCollStatsLatencyNamespaceClusterMeasurements`, - Aliases: nil, + OperationID: `getCollStatsLatencyNamespaceClusterMeasurements`, + ShortOperationID: ``, + Aliases: nil, Description: `Get a list of the Coll Stats Latency cluster-level measurements for the given namespace. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespaceclustermeasurements. @@ -8308,8 +8410,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCollStatsLatencyNamespaceHostMeasurements`, - Aliases: nil, + OperationID: `getCollStatsLatencyNamespaceHostMeasurements`, + ShortOperationID: ``, + Aliases: nil, Description: `Get a list of the Coll Stats Latency process-level measurements for the given namespace. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespacehostmeasurements. @@ -8428,8 +8531,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCollStatsLatencyNamespaceMetrics`, - Aliases: nil, + OperationID: `getCollStatsLatencyNamespaceMetrics`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all available Coll Stats Latency metric names and their respective units for the specified project at the time of request. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespacemetrics. @@ -8478,8 +8582,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCollStatsLatencyNamespacesForCluster`, - Aliases: nil, + OperationID: `getCollStatsLatencyNamespacesForCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Return the subset of namespaces from the given cluster sorted by highest total execution time (descending) within the given time window. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespacesforcluster. @@ -8578,8 +8683,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCollStatsLatencyNamespacesForHost`, - Aliases: nil, + OperationID: `getCollStatsLatencyNamespacesForHost`, + ShortOperationID: ``, + Aliases: nil, Description: `Return the subset of namespaces from the given process ranked by highest total execution time (descending) within the given time window. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcollstatslatencynamespacesforhost. @@ -8668,8 +8774,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getPinnedNamespaces`, - Aliases: nil, + OperationID: `getPinnedNamespaces`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns a list of given cluster's pinned namespaces, a set of namespaces manually selected by users to collect query latency metrics on. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpinnednamespaces. @@ -8728,8 +8835,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `pinNamespacesPatch`, - Aliases: nil, + OperationID: `pinNamespacesPatch`, + ShortOperationID: ``, + Aliases: nil, Description: `Add provided list of namespaces to existing pinned namespaces list for collection-level latency metrics collection for the given Group and Cluster. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pinnamespacespatch. @@ -8789,8 +8897,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `pinNamespacesPut`, - Aliases: nil, + OperationID: `pinNamespacesPut`, + ShortOperationID: ``, + Aliases: nil, Description: `Pin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. This initializes a pinned namespaces list or replaces any existing pinned namespaces list for the Group and Cluster. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-pinnamespacesput. @@ -8850,8 +8959,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `unpinNamespaces`, - Aliases: nil, + OperationID: `unpinNamespaces`, + ShortOperationID: ``, + Aliases: nil, Description: `Unpin provided list of namespaces for collection-level latency metrics collection for the given Group and Cluster. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-unpinnamespaces. @@ -8916,8 +9026,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes custom database user privilege roles. Use custom roles to specify custom sets of actions that the MongoDB Cloud built-in roles can't describe. You define custom roles at the project level, for all clusters in the project. This resource supports a subset of MongoDB privilege actions. You can create a subset of custom role actions. To create a wider list of custom role actions, use the MongoDB Cloud user interface. Custom roles must include actions that all project's clusters support, and that are compatible with each MongoDB version that your project's clusters use. For example, if your project has MongoDB 4.2 clusters, you can't create custom roles that use actions introduced in MongoDB 4.4.`, Commands: []shared_api.Command{ { - OperationID: `createCustomDatabaseRole`, - Aliases: nil, + OperationID: `createCustomDatabaseRole`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one custom role in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Stream Processing Owner role, or the Project Database Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcustomdatabaserole. @@ -8976,8 +9087,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteCustomDatabaseRole`, - Aliases: nil, + OperationID: `deleteCustomDatabaseRole`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one custom role from the specified project. You can't remove a custom role that would leave one or more child roles with no parent roles or actions. You also can't remove a custom role that would leave one or more database users without roles. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Stream Processing Owner role, or the Project Database Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletecustomdatabaserole. @@ -9046,8 +9158,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getCustomDatabaseRole`, - Aliases: nil, + OperationID: `getCustomDatabaseRole`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one custom role for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcustomdatabaserole. @@ -9116,8 +9229,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listCustomDatabaseRoles`, - Aliases: nil, + OperationID: `listCustomDatabaseRoles`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all custom roles for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listcustomdatabaseroles. @@ -9176,8 +9290,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateCustomDatabaseRole`, - Aliases: nil, + OperationID: `updateCustomDatabaseRole`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one custom role in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatecustomdatabaserole. @@ -9252,8 +9367,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes Federated Database Instances. This resource requires your project ID. Changes to federated database instance configurations can affect costs.`, Commands: []shared_api.Command{ { - OperationID: `createDataFederationPrivateEndpoint`, - Aliases: nil, + OperationID: `createDataFederationPrivateEndpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Adds one private endpoint for Federated Database Instances and Online Archives to the specified projects. If the endpoint ID already exists and the associated comment is unchanged, Atlas Data Federation makes no change to the endpoint ID list. If the endpoint ID already exists and the associated comment is changed, Atlas Data Federation updates the comment value only in the endpoint ID list. If the endpoint ID doesn't exist, Atlas Data Federation appends the new endpoint to the list of endpoints in the endpoint ID list. Each region has an associated service name for the various endpoints in each region. @@ -9339,8 +9455,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createFederatedDatabase`, - Aliases: nil, + OperationID: `createFederatedDatabase`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createfederateddatabase. @@ -9409,8 +9526,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createOneDataFederationQueryLimit`, - Aliases: nil, + OperationID: `createOneDataFederationQueryLimit`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates or updates one query limit for one federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createonedatafederationquerylimit. @@ -9487,8 +9605,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteDataFederationPrivateEndpoint`, - Aliases: nil, + OperationID: `deleteDataFederationPrivateEndpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one private endpoint for Federated Database Instances and Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletedatafederationprivateendpoint. @@ -9557,8 +9676,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteFederatedDatabase`, - Aliases: nil, + OperationID: `deleteFederatedDatabase`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one federated database instance from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletefederateddatabase. @@ -9627,8 +9747,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteOneDataFederationInstanceQueryLimit`, - Aliases: nil, + OperationID: `deleteOneDataFederationInstanceQueryLimit`, + ShortOperationID: ``, + Aliases: nil, Description: `Deletes one query limit for one federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteonedatafederationinstancequerylimit. @@ -9705,8 +9826,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `downloadFederatedDatabaseQueryLogs`, - Aliases: nil, + OperationID: `downloadFederatedDatabaseQueryLogs`, + ShortOperationID: ``, + Aliases: nil, Description: `Downloads the query logs for the specified federated database instance. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Data Access Read Write roles. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadfederateddatabasequerylogs. @@ -9775,8 +9897,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getDataFederationPrivateEndpoint`, - Aliases: nil, + OperationID: `getDataFederationPrivateEndpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the specified private endpoint for Federated Database Instances or Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatafederationprivateendpoint. @@ -9845,8 +9968,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getFederatedDatabase`, - Aliases: nil, + OperationID: `getFederatedDatabase`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details of one federated database instance within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederateddatabase. @@ -9905,8 +10029,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDataFederationPrivateEndpoints`, - Aliases: nil, + OperationID: `listDataFederationPrivateEndpoints`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all private endpoints for Federated Database Instances and Online Archives in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdatafederationprivateendpoints. @@ -9995,8 +10120,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listFederatedDatabases`, - Aliases: nil, + OperationID: `listFederatedDatabases`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details of all federated database instances in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only or higher role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listfederateddatabases. @@ -10065,8 +10191,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `returnFederatedDatabaseQueryLimit`, - Aliases: nil, + OperationID: `returnFederatedDatabaseQueryLimit`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details of one query limit for the specified federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-returnfederateddatabasequerylimit. @@ -10153,8 +10280,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `returnFederatedDatabaseQueryLimits`, - Aliases: nil, + OperationID: `returnFederatedDatabaseQueryLimits`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns query limits for a federated databases instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-returnfederateddatabasequerylimits. @@ -10223,8 +10351,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateFederatedDatabase`, - Aliases: nil, + OperationID: `updateFederatedDatabase`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the details of one federated database instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or higher role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatefederateddatabase. @@ -10309,8 +10438,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes database users.`, Commands: []shared_api.Command{ { - OperationID: `createDatabaseUser`, - Aliases: nil, + OperationID: `createDatabaseUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one database user in the specified project. This MongoDB Cloud supports a maximum of 100 database users per project. If you require more than 100 database users on a project, contact Support. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createdatabaseuser. @@ -10369,8 +10499,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteDatabaseUser`, - Aliases: nil, + OperationID: `deleteDatabaseUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one database user from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, the Project Stream Processing Owner role, or the Project Database Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletedatabaseuser. @@ -10462,8 +10593,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getDatabaseUser`, - Aliases: nil, + OperationID: `getDatabaseUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one database user that belong to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatabaseuser. @@ -10555,8 +10687,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDatabaseUsers`, - Aliases: nil, + OperationID: `listDatabaseUsers`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all database users that belong to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdatabaseusers. @@ -10645,8 +10778,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateDatabaseUser`, - Aliases: nil, + OperationID: `updateDatabaseUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one database user that belongs to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role, Project Charts Admin role, Project Stream Processing Owner role, or the Project Database Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatedatabaseuser. @@ -10744,8 +10878,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and edits the Encryption at Rest using Customer Key Management configuration. MongoDB Cloud encrypts all storage whether or not you use your own key management.`, Commands: []shared_api.Command{ { - OperationID: `createEncryptionAtRestPrivateEndpoint`, - Aliases: nil, + OperationID: `createEncryptionAtRestPrivateEndpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates a private endpoint in the specified region for encryption at rest using customer key management. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createencryptionatrestprivateendpoint. @@ -10814,8 +10949,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getEncryptionAtRest`, - Aliases: nil, + OperationID: `getEncryptionAtRest`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the configuration for encryption at rest using the keys you manage through your cloud provider. MongoDB Cloud encrypts all storage even if you don't use your own key management. This resource requires the requesting Service Account or API Key to have the Project Owner role. @@ -10877,8 +11013,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getEncryptionAtRestPrivateEndpoint`, - Aliases: nil, + OperationID: `getEncryptionAtRestPrivateEndpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getencryptionatrestprivateendpoint. @@ -10957,8 +11094,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getEncryptionAtRestPrivateEndpointsForCloudProvider`, - Aliases: nil, + OperationID: `getEncryptionAtRestPrivateEndpointsForCloudProvider`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the private endpoints of the specified cloud provider for encryption at rest using customer key management. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getencryptionatrestprivateendpointsforcloudprovider. @@ -11057,8 +11195,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `requestEncryptionAtRestPrivateEndpointDeletion`, - Aliases: nil, + OperationID: `requestEncryptionAtRestPrivateEndpointDeletion`, + ShortOperationID: ``, + Aliases: nil, Description: `Deletes one private endpoint, identified by its ID, for encryption at rest using Customer Key Management. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-requestencryptionatrestprivateendpointdeletion. @@ -11137,8 +11276,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateEncryptionAtRest`, - Aliases: nil, + OperationID: `updateEncryptionAtRest`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the configuration for encryption at rest using the keys you manage through your cloud provider. MongoDB Cloud encrypts all storage even if you don't use your own key management. This resource requires the requesting Service Account or API Key to have the Project Owner role. This feature isn't available for M0 free clusters, M2, M5, or serverless clusters. @@ -11206,8 +11346,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns events. This collection remains under revision and may change.`, Commands: []shared_api.Command{ { - OperationID: `getOrganizationEvent`, - Aliases: nil, + OperationID: `getOrganizationEvent`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one event for the specified organization. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Organization Member role. Use the Return Events from One Organization endpoint to retrieve all events to which the authenticated user has access. @@ -11285,8 +11426,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getProjectEvent`, - Aliases: nil, + OperationID: `getProjectEvent`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one event for the specified project. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Use the Return Events from One Project endpoint to retrieve all events to which the authenticated user has access. @@ -11368,8 +11510,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listEventTypes`, - Aliases: nil, + OperationID: `listEventTypes`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns a list of all event types, along with a description and additional metadata about each event. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listeventtypes. @@ -11443,8 +11586,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrganizationEvents`, - Aliases: nil, + OperationID: `listOrganizationEvents`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns events for the specified organization. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Organization Member role. @@ -11575,8 +11719,9 @@ IMPORTANT: The complete list of event type values changes frequently.`, }, }, { - OperationID: `listProjectEvents`, - Aliases: nil, + OperationID: `listProjectEvents`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns events for the specified project. Events identify significant database, billing, or security activities or status changes. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -11740,8 +11885,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes federation-related features such as role mappings and connected organization configurations.`, Commands: []shared_api.Command{ { - OperationID: `createIdentityProvider`, - Aliases: nil, + OperationID: `createIdentityProvider`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one identity provider within the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. @@ -11789,8 +11935,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createRoleMapping`, - Aliases: nil, + OperationID: `createRoleMapping`, + ShortOperationID: ``, + Aliases: nil, Description: `Adds one role mapping to the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createrolemapping. @@ -11845,8 +11992,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteFederationApp`, - Aliases: nil, + OperationID: `deleteFederationApp`, + ShortOperationID: ``, + Aliases: nil, Description: `Deletes the federation settings instance and all associated data, including identity providers and domains. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the last remaining connected organization. Note: requests to this resource will fail if there is more than one connected organization in the federation. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletefederationapp. @@ -11880,8 +12028,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteIdentityProvider`, - Aliases: nil, + OperationID: `deleteIdentityProvider`, + ShortOperationID: ``, + Aliases: nil, Description: `Deletes one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. @@ -11939,8 +12088,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteRoleMapping`, - Aliases: nil, + OperationID: `deleteRoleMapping`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one role mapping in the specified organization from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleterolemapping. @@ -12005,8 +12155,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getConnectedOrgConfig`, - Aliases: nil, + OperationID: `getConnectedOrgConfig`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the specified connected org config from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getconnectedorgconfig. @@ -12061,8 +12212,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getFederationSettings`, - Aliases: nil, + OperationID: `getFederationSettings`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns information about the federation settings for the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in the connected org. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getfederationsettings. @@ -12117,8 +12269,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getIdentityProvider`, - Aliases: nil, + OperationID: `getIdentityProvider`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one identity provider in the specified federation by the identity provider's id. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getidentityprovider. @@ -12173,8 +12326,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getIdentityProviderMetadata`, - Aliases: nil, + OperationID: `getIdentityProviderMetadata`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the metadata of one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getidentityprovidermetadata. @@ -12218,8 +12372,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getRoleMapping`, - Aliases: nil, + OperationID: `getRoleMapping`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one role mapping from the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getrolemapping. @@ -12284,8 +12439,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listConnectedOrgConfigs`, - Aliases: nil, + OperationID: `listConnectedOrgConfigs`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all connected org configs in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected orgs. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listconnectedorgconfigs. @@ -12350,8 +12506,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listIdentityProviders`, - Aliases: nil, + OperationID: `listIdentityProviders`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all identity providers with the provided protocol and type in the specified federation. If no protocol is specified, only SAML identity providers will be returned. If no idpType is specified, only WORKFORCE identity providers will be returned. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listidentityproviders. @@ -12436,8 +12593,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listRoleMappings`, - Aliases: nil, + OperationID: `listRoleMappings`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all role mappings from the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listrolemappings. @@ -12492,8 +12650,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `removeConnectedOrgConfig`, - Aliases: nil, + OperationID: `removeConnectedOrgConfig`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one connected organization configuration from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. Note: This request fails if only one connected organization exists in the federation. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeconnectedorgconfig. @@ -12548,8 +12707,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `revokeJwksFromIdentityProvider`, - Aliases: nil, + OperationID: `revokeJwksFromIdentityProvider`, + ShortOperationID: ``, + Aliases: nil, Description: `Revokes the JWKS tokens from the requested OIDC identity provider. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. @@ -12607,8 +12767,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateConnectedOrgConfig`, - Aliases: nil, + OperationID: `updateConnectedOrgConfig`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one connected organization configuration from the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -12675,8 +12836,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateIdentityProvider`, - Aliases: nil, + OperationID: `updateIdentityProvider`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one identity provider in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role in one of the connected organizations. @@ -12734,8 +12896,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateRoleMapping`, - Aliases: nil, + OperationID: `updateRoleMapping`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one role mapping in the specified organization in the specified federation. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updaterolemapping. @@ -12806,8 +12969,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Returns, adds, edits, and removes flex clusters.`, Commands: []shared_api.Command{ { - OperationID: `createFlexCluster`, - Aliases: nil, + OperationID: `createFlexCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createflexcluster. @@ -12885,8 +13049,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteFlexCluster`, - Aliases: nil, + OperationID: `deleteFlexCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one flex cluster from the specified project. The flex cluster must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteflexcluster. @@ -12969,8 +13134,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getFlexCluster`, - Aliases: nil, + OperationID: `getFlexCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details for one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getflexcluster. @@ -13039,8 +13205,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listFlexClusters`, - Aliases: nil, + OperationID: `listFlexClusters`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details for all flex clusters in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listflexclusters. @@ -13129,8 +13296,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateFlexCluster`, - Aliases: nil, + OperationID: `updateFlexCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one flex cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateflexcluster. @@ -13217,8 +13385,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `upgradeFlexCluster`, - Aliases: nil, + OperationID: `upgradeFlexCluster`, + ShortOperationID: ``, + Aliases: nil, Description: `Upgrades a flex cluster to a dedicated cluster (M10+) in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Cluster Manager role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-upgradeflexcluster. @@ -13283,8 +13452,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and adds restore jobs for flex database deployments.`, Commands: []shared_api.Command{ { - OperationID: `createFlexBackupRestoreJob`, - Aliases: nil, + OperationID: `createFlexBackupRestoreJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Restores one snapshot of one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createflexbackuprestorejob. @@ -13373,8 +13543,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getFlexBackupRestoreJob`, - Aliases: nil, + OperationID: `getFlexBackupRestoreJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one restore job for one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getflexbackuprestorejob. @@ -13453,8 +13624,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listFlexBackupRestoreJobs`, - Aliases: nil, + OperationID: `listFlexBackupRestoreJobs`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all restore jobs for one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listflexbackuprestorejobs. @@ -13559,8 +13731,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and requests to download flex database deployment snapshots.`, Commands: []shared_api.Command{ { - OperationID: `downloadFlexBackup`, - Aliases: nil, + OperationID: `downloadFlexBackup`, + ShortOperationID: ``, + Aliases: nil, Description: `Requests one snapshot for the specified flex cluster. This resource returns a snapshotURL that you can use to download the snapshot. This snapshotURL remains active for four hours after you make the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadflexbackup. @@ -13629,8 +13802,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getFlexBackup`, - Aliases: nil, + OperationID: `getFlexBackup`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one snapshot of one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getflexbackup. @@ -13699,8 +13873,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listFlexBackups`, - Aliases: nil, + OperationID: `listFlexBackups`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all snapshots of one flex cluster from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listflexbackups. @@ -13806,8 +13981,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you MongoDB Cloud shards the empty collection using the required location field and a custom shard key. For example, if your custom shard key is city, the compound shard key is location, city. Each Global Cluster is also associated with one or more Global Writes Zones. When a user creates a Global Cluster, MongoDB Cloud automatically maps each location code to the closest geographical zone. Custom zone mappings allow administrators to override these automatic mappings. For example, a use case might require mapping a location code to a geographically distant zone. Administrators can manage custom zone mappings with the APIs below and the Global Cluster Configuration pane when you create or modify your Global Cluster.`, Commands: []shared_api.Command{ { - OperationID: `createCustomZoneMapping`, - Aliases: nil, + OperationID: `createCustomZoneMapping`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one custom zone mapping for the specified global cluster. A custom zone mapping matches one ISO 3166-2 location code to a zone in your global cluster. By default, MongoDB Cloud maps each location code to the closest geographical zone. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcustomzonemapping. @@ -13890,8 +14066,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createManagedNamespace`, - Aliases: nil, + OperationID: `createManagedNamespace`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one managed namespace within the specified global cluster. A managed namespace identifies a collection using the database name, the dot separator, and the collection name. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createmanagednamespace. @@ -13974,8 +14151,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteAllCustomZoneMappings`, - Aliases: nil, + OperationID: `deleteAllCustomZoneMappings`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes all custom zone mappings for the specified global cluster. A custom zone mapping matches one ISO 3166-2 location code to a zone in your global cluster. Removing the custom zone mappings restores the default mapping. By default, MongoDB Cloud maps each location code to the closest geographical zone. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteallcustomzonemappings. @@ -14058,8 +14236,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteManagedNamespace`, - Aliases: nil, + OperationID: `deleteManagedNamespace`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one managed namespace within the specified global cluster. A managed namespace identifies a collection using the database name, the dot separator, and the collection name. Deleting a managed namespace does not remove the associated collection or data. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletemanagednamespace. @@ -14162,8 +14341,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getManagedNamespace`, - Aliases: nil, + OperationID: `getManagedNamespace`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one managed namespace within the specified global cluster. A managed namespace identifies a collection using the database name, the dot separator, and the collection name. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getmanagednamespace. @@ -14252,8 +14432,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns invoices.`, Commands: []shared_api.Command{ { - OperationID: `createCostExplorerQueryProcess`, - Aliases: nil, + OperationID: `createCostExplorerQueryProcess`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates a query process within the Cost Explorer for the given parameters. A token is returned that can be used to poll the status of the query and eventually retrieve the results. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcostexplorerqueryprocess. @@ -14298,8 +14479,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `downloadInvoiceCsv`, - Aliases: nil, + OperationID: `downloadInvoiceCsv`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one invoice that MongoDB issued to the specified organization in CSV format. A unique 24-hexadecimal digit string identifies the invoice. To use this resource, the requesting Service Account or API Key have at least the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner Role. To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. @@ -14365,8 +14547,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getCostExplorerQueryProcess`, - Aliases: nil, + OperationID: `getCostExplorerQueryProcess`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the usage details for a Cost Explorer query, if the query is finished and the data is ready to be viewed. If the data is not ready, a 'processing' response willindicate that another request should be sent later to view the data. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getcostexplorerqueryprocess. @@ -14422,8 +14605,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getInvoice`, - Aliases: nil, + OperationID: `getInvoice`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one invoice that MongoDB issued to the specified organization. A unique 24-hexadecimal digit string identifies the invoice. You can choose to receive this invoice in JSON or CSV format. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can query for a linked invoice if you have the Organization Billing Admin or Organization Owner role. To compute the total owed amount of the invoice - sum up total owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. @@ -14490,8 +14674,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listInvoices`, - Aliases: nil, + OperationID: `listInvoices`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all invoices that MongoDB issued to the specified organization. This list includes all invoices regardless of invoice status. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner role. To compute the total owed amount of the invoices - sum up total owed of each invoice. It could be computed as a sum of owed amount of each payment included into the invoice. To compute payment's owed amount - use formula totalBilledCents * unitPrice + salesTax - startingBalanceCents. @@ -14637,8 +14822,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listPendingInvoices`, - Aliases: nil, + OperationID: `listPendingInvoices`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all invoices accruing charges for the current billing cycle for the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Billing Viewer, Organization Billing Admin, or Organization Owner role. If you have a cross-organization setup, you can view linked invoices if you have the Organization Billing Admin or Organization Owner Role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listpendinginvoices. @@ -14693,8 +14879,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `queryLineItemsFromSingleInvoice`, - Aliases: nil, + OperationID: `queryLineItemsFromSingleInvoice`, + ShortOperationID: ``, + Aliases: nil, Description: `Query the lineItems of the specified invoice and return the result JSON. A unique 24-hexadecimal digit string identifies the invoice. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-querylineitemsfromsingleinvoice. @@ -14775,8 +14962,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Returns, edits, verifies, and removes LDAP configurations. An LDAP configuration defines settings for MongoDB Cloud to connect to your LDAP server over TLS for user authentication and authorization. Your LDAP server must be visible to the internet or connected to your MongoDB Cloud cluster with VPC Peering. Also, your LDAP server must use TLS. You must have the MongoDB Cloud admin user privilege to use these endpoints. Also, to configure user authentication and authorization with LDAPS, your cluster must run MongoDB 3.6 or higher. Groups for which you have configured LDAPS can't create a cluster using a version of MongoDB 3.6 or lower.`, Commands: []shared_api.Command{ { - OperationID: `deleteLdapConfiguration`, - Aliases: nil, + OperationID: `deleteLdapConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes the current LDAP Distinguished Name mapping captured in the userToDNMapping document from the LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteldapconfiguration. @@ -14835,8 +15023,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getLdapConfiguration`, - Aliases: nil, + OperationID: `getLdapConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the current LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getldapconfiguration. @@ -14895,8 +15084,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getLdapConfigurationStatus`, - Aliases: nil, + OperationID: `getLdapConfigurationStatus`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the status of one request to verify one LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getldapconfigurationstatus. @@ -14965,8 +15155,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `saveLdapConfiguration`, - Aliases: nil, + OperationID: `saveLdapConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Edits the LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -15028,8 +15219,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `verifyLdapConfiguration`, - Aliases: nil, + OperationID: `verifyLdapConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Verifies the LDAP configuration for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-verifyldapconfiguration. @@ -15113,8 +15305,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Manages Legacy Backup snapshots, restore jobs, schedules and checkpoints.`, Commands: []shared_api.Command{ { - OperationID: `createLegacyBackupRestoreJob`, - Aliases: nil, + OperationID: `createLegacyBackupRestoreJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Restores one legacy backup for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. This endpoint doesn't support creating checkpoint restore jobs for sharded clusters, or creating restore jobs for queryable backup snapshots. If you create an automated restore job by specifying delivery.methodName of AUTOMATED_RESTORE in your request body, MongoDB Cloud removes all existing data on the target cluster prior to the restore. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createlegacybackuprestorejob. @@ -15183,8 +15376,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteLegacySnapshot`, - Aliases: nil, + OperationID: `deleteLegacySnapshot`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one legacy backup snapshot for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletelegacysnapshot. @@ -15263,8 +15457,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getLegacyBackupCheckpoint`, - Aliases: nil, + OperationID: `getLegacyBackupCheckpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one legacy backup checkpoint for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getlegacybackupcheckpoint. @@ -15343,8 +15538,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getLegacyBackupRestoreJob`, - Aliases: nil, + OperationID: `getLegacyBackupRestoreJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one legacy backup restore job for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -15426,8 +15622,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getLegacySnapshot`, - Aliases: nil, + OperationID: `getLegacySnapshot`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one legacy backup snapshot for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getlegacysnapshot. @@ -15506,8 +15703,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getLegacySnapshotSchedule`, - Aliases: nil, + OperationID: `getLegacySnapshotSchedule`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the snapshot schedule for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -15579,8 +15777,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listLegacyBackupCheckpoints`, - Aliases: nil, + OperationID: `listLegacyBackupCheckpoints`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all legacy backup checkpoints for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listlegacybackupcheckpoints. @@ -15679,8 +15878,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listLegacyBackupRestoreJobs`, - Aliases: nil, + OperationID: `listLegacyBackupRestoreJobs`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all legacy backup restore jobs for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -15792,8 +15992,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listLegacySnapshots`, - Aliases: nil, + OperationID: `listLegacySnapshots`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all legacy backup snapshots for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listlegacysnapshots. @@ -15902,8 +16103,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateLegacySnapshotRetention`, - Aliases: nil, + OperationID: `updateLegacySnapshotRetention`, + ShortOperationID: ``, + Aliases: nil, Description: `Changes the expiration date for one legacy backup snapshot for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Effective 23 March 2020, all new clusters can use only Cloud Backups. When you upgrade to 4.2, your backup system upgrades to cloud backup if it is currently set to legacy backup. After this upgrade, all your existing legacy backup snapshots remain available. They expire over time in accordance with your retention policy. Your backup policy resets to the default schedule. If you had a custom backup policy in place with legacy backups, you must re-create it with the procedure outlined in the Cloud Backup documentation. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatelegacysnapshotretention. @@ -15982,8 +16184,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateLegacySnapshotSchedule`, - Aliases: nil, + OperationID: `updateLegacySnapshotSchedule`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the snapshot schedule for one cluster in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -16061,8 +16264,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, edits, and removes maintenance windows. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. You can defer a scheduled maintenance event for a project up to two times. Deferred maintenance events occur during your preferred maintenance window exactly one week after the previously scheduled date and time.`, Commands: []shared_api.Command{ { - OperationID: `deferMaintenanceWindow`, - Aliases: nil, + OperationID: `deferMaintenanceWindow`, + ShortOperationID: ``, + Aliases: nil, Description: `Defers the maintenance window for the specified project. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-defermaintenancewindow. @@ -16111,8 +16315,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getMaintenanceWindow`, - Aliases: nil, + OperationID: `getMaintenanceWindow`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the maintenance window for the specified project. MongoDB Cloud starts those maintenance activities when needed. You can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getmaintenancewindow. @@ -16171,8 +16376,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `resetMaintenanceWindow`, - Aliases: nil, + OperationID: `resetMaintenanceWindow`, + ShortOperationID: ``, + Aliases: nil, Description: `Resets the maintenance window for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-resetmaintenancewindow. @@ -16221,8 +16427,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `toggleMaintenanceAutoDefer`, - Aliases: nil, + OperationID: `toggleMaintenanceAutoDefer`, + ShortOperationID: ``, + Aliases: nil, Description: `Toggles automatic deferral of the maintenance window for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-togglemaintenanceautodefer. @@ -16271,8 +16478,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateMaintenanceWindow`, - Aliases: nil, + OperationID: `updateMaintenanceWindow`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the maintenance window for the specified project. Urgent maintenance activities such as security patches can't wait for your chosen window. MongoDB Cloud starts those maintenance activities when needed. After you schedule maintenance for your cluster, you can't change your maintenance window until the current maintenance efforts complete. The maintenance procedure that MongoDB Cloud performs requires at least one replica set election during the maintenance window per replica set. Maintenance always begins as close to the scheduled hour as possible, but in-progress cluster updates or unexpected system issues could delay the start time. Updating the maintenance window will reset any maintenance deferrals for this project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatemaintenancewindow. @@ -16327,8 +16535,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, and edits MongoDB Cloud users.`, Commands: []shared_api.Command{ { - OperationID: `addOrganizationRole`, - Aliases: nil, + OperationID: `addOrganizationRole`, + ShortOperationID: ``, + Aliases: nil, Description: `Adds one organization-level role to the MongoDB Cloud user. You can add a role to an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -16399,8 +16608,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `addProjectRole`, - Aliases: nil, + OperationID: `addProjectRole`, + ShortOperationID: ``, + Aliases: nil, Description: `Adds one project-level role to the MongoDB Cloud user. You can add a role to an active user or a user that has been invited to join the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -16472,8 +16682,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `addProjectUser`, - Aliases: nil, + OperationID: `addProjectUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Adds one MongoDB Cloud user to one project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -16542,8 +16753,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `addUserToTeam`, - Aliases: nil, + OperationID: `addUserToTeam`, + ShortOperationID: ``, + Aliases: nil, Description: `Adds one MongoDB Cloud user to one team. You can add an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -16611,8 +16823,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createOrganizationUser`, - Aliases: nil, + OperationID: `createOrganizationUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Invites one new or existing MongoDB Cloud user to join the organization. The invitation to join the organization will be sent to the username provided and must be accepted within 30 days. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -16670,8 +16883,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createUser`, - Aliases: nil, + OperationID: `createUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one MongoDB Cloud user account. A MongoDB Cloud user account grants access to only the MongoDB Cloud application. To grant database access, create a database user. MongoDB Cloud sends an email to the users you specify, inviting them to join the project. Invited users don't have access to the project until they accept the invitation. Invitations expire after 30 days. @@ -16721,8 +16935,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getOrganizationUser`, - Aliases: nil, + OperationID: `getOrganizationUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns information about the specified MongoDB Cloud user within the context of the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Member role. @@ -16793,8 +17008,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getProjectUser`, - Aliases: nil, + OperationID: `getProjectUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns information about the specified MongoDB Cloud user within the context of the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -16869,8 +17085,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getUser`, - Aliases: nil, + OperationID: `getUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details for one MongoDB Cloud user account with the specified unique identifier for the user. You can't use this endpoint to return information on an API Key. To return information about an API Key, use the Return One Organization API Key endpoint. You can always retrieve your own user account. If you are the owner of a MongoDB Cloud organization or project, you can also retrieve the user profile for any user with membership in that organization or project. To use this resource, the requesting Service Account or API Key can have any role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getuser. @@ -16925,8 +17142,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getUserByUsername`, - Aliases: nil, + OperationID: `getUserByUsername`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details for one MongoDB Cloud user account with the specified username. You can't use this endpoint to return information about an API Key. To return information about an API Key, use the Return One Organization API Key endpoint. To use this resource, the requesting Service Account or API Key can have any role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getuserbyusername. @@ -16981,8 +17199,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrganizationUsers`, - Aliases: nil, + OperationID: `listOrganizationUsers`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about the pending and active MongoDB Cloud users associated with the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Member role. @@ -17100,8 +17319,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listProjectUsers`, - Aliases: nil, + OperationID: `listProjectUsers`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about the pending and active MongoDB Cloud users associated with the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -17243,8 +17463,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listTeamUsers`, - Aliases: nil, + OperationID: `listTeamUsers`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about the pending and active MongoDB Cloud users associated with the specified team in the organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. @@ -17372,8 +17593,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `removeOrganizationRole`, - Aliases: nil, + OperationID: `removeOrganizationRole`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one organization-level role from the MongoDB Cloud user. You can remove a role from an active user or a user that has not yet accepted the invitation to join the organization. To replace a user's only role, add the new role before removing the old role. A user must have at least one role at all times. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -17444,8 +17666,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `removeOrganizationUser`, - Aliases: nil, + OperationID: `removeOrganizationUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one MongoDB Cloud user in the specified organization. You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -17523,8 +17746,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `removeProjectRole`, - Aliases: nil, + OperationID: `removeProjectRole`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one project-level role from the MongoDB Cloud user. You can remove a role from an active user or a user that has been invited to join the project. To replace a user's only role, add the new role before removing the old role. A user must have at least one role at all times. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -17596,8 +17820,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `removeProjectUser`, - Aliases: nil, + OperationID: `removeProjectUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one MongoDB Cloud user from the specified project. You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -17679,8 +17904,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `removeUserFromTeam`, - Aliases: nil, + OperationID: `removeUserFromTeam`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one MongoDB Cloud user from one team. You can remove an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -17748,8 +17974,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateOrganizationUser`, - Aliases: nil, + OperationID: `updateOrganizationUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one MongoDB Cloud user in the specified organization. You can update an active user or a user that has not yet accepted the invitation to join the organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -17826,8 +18053,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Returns database deployment monitoring and logging data.`, Commands: []shared_api.Command{ { - OperationID: `getAtlasProcess`, - Aliases: nil, + OperationID: `getAtlasProcess`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the processes for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getatlasprocess. @@ -17896,8 +18124,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getDatabase`, - Aliases: nil, + OperationID: `getDatabase`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one database running on the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatabase. @@ -17976,8 +18205,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getDatabaseMeasurements`, - Aliases: nil, + OperationID: `getDatabaseMeasurements`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the measurements of one database for the specified host for the specified project. Returns the database's on-disk storage space based on the MongoDB dbStats command output. To calculate some metric series, Atlas takes the rate between every two adjacent points. For these metric series, the first data point has a null value because Atlas can't calculate a rate for the first data point given the query time range. Atlas retrieves database metrics every 20 minutes but reduces frequency when necessary to optimize database performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getdatabasemeasurements. @@ -18106,8 +18336,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getDiskMeasurements`, - Aliases: nil, + OperationID: `getDiskMeasurements`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the measurements of one disk or partition for the specified host for the specified project. Returned value can be one of the following: @@ -18253,8 +18484,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getHostLogs`, - Aliases: nil, + OperationID: `getHostLogs`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns a compressed (.gz) log file that contains a range of log messages for the specified host for the specified project. MongoDB updates process and audit logs from the cluster backend infrastructure every five minutes. Logs are stored in chunks approximately five minutes in length, but this duration may vary. If you poll the API for log files, we recommend polling every five minutes even though consecutive polls could contain some overlapping logs. This feature isn't available for M0 free clusters, M2, M5, flex, or serverless clusters. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Only or higher role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-gethostlogs. @@ -18350,8 +18582,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getHostMeasurements`, - Aliases: nil, + OperationID: `getHostMeasurements`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns disk, partition, or host measurements per process for the specified host for the specified project. Returned value can be one of the following: @@ -18490,8 +18723,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getIndexMetrics`, - Aliases: nil, + OperationID: `getIndexMetrics`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the Atlas Search metrics data series within the provided time range for one namespace and index name on the specified process. You must have the Project Read Only or higher role to view the Atlas Search metric types. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getindexmetrics. @@ -18630,8 +18864,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getMeasurements`, - Aliases: nil, + OperationID: `getMeasurements`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the Atlas Search hardware and status data series within the provided time range for one process in the specified project. You must have the Project Read Only or higher role to view the Atlas Search metric types. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getmeasurements. @@ -18740,8 +18975,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listAtlasProcesses`, - Aliases: nil, + OperationID: `listAtlasProcesses`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details of all processes for the specified project. A MongoDB process can be either a mongod or mongos. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listatlasprocesses. @@ -18830,8 +19066,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDatabases`, - Aliases: nil, + OperationID: `listDatabases`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the list of databases running on the specified host for the specified project. M0 free clusters, M2, M5, serverless, and Flex clusters have some operational limits. The MongoDB Cloud process must be a mongod. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdatabases. @@ -18930,8 +19167,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDiskMeasurements`, - Aliases: nil, + OperationID: `listDiskMeasurements`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns measurement details for one disk or partition for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdiskmeasurements. @@ -19000,8 +19238,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDiskPartitions`, - Aliases: nil, + OperationID: `listDiskPartitions`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the list of disks or partitions for the specified host for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdiskpartitions. @@ -19100,8 +19339,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listIndexMetrics`, - Aliases: nil, + OperationID: `listIndexMetrics`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the Atlas Search index metrics within the specified time range for one namespace in the specified process. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listindexmetrics. @@ -19230,8 +19470,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listMetricTypes`, - Aliases: nil, + OperationID: `listMetricTypes`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all Atlas Search metric types available for one process in the specified project. You must have the Project Read Only or higher role to view the Atlas Search metric types. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listmetrictypes. @@ -19297,8 +19538,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you When you deploy an M10+ dedicated cluster, Atlas creates a VPC for the selected provider and region or regions if no existing VPC or VPC peering connection exists for that provider and region. Atlas assigns the VPC a Classless Inter-Domain Routing (CIDR) block.`, Commands: []shared_api.Command{ { - OperationID: `createPeeringConnection`, - Aliases: nil, + OperationID: `createPeeringConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one new network peering connection in the specified project. Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations and prerequisites, see the Network Peering Documentation. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createpeeringconnection. @@ -19357,8 +19599,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createPeeringContainer`, - Aliases: nil, + OperationID: `createPeeringContainer`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one new network peering container in the specified project. MongoDB Cloud can deploy Network Peering connections in a network peering container. GCP can have one container per project. AWS and Azure can have one container per cloud provider region. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createpeeringcontainer. @@ -19417,8 +19660,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deletePeeringConnection`, - Aliases: nil, + OperationID: `deletePeeringConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one network peering connection in the specified project. If you Removes the last network peering connection associated with a project, MongoDB Cloud also removes any AWS security groups from the project IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletepeeringconnection. @@ -19487,8 +19731,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deletePeeringContainer`, - Aliases: nil, + OperationID: `deletePeeringContainer`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one network peering container in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletepeeringcontainer. @@ -19557,8 +19802,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `disablePeering`, - Aliases: nil, + OperationID: `disablePeering`, + ShortOperationID: ``, + Aliases: nil, Description: `Disables Connect via Peering Only mode for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disablepeering. @@ -19617,8 +19863,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getPeeringConnection`, - Aliases: nil, + OperationID: `getPeeringConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about one specified network peering connection in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpeeringconnection. @@ -19687,8 +19934,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getPeeringContainer`, - Aliases: nil, + OperationID: `getPeeringContainer`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about one network peering container in one specified project. Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpeeringcontainer. @@ -19757,8 +20005,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listPeeringConnections`, - Aliases: nil, + OperationID: `listPeeringConnections`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about all network peering connections in the specified project. Network peering allows multiple cloud-hosted applications to securely connect to the same project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listpeeringconnections. @@ -19857,8 +20106,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listPeeringContainerByCloudProvider`, - Aliases: nil, + OperationID: `listPeeringContainerByCloudProvider`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about all network peering containers in the specified project for the specified cloud provider. If you do not specify the cloud provider, MongoDB Cloud returns details about all network peering containers in the project for Amazon Web Services (AWS). To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listpeeringcontainerbycloudprovider. @@ -19957,8 +20207,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listPeeringContainers`, - Aliases: nil, + OperationID: `listPeeringContainers`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about all network peering containers in the specified project. Network peering containers contain network peering connections. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listpeeringcontainers. @@ -20047,8 +20298,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updatePeeringConnection`, - Aliases: nil, + OperationID: `updatePeeringConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one specified network peering connection in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatepeeringconnection. @@ -20117,8 +20369,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updatePeeringContainer`, - Aliases: nil, + OperationID: `updatePeeringContainer`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the network details and labels of one specified network peering container in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatepeeringcontainer. @@ -20187,8 +20440,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `verifyConnectViaPeeringOnlyModeForOneProject`, - Aliases: nil, + OperationID: `verifyConnectViaPeeringOnlyModeForOneProject`, + ShortOperationID: ``, + Aliases: nil, Description: `Verifies if someone set the specified project to Connect via Peering Only mode. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-verifyconnectviapeeringonlymodeforoneproject. @@ -20253,8 +20507,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, or removes an online archive.`, Commands: []shared_api.Command{ { - OperationID: `createOnlineArchive`, - Aliases: nil, + OperationID: `createOnlineArchive`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one online archive. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createonlinearchive. @@ -20346,8 +20601,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteOnlineArchive`, - Aliases: nil, + OperationID: `deleteOnlineArchive`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one online archive. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteonlinearchive. @@ -20441,8 +20697,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `downloadOnlineArchiveQueryLogs`, - Aliases: nil, + OperationID: `downloadOnlineArchiveQueryLogs`, + ShortOperationID: ``, + Aliases: nil, Description: `Downloads query logs for the specified online archive. To use this resource, the requesting Service Account or API Key must have the Project Data Access Read Only or higher role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadonlinearchivequerylogs. @@ -20531,8 +20788,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getOnlineArchive`, - Aliases: nil, + OperationID: `getOnlineArchive`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one online archive for one cluster. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getonlinearchive. @@ -20611,8 +20869,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listOnlineArchives`, - Aliases: nil, + OperationID: `listOnlineArchives`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details of all online archives. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listonlinearchives. @@ -20711,8 +20970,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateOnlineArchive`, - Aliases: nil, + OperationID: `updateOnlineArchive`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates, pauses, or resumes one online archive. This archive stores data from one cluster within one project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateonlinearchive. @@ -20820,8 +21080,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, and edits organizational units in MongoDB Cloud.`, Commands: []shared_api.Command{ { - OperationID: `createOrganization`, - Aliases: nil, + OperationID: `createOrganization`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one organization in MongoDB Cloud and links it to the requesting Service Account's or API Key's organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. The requesting Service Account's or API Key's organization must be a paying organization. To learn more, see Configure a Paying Organization in the MongoDB Atlas documentation. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorganization. @@ -20865,8 +21126,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createOrganizationInvitation`, - Aliases: nil, + OperationID: `createOrganizationInvitation`, + ShortOperationID: ``, + Aliases: nil, Description: `Invites one MongoDB Cloud user to join the specified organization. The user must accept the invitation to access information within the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -20924,8 +21186,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteOrganization`, - Aliases: nil, + OperationID: `deleteOrganization`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one specified organization. MongoDB Cloud imposes the following limits on this resource: @@ -20978,8 +21241,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteOrganizationInvitation`, - Aliases: nil, + OperationID: `deleteOrganizationInvitation`, + ShortOperationID: ``, + Aliases: nil, Description: `Cancels one pending invitation sent to the specified MongoDB Cloud user to join an organization. You can't cancel an invitation that the user accepted. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -21047,8 +21311,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getOrganization`, - Aliases: nil, + OperationID: `getOrganization`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one organization to which the requesting Service Account or API Key has access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorganization. @@ -21103,8 +21368,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getOrganizationInvitation`, - Aliases: nil, + OperationID: `getOrganizationInvitation`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details of one pending invitation to the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -21162,8 +21428,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getOrganizationSettings`, - Aliases: nil, + OperationID: `getOrganizationSettings`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about the specified organization's settings. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorganizationsettings. @@ -21218,8 +21485,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrganizationInvitations`, - Aliases: nil, + OperationID: `listOrganizationInvitations`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all pending invitations to the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -21287,8 +21555,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrganizationProjects`, - Aliases: nil, + OperationID: `listOrganizationProjects`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns multiple projects in the specified organization. Each organization can have multiple projects. Use projects to: @@ -21400,8 +21669,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrganizations`, - Aliases: nil, + OperationID: `listOrganizations`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all organizations to which the requesting Service Account or API Key has access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizations. @@ -21485,8 +21755,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateOrganization`, - Aliases: nil, + OperationID: `updateOrganization`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganization. @@ -21541,8 +21812,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateOrganizationInvitation`, - Aliases: nil, + OperationID: `updateOrganizationInvitation`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the details of one pending invitation, identified by the username of the invited user, to the specified organization. To use this resource, the requesting API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationinvitation. @@ -21597,8 +21869,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateOrganizationInvitationById`, - Aliases: nil, + OperationID: `updateOrganizationInvitationById`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the details of one pending invitation, identified by its unique ID, to the specified organization. Use the Return All Organization Invitations endpoint to retrieve IDs for all pending organization invitations. To use this resource, the requesting API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationinvitationbyid. @@ -21663,8 +21936,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateOrganizationRoles`, - Aliases: nil, + OperationID: `updateOrganizationRoles`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the roles of the specified user in the specified organization. To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified organization. To use this resource, the requesting Service Account or API Key must have the Organization User Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationroles. @@ -21729,8 +22003,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateOrganizationSettings`, - Aliases: nil, + OperationID: `updateOrganizationSettings`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the organization's settings. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorganizationsettings. @@ -21791,8 +22066,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Returns suggested indexes and slow query data for a database deployment. Also enables or disables MongoDB Cloud-managed slow operation thresholds. To view field values in a sample query, you must have the Project Data Access Read Only role or higher. Otherwise, MongoDB Cloud returns redacted data rather than the field values.`, Commands: []shared_api.Command{ { - OperationID: `disableSlowOperationThresholding`, - Aliases: nil, + OperationID: `disableSlowOperationThresholding`, + ShortOperationID: ``, + Aliases: nil, Description: `Disables the slow operation threshold that MongoDB Cloud calculated for the specified project. The threshold determines which operations the Performance Advisor and Query Profiler considers slow. When enabled, MongoDB Cloud uses the average execution time for operations on your cluster to determine slow-running queries. As a result, the threshold is more pertinent to your cluster workload. The slow operation threshold is enabled by default for dedicated clusters (M10+). When disabled, MongoDB Cloud considers any operation that takes longer than 100 milliseconds to be slow. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-disableslowoperationthresholding. @@ -21851,8 +22127,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `enableSlowOperationThresholding`, - Aliases: nil, + OperationID: `enableSlowOperationThresholding`, + ShortOperationID: ``, + Aliases: nil, Description: `Enables MongoDB Cloud to use its slow operation threshold for the specified project. The threshold determines which operations the Performance Advisor and Query Profiler considers slow. When enabled, MongoDB Cloud uses the average execution time for operations on your cluster to determine slow-running queries. As a result, the threshold is more pertinent to your cluster workload. The slow operation threshold is enabled by default for dedicated clusters (M10+). When disabled, MongoDB Cloud considers any operation that takes longer than 100 milliseconds to be slow. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-enableslowoperationthresholding. @@ -21911,8 +22188,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getManagedSlowMs`, - Aliases: nil, + OperationID: `getManagedSlowMs`, + ShortOperationID: ``, + Aliases: nil, Description: `Get whether the Managed Slow MS feature is enabled. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getmanagedslowms. @@ -21971,8 +22249,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getServerlessAutoIndexing`, - Aliases: nil, + OperationID: `getServerlessAutoIndexing`, + ShortOperationID: ``, + Aliases: nil, Description: `Get whether the Serverless Auto Indexing feature is enabled. This endpoint returns a value for Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. However, the value returned is not indicative of the Auto Indexing state as Auto Indexing is unavailable for Flex clusters. This endpoint will be sunset in January 2026. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserverlessautoindexing. @@ -22041,8 +22320,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listClusterSuggestedIndexes`, - Aliases: nil, + OperationID: `listClusterSuggestedIndexes`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the indexes that the Performance Advisor suggests. The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclustersuggestedindexes. @@ -22145,8 +22425,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDropIndexes`, - Aliases: nil, + OperationID: `listDropIndexes`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the indexes that the Performance Advisor suggests to drop. The Performance Advisor suggests dropping unused, redundant, and hidden indexes to improve write performance and increase storage space. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdropindexes. @@ -22194,8 +22475,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listSchemaAdvice`, - Aliases: nil, + OperationID: `listSchemaAdvice`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the schema suggestions that the Performance Advisor detects. The Performance Advisor provides holistic schema recommendations for your cluster by sampling documents in your most active collections and collections with slow-running queries. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listschemaadvice. @@ -22243,8 +22525,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listSlowQueries`, - Aliases: nil, + OperationID: `listSlowQueries`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns log lines for slow queries that the Performance Advisor and Query Profiler identified. The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. MongoDB Cloud bases the threshold for slow queries on the average time of operations on your cluster. This enables workload-relevant recommendations. To use this resource, the requesting Service Account or API Key must have any Project Data Access role or the Project Observability Viewer role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listslowqueries. @@ -22397,8 +22680,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listSlowQueryNamespaces`, - Aliases: nil, + OperationID: `listSlowQueryNamespaces`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns up to 20 namespaces for collections experiencing slow queries on the specified host. If you specify a secondary member of a replica set that hasn't received any database read operations, the endpoint doesn't return any namespaces. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listslowquerynamespaces. @@ -22501,8 +22785,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listSuggestedIndexes`, - Aliases: nil, + OperationID: `listSuggestedIndexes`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the indexes that the Performance Advisor suggests. The Performance Advisor monitors queries that MongoDB considers slow and suggests new indexes to improve query performance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listsuggestedindexes. @@ -22665,8 +22950,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `setServerlessAutoIndexing`, - Aliases: nil, + OperationID: `setServerlessAutoIndexing`, + ShortOperationID: ``, + Aliases: nil, Description: `Set whether the Serverless Auto Indexing feature is enabled. This endpoint sets a value for Flex clusters that were created with the createServerlessInstance endpoint or Flex clusters that were migrated from Serverless instances. However, the value returned is not indicative of the Auto Indexing state as Auto Indexing is unavailable for Flex clusters. This endpoint will be sunset in January 2026. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-setserverlessautoindexing. @@ -22741,8 +23027,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes private endpoint services.`, Commands: []shared_api.Command{ { - OperationID: `createPrivateEndpoint`, - Aliases: nil, + OperationID: `createPrivateEndpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one private endpoint for the specified cloud service provider. This cloud service provider manages the private endpoint service, which in turn manages the private endpoints for the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. To learn more about considerations, limitations, and prerequisites, see the MongoDB documentation for setting up a private endpoint. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprivateendpoint. @@ -22821,8 +23108,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createPrivateEndpointService`, - Aliases: nil, + OperationID: `createPrivateEndpointService`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one private endpoint service for the specified cloud service provider. This cloud service provider manages the private endpoint service for the project. When you create a private endpoint service, MongoDB Cloud creates a network container in the project for the cloud provider for which you create the private endpoint service if one doesn't already exist. To learn more about private endpoint terminology in MongoDB Cloud, see Private Endpoint Concepts. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprivateendpointservice. @@ -22901,8 +23189,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deletePrivateEndpoint`, - Aliases: nil, + OperationID: `deletePrivateEndpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one private endpoint from the specified project and private endpoint service, as managed by the specified cloud service provider. When the last private endpoint is removed from a given private endpoint service, that private endpoint service is also removed. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprivateendpoint. @@ -22991,8 +23280,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deletePrivateEndpointService`, - Aliases: nil, + OperationID: `deletePrivateEndpointService`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one private endpoint service from the specified project. This cloud service provider manages the private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprivateendpointservice. @@ -23086,8 +23376,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getPrivateEndpoint`, - Aliases: nil, + OperationID: `getPrivateEndpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the connection state of the specified private endpoint. The private endpoint service manages this private endpoint which belongs to one project hosted from one cloud service provider. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprivateendpoint. @@ -23176,8 +23467,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getPrivateEndpointService`, - Aliases: nil, + OperationID: `getPrivateEndpointService`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the name, interfaces, and state of the specified private endpoint service from one project. The cloud service provider hosted this private endpoint service that belongs to the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprivateendpointservice. @@ -23256,8 +23548,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getRegionalizedPrivateEndpointSetting`, - Aliases: nil, + OperationID: `getRegionalizedPrivateEndpointSetting`, + ShortOperationID: ``, + Aliases: nil, Description: `Checks whether each region in the specified cloud service provider can create multiple private endpoints per region. The cloud service provider manages the private endpoint for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getregionalizedprivateendpointsetting. @@ -23316,8 +23609,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listPrivateEndpointServices`, - Aliases: nil, + OperationID: `listPrivateEndpointServices`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the name, interfaces, and state of all private endpoint services for the specified cloud service provider. This cloud service provider manages the private endpoint service for the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprivateendpointservices. @@ -23386,8 +23680,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `toggleRegionalizedPrivateEndpointSetting`, - Aliases: nil, + OperationID: `toggleRegionalizedPrivateEndpointSetting`, + ShortOperationID: ``, + Aliases: nil, Description: `Enables or disables the ability to create multiple private endpoints per region in all cloud service providers in one project. The cloud service provider manages the private endpoints for the project. Connection strings to existing multi-region and global sharded clusters change when you enable this setting. You must update your applications to use the new connection strings. This might cause downtime. To use this resource, the requesting Service Account or API Key must have the Project Owner role and all clusters in the deployment must be sharded clusters. Once enabled, you cannot create replica sets. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-toggleregionalizedprivateendpointsetting. @@ -23452,8 +23747,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes access tokens to use the MongoDB Cloud API. MongoDB Cloud applies these keys to organizations. These resources can return, assign, or revoke use of these keys within a specified project.`, Commands: []shared_api.Command{ { - OperationID: `addProjectApiKey`, - Aliases: nil, + OperationID: `addProjectApiKey`, + ShortOperationID: ``, + Aliases: nil, Description: `Assigns the specified organization API key to the specified project. Users with the Project Owner role in the project associated with the API key can then use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addprojectapikey. @@ -23522,8 +23818,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createApiKey`, - Aliases: nil, + OperationID: `createApiKey`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one API key for the specified organization. An organization API key grants programmatic access to an organization. You can't use the API key to log into the console. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createapikey. @@ -23578,8 +23875,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createApiKeyAccessList`, - Aliases: nil, + OperationID: `createApiKeyAccessList`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates the access list entries for the specified organization API key. Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createapikeyaccesslist. @@ -23674,8 +23972,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createProjectApiKey`, - Aliases: nil, + OperationID: `createProjectApiKey`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates and assigns the specified organization API key to the specified project. Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectapikey. @@ -23734,8 +24033,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteApiKey`, - Aliases: nil, + OperationID: `deleteApiKey`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one organization API key from the specified organization. When you remove an API key from an organization, MongoDB Cloud also removes that key from any projects that use that key. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteapikey. @@ -23800,8 +24100,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteApiKeyAccessListEntry`, - Aliases: nil, + OperationID: `deleteApiKeyAccessListEntry`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes the specified access list entry from the specified organization API key. Resources require all API requests originate from the IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Read Write role. In addition, you cannot remove the requesting IP address from the requesting organization API key. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteapikeyaccesslistentry. @@ -23876,8 +24177,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getApiKey`, - Aliases: nil, + OperationID: `getApiKey`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one organization API key. The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the user interface. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getapikey. @@ -23942,8 +24244,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getApiKeyAccessList`, - Aliases: nil, + OperationID: `getApiKeyAccessList`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one access list entry for the specified organization API key. Resources require all API requests originate from IP addresses on the API access list. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getapikeyaccesslist. @@ -24018,8 +24321,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listApiKeyAccessListsEntries`, - Aliases: nil, + OperationID: `listApiKeyAccessListsEntries`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all access list entries that you configured for the specified organization API key. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listapikeyaccesslistsentries. @@ -24114,8 +24418,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listApiKeys`, - Aliases: nil, + OperationID: `listApiKeys`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all organization API keys for the specified organization. The organization API keys grant programmatic access to an organization. You can't use the API key to log into MongoDB Cloud through the console. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listapikeys. @@ -24200,8 +24505,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listProjectApiKeys`, - Aliases: nil, + OperationID: `listProjectApiKeys`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all organization API keys that you assigned to the specified project. Users with the Project Owner role in the project associated with the API key can use the organization API key to access the resources. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectapikeys. @@ -24290,8 +24596,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `removeProjectApiKey`, - Aliases: nil, + OperationID: `removeProjectApiKey`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one organization API key from the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeprojectapikey. @@ -24360,8 +24667,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateApiKey`, - Aliases: nil, + OperationID: `updateApiKey`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one organization API key in the specified organization. The organization API keys grant programmatic access to an organization. To use this resource, the requesting API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateapikey. @@ -24426,8 +24734,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateApiKeyRoles`, - Aliases: nil, + OperationID: `updateApiKeyRoles`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the roles of the organization API key that you specify for the project that you specify. You must specify at least one valid role for the project. The application removes any roles that you do not include in this request if they were previously set in the organization API key that you specify for the project. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateapikeyroles. @@ -24532,8 +24841,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes network access limits to database deployments in Atlas. This resource replaces the whitelist resource. Atlas removed whitelists in July 2021. Update your applications to use this new resource. This resource manages a project's IP Access List and supports creating temporary Access List entries that automatically expire within a user-configurable 7-day period.`, Commands: []shared_api.Command{ { - OperationID: `createProjectIpAccessList`, - Aliases: nil, + OperationID: `createProjectIpAccessList`, + ShortOperationID: ``, + Aliases: nil, Description: `Adds one or more access list entries to the specified project. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. Write each entry as either one IP address or one CIDR-notated block of IP addresses. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. This endpoint doesn't support concurrent POST requests. You must submit multiple POST requests synchronously. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectipaccesslist. @@ -24622,8 +24932,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteProjectIpAccessList`, - Aliases: nil, + OperationID: `deleteProjectIpAccessList`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one access list entry from the specified project's IP access list. Each entry in the project's IP access list contains one IP address, one CIDR-notated block of IP addresses, or one AWS Security Group ID. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectipaccesslist. @@ -24702,8 +25013,9 @@ which protocol (like TCP or UDP) the connection uses.`, }, }, { - OperationID: `getProjectIpAccessListStatus`, - Aliases: nil, + OperationID: `getProjectIpAccessListStatus`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the status of one project IP access list entry. This resource checks if the provided project IP access list entry applies to all cloud providers serving clusters from the specified project. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectipaccessliststatus. @@ -24772,8 +25084,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getProjectIpList`, - Aliases: nil, + OperationID: `getProjectIpList`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one access list entry from the specified project's IP access list. Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. This endpoint (/groups/{GROUP-ID}/accessList) manages the Project IP Access List. It doesn't manage the access list for MongoDB Cloud organizations. TheProgrammatic API Keys endpoint (/orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist) manages those access lists. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectiplist. @@ -24842,8 +25155,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listProjectIpAccessLists`, - Aliases: nil, + OperationID: `listProjectIpAccessLists`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all access list entries from the specified project's IP access list. Each entry in the project's IP access list contains either one IP address or one CIDR-notated block of IP addresses. MongoDB Cloud only allows client connections to the cluster from entries in the project's IP access list. To use this resource, the requesting Service Account or API Key must have the Project Read Only or Project Charts Admin roles. This resource replaces the whitelist resource. MongoDB Cloud removed whitelists in July 2021. Update your applications to use this new resource. The /groups/{GROUP-ID}/accessList endpoint manages the database IP access list. This endpoint is distinct from the orgs/{ORG-ID}/apiKeys/{API-KEY-ID}/accesslist endpoint, which manages the access list for MongoDB Cloud organizations. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectipaccesslists. @@ -24938,8 +25252,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, and edits collections of clusters and users in MongoDB Cloud.`, Commands: []shared_api.Command{ { - OperationID: `addUserToProject`, - Aliases: nil, + OperationID: `addUserToProject`, + ShortOperationID: ``, + Aliases: nil, Description: `Adds one MongoDB Cloud user to the specified project. If the MongoDB Cloud user is not a member of the project's organization, then the user must accept their invitation to the organization to access information within the specified project. If the MongoDB Cloud User is already a member of the project's organization, then they will be added to the project immediately and an invitation will not be returned by this resource. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addusertoproject. @@ -24999,8 +25314,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createProject`, - Aliases: nil, + OperationID: `createProject`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Read Write role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createproject. @@ -25054,8 +25370,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createProjectInvitation`, - Aliases: nil, + OperationID: `createProjectInvitation`, + ShortOperationID: ``, + Aliases: nil, Description: `Invites one MongoDB Cloud user to join the specified project. The MongoDB Cloud user must accept the invitation to access information within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectinvitation. @@ -25114,8 +25431,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteProject`, - Aliases: nil, + OperationID: `deleteProject`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes the specified project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. You can delete a project only if there are no Online Archives for the clusters in the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteproject. @@ -25174,8 +25492,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteProjectInvitation`, - Aliases: nil, + OperationID: `deleteProjectInvitation`, + ShortOperationID: ``, + Aliases: nil, Description: `Cancels one pending invitation sent to the specified MongoDB Cloud user to join a project. You can't cancel an invitation that the user accepted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectinvitation. @@ -25234,8 +25553,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteProjectLimit`, - Aliases: nil, + OperationID: `deleteProjectLimit`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes the specified project limit. Depending on the limit, Atlas either resets the limit to its default value or removes the limit entirely. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectlimit. @@ -25321,8 +25641,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getProject`, - Aliases: nil, + OperationID: `getProject`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about the specified project. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getproject. @@ -25381,8 +25702,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getProjectByName`, - Aliases: nil, + OperationID: `getProjectByName`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about the project identified by its name. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectbyname. @@ -25437,8 +25759,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getProjectInvitation`, - Aliases: nil, + OperationID: `getProjectInvitation`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details of one pending invitation to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectinvitation. @@ -25507,8 +25830,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getProjectLimit`, - Aliases: nil, + OperationID: `getProjectLimit`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the specified limit for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectlimit. @@ -25594,8 +25918,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getProjectLtsVersions`, - Aliases: nil, + OperationID: `getProjectLtsVersions`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the MongoDB Long Term Support Major Versions available to new clusters in this project. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectltsversions. @@ -25704,8 +26029,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getProjectSettings`, - Aliases: nil, + OperationID: `getProjectSettings`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about the specified project's settings. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectsettings. @@ -25764,8 +26090,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listProjectInvitations`, - Aliases: nil, + OperationID: `listProjectInvitations`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all pending invitations to the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectinvitations. @@ -25834,8 +26161,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listProjectLimits`, - Aliases: nil, + OperationID: `listProjectLimits`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all the limits for the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectlimits. @@ -25894,8 +26222,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listProjects`, - Aliases: nil, + OperationID: `listProjects`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details about all projects. Projects group clusters into logical collections that support an application environment, workload, or both. Each project can have its own users, teams, security, tags, and alert settings. To use this resource, the requesting Service Account or API Key must have the Organization Read Only role or higher. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojects. @@ -25969,8 +26298,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `migrateProjectToAnotherOrg`, - Aliases: nil, + OperationID: `migrateProjectToAnotherOrg`, + ShortOperationID: ``, + Aliases: nil, Description: `Migrates a project from its current organization to another organization. All project users and their roles will be copied to the same project in the destination organization. You must include an organization API key with the Organization Owner role for the destination organization to verify access to the destination organization when you authenticate with Programmatic API Keys. Otherwise, the requesting user must have the Organization Owner role in both organizations. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-migrateprojecttoanotherorg. @@ -26019,8 +26349,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `returnAllIpAddresses`, - Aliases: nil, + OperationID: `returnAllIpAddresses`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all IP addresses for this project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-returnallipaddresses. @@ -26079,8 +26410,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `setProjectLimit`, - Aliases: nil, + OperationID: `setProjectLimit`, + ShortOperationID: ``, + Aliases: nil, Description: `Sets the specified project limit. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -26169,8 +26501,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateProject`, - Aliases: nil, + OperationID: `updateProject`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the human-readable label that identifies the specified project, or the tags associated with the project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateproject. @@ -26229,8 +26562,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateProjectInvitation`, - Aliases: nil, + OperationID: `updateProjectInvitation`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the details of one pending invitation, identified by the username of the invited user, to the specified project. To use this resource, the requesting API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectinvitation. @@ -26289,8 +26623,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateProjectInvitationById`, - Aliases: nil, + OperationID: `updateProjectInvitationById`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the details of one pending invitation, identified by its unique ID, to the specified project. Use the Return All Project Invitations endpoint to retrieve IDs for all pending project invitations. To use this resource, the requesting API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectinvitationbyid. @@ -26349,8 +26684,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateProjectRoles`, - Aliases: nil, + OperationID: `updateProjectRoles`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the roles of the specified user in the specified project. To specify the user to update, provide the unique 24-hexadecimal digit string that identifies the user in the specified project. To use this resource, the requesting Service Account or API Key must have the Group User Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectroles. @@ -26419,8 +26755,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateProjectSettings`, - Aliases: nil, + OperationID: `updateProjectSettings`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the settings of the specified project. You can update any of the options available. MongoDB cloud only updates the options provided in the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectsettings. @@ -26485,8 +26822,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `You can continually push logs from mongod, mongos, and audit logs to an AWS S3 bucket. Atlas exports logs every 5 minutes.`, Commands: []shared_api.Command{ { - OperationID: `createPushBasedLogConfiguration`, - Aliases: nil, + OperationID: `createPushBasedLogConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Configures the project level settings for the push-based log export feature. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createpushbasedlogconfiguration. @@ -26545,8 +26883,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deletePushBasedLogConfiguration`, - Aliases: nil, + OperationID: `deletePushBasedLogConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Disables the push-based log export feature by resetting the project level settings to its default configuration. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletepushbasedlogconfiguration. @@ -26605,8 +26944,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getPushBasedLogConfiguration`, - Aliases: nil, + OperationID: `getPushBasedLogConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Fetches the current project level settings for the push-based log export feature. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getpushbasedlogconfiguration. @@ -26665,8 +27005,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updatePushBasedLogConfiguration`, - Aliases: nil, + OperationID: `updatePushBasedLogConfiguration`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the project level settings for the push-based log export feature. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatepushbasedlogconfiguration. @@ -26731,8 +27072,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: ``, Commands: []shared_api.Command{ { - OperationID: `getGroupClusterQueryShapeInsightDetails`, - Aliases: nil, + OperationID: `getGroupClusterQueryShapeInsightDetails`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the metadata and statistics summary for a given query shape hash. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterqueryshapeinsightdetails. @@ -26855,8 +27197,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getGroupClusterQueryShapeInsightSummaries`, - Aliases: nil, + OperationID: `getGroupClusterQueryShapeInsightSummaries`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns a list of query shape statistics summaries for a given cluster. Query shape statistics provide performance insights about MongoDB queries, helping users identify problematic query patterns and potential optimizations. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getgroupclusterqueryshapeinsightsummaries. @@ -27025,8 +27368,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Configure and manage Atlas Resource Policies within your organization.`, Commands: []shared_api.Command{ { - OperationID: `createOrgResourcePolicy`, - Aliases: nil, + OperationID: `createOrgResourcePolicy`, + ShortOperationID: ``, + Aliases: nil, Description: `Create one Atlas Resource Policy for an org. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createorgresourcepolicy. @@ -27081,8 +27425,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteOrgResourcePolicy`, - Aliases: nil, + OperationID: `deleteOrgResourcePolicy`, + ShortOperationID: ``, + Aliases: nil, Description: `Delete one Atlas Resource Policy for an org. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteorgresourcepolicy. @@ -27147,8 +27492,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getOrgResourcePolicy`, - Aliases: nil, + OperationID: `getOrgResourcePolicy`, + ShortOperationID: ``, + Aliases: nil, Description: `Return one Atlas Resource Policy for an org. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getorgresourcepolicy. @@ -27213,8 +27559,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getResourcesNonCompliant`, - Aliases: nil, + OperationID: `getResourcesNonCompliant`, + ShortOperationID: ``, + Aliases: nil, Description: `Return all non-compliant resources for an org. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getresourcesnoncompliant. @@ -27269,8 +27616,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrgResourcePolicies`, - Aliases: nil, + OperationID: `listOrgResourcePolicies`, + ShortOperationID: ``, + Aliases: nil, Description: `Return all Atlas Resource Policies for the org. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorgresourcepolicies. @@ -27325,8 +27673,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateOrgResourcePolicy`, - Aliases: nil, + OperationID: `updateOrgResourcePolicy`, + ShortOperationID: ``, + Aliases: nil, Description: `Update one Atlas Resource Policy for an org. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateorgresourcepolicy. @@ -27391,8 +27740,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `validateAtlasResourcePolicy`, - Aliases: nil, + OperationID: `validateAtlasResourcePolicy`, + ShortOperationID: ``, + Aliases: nil, Description: `Validate one Atlas Resource Policy for an org. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-validateatlasresourcepolicy. @@ -27453,8 +27803,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Creates one index to a database deployment in a rolling manner. Rolling indexes build indexes on the applicable nodes sequentially and may reduce the performance impact of an index build if your deployment's average CPU utilization exceeds (N-1)/N-10% where N is the number of CPU threads available to mongod of if the WiredTiger cache fill ratio regularly exceeds 90%. If your deployment does not meet this criteria, use the default index build. You can't create a rolling index on an M0 free cluster or M2/M5 shared cluster.`, Commands: []shared_api.Command{ { - OperationID: `createRollingIndex`, - Aliases: nil, + OperationID: `createRollingIndex`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates an index on the cluster identified by its name in a rolling manner. Creating the index in this way allows index builds on one replica set member as a standalone at a time, starting with the secondary members. Creating indexes in this way requires at least one replica set election. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createrollingindex. @@ -27529,8 +27880,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns details that describe the MongoDB Cloud build and the access token that requests this resource. This starts the MongoDB Cloud API.`, Commands: []shared_api.Command{ { - OperationID: `getSystemStatus`, - Aliases: nil, + OperationID: `getSystemStatus`, + ShortOperationID: ``, + Aliases: nil, Description: `This resource returns information about the MongoDB application along with API key meta data. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getsystemstatus. @@ -27574,8 +27926,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `returnAllControlPlaneIpAddresses`, - Aliases: nil, + OperationID: `returnAllControlPlaneIpAddresses`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all control plane IP addresses. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-returnallcontrolplaneipaddresses. @@ -27615,8 +27968,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Returns, adds, edits, and removes serverless instances.`, Commands: []shared_api.Command{ { - OperationID: `createServerlessInstance`, - Aliases: nil, + OperationID: `createServerlessInstance`, + ShortOperationID: ``, + Aliases: nil, Description: `Update as of Feb 2025: This endpoint now creates a Flex cluster instead. This endpoint will no longer be supported starting January 2026. Continuous backups are not supported and serverlessContinuousBackupEnabled will not take effect. Please use the createFlexCluster endpoint instead. @@ -27696,8 +28050,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteServerlessInstance`, - Aliases: nil, + OperationID: `deleteServerlessInstance`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one serverless instance from the specified project. The serverless instance must have termination protection disabled in order to be deleted. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -27783,8 +28138,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getServerlessInstance`, - Aliases: nil, + OperationID: `getServerlessInstance`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details for one serverless instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -27856,8 +28212,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listServerlessInstances`, - Aliases: nil, + OperationID: `listServerlessInstances`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details for all serverless instances in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -27949,8 +28306,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateServerlessInstance`, - Aliases: nil, + OperationID: `updateServerlessInstance`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one serverless instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -28046,8 +28404,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes private endpoints for serverless instances. To learn more, see the Atlas Administration API tab on the following tutorial.`, Commands: []shared_api.Command{ { - OperationID: `createServerlessPrivateEndpoint`, - Aliases: nil, + OperationID: `createServerlessPrivateEndpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one private endpoint for one serverless instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -28112,8 +28471,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteServerlessPrivateEndpoint`, - Aliases: nil, + OperationID: `deleteServerlessPrivateEndpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Remove one private endpoint from one serverless instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -28185,8 +28545,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getServerlessPrivateEndpoint`, - Aliases: nil, + OperationID: `getServerlessPrivateEndpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Return one private endpoint for one serverless instance. Identify this endpoint using its unique ID. You must have at least the Project Read Only role for the project to successfully call this resource. @@ -28258,8 +28619,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listServerlessPrivateEndpoints`, - Aliases: nil, + OperationID: `listServerlessPrivateEndpoints`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all private endpoints for one serverless instance. You must have at least the Project Read Only role for the project to successfully call this resource. @@ -28321,8 +28683,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateServerlessPrivateEndpoint`, - Aliases: nil, + OperationID: `updateServerlessPrivateEndpoint`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one private endpoint for one serverless instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -28400,8 +28763,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Endpoints for managing Service Accounts and secrets. Service Accounts are used for programmatic access to the Atlas Admin API through the OAuth 2.0 Client Credentials flow.`, Commands: []shared_api.Command{ { - OperationID: `addProjectServiceAccount`, - Aliases: nil, + OperationID: `addProjectServiceAccount`, + ShortOperationID: ``, + Aliases: nil, Description: `Assigns the specified Service Account to the specified Project. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addprojectserviceaccount. @@ -28470,8 +28834,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createProjectServiceAccount`, - Aliases: nil, + OperationID: `createProjectServiceAccount`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one Service Account for the specified Project. The Service Account will automatically be added as an Organization Member to the Organization that the specified Project is a part of. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectserviceaccount. @@ -28530,8 +28895,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createProjectServiceAccountAccessList`, - Aliases: nil, + OperationID: `createProjectServiceAccountAccessList`, + ShortOperationID: ``, + Aliases: nil, Description: `Add Access List Entries for the specified Service Account for the project. Resources require all API requests to originate from IP addresses on the API access list. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectserviceaccountaccesslist. @@ -28630,8 +28996,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createProjectServiceAccountSecret`, - Aliases: nil, + OperationID: `createProjectServiceAccountSecret`, + ShortOperationID: ``, + Aliases: nil, Description: `Create a secret for the specified Service Account in the specified Project. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprojectserviceaccountsecret. @@ -28700,8 +29067,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createServiceAccount`, - Aliases: nil, + OperationID: `createServiceAccount`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one Service Account for the specified Organization. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserviceaccount. @@ -28756,8 +29124,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createServiceAccountAccessList`, - Aliases: nil, + OperationID: `createServiceAccountAccessList`, + ShortOperationID: ``, + Aliases: nil, Description: `Add Access List Entries for the specified Service Account for the organization. Resources require all API requests to originate from IP addresses on the API access list. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserviceaccountaccesslist. @@ -28852,8 +29221,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createServiceAccountSecret`, - Aliases: nil, + OperationID: `createServiceAccountSecret`, + ShortOperationID: ``, + Aliases: nil, Description: `Create a secret for the specified Service Account. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createserviceaccountsecret. @@ -28918,8 +29288,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteProjectServiceAccount`, - Aliases: nil, + OperationID: `deleteProjectServiceAccount`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes the specified Service Account from the specified project. The Service Account will still be a part of the Organization it was created in, and the credentials will remain active until expired or manually revoked. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectserviceaccount. @@ -28988,8 +29359,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteProjectServiceAccountAccessListEntry`, - Aliases: nil, + OperationID: `deleteProjectServiceAccountAccessListEntry`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes the specified access list entry from the specified Service Account for the project. You can't remove the requesting IP address from the access list. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectserviceaccountaccesslistentry. @@ -29068,8 +29440,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteProjectServiceAccountSecret`, - Aliases: nil, + OperationID: `deleteProjectServiceAccountSecret`, + ShortOperationID: ``, + Aliases: nil, Description: `Deletes the specified Service Account secret. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprojectserviceaccountsecret. @@ -29148,8 +29521,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteServiceAccount`, - Aliases: nil, + OperationID: `deleteServiceAccount`, + ShortOperationID: ``, + Aliases: nil, Description: `Deletes the specified Service Account. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserviceaccount. @@ -29214,8 +29588,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteServiceAccountAccessListEntry`, - Aliases: nil, + OperationID: `deleteServiceAccountAccessListEntry`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes the specified access list entry from the specified Service Account for the organization. You can't remove the requesting IP address from the access list. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserviceaccountaccesslistentry. @@ -29290,8 +29665,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteServiceAccountSecret`, - Aliases: nil, + OperationID: `deleteServiceAccountSecret`, + ShortOperationID: ``, + Aliases: nil, Description: `Deletes the specified Service Account secret. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteserviceaccountsecret. @@ -29366,8 +29742,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getProjectServiceAccount`, - Aliases: nil, + OperationID: `getProjectServiceAccount`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one Service Account in the specified Project. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectserviceaccount. @@ -29436,8 +29813,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getServiceAccount`, - Aliases: nil, + OperationID: `getServiceAccount`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the specified Service Account. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getserviceaccount. @@ -29502,8 +29880,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listProjectServiceAccountAccessList`, - Aliases: nil, + OperationID: `listProjectServiceAccountAccessList`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all access list entries that you configured for the specified Service Account for the project. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectserviceaccountaccesslist. @@ -29602,8 +29981,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listProjectServiceAccounts`, - Aliases: nil, + OperationID: `listProjectServiceAccounts`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all Service Accounts for the specified Project. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectserviceaccounts. @@ -29682,8 +30062,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listServiceAccountAccessList`, - Aliases: nil, + OperationID: `listServiceAccountAccessList`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all access list entries that you configured for the specified Service Account for the organization. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserviceaccountaccesslist. @@ -29778,8 +30159,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listServiceAccountProjects`, - Aliases: nil, + OperationID: `listServiceAccountProjects`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns a list of all projects the specified Service Account is a part of. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserviceaccountprojects. @@ -29864,8 +30246,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listServiceAccounts`, - Aliases: nil, + OperationID: `listServiceAccounts`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all Service Accounts for the specified Organization. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listserviceaccounts. @@ -29940,8 +30323,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateProjectServiceAccount`, - Aliases: nil, + OperationID: `updateProjectServiceAccount`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates one Service Account in the specified Project. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateprojectserviceaccount. @@ -30010,8 +30394,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateServiceAccount`, - Aliases: nil, + OperationID: `updateServiceAccount`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the specified Service Account in the specified Organization. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateserviceaccount. @@ -30082,8 +30467,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c Description: `Returns and adds restore jobs for shared-tier database deployments.`, Commands: []shared_api.Command{ { - OperationID: `createSharedClusterBackupRestoreJob`, - Aliases: nil, + OperationID: `createSharedClusterBackupRestoreJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Restores the specified M2 or M5 cluster. MongoDB Cloud limits which clusters can be the target clusters of a restore. The target cluster can't use encryption at rest, run a major release MongoDB version different than the snapshot, or receive client requests during restores. MongoDB Cloud deletes all existing data on the target cluster prior to the restore operation. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -30155,8 +30541,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getSharedClusterBackupRestoreJob`, - Aliases: nil, + OperationID: `getSharedClusterBackupRestoreJob`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the specified restore job for the specified M2 or M5 cluster. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -30238,8 +30625,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listSharedClusterBackupRestoreJobs`, - Aliases: nil, + OperationID: `listSharedClusterBackupRestoreJobs`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all restore jobs for the specified M2 or M5 cluster. Restore jobs restore a cluster using a snapshot. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -30317,8 +30705,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns and requests to download shared-tier database deployment snapshots.`, Commands: []shared_api.Command{ { - OperationID: `downloadSharedClusterBackup`, - Aliases: nil, + OperationID: `downloadSharedClusterBackup`, + ShortOperationID: ``, + Aliases: nil, Description: `Requests one snapshot for the specified shared cluster. This resource returns a snapshotURL that you can use to download the snapshot. This snapshotURL remains active for four hours after you make the request. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -30390,8 +30779,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getSharedClusterBackup`, - Aliases: nil, + OperationID: `getSharedClusterBackup`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details for one snapshot for the specified shared cluster. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -30473,8 +30863,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listSharedClusterBackups`, - Aliases: nil, + OperationID: `listSharedClusterBackups`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns details for all snapshots for the specified shared cluster. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. @@ -30552,8 +30943,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, and removes Streams Instances. This resource requires your project ID.`, Commands: []shared_api.Command{ { - OperationID: `acceptVpcPeeringConnection`, - Aliases: nil, + OperationID: `acceptVpcPeeringConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Requests the acceptance of an incoming VPC Peering connection. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-acceptvpcpeeringconnection. @@ -30612,8 +31004,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createPrivateLinkConnection`, - Aliases: nil, + OperationID: `createPrivateLinkConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one Private Link in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createprivatelinkconnection. @@ -30672,8 +31065,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createStreamConnection`, - Aliases: nil, + OperationID: `createStreamConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one connection for a stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createstreamconnection. @@ -30742,8 +31136,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createStreamInstance`, - Aliases: nil, + OperationID: `createStreamInstance`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createstreaminstance. @@ -30802,8 +31197,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createStreamInstanceWithSampleConnections`, - Aliases: nil, + OperationID: `createStreamInstanceWithSampleConnections`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one stream instance in the specified project with sample connections. To use this resource the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createstreaminstancewithsampleconnections. @@ -30862,8 +31258,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `createStreamProcessor`, - Aliases: nil, + OperationID: `createStreamProcessor`, + ShortOperationID: ``, + Aliases: nil, Description: `Create one Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createstreamprocessor. @@ -30932,8 +31329,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deletePrivateLinkConnection`, - Aliases: nil, + OperationID: `deletePrivateLinkConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Deletes one Private Link in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteprivatelinkconnection. @@ -31002,8 +31400,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteStreamConnection`, - Aliases: nil, + OperationID: `deleteStreamConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Delete one connection of the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletestreamconnection. @@ -31082,8 +31481,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteStreamInstance`, - Aliases: nil, + OperationID: `deleteStreamInstance`, + ShortOperationID: ``, + Aliases: nil, Description: `Delete one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletestreaminstance. @@ -31152,8 +31552,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteStreamProcessor`, - Aliases: nil, + OperationID: `deleteStreamProcessor`, + ShortOperationID: ``, + Aliases: nil, Description: `Delete a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletestreamprocessor. @@ -31232,8 +31633,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteVpcPeeringConnection`, - Aliases: nil, + OperationID: `deleteVpcPeeringConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Deletes an incoming VPC Peering connection. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletevpcpeeringconnection. @@ -31292,8 +31694,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `downloadStreamTenantAuditLogs`, - Aliases: nil, + OperationID: `downloadStreamTenantAuditLogs`, + ShortOperationID: ``, + Aliases: nil, Description: `Downloads the audit logs for the specified Atlas Streams Processing instance. By default, logs cover periods of 30 days. To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. The API does not support direct calls with the json response schema. You must request a gzip response schema using an accept header of the format: "Accept: application/vnd.atlas.YYYY-MM-DD+gzip". This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-downloadstreamtenantauditlogs. @@ -31372,8 +31775,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getAccountDetails`, - Aliases: nil, + OperationID: `getAccountDetails`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the Account ID, and the VPC ID for the group and region specified. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getaccountdetails. @@ -31442,8 +31846,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getActiveVpcPeeringConnections`, - Aliases: nil, + OperationID: `getActiveVpcPeeringConnections`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns a list of active incoming VPC Peering Connections. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getactivevpcpeeringconnections. @@ -31522,8 +31927,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getPrivateLinkConnection`, - Aliases: nil, + OperationID: `getPrivateLinkConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details of one Private Link connection within the project. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprivatelinkconnection. @@ -31582,8 +31988,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getStreamConnection`, - Aliases: nil, + OperationID: `getStreamConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details of one stream connection within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getstreamconnection. @@ -31652,8 +32059,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getStreamInstance`, - Aliases: nil, + OperationID: `getStreamInstance`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the details of one stream instance within the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getstreaminstance. @@ -31722,8 +32130,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getStreamProcessor`, - Aliases: nil, + OperationID: `getStreamProcessor`, + ShortOperationID: ``, + Aliases: nil, Description: `Get one Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getstreamprocessor. @@ -31802,8 +32211,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getVpcPeeringConnections`, - Aliases: nil, + OperationID: `getVpcPeeringConnections`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns a list of incoming VPC Peering Connections. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getvpcpeeringconnections. @@ -31892,8 +32302,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listPrivateLinkConnections`, - Aliases: nil, + OperationID: `listPrivateLinkConnections`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all Private Link connections for the specified project. To use this resource, the requesting API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprivatelinkconnections. @@ -31972,8 +32383,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listStreamConnections`, - Aliases: nil, + OperationID: `listStreamConnections`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all connections of the stream instance for the specified project. To use this resource, the requesting API Key must have the Project Data Access roles, Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-liststreamconnections. @@ -32062,8 +32474,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listStreamInstances`, - Aliases: nil, + OperationID: `listStreamInstances`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all stream instances for the specified project. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-liststreaminstances. @@ -32142,8 +32555,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listStreamProcessors`, - Aliases: nil, + OperationID: `listStreamProcessors`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all Stream Processors within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-liststreamprocessors. @@ -32242,8 +32656,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `modifyStreamProcessor`, - Aliases: nil, + OperationID: `modifyStreamProcessor`, + ShortOperationID: ``, + Aliases: nil, Description: `Modify one existing Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-modifystreamprocessor. @@ -32322,8 +32737,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `rejectVpcPeeringConnection`, - Aliases: nil, + OperationID: `rejectVpcPeeringConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Requests the rejection of an incoming VPC Peering connection. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-rejectvpcpeeringconnection. @@ -32382,8 +32798,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `startStreamProcessor`, - Aliases: nil, + OperationID: `startStreamProcessor`, + ShortOperationID: ``, + Aliases: nil, Description: `Start a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startstreamprocessor. @@ -32462,8 +32879,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `startStreamProcessorWith`, - Aliases: nil, + OperationID: `startStreamProcessorWith`, + ShortOperationID: ``, + Aliases: nil, Description: `Start a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-startstreamprocessorwith. @@ -32542,8 +32960,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `stopStreamProcessor`, - Aliases: nil, + OperationID: `stopStreamProcessor`, + ShortOperationID: ``, + Aliases: nil, Description: `Stop a Stream Processor within the specified stream instance. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-stopstreamprocessor. @@ -32622,8 +33041,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateStreamConnection`, - Aliases: nil, + OperationID: `updateStreamConnection`, + ShortOperationID: ``, + Aliases: nil, Description: `Update one connection for the specified stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatestreamconnection. @@ -32702,8 +33122,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateStreamInstance`, - Aliases: nil, + OperationID: `updateStreamInstance`, + ShortOperationID: ``, + Aliases: nil, Description: `Update one stream instance in the specified project. To use this resource, the requesting Service Account or API Key must have the Project Data Access Admin role, Project Owner role or Project Stream Processing Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatestreaminstance. @@ -32778,8 +33199,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, adds, edits, or removes teams.`, Commands: []shared_api.Command{ { - OperationID: `addAllTeamsToProject`, - Aliases: nil, + OperationID: `addAllTeamsToProject`, + ShortOperationID: ``, + Aliases: nil, Description: `Adds one or more teams to the specified project. All members of the team share the same project access. MongoDB Cloud limits the number of users to a maximum of 100 teams per project and a maximum of 250 teams per organization. To use this resource, the requesting API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-addallteamstoproject. @@ -32838,8 +33260,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `addTeamUser`, - Aliases: nil, + OperationID: `addTeamUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Adds one or more MongoDB Cloud users from the specified organization to the specified team. Teams enable you to grant project access roles to MongoDB Cloud users. You can assign up to 250 MongoDB Cloud users from one organization to one team. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -32907,8 +33330,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `createTeam`, - Aliases: nil, + OperationID: `createTeam`, + ShortOperationID: ``, + Aliases: nil, Description: `Creates one team in the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud limits the number of teams to a maximum of 250 teams per organization. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createteam. @@ -32963,8 +33387,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `deleteTeam`, - Aliases: nil, + OperationID: `deleteTeam`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one team specified using its unique 24-hexadecimal digit identifier from the organization specified using its unique 24-hexadecimal digit identifier. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deleteteam. @@ -33029,8 +33454,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getProjectTeam`, - Aliases: nil, + OperationID: `getProjectTeam`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one team to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getprojectteam. @@ -33099,8 +33525,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getTeamById`, - Aliases: nil, + OperationID: `getTeamById`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one team that you identified using its unique 24-hexadecimal digit ID. This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getteambyid. @@ -33165,8 +33592,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `getTeamByName`, - Aliases: nil, + OperationID: `getTeamByName`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns one team that you identified using its human-readable name. This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getteambyname. @@ -33231,8 +33659,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listOrganizationTeams`, - Aliases: nil, + OperationID: `listOrganizationTeams`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all teams that belong to the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. MongoDB Cloud only returns teams for which you have access. To use this resource, the requesting Service Account or API Key must have the Organization Member role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listorganizationteams. @@ -33317,8 +33746,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `listProjectTeams`, - Aliases: nil, + OperationID: `listProjectTeams`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all teams to which the authenticated user has access in the project specified using its unique 24-hexadecimal digit identifier. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listprojectteams. @@ -33407,8 +33837,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `removeProjectTeam`, - Aliases: nil, + OperationID: `removeProjectTeam`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one team specified using its unique 24-hexadecimal digit identifier from the project specified using its unique 24-hexadecimal digit identifier. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-removeprojectteam. @@ -33467,8 +33898,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `removeTeamUser`, - Aliases: nil, + OperationID: `removeTeamUser`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes one MongoDB Cloud user from the specified team. This team belongs to one organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. @@ -33546,8 +33978,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `renameTeam`, - Aliases: nil, + OperationID: `renameTeam`, + ShortOperationID: ``, + Aliases: nil, Description: `Renames one team in the specified organization. Teams enable you to grant project access roles to MongoDB Cloud users. To use this resource, the requesting Service Account or API Key must have the Organization Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-renameteam. @@ -33612,8 +34045,9 @@ For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/c }, }, { - OperationID: `updateTeamRoles`, - Aliases: nil, + OperationID: `updateTeamRoles`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the project roles assigned to the specified team. You can grant team roles for specific projects and grant project access roles to users in the team. All members of the team share the same project access. To use this resource, the requesting Service Account or API Key must have the Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updateteamroles. @@ -33691,8 +34125,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you IMPORTANT: Each project can only have one configuration per integrationType.`, Commands: []shared_api.Command{ { - OperationID: `createThirdPartyIntegration`, - Aliases: nil, + OperationID: `createThirdPartyIntegration`, + ShortOperationID: ``, + Aliases: nil, Description: `Adds the settings for configuring one third-party service integration. These settings apply to all databases managed in the specified MongoDB Cloud project. Each project can have only one configuration per {INTEGRATION-TYPE}. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createthirdpartyintegration. @@ -33791,8 +34226,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `deleteThirdPartyIntegration`, - Aliases: nil, + OperationID: `deleteThirdPartyIntegration`, + ShortOperationID: ``, + Aliases: nil, Description: `Removes the settings that permit configuring one third-party service integration. These settings apply to all databases managed in one MongoDB Cloud project. If you delete an integration from a project, you remove that integration configuration only for that project. This action doesn't affect any other project or organization's configured {INTEGRATION-TYPE} integrations. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-deletethirdpartyintegration. @@ -33861,8 +34297,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `getThirdPartyIntegration`, - Aliases: nil, + OperationID: `getThirdPartyIntegration`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the settings for configuring integration with one third-party service. These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-getthirdpartyintegration. @@ -33931,8 +34368,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listThirdPartyIntegrations`, - Aliases: nil, + OperationID: `listThirdPartyIntegrations`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns the settings that permit integrations with all configured third-party services. These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listthirdpartyintegrations. @@ -34021,8 +34459,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `updateThirdPartyIntegration`, - Aliases: nil, + OperationID: `updateThirdPartyIntegration`, + ShortOperationID: ``, + Aliases: nil, Description: `Updates the settings for configuring integration with one third-party service. These settings apply to all databases managed in one MongoDB Cloud project. To use this resource, the requesting Service Account or API Key must have the Organization Owner or Project Owner role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updatethirdpartyintegration. @@ -34127,8 +34566,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you Description: `Returns, edits, and removes user-managed X.509 configurations. Also returns and generates MongoDB Cloud-managed X.509 certificates for database users. The following resources help manage database users who authenticate using X.509 certificates. You can manage these X.509 certificates or let MongoDB Cloud do it for you. If MongoDB Cloud manages your certificates, it also manages your Certificate Authority and can generate certificates for your database users. No additional X.509 configuration is required. If you manage your certificates, you must provide a Certificate Authority and generate certificates for your database users.`, Commands: []shared_api.Command{ { - OperationID: `createDatabaseUserCertificate`, - Aliases: nil, + OperationID: `createDatabaseUserCertificate`, + ShortOperationID: ``, + Aliases: nil, Description: `Generates one X.509 certificate for the specified MongoDB user. Atlas manages the certificate and MongoDB user that belong to one project. To use this resource, the requesting Service Account or API Key must have the Project Owner role. @@ -34203,8 +34643,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `disableCustomerManagedX509`, - Aliases: nil, + OperationID: `disableCustomerManagedX509`, + ShortOperationID: ``, + Aliases: nil, Description: `Clears the customer-managed X.509 settings on a project, including the uploaded Certificate Authority, which disables self-managed X.509. @@ -34256,8 +34697,9 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you }, }, { - OperationID: `listDatabaseUserCertificates`, - Aliases: nil, + OperationID: `listDatabaseUserCertificates`, + ShortOperationID: ``, + Aliases: nil, Description: `Returns all unexpired X.509 certificates for the specified MongoDB user. This MongoDB user belongs to one project. Atlas manages these certificates and the MongoDB user. To use this resource, the requesting Service Account or API Key must have the Project Read Only role. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listdatabaseusercertificates. From 3f4dd64239d9afb678e40e7b082f4964df888fee Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Wed, 24 Sep 2025 16:57:30 +0100 Subject: [PATCH 04/14] Re-add no-lint comments --- internal/cli/auth/login_test.go | 2 +- internal/store/store_test.go | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/internal/cli/auth/login_test.go b/internal/cli/auth/login_test.go index ac5221afa5..a6f924bcd5 100644 --- a/internal/cli/auth/login_test.go +++ b/internal/cli/auth/login_test.go @@ -284,7 +284,7 @@ func TestLoginOpts_setUpProfile_Success(t *testing.T) { TrackAsk(gomock.Any(), opts). DoAndReturn(func(_ []*survey.Question, answer any, _ ...survey.AskOpt) error { if o, ok := answer.(*LoginOpts); ok { - o.Output = "json" + o.Output = "json" //nolint:goconst } return nil }) diff --git a/internal/store/store_test.go b/internal/store/store_test.go index f7278b92dc..8e04548412 100644 --- a/internal/store/store_test.go +++ b/internal/store/store_test.go @@ -168,7 +168,7 @@ func TestWithContext(t *testing.T) { t.Fatalf("New() unexpected error: %v", err) } - if c.ctx != context.Background() { + if c.ctx != context.Background() { //nolint: usetesting // we test this value t.Errorf("New() got %v; expected %v", c.ctx, t.Context()) } From ba968933fe9fdc8310bc8817b46d2cadf4ee0f2a Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Thu, 25 Sep 2025 11:45:41 +0100 Subject: [PATCH 05/14] Does not add operationId to alias when overriden by x-xgen-atlascli --- tools/cmd/api-generator/convert_commands.go | 64 +++++++++++++++------ 1 file changed, 47 insertions(+), 17 deletions(-) diff --git a/tools/cmd/api-generator/convert_commands.go b/tools/cmd/api-generator/convert_commands.go index 32d24a4a6f..407ee31352 100644 --- a/tools/cmd/api-generator/convert_commands.go +++ b/tools/cmd/api-generator/convert_commands.go @@ -113,32 +113,55 @@ func extractExtensionsFromOperation(operation *openapi3.Operation) operationExte operationAliases: []string{}, } - if extensions, okExtensions := operation.Extensions["x-xgen-atlascli"].(map[string]any); okExtensions && extensions != nil { - if extSkip, okSkip := extensions["skip"].(bool); okSkip && extSkip { - ext.skip = extSkip - } + processAtlasCLIExtensions(&ext, operation.Extensions) + processShortOperationIDOverride(&ext, operation) - if extAliases, okExtAliases := extensions["command-aliases"].([]any); okExtAliases && extAliases != nil { - for _, alias := range extAliases { - if sAlias, ok := alias.(string); ok && sAlias != "" { - ext.operationAliases = append(ext.operationAliases, sAlias) - } + return ext +} + +func processAtlasCLIExtensions(ext *operationExtensions, extensions map[string]any) { + atlasCLIExt, ok := extensions["x-xgen-atlascli"].(map[string]any) + if !ok || atlasCLIExt == nil { + return + } + + if extSkip, okSkip := atlasCLIExt["skip"].(bool); okSkip && extSkip { + ext.skip = extSkip + } + + if extAliases, okExtAliases := atlasCLIExt["command-aliases"].([]any); okExtAliases && extAliases != nil { + for _, alias := range extAliases { + if sAlias, ok := alias.(string); ok && sAlias != "" { + ext.operationAliases = append(ext.operationAliases, sAlias) } } + } - if overrides := extractOverrides(operation.Extensions); overrides != nil { - if overriddenOperationID, ok := overrides["operationId"].(string); ok && overriddenOperationID != "" { - ext.operationID = overriddenOperationID - } + if overrides := extractOverrides(extensions); overrides != nil { + if overriddenOperationID, ok := overrides["operationId"].(string); ok && overriddenOperationID != "" { + ext.operationID = overriddenOperationID } } +} - if shortOperationID, ok := operation.Extensions["x-xgen-operation-id-override"].(string); ok && shortOperationID != "" { - ext.shortOperationID = shortOperationID +func processShortOperationIDOverride(ext *operationExtensions, operation *openapi3.Operation) { + shortOperationID, ok := operation.Extensions["x-xgen-operation-id-override"].(string) + if !ok || shortOperationID == "" { + return + } + + ext.shortOperationID = shortOperationID + + // Only add original operation ID to aliases if there's no Atlas CLI operation ID override + overrides := extractOverrides(operation.Extensions) + if overrides == nil { ext.operationAliases = append(ext.operationAliases, strcase.ToLowerCamel(operation.OperationID)) + return } - return ext + if _, hasOverride := overrides["operationId"].(string); !hasOverride { + ext.operationAliases = append(ext.operationAliases, strcase.ToLowerCamel(operation.OperationID)) + } } func operationToCommand(now time.Time, path, verb string, operation *openapi3.Operation) (*api.Command, error) { @@ -175,6 +198,13 @@ func operationToCommand(now time.Time, path, verb string, operation *openapi3.Op return nil, fmt.Errorf("failed to clean description: %w", err) } + if overrides := extractOverrides(operation.Extensions); overrides != nil { + if overriddenOperationID, ok := overrides["operationId"].(string); ok && overriddenOperationID != "" { + operationID = overriddenOperationID + shortOperationID = "" + } + } + watcher, err := extractWatcherProperties(operation.Extensions) if err != nil { return nil, err @@ -182,7 +212,7 @@ func operationToCommand(now time.Time, path, verb string, operation *openapi3.Op command := api.Command{ OperationID: operationID, - ShortOperationID: strcase.ToLowerCamel(shortOperationID), + ShortOperationID: shortOperationID, Aliases: aliases, Description: description, RequestParameters: api.RequestParameters{ From f28c669a11aee29fedda98a57bf87663d28b9cf7 Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Thu, 25 Sep 2025 11:59:06 +0100 Subject: [PATCH 06/14] Add operationid override snapshot test --- ...perationid-override.yaml-commands.snapshot | 229 + ...perationid-override.yaml-metadata.snapshot | 305 + .../12-short-operationid-override.yaml | 8449 +++++++++++++++++ 3 files changed, 8983 insertions(+) create mode 100644 tools/cmd/api-generator/testdata/.snapshots/12-short-operationid-override.yaml-commands.snapshot create mode 100644 tools/cmd/api-generator/testdata/.snapshots/12-short-operationid-override.yaml-metadata.snapshot create mode 100644 tools/cmd/api-generator/testdata/fixtures/12-short-operationid-override.yaml diff --git a/tools/cmd/api-generator/testdata/.snapshots/12-short-operationid-override.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/12-short-operationid-override.yaml-commands.snapshot new file mode 100644 index 0000000000..3752878325 --- /dev/null +++ b/tools/cmd/api-generator/testdata/.snapshots/12-short-operationid-override.yaml-commands.snapshot @@ -0,0 +1,229 @@ +// Copyright 2025 MongoDB Inc +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// Code generated using `make gen-api-commands`. DO NOT EDIT. +// Don't make any manual changes to this file. + +package api + +import ( + "net/http" + + shared_api "github.com/mongodb/mongodb-atlas-cli/atlascli/tools/shared/api" +) + +var Commands = shared_api.GroupedAndSortedCommands{ + { + Name: `Clusters`, + Description: `Returns, adds, edits, and removes database deployments. Changes to cluster configurations can affect costs. This resource requires your Project ID.`, + Commands: []shared_api.Command{ + { + OperationID: `createClustersX`, + ShortOperationID: ``, + Aliases: nil, + Description: `OVERRIDDEN + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-createcluster. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-createCluster/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/clusters`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodPost, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + { + Version: shared_api.NewStableVersion(2023, 2, 1), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + { + Version: shared_api.NewStableVersion(2024, 8, 5), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + { + Version: shared_api.NewStableVersion(2024, 10, 23), + RequestContentType: `json`, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + { + OperationID: `listClusters`, + ShortOperationID: `listClustersShort`, + Aliases: []string{`listClusters`}, + Description: `Returns the details for all clusters in the specific project to which you have access. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting API Key must have the Project Read Only role. This feature is not available for serverless clusters. + +This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclusters. + +For more information and examples, see: https://www.mongodb.com/docs/atlas/cli/current/command/atlas-api-clusters-listClusters/`, + RequestParameters: shared_api.RequestParameters{ + URL: `/api/atlas/v2/groups/{groupId}/clusters`, + QueryParameters: []shared_api.Parameter{ + { + Name: `envelope`, + Description: `Flag that indicates whether Application wraps the response in an envelope JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `includeCount`, + Description: `Flag that indicates whether the response returns the total number of items (totalCount) in the response.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `itemsPerPage`, + Description: `Number of items that the response returns per page.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `pageNum`, + Description: `Number of the page that displays the current set of the total objects that the response returns.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `int`, + }, + }, + { + Name: `pretty`, + Description: `Flag that indicates whether the response body should be in the prettyprint format.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + { + Name: `includeDeletedWithRetainedBackups`, + Description: `Flag that indicates whether to return Clusters with retain backups.`, + Short: ``, + Required: false, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `bool`, + }, + }, + }, + URLParameters: []shared_api.Parameter{ + { + Name: `groupId`, + Description: `Unique 24-hexadecimal digit string that identifies your project. Use the /groups endpoint to retrieve all projects to which the authenticated user has access. + + +NOTE: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + Short: ``, + Required: true, + Type: shared_api.ParameterType{ + IsArray: false, + Type: `string`, + }, + }, + }, + Verb: http.MethodGet, + }, + Versions: []shared_api.CommandVersion{ + { + Version: shared_api.NewStableVersion(2023, 1, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + { + Version: shared_api.NewStableVersion(2023, 2, 1), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + { + Version: shared_api.NewStableVersion(2024, 8, 5), + RequestContentType: ``, + ResponseContentTypes: []string{ + `json`, + }, + }, + }, + }, + }, + }, +} + diff --git a/tools/cmd/api-generator/testdata/.snapshots/12-short-operationid-override.yaml-metadata.snapshot b/tools/cmd/api-generator/testdata/.snapshots/12-short-operationid-override.yaml-metadata.snapshot new file mode 100644 index 0000000000..55a9b1be34 --- /dev/null +++ b/tools/cmd/api-generator/testdata/.snapshots/12-short-operationid-override.yaml-metadata.snapshot @@ -0,0 +1,305 @@ +// Copyright 2025 MongoDB Inc +// +// Licensed under the Apache License, Version 2.0 (the "License"); +// you may not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, software +// distributed under the License is distributed on an "AS IS" BASIS, +// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +// See the License for the specific language governing permissions and +// limitations under the License. + +// Code generated using `make gen-api-commands`. DO NOT EDIT. +// Don't make any manual changes to this file. + +package main + +import "github.com/mongodb/mongodb-atlas-cli/atlascli/tools/internal/metadatatypes" + +var metadata = metadatatypes.Metadata{ + `createCluster`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2024-08-05`: {{ + Source: `Cluster`, + + Description: `Cluster`, + Value: `{ + "clusterType": "SHARDED", + "name": "myCluster", + "replicationSpecs": [ + { + "regionConfigs": [ + { + "analyticsAutoScaling": { + "autoIndexing": { + "enabled": false + }, + "compute": { + "enabled": false + }, + "diskGB": { + "enabled": true + } + }, + "analyticsSpecs": { + "diskSizeGB": 10, + "instanceSize": "M30", + "nodeCount": 0 + }, + "autoScaling": { + "autoIndexing": { + "enabled": false + }, + "compute": { + "enabled": false + }, + "diskGB": { + "enabled": true + } + }, + "electableSpecs": { + "diskSizeGB": 10, + "instanceSize": "M30", + "nodeCount": 3 + }, + "priority": 7, + "providerName": "AWS", + "readOnlySpecs": { + "diskSizeGB": 10, + "instanceSize": "M30", + "nodeCount": 0 + }, + "regionName": "US_EAST_1" + } + ], + "zoneName": "Zone 1" + }, + { + "regionConfigs": [ + { + "analyticsAutoScaling": { + "autoIndexing": { + "enabled": false + }, + "compute": { + "enabled": false + }, + "diskGB": { + "enabled": true + } + }, + "analyticsSpecs": { + "diskSizeGB": 10, + "instanceSize": "M10", + "nodeCount": 0 + }, + "autoScaling": { + "autoIndexing": { + "enabled": false + }, + "compute": { + "enabled": false + }, + "diskGB": { + "enabled": true + } + }, + "electableSpecs": { + "diskSizeGB": 10, + "instanceSize": "M10", + "nodeCount": 3 + }, + "priority": 7, + "providerName": "AWS", + "readOnlySpecs": { + "diskSizeGB": 10, + "instanceSize": "M10", + "nodeCount": 0 + }, + "regionName": "US_EAST_1" + } + ], + "zoneName": "Zone 1" + } + ] +}`, + Flags: map[string]string{ + `envelope`: `false`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `pretty`: `false`, + }, + }, + }, + `2024-10-23`: {{ + Source: `Cluster`, + + Description: `Cluster`, + Value: `{ + "clusterType": "SHARDED", + "name": "myCluster", + "replicationSpecs": [ + { + "regionConfigs": [ + { + "analyticsAutoScaling": { + "autoIndexing": { + "enabled": false + }, + "compute": { + "enabled": false + }, + "diskGB": { + "enabled": true + } + }, + "analyticsSpecs": { + "diskSizeGB": 10, + "instanceSize": "M30", + "nodeCount": 0 + }, + "autoScaling": { + "autoIndexing": { + "enabled": false + }, + "compute": { + "enabled": false + }, + "diskGB": { + "enabled": true + } + }, + "electableSpecs": { + "diskSizeGB": 10, + "instanceSize": "M30", + "nodeCount": 3 + }, + "priority": 7, + "providerName": "AWS", + "readOnlySpecs": { + "diskSizeGB": 10, + "instanceSize": "M30", + "nodeCount": 0 + }, + "regionName": "US_EAST_1" + } + ], + "zoneName": "Zone 1" + }, + { + "regionConfigs": [ + { + "analyticsAutoScaling": { + "autoIndexing": { + "enabled": false + }, + "compute": { + "enabled": false + }, + "diskGB": { + "enabled": true + } + }, + "analyticsSpecs": { + "diskSizeGB": 10, + "instanceSize": "M10", + "nodeCount": 0 + }, + "autoScaling": { + "autoIndexing": { + "enabled": false + }, + "compute": { + "enabled": false + }, + "diskGB": { + "enabled": true + } + }, + "electableSpecs": { + "diskSizeGB": 10, + "instanceSize": "M10", + "nodeCount": 3 + }, + "priority": 7, + "providerName": "AWS", + "readOnlySpecs": { + "diskSizeGB": 10, + "instanceSize": "M10", + "nodeCount": 0 + }, + "regionName": "US_EAST_1" + } + ], + "zoneName": "Zone 1" + } + ] +}`, + Flags: map[string]string{ + `envelope`: `false`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `pretty`: `false`, + }, + }, + }, + }, + }, + `listClusters`: { + Parameters: map[string]metadatatypes.ParameterMetadata{ + `envelope`: { + Usage: `Flag that indicates whether Application wraps the response in an ` + "`" + `envelope` + "`" + ` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body.`, + }, + `groupId`: { + Usage: `Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + +**NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups.`, + }, + `includeCount`: { + Usage: `Flag that indicates whether the response returns the total number of items (**totalCount**) in the response.`, + }, + `includeDeletedWithRetainedBackups`: { + Usage: `Flag that indicates whether to return Clusters with retain backups.`, + }, + `itemsPerPage`: { + Usage: `Number of items that the response returns per page.`, + }, + `pageNum`: { + Usage: `Number of the page that displays the current set of the total objects that the response returns.`, + }, + `pretty`: { + Usage: `Flag that indicates whether the response body should be in the prettyprint format.`, + }, + }, + Examples: map[string][]metadatatypes.Example{ + `2024-08-05`: {{ + Source: `-`, + + Flags: map[string]string{ + `envelope`: `false`, + `groupId`: `32b6e34b3d91647abb20e7b8`, + `includeCount`: `true`, + `itemsPerPage`: `100`, + `pageNum`: `1`, + `pretty`: `false`, + }, + }, + }, + }, + }, +} + diff --git a/tools/cmd/api-generator/testdata/fixtures/12-short-operationid-override.yaml b/tools/cmd/api-generator/testdata/fixtures/12-short-operationid-override.yaml new file mode 100644 index 0000000000..9da5755f84 --- /dev/null +++ b/tools/cmd/api-generator/testdata/fixtures/12-short-operationid-override.yaml @@ -0,0 +1,8449 @@ +openapi: 3.0.1 +info: + description: |- + The MongoDB Atlas Administration API allows developers to manage all components in MongoDB Atlas. + + The Atlas Administration API uses HTTP Digest Authentication to authenticate requests. Provide a programmatic API public key and corresponding private key as the username and password when constructing the HTTP request. For example, to [return database access history](#tag/Access-Tracking/operation/listAccessLogsByClusterName) with [cURL](https://en.wikipedia.org/wiki/CURL), run the following command in the terminal: + + ``` + curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" \ + --digest \ + --header "Accept: application/vnd.atlas.2025-01-01+json" \ + -X GET "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/dbAccessHistory/clusters/{clusterName}?pretty=true" + ``` + + To learn more, see [Get Started with the Atlas Administration API](https://www.mongodb.com/docs/atlas/configure-api-access/). For support, see [MongoDB Support](https://www.mongodb.com/support/get-started). + + You can also explore the various endpoints available through the Atlas Administration API in MongoDB's [Postman workspace](https://www.postman.com/mongodb-devrel/workspace/mongodb-atlas-administration-apis/). + license: + name: CC BY-NC-SA 3.0 US + url: https://creativecommons.org/licenses/by-nc-sa/3.0/us/ + termsOfService: https://www.mongodb.com/mongodb-management-service-terms-and-conditions + title: MongoDB Atlas Administration API + version: '2.0' + x-xgen-sha: e4e03e44a819d3c9846972a63cc6d6acf236fbd7 +servers: + - url: https://cloud.mongodb.com +security: + - DigestAuth: [] +tags: + - description: Returns, adds, edits, and removes database deployments. Changes to cluster configurations can affect costs. This resource requires your Project ID. + name: Clusters +paths: + /api/atlas/v2/groups/{groupId}/clusters: + get: + description: Returns the details for all clusters in the specific project to which you have access. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting API Key must have the Project Read Only role. This feature is not available for serverless clusters. + x-xgen-operation-id-override: listClustersShort + operationId: listClusters + parameters: + - $ref: '#/components/parameters/envelope' + - $ref: '#/components/parameters/groupId' + - $ref: '#/components/parameters/includeCount' + - $ref: '#/components/parameters/itemsPerPage' + - $ref: '#/components/parameters/pageNum' + - $ref: '#/components/parameters/pretty' + - description: Flag that indicates whether to return Clusters with retain backups. + in: query + name: includeDeletedWithRetainedBackups + schema: + default: false + type: boolean + responses: + '200': + content: + application/vnd.atlas.2023-01-01+json: + schema: + $ref: '#/components/schemas/PaginatedLegacyClusterView' + x-sunset: '2025-06-01' + x-xgen-version: '2023-01-01' + application/vnd.atlas.2023-02-01+json: + schema: + $ref: '#/components/schemas/PaginatedAdvancedClusterDescriptionView' + x-sunset: '2026-03-01' + x-xgen-version: '2023-02-01' + application/vnd.atlas.2024-08-05+json: + schema: + $ref: '#/components/schemas/PaginatedClusterDescription20240805' + x-xgen-version: '2024-08-05' + description: OK + '401': + $ref: '#/components/responses/unauthorized' + '500': + $ref: '#/components/responses/internalServerError' + summary: Return All Clusters in One Project + tags: + - Clusters + x-xgen-owner-team: Atlas Dedicated + post: + description: Creates one cluster in the specified project. Clusters contain a group of hosts that maintain the same data set. This resource can create clusters with asymmetrically-sized shards. Each project supports up to 25 database deployments. To use this resource, the requesting API Key must have the Project Owner role. This feature is not available for serverless clusters. + x-xgen-atlascli: + override: + description: OVERRIDDEN + operationId: createClustersX + x-xgen-operation-id-override: createClustersShort + operationId: createCluster + parameters: + - $ref: '#/components/parameters/envelope' + - $ref: '#/components/parameters/groupId' + - $ref: '#/components/parameters/pretty' + requestBody: + content: + application/vnd.atlas.2023-01-01+json: + schema: + $ref: '#/components/schemas/LegacyAtlasCluster' + application/vnd.atlas.2023-02-01+json: + schema: + $ref: '#/components/schemas/AdvancedClusterDescription' + application/vnd.atlas.2024-08-05+json: + examples: + Cluster: + description: Cluster + value: + clusterType: SHARDED + name: myCluster + replicationSpecs: + - regionConfigs: + - analyticsAutoScaling: + autoIndexing: + enabled: false + compute: + enabled: false + diskGB: + enabled: true + analyticsSpecs: + diskSizeGB: 10 + instanceSize: M30 + nodeCount: 0 + autoScaling: + autoIndexing: + enabled: false + compute: + enabled: false + diskGB: + enabled: true + electableSpecs: + diskSizeGB: 10 + instanceSize: M30 + nodeCount: 3 + priority: 7 + providerName: AWS + readOnlySpecs: + diskSizeGB: 10 + instanceSize: M30 + nodeCount: 0 + regionName: US_EAST_1 + zoneName: Zone 1 + - regionConfigs: + - analyticsAutoScaling: + autoIndexing: + enabled: false + compute: + enabled: false + diskGB: + enabled: true + analyticsSpecs: + diskSizeGB: 10 + instanceSize: M10 + nodeCount: 0 + autoScaling: + autoIndexing: + enabled: false + compute: + enabled: false + diskGB: + enabled: true + electableSpecs: + diskSizeGB: 10 + instanceSize: M10 + nodeCount: 3 + priority: 7 + providerName: AWS + readOnlySpecs: + diskSizeGB: 10 + instanceSize: M10 + nodeCount: 0 + regionName: US_EAST_1 + zoneName: Zone 1 + schema: + $ref: '#/components/schemas/ClusterDescription20240805' + x-xgen-version: '2024-08-05' + application/vnd.atlas.2024-10-23+json: + examples: + Cluster: + description: Cluster + value: + clusterType: SHARDED + name: myCluster + replicationSpecs: + - regionConfigs: + - analyticsAutoScaling: + autoIndexing: + enabled: false + compute: + enabled: false + diskGB: + enabled: true + analyticsSpecs: + diskSizeGB: 10 + instanceSize: M30 + nodeCount: 0 + autoScaling: + autoIndexing: + enabled: false + compute: + enabled: false + diskGB: + enabled: true + electableSpecs: + diskSizeGB: 10 + instanceSize: M30 + nodeCount: 3 + priority: 7 + providerName: AWS + readOnlySpecs: + diskSizeGB: 10 + instanceSize: M30 + nodeCount: 0 + regionName: US_EAST_1 + zoneName: Zone 1 + - regionConfigs: + - analyticsAutoScaling: + autoIndexing: + enabled: false + compute: + enabled: false + diskGB: + enabled: true + analyticsSpecs: + diskSizeGB: 10 + instanceSize: M10 + nodeCount: 0 + autoScaling: + autoIndexing: + enabled: false + compute: + enabled: false + diskGB: + enabled: true + electableSpecs: + diskSizeGB: 10 + instanceSize: M10 + nodeCount: 3 + priority: 7 + providerName: AWS + readOnlySpecs: + diskSizeGB: 10 + instanceSize: M10 + nodeCount: 0 + regionName: US_EAST_1 + zoneName: Zone 1 + schema: + $ref: '#/components/schemas/ClusterDescription20240805' + x-xgen-version: '2024-10-23' + description: Cluster to create in this project. + required: true + responses: + '201': + content: + application/vnd.atlas.2023-01-01+json: + schema: + $ref: '#/components/schemas/LegacyAtlasCluster' + x-sunset: '2025-06-01' + x-xgen-version: '2023-01-01' + application/vnd.atlas.2023-02-01+json: + schema: + $ref: '#/components/schemas/AdvancedClusterDescription' + x-sunset: '2026-03-01' + x-xgen-version: '2023-02-01' + application/vnd.atlas.2024-08-05+json: + schema: + $ref: '#/components/schemas/ClusterDescription20240805' + x-sunset: '2026-03-01' + x-xgen-version: '2024-08-05' + application/vnd.atlas.2024-10-23+json: + schema: + $ref: '#/components/schemas/ClusterDescription20240805' + x-xgen-version: '2024-10-23' + description: Created + '400': + $ref: '#/components/responses/badRequest' + '401': + $ref: '#/components/responses/unauthorized' + '402': + $ref: '#/components/responses/paymentRequired' + '403': + $ref: '#/components/responses/forbidden' + '409': + $ref: '#/components/responses/conflict' + '500': + $ref: '#/components/responses/internalServerError' + summary: Create One Cluster from One Project + tags: + - Clusters + x-xgen-owner-team: Atlas Dedicated +components: + parameters: + envelope: + description: Flag that indicates whether Application wraps the response in an `envelope` JSON object. Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query. Endpoints that return a list of results use the results object as an envelope. Application adds the status parameter to the response body. + in: query + name: envelope + schema: + default: false + example: false + type: boolean + groupId: + description: |- + Unique 24-hexadecimal digit string that identifies your project. Use the [/groups](#tag/Projects/operation/listProjects) endpoint to retrieve all projects to which the authenticated user has access. + + **NOTE**: Groups and projects are synonymous terms. Your group id is the same as your project id. For existing groups, your group/project id remains the same. The resource and corresponding endpoints use the term groups. + in: path + name: groupId + required: true + schema: + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + includeCount: + description: Flag that indicates whether the response returns the total number of items (**totalCount**) in the response. + in: query + name: includeCount + schema: + default: true + example: true + type: boolean + itemsPerPage: + description: Number of items that the response returns per page. + in: query + name: itemsPerPage + schema: + default: 100 + example: 100 + maximum: 500 + minimum: 1 + type: integer + pageNum: + description: Number of the page that displays the current set of the total objects that the response returns. + in: query + name: pageNum + schema: + default: 1 + example: 1 + minimum: 1 + type: integer + pretty: + description: Flag that indicates whether the response body should be in the prettyprint format. + in: query + name: pretty + schema: + default: false + example: false + type: boolean + responses: + badRequest: + content: + application/json: + example: + detail: (This is just an example, the exception may not be related to this endpoint) No provider AWS exists. + error: 400 + errorCode: VALIDATION_ERROR + reason: Bad Request + schema: + $ref: '#/components/schemas/ApiError' + description: Bad Request. + conflict: + content: + application/json: + example: + detail: '(This is just an example, the exception may not be related to this endpoint) Cannot delete organization link while there is active migration in following project ids: 60c4fd418ebe251047c50554' + error: 409 + errorCode: CANNOT_DELETE_ORG_ACTIVE_LIVE_MIGRATION_ATLAS_ORG_LINK + reason: Conflict + schema: + $ref: '#/components/schemas/ApiError' + description: Conflict. + forbidden: + content: + application/json: + example: + detail: (This is just an example, the exception may not be related to this endpoint) + error: 403 + errorCode: CANNOT_CHANGE_GROUP_NAME + reason: Forbidden + schema: + $ref: '#/components/schemas/ApiError' + description: Forbidden. + internalServerError: + content: + application/json: + example: + detail: (This is just an example, the exception may not be related to this endpoint) + error: 500 + errorCode: UNEXPECTED_ERROR + reason: Internal Server Error + schema: + $ref: '#/components/schemas/ApiError' + description: Internal Server Error. + paymentRequired: + content: + application/json: + example: + detail: (This is just an example, the exception may not be related to this endpoint) + error: 402 + errorCode: NO_PAYMENT_INFORMATION_FOUND + reason: Payment Required + schema: + $ref: '#/components/schemas/ApiError' + description: Payment Required. + unauthorized: + content: + application/json: + example: + detail: (This is just an example, the exception may not be related to this endpoint) + error: 401 + errorCode: NOT_ORG_GROUP_CREATOR + reason: Unauthorized + schema: + $ref: '#/components/schemas/ApiError' + description: Unauthorized. + schemas: + AWSCloudProviderContainer: + allOf: + - $ref: '#/components/schemas/CloudProviderContainer' + - properties: + atlasCidrBlock: + description: |- + IP addresses expressed in Classless Inter-Domain Routing (CIDR) notation that MongoDB Cloud uses for the network peering containers in your project. MongoDB Cloud assigns all of the project's clusters deployed to this cloud provider an IP address from this range. MongoDB Cloud locks this value if an M10 or greater cluster or a network peering connection exists in this project. + + These CIDR blocks must fall within the ranges reserved per RFC 1918. AWS and Azure further limit the block to between the `/24` and `/21` ranges. + + To modify the CIDR block, the target project cannot have: + + - Any M10 or greater clusters + - Any other VPC peering connections + + You can also create a new project and create a network peering connection to set the desired MongoDB Cloud network peering container CIDR block for that project. MongoDB Cloud limits the number of MongoDB nodes per network peering connection based on the CIDR block and the region selected for the project. + + **Example:** A project in an Amazon Web Services (AWS) region supporting three availability zones and an MongoDB CIDR network peering container block of limit of `/24` equals 27 three-node replica sets. + pattern: ^((([0-9]{1,3}\.){3}[0-9]{1,3})|(:{0,2}([0-9a-f]{1,4}:){0,7}[0-9a-f]{1,4}[:]{0,2}))((%2[fF]|/)[0-9]{1,3})+$ + type: string + regionName: + description: Geographic area that Amazon Web Services (AWS) defines to which MongoDB Cloud deployed this network peering container. + enum: + - US_EAST_1 + - US_EAST_2 + - US_WEST_1 + - US_WEST_2 + - CA_CENTRAL_1 + - EU_NORTH_1 + - EU_WEST_1 + - EU_WEST_2 + - EU_WEST_3 + - EU_CENTRAL_1 + - EU_CENTRAL_2 + - SA_EAST_1 + - AP_EAST_1 + - AP_SOUTHEAST_2 + - AP_SOUTHEAST_3 + - AP_SOUTHEAST_4 + - AP_NORTHEAST_1 + - AP_NORTHEAST_2 + - AP_NORTHEAST_3 + - AP_SOUTHEAST_1 + - AP_SOUTH_1 + - AP_SOUTH_2 + - CN_NORTH_1 + - CN_NORTHWEST_1 + - ME_CENTRAL_1 + - ME_SOUTH_1 + - AF_SOUTH_1 + - EU_SOUTH_1 + - EU_SOUTH_2 + - IL_CENTRAL_1 + - CA_WEST_1 + - GLOBAL + - US_GOV_WEST_1 + - US_GOV_EAST_1 + type: string + vpcId: + description: Unique string that identifies the MongoDB Cloud VPC on AWS. + example: vpc-b555d3b0d9cb783b0 + minLength: 5 + pattern: ^vpc-[0-9a-f]{17}$ + readOnly: true + type: string + type: object + description: Collection of settings that configures the network container for a virtual private connection on Amazon Web Services. + required: + - regionName + title: AWS + type: object + AWSCloudProviderSettings: + allOf: + - $ref: '#/components/schemas/ClusterProviderSettings' + - properties: + autoScaling: + $ref: '#/components/schemas/CloudProviderAWSAutoScaling' + diskIOPS: + description: Maximum Disk Input/Output Operations per Second (IOPS) that the database host can perform. + format: int32 + type: integer + encryptEBSVolume: + default: true + deprecated: true + description: Flag that indicates whether the Amazon Elastic Block Store (EBS) encryption feature encrypts the host's root volume for both data at rest within the volume and for data moving between the volume and the cluster. Clusters always have this setting enabled. + type: boolean + instanceSizeName: + description: Cluster tier, with a default storage and memory capacity, that applies to all the data-bearing hosts in your cluster. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M100 + - M140 + - M200 + - M300 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - R700 + - M40_NVME + - M50_NVME + - M60_NVME + - M80_NVME + - M200_NVME + - M400_NVME + title: AWS Instance Sizes + type: string + regionName: + description: Physical location where MongoDB Cloud deploys your AWS-hosted MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. MongoDB Cloud assigns the VPC a CIDR block. To limit a new VPC peering connection to one CIDR block and region, create the connection first. Deploy the cluster after the connection starts. + enum: + - US_GOV_WEST_1 + - US_GOV_EAST_1 + - US_EAST_1 + - US_EAST_2 + - US_WEST_1 + - US_WEST_2 + - CA_CENTRAL_1 + - EU_NORTH_1 + - EU_WEST_1 + - EU_WEST_2 + - EU_WEST_3 + - EU_CENTRAL_1 + - EU_CENTRAL_2 + - AP_EAST_1 + - AP_NORTHEAST_1 + - AP_NORTHEAST_2 + - AP_NORTHEAST_3 + - AP_SOUTHEAST_1 + - AP_SOUTHEAST_2 + - AP_SOUTHEAST_3 + - AP_SOUTHEAST_4 + - AP_SOUTH_1 + - AP_SOUTH_2 + - SA_EAST_1 + - CN_NORTH_1 + - CN_NORTHWEST_1 + - ME_SOUTH_1 + - ME_CENTRAL_1 + - AF_SOUTH_1 + - EU_SOUTH_1 + - EU_SOUTH_2 + - IL_CENTRAL_1 + - CA_WEST_1 + - GLOBAL + externalDocs: + description: AWS + url: https://docs.atlas.mongodb.com/reference/amazon-aws/#std-label-amazon-aws + title: AWS Regions + type: string + volumeType: + description: Disk Input/Output Operations per Second (IOPS) setting for Amazon Web Services (AWS) storage that you configure only for abbr title="Amazon Web Services">AWS. Specify whether Disk Input/Output Operations per Second (IOPS) must not exceed the default Input/Output Operations per Second (IOPS) rate for the selected volume size (`STANDARD`), or must fall within the allowable Input/Output Operations per Second (IOPS) range for the selected volume size (`PROVISIONED`). You must set this value to (`PROVISIONED`) for NVMe clusters. + enum: + - STANDARD + - PROVISIONED + type: string + type: object + type: object + AWSComputeAutoScaling: + description: Collection of settings that configures how a cluster might scale its cluster tier and whether the cluster can scale down. Cluster tier auto-scaling is unavailable for clusters using Low CPU or NVME storage classes. + properties: + maxInstanceSize: + description: Maximum instance size to which your cluster can automatically scale. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M100 + - M140 + - M200 + - M300 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - R700 + - M40_NVME + - M50_NVME + - M60_NVME + - M80_NVME + - M200_NVME + - M400_NVME + title: AWS Instance Sizes + type: string + minInstanceSize: + description: Minimum instance size to which your cluster can automatically scale. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M100 + - M140 + - M200 + - M300 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - R700 + - M40_NVME + - M50_NVME + - M60_NVME + - M80_NVME + - M200_NVME + - M400_NVME + title: AWS Instance Sizes + type: string + title: AWS + type: object + AWSCreateDataProcessRegionView: + allOf: + - $ref: '#/components/schemas/CreateDataProcessRegionView' + - properties: + region: + description: Human-readable label that identifies the geographic location of the region where you wish to store your archived data. + enum: + - US_EAST_1 + - US_WEST_2 + - SA_EAST_1 + - EU_WEST_1 + - EU_WEST_2 + - EU_CENTRAL_1 + - AP_SOUTH_1 + - AP_SOUTHEAST_1 + - AP_SOUTHEAST_2 + type: string + type: object + type: object + AWSDataProcessRegionView: + allOf: + - $ref: '#/components/schemas/DataProcessRegionView' + - properties: + region: + description: Human-readable label that identifies the geographic location of the region where you store your archived data. + enum: + - US_EAST_1 + - US_WEST_2 + - SA_EAST_1 + - EU_WEST_1 + - EU_WEST_2 + - EU_CENTRAL_1 + - AP_SOUTH_1 + - AP_SOUTHEAST_1 + - AP_SOUTHEAST_2 + readOnly: true + type: string + type: object + type: object + AWSHardwareSpec: + description: Hardware specifications for nodes deployed in the region. + properties: + diskIOPS: + description: |- + Target IOPS (Input/Output Operations Per Second) desired for storage attached to this hardware. + + Change this parameter if you: + + - set `"replicationSpecs[n].regionConfigs[m].providerName" to "AWS"`. + - set `"replicationSpecs[n].regionConfigs[m].electableSpecs.instanceSize" to "M30"` or greater (not including `Mxx_NVME` tiers). + + - set `"replicationSpecs[n].regionConfigs[m].electableSpecs.ebsVolumeType" to "PROVISIONED"`. + + The maximum input/output operations per second (IOPS) depend on the selected **.instanceSize** and **.diskSizeGB**. + This parameter defaults to the cluster tier's standard IOPS value. + Changing this value impacts cluster cost. + MongoDB Cloud enforces minimum ratios of storage capacity to system memory for given cluster tiers. This keeps cluster performance consistent with large datasets. + + - Instance sizes `M10` to `M40` have a ratio of disk capacity to system memory of 60:1. + - Instance sizes greater than `M40` have a ratio of 120:1. + format: int32 + type: integer + ebsVolumeType: + default: STANDARD + description: |- + Type of storage you want to attach to your AWS-provisioned cluster. + + - `STANDARD` volume types can't exceed the default input/output operations per second (IOPS) rate for the selected volume size. + + - `PROVISIONED` volume types must fall within the allowable IOPS range for the selected volume size. You must set this value to (`PROVISIONED`) for NVMe clusters. + enum: + - STANDARD + - PROVISIONED + type: string + instanceSize: + description: Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts of the node type. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M100 + - M140 + - M200 + - M300 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - R700 + - M40_NVME + - M50_NVME + - M60_NVME + - M80_NVME + - M200_NVME + - M400_NVME + title: AWS Instance Sizes + type: string + nodeCount: + description: Number of nodes of the given type for MongoDB Cloud to deploy to the region. + format: int32 + type: integer + title: AWS Cluster Hardware Settings + type: object + AWSHardwareSpec20240805: + description: Hardware specifications for nodes deployed in the region. + properties: + diskIOPS: + description: |- + Target IOPS (Input/Output Operations Per Second) desired for storage attached to this hardware. + + You can set different IOPS values on different shards when provisioned IOPS are supported. + + Change this parameter if you: + + - set `"replicationSpecs[n].regionConfigs[m].providerName" to "AWS"`. + - set `"replicationSpecs[n].regionConfigs[m].electableSpecs.instanceSize" to "M30"` or greater (not including `Mxx_NVME` tiers). + + - set `"replicationSpecs[n].regionConfigs[m].electableSpecs.ebsVolumeType" to "PROVISIONED"`. + + The maximum input/output operations per second (IOPS) depend on the selected **.instanceSize** and **.diskSizeGB**. + This parameter defaults to the cluster tier's standard IOPS value. + Changing this value impacts cluster cost. + MongoDB Cloud enforces minimum ratios of storage capacity to system memory for given cluster tiers. This keeps cluster performance consistent with large datasets. + + - Instance sizes `M10` to `M40` have a ratio of disk capacity to system memory of 60:1. + - Instance sizes greater than `M40` have a ratio of 120:1. + format: int32 + type: integer + diskSizeGB: + description: |- + Storage capacity of instance data volumes expressed in gigabytes. Increase this number to add capacity. + + This value must be equal for all shards and node types. + + This value is not configurable on M0/M2/M5 clusters. + + MongoDB Cloud requires this parameter if you set **replicationSpecs**. + + If you specify a disk size below the minimum (10 GB), this parameter defaults to the minimum disk size value. + + Storage charge calculations depend on whether you choose the default value or a custom value. + + The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require more storage space, consider upgrading your cluster to a higher tier. + format: double + maximum: 4096 + minimum: 10 + type: number + ebsVolumeType: + default: STANDARD + description: |- + Type of storage you want to attach to your AWS-provisioned cluster. + + - `STANDARD` volume types can't exceed the default input/output operations per second (IOPS) rate for the selected volume size. + + - `PROVISIONED` volume types must fall within the allowable IOPS range for the selected volume size. You must set this value to (`PROVISIONED`) for NVMe clusters. + enum: + - STANDARD + - PROVISIONED + type: string + instanceSize: + description: Hardware specification for the instance sizes in this region in this shard. Each instance size has a default storage and memory capacity. Electable nodes and read-only nodes (known as "base nodes") within a single shard must use the same instance size. Analytics nodes can scale independently from base nodes within a shard. Both base nodes and analytics nodes can scale independently from their equivalents in other shards. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M100 + - M140 + - M200 + - M300 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - R700 + - M40_NVME + - M50_NVME + - M60_NVME + - M80_NVME + - M200_NVME + - M400_NVME + title: AWS Instance Sizes + type: string + nodeCount: + description: Number of nodes of the given type for MongoDB Cloud to deploy to the region. + format: int32 + type: integer + title: AWS Cluster Hardware Settings + type: object + AWSRegionConfig: + allOf: + - $ref: '#/components/schemas/CloudRegionConfig' + - properties: + analyticsAutoScaling: + $ref: '#/components/schemas/AdvancedAutoScalingSettings' + analyticsSpecs: + $ref: '#/components/schemas/DedicatedHardwareSpec' + autoScaling: + $ref: '#/components/schemas/AdvancedAutoScalingSettings' + readOnlySpecs: + $ref: '#/components/schemas/DedicatedHardwareSpec' + type: object + description: Details that explain how MongoDB Cloud replicates data in one region on the specified MongoDB database. + title: AWS Regional Replication Specifications + type: object + AWSRegionConfig20240805: + allOf: + - $ref: '#/components/schemas/CloudRegionConfig20240805' + - properties: + analyticsAutoScaling: + $ref: '#/components/schemas/AdvancedAutoScalingSettings' + analyticsSpecs: + $ref: '#/components/schemas/DedicatedHardwareSpec20240805' + autoScaling: + $ref: '#/components/schemas/AdvancedAutoScalingSettings' + readOnlySpecs: + $ref: '#/components/schemas/DedicatedHardwareSpec20240805' + type: object + description: Details that explain how MongoDB Cloud replicates data in one region on the specified MongoDB database. + title: AWS Regional Replication Specifications + type: object + AdvancedAutoScalingSettings: + description: Options that determine how this cluster handles resource scaling. + properties: + compute: + $ref: '#/components/schemas/AdvancedComputeAutoScaling' + diskGB: + $ref: '#/components/schemas/DiskGBAutoScaling' + title: Automatic Scaling Settings + type: object + AdvancedClusterDescription: + properties: + acceptDataRisksAndForceReplicaSetReconfig: + description: If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set **acceptDataRisksAndForceReplicaSetReconfig** to the current date. + externalDocs: + description: Reconfiguring a Replica Set during a regional outage + url: https://dochub.mongodb.org/core/regional-outage-reconfigure-replica-set + format: date-time + type: string + backupEnabled: + default: false + description: Flag that indicates whether the cluster can perform backups. If set to `true`, the cluster can perform backups. You must set this value to `true` for NVMe clusters. Backup uses [Cloud Backups](https://docs.atlas.mongodb.com/backup/cloud-backup/overview/) for dedicated clusters and [Shared Cluster Backups](https://docs.atlas.mongodb.com/backup/shared-tier/overview/) for tenant clusters. If set to `false`, the cluster doesn't use backups. + type: boolean + biConnector: + $ref: '#/components/schemas/BiConnector' + clusterType: + description: Configuration of nodes that comprise the cluster. + enum: + - REPLICASET + - SHARDED + - GEOSHARDED + type: string + configServerManagementMode: + default: ATLAS_MANAGED + description: |- + Config Server Management Mode for creating or updating a sharded cluster. + + When configured as ATLAS_MANAGED, atlas may automatically switch the cluster's config server type for optimal performance and savings. + + When configured as FIXED_TO_DEDICATED, the cluster will always use a dedicated config server. + enum: + - ATLAS_MANAGED + - FIXED_TO_DEDICATED + externalDocs: + description: MongoDB Sharded Cluster Config Servers + url: https://dochub.mongodb.org/docs/manual/core/sharded-cluster-config-servers + type: string + configServerType: + description: Describes a sharded cluster's config server type. + enum: + - DEDICATED + - EMBEDDED + externalDocs: + description: MongoDB Sharded Cluster Config Servers + url: https://dochub.mongodb.org/docs/manual/core/sharded-cluster-config-servers + readOnly: true + type: string + connectionStrings: + $ref: '#/components/schemas/ClusterConnectionStrings' + createDate: + description: Date and time when MongoDB Cloud created this cluster. This parameter expresses its value in ISO 8601 format in UTC. + format: date-time + readOnly: true + type: string + diskSizeGB: + description: |- + Storage capacity of instance data volumes expressed in gigabytes. Increase this number to add capacity. + + This value is not configurable on M0/M2/M5 clusters. + + MongoDB Cloud requires this parameter if you set **replicationSpecs**. + + If you specify a disk size below the minimum (10 GB), this parameter defaults to the minimum disk size value. + + Storage charge calculations depend on whether you choose the default value or a custom value. + + The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require more storage space, consider upgrading your cluster to a higher tier. + format: double + maximum: 4096 + minimum: 10 + type: number + diskWarmingMode: + default: FULLY_WARMED + description: Disk warming mode selection. + enum: + - FULLY_WARMED + - VISIBLE_EARLIER + externalDocs: + description: Reduce Secondary Disk Warming Impact + url: https://docs.atlas.mongodb.com/reference/replica-set-tags/#reduce-secondary-disk-warming-impact + type: string + encryptionAtRestProvider: + description: 'Cloud service provider that manages your customer keys to provide an additional layer of encryption at rest for the cluster. To enable customer key management for encryption at rest, the cluster **replicationSpecs[n].regionConfigs[m].{type}Specs.instanceSize** setting must be `M10` or higher and `"backupEnabled" : false` or omitted entirely.' + enum: + - NONE + - AWS + - AZURE + - GCP + externalDocs: + description: Encryption at Rest using Customer Key Management + url: https://www.mongodb.com/docs/atlas/security-kms-encryption/ + type: string + featureCompatibilityVersion: + description: Feature compatibility version of the cluster. + readOnly: true + type: string + featureCompatibilityVersionExpirationDate: + description: Feature compatibility version expiration date. + format: date-time + readOnly: true + type: string + globalClusterSelfManagedSharding: + description: |- + Set this field to configure the Sharding Management Mode when creating a new Global Cluster. + + When set to false, the management mode is set to Atlas-Managed Sharding. This mode fully manages the sharding of your Global Cluster and is built to provide a seamless deployment experience. + + When set to true, the management mode is set to Self-Managed Sharding. This mode leaves the management of shards in your hands and is built to provide an advanced and flexible deployment experience. + + This setting cannot be changed once the cluster is deployed. + externalDocs: + description: Creating a Global Cluster + url: https://dochub.mongodb.org/core/global-cluster-management + type: boolean + groupId: + description: Unique 24-hexadecimal character string that identifies the project. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + id: + description: Unique 24-hexadecimal digit string that identifies the cluster. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + labels: + deprecated: true + description: |- + Collection of key-value pairs between 1 to 255 characters in length that tag and categorize the cluster. The MongoDB Cloud console doesn't display your labels. + + Cluster labels are deprecated and will be removed in a future release. We strongly recommend that you use [resource tags](https://dochub.mongodb.org/core/add-cluster-tag-atlas) instead. + items: + $ref: '#/components/schemas/ComponentLabel' + type: array + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + mongoDBEmployeeAccessGrant: + $ref: '#/components/schemas/EmployeeAccessGrantView' + mongoDBMajorVersion: + description: |- + MongoDB major version of the cluster. + + On creation: Choose from the available versions of MongoDB, or leave unspecified for the current recommended default in the MongoDB Cloud platform. The recommended version is a recent Long Term Support version. The default is not guaranteed to be the most recently released version throughout the entire release cycle. For versions available in a specific project, see the linked documentation or use the API endpoint for [project LTS versions endpoint](#tag/Projects/operation/getProjectLTSVersions). + + On update: Increase version only by 1 major version at a time. If the cluster is pinned to a MongoDB feature compatibility version exactly one major version below the current MongoDB version, the MongoDB version can be downgraded to the previous major version. + externalDocs: + description: Available MongoDB Versions in Atlas + url: https://www.mongodb.com/docs/atlas/reference/faq/database/#which-versions-of-mongodb-do-service-clusters-use- + type: string + mongoDBVersion: + description: Version of MongoDB that the cluster runs. + pattern: ([\d]+\.[\d]+\.[\d]+) + readOnly: true + type: string + name: + description: Human-readable label that identifies the advanced cluster. + maxLength: 64 + minLength: 1 + pattern: ^([a-zA-Z0-9][a-zA-Z0-9-]*)?[a-zA-Z0-9]+$ + type: string + paused: + description: Flag that indicates whether the cluster is paused. + type: boolean + pitEnabled: + description: Flag that indicates whether the cluster uses continuous cloud backups. + externalDocs: + description: Continuous Cloud Backups + url: https://docs.atlas.mongodb.com/backup/cloud-backup/overview/ + type: boolean + replicaSetScalingStrategy: + default: WORKLOAD_TYPE + description: |- + Set this field to configure the replica set scaling mode for your cluster. + + By default, Atlas scales under WORKLOAD_TYPE. This mode allows Atlas to scale your analytics nodes in parallel to your operational nodes. + + When configured as SEQUENTIAL, Atlas scales all nodes sequentially. This mode is intended for steady-state workloads and applications performing latency-sensitive secondary reads. + + When configured as NODE_TYPE, Atlas scales your electable nodes in parallel with your read-only and analytics nodes. This mode is intended for large, dynamic workloads requiring frequent and timely cluster tier scaling. This is the fastest scaling strategy, but it might impact latency of workloads when performing extensive secondary reads. + enum: + - SEQUENTIAL + - WORKLOAD_TYPE + - NODE_TYPE + externalDocs: + description: Modify the Replica Set Scaling Mode + url: https://dochub.mongodb.org/core/scale-nodes + type: string + replicationSpecs: + description: List of settings that configure your cluster regions. For Global Clusters, each object in the array represents a zone where your clusters nodes deploy. For non-Global sharded clusters and replica sets, this array has one object representing where your clusters nodes deploy. + items: + $ref: '#/components/schemas/ReplicationSpec' + type: array + rootCertType: + default: ISRGROOTX1 + description: Root Certificate Authority that MongoDB Cloud cluster uses. MongoDB Cloud supports Internet Security Research Group. + enum: + - ISRGROOTX1 + type: string + stateName: + description: Human-readable label that indicates the current operating condition of this cluster. + enum: + - IDLE + - CREATING + - UPDATING + - DELETING + - REPAIRING + readOnly: true + type: string + tags: + description: List that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. + externalDocs: + description: Resource Tags + url: https://dochub.mongodb.org/core/add-cluster-tag-atlas + items: + $ref: '#/components/schemas/ResourceTag' + type: array + terminationProtectionEnabled: + default: false + description: Flag that indicates whether termination protection is enabled on the cluster. If set to `true`, MongoDB Cloud won't delete the cluster. If set to `false`, MongoDB Cloud will delete the cluster. + type: boolean + versionReleaseSystem: + default: LTS + description: Method by which the cluster maintains the MongoDB versions. If value is `CONTINUOUS`, you must not specify **mongoDBMajorVersion**. + enum: + - LTS + - CONTINUOUS + type: string + type: object + AdvancedComputeAutoScaling: + description: Options that determine how this cluster handles CPU scaling. + properties: + enabled: + description: |- + Flag that indicates whether someone enabled instance size auto-scaling. + + - Set to `true` to enable instance size auto-scaling. If enabled, you must specify a value for **replicationSpecs[n].regionConfigs[m].autoScaling.compute.maxInstanceSize**. + - Set to `false` to disable instance size automatic scaling. + type: boolean + maxInstanceSize: + $ref: '#/components/schemas/BaseCloudProviderInstanceSize' + minInstanceSize: + $ref: '#/components/schemas/BaseCloudProviderInstanceSize' + scaleDownEnabled: + description: 'Flag that indicates whether the instance size may scale down. MongoDB Cloud requires this parameter if `"replicationSpecs[n].regionConfigs[m].autoScaling.compute.enabled" : true`. If you enable this option, specify a value for **replicationSpecs[n].regionConfigs[m].autoScaling.compute.minInstanceSize**.' + type: boolean + title: Automatic Compute Scaling Settings + type: object + ApiAtlasCloudProviderAccessFeatureUsageFeatureIdView: + description: Object that contains the identifying characteristics of the Amazon Web Services (AWS) Key Management Service (KMS). This field always returns a null value. + nullable: true + type: object + ApiAtlasDataLakeStorageView: + $ref: '#/components/schemas/DataLakeStorage' + ApiAtlasFTSAnalyzersViewManual: + description: Settings that describe one Atlas Search custom analyzer. + properties: + charFilters: + description: Filters that examine text one character at a time and perform filtering operations. + items: + oneOf: + - $ref: '#/components/schemas/charFilterhtmlStrip' + - $ref: '#/components/schemas/charFiltericuNormalize' + - $ref: '#/components/schemas/charFiltermapping' + - $ref: '#/components/schemas/charFilterpersian' + type: object + type: array + name: + description: |- + Human-readable name that identifies the custom analyzer. Names must be unique within an index, and must not start with any of the following strings: + - `lucene.` + - `builtin.` + - `mongodb.` + type: string + tokenFilters: + description: |- + Filter that performs operations such as: + + - Stemming, which reduces related words, such as "talking", "talked", and "talks" to their root word "talk". + + - Redaction, the removal of sensitive information from public documents. + items: + anyOf: + - $ref: '#/components/schemas/tokenFilterasciiFolding' + - $ref: '#/components/schemas/tokenFilterdaitchMokotoffSoundex' + - $ref: '#/components/schemas/tokenFilteredgeGram' + - $ref: '#/components/schemas/TokenFilterEnglishPossessive' + - $ref: '#/components/schemas/TokenFilterFlattenGraph' + - $ref: '#/components/schemas/tokenFiltericuFolding' + - $ref: '#/components/schemas/tokenFiltericuNormalizer' + - $ref: '#/components/schemas/TokenFilterkStemming' + - $ref: '#/components/schemas/tokenFilterlength' + - $ref: '#/components/schemas/tokenFilterlowercase' + - $ref: '#/components/schemas/tokenFilternGram' + - $ref: '#/components/schemas/TokenFilterPorterStemming' + - $ref: '#/components/schemas/tokenFilterregex' + - $ref: '#/components/schemas/tokenFilterreverse' + - $ref: '#/components/schemas/tokenFiltershingle' + - $ref: '#/components/schemas/tokenFiltersnowballStemming' + - $ref: '#/components/schemas/TokenFilterSpanishPluralStemming' + - $ref: '#/components/schemas/TokenFilterStempel' + - $ref: '#/components/schemas/tokenFilterstopword' + - $ref: '#/components/schemas/tokenFiltertrim' + - $ref: '#/components/schemas/TokenFilterWordDelimiterGraph' + type: array + tokenizer: + description: Tokenizer that you want to use to create tokens. Tokens determine how Atlas Search splits up text into discrete chunks for indexing. + discriminator: + mapping: + edgeGram: '#/components/schemas/tokenizeredgeGram' + keyword: '#/components/schemas/tokenizerkeyword' + nGram: '#/components/schemas/tokenizernGram' + regexCaptureGroup: '#/components/schemas/tokenizerregexCaptureGroup' + regexSplit: '#/components/schemas/tokenizerregexSplit' + standard: '#/components/schemas/tokenizerstandard' + uaxUrlEmail: '#/components/schemas/tokenizeruaxUrlEmail' + whitespace: '#/components/schemas/tokenizerwhitespace' + propertyName: type + oneOf: + - $ref: '#/components/schemas/tokenizeredgeGram' + - $ref: '#/components/schemas/tokenizerkeyword' + - $ref: '#/components/schemas/tokenizernGram' + - $ref: '#/components/schemas/tokenizerregexCaptureGroup' + - $ref: '#/components/schemas/tokenizerregexSplit' + - $ref: '#/components/schemas/tokenizerstandard' + - $ref: '#/components/schemas/tokenizeruaxUrlEmail' + - $ref: '#/components/schemas/tokenizerwhitespace' + type: object + required: + - name + - tokenizer + title: analyzers + type: object + ApiAtlasFTSMappingsViewManual: + description: Index specifications for the collection's fields. + properties: + dynamic: + default: false + description: Flag that indicates whether the index uses dynamic or static mappings. Required if **mappings.fields** is omitted. + externalDocs: + description: Dynamic or Static Mappings + url: https://dochub.mongodb.org/core/index-definitions-fts#field-mapping-examples + type: boolean + fields: + additionalProperties: + externalDocs: + description: Atlas Search Field Mappings + url: https://dochub.mongodb.org/core/field-mapping-definition-fts#define-field-mappings + type: object + description: One or more field specifications for the Atlas Search index. Required if **mappings.dynamic** is omitted or set to **false**. + externalDocs: + description: Atlas Search Index + url: https://dochub.mongodb.org/core/index-definitions-fts + type: object + title: mappings + type: object + ApiError: + properties: + badRequestDetail: + $ref: '#/components/schemas/BadRequestDetail' + detail: + description: Describes the specific conditions or reasons that cause each type of error. + type: string + error: + description: HTTP status code returned with this error. + externalDocs: + url: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status + format: int32 + readOnly: true + type: integer + errorCode: + description: Application error code returned with this error. + readOnly: true + type: string + parameters: + description: Parameters used to give more information about the error. + items: + readOnly: true + type: object + readOnly: true + type: array + reason: + description: Application error message returned with this error. + readOnly: true + type: string + required: + - error + - errorCode + type: object + AtlasSearchAnalyzer: + properties: + charFilters: + description: Filters that examine text one character at a time and perform filtering operations. + items: + $ref: '#/components/schemas/BasicDBObject' + type: array + name: + description: |- + Name that identifies the custom analyzer. Names must be unique within an index, and must not start with any of the following strings: + - `lucene.` + - `builtin.` + - `mongodb.` + type: string + tokenFilters: + description: |- + Filter that performs operations such as: + + - Stemming, which reduces related words, such as "talking", "talked", and "talks" to their root word "talk". + + - Redaction, which is the removal of sensitive information from public documents. + items: + $ref: '#/components/schemas/BasicDBObject' + type: array + tokenizer: + additionalProperties: + description: Tokenizer that you want to use to create tokens. Tokens determine how Atlas Search splits up text into discrete chunks for indexing. + type: object + description: Tokenizer that you want to use to create tokens. Tokens determine how Atlas Search splits up text into discrete chunks for indexing. + type: object + required: + - name + - tokenizer + title: Atlas Search Analyzer + type: object + AzureCloudProviderContainer: + allOf: + - $ref: '#/components/schemas/CloudProviderContainer' + - properties: + atlasCidrBlock: + description: |- + IP addresses expressed in Classless Inter-Domain Routing (CIDR) notation that MongoDB Cloud uses for the network peering containers in your project. MongoDB Cloud assigns all of the project's clusters deployed to this cloud provider an IP address from this range. MongoDB Cloud locks this value if an M10 or greater cluster or a network peering connection exists in this project. + + These CIDR blocks must fall within the ranges reserved per RFC 1918. AWS and Azure further limit the block to between the `/24` and `/21` ranges. + + To modify the CIDR block, the target project cannot have: + + - Any M10 or greater clusters + - Any other VPC peering connections + + You can also create a new project and create a network peering connection to set the desired MongoDB Cloud network peering container CIDR block for that project. MongoDB Cloud limits the number of MongoDB nodes per network peering connection based on the CIDR block and the region selected for the project. + + **Example:** A project in an Amazon Web Services (AWS) region supporting three availability zones and an MongoDB CIDR network peering container block of limit of `/24` equals 27 three-node replica sets. + pattern: ^((([0-9]{1,3}\.){3}[0-9]{1,3})|(:{0,2}([0-9a-f]{1,4}:){0,7}[0-9a-f]{1,4}[:]{0,2}))((%2[fF]|/)[0-9]{1,3})+$ + type: string + azureSubscriptionId: + description: Unique string that identifies the Azure subscription in which the MongoDB Cloud VNet resides. + example: 32b6e34b3d91647abb20e7b8 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + region: + description: Azure region to which MongoDB Cloud deployed this network peering container. + enum: + - US_CENTRAL + - US_EAST + - US_EAST_2 + - US_EAST_2_EUAP + - US_NORTH_CENTRAL + - US_WEST + - US_SOUTH_CENTRAL + - EUROPE_NORTH + - EUROPE_WEST + - US_WEST_CENTRAL + - US_WEST_2 + - US_WEST_3 + - CANADA_EAST + - CANADA_CENTRAL + - BRAZIL_SOUTH + - BRAZIL_SOUTHEAST + - AUSTRALIA_EAST + - AUSTRALIA_SOUTH_EAST + - AUSTRALIA_CENTRAL + - AUSTRALIA_CENTRAL_2 + - UAE_NORTH + - GERMANY_CENTRAL + - GERMANY_NORTH_EAST + - GERMANY_WEST_CENTRAL + - GERMANY_NORTH + - SWITZERLAND_NORTH + - SWITZERLAND_WEST + - SWEDEN_CENTRAL + - SWEDEN_SOUTH + - UK_SOUTH + - UK_WEST + - INDIA_CENTRAL + - INDIA_WEST + - INDIA_SOUTH + - CHINA_EAST + - CHINA_NORTH + - ASIA_EAST + - JAPAN_EAST + - JAPAN_WEST + - ASIA_SOUTH_EAST + - KOREA_CENTRAL + - KOREA_SOUTH + - FRANCE_CENTRAL + - FRANCE_SOUTH + - SOUTH_AFRICA_NORTH + - SOUTH_AFRICA_WEST + - NORWAY_EAST + - NORWAY_WEST + - UAE_CENTRAL + - QATAR_CENTRAL + - POLAND_CENTRAL + - ISRAEL_CENTRAL + - ITALY_NORTH + type: string + vnetName: + description: Unique string that identifies the Azure VNet in which MongoDB Cloud clusters in this network peering container exist. The response returns **null** if no clusters exist in this network peering container. + maxLength: 38 + minLength: 38 + pattern: ^([-\w._()])+$ + readOnly: true + type: string + type: object + description: Collection of settings that configures the network container for a virtual private connection on Amazon Web Services. + required: + - atlasCidrBlock + - region + title: AZURE + type: object + AzureCloudProviderSettings: + allOf: + - $ref: '#/components/schemas/ClusterProviderSettings' + - properties: + autoScaling: + $ref: '#/components/schemas/CloudProviderAzureAutoScaling' + diskTypeName: + description: Disk type that corresponds to the host's root volume for Azure instances. If omitted, the default disk type for the selected **providerSettings.instanceSizeName** applies. + enum: + - P2 + - P3 + - P4 + - P6 + - P10 + - P15 + - P20 + - P30 + - P40 + - P50 + externalDocs: + description: Disk type + url: https://docs.microsoft.com/en-us/azure/virtual-machines/premium-storage-performance#premium-storage-disk-sizes + type: string + instanceSizeName: + description: Cluster tier, with a default storage and memory capacity, that applies to all the data-bearing hosts in your cluster. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M90 + - M200 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - M60_NVME + - M80_NVME + - M200_NVME + - M300_NVME + - M400_NVME + - M600_NVME + title: Azure Instance Sizes + type: string + regionName: + description: Microsoft Azure Regions. + enum: + - US_CENTRAL + - US_EAST + - US_EAST_2 + - US_NORTH_CENTRAL + - US_WEST + - US_SOUTH_CENTRAL + - EUROPE_NORTH + - EUROPE_WEST + - US_WEST_CENTRAL + - US_WEST_2 + - US_WEST_3 + - CANADA_EAST + - CANADA_CENTRAL + - BRAZIL_SOUTH + - BRAZIL_SOUTHEAST + - AUSTRALIA_CENTRAL + - AUSTRALIA_CENTRAL_2 + - AUSTRALIA_EAST + - AUSTRALIA_SOUTH_EAST + - GERMANY_CENTRAL + - GERMANY_NORTH_EAST + - GERMANY_WEST_CENTRAL + - GERMANY_NORTH + - SWEDEN_CENTRAL + - SWEDEN_SOUTH + - SWITZERLAND_NORTH + - SWITZERLAND_WEST + - UK_SOUTH + - UK_WEST + - NORWAY_EAST + - NORWAY_WEST + - INDIA_CENTRAL + - INDIA_SOUTH + - INDIA_WEST + - CHINA_EAST + - CHINA_NORTH + - ASIA_EAST + - JAPAN_EAST + - JAPAN_WEST + - ASIA_SOUTH_EAST + - KOREA_CENTRAL + - KOREA_SOUTH + - FRANCE_CENTRAL + - FRANCE_SOUTH + - SOUTH_AFRICA_NORTH + - SOUTH_AFRICA_WEST + - UAE_CENTRAL + - UAE_NORTH + - QATAR_CENTRAL + externalDocs: + description: Azure + url: https://docs.atlas.mongodb.com/reference/microsoft-azure/ + title: Azure Regions + type: string + type: object + type: object + AzureComputeAutoScalingRules: + description: Collection of settings that configures how a cluster might scale its cluster tier and whether the cluster can scale down. Cluster tier auto-scaling is unavailable for clusters using Low CPU or NVME storage classes. + properties: + maxInstanceSize: + description: Maximum instance size to which your cluster can automatically scale. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M90 + - M200 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - M60_NVME + - M80_NVME + - M200_NVME + - M300_NVME + - M400_NVME + - M600_NVME + title: Azure Instance Sizes + type: string + minInstanceSize: + description: Minimum instance size to which your cluster can automatically scale. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M90 + - M200 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - M60_NVME + - M80_NVME + - M200_NVME + - M300_NVME + - M400_NVME + - M600_NVME + title: Azure Instance Sizes + type: string + title: Azure + type: object + AzureCreateDataProcessRegionView: + allOf: + - $ref: '#/components/schemas/CreateDataProcessRegionView' + - properties: + region: + description: Human-readable label that identifies the geographic location of the region where you wish to store your archived data. + enum: + - US_EAST_2 + - EUROPE_WEST + type: string + type: object + type: object + AzureDataProcessRegionView: + allOf: + - $ref: '#/components/schemas/DataProcessRegionView' + - properties: + region: + description: Human-readable label that identifies the geographic location of the region where you store your archived data. + enum: + - US_EAST_2 + - EUROPE_WEST + readOnly: true + type: string + type: object + type: object + AzureHardwareSpec: + properties: + diskIOPS: + description: |- + Target throughput desired for storage attached to your Azure-provisioned cluster. Change this parameter if you: + + - set `"replicationSpecs[n].regionConfigs[m].providerName" : "Azure"`. + - set `"replicationSpecs[n].regionConfigs[m].electableSpecs.instanceSize" : "M40"` or greater not including `Mxx_NVME` tiers. + + The maximum input/output operations per second (IOPS) depend on the selected **.instanceSize** and **.diskSizeGB**. + This parameter defaults to the cluster tier's standard IOPS value. + Changing this value impacts cluster cost. + externalDocs: + description: Programmatic API Keys + url: https://www.mongodb.com/docs/atlas/customize-storage/#extend-iops-on-azure + format: int32 + type: integer + instanceSize: + description: Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts of the node type. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M90 + - M200 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - M60_NVME + - M80_NVME + - M200_NVME + - M300_NVME + - M400_NVME + - M600_NVME + title: Azure Instance Sizes + type: string + nodeCount: + description: Number of nodes of the given type for MongoDB Cloud to deploy to the region. + format: int32 + type: integer + type: object + AzureHardwareSpec20240805: + properties: + diskIOPS: + description: |- + Target throughput desired for storage attached to your Azure-provisioned cluster. Change this parameter if you: + + - set `"replicationSpecs[n].regionConfigs[m].providerName" : "Azure"`. + - set `"replicationSpecs[n].regionConfigs[m].electableSpecs.instanceSize" : "M40"` or greater not including `Mxx_NVME` tiers. + + The maximum input/output operations per second (IOPS) depend on the selected **.instanceSize** and **.diskSizeGB**. + This parameter defaults to the cluster tier's standard IOPS value. + Changing this value impacts cluster cost. + externalDocs: + description: Programmatic API Keys + url: https://www.mongodb.com/docs/atlas/customize-storage/#extend-iops-on-azure + format: int32 + type: integer + diskSizeGB: + description: |- + Storage capacity of instance data volumes expressed in gigabytes. Increase this number to add capacity. + + This value must be equal for all shards and node types. + + This value is not configurable on M0/M2/M5 clusters. + + MongoDB Cloud requires this parameter if you set **replicationSpecs**. + + If you specify a disk size below the minimum (10 GB), this parameter defaults to the minimum disk size value. + + Storage charge calculations depend on whether you choose the default value or a custom value. + + The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require more storage space, consider upgrading your cluster to a higher tier. + format: double + maximum: 4096 + minimum: 10 + type: number + instanceSize: + description: Hardware specification for the instance sizes in this region in this shard. Each instance size has a default storage and memory capacity. Electable nodes and read-only nodes (known as "base nodes") within a single shard must use the same instance size. Analytics nodes can scale independently from base nodes within a shard. Both base nodes and analytics nodes can scale independently from their equivalents in other shards. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M90 + - M200 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - M60_NVME + - M80_NVME + - M200_NVME + - M300_NVME + - M400_NVME + - M600_NVME + title: Azure Instance Sizes + type: string + nodeCount: + description: Number of nodes of the given type for MongoDB Cloud to deploy to the region. + format: int32 + type: integer + type: object + AzureRegionConfig: + allOf: + - $ref: '#/components/schemas/CloudRegionConfig' + - properties: + analyticsAutoScaling: + $ref: '#/components/schemas/AdvancedAutoScalingSettings' + analyticsSpecs: + $ref: '#/components/schemas/DedicatedHardwareSpec' + autoScaling: + $ref: '#/components/schemas/AdvancedAutoScalingSettings' + readOnlySpecs: + $ref: '#/components/schemas/DedicatedHardwareSpec' + type: object + description: Details that explain how MongoDB Cloud replicates data in one region on the specified MongoDB database. + title: Azure Regional Replication Specifications + type: object + AzureRegionConfig20240805: + allOf: + - $ref: '#/components/schemas/CloudRegionConfig20240805' + - properties: + analyticsAutoScaling: + $ref: '#/components/schemas/AdvancedAutoScalingSettings' + analyticsSpecs: + $ref: '#/components/schemas/DedicatedHardwareSpec20240805' + autoScaling: + $ref: '#/components/schemas/AdvancedAutoScalingSettings' + readOnlySpecs: + $ref: '#/components/schemas/DedicatedHardwareSpec20240805' + type: object + description: Details that explain how MongoDB Cloud replicates data in one region on the specified MongoDB database. + title: Azure Regional Replication Specifications + type: object + BadRequestDetail: + description: Bad request detail. + properties: + fields: + description: Describes all violations in a client request. + items: + $ref: '#/components/schemas/FieldViolation' + type: array + readOnly: true + type: object + BaseCloudProviderInstanceSize: + description: 'Minimum instance size to which your cluster can automatically scale. MongoDB Cloud requires this parameter if `"replicationSpecs[n].regionConfigs[m].autoScaling.compute.scaleDownEnabled" : true`.' + oneOf: + - enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M100 + - M140 + - M200 + - M300 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - R700 + - M40_NVME + - M50_NVME + - M60_NVME + - M80_NVME + - M200_NVME + - M400_NVME + title: AWS Instance Sizes + type: string + - enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M90 + - M200 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - M60_NVME + - M80_NVME + - M200_NVME + - M300_NVME + - M400_NVME + - M600_NVME + title: Azure Instance Sizes + type: string + - enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M140 + - M200 + - M250 + - M300 + - M400 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - R600 + title: GCP Instance Sizes + type: string + type: object + BasicDBObject: + additionalProperties: + type: object + type: object + BiConnector: + description: Settings needed to configure the MongoDB Connector for Business Intelligence for this cluster. + externalDocs: + description: MongoDB Connector for Business Intelligence + url: https://docs.mongodb.com/bi-connector/current/ + properties: + enabled: + description: Flag that indicates whether MongoDB Connector for Business Intelligence is enabled on the specified cluster. + type: boolean + readPreference: + description: Data source node designated for the MongoDB Connector for Business Intelligence on MongoDB Cloud. The MongoDB Connector for Business Intelligence on MongoDB Cloud reads data from the primary, secondary, or analytics node based on your read preferences. Defaults to `ANALYTICS` node, or `SECONDARY` if there are no `ANALYTICS` nodes. + enum: + - PRIMARY + - SECONDARY + - ANALYTICS + externalDocs: + description: Read preferences for BI Connector + url: https://docs.atlas.mongodb.com/cluster-config/enable-bic/#std-label-bic-read-preferences + type: string + title: MongoDB Connector for Business Intelligence Settings + type: object + BillingInvoice: + properties: + amountBilledCents: + description: Sum of services that the specified organization consumed in the period covered in this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + amountPaidCents: + description: Sum that the specified organization paid toward this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + created: + description: Date and time when MongoDB Cloud created this invoice. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + creditsCents: + description: Sum that MongoDB credited the specified organization toward this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + endDate: + description: Date and time when MongoDB Cloud finished the billing period that this invoice covers. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + id: + description: Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + lineItems: + description: List that contains individual services included in this invoice. + items: + $ref: '#/components/schemas/InvoiceLineItem' + readOnly: true + type: array + linkedInvoices: + description: List that contains the invoices for organizations linked to the paying organization. + items: + $ref: '#/components/schemas/BillingInvoice' + readOnly: true + type: array + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + orgId: + description: Unique 24-hexadecimal digit string that identifies the organization charged for services consumed from MongoDB Cloud. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + payments: + description: List that contains funds transferred to MongoDB to cover the specified service noted in this invoice. + items: + $ref: '#/components/schemas/BillingPayment' + readOnly: true + type: array + refunds: + description: List that contains payments that MongoDB returned to the organization for this invoice. + items: + $ref: '#/components/schemas/BillingRefund' + readOnly: true + type: array + salesTaxCents: + description: Sum of sales tax applied to this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + startDate: + description: Date and time when MongoDB Cloud began the billing period that this invoice covers. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + startingBalanceCents: + description: Sum that the specified organization owed to MongoDB when MongoDB issued this invoice. This parameter expresses its value in US Dollars. + format: int64 + readOnly: true + type: integer + statusName: + description: | + Phase of payment processing in which this invoice exists when you made this request. Accepted phases include: + + | Phase Value | Reason | + |---|---| + | CLOSED | MongoDB finalized all charges in the billing cycle but has yet to charge the customer. | + | FAILED | MongoDB attempted to charge the provided credit card but charge for that amount failed. | + | FORGIVEN | Customer initiated payment which MongoDB later forgave. | + | FREE | All charges totalled zero so the customer won't be charged. | + | INVOICED | MongoDB handled these charges using elastic invoicing. | + | PAID | MongoDB succeeded in charging the provided credit card. | + | PENDING | Invoice includes charges for the current billing cycle. | + | PREPAID | Customer has a pre-paid plan so they won't be charged. | + enum: + - PENDING + - CLOSED + - FORGIVEN + - FAILED + - PAID + - FREE + - PREPAID + - INVOICED + type: string + subtotalCents: + description: Sum of all positive invoice line items contained in this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + updated: + description: Date and time when MongoDB Cloud last updated the value of this payment. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + type: object + BillingInvoiceMetadata: + properties: + amountBilledCents: + description: Sum of services that the specified organization consumed in the period covered in this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + amountPaidCents: + description: Sum that the specified organization paid toward this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + created: + description: Date and time when MongoDB Cloud created this invoice. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + creditsCents: + description: Sum that MongoDB credited the specified organization toward this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + endDate: + description: Date and time when MongoDB Cloud finished the billing period that this invoice covers. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + id: + description: Unique 24-hexadecimal digit string that identifies the invoice submitted to the specified organization. Charges typically post the next day. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + linkedInvoices: + description: List that contains the invoices for organizations linked to the paying organization. + items: + $ref: '#/components/schemas/BillingInvoiceMetadata' + readOnly: true + type: array + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + orgId: + description: Unique 24-hexadecimal digit string that identifies the organization charged for services consumed from MongoDB Cloud. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + salesTaxCents: + description: Sum of sales tax applied to this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + startDate: + description: Date and time when MongoDB Cloud began the billing period that this invoice covers. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + startingBalanceCents: + description: Sum that the specified organization owed to MongoDB when MongoDB issued this invoice. This parameter expresses its value in US Dollars. + format: int64 + readOnly: true + type: integer + statusName: + description: | + Phase of payment processing in which this invoice exists when you made this request. Accepted phases include: + + | Phase Value | Reason | + |---|---| + | CLOSED | MongoDB finalized all charges in the billing cycle but has yet to charge the customer. | + | FAILED | MongoDB attempted to charge the provided credit card but charge for that amount failed. | + | FORGIVEN | Customer initiated payment which MongoDB later forgave. | + | FREE | All charges totalled zero so the customer won't be charged. | + | INVOICED | MongoDB handled these charges using elastic invoicing. | + | PAID | MongoDB succeeded in charging the provided credit card. | + | PENDING | Invoice includes charges for the current billing cycle. | + | PREPAID | Customer has a pre-paid plan so they won't be charged. | + enum: + - PENDING + - CLOSED + - FORGIVEN + - FAILED + - PAID + - FREE + - PREPAID + - INVOICED + type: string + subtotalCents: + description: Sum of all positive invoice line items contained in this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + updated: + description: Date and time when MongoDB Cloud last updated the value of this payment. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + type: object + BillingPayment: + description: Funds transferred to MongoDB to cover the specified service in this invoice. + properties: + amountBilledCents: + description: Sum of services that the specified organization consumed in the period covered in this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + amountPaidCents: + description: Sum that the specified organization paid toward the associated invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + created: + description: Date and time when the customer made this payment attempt. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + currency: + description: The currency in which payment was paid. This parameter expresses its value in 3-letter ISO 4217 currency code. + readOnly: true + type: string + id: + description: Unique 24-hexadecimal digit string that identifies this payment toward the associated invoice. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + salesTaxCents: + description: Sum of sales tax applied to this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + statusName: + description: | + Phase of payment processing for the associated invoice when you made this request. + + These phases include: + + | Phase Value | Reason | + |---|---| + | `CANCELLED` | Customer or MongoDB cancelled the payment. | + | `ERROR` | Issue arose when attempting to complete payment. | + | `FAILED` | MongoDB tried to charge the credit card without success. | + | `FAILED_AUTHENTICATION` | Strong Customer Authentication has failed. Confirm that your payment method is authenticated. | + | `FORGIVEN` | Customer initiated payment which MongoDB later forgave. | + | `INVOICED` | MongoDB issued an invoice that included this line item. | + | `NEW` | Customer provided a method of payment, but MongoDB hasn't tried to charge the credit card. | + | `PAID` | Customer submitted a successful payment. | + | `PARTIAL_PAID` | Customer paid for part of this line item. | + enum: + - NEW + - FORGIVEN + - FAILED + - PAID + - PARTIAL_PAID + - CANCELLED + - INVOICED + - ERROR + - FAILED_AUTHENTICATION + - PROCESSING + - PENDING_REVERSAL + - REFUNDED + type: string + subtotalCents: + description: Sum of all positive invoice line items contained in this invoice. This parameter expresses its value in cents (100ths of one US Dollar). + format: int64 + readOnly: true + type: integer + unitPrice: + description: The unit price applied to amountBilledCents to compute total payment amount. This value is represented as a decimal string. + readOnly: true + type: string + updated: + description: Date and time when the customer made an update to this payment attempt. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + title: Payment + type: object + BillingRefund: + description: One payment that MongoDB returned to the organization for this invoice. + properties: + amountCents: + description: Sum of the funds returned to the specified organization expressed in cents (100th of US Dollar). + format: int64 + readOnly: true + type: integer + created: + description: Date and time when MongoDB Cloud created this refund. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + paymentId: + description: Unique 24-hexadecimal digit string that identifies the payment that the organization had made. + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + reason: + description: Justification that MongoDB accepted to return funds to the organization. + readOnly: true + type: string + title: Refund + type: object + CloudGCPProviderSettings: + allOf: + - $ref: '#/components/schemas/ClusterProviderSettings' + - properties: + autoScaling: + $ref: '#/components/schemas/CloudProviderGCPAutoScaling' + instanceSizeName: + description: Cluster tier, with a default storage and memory capacity, that applies to all the data-bearing hosts in your cluster. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M140 + - M200 + - M250 + - M300 + - M400 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - R600 + title: GCP Instance Sizes + type: string + regionName: + description: Google Compute Regions. + enum: + - EASTERN_US + - EASTERN_US_AW + - US_EAST_4 + - US_EAST_4_AW + - US_EAST_5 + - US_EAST_5_AW + - US_WEST_2 + - US_WEST_2_AW + - US_WEST_3 + - US_WEST_3_AW + - US_WEST_4 + - US_WEST_4_AW + - US_SOUTH_1 + - US_SOUTH_1_AW + - CENTRAL_US + - CENTRAL_US_AW + - WESTERN_US + - WESTERN_US_AW + - NORTH_AMERICA_NORTHEAST_1 + - NORTH_AMERICA_NORTHEAST_2 + - SOUTH_AMERICA_EAST_1 + - SOUTH_AMERICA_WEST_1 + - WESTERN_EUROPE + - EUROPE_NORTH_1 + - EUROPE_WEST_2 + - EUROPE_WEST_3 + - EUROPE_WEST_4 + - EUROPE_WEST_6 + - EUROPE_WEST_8 + - EUROPE_WEST_9 + - EUROPE_WEST_10 + - EUROPE_WEST_12 + - EUROPE_SOUTHWEST_1 + - EUROPE_CENTRAL_2 + - MIDDLE_EAST_CENTRAL_1 + - MIDDLE_EAST_CENTRAL_2 + - MIDDLE_EAST_WEST_1 + - AUSTRALIA_SOUTHEAST_1 + - AUSTRALIA_SOUTHEAST_2 + - EASTERN_ASIA_PACIFIC + - NORTHEASTERN_ASIA_PACIFIC + - SOUTHEASTERN_ASIA_PACIFIC + - ASIA_EAST_2 + - ASIA_NORTHEAST_2 + - ASIA_NORTHEAST_3 + - ASIA_SOUTH_1 + - ASIA_SOUTH_2 + - ASIA_SOUTHEAST_2 + externalDocs: + description: GCP + url: https://docs.atlas.mongodb.com/reference/google-gcp/ + title: GCP Regions + type: string + type: object + type: object + CloudProviderAWSAutoScaling: + description: Range of instance sizes to which your cluster can scale. + properties: + compute: + $ref: '#/components/schemas/AWSComputeAutoScaling' + type: object + CloudProviderAccessAWSIAMRole: + allOf: + - $ref: '#/components/schemas/CloudProviderAccessRole' + - properties: + atlasAWSAccountArn: + description: Amazon Resource Name that identifies the Amazon Web Services (AWS) user account that MongoDB Cloud uses when it assumes the Identity and Access Management (IAM) role. + example: arn:aws:iam::772401394250:role/my-test-aws-role + maxLength: 2048 + minLength: 20 + readOnly: true + type: string + atlasAssumedRoleExternalId: + description: Unique external ID that MongoDB Cloud uses when it assumes the IAM role in your Amazon Web Services (AWS) account. + format: uuid + readOnly: true + type: string + authorizedDate: + description: Date and time when someone authorized this role for the specified cloud service provider. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + createdDate: + description: Date and time when someone created this role for the specified cloud service provider. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + featureUsages: + description: List that contains application features associated with this Amazon Web Services (AWS) Identity and Access Management (IAM) role. + items: + $ref: '#/components/schemas/CloudProviderAccessFeatureUsage' + readOnly: true + type: array + iamAssumedRoleArn: + description: Amazon Resource Name (ARN) that identifies the Amazon Web Services (AWS) Identity and Access Management (IAM) role that MongoDB Cloud assumes when it accesses resources in your AWS account. + example: arn:aws:iam::123456789012:root + maxLength: 2048 + minLength: 20 + type: string + roleId: + description: Unique 24-hexadecimal digit string that identifies the role. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + type: object + description: Details that describe the features linked to the Amazon Web Services (AWS) Identity and Access Management (IAM) role. + required: + - providerName + type: object + CloudProviderAccessAWSIAMRoleRequestUpdate: + allOf: + - $ref: '#/components/schemas/CloudProviderAccessRoleRequestUpdate' + - properties: + atlasAWSAccountArn: + description: Amazon Resource Name that identifies the Amazon Web Services (AWS) user account that MongoDB Cloud uses when it assumes the Identity and Access Management (IAM) role. + example: arn:aws:iam::772401394250:role/my-test-aws-role + maxLength: 2048 + minLength: 20 + readOnly: true + type: string + atlasAssumedRoleExternalId: + description: Unique external ID that MongoDB Cloud uses when it assumes the IAM role in your Amazon Web Services (AWS) account. + format: uuid + readOnly: true + type: string + authorizedDate: + description: Date and time when someone authorized this role for the specified cloud service provider. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + createdDate: + description: Date and time when someone created this role for the specified cloud service provider. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + featureUsages: + description: List that contains application features associated with this Amazon Web Services (AWS) Identity and Access Management (IAM) role. + items: + $ref: '#/components/schemas/CloudProviderAccessFeatureUsage' + readOnly: true + type: array + iamAssumedRoleArn: + description: Amazon Resource Name (ARN) that identifies the Amazon Web Services (AWS) Identity and Access Management (IAM) role that MongoDB Cloud assumes when it accesses resources in your AWS account. + example: arn:aws:iam::123456789012:root + maxLength: 2048 + minLength: 20 + type: string + roleId: + description: Unique 24-hexadecimal digit string that identifies the role. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + type: object + description: Details that describe the features linked to the Amazon Web Services (AWS) Identity and Access Management (IAM) role. + required: + - providerName + type: object + CloudProviderAccessAzureServicePrincipal: + allOf: + - $ref: '#/components/schemas/CloudProviderAccessRole' + - properties: + _id: + description: Unique 24-hexadecimal digit string that identifies the role. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + atlasAzureAppId: + description: Azure Active Directory Application ID of Atlas. + maxLength: 36 + minLength: 32 + pattern: ^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$ + type: string + createdDate: + description: Date and time when this Azure Service Principal was created. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + featureUsages: + description: List that contains application features associated with this Azure Service Principal. + items: + $ref: '#/components/schemas/CloudProviderAccessFeatureUsage' + readOnly: true + type: array + lastUpdatedDate: + description: Date and time when this Azure Service Principal was last updated. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + servicePrincipalId: + description: UUID string that identifies the Azure Service Principal. + maxLength: 36 + minLength: 32 + pattern: ^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$ + type: string + tenantId: + description: UUID String that identifies the Azure Active Directory Tenant ID. + maxLength: 36 + minLength: 32 + pattern: ^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$ + type: string + type: object + description: Details that describe the features linked to the Azure Service Principal. + required: + - providerName + type: object + CloudProviderAccessAzureServicePrincipalRequestUpdate: + allOf: + - $ref: '#/components/schemas/CloudProviderAccessRoleRequestUpdate' + - properties: + _id: + description: Unique 24-hexadecimal digit string that identifies the role. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + atlasAzureAppId: + description: Azure Active Directory Application ID of Atlas. + maxLength: 36 + minLength: 32 + pattern: ^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$ + type: string + createdDate: + description: Date and time when this Azure Service Principal was created. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + featureUsages: + description: List that contains application features associated with this Azure Service Principal. + items: + $ref: '#/components/schemas/CloudProviderAccessFeatureUsage' + readOnly: true + type: array + lastUpdatedDate: + description: Date and time when this Azure Service Principal was last updated. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + servicePrincipalId: + description: UUID string that identifies the Azure Service Principal. + maxLength: 36 + minLength: 32 + pattern: ^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$ + type: string + tenantId: + description: UUID String that identifies the Azure Active Directory Tenant ID. + maxLength: 36 + minLength: 32 + pattern: ^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$ + type: string + type: object + description: Details that describe the features linked to the Azure Service Principal. + required: + - providerName + type: object + CloudProviderAccessDataLakeFeatureUsage: + allOf: + - $ref: '#/components/schemas/CloudProviderAccessFeatureUsage' + - properties: + featureId: + $ref: '#/components/schemas/CloudProviderAccessFeatureUsageDataLakeFeatureId' + type: object + description: Details that describe the Atlas Data Lakes linked to this Amazon Web Services (AWS) Identity and Access Management (IAM) role. + type: object + CloudProviderAccessEncryptionAtRestFeatureUsage: + allOf: + - $ref: '#/components/schemas/CloudProviderAccessFeatureUsage' + - properties: + featureId: + $ref: '#/components/schemas/ApiAtlasCloudProviderAccessFeatureUsageFeatureIdView' + type: object + description: Details that describe the Key Management Service (KMS) linked to this Amazon Web Services (AWS) Identity and Access Management (IAM) role. + type: object + CloudProviderAccessExportSnapshotFeatureUsage: + allOf: + - $ref: '#/components/schemas/CloudProviderAccessFeatureUsage' + - properties: + featureId: + $ref: '#/components/schemas/CloudProviderAccessFeatureUsageExportSnapshotFeatureId' + type: object + description: Details that describe the Amazon Web Services (AWS) Simple Storage Service (S3) export buckets linked to this AWS Identity and Access Management (IAM) role. + type: object + CloudProviderAccessFeatureUsage: + description: MongoDB Cloud features associated with this Amazon Web Services (AWS) Identity and Access Management (IAM) role. + discriminator: + mapping: + ATLAS_DATA_LAKE: '#/components/schemas/CloudProviderAccessDataLakeFeatureUsage' + ENCRYPTION_AT_REST: '#/components/schemas/CloudProviderAccessEncryptionAtRestFeatureUsage' + EXPORT_SNAPSHOT: '#/components/schemas/CloudProviderAccessExportSnapshotFeatureUsage' + PUSH_BASED_LOG_EXPORT: '#/components/schemas/CloudProviderAccessPushBasedLogExportFeatureUsage' + propertyName: featureType + properties: + featureType: + description: Human-readable label that describes one MongoDB Cloud feature linked to this Amazon Web Services (AWS) Identity and Access Management (IAM) role. + enum: + - ATLAS_DATA_LAKE + - ENCRYPTION_AT_REST + - EXPORT_SNAPSHOT + - PUSH_BASED_LOG_EXPORT + readOnly: true + type: string + type: object + CloudProviderAccessFeatureUsageDataLakeFeatureId: + description: Identifying characteristics about the data lake linked to this Amazon Web Services (AWS) Identity and Access Management (IAM) role. + properties: + groupId: + description: Unique 24-hexadecimal digit string that identifies your project. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + name: + description: Human-readable label that identifies the data lake. + type: string + type: object + CloudProviderAccessFeatureUsageExportSnapshotFeatureId: + description: Identifying characteristics about the Amazon Web Services (AWS) Simple Storage Service (S3) export bucket linked to this AWS Identity and Access Management (IAM) role. + properties: + exportBucketId: + description: Unique 24-hexadecimal digit string that identifies the AWS S3 bucket to which you export your snapshots. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + groupId: + description: Unique 24-hexadecimal digit string that identifies your project. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + type: object + CloudProviderAccessFeatureUsagePushBasedLogExportFeatureId: + description: Identifying characteristics about the Amazon Web Services (AWS) Simple Storage Service (S3) export bucket linked to this AWS Identity and Access Management (IAM) role. + properties: + bucketName: + description: Name of the AWS S3 bucket to which your logs will be exported to. + readOnly: true + type: string + groupId: + description: Unique 24-hexadecimal digit string that identifies your project. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + type: object + CloudProviderAccessGCPServiceAccount: + allOf: + - $ref: '#/components/schemas/CloudProviderAccessRole' + - properties: + createdDate: + description: Date and time when this Google Service Account was created. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + featureUsages: + description: List that contains application features associated with this Google Service Account. + items: + $ref: '#/components/schemas/CloudProviderAccessFeatureUsage' + readOnly: true + type: array + gcpServiceAccountForAtlas: + description: Email address for the Google Service Account created by Atlas. + maxLength: 82 + minLength: 57 + pattern: ^mongodb-atlas-[0-9a-z]{16}@p-[0-9a-z]{24}.iam.gserviceaccount.com$ + type: string + roleId: + description: Unique 24-hexadecimal digit string that identifies the role. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + type: object + description: Details that describe the features linked to the GCP Service Account. + required: + - providerName + type: object + CloudProviderAccessGCPServiceAccountRequestUpdate: + allOf: + - $ref: '#/components/schemas/CloudProviderAccessRoleRequestUpdate' + description: Details that describe the features linked to the GCP Service Account. + required: + - providerName + type: object + CloudProviderAccessPushBasedLogExportFeatureUsage: + allOf: + - $ref: '#/components/schemas/CloudProviderAccessFeatureUsage' + - properties: + featureId: + $ref: '#/components/schemas/CloudProviderAccessFeatureUsagePushBasedLogExportFeatureId' + type: object + description: Details that describe the Amazon Web Services (AWS) Simple Storage Service (S3) export buckets linked to this AWS Identity and Access Management (IAM) role. + type: object + CloudProviderAccessRole: + description: Cloud provider access role. + discriminator: + mapping: + AWS: '#/components/schemas/CloudProviderAccessAWSIAMRole' + AZURE: '#/components/schemas/CloudProviderAccessAzureServicePrincipal' + GCP: '#/components/schemas/CloudProviderAccessGCPServiceAccount' + propertyName: providerName + properties: + providerName: + description: Human-readable label that identifies the cloud provider of the role. + enum: + - AWS + - AZURE + - GCP + type: string + required: + - providerName + type: object + CloudProviderAccessRoleRequestUpdate: + description: Cloud provider access role. + discriminator: + mapping: + AWS: '#/components/schemas/CloudProviderAccessAWSIAMRoleRequestUpdate' + AZURE: '#/components/schemas/CloudProviderAccessAzureServicePrincipalRequestUpdate' + GCP: '#/components/schemas/CloudProviderAccessGCPServiceAccountRequestUpdate' + propertyName: providerName + properties: + providerName: + description: Human-readable label that identifies the cloud provider of the role. + enum: + - AWS + - AZURE + - GCP + type: string + required: + - providerName + type: object + CloudProviderAzureAutoScaling: + description: Range of instance sizes to which your cluster can scale. + properties: + compute: + $ref: '#/components/schemas/AzureComputeAutoScalingRules' + type: object + CloudProviderContainer: + description: Collection of settings that configures the network container for a virtual private connection on Amazon Web Services. + discriminator: + mapping: + AWS: '#/components/schemas/AWSCloudProviderContainer' + AZURE: '#/components/schemas/AzureCloudProviderContainer' + GCP: '#/components/schemas/GCPCloudProviderContainer' + propertyName: providerName + oneOf: + - $ref: '#/components/schemas/AzureCloudProviderContainer' + - $ref: '#/components/schemas/GCPCloudProviderContainer' + - $ref: '#/components/schemas/AWSCloudProviderContainer' + properties: + id: + description: Unique 24-hexadecimal digit string that identifies the network peering container. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + providerName: + description: Cloud service provider that serves the requested network peering containers. + enum: + - AWS + - GCP + - AZURE + - TENANT + - SERVERLESS + type: string + provisioned: + description: Flag that indicates whether MongoDB Cloud clusters exist in the specified network peering container. + readOnly: true + type: boolean + type: object + CloudProviderGCPAutoScaling: + description: Range of instance sizes to which your cluster can scale. + properties: + compute: + $ref: '#/components/schemas/GCPComputeAutoScaling' + type: object + CloudRegionConfig: + description: Cloud service provider on which MongoDB Cloud provisions the hosts. + discriminator: + mapping: + AWS: '#/components/schemas/AWSRegionConfig' + AZURE: '#/components/schemas/AzureRegionConfig' + GCP: '#/components/schemas/GCPRegionConfig' + TENANT: '#/components/schemas/TenantRegionConfig' + propertyName: providerName + oneOf: + - $ref: '#/components/schemas/AWSRegionConfig' + - $ref: '#/components/schemas/AzureRegionConfig' + - $ref: '#/components/schemas/GCPRegionConfig' + - $ref: '#/components/schemas/TenantRegionConfig' + properties: + electableSpecs: + $ref: '#/components/schemas/HardwareSpec' + priority: + description: |- + Precedence is given to this region when a primary election occurs. If your **regionConfigs** has only **readOnlySpecs**, **analyticsSpecs**, or both, set this value to `0`. If you have multiple **regionConfigs** objects (your cluster is multi-region or multi-cloud), they must have priorities in descending order. The highest priority is `7`. + + **Example:** If you have three regions, their priorities would be `7`, `6`, and `5` respectively. If you added two more regions for supporting electable nodes, the priorities of those regions would be `4` and `3` respectively. + format: int32 + maximum: 7 + minimum: 0 + type: integer + providerName: + description: Cloud service provider on which MongoDB Cloud provisions the hosts. Set dedicated clusters to `AWS`, `GCP`, `AZURE` or `TENANT`. + enum: + - AWS + - AZURE + - GCP + - TENANT + type: string + regionName: + description: Physical location of your MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. The region name is only returned in the response for single-region clusters. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. It assigns the VPC a Classless Inter-Domain Routing (CIDR) block. To limit a new VPC peering connection to one Classless Inter-Domain Routing (CIDR) block and region, create the connection first. Deploy the cluster after the connection starts. GCP Clusters and Multi-region clusters require one VPC peering connection for each region. MongoDB nodes can use only the peering connection that resides in the same region as the nodes to communicate with the peered VPC. + oneOf: + - description: Physical location where MongoDB Cloud deploys your AWS-hosted MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. MongoDB Cloud assigns the VPC a CIDR block. To limit a new VPC peering connection to one CIDR block and region, create the connection first. Deploy the cluster after the connection starts. + enum: + - US_GOV_WEST_1 + - US_GOV_EAST_1 + - US_EAST_1 + - US_EAST_2 + - US_WEST_1 + - US_WEST_2 + - CA_CENTRAL_1 + - EU_NORTH_1 + - EU_WEST_1 + - EU_WEST_2 + - EU_WEST_3 + - EU_CENTRAL_1 + - EU_CENTRAL_2 + - AP_EAST_1 + - AP_NORTHEAST_1 + - AP_NORTHEAST_2 + - AP_NORTHEAST_3 + - AP_SOUTHEAST_1 + - AP_SOUTHEAST_2 + - AP_SOUTHEAST_3 + - AP_SOUTHEAST_4 + - AP_SOUTH_1 + - AP_SOUTH_2 + - SA_EAST_1 + - CN_NORTH_1 + - CN_NORTHWEST_1 + - ME_SOUTH_1 + - ME_CENTRAL_1 + - AF_SOUTH_1 + - EU_SOUTH_1 + - EU_SOUTH_2 + - IL_CENTRAL_1 + - CA_WEST_1 + - GLOBAL + title: AWS Regions + type: string + - description: Microsoft Azure Regions. + enum: + - US_CENTRAL + - US_EAST + - US_EAST_2 + - US_NORTH_CENTRAL + - US_WEST + - US_SOUTH_CENTRAL + - EUROPE_NORTH + - EUROPE_WEST + - US_WEST_CENTRAL + - US_WEST_2 + - US_WEST_3 + - CANADA_EAST + - CANADA_CENTRAL + - BRAZIL_SOUTH + - BRAZIL_SOUTHEAST + - AUSTRALIA_CENTRAL + - AUSTRALIA_CENTRAL_2 + - AUSTRALIA_EAST + - AUSTRALIA_SOUTH_EAST + - GERMANY_CENTRAL + - GERMANY_NORTH_EAST + - GERMANY_WEST_CENTRAL + - GERMANY_NORTH + - SWEDEN_CENTRAL + - SWEDEN_SOUTH + - SWITZERLAND_NORTH + - SWITZERLAND_WEST + - UK_SOUTH + - UK_WEST + - NORWAY_EAST + - NORWAY_WEST + - INDIA_CENTRAL + - INDIA_SOUTH + - INDIA_WEST + - CHINA_EAST + - CHINA_NORTH + - ASIA_EAST + - JAPAN_EAST + - JAPAN_WEST + - ASIA_SOUTH_EAST + - KOREA_CENTRAL + - KOREA_SOUTH + - FRANCE_CENTRAL + - FRANCE_SOUTH + - SOUTH_AFRICA_NORTH + - SOUTH_AFRICA_WEST + - UAE_CENTRAL + - UAE_NORTH + - QATAR_CENTRAL + title: Azure Regions + type: string + - description: Google Compute Regions. + enum: + - EASTERN_US + - EASTERN_US_AW + - US_EAST_4 + - US_EAST_4_AW + - US_EAST_5 + - US_EAST_5_AW + - US_WEST_2 + - US_WEST_2_AW + - US_WEST_3 + - US_WEST_3_AW + - US_WEST_4 + - US_WEST_4_AW + - US_SOUTH_1 + - US_SOUTH_1_AW + - CENTRAL_US + - CENTRAL_US_AW + - WESTERN_US + - WESTERN_US_AW + - NORTH_AMERICA_NORTHEAST_1 + - NORTH_AMERICA_NORTHEAST_2 + - SOUTH_AMERICA_EAST_1 + - SOUTH_AMERICA_WEST_1 + - WESTERN_EUROPE + - EUROPE_NORTH_1 + - EUROPE_WEST_2 + - EUROPE_WEST_3 + - EUROPE_WEST_4 + - EUROPE_WEST_6 + - EUROPE_WEST_8 + - EUROPE_WEST_9 + - EUROPE_WEST_10 + - EUROPE_WEST_12 + - EUROPE_SOUTHWEST_1 + - EUROPE_CENTRAL_2 + - MIDDLE_EAST_CENTRAL_1 + - MIDDLE_EAST_CENTRAL_2 + - MIDDLE_EAST_WEST_1 + - AUSTRALIA_SOUTHEAST_1 + - AUSTRALIA_SOUTHEAST_2 + - EASTERN_ASIA_PACIFIC + - NORTHEASTERN_ASIA_PACIFIC + - SOUTHEASTERN_ASIA_PACIFIC + - ASIA_EAST_2 + - ASIA_NORTHEAST_2 + - ASIA_NORTHEAST_3 + - ASIA_SOUTH_1 + - ASIA_SOUTH_2 + - ASIA_SOUTHEAST_2 + title: GCP Regions + type: string + type: object + title: Cloud Service Provider Settings for Multi-Cloud Clusters + type: object + CloudRegionConfig20240805: + description: Cloud service provider on which MongoDB Cloud provisions the hosts. + discriminator: + mapping: + AWS: '#/components/schemas/AWSRegionConfig20240805' + AZURE: '#/components/schemas/AzureRegionConfig20240805' + GCP: '#/components/schemas/GCPRegionConfig20240805' + TENANT: '#/components/schemas/TenantRegionConfig20240805' + propertyName: providerName + oneOf: + - $ref: '#/components/schemas/AWSRegionConfig20240805' + - $ref: '#/components/schemas/AzureRegionConfig20240805' + - $ref: '#/components/schemas/GCPRegionConfig20240805' + - $ref: '#/components/schemas/TenantRegionConfig20240805' + properties: + electableSpecs: + $ref: '#/components/schemas/HardwareSpec20240805' + priority: + description: |- + Precedence is given to this region when a primary election occurs. If your **regionConfigs** has only **readOnlySpecs**, **analyticsSpecs**, or both, set this value to `0`. If you have multiple **regionConfigs** objects (your cluster is multi-region or multi-cloud), they must have priorities in descending order. The highest priority is `7`. + + **Example:** If you have three regions, their priorities would be `7`, `6`, and `5` respectively. If you added two more regions for supporting electable nodes, the priorities of those regions would be `4` and `3` respectively. + format: int32 + maximum: 7 + minimum: 0 + type: integer + providerName: + description: Cloud service provider on which MongoDB Cloud provisions the hosts. Set dedicated clusters to `AWS`, `GCP`, `AZURE` or `TENANT`. + enum: + - AWS + - AZURE + - GCP + - TENANT + type: string + regionName: + description: Physical location of your MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. The region name is only returned in the response for single-region clusters. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. It assigns the VPC a Classless Inter-Domain Routing (CIDR) block. To limit a new VPC peering connection to one Classless Inter-Domain Routing (CIDR) block and region, create the connection first. Deploy the cluster after the connection starts. GCP Clusters and Multi-region clusters require one VPC peering connection for each region. MongoDB nodes can use only the peering connection that resides in the same region as the nodes to communicate with the peered VPC. + oneOf: + - description: Physical location where MongoDB Cloud deploys your AWS-hosted MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. MongoDB Cloud assigns the VPC a CIDR block. To limit a new VPC peering connection to one CIDR block and region, create the connection first. Deploy the cluster after the connection starts. + enum: + - US_GOV_WEST_1 + - US_GOV_EAST_1 + - US_EAST_1 + - US_EAST_2 + - US_WEST_1 + - US_WEST_2 + - CA_CENTRAL_1 + - EU_NORTH_1 + - EU_WEST_1 + - EU_WEST_2 + - EU_WEST_3 + - EU_CENTRAL_1 + - EU_CENTRAL_2 + - AP_EAST_1 + - AP_NORTHEAST_1 + - AP_NORTHEAST_2 + - AP_NORTHEAST_3 + - AP_SOUTHEAST_1 + - AP_SOUTHEAST_2 + - AP_SOUTHEAST_3 + - AP_SOUTHEAST_4 + - AP_SOUTH_1 + - AP_SOUTH_2 + - SA_EAST_1 + - CN_NORTH_1 + - CN_NORTHWEST_1 + - ME_SOUTH_1 + - ME_CENTRAL_1 + - AF_SOUTH_1 + - EU_SOUTH_1 + - EU_SOUTH_2 + - IL_CENTRAL_1 + - CA_WEST_1 + - GLOBAL + title: AWS Regions + type: string + - description: Microsoft Azure Regions. + enum: + - US_CENTRAL + - US_EAST + - US_EAST_2 + - US_NORTH_CENTRAL + - US_WEST + - US_SOUTH_CENTRAL + - EUROPE_NORTH + - EUROPE_WEST + - US_WEST_CENTRAL + - US_WEST_2 + - US_WEST_3 + - CANADA_EAST + - CANADA_CENTRAL + - BRAZIL_SOUTH + - BRAZIL_SOUTHEAST + - AUSTRALIA_CENTRAL + - AUSTRALIA_CENTRAL_2 + - AUSTRALIA_EAST + - AUSTRALIA_SOUTH_EAST + - GERMANY_CENTRAL + - GERMANY_NORTH_EAST + - GERMANY_WEST_CENTRAL + - GERMANY_NORTH + - SWEDEN_CENTRAL + - SWEDEN_SOUTH + - SWITZERLAND_NORTH + - SWITZERLAND_WEST + - UK_SOUTH + - UK_WEST + - NORWAY_EAST + - NORWAY_WEST + - INDIA_CENTRAL + - INDIA_SOUTH + - INDIA_WEST + - CHINA_EAST + - CHINA_NORTH + - ASIA_EAST + - JAPAN_EAST + - JAPAN_WEST + - ASIA_SOUTH_EAST + - KOREA_CENTRAL + - KOREA_SOUTH + - FRANCE_CENTRAL + - FRANCE_SOUTH + - SOUTH_AFRICA_NORTH + - SOUTH_AFRICA_WEST + - UAE_CENTRAL + - UAE_NORTH + - QATAR_CENTRAL + title: Azure Regions + type: string + - description: Google Compute Regions. + enum: + - EASTERN_US + - EASTERN_US_AW + - US_EAST_4 + - US_EAST_4_AW + - US_EAST_5 + - US_EAST_5_AW + - US_WEST_2 + - US_WEST_2_AW + - US_WEST_3 + - US_WEST_3_AW + - US_WEST_4 + - US_WEST_4_AW + - US_SOUTH_1 + - US_SOUTH_1_AW + - CENTRAL_US + - CENTRAL_US_AW + - WESTERN_US + - WESTERN_US_AW + - NORTH_AMERICA_NORTHEAST_1 + - NORTH_AMERICA_NORTHEAST_2 + - SOUTH_AMERICA_EAST_1 + - SOUTH_AMERICA_WEST_1 + - WESTERN_EUROPE + - EUROPE_NORTH_1 + - EUROPE_WEST_2 + - EUROPE_WEST_3 + - EUROPE_WEST_4 + - EUROPE_WEST_6 + - EUROPE_WEST_8 + - EUROPE_WEST_9 + - EUROPE_WEST_10 + - EUROPE_WEST_12 + - EUROPE_SOUTHWEST_1 + - EUROPE_CENTRAL_2 + - MIDDLE_EAST_CENTRAL_1 + - MIDDLE_EAST_CENTRAL_2 + - MIDDLE_EAST_WEST_1 + - AUSTRALIA_SOUTHEAST_1 + - AUSTRALIA_SOUTHEAST_2 + - EASTERN_ASIA_PACIFIC + - NORTHEASTERN_ASIA_PACIFIC + - SOUTHEASTERN_ASIA_PACIFIC + - ASIA_EAST_2 + - ASIA_NORTHEAST_2 + - ASIA_NORTHEAST_3 + - ASIA_SOUTH_1 + - ASIA_SOUTH_2 + - ASIA_SOUTHEAST_2 + title: GCP Regions + type: string + type: object + title: Cloud Service Provider Settings + type: object + ClusterAutoScalingSettings: + description: Range of instance sizes to which your cluster can scale. + externalDocs: + description: Cluster Auto-Scaling + url: https://docs.atlas.mongodb.com/cluster-autoscaling/ + properties: + compute: + $ref: '#/components/schemas/ClusterComputeAutoScaling' + diskGBEnabled: + default: false + description: Flag that indicates whether someone enabled disk auto-scaling for this cluster. + type: boolean + title: Automatic Cluster Scaling Settings + type: object + ClusterComputeAutoScaling: + description: Collection of settings that configures how a cluster might scale its cluster tier and whether the cluster can scale down. Cluster tier auto-scaling is unavailable for clusters using Low CPU or NVME storage classes. + properties: + enabled: + default: false + description: Flag that indicates whether cluster tier auto-scaling is enabled. Set to `true` to enable cluster tier auto-scaling. If enabled, you must specify a value for **providerSettings.autoScaling.compute.maxInstanceSize** also. Set to `false` to disable cluster tier auto-scaling. + type: boolean + scaleDownEnabled: + default: false + description: Flag that indicates whether the cluster tier can scale down. This is required if **autoScaling.compute.enabled** is `true`. If you enable this option, specify a value for **providerSettings.autoScaling.compute.minInstanceSize**. + type: boolean + type: object + ClusterConnectionStrings: + description: Collection of Uniform Resource Locators that point to the MongoDB database. + externalDocs: + description: Connection string URI format. + url: https://docs.mongodb.com/manual/reference/connection-string/ + properties: + awsPrivateLink: + additionalProperties: + description: Private endpoint-aware connection strings that use AWS-hosted clusters with Amazon Web Services (AWS) PrivateLink. Each key identifies an Amazon Web Services (AWS) interface endpoint. Each value identifies the related `mongodb://` connection string that you use to connect to MongoDB Cloud through the interface endpoint that the key names. + externalDocs: + description: Network Peering Connection + url: https://docs.atlas.mongodb.com/security-vpc-peering/#std-label-vpc-peering/ + readOnly: true + type: string + description: Private endpoint-aware connection strings that use AWS-hosted clusters with Amazon Web Services (AWS) PrivateLink. Each key identifies an Amazon Web Services (AWS) interface endpoint. Each value identifies the related `mongodb://` connection string that you use to connect to MongoDB Cloud through the interface endpoint that the key names. + externalDocs: + description: Network Peering Connection + url: https://docs.atlas.mongodb.com/security-vpc-peering/#std-label-vpc-peering/ + readOnly: true + type: object + awsPrivateLinkSrv: + additionalProperties: + description: Private endpoint-aware connection strings that use AWS-hosted clusters with Amazon Web Services (AWS) PrivateLink. Each key identifies an Amazon Web Services (AWS) interface endpoint. Each value identifies the related `mongodb://` connection string that you use to connect to Atlas through the interface endpoint that the key names. If the cluster uses an optimized connection string, `awsPrivateLinkSrv` contains the optimized connection string. If the cluster has the non-optimized (legacy) connection string, `awsPrivateLinkSrv` contains the non-optimized connection string even if an optimized connection string is also present. + externalDocs: + description: Network Peering Connection + url: https://docs.atlas.mongodb.com/security-vpc-peering/#std-label-vpc-peering/ + readOnly: true + type: string + description: Private endpoint-aware connection strings that use AWS-hosted clusters with Amazon Web Services (AWS) PrivateLink. Each key identifies an Amazon Web Services (AWS) interface endpoint. Each value identifies the related `mongodb://` connection string that you use to connect to Atlas through the interface endpoint that the key names. If the cluster uses an optimized connection string, `awsPrivateLinkSrv` contains the optimized connection string. If the cluster has the non-optimized (legacy) connection string, `awsPrivateLinkSrv` contains the non-optimized connection string even if an optimized connection string is also present. + externalDocs: + description: Network Peering Connection + url: https://docs.atlas.mongodb.com/security-vpc-peering/#std-label-vpc-peering/ + readOnly: true + type: object + private: + description: Network peering connection strings for each interface Virtual Private Cloud (VPC) endpoint that you configured to connect to this cluster. This connection string uses the `mongodb+srv://` protocol. The resource returns this parameter once someone creates a network peering connection to this cluster. This protocol tells the application to look up the host seed list in the Domain Name System (DNS). This list synchronizes with the nodes in a cluster. If the connection string uses this Uniform Resource Identifier (URI) format, you don't need to append the seed list or change the URI if the nodes change. Use this URI format if your driver supports it. If it doesn't, use connectionStrings.private. For Amazon Web Services (AWS) clusters, this resource returns this parameter only if you enable custom DNS. + externalDocs: + description: Network Peering Connection + url: https://docs.atlas.mongodb.com/security-vpc-peering/#std-label-vpc-peering/ + readOnly: true + type: string + privateEndpoint: + description: List of private endpoint-aware connection strings that you can use to connect to this cluster through a private endpoint. This parameter returns only if you deployed a private endpoint to all regions to which you deployed this clusters' nodes. + items: + $ref: '#/components/schemas/ClusterDescriptionConnectionStringsPrivateEndpoint' + readOnly: true + type: array + privateSrv: + description: Network peering connection strings for each interface Virtual Private Cloud (VPC) endpoint that you configured to connect to this cluster. This connection string uses the `mongodb+srv://` protocol. The resource returns this parameter when someone creates a network peering connection to this cluster. This protocol tells the application to look up the host seed list in the Domain Name System (DNS). This list synchronizes with the nodes in a cluster. If the connection string uses this Uniform Resource Identifier (URI) format, you don't need to append the seed list or change the Uniform Resource Identifier (URI) if the nodes change. Use this Uniform Resource Identifier (URI) format if your driver supports it. If it doesn't, use `connectionStrings.private`. For Amazon Web Services (AWS) clusters, this parameter returns only if you [enable custom DNS](https://docs.atlas.mongodb.com/reference/api/aws-custom-dns-update/). + externalDocs: + description: Network Peering Connection + url: https://docs.atlas.mongodb.com/security-vpc-peering/#std-label-vpc-peering/ + readOnly: true + type: string + standard: + description: Public connection string that you can use to connect to this cluster. This connection string uses the `mongodb://` protocol. + externalDocs: + description: Connection String URI Format + url: https://docs.mongodb.com/manual/reference/connection-string/ + readOnly: true + type: string + standardSrv: + description: Public connection string that you can use to connect to this cluster. This connection string uses the `mongodb+srv://` protocol. + externalDocs: + description: Connection String URI Format + url: https://docs.mongodb.com/manual/reference/connection-string/ + readOnly: true + type: string + readOnly: true + title: Cluster Connection Strings + type: object + ClusterDescription20240805: + properties: + acceptDataRisksAndForceReplicaSetReconfig: + description: If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set **acceptDataRisksAndForceReplicaSetReconfig** to the current date. + externalDocs: + description: Reconfiguring a Replica Set during a regional outage + url: https://dochub.mongodb.org/core/regional-outage-reconfigure-replica-set + format: date-time + type: string + backupEnabled: + default: false + description: Flag that indicates whether the cluster can perform backups. If set to `true`, the cluster can perform backups. You must set this value to `true` for NVMe clusters. Backup uses [Cloud Backups](https://docs.atlas.mongodb.com/backup/cloud-backup/overview/) for dedicated clusters and [Shared Cluster Backups](https://docs.atlas.mongodb.com/backup/shared-tier/overview/) for tenant clusters. If set to `false`, the cluster doesn't use backups. + type: boolean + biConnector: + $ref: '#/components/schemas/BiConnector' + clusterType: + description: Configuration of nodes that comprise the cluster. + enum: + - REPLICASET + - SHARDED + - GEOSHARDED + type: string + configServerManagementMode: + default: ATLAS_MANAGED + description: |- + Config Server Management Mode for creating or updating a sharded cluster. + + When configured as ATLAS_MANAGED, atlas may automatically switch the cluster's config server type for optimal performance and savings. + + When configured as FIXED_TO_DEDICATED, the cluster will always use a dedicated config server. + enum: + - ATLAS_MANAGED + - FIXED_TO_DEDICATED + externalDocs: + description: MongoDB Sharded Cluster Config Servers + url: https://dochub.mongodb.org/docs/manual/core/sharded-cluster-config-servers + type: string + configServerType: + description: Describes a sharded cluster's config server type. + enum: + - DEDICATED + - EMBEDDED + externalDocs: + description: MongoDB Sharded Cluster Config Servers + url: https://dochub.mongodb.org/docs/manual/core/sharded-cluster-config-servers + readOnly: true + type: string + connectionStrings: + $ref: '#/components/schemas/ClusterConnectionStrings' + createDate: + description: Date and time when MongoDB Cloud created this cluster. This parameter expresses its value in ISO 8601 format in UTC. + format: date-time + readOnly: true + type: string + diskWarmingMode: + default: FULLY_WARMED + description: Disk warming mode selection. + enum: + - FULLY_WARMED + - VISIBLE_EARLIER + externalDocs: + description: Reduce Secondary Disk Warming Impact + url: https://docs.atlas.mongodb.com/reference/replica-set-tags/#reduce-secondary-disk-warming-impact + type: string + encryptionAtRestProvider: + description: 'Cloud service provider that manages your customer keys to provide an additional layer of encryption at rest for the cluster. To enable customer key management for encryption at rest, the cluster **replicationSpecs[n].regionConfigs[m].{type}Specs.instanceSize** setting must be `M10` or higher and `"backupEnabled" : false` or omitted entirely.' + enum: + - NONE + - AWS + - AZURE + - GCP + externalDocs: + description: Encryption at Rest using Customer Key Management + url: https://www.mongodb.com/docs/atlas/security-kms-encryption/ + type: string + featureCompatibilityVersion: + description: Feature compatibility version of the cluster. + readOnly: true + type: string + featureCompatibilityVersionExpirationDate: + description: Feature compatibility version expiration date. + format: date-time + readOnly: true + type: string + globalClusterSelfManagedSharding: + description: |- + Set this field to configure the Sharding Management Mode when creating a new Global Cluster. + + When set to false, the management mode is set to Atlas-Managed Sharding. This mode fully manages the sharding of your Global Cluster and is built to provide a seamless deployment experience. + + When set to true, the management mode is set to Self-Managed Sharding. This mode leaves the management of shards in your hands and is built to provide an advanced and flexible deployment experience. + + This setting cannot be changed once the cluster is deployed. + externalDocs: + description: Creating a Global Cluster + url: https://dochub.mongodb.org/core/global-cluster-management + type: boolean + groupId: + description: Unique 24-hexadecimal character string that identifies the project. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + id: + description: Unique 24-hexadecimal digit string that identifies the cluster. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + labels: + deprecated: true + description: |- + Collection of key-value pairs between 1 to 255 characters in length that tag and categorize the cluster. The MongoDB Cloud console doesn't display your labels. + + Cluster labels are deprecated and will be removed in a future release. We strongly recommend that you use [resource tags](https://dochub.mongodb.org/core/add-cluster-tag-atlas) instead. + items: + $ref: '#/components/schemas/ComponentLabel' + type: array + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + mongoDBEmployeeAccessGrant: + $ref: '#/components/schemas/EmployeeAccessGrantView' + mongoDBMajorVersion: + description: |- + MongoDB major version of the cluster. + + On creation: Choose from the available versions of MongoDB, or leave unspecified for the current recommended default in the MongoDB Cloud platform. The recommended version is a recent Long Term Support version. The default is not guaranteed to be the most recently released version throughout the entire release cycle. For versions available in a specific project, see the linked documentation or use the API endpoint for [project LTS versions endpoint](#tag/Projects/operation/getProjectLTSVersions). + + On update: Increase version only by 1 major version at a time. If the cluster is pinned to a MongoDB feature compatibility version exactly one major version below the current MongoDB version, the MongoDB version can be downgraded to the previous major version. + externalDocs: + description: Available MongoDB Versions in Atlas + url: https://www.mongodb.com/docs/atlas/reference/faq/database/#which-versions-of-mongodb-do-service-clusters-use- + type: string + mongoDBVersion: + description: Version of MongoDB that the cluster runs. + pattern: ([\d]+\.[\d]+\.[\d]+) + readOnly: true + type: string + name: + description: Human-readable label that identifies the cluster. + maxLength: 64 + minLength: 1 + pattern: ^([a-zA-Z0-9][a-zA-Z0-9-]*)?[a-zA-Z0-9]+$ + type: string + paused: + description: Flag that indicates whether the cluster is paused. + type: boolean + pitEnabled: + description: Flag that indicates whether the cluster uses continuous cloud backups. + externalDocs: + description: Continuous Cloud Backups + url: https://docs.atlas.mongodb.com/backup/cloud-backup/overview/ + type: boolean + redactClientLogData: + description: |- + Enable or disable log redaction. + + This setting configures the ``mongod`` or ``mongos`` to redact any document field contents from a message accompanying a given log event before logging. This prevents the program from writing potentially sensitive data stored on the database to the diagnostic log. Metadata such as error or operation codes, line numbers, and source file names are still visible in the logs. + + Use ``redactClientLogData`` in conjunction with Encryption at Rest and TLS/SSL (Transport Encryption) to assist compliance with regulatory requirements. + + *Note*: changing this setting on a cluster will trigger a rolling restart as soon as the cluster is updated. + externalDocs: + description: Log Redaction + url: https://www.mongodb.com/docs/manual/administration/monitoring/#log-redaction + type: boolean + replicaSetScalingStrategy: + default: WORKLOAD_TYPE + description: |- + Set this field to configure the replica set scaling mode for your cluster. + + By default, Atlas scales under WORKLOAD_TYPE. This mode allows Atlas to scale your analytics nodes in parallel to your operational nodes. + + When configured as SEQUENTIAL, Atlas scales all nodes sequentially. This mode is intended for steady-state workloads and applications performing latency-sensitive secondary reads. + + When configured as NODE_TYPE, Atlas scales your electable nodes in parallel with your read-only and analytics nodes. This mode is intended for large, dynamic workloads requiring frequent and timely cluster tier scaling. This is the fastest scaling strategy, but it might impact latency of workloads when performing extensive secondary reads. + enum: + - SEQUENTIAL + - WORKLOAD_TYPE + - NODE_TYPE + externalDocs: + description: Modify the Replica Set Scaling Mode + url: https://dochub.mongodb.org/core/scale-nodes + type: string + replicationSpecs: + description: List of settings that configure your cluster regions. This array has one object per shard representing node configurations in each shard. For replica sets there is only one object representing node configurations. + items: + $ref: '#/components/schemas/ReplicationSpec20240805' + type: array + rootCertType: + default: ISRGROOTX1 + description: Root Certificate Authority that MongoDB Cloud cluster uses. MongoDB Cloud supports Internet Security Research Group. + enum: + - ISRGROOTX1 + type: string + stateName: + description: Human-readable label that indicates the current operating condition of this cluster. + enum: + - IDLE + - CREATING + - UPDATING + - DELETING + - REPAIRING + readOnly: true + type: string + tags: + description: List that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. + externalDocs: + description: Resource Tags + url: https://dochub.mongodb.org/core/add-cluster-tag-atlas + items: + $ref: '#/components/schemas/ResourceTag' + type: array + terminationProtectionEnabled: + default: false + description: Flag that indicates whether termination protection is enabled on the cluster. If set to `true`, MongoDB Cloud won't delete the cluster. If set to `false`, MongoDB Cloud will delete the cluster. + type: boolean + versionReleaseSystem: + default: LTS + description: Method by which the cluster maintains the MongoDB versions. If value is `CONTINUOUS`, you must not specify **mongoDBMajorVersion**. + enum: + - LTS + - CONTINUOUS + type: string + type: object + ClusterDescriptionConnectionStringsPrivateEndpoint: + description: Private endpoint-aware connection string that you can use to connect to this cluster through a private endpoint. + externalDocs: + description: Private Endpoint for Dedicated Cluster + url: https://docs.atlas.mongodb.com/security-private-endpoint/ + properties: + connectionString: + description: Private endpoint-aware connection string that uses the `mongodb://` protocol to connect to MongoDB Cloud through a private endpoint. + readOnly: true + type: string + endpoints: + description: List that contains the private endpoints through which you connect to MongoDB Cloud when you use **connectionStrings.privateEndpoint[n].connectionString** or **connectionStrings.privateEndpoint[n].srvConnectionString**. + items: + $ref: '#/components/schemas/ClusterDescriptionConnectionStringsPrivateEndpointEndpoint' + readOnly: true + type: array + srvConnectionString: + description: Private endpoint-aware connection string that uses the `mongodb+srv://` protocol to connect to MongoDB Cloud through a private endpoint. The `mongodb+srv` protocol tells the driver to look up the seed list of hosts in the Domain Name System (DNS). This list synchronizes with the nodes in a cluster. If the connection string uses this Uniform Resource Identifier (URI) format, you don't need to append the seed list or change the Uniform Resource Identifier (URI) if the nodes change. Use this Uniform Resource Identifier (URI) format if your application supports it. If it doesn't, use connectionStrings.privateEndpoint[n].connectionString. + readOnly: true + type: string + srvShardOptimizedConnectionString: + description: Private endpoint-aware connection string optimized for sharded clusters that uses the `mongodb+srv://` protocol to connect to MongoDB Cloud through a private endpoint. If the connection string uses this Uniform Resource Identifier (URI) format, you don't need to change the Uniform Resource Identifier (URI) if the nodes change. Use this Uniform Resource Identifier (URI) format if your application and Atlas cluster supports it. If it doesn't, use and consult the documentation for connectionStrings.privateEndpoint[n].srvConnectionString. + readOnly: true + type: string + type: + description: MongoDB process type to which your application connects. Use `MONGOD` for replica sets and `MONGOS` for sharded clusters. + enum: + - MONGOD + - MONGOS + readOnly: true + type: string + title: Cluster Private Endpoint Connection String + type: object + ClusterDescriptionConnectionStringsPrivateEndpointEndpoint: + description: Details of a private endpoint deployed for this cluster. + properties: + endpointId: + description: Unique string that the cloud provider uses to identify the private endpoint. + readOnly: true + type: string + providerName: + description: Cloud provider in which MongoDB Cloud deploys the private endpoint. + enum: + - AWS + - AZURE + - GCP + readOnly: true + type: string + region: + description: Region where the private endpoint is deployed. + readOnly: true + type: string + title: Cluster Private Endpoint Connection Strings Endpoint + type: object + ClusterFreeAutoScaling: + description: Range of instance sizes to which your cluster can scale. + properties: + compute: + $ref: '#/components/schemas/FreeComputeAutoScalingRules' + type: object + ClusterFreeProviderSettings: + allOf: + - $ref: '#/components/schemas/ClusterProviderSettings' + - properties: + autoScaling: + $ref: '#/components/schemas/ClusterFreeAutoScaling' + backingProviderName: + description: Cloud service provider on which MongoDB Cloud provisioned the multi-tenant host. The resource returns this parameter when **providerSettings.providerName** is `TENANT` and **providerSetting.instanceSizeName** is `M0`, `M2` or `M5`. + enum: + - AWS + - GCP + - AZURE + type: string + instanceSizeName: + description: Cluster tier, with a default storage and memory capacity, that applies to all the data-bearing hosts in your cluster. You must set **providerSettings.providerName** to `TENANT` and specify the cloud service provider in **providerSettings.backingProviderName**. + enum: + - M0 + - M2 + - M5 + title: Tenant Instance Sizes + type: string + regionName: + description: Human-readable label that identifies the geographic location of your MongoDB cluster. The region you choose can affect network latency for clients accessing your databases. For a complete list of region names, see [AWS](https://docs.atlas.mongodb.com/reference/amazon-aws/#std-label-amazon-aws), [GCP](https://docs.atlas.mongodb.com/reference/google-gcp/), and [Azure](https://docs.atlas.mongodb.com/reference/microsoft-azure/). For multi-region clusters, see **replicationSpec.{region}**. + type: string + type: object + type: object + ClusterProviderSettings: + description: Group of cloud provider settings that configure the provisioned MongoDB hosts. + discriminator: + mapping: + AWS: '#/components/schemas/AWSCloudProviderSettings' + AZURE: '#/components/schemas/AzureCloudProviderSettings' + GCP: '#/components/schemas/CloudGCPProviderSettings' + TENANT: '#/components/schemas/ClusterFreeProviderSettings' + propertyName: providerName + oneOf: + - $ref: '#/components/schemas/AWSCloudProviderSettings' + - $ref: '#/components/schemas/AzureCloudProviderSettings' + - $ref: '#/components/schemas/CloudGCPProviderSettings' + - $ref: '#/components/schemas/ClusterFreeProviderSettings' + properties: + providerName: + type: string + required: + - providerName + title: Cloud Service Provider Settings for a Cluster + type: object + ClusterSearchIndex: + discriminator: + mapping: + search: '#/components/schemas/SearchIndex' + vectorSearch: '#/components/schemas/VectorSearchIndex' + propertyName: type + properties: + collectionName: + description: Human-readable label that identifies the collection that contains one or more Atlas Search indexes. + type: string + database: + description: Human-readable label that identifies the database that contains the collection with one or more Atlas Search indexes. + type: string + indexID: + description: Unique 24-hexadecimal digit string that identifies this Atlas Search index. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + name: + description: Human-readable label that identifies this index. Within each namespace, names of all indexes in the namespace must be unique. + type: string + status: + description: | + Condition of the search index when you made this request. + + | Status | Index Condition | + |---|---| + | IN_PROGRESS | Atlas is building or re-building the index after an edit. | + | STEADY | You can use this search index. | + | FAILED | Atlas could not build the index. | + | MIGRATING | Atlas is upgrading the underlying cluster tier and migrating indexes. | + | PAUSED | The cluster is paused. | + enum: + - IN_PROGRESS + - STEADY + - FAILED + - MIGRATING + - STALE + - PAUSED + readOnly: true + type: string + type: + description: Type of the index. Default type is search. + enum: + - search + - vectorSearch + type: string + required: + - collectionName + - database + - name + type: object + ComponentLabel: + description: Human-readable labels applied to this MongoDB Cloud component. + properties: + key: + description: Key applied to tag and categorize this component. + maxLength: 255 + minLength: 1 + type: string + value: + description: Value set to the Key applied to tag and categorize this component. + maxLength: 255 + minLength: 1 + type: string + title: Component Label + type: object + CreateAWSEndpointRequest: + allOf: + - $ref: '#/components/schemas/CreateEndpointRequest' + - properties: + id: + description: Unique string that identifies the private endpoint's network interface that someone added to this private endpoint service. + example: vpce-3bf78b0ddee411ba1 + pattern: ^vpce-[0-9a-f]{17}$ + type: string + writeOnly: true + type: object + description: Group of Private Endpoint settings. + required: + - id + title: AWS + type: object + CreateAzureEndpointRequest: + allOf: + - $ref: '#/components/schemas/CreateEndpointRequest' + - properties: + id: + description: Unique string that identifies the private endpoint's network interface that someone added to this private endpoint service. + example: /subscriptions/cba6d9c6-1d3f-3c11-03cb-c705d895e636/resourcegroups/qrRTqi4TSN)7yB5YLRjVDveH3.yLzpNR7Br0D3-SGrU3j0.0/providers/Microsoft.Network/privateEndpoints/pVP(vb(XeckpxtXzP0NaOsDjeWDbOK)DX8A2j2E_vBYL2.GEYIdln + type: string + writeOnly: true + privateEndpointIPAddress: + description: IPv4 address of the private endpoint in your Azure VNet that someone added to this private endpoint service. + pattern: ^((25[0-5]|(2[0-4]|1\d|[1-9]|)\d)(\.(?!$)|$)){4}|([0-9a-f]{1,4}:){7}[0-9a-f]{1,4}$ + type: string + type: object + description: Group of Private Endpoint settings. + required: + - id + - privateEndpointIPAddress + title: AZURE + type: object + CreateDataProcessRegionView: + description: Settings to configure the region where you wish to store your archived data. + discriminator: + mapping: + AWS: '#/components/schemas/AWSCreateDataProcessRegionView' + AZURE: '#/components/schemas/AzureCreateDataProcessRegionView' + GCP: '#/components/schemas/GCPCreateDataProcessRegionView' + propertyName: cloudProvider + properties: + cloudProvider: + description: Human-readable label that identifies the Cloud service provider where you wish to store your archived data. **AZURE** may be selected only if **AZURE** is the Cloud service provider for the cluster and no **AWS** online archive has been created for the cluster. + enum: + - AWS + - AZURE + type: string + type: object + writeOnly: true + CreateEndpointRequest: + oneOf: + - $ref: '#/components/schemas/CreateAWSEndpointRequest' + - $ref: '#/components/schemas/CreateAzureEndpointRequest' + - $ref: '#/components/schemas/CreateGCPEndpointGroupRequest' + type: object + CreateGCPEndpointGroupRequest: + allOf: + - $ref: '#/components/schemas/CreateEndpointRequest' + - properties: + endpointGroupName: + description: Human-readable label that identifies a set of endpoints. + type: string + writeOnly: true + endpoints: + description: List of individual private endpoints that comprise this endpoint group. + externalDocs: + description: Google Cloud Forwarding Rule Concepts + url: https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts + items: + $ref: '#/components/schemas/CreateGCPForwardingRuleRequest' + type: array + gcpProjectId: + description: Unique string that identifies the Google Cloud project in which you created the endpoints. + example: p-fdeeb3e43b8e733e5ab627b1 + externalDocs: + description: Google Cloud Creating and Managing Projects + url: https://cloud.google.com/resource-manager/docs/creating-managing-projects + pattern: ^p-[0-9a-z]{24}$ + type: string + writeOnly: true + type: object + description: Group of Private Endpoint settings. + required: + - endpointGroupName + - gcpProjectId + title: GCP + type: object + CreateGCPForwardingRuleRequest: + properties: + endpointName: + description: Human-readable label that identifies the Google Cloud consumer forwarding rule that you created. + externalDocs: + description: Google Cloud Forwarding Rule Concepts + url: https://cloud.google.com/load-balancing/docs/forwarding-rule-concepts + type: string + writeOnly: true + ipAddress: + description: One Private Internet Protocol version 4 (IPv4) address to which this Google Cloud consumer forwarding rule resolves. + pattern: ^((25[0-5]|(2[0-4]|1\d|[1-9]|)\d)(\.(?!$)|$)){4}|([0-9a-f]{1,4}:){7}[0-9a-f]{1,4}$ + type: string + writeOnly: true + title: GCP Forwarding Rules + type: object + CriteriaView: + description: |- + Rules by which MongoDB Cloud archives data. + + Use the **criteria.type** field to choose how MongoDB Cloud selects data to archive. Choose data using the age of the data or a MongoDB query. + **"criteria.type": "DATE"** selects documents to archive based on a date. + **"criteria.type": "CUSTOM"** selects documents to archive based on a custom JSON query. MongoDB Cloud doesn't support **"criteria.type": "CUSTOM"** when **"collectionType": "TIMESERIES"**. + discriminator: + mapping: + CUSTOM: '#/components/schemas/CustomCriteriaView' + DATE: '#/components/schemas/DateCriteriaView' + propertyName: type + properties: + type: + description: |- + Means by which MongoDB Cloud selects data to archive. Data can be chosen using the age of the data or a MongoDB query. + **DATE** selects documents to archive based on a date. + **CUSTOM** selects documents to archive based on a custom JSON query. MongoDB Cloud doesn't support **CUSTOM** when `"collectionType": "TIMESERIES"`. + enum: + - DATE + - CUSTOM + type: string + type: object + CustomCriteriaView: + allOf: + - $ref: '#/components/schemas/CriteriaView' + - properties: + query: + description: 'MongoDB find query that selects documents to archive. The specified query follows the syntax of the `db.collection.find(query)` command. This query can''t use the empty document (`{}`) to return all documents. Set this parameter when **"criteria.type" : "CUSTOM"**.' + type: string + type: object + description: '**CUSTOM criteria.type**.' + required: + - query + title: Archival Criteria + type: object + DBRoleToExecute: + description: The name of a Built in or Custom DB Role to connect to an Atlas Cluster. + properties: + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + role: + description: The name of the role to use. Can be a built in role or a custom role. + type: string + type: + description: Type of the DB role. Can be either BuiltIn or Custom. + enum: + - BUILT_IN + - CUSTOM + title: DB Role Type + type: string + type: object + DLSIngestionSink: + allOf: + - $ref: '#/components/schemas/IngestionSink' + - properties: + metadataProvider: + description: Target cloud provider for this Data Lake Pipeline. + enum: + - AWS + type: string + metadataRegion: + description: Target cloud provider region for this Data Lake Pipeline. + externalDocs: + description: Supported cloud provider regions + url: https://www.mongodb.com/docs/datalake/limitations + type: string + partitionFields: + description: Ordered fields used to physically organize data in the destination. + items: + $ref: '#/components/schemas/DataLakePipelinesPartitionField' + type: array + type: object + description: Atlas Data Lake Storage as the destination for a Data Lake Pipeline. + title: DLS Ingestion Destination + type: object + DailyScheduleView: + allOf: + - $ref: '#/components/schemas/OnlineArchiveSchedule' + - properties: + endHour: + description: Hour of the day when the scheduled window to run one online archive ends. + format: int32 + maximum: 23 + minimum: 0 + type: integer + endMinute: + description: Minute of the hour when the scheduled window to run one online archive ends. + format: int32 + maximum: 59 + minimum: 0 + type: integer + startHour: + description: Hour of the day when the when the scheduled window to run one online archive starts. + format: int32 + maximum: 23 + minimum: 0 + type: integer + startMinute: + description: Minute of the hour when the scheduled window to run one online archive starts. + format: int32 + maximum: 59 + minimum: 0 + type: integer + type: object + required: + - type + type: object + DataLakeApiBase: + description: An aggregation pipeline that applies to the collection. + properties: + name: + description: Human-readable label that identifies the view, which corresponds to an aggregation pipeline on a collection. + type: string + pipeline: + description: Aggregation pipeline stages to apply to the source collection. + externalDocs: + description: Aggregation Pipelines + url: https://docs.mongodb.com/manual/core/aggregation-pipeline/ + type: string + source: + description: Human-readable label that identifies the source collection for the view. + type: string + type: object + DataLakeAtlasStoreInstance: + allOf: + - $ref: '#/components/schemas/DataLakeStoreSettings' + - properties: + clusterName: + description: Human-readable label of the MongoDB Cloud cluster on which the store is based. + type: string + projectId: + description: Unique 24-hexadecimal digit string that identifies the project. + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + readConcern: + $ref: '#/components/schemas/DataLakeAtlasStoreReadConcern' + readPreference: + $ref: '#/components/schemas/DataLakeAtlasStoreReadPreference' + type: object + type: object + DataLakeAtlasStoreReadConcern: + description: MongoDB Cloud cluster read concern, which determines the consistency and isolation properties of the data read from an Atlas cluster. + properties: + level: + description: Read Concern level that specifies the consistency and availability of the data read. + enum: + - LOCAL + - MAJORITY + - LINEARIZABLE + - SNAPSHOT + - AVAILABLE + externalDocs: + description: Read Concern Level + url: https://www.mongodb.com/docs/manual/reference/read-concern/#read-concern-levels + type: string + type: object + DataLakeAtlasStoreReadPreference: + description: MongoDB Cloud cluster read preference, which describes how to route read requests to the cluster. + properties: + maxStalenessSeconds: + description: Maximum replication lag, or **staleness**, for reads from secondaries. + format: int32 + type: integer + mode: + description: Read preference mode that specifies to which replica set member to route the read requests. + enum: + - primary + - primaryPreferred + - secondary + - secondaryPreferred + - nearest + externalDocs: + description: Read Preference Modes + url: https://docs.mongodb.com/manual/core/read-preference/#read-preference-modes + type: string + tagSets: + description: List that contains tag sets or tag specification documents. If specified, Atlas Data Lake routes read requests to replica set member or members that are associated with the specified tags. + externalDocs: + description: Read Preference Tag Set Lists + url: https://docs.mongodb.com/manual/core/read-preference-tags/ + items: + items: + $ref: '#/components/schemas/DataLakeAtlasStoreReadPreferenceTag' + type: array + type: array + type: object + DataLakeAtlasStoreReadPreferenceTag: + properties: + name: + description: Human-readable label of the tag. + type: string + value: + description: Value of the tag. + type: string + type: object + DataLakeAzureBlobStore: + allOf: + - $ref: '#/components/schemas/DataLakeStoreSettings' + - properties: + containerName: + description: Human-readable label that identifies the name of the container. + type: string + delimiter: + description: Delimiter. + type: string + prefix: + description: Prefix. + type: string + public: + default: false + description: Flag that indicates whether the blob store is public. If set to `true`, MongoDB Cloud doesn't use the configured Azure service principal to access the blob store. If set to `false`, the configured Azure service principal must include permissions to access the blob store. + type: boolean + region: + description: Microsoft Azure Regions. + enum: + - US_CENTRAL + - US_EAST + - US_EAST_2 + - US_NORTH_CENTRAL + - US_WEST + - US_SOUTH_CENTRAL + - EUROPE_NORTH + - EUROPE_WEST + - US_WEST_CENTRAL + - US_WEST_2 + - US_WEST_3 + - CANADA_EAST + - CANADA_CENTRAL + - BRAZIL_SOUTH + - BRAZIL_SOUTHEAST + - AUSTRALIA_CENTRAL + - AUSTRALIA_CENTRAL_2 + - AUSTRALIA_EAST + - AUSTRALIA_SOUTH_EAST + - GERMANY_CENTRAL + - GERMANY_NORTH_EAST + - GERMANY_WEST_CENTRAL + - GERMANY_NORTH + - SWEDEN_CENTRAL + - SWEDEN_SOUTH + - SWITZERLAND_NORTH + - SWITZERLAND_WEST + - UK_SOUTH + - UK_WEST + - NORWAY_EAST + - NORWAY_WEST + - INDIA_CENTRAL + - INDIA_SOUTH + - INDIA_WEST + - CHINA_EAST + - CHINA_NORTH + - ASIA_EAST + - JAPAN_EAST + - JAPAN_WEST + - ASIA_SOUTH_EAST + - KOREA_CENTRAL + - KOREA_SOUTH + - FRANCE_CENTRAL + - FRANCE_SOUTH + - SOUTH_AFRICA_NORTH + - SOUTH_AFRICA_WEST + - UAE_CENTRAL + - UAE_NORTH + - QATAR_CENTRAL + title: Azure Regions + type: string + replacementDelimiter: + description: Replacement Delimiter. + type: string + serviceURL: + description: Service URL. + type: string + type: object + type: object + DataLakeDLSAWSStore: + allOf: + - $ref: '#/components/schemas/DataLakeStoreSettings' + - properties: + region: + description: Physical location where MongoDB Cloud deploys your AWS-hosted MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. MongoDB Cloud assigns the VPC a CIDR block. To limit a new VPC peering connection to one CIDR block and region, create the connection first. Deploy the cluster after the connection starts. + enum: + - US_GOV_WEST_1 + - US_GOV_EAST_1 + - US_EAST_1 + - US_EAST_2 + - US_WEST_1 + - US_WEST_2 + - CA_CENTRAL_1 + - EU_NORTH_1 + - EU_WEST_1 + - EU_WEST_2 + - EU_WEST_3 + - EU_CENTRAL_1 + - EU_CENTRAL_2 + - AP_EAST_1 + - AP_NORTHEAST_1 + - AP_NORTHEAST_2 + - AP_NORTHEAST_3 + - AP_SOUTHEAST_1 + - AP_SOUTHEAST_2 + - AP_SOUTHEAST_3 + - AP_SOUTHEAST_4 + - AP_SOUTH_1 + - AP_SOUTH_2 + - SA_EAST_1 + - CN_NORTH_1 + - CN_NORTHWEST_1 + - ME_SOUTH_1 + - ME_CENTRAL_1 + - AF_SOUTH_1 + - EU_SOUTH_1 + - EU_SOUTH_2 + - IL_CENTRAL_1 + - CA_WEST_1 + - GLOBAL + title: AWS Regions + type: string + type: object + type: object + DataLakeDLSAzureStore: + allOf: + - $ref: '#/components/schemas/DataLakeStoreSettings' + - properties: + region: + description: Microsoft Azure Regions. + enum: + - US_CENTRAL + - US_EAST + - US_EAST_2 + - US_NORTH_CENTRAL + - US_WEST + - US_SOUTH_CENTRAL + - EUROPE_NORTH + - EUROPE_WEST + - US_WEST_CENTRAL + - US_WEST_2 + - US_WEST_3 + - CANADA_EAST + - CANADA_CENTRAL + - BRAZIL_SOUTH + - BRAZIL_SOUTHEAST + - AUSTRALIA_CENTRAL + - AUSTRALIA_CENTRAL_2 + - AUSTRALIA_EAST + - AUSTRALIA_SOUTH_EAST + - GERMANY_CENTRAL + - GERMANY_NORTH_EAST + - GERMANY_WEST_CENTRAL + - GERMANY_NORTH + - SWEDEN_CENTRAL + - SWEDEN_SOUTH + - SWITZERLAND_NORTH + - SWITZERLAND_WEST + - UK_SOUTH + - UK_WEST + - NORWAY_EAST + - NORWAY_WEST + - INDIA_CENTRAL + - INDIA_SOUTH + - INDIA_WEST + - CHINA_EAST + - CHINA_NORTH + - ASIA_EAST + - JAPAN_EAST + - JAPAN_WEST + - ASIA_SOUTH_EAST + - KOREA_CENTRAL + - KOREA_SOUTH + - FRANCE_CENTRAL + - FRANCE_SOUTH + - SOUTH_AFRICA_NORTH + - SOUTH_AFRICA_WEST + - UAE_CENTRAL + - UAE_NORTH + - QATAR_CENTRAL + title: Azure Regions + type: string + type: object + type: object + DataLakeDLSGCPStore: + allOf: + - $ref: '#/components/schemas/DataLakeStoreSettings' + - properties: + region: + description: Google Cloud Platform Regions. + enum: + - ASIA_EAST_2 + - ASIA_NORTHEAST_2 + - ASIA_NORTHEAST_3 + - ASIA_SOUTH_1 + - ASIA_SOUTH_2 + - ASIA_SOUTHEAST_2 + - AUSTRALIA_SOUTHEAST_1 + - AUSTRALIA_SOUTHEAST_2 + - CENTRAL_US + - EASTERN_ASIA_PACIFIC + - EASTERN_US + - EUROPE_CENTRAL_2 + - EUROPE_NORTH_1 + - EUROPE_WEST_2 + - EUROPE_WEST_3 + - EUROPE_WEST_4 + - EUROPE_WEST_6 + - EUROPE_WEST_10 + - EUROPE_WEST_12 + - MIDDLE_EAST_CENTRAL_1 + - MIDDLE_EAST_CENTRAL_2 + - MIDDLE_EAST_WEST_1 + - NORTH_AMERICA_NORTHEAST_1 + - NORTH_AMERICA_NORTHEAST_2 + - NORTHEASTERN_ASIA_PACIFIC + - SOUTH_AMERICA_EAST_1 + - SOUTH_AMERICA_WEST_1 + - SOUTHEASTERN_ASIA_PACIFIC + - US_EAST_4 + - US_EAST_5 + - US_WEST_2 + - US_WEST_3 + - US_WEST_4 + - US_SOUTH_1 + - WESTERN_EUROPE + - WESTERN_US + title: GCP Regions + type: string + type: object + type: object + DataLakeDatabaseCollection: + description: A collection and data sources that map to a ``stores`` data store. + properties: + dataSources: + description: Array that contains the data stores that map to a collection for this data lake. + items: + $ref: '#/components/schemas/DataLakeDatabaseDataSourceSettings' + type: array + name: + description: Human-readable label that identifies the collection to which MongoDB Cloud maps the data in the data stores. + type: string + type: object + DataLakeDatabaseDataSourceSettings: + description: Data store that maps to a collection for this data lake. + properties: + allowInsecure: + default: false + description: Flag that validates the scheme in the specified URLs. If `true`, allows insecure `HTTP` scheme, doesn't verify the server's certificate chain and hostname, and accepts any certificate with any hostname presented by the server. If `false`, allows secure `HTTPS` scheme only. + type: boolean + collection: + description: Human-readable label that identifies the collection in the database. For creating a wildcard (`*`) collection, you must omit this parameter. + type: string + collectionRegex: + description: Regex pattern to use for creating the wildcard (*) collection. To learn more about the regex syntax, see [Go programming language](https://pkg.go.dev/regexp). + type: string + database: + description: Human-readable label that identifies the database, which contains the collection in the cluster. You must omit this parameter to generate wildcard (`*`) collections for dynamically generated databases. + type: string + databaseRegex: + description: Regex pattern to use for creating the wildcard (*) database. To learn more about the regex syntax, see [Go programming language](https://pkg.go.dev/regexp). + type: string + datasetName: + description: Human-readable label that identifies the dataset that Atlas generates for an ingestion pipeline run or Online Archive. + example: v1$atlas$snapshot$Cluster0$myDatabase$myCollection$19700101T000000Z + type: string + datasetPrefix: + description: Human-readable label that matches against the dataset names for ingestion pipeline runs or Online Archives. + type: string + defaultFormat: + description: File format that MongoDB Cloud uses if it encounters a file without a file extension while searching **storeName**. + enum: + - .avro + - .avro.bz2 + - .avro.gz + - .bson + - .bson.bz2 + - .bson.gz + - .bsonx + - .csv + - .csv.bz2 + - .csv.gz + - .json + - .json.bz2 + - .json.gz + - .orc + - .parquet + - .tsv + - .tsv.bz2 + - .tsv.gz + type: string + path: + description: File path that controls how MongoDB Cloud searches for and parses files in the **storeName** before mapping them to a collection.Specify ``/`` to capture all files and folders from the ``prefix`` path. + type: string + provenanceFieldName: + description: Name for the field that includes the provenance of the documents in the results. MongoDB Cloud returns different fields in the results for each supported provider. + type: string + storeName: + description: Human-readable label that identifies the data store that MongoDB Cloud maps to the collection. + type: string + trimLevel: + description: Unsigned integer that specifies how many fields of the dataset name to trim from the left of the dataset name before mapping the remaining fields to a wildcard collection name. + format: int32 + type: integer + urls: + description: URLs of the publicly accessible data files. You can't specify URLs that require authentication. Atlas Data Lake creates a partition for each URL. If empty or omitted, Data Lake uses the URLs from the store specified in the **dataSources.storeName** parameter. + items: + type: string + type: array + type: object + DataLakeDatabaseInstance: + description: Database associated with this data lake. Databases contain collections and views. + properties: + collections: + description: Array of collections and data sources that map to a ``stores`` data store. + items: + $ref: '#/components/schemas/DataLakeDatabaseCollection' + type: array + maxWildcardCollections: + default: 100 + description: Maximum number of wildcard collections in the database. This only applies to S3 data sources. + format: int32 + maximum: 1000 + minimum: 1 + type: integer + name: + description: Human-readable label that identifies the database to which the data lake maps data. + type: string + views: + description: Array of aggregation pipelines that apply to the collection. This only applies to S3 data sources. + items: + $ref: '#/components/schemas/DataLakeApiBase' + type: array + type: object + DataLakeGoogleCloudStorageStore: + allOf: + - $ref: '#/components/schemas/DataLakeStoreSettings' + - properties: + bucket: + description: Human-readable label that identifies the Google Cloud Storage bucket. + type: string + delimiter: + description: Delimiter. + type: string + prefix: + description: Prefix. + type: string + public: + default: false + description: Flag that indicates whether the bucket is public. If set to `true`, MongoDB Cloud doesn't use the configured GCP service account to access the bucket. If set to `false`, the configured GCP service acccount must include permissions to access the bucket. + type: boolean + region: + description: Google Cloud Platform Regions. + enum: + - ASIA_EAST_2 + - ASIA_NORTHEAST_2 + - ASIA_NORTHEAST_3 + - ASIA_SOUTH_1 + - ASIA_SOUTH_2 + - ASIA_SOUTHEAST_2 + - AUSTRALIA_SOUTHEAST_1 + - AUSTRALIA_SOUTHEAST_2 + - CENTRAL_US + - EASTERN_ASIA_PACIFIC + - EASTERN_US + - EUROPE_CENTRAL_2 + - EUROPE_NORTH_1 + - EUROPE_WEST_2 + - EUROPE_WEST_3 + - EUROPE_WEST_4 + - EUROPE_WEST_6 + - EUROPE_WEST_10 + - EUROPE_WEST_12 + - MIDDLE_EAST_CENTRAL_1 + - MIDDLE_EAST_CENTRAL_2 + - MIDDLE_EAST_WEST_1 + - NORTH_AMERICA_NORTHEAST_1 + - NORTH_AMERICA_NORTHEAST_2 + - NORTHEASTERN_ASIA_PACIFIC + - SOUTH_AMERICA_EAST_1 + - SOUTH_AMERICA_WEST_1 + - SOUTHEASTERN_ASIA_PACIFIC + - US_EAST_4 + - US_EAST_5 + - US_WEST_2 + - US_WEST_3 + - US_WEST_4 + - US_SOUTH_1 + - WESTERN_EUROPE + - WESTERN_US + title: GCP Regions + type: string + replacementDelimiter: + description: Replacement Delimiter. + type: string + type: object + type: object + DataLakeHTTPStore: + allOf: + - $ref: '#/components/schemas/DataLakeStoreSettings' + - properties: + allowInsecure: + default: false + description: Flag that validates the scheme in the specified URLs. If `true`, allows insecure `HTTP` scheme, doesn't verify the server's certificate chain and hostname, and accepts any certificate with any hostname presented by the server. If `false`, allows secure `HTTPS` scheme only. + type: boolean + defaultFormat: + description: Default format that Data Lake assumes if it encounters a file without an extension while searching the `storeName`. If omitted, Data Lake attempts to detect the file type by processing a few bytes of the file. The specified format only applies to the URLs specified in the **databases.[n].collections.[n].dataSources** object. + type: string + urls: + description: Comma-separated list of publicly accessible HTTP URLs where data is stored. You can't specify URLs that require authentication. + items: + description: Comma-separated list of publicly accessible HTTP URLs where data is stored. You can't specify URLs that require authentication. + type: string + type: array + type: object + type: object + DataLakePipelinesPartitionField: + description: Partition Field in the Data Lake Storage provider for a Data Lake Pipeline. + properties: + fieldName: + description: Human-readable label that identifies the field name used to partition data. + maxLength: 700 + type: string + order: + default: 0 + description: Sequence in which MongoDB Cloud slices the collection data to create partitions. The resource expresses this sequence starting with zero. + format: int32 + type: integer + required: + - fieldName + - order + title: Partition Field + type: object + DataLakeS3StoreSettings: + allOf: + - $ref: '#/components/schemas/DataLakeStoreSettings' + - properties: + additionalStorageClasses: + description: Collection of AWS S3 [storage classes](https://aws.amazon.com/s3/storage-classes/). Atlas Data Lake includes the files in these storage classes in the query results. + items: + description: AWS S3 [storage class](https://aws.amazon.com/s3/storage-classes/) where the files to include in the results are stored. + enum: + - STANDARD + - INTELLIGENT_TIERING + - STANDARD_IA + type: string + type: array + bucket: + description: Human-readable label that identifies the AWS S3 bucket. This label must exactly match the name of an S3 bucket that the data lake can access with the configured AWS Identity and Access Management (IAM) credentials. + type: string + delimiter: + description: The delimiter that separates **databases.[n].collections.[n].dataSources.[n].path** segments in the data store. MongoDB Cloud uses the delimiter to efficiently traverse S3 buckets with a hierarchical directory structure. You can specify any character supported by the S3 object keys as the delimiter. For example, you can specify an underscore (_) or a plus sign (+) or multiple characters, such as double underscores (__) as the delimiter. If omitted, defaults to `/`. + type: string + includeTags: + default: false + description: Flag that indicates whether to use S3 tags on the files in the given path as additional partition attributes. If set to `true`, data lake adds the S3 tags as additional partition attributes and adds new top-level BSON elements associating each tag to each document. + type: boolean + prefix: + description: Prefix that MongoDB Cloud applies when searching for files in the S3 bucket. The data store prepends the value of prefix to the **databases.[n].collections.[n].dataSources.[n].path** to create the full path for files to ingest. If omitted, MongoDB Cloud searches all files from the root of the S3 bucket. + type: string + public: + default: false + description: Flag that indicates whether the bucket is public. If set to `true`, MongoDB Cloud doesn't use the configured AWS Identity and Access Management (IAM) role to access the S3 bucket. If set to `false`, the configured AWS IAM role must include permissions to access the S3 bucket. + type: boolean + region: + description: Physical location where MongoDB Cloud deploys your AWS-hosted MongoDB cluster nodes. The region you choose can affect network latency for clients accessing your databases. When MongoDB Cloud deploys a dedicated cluster, it checks if a VPC or VPC connection exists for that provider and region. If not, MongoDB Cloud creates them as part of the deployment. MongoDB Cloud assigns the VPC a CIDR block. To limit a new VPC peering connection to one CIDR block and region, create the connection first. Deploy the cluster after the connection starts. + enum: + - US_GOV_WEST_1 + - US_GOV_EAST_1 + - US_EAST_1 + - US_EAST_2 + - US_WEST_1 + - US_WEST_2 + - CA_CENTRAL_1 + - EU_NORTH_1 + - EU_WEST_1 + - EU_WEST_2 + - EU_WEST_3 + - EU_CENTRAL_1 + - EU_CENTRAL_2 + - AP_EAST_1 + - AP_NORTHEAST_1 + - AP_NORTHEAST_2 + - AP_NORTHEAST_3 + - AP_SOUTHEAST_1 + - AP_SOUTHEAST_2 + - AP_SOUTHEAST_3 + - AP_SOUTHEAST_4 + - AP_SOUTH_1 + - AP_SOUTH_2 + - SA_EAST_1 + - CN_NORTH_1 + - CN_NORTHWEST_1 + - ME_SOUTH_1 + - ME_CENTRAL_1 + - AF_SOUTH_1 + - EU_SOUTH_1 + - EU_SOUTH_2 + - IL_CENTRAL_1 + - CA_WEST_1 + - GLOBAL + title: AWS Regions + type: string + type: object + type: object + DataLakeStorage: + description: Configuration information for each data store and its mapping to MongoDB Cloud databases. + properties: + databases: + description: Array that contains the queryable databases and collections for this data lake. + items: + $ref: '#/components/schemas/DataLakeDatabaseInstance' + type: array + stores: + description: Array that contains the data stores for the data lake. + items: + $ref: '#/components/schemas/DataLakeStoreSettings' + type: array + type: object + DataLakeStoreSettings: + description: Group of settings that define where the data is stored. + discriminator: + mapping: + atlas: '#/components/schemas/DataLakeAtlasStoreInstance' + azure: '#/components/schemas/DataLakeAzureBlobStore' + dls:aws: '#/components/schemas/DataLakeDLSAWSStore' + dls:azure: '#/components/schemas/DataLakeDLSAzureStore' + dls:gcp: '#/components/schemas/DataLakeDLSGCPStore' + gcs: '#/components/schemas/DataLakeGoogleCloudStorageStore' + http: '#/components/schemas/DataLakeHTTPStore' + s3: '#/components/schemas/DataLakeS3StoreSettings' + propertyName: provider + oneOf: + - $ref: '#/components/schemas/DataLakeS3StoreSettings' + - $ref: '#/components/schemas/DataLakeDLSAWSStore' + - $ref: '#/components/schemas/DataLakeDLSAzureStore' + - $ref: '#/components/schemas/DataLakeDLSGCPStore' + - $ref: '#/components/schemas/DataLakeAtlasStoreInstance' + - $ref: '#/components/schemas/DataLakeHTTPStore' + - $ref: '#/components/schemas/DataLakeAzureBlobStore' + - $ref: '#/components/schemas/DataLakeGoogleCloudStorageStore' + properties: + name: + description: Human-readable label that identifies the data store. The **databases.[n].collections.[n].dataSources.[n].storeName** field references this values as part of the mapping configuration. To use MongoDB Cloud as a data store, the data lake requires a serverless instance or an `M10` or higher cluster. + type: string + provider: + type: string + required: + - provider + type: object + DataProcessRegionView: + description: Settings to configure the region where you wish to store your archived data. + discriminator: + mapping: + AWS: '#/components/schemas/AWSDataProcessRegionView' + AZURE: '#/components/schemas/AzureDataProcessRegionView' + GCP: '#/components/schemas/GCPDataProcessRegionView' + propertyName: cloudProvider + properties: + cloudProvider: + description: Human-readable label that identifies the Cloud service provider where you store your archived data. + enum: + - AWS + - AZURE + - GCP + readOnly: true + type: string + readOnly: true + type: object + DateCriteriaView: + allOf: + - $ref: '#/components/schemas/CriteriaView' + - properties: + dateField: + description: 'Indexed database parameter that stores the date that determines when data moves to the online archive. MongoDB Cloud archives the data when the current date exceeds the date in this database parameter plus the number of days specified through the **expireAfterDays** parameter. Set this parameter when you set `"criteria.type" : "DATE"`.' + type: string + dateFormat: + default: ISODATE + description: |- + Syntax used to write the date after which data moves to the online archive. Date can be expressed as ISO 8601 or Epoch timestamps. The Epoch timestamp can be expressed as nanoseconds, milliseconds, or seconds. Set this parameter when **"criteria.type" : "DATE"**. + You must set **"criteria.type" : "DATE"** if **"collectionType": "TIMESERIES"**. + enum: + - ISODATE + - EPOCH_SECONDS + - EPOCH_MILLIS + - EPOCH_NANOSECONDS + type: string + expireAfterDays: + description: 'Number of days after the value in the **criteria.dateField** when MongoDB Cloud archives data in the specified cluster. Set this parameter when you set **"criteria.type" : "DATE"**.' + format: int32 + type: integer + type: object + description: '**DATE criteria.type**.' + title: Archival Criteria + type: object + DedicatedHardwareSpec: + description: Hardware specifications for read-only nodes in the region. Read-only nodes can never become the primary member, but can enable local reads.If you don't specify this parameter, no read-only nodes are deployed to the region. + oneOf: + - $ref: '#/components/schemas/AWSHardwareSpec' + - $ref: '#/components/schemas/AzureHardwareSpec' + - $ref: '#/components/schemas/GCPHardwareSpec' + properties: + nodeCount: + description: Number of nodes of the given type for MongoDB Cloud to deploy to the region. + format: int32 + type: integer + type: object + DedicatedHardwareSpec20240805: + description: Hardware specifications for read-only nodes in the region. Read-only nodes can never become the primary member, but can enable local reads. If you don't specify this parameter, no read-only nodes are deployed to the region. + oneOf: + - $ref: '#/components/schemas/AWSHardwareSpec20240805' + - $ref: '#/components/schemas/AzureHardwareSpec20240805' + - $ref: '#/components/schemas/GCPHardwareSpec20240805' + properties: + diskSizeGB: + description: |- + Storage capacity of instance data volumes expressed in gigabytes. Increase this number to add capacity. + + This value must be equal for all shards and node types. + + This value is not configurable on M0/M2/M5 clusters. + + MongoDB Cloud requires this parameter if you set **replicationSpecs**. + + If you specify a disk size below the minimum (10 GB), this parameter defaults to the minimum disk size value. + + Storage charge calculations depend on whether you choose the default value or a custom value. + + The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require more storage space, consider upgrading your cluster to a higher tier. + format: double + maximum: 4096 + minimum: 10 + type: number + nodeCount: + description: Number of nodes of the given type for MongoDB Cloud to deploy to the region. + format: int32 + type: integer + type: object + DefaultScheduleView: + allOf: + - $ref: '#/components/schemas/OnlineArchiveSchedule' + required: + - type + type: object + DiskBackupSnapshotAWSExportBucketRequest: + allOf: + - $ref: '#/components/schemas/DiskBackupSnapshotExportBucketRequest' + - properties: + iamRoleId: + description: Unique 24-hexadecimal character string that identifies the Unified AWS Access role ID that MongoDB Cloud uses to access the AWS S3 bucket. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + type: object + required: + - bucketName + - cloudProvider + - iamRoleId + type: object + DiskBackupSnapshotAWSExportBucketResponse: + properties: + _id: + description: Unique 24-hexadecimal character string that identifies the Export Bucket. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + bucketName: + description: The name of the AWS S3 Bucket or Azure Storage Container that Snapshots are exported to. + example: export-bucket + maxLength: 63 + minLength: 3 + type: string + cloudProvider: + description: Human-readable label that identifies the cloud provider that Snapshots will be exported to. + enum: + - AWS + - AZURE + type: string + iamRoleId: + description: Unique 24-hexadecimal character string that identifies the Unified AWS Access role ID that MongoDB Cloud uses to access the AWS S3 bucket. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + required: + - _id + - bucketName + - cloudProvider + - iamRoleId + type: object + DiskBackupSnapshotAzureExportBucketRequest: + allOf: + - $ref: '#/components/schemas/DiskBackupSnapshotExportBucketRequest' + - properties: + bucketName: + deprecated: true + description: 'The name of the Azure Storage Container to export to. Deprecated: provide the Container''s URL in serviceUrl instead.' + example: export-container + maxLength: 63 + minLength: 3 + type: string + roleId: + description: Unique 24-hexadecimal digit string that identifies the Azure Cloud Provider Access Role that MongoDB Cloud uses to access the Azure Blob Storage Container. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + serviceUrl: + description: 'URL of the Azure Storage Account to export to. For example: "https://examplestorageaccount.blob.core.windows.net". Only standard endpoints (with "blob.core.windows.net") are supported.' + example: https://examplestorageaccount.blob.core.windows.net + maxLength: 2048 + minLength: 33 + type: string + tenantId: + deprecated: true + description: 'UUID that identifies the Azure Active Directory Tenant ID. Deprecated: this field is ignored; the tenantId of the Cloud Provider Access role (from roleId) is used.' + example: 4297fc77-1592-4de8-a6d5-a8c32401df87 + maxLength: 36 + minLength: 36 + pattern: ^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$ + type: string + type: object + required: + - cloudProvider + - roleId + - serviceUrl + type: object + DiskBackupSnapshotAzureExportBucketResponse: + allOf: + - $ref: '#/components/schemas/DiskBackupSnapshotExportBucketResponse' + - properties: + roleId: + description: Unique 24-hexadecimal digit string that identifies the Azure Cloud Provider Access Role that MongoDB Cloud uses to access the Azure Blob Storage Container. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + serviceUrl: + description: URL of the Azure Storage Account to export to. Only standard endpoints (with "blob.core.windows.net") are supported. + example: https://examplestorageaccount.blob.core.windows.net + maxLength: 2048 + minLength: 33 + type: string + tenantId: + description: UUID that identifies the Azure Active Directory Tenant ID used during exports. + example: 4297fc77-1592-4de8-a6d5-a8c32401df87 + maxLength: 36 + minLength: 36 + pattern: ^[0-9a-fA-F]{8}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{4}\b-[0-9a-fA-F]{12}$ + type: string + type: object + required: + - _id + - bucketName + - cloudProvider + - roleId + - serviceUrl + - tenantId + type: object + DiskBackupSnapshotExportBucketRequest: + description: Disk backup snapshot Export Bucket Request. + discriminator: + mapping: + AWS: '#/components/schemas/DiskBackupSnapshotAWSExportBucketRequest' + AZURE: '#/components/schemas/DiskBackupSnapshotAzureExportBucketRequest' + propertyName: cloudProvider + oneOf: + - $ref: '#/components/schemas/DiskBackupSnapshotAWSExportBucketRequest' + - $ref: '#/components/schemas/DiskBackupSnapshotAzureExportBucketRequest' + properties: + bucketName: + description: Human-readable label that identifies the AWS S3 Bucket or Azure Storage Container that the role is authorized to export to. + example: export-bucket + maxLength: 63 + minLength: 3 + type: string + cloudProvider: + description: Human-readable label that identifies the cloud provider that Snapshots are exported to. + enum: + - AWS + - AZURE + type: string + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + required: + - bucketName + - cloudProvider + type: object + DiskBackupSnapshotExportBucketResponse: + description: Disk backup snapshot Export Bucket. + discriminator: + mapping: + AWS: '#/components/schemas/DiskBackupSnapshotAWSExportBucketResponse' + AZURE: '#/components/schemas/DiskBackupSnapshotAzureExportBucketResponse' + propertyName: cloudProvider + oneOf: + - $ref: '#/components/schemas/DiskBackupSnapshotAWSExportBucketResponse' + - $ref: '#/components/schemas/DiskBackupSnapshotAzureExportBucketResponse' + properties: + _id: + description: Unique 24-hexadecimal character string that identifies the Export Bucket. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + bucketName: + description: The name of the AWS S3 Bucket or Azure Storage Container that Snapshots are exported to. + example: export-bucket + maxLength: 63 + minLength: 3 + type: string + cloudProvider: + description: Human-readable label that identifies the cloud provider that Snapshots will be exported to. + enum: + - AWS + - AZURE + type: string + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + required: + - _id + - bucketName + - cloudProvider + type: object + DiskGBAutoScaling: + description: Setting that enables disk auto-scaling. + properties: + enabled: + description: Flag that indicates whether this cluster enables disk auto-scaling. The maximum memory allowed for the selected cluster tier and the oplog size can limit storage auto-scaling. + type: boolean + type: object + EmployeeAccessGrantView: + description: MongoDB employee granted access level and expiration for a cluster. + properties: + expirationTime: + description: Expiration date for the employee access grant. + format: date-time + type: string + grantType: + description: Level of access to grant to MongoDB Employees. + enum: + - CLUSTER_DATABASE_LOGS + - CLUSTER_INFRASTRUCTURE + - CLUSTER_INFRASTRUCTURE_AND_APP_SERVICES_SYNC_DATA + type: string + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + required: + - expirationTime + - grantType + type: object + FieldViolation: + properties: + description: + description: A description of why the request element is bad. + type: string + field: + description: A path that leads to a field in the request body. + type: string + required: + - description + - field + type: object + FreeComputeAutoScalingRules: + description: Collection of settings that configures how a cluster might scale its cluster tier and whether the cluster can scale down. + properties: + maxInstanceSize: + description: Maximum instance size to which your cluster can automatically scale. + enum: + - M0 + - M2 + - M5 + title: Tenant Instance Sizes + type: string + minInstanceSize: + description: Minimum instance size to which your cluster can automatically scale. + enum: + - M0 + - M2 + - M5 + title: Tenant Instance Sizes + type: string + title: Tenant + type: object + GCPCloudProviderContainer: + allOf: + - $ref: '#/components/schemas/CloudProviderContainer' + - properties: + atlasCidrBlock: + description: |- + IP addresses expressed in Classless Inter-Domain Routing (CIDR) notation that MongoDB Cloud uses for the network peering containers in your project. MongoDB Cloud assigns all of the project's clusters deployed to this cloud provider an IP address from this range. MongoDB Cloud locks this value if an M10 or greater cluster or a network peering connection exists in this project. + + These CIDR blocks must fall within the ranges reserved per RFC 1918. GCP further limits the block to a lower bound of the `/18` range. + + To modify the CIDR block, the target project cannot have: + + - Any M10 or greater clusters + - Any other VPC peering connections + + You can also create a new project and create a network peering connection to set the desired MongoDB Cloud network peering container CIDR block for that project. MongoDB Cloud limits the number of MongoDB nodes per network peering connection based on the CIDR block and the region selected for the project. + + **Example:** A project in an Google Cloud (GCP) region supporting three availability zones and an MongoDB CIDR network peering container block of limit of `/24` equals 27 three-node replica sets. + pattern: ^((([0-9]{1,3}\.){3}[0-9]{1,3})|(:{0,2}([0-9a-f]{1,4}:){0,7}[0-9a-f]{1,4}[:]{0,2}))((%2[fF]|/)[0-9]{1,3})+$ + type: string + gcpProjectId: + description: Unique string that identifies the GCP project in which MongoDB Cloud clusters in this network peering container exist. The response returns **null** if no clusters exist in this network peering container. + maxLength: 26 + minLength: 26 + pattern: ^p-[0-9a-z]{24}$ + readOnly: true + type: string + networkName: + description: Human-readable label that identifies the network in which MongoDB Cloud clusters in this network peering container exist. MongoDB Cloud returns **null** if no clusters exist in this network peering container. + maxLength: 36 + minLength: 36 + pattern: ^nt-[0-9a-f]{24}-[0-9a-z]{8}$ + readOnly: true + type: string + regions: + description: List of GCP regions to which you want to deploy this MongoDB Cloud network peering container. In this MongoDB Cloud project, you can deploy clusters only to the GCP regions in this list. To deploy MongoDB Cloud clusters to other GCP regions, create additional projects. + items: + description: List of GCP regions to which you want to deploy this MongoDB Cloud network peering container. In this MongoDB Cloud project, you can deploy clusters only to the GCP regions in this list. To deploy MongoDB Cloud clusters to other GCP regions, create additional projects. + enum: + - ASIA_EAST_2 + - ASIA_NORTHEAST_2 + - ASIA_NORTHEAST_3 + - ASIA_SOUTH_1 + - ASIA_SOUTH_2 + - ASIA_SOUTHEAST_2 + - AUSTRALIA_SOUTHEAST_1 + - AUSTRALIA_SOUTHEAST_2 + - CENTRAL_US + - EASTERN_ASIA_PACIFIC + - EASTERN_US + - EUROPE_CENTRAL_2 + - EUROPE_NORTH_1 + - EUROPE_WEST_2 + - EUROPE_WEST_3 + - EUROPE_WEST_4 + - EUROPE_WEST_6 + - EUROPE_WEST_10 + - EUROPE_WEST_12 + - MIDDLE_EAST_CENTRAL_1 + - MIDDLE_EAST_CENTRAL_2 + - MIDDLE_EAST_WEST_1 + - NORTH_AMERICA_NORTHEAST_1 + - NORTH_AMERICA_NORTHEAST_2 + - NORTHEASTERN_ASIA_PACIFIC + - SOUTH_AMERICA_EAST_1 + - SOUTH_AMERICA_WEST_1 + - SOUTHEASTERN_ASIA_PACIFIC + - US_EAST_4 + - US_EAST_5 + - US_WEST_2 + - US_WEST_3 + - US_WEST_4 + - US_SOUTH_1 + - WESTERN_EUROPE + - WESTERN_US + type: string + type: array + type: object + description: Collection of settings that configures the network container for a virtual private connection on Amazon Web Services. + required: + - atlasCidrBlock + title: GCP + type: object + GCPComputeAutoScaling: + description: Collection of settings that configures how a cluster might scale its cluster tier and whether the cluster can scale down. Cluster tier auto-scaling is unavailable for clusters using Low CPU or NVME storage classes. + properties: + maxInstanceSize: + description: Maximum instance size to which your cluster can automatically scale. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M140 + - M200 + - M250 + - M300 + - M400 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - R600 + title: GCP Instance Sizes + type: string + minInstanceSize: + description: Minimum instance size to which your cluster can automatically scale. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M140 + - M200 + - M250 + - M300 + - M400 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - R600 + title: GCP Instance Sizes + type: string + title: GCP + type: object + GCPCreateDataProcessRegionView: + allOf: + - $ref: '#/components/schemas/CreateDataProcessRegionView' + - properties: + region: + description: Human-readable label that identifies the geographic location of the region where you wish to store your archived data. + enum: + - CENTRAL_US + - WESTERN_EUROPE + type: string + type: object + type: object + GCPDataProcessRegionView: + allOf: + - $ref: '#/components/schemas/DataProcessRegionView' + - properties: + region: + description: Human-readable label that identifies the geographic location of the region where you store your archived data. + enum: + - CENTRAL_US + - WESTERN_EUROPE + readOnly: true + type: string + type: object + type: object + GCPHardwareSpec: + properties: + instanceSize: + description: Hardware specification for the instance sizes in this region. Each instance size has a default storage and memory capacity. The instance size you select applies to all the data-bearing hosts of the node type. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M140 + - M200 + - M250 + - M300 + - M400 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - R600 + title: GCP Instance Sizes + type: string + nodeCount: + description: Number of nodes of the given type for MongoDB Cloud to deploy to the region. + format: int32 + type: integer + type: object + GCPHardwareSpec20240805: + properties: + diskSizeGB: + description: |- + Storage capacity of instance data volumes expressed in gigabytes. Increase this number to add capacity. + + This value must be equal for all shards and node types. + + This value is not configurable on M0/M2/M5 clusters. + + MongoDB Cloud requires this parameter if you set **replicationSpecs**. + + If you specify a disk size below the minimum (10 GB), this parameter defaults to the minimum disk size value. + + Storage charge calculations depend on whether you choose the default value or a custom value. + + The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require more storage space, consider upgrading your cluster to a higher tier. + format: double + maximum: 4096 + minimum: 10 + type: number + instanceSize: + description: Hardware specification for the instance sizes in this region in this shard. Each instance size has a default storage and memory capacity. Electable nodes and read-only nodes (known as "base nodes") within a single shard must use the same instance size. Analytics nodes can scale independently from base nodes within a shard. Both base nodes and analytics nodes can scale independently from their equivalents in other shards. + enum: + - M10 + - M20 + - M30 + - M40 + - M50 + - M60 + - M80 + - M140 + - M200 + - M250 + - M300 + - M400 + - R40 + - R50 + - R60 + - R80 + - R200 + - R300 + - R400 + - R600 + title: GCP Instance Sizes + type: string + nodeCount: + description: Number of nodes of the given type for MongoDB Cloud to deploy to the region. + format: int32 + type: integer + type: object + GCPRegionConfig: + allOf: + - $ref: '#/components/schemas/CloudRegionConfig' + - properties: + analyticsAutoScaling: + $ref: '#/components/schemas/AdvancedAutoScalingSettings' + analyticsSpecs: + $ref: '#/components/schemas/DedicatedHardwareSpec' + autoScaling: + $ref: '#/components/schemas/AdvancedAutoScalingSettings' + readOnlySpecs: + $ref: '#/components/schemas/DedicatedHardwareSpec' + type: object + description: Details that explain how MongoDB Cloud replicates data in one region on the specified MongoDB database. + title: GCP Regional Replication Specifications + type: object + GCPRegionConfig20240805: + allOf: + - $ref: '#/components/schemas/CloudRegionConfig20240805' + - properties: + analyticsAutoScaling: + $ref: '#/components/schemas/AdvancedAutoScalingSettings' + analyticsSpecs: + $ref: '#/components/schemas/DedicatedHardwareSpec20240805' + autoScaling: + $ref: '#/components/schemas/AdvancedAutoScalingSettings' + readOnlySpecs: + $ref: '#/components/schemas/DedicatedHardwareSpec20240805' + type: object + description: Details that explain how MongoDB Cloud replicates data in one region on the specified MongoDB database. + title: GCP Regional Replication Specifications + type: object + GroupRoleAssignment: + properties: + groupId: + description: Unique 24-hexadecimal digit string that identifies the project to which these roles belong. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + groupRoles: + description: One or more project level roles assigned to the MongoDB Cloud user. + items: + enum: + - GROUP_OWNER + - GROUP_CLUSTER_MANAGER + - GROUP_STREAM_PROCESSING_OWNER + - GROUP_DATA_ACCESS_ADMIN + - GROUP_DATA_ACCESS_READ_WRITE + - GROUP_DATA_ACCESS_READ_ONLY + - GROUP_READ_ONLY + - GROUP_SEARCH_INDEX_EDITOR + type: string + type: array + uniqueItems: true + type: object + HardwareSpec: + description: Hardware specifications for all electable nodes deployed in the region. Electable nodes can become the primary and can enable local reads. If you don't specify this option, MongoDB Cloud deploys no electable nodes to the region. + oneOf: + - $ref: '#/components/schemas/AWSHardwareSpec' + - $ref: '#/components/schemas/AzureHardwareSpec' + - $ref: '#/components/schemas/GCPHardwareSpec' + - $ref: '#/components/schemas/TenantHardwareSpec' + type: object + HardwareSpec20240805: + description: Hardware specifications for all electable nodes deployed in the region. Electable nodes can become the primary and can enable local reads. If you don't specify this option, MongoDB Cloud deploys no electable nodes to the region. + oneOf: + - $ref: '#/components/schemas/AWSHardwareSpec20240805' + - $ref: '#/components/schemas/AzureHardwareSpec20240805' + - $ref: '#/components/schemas/GCPHardwareSpec20240805' + - $ref: '#/components/schemas/TenantHardwareSpec20240805' + properties: + diskSizeGB: + description: |- + Storage capacity of instance data volumes expressed in gigabytes. Increase this number to add capacity. + + This value must be equal for all shards and node types. + + This value is not configurable on M0/M2/M5 clusters. + + MongoDB Cloud requires this parameter if you set **replicationSpecs**. + + If you specify a disk size below the minimum (10 GB), this parameter defaults to the minimum disk size value. + + Storage charge calculations depend on whether you choose the default value or a custom value. + + The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require more storage space, consider upgrading your cluster to a higher tier. + format: double + maximum: 4096 + minimum: 10 + type: number + type: object + IngestionSink: + description: Ingestion destination of a Data Lake Pipeline. + discriminator: + mapping: + DLS: '#/components/schemas/DLSIngestionSink' + propertyName: type + properties: + type: + description: Type of ingestion destination of this Data Lake Pipeline. + enum: + - DLS + readOnly: true + type: string + title: Ingestion Destination + type: object + IngestionSource: + description: Ingestion Source of a Data Lake Pipeline. + discriminator: + mapping: + ON_DEMAND_CPS: '#/components/schemas/OnDemandCpsSnapshotSource' + PERIODIC_CPS: '#/components/schemas/PeriodicCpsSnapshotSource' + propertyName: type + oneOf: + - $ref: '#/components/schemas/OnDemandCpsSnapshotSource' + - $ref: '#/components/schemas/PeriodicCpsSnapshotSource' + properties: + type: + description: Type of ingestion source of this Data Lake Pipeline. + enum: + - PERIODIC_CPS + - ON_DEMAND_CPS + type: string + title: Ingestion Source + type: object + InvoiceLineItem: + description: One service included in this invoice. + properties: + clusterName: + description: Human-readable label that identifies the cluster that incurred the charge. + maxLength: 64 + minLength: 1 + pattern: ^([a-zA-Z0-9][a-zA-Z0-9-]*)?[a-zA-Z0-9]+$ + readOnly: true + type: string + created: + description: Date and time when MongoDB Cloud created this line item. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + discountCents: + description: Sum by which MongoDB discounted this line item. MongoDB Cloud expresses this value in cents (100ths of one US Dollar). The resource returns this parameter when a discount applies. + format: int64 + readOnly: true + type: integer + endDate: + description: Date and time when when MongoDB Cloud finished charging for this line item. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + groupId: + description: Unique 24-hexadecimal digit string that identifies the project associated to this line item. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + groupName: + description: Human-readable label that identifies the project. + type: string + note: + description: Comment that applies to this line item. + readOnly: true + type: string + percentDiscount: + description: Percentage by which MongoDB discounted this line item. The resource returns this parameter when a discount applies. + format: float + readOnly: true + type: number + quantity: + description: Number of units included for the line item. These can be expressions of storage (GB), time (hours), or other units. + format: double + readOnly: true + type: number + sku: + description: Human-readable description of the service that this line item provided. This Stock Keeping Unit (SKU) could be the instance type, a support charge, advanced security, or another service. + enum: + - CLASSIC_BACKUP_OPLOG + - CLASSIC_BACKUP_STORAGE + - CLASSIC_BACKUP_SNAPSHOT_CREATE + - CLASSIC_BACKUP_DAILY_MINIMUM + - CLASSIC_BACKUP_FREE_TIER + - CLASSIC_COUPON + - BACKUP_STORAGE_FREE_TIER + - BACKUP_STORAGE + - FLEX_CONSULTING + - CLOUD_MANAGER_CLASSIC + - CLOUD_MANAGER_BASIC_FREE_TIER + - CLOUD_MANAGER_BASIC + - CLOUD_MANAGER_PREMIUM + - CLOUD_MANAGER_FREE_TIER + - CLOUD_MANAGER_STANDARD_FREE_TIER + - CLOUD_MANAGER_STANDARD_ANNUAL + - CLOUD_MANAGER_STANDARD + - CLOUD_MANAGER_FREE_TRIAL + - ATLAS_INSTANCE_M0 + - ATLAS_INSTANCE_M2 + - ATLAS_INSTANCE_M5 + - ATLAS_AWS_INSTANCE_M10 + - ATLAS_AWS_INSTANCE_M20 + - ATLAS_AWS_INSTANCE_M30 + - ATLAS_AWS_INSTANCE_M40 + - ATLAS_AWS_INSTANCE_M50 + - ATLAS_AWS_INSTANCE_M60 + - ATLAS_AWS_INSTANCE_M80 + - ATLAS_AWS_INSTANCE_M100 + - ATLAS_AWS_INSTANCE_M140 + - ATLAS_AWS_INSTANCE_M200 + - ATLAS_AWS_INSTANCE_M300 + - ATLAS_AWS_INSTANCE_M40_LOW_CPU + - ATLAS_AWS_INSTANCE_M50_LOW_CPU + - ATLAS_AWS_INSTANCE_M60_LOW_CPU + - ATLAS_AWS_INSTANCE_M80_LOW_CPU + - ATLAS_AWS_INSTANCE_M200_LOW_CPU + - ATLAS_AWS_INSTANCE_M300_LOW_CPU + - ATLAS_AWS_INSTANCE_M400_LOW_CPU + - ATLAS_AWS_INSTANCE_M700_LOW_CPU + - ATLAS_AWS_INSTANCE_M40_NVME + - ATLAS_AWS_INSTANCE_M50_NVME + - ATLAS_AWS_INSTANCE_M60_NVME + - ATLAS_AWS_INSTANCE_M80_NVME + - ATLAS_AWS_INSTANCE_M200_NVME + - ATLAS_AWS_INSTANCE_M400_NVME + - ATLAS_AWS_INSTANCE_M10_PAUSED + - ATLAS_AWS_INSTANCE_M20_PAUSED + - ATLAS_AWS_INSTANCE_M30_PAUSED + - ATLAS_AWS_INSTANCE_M40_PAUSED + - ATLAS_AWS_INSTANCE_M50_PAUSED + - ATLAS_AWS_INSTANCE_M60_PAUSED + - ATLAS_AWS_INSTANCE_M80_PAUSED + - ATLAS_AWS_INSTANCE_M100_PAUSED + - ATLAS_AWS_INSTANCE_M140_PAUSED + - ATLAS_AWS_INSTANCE_M200_PAUSED + - ATLAS_AWS_INSTANCE_M300_PAUSED + - ATLAS_AWS_INSTANCE_M40_LOW_CPU_PAUSED + - ATLAS_AWS_INSTANCE_M50_LOW_CPU_PAUSED + - ATLAS_AWS_INSTANCE_M60_LOW_CPU_PAUSED + - ATLAS_AWS_INSTANCE_M80_LOW_CPU_PAUSED + - ATLAS_AWS_INSTANCE_M200_LOW_CPU_PAUSED + - ATLAS_AWS_INSTANCE_M300_LOW_CPU_PAUSED + - ATLAS_AWS_INSTANCE_M400_LOW_CPU_PAUSED + - ATLAS_AWS_INSTANCE_M700_LOW_CPU_PAUSED + - ATLAS_AWS_SEARCH_INSTANCE_S20_COMPUTE_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S30_COMPUTE_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S40_COMPUTE_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S50_COMPUTE_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S60_COMPUTE_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S70_COMPUTE_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S80_COMPUTE_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S30_MEMORY_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S40_MEMORY_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S50_MEMORY_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S60_MEMORY_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S80_MEMORY_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S90_MEMORY_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S100_MEMORY_NVME + - ATLAS_AWS_SEARCH_INSTANCE_S110_MEMORY_NVME + - ATLAS_AWS_STORAGE_PROVISIONED + - ATLAS_AWS_STORAGE_STANDARD + - ATLAS_AWS_STORAGE_STANDARD_GP3 + - ATLAS_AWS_STORAGE_IOPS + - ATLAS_AWS_DATA_TRANSFER_SAME_REGION + - ATLAS_AWS_DATA_TRANSFER_DIFFERENT_REGION + - ATLAS_AWS_DATA_TRANSFER_INTERNET + - ATLAS_AWS_BACKUP_SNAPSHOT_STORAGE + - ATLAS_AWS_BACKUP_DOWNLOAD_VM + - ATLAS_AWS_BACKUP_DOWNLOAD_VM_STORAGE + - ATLAS_AWS_BACKUP_DOWNLOAD_VM_STORAGE_IOPS + - ATLAS_AWS_PRIVATE_ENDPOINT + - ATLAS_AWS_PRIVATE_ENDPOINT_CAPACITY_UNITS + - ATLAS_GCP_SEARCH_INSTANCE_S20_COMPUTE_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S30_COMPUTE_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S40_COMPUTE_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S50_COMPUTE_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S60_COMPUTE_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S70_COMPUTE_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S80_COMPUTE_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S30_MEMORY_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S40_MEMORY_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S50_MEMORY_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S60_MEMORY_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S70_MEMORY_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S80_MEMORY_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S90_MEMORY_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S100_MEMORY_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S110_MEMORY_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S120_MEMORY_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S130_MEMORY_LOCALSSD + - ATLAS_GCP_SEARCH_INSTANCE_S140_MEMORY_LOCALSSD + - ATLAS_GCP_INSTANCE_M10 + - ATLAS_GCP_INSTANCE_M20 + - ATLAS_GCP_INSTANCE_M30 + - ATLAS_GCP_INSTANCE_M40 + - ATLAS_GCP_INSTANCE_M50 + - ATLAS_GCP_INSTANCE_M60 + - ATLAS_GCP_INSTANCE_M80 + - ATLAS_GCP_INSTANCE_M140 + - ATLAS_GCP_INSTANCE_M200 + - ATLAS_GCP_INSTANCE_M250 + - ATLAS_GCP_INSTANCE_M300 + - ATLAS_GCP_INSTANCE_M400 + - ATLAS_GCP_INSTANCE_M40_LOW_CPU + - ATLAS_GCP_INSTANCE_M50_LOW_CPU + - ATLAS_GCP_INSTANCE_M60_LOW_CPU + - ATLAS_GCP_INSTANCE_M80_LOW_CPU + - ATLAS_GCP_INSTANCE_M200_LOW_CPU + - ATLAS_GCP_INSTANCE_M300_LOW_CPU + - ATLAS_GCP_INSTANCE_M400_LOW_CPU + - ATLAS_GCP_INSTANCE_M600_LOW_CPU + - ATLAS_GCP_INSTANCE_M10_PAUSED + - ATLAS_GCP_INSTANCE_M20_PAUSED + - ATLAS_GCP_INSTANCE_M30_PAUSED + - ATLAS_GCP_INSTANCE_M40_PAUSED + - ATLAS_GCP_INSTANCE_M50_PAUSED + - ATLAS_GCP_INSTANCE_M60_PAUSED + - ATLAS_GCP_INSTANCE_M80_PAUSED + - ATLAS_GCP_INSTANCE_M140_PAUSED + - ATLAS_GCP_INSTANCE_M200_PAUSED + - ATLAS_GCP_INSTANCE_M250_PAUSED + - ATLAS_GCP_INSTANCE_M300_PAUSED + - ATLAS_GCP_INSTANCE_M400_PAUSED + - ATLAS_GCP_INSTANCE_M40_LOW_CPU_PAUSED + - ATLAS_GCP_INSTANCE_M50_LOW_CPU_PAUSED + - ATLAS_GCP_INSTANCE_M60_LOW_CPU_PAUSED + - ATLAS_GCP_INSTANCE_M80_LOW_CPU_PAUSED + - ATLAS_GCP_INSTANCE_M200_LOW_CPU_PAUSED + - ATLAS_GCP_INSTANCE_M300_LOW_CPU_PAUSED + - ATLAS_GCP_INSTANCE_M400_LOW_CPU_PAUSED + - ATLAS_GCP_INSTANCE_M600_LOW_CPU_PAUSED + - ATLAS_GCP_DATA_TRANSFER_INTERNET + - ATLAS_GCP_STORAGE_SSD + - ATLAS_GCP_DATA_TRANSFER_INTER_CONNECT + - ATLAS_GCP_DATA_TRANSFER_INTER_ZONE + - ATLAS_GCP_DATA_TRANSFER_INTER_REGION + - ATLAS_GCP_DATA_TRANSFER_GOOGLE + - ATLAS_GCP_BACKUP_SNAPSHOT_STORAGE + - ATLAS_GCP_BACKUP_DOWNLOAD_VM + - ATLAS_GCP_BACKUP_DOWNLOAD_VM_STORAGE + - ATLAS_GCP_PRIVATE_ENDPOINT + - ATLAS_GCP_PRIVATE_ENDPOINT_CAPACITY_UNITS + - ATLAS_GCP_SNAPSHOT_COPY_DATA_TRANSFER + - ATLAS_AZURE_INSTANCE_M10 + - ATLAS_AZURE_INSTANCE_M20 + - ATLAS_AZURE_INSTANCE_M30 + - ATLAS_AZURE_INSTANCE_M40 + - ATLAS_AZURE_INSTANCE_M50 + - ATLAS_AZURE_INSTANCE_M60 + - ATLAS_AZURE_INSTANCE_M80 + - ATLAS_AZURE_INSTANCE_M90 + - ATLAS_AZURE_INSTANCE_M200 + - ATLAS_AZURE_INSTANCE_R40 + - ATLAS_AZURE_INSTANCE_R50 + - ATLAS_AZURE_INSTANCE_R60 + - ATLAS_AZURE_INSTANCE_R80 + - ATLAS_AZURE_INSTANCE_R200 + - ATLAS_AZURE_INSTANCE_R300 + - ATLAS_AZURE_INSTANCE_R400 + - ATLAS_AZURE_INSTANCE_M60_NVME + - ATLAS_AZURE_INSTANCE_M80_NVME + - ATLAS_AZURE_INSTANCE_M200_NVME + - ATLAS_AZURE_INSTANCE_M300_NVME + - ATLAS_AZURE_INSTANCE_M400_NVME + - ATLAS_AZURE_INSTANCE_M600_NVME + - ATLAS_AZURE_INSTANCE_M10_PAUSED + - ATLAS_AZURE_INSTANCE_M20_PAUSED + - ATLAS_AZURE_INSTANCE_M30_PAUSED + - ATLAS_AZURE_INSTANCE_M40_PAUSED + - ATLAS_AZURE_INSTANCE_M50_PAUSED + - ATLAS_AZURE_INSTANCE_M60_PAUSED + - ATLAS_AZURE_INSTANCE_M80_PAUSED + - ATLAS_AZURE_INSTANCE_M90_PAUSED + - ATLAS_AZURE_INSTANCE_M200_PAUSED + - ATLAS_AZURE_INSTANCE_R40_PAUSED + - ATLAS_AZURE_INSTANCE_R50_PAUSED + - ATLAS_AZURE_INSTANCE_R60_PAUSED + - ATLAS_AZURE_INSTANCE_R80_PAUSED + - ATLAS_AZURE_INSTANCE_R200_PAUSED + - ATLAS_AZURE_INSTANCE_R300_PAUSED + - ATLAS_AZURE_INSTANCE_R400_PAUSED + - ATLAS_AZURE_SEARCH_INSTANCE_S20_COMPUTE_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S30_COMPUTE_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S40_COMPUTE_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S50_COMPUTE_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S60_COMPUTE_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S70_COMPUTE_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S80_COMPUTE_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S40_MEMORY_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S50_MEMORY_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S60_MEMORY_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S80_MEMORY_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S90_MEMORY_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S100_MEMORY_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S110_MEMORY_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S130_MEMORY_LOCALSSD + - ATLAS_AZURE_SEARCH_INSTANCE_S135_MEMORY_LOCALSSD + - ATLAS_AZURE_STORAGE_P2 + - ATLAS_AZURE_STORAGE_P3 + - ATLAS_AZURE_STORAGE_P4 + - ATLAS_AZURE_STORAGE_P6 + - ATLAS_AZURE_STORAGE_P10 + - ATLAS_AZURE_STORAGE_P15 + - ATLAS_AZURE_STORAGE_P20 + - ATLAS_AZURE_STORAGE_P30 + - ATLAS_AZURE_STORAGE_P40 + - ATLAS_AZURE_STORAGE_P50 + - ATLAS_AZURE_DATA_TRANSFER + - ATLAS_AZURE_DATA_TRANSFER_REGIONAL_VNET_IN + - ATLAS_AZURE_DATA_TRANSFER_REGIONAL_VNET_OUT + - ATLAS_AZURE_DATA_TRANSFER_GLOBAL_VNET_IN + - ATLAS_AZURE_DATA_TRANSFER_GLOBAL_VNET_OUT + - ATLAS_AZURE_DATA_TRANSFER_AVAILABILITY_ZONE_IN + - ATLAS_AZURE_DATA_TRANSFER_AVAILABILITY_ZONE_OUT + - ATLAS_AZURE_DATA_TRANSFER_INTER_REGION_INTRA_CONTINENT + - ATLAS_AZURE_DATA_TRANSFER_INTER_REGION_INTER_CONTINENT + - ATLAS_AZURE_BACKUP_SNAPSHOT_STORAGE + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM_STORAGE_P2 + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM_STORAGE_P3 + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM_STORAGE_P4 + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM_STORAGE_P6 + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM_STORAGE_P10 + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM_STORAGE_P15 + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM_STORAGE_P20 + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM_STORAGE_P30 + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM_STORAGE_P40 + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM_STORAGE_P50 + - ATLAS_AZURE_STANDARD_STORAGE + - ATLAS_AZURE_EXTENDED_STANDARD_IOPS + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM_STORAGE + - ATLAS_AZURE_BACKUP_DOWNLOAD_VM_STORAGE_EXTENDED_IOPS + - ATLAS_AZURE_SNAPSHOT_EXPORT_VM_STORAGE + - ATLAS_AZURE_SNAPSHOT_EXPORT_VM_STORAGE_EXTENDED_IOPS + - ATLAS_BI_CONNECTOR + - ATLAS_ADVANCED_SECURITY + - ATLAS_ENTERPRISE_AUDITING + - ATLAS_FREE_SUPPORT + - ATLAS_SUPPORT + - STITCH_DATA_DOWNLOADED_FREE_TIER + - STITCH_DATA_DOWNLOADED + - STITCH_COMPUTE_FREE_TIER + - STITCH_COMPUTE + - CREDIT + - MINIMUM_CHARGE + - CHARTS_DATA_DOWNLOADED_FREE_TIER + - CHARTS_DATA_DOWNLOADED + - ATLAS_DATA_LAKE_AWS_DATA_RETURNED_SAME_REGION + - ATLAS_DATA_LAKE_AWS_DATA_RETURNED_DIFFERENT_REGION + - ATLAS_DATA_LAKE_AWS_DATA_RETURNED_INTERNET + - ATLAS_DATA_LAKE_AWS_DATA_SCANNED + - ATLAS_DATA_LAKE_AWS_DATA_TRANSFERRED_FROM_DIFFERENT_REGION + - ATLAS_NDS_AWS_DATA_LAKE_STORAGE_ACCESS + - ATLAS_NDS_AWS_DATA_LAKE_STORAGE + - ATLAS_DATA_FEDERATION_AZURE_DATA_RETURNED_SAME_REGION + - ATLAS_DATA_FEDERATION_AZURE_DATA_RETURNED_SAME_CONTINENT + - ATLAS_DATA_FEDERATION_AZURE_DATA_RETURNED_DIFFERENT_CONTINENT + - ATLAS_DATA_FEDERATION_AZURE_DATA_RETURNED_INTERNET + - ATLAS_DATA_FEDERATION_GCP_DATA_RETURNED_SAME_REGION + - ATLAS_DATA_FEDERATION_GCP_DATA_RETURNED_DIFFERENT_REGION + - ATLAS_DATA_FEDERATION_GCP_DATA_RETURNED_INTERNET + - ATLAS_DATA_FEDERATION_AZURE_DATA_SCANNED + - ATLAS_NDS_AZURE_DATA_LAKE_STORAGE_ACCESS + - ATLAS_NDS_AZURE_DATA_LAKE_STORAGE + - ATLAS_DATA_FEDERATION_GCP_DATA_SCANNED + - ATLAS_NDS_GCP_DATA_LAKE_STORAGE_ACCESS + - ATLAS_NDS_GCP_DATA_LAKE_STORAGE + - ATLAS_NDS_AWS_OBJECT_STORAGE_ACCESS + - ATLAS_NDS_AWS_COMPRESSED_OBJECT_STORAGE + - ATLAS_NDS_AZURE_OBJECT_STORAGE_ACCESS + - ATLAS_NDS_AZURE_OBJECT_STORAGE + - ATLAS_NDS_AZURE_COMPRESSED_OBJECT_STORAGE + - ATLAS_NDS_GCP_OBJECT_STORAGE_ACCESS + - ATLAS_NDS_GCP_OBJECT_STORAGE + - ATLAS_NDS_GCP_COMPRESSED_OBJECT_STORAGE + - ATLAS_ARCHIVE_ACCESS_PARTITION_LOCATE + - ATLAS_NDS_AWS_PIT_RESTORE_STORAGE_FREE_TIER + - ATLAS_NDS_AWS_PIT_RESTORE_STORAGE + - ATLAS_NDS_GCP_PIT_RESTORE_STORAGE_FREE_TIER + - ATLAS_NDS_GCP_PIT_RESTORE_STORAGE + - ATLAS_NDS_AZURE_PIT_RESTORE_STORAGE_FREE_TIER + - ATLAS_NDS_AZURE_PIT_RESTORE_STORAGE + - ATLAS_NDS_AZURE_PRIVATE_ENDPOINT_CAPACITY_UNITS + - ATLAS_NDS_AWS_OBJECT_STORAGE + - ATLAS_NDS_AWS_SNAPSHOT_EXPORT_UPLOAD + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_UPLOAD + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_M40 + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_M50 + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_M60 + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_STORAGE_P2 + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_STORAGE_P3 + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_STORAGE_P4 + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_STORAGE_P6 + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_STORAGE_P10 + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_STORAGE_P15 + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_STORAGE_P20 + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_STORAGE_P30 + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_STORAGE_P40 + - ATLAS_NDS_AZURE_SNAPSHOT_EXPORT_VM_STORAGE_P50 + - ATLAS_NDS_AWS_SNAPSHOT_EXPORT_VM + - ATLAS_NDS_AWS_SNAPSHOT_EXPORT_VM_M40 + - ATLAS_NDS_AWS_SNAPSHOT_EXPORT_VM_M50 + - ATLAS_NDS_AWS_SNAPSHOT_EXPORT_VM_M60 + - ATLAS_NDS_AWS_SNAPSHOT_EXPORT_VM_STORAGE + - ATLAS_NDS_AWS_SNAPSHOT_EXPORT_VM_STORAGE_IOPS + - ATLAS_NDS_GCP_SNAPSHOT_EXPORT_VM + - ATLAS_NDS_GCP_SNAPSHOT_EXPORT_VM_M40 + - ATLAS_NDS_GCP_SNAPSHOT_EXPORT_VM_M50 + - ATLAS_NDS_GCP_SNAPSHOT_EXPORT_VM_M60 + - ATLAS_NDS_GCP_SNAPSHOT_EXPORT_VM_STORAGE + - ATLAS_NDS_AWS_SERVERLESS_RPU + - ATLAS_NDS_AWS_SERVERLESS_WPU + - ATLAS_NDS_AWS_SERVERLESS_STORAGE + - ATLAS_NDS_AWS_SERVERLESS_CONTINUOUS_BACKUP + - ATLAS_NDS_AWS_SERVERLESS_BACKUP_RESTORE_VM + - ATLAS_NDS_AWS_SERVERLESS_DATA_TRANSFER_PREVIEW + - ATLAS_NDS_AWS_SERVERLESS_DATA_TRANSFER + - ATLAS_NDS_AWS_SERVERLESS_DATA_TRANSFER_REGIONAL + - ATLAS_NDS_AWS_SERVERLESS_DATA_TRANSFER_CROSS_REGION + - ATLAS_NDS_AWS_SERVERLESS_DATA_TRANSFER_INTERNET + - ATLAS_NDS_GCP_SERVERLESS_RPU + - ATLAS_NDS_GCP_SERVERLESS_WPU + - ATLAS_NDS_GCP_SERVERLESS_STORAGE + - ATLAS_NDS_GCP_SERVERLESS_CONTINUOUS_BACKUP + - ATLAS_NDS_GCP_SERVERLESS_BACKUP_RESTORE_VM + - ATLAS_NDS_GCP_SERVERLESS_DATA_TRANSFER_PREVIEW + - ATLAS_NDS_GCP_SERVERLESS_DATA_TRANSFER + - ATLAS_NDS_GCP_SERVERLESS_DATA_TRANSFER_REGIONAL + - ATLAS_NDS_GCP_SERVERLESS_DATA_TRANSFER_CROSS_REGION + - ATLAS_NDS_GCP_SERVERLESS_DATA_TRANSFER_INTERNET + - ATLAS_NDS_AZURE_SERVERLESS_RPU + - ATLAS_NDS_AZURE_SERVERLESS_WPU + - ATLAS_NDS_AZURE_SERVERLESS_STORAGE + - ATLAS_NDS_AZURE_SERVERLESS_CONTINUOUS_BACKUP + - ATLAS_NDS_AZURE_SERVERLESS_BACKUP_RESTORE_VM + - ATLAS_NDS_AZURE_SERVERLESS_DATA_TRANSFER_PREVIEW + - ATLAS_NDS_AZURE_SERVERLESS_DATA_TRANSFER + - ATLAS_NDS_AZURE_SERVERLESS_DATA_TRANSFER_REGIONAL + - ATLAS_NDS_AZURE_SERVERLESS_DATA_TRANSFER_CROSS_REGION + - ATLAS_NDS_AZURE_SERVERLESS_DATA_TRANSFER_INTERNET + - REALM_APP_REQUESTS_FREE_TIER + - REALM_APP_REQUESTS + - REALM_APP_COMPUTE_FREE_TIER + - REALM_APP_COMPUTE + - REALM_APP_SYNC_FREE_TIER + - REALM_APP_SYNC + - REALM_APP_DATA_TRANSFER_FREE_TIER + - REALM_APP_DATA_TRANSFER + - GCP_SNAPSHOT_COPY_DISK + - ATLAS_AWS_STREAM_PROCESSING_INSTANCE_SP10 + - ATLAS_AWS_STREAM_PROCESSING_INSTANCE_SP30 + - ATLAS_AWS_STREAM_PROCESSING_INSTANCE_SP50 + - ATLAS_AZURE_STREAM_PROCESSING_INSTANCE_SP10 + - ATLAS_AZURE_STREAM_PROCESSING_INSTANCE_SP30 + - ATLAS_AZURE_STREAM_PROCESSING_INSTANCE_SP50 + - ATLAS_AWS_STREAM_PROCESSING_DATA_TRANSFER + - ATLAS_AZURE_STREAM_PROCESSING_DATA_TRANSFER + - ATLAS_AWS_STREAM_PROCESSING_VPC_PEERING + - ATLAS_AZURE_STREAM_PROCESSING_PRIVATELINK + - ATLAS_AWS_STREAM_PROCESSING_PRIVATELINK + - ATLAS_FLEX_AWS_100_USAGE_HOURS + - ATLAS_FLEX_AWS_200_USAGE_HOURS + - ATLAS_FLEX_AWS_300_USAGE_HOURS + - ATLAS_FLEX_AWS_400_USAGE_HOURS + - ATLAS_FLEX_AWS_500_USAGE_HOURS + - ATLAS_FLEX_AZURE_100_USAGE_HOURS + - ATLAS_FLEX_AZURE_200_USAGE_HOURS + - ATLAS_FLEX_AZURE_300_USAGE_HOURS + - ATLAS_FLEX_AZURE_400_USAGE_HOURS + - ATLAS_FLEX_AZURE_500_USAGE_HOURS + - ATLAS_FLEX_GCP_100_USAGE_HOURS + - ATLAS_FLEX_GCP_200_USAGE_HOURS + - ATLAS_FLEX_GCP_300_USAGE_HOURS + - ATLAS_FLEX_GCP_400_USAGE_HOURS + - ATLAS_FLEX_GCP_500_USAGE_HOURS + readOnly: true + type: string + startDate: + description: Date and time when MongoDB Cloud began charging for this line item. This parameter expresses its value in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + stitchAppName: + description: Human-readable label that identifies the Atlas App Services application associated with this line item. + externalDocs: + description: Create a new Atlas App Service + url: https://www.mongodb.com/docs/atlas/app-services/manage-apps/create/create-with-ui/ + readOnly: true + type: string + tags: + additionalProperties: + description: A map of key-value pairs corresponding to the tags associated with the line item resource. + items: + description: A map of key-value pairs corresponding to the tags associated with the line item resource. + readOnly: true + type: string + readOnly: true + type: array + description: A map of key-value pairs corresponding to the tags associated with the line item resource. + readOnly: true + type: object + tierLowerBound: + description: |- + Lower bound for usage amount range in current SKU tier. + + **NOTE**: **lineItems[n].tierLowerBound** appears only if your **lineItems[n].sku** is tiered. + format: double + readOnly: true + type: number + tierUpperBound: + description: |- + Upper bound for usage amount range in current SKU tier. + + **NOTE**: **lineItems[n].tierUpperBound** appears only if your **lineItems[n].sku** is tiered. + format: double + readOnly: true + type: number + totalPriceCents: + description: Sum of the cost set for this line item. MongoDB Cloud expresses this value in cents (100ths of one US Dollar) and calculates this value as **unitPriceDollars** × **quantity** × 100. + format: int64 + readOnly: true + type: integer + unit: + description: Element used to express what **quantity** this line item measures. This value can be elements of time, storage capacity, and the like. + readOnly: true + type: string + unitPriceDollars: + description: Value per **unit** for this line item expressed in US Dollars. + format: double + readOnly: true + type: number + title: Line Item + type: object + LegacyAtlasCluster: + description: Group of settings that configure a MongoDB cluster. + properties: + acceptDataRisksAndForceReplicaSetReconfig: + description: If reconfiguration is necessary to regain a primary due to a regional outage, submit this field alongside your topology reconfiguration to request a new regional outage resistant topology. Forced reconfigurations during an outage of the majority of electable nodes carry a risk of data loss if replicated writes (even majority committed writes) have not been replicated to the new primary node. MongoDB Atlas docs contain more information. To proceed with an operation which carries that risk, set **acceptDataRisksAndForceReplicaSetReconfig** to the current date. + externalDocs: + description: Reconfiguring a Replica Set during a regional outage + url: https://dochub.mongodb.org/core/regional-outage-reconfigure-replica-set + format: date-time + type: string + autoScaling: + $ref: '#/components/schemas/ClusterAutoScalingSettings' + backupEnabled: + description: Flag that indicates whether the cluster can perform backups. If set to `true`, the cluster can perform backups. You must set this value to `true` for NVMe clusters. Backup uses Cloud Backups for dedicated clusters and Shared Cluster Backups for tenant clusters. If set to `false`, the cluster doesn't use MongoDB Cloud backups. + type: boolean + biConnector: + $ref: '#/components/schemas/BiConnector' + clusterType: + description: Configuration of nodes that comprise the cluster. + enum: + - REPLICASET + - SHARDED + - GEOSHARDED + type: string + configServerManagementMode: + default: ATLAS_MANAGED + description: |- + Config Server Management Mode for creating or updating a sharded cluster. + + When configured as ATLAS_MANAGED, atlas may automatically switch the cluster's config server type for optimal performance and savings. + + When configured as FIXED_TO_DEDICATED, the cluster will always use a dedicated config server. + enum: + - ATLAS_MANAGED + - FIXED_TO_DEDICATED + externalDocs: + description: MongoDB Sharded Cluster Config Servers + url: https://dochub.mongodb.org/docs/manual/core/sharded-cluster-config-servers + type: string + configServerType: + description: Describes a sharded cluster's config server type. + enum: + - DEDICATED + - EMBEDDED + externalDocs: + description: MongoDB Sharded Cluster Config Servers + url: https://dochub.mongodb.org/docs/manual/core/sharded-cluster-config-servers + readOnly: true + type: string + connectionStrings: + $ref: '#/components/schemas/ClusterConnectionStrings' + createDate: + description: Date and time when MongoDB Cloud created this serverless instance. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC. + format: date-time + readOnly: true + type: string + diskSizeGB: + description: |- + Storage capacity of instance data volumes expressed in gigabytes. Increase this number to add capacity. + + This value is not configurable on M0/M2/M5 clusters. + + MongoDB Cloud requires this parameter if you set **replicationSpecs**. + + If you specify a disk size below the minimum (10 GB), this parameter defaults to the minimum disk size value. + + Storage charge calculations depend on whether you choose the default value or a custom value. + + The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require more storage space, consider upgrading your cluster to a higher tier. + format: double + maximum: 4096 + minimum: 10 + type: number + diskWarmingMode: + default: FULLY_WARMED + description: Disk warming mode selection. + enum: + - FULLY_WARMED + - VISIBLE_EARLIER + externalDocs: + description: Reduce Secondary Disk Warming Impact + url: https://docs.atlas.mongodb.com/reference/replica-set-tags/#reduce-secondary-disk-warming-impact + type: string + encryptionAtRestProvider: + description: Cloud service provider that manages your customer keys to provide an additional layer of Encryption at Rest for the cluster. + enum: + - NONE + - AWS + - AZURE + - GCP + externalDocs: + description: Encryption at Rest using Customer Key Management + url: https://www.mongodb.com/docs/atlas/security-kms-encryption/ + type: string + featureCompatibilityVersion: + description: Feature compatibility version of the cluster. + readOnly: true + type: string + featureCompatibilityVersionExpirationDate: + description: Feature compatibility version expiration date. + format: date-time + readOnly: true + type: string + globalClusterSelfManagedSharding: + description: |- + Set this field to configure the Sharding Management Mode when creating a new Global Cluster. + + When set to false, the management mode is set to Atlas-Managed Sharding. This mode fully manages the sharding of your Global Cluster and is built to provide a seamless deployment experience. + + When set to true, the management mode is set to Self-Managed Sharding. This mode leaves the management of shards in your hands and is built to provide an advanced and flexible deployment experience. + + This setting cannot be changed once the cluster is deployed. + externalDocs: + description: Creating a Global Cluster + url: https://dochub.mongodb.org/core/global-cluster-management + type: boolean + groupId: + description: Unique 24-hexadecimal character string that identifies the project. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + id: + description: Unique 24-hexadecimal digit string that identifies the cluster. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + labels: + deprecated: true + description: |- + Collection of key-value pairs between 1 to 255 characters in length that tag and categorize the cluster. The MongoDB Cloud console doesn't display your labels. + + Cluster labels are deprecated and will be removed in a future release. We strongly recommend that you use [resource tags](https://dochub.mongodb.org/core/add-cluster-tag-atlas) instead. + items: + $ref: '#/components/schemas/ComponentLabel' + type: array + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + mongoDBEmployeeAccessGrant: + $ref: '#/components/schemas/EmployeeAccessGrantView' + mongoDBMajorVersion: + description: |- + MongoDB major version of the cluster. + + On creation: Choose from the available versions of MongoDB, or leave unspecified for the current recommended default in the MongoDB Cloud platform. The recommended version is a recent Long Term Support version. The default is not guaranteed to be the most recently released version throughout the entire release cycle. For versions available in a specific project, see the linked documentation or use the API endpoint for [project LTS versions endpoint](#tag/Projects/operation/getProjectLTSVersions). + + On update: Increase version only by 1 major version at a time. If the cluster is pinned to a MongoDB feature compatibility version exactly one major version below the current MongoDB version, the MongoDB version can be downgraded to the previous major version. + example: '5.0' + externalDocs: + description: Available MongoDB Versions in Atlas + url: https://www.mongodb.com/docs/atlas/reference/faq/database/#which-versions-of-mongodb-do-service-clusters-use- + type: string + mongoDBVersion: + description: Version of MongoDB that the cluster runs. + example: 5.0.25 + pattern: ([\d]+\.[\d]+\.[\d]+) + type: string + mongoURI: + description: Base connection string that you can use to connect to the cluster. MongoDB Cloud displays the string only after the cluster starts, not while it builds the cluster. + externalDocs: + description: Connection string URI format. + url: https://docs.mongodb.com/manual/reference/connection-string/ + readOnly: true + type: string + mongoURIUpdated: + description: Date and time when someone last updated the connection string. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC. + format: date-time + readOnly: true + type: string + mongoURIWithOptions: + description: Connection string that you can use to connect to the cluster including the `replicaSet`, `ssl`, and `authSource` query parameters with values appropriate for the cluster. You may need to add MongoDB database users. The response returns this parameter once the cluster can receive requests, not while it builds the cluster. + externalDocs: + description: Connection string URI format. + url: https://docs.mongodb.com/manual/reference/connection-string/ + readOnly: true + type: string + name: + description: Human-readable label that identifies the cluster. + maxLength: 64 + minLength: 1 + pattern: ^([a-zA-Z0-9][a-zA-Z0-9-]*)?[a-zA-Z0-9]+$ + type: string + numShards: + default: 1 + description: Number of shards up to 50 to deploy for a sharded cluster. The resource returns `1` to indicate a replica set and values of `2` and higher to indicate a sharded cluster. The returned value equals the number of shards in the cluster. + externalDocs: + description: Sharding + url: https://docs.mongodb.com/manual/sharding/ + format: int32 + maximum: 50 + minimum: 1 + type: integer + paused: + description: Flag that indicates whether the cluster is paused. + type: boolean + pitEnabled: + description: Flag that indicates whether the cluster uses continuous cloud backups. + externalDocs: + description: Continuous Cloud Backups + url: https://docs.atlas.mongodb.com/backup/cloud-backup/overview/ + type: boolean + providerBackupEnabled: + description: Flag that indicates whether the M10 or higher cluster can perform Cloud Backups. If set to `true`, the cluster can perform backups. If this and **backupEnabled** are set to `false`, the cluster doesn't use MongoDB Cloud backups. + type: boolean + providerSettings: + $ref: '#/components/schemas/ClusterProviderSettings' + replicaSetScalingStrategy: + default: WORKLOAD_TYPE + description: |- + Set this field to configure the replica set scaling mode for your cluster. + + By default, Atlas scales under WORKLOAD_TYPE. This mode allows Atlas to scale your analytics nodes in parallel to your operational nodes. + + When configured as SEQUENTIAL, Atlas scales all nodes sequentially. This mode is intended for steady-state workloads and applications performing latency-sensitive secondary reads. + + When configured as NODE_TYPE, Atlas scales your electable nodes in parallel with your read-only and analytics nodes. This mode is intended for large, dynamic workloads requiring frequent and timely cluster tier scaling. This is the fastest scaling strategy, but it might impact latency of workloads when performing extensive secondary reads. + enum: + - SEQUENTIAL + - WORKLOAD_TYPE + - NODE_TYPE + externalDocs: + description: Modify the Replica Set Scaling Mode + url: https://dochub.mongodb.org/core/scale-nodes + type: string + replicationFactor: + default: 3 + deprecated: true + description: Number of members that belong to the replica set. Each member retains a copy of your databases, providing high availability and data redundancy. Use **replicationSpecs** instead. + enum: + - 3 + - 5 + - 7 + format: int32 + type: integer + replicationSpec: + additionalProperties: + $ref: '#/components/schemas/RegionSpec' + description: Physical location where MongoDB Cloud provisions cluster nodes. + title: Region Configuration + type: object + replicationSpecs: + description: |- + List of settings that configure your cluster regions. + + - For Global Clusters, each object in the array represents one zone where MongoDB Cloud deploys your clusters nodes. + - For non-Global sharded clusters and replica sets, the single object represents where MongoDB Cloud deploys your clusters nodes. + items: + $ref: '#/components/schemas/LegacyReplicationSpec' + type: array + rootCertType: + default: ISRGROOTX1 + description: Root Certificate Authority that MongoDB Atlas clusters uses. MongoDB Cloud supports Internet Security Research Group. + enum: + - ISRGROOTX1 + type: string + srvAddress: + description: Connection string that you can use to connect to the cluster. The `+srv` modifier forces the connection to use Transport Layer Security (TLS). The `mongoURI` parameter lists additional options. + externalDocs: + description: Connection string URI format. + url: https://docs.mongodb.com/manual/reference/connection-string/ + readOnly: true + type: string + stateName: + description: Human-readable label that indicates the current operating condition of the cluster. + enum: + - IDLE + - CREATING + - UPDATING + - DELETING + - REPAIRING + readOnly: true + type: string + tags: + description: List that contains key-value pairs between 1 to 255 characters in length for tagging and categorizing the cluster. + externalDocs: + description: Resource Tags + url: https://dochub.mongodb.org/core/add-cluster-tag-atlas + items: + $ref: '#/components/schemas/ResourceTag' + type: array + terminationProtectionEnabled: + default: false + description: Flag that indicates whether termination protection is enabled on the cluster. If set to `true`, MongoDB Cloud won't delete the cluster. If set to `false`, MongoDB Cloud will delete the cluster. + type: boolean + versionReleaseSystem: + default: LTS + description: Method by which the cluster maintains the MongoDB versions. If value is `CONTINUOUS`, you must not specify **mongoDBMajorVersion**. + enum: + - LTS + - CONTINUOUS + type: string + title: Cluster Description + type: object + LegacyReplicationSpec: + properties: + id: + description: |- + Unique 24-hexadecimal digit string that identifies the replication object for a zone in a Global Cluster. + + - If you include existing zones in the request, you must specify this parameter. + + - If you add a new zone to an existing Global Cluster, you may specify this parameter. The request deletes any existing zones in a Global Cluster that you exclude from the request. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + numShards: + default: 1 + description: |- + Positive integer that specifies the number of shards to deploy in each specified zone If you set this value to `1` and **clusterType** is `SHARDED`, MongoDB Cloud deploys a single-shard sharded cluster. Don't create a sharded cluster with a single shard for production environments. Single-shard sharded clusters don't provide the same benefits as multi-shard configurations. + + If you are upgrading a replica set to a sharded cluster, you cannot increase the number of shards in the same update request. You should wait until after the cluster has completed upgrading to sharded and you have reconnected all application clients to the MongoDB router before adding additional shards. Otherwise, your data might become inconsistent once MongoDB Cloud begins distributing data across shards. + format: int32 + type: integer + regionsConfig: + additionalProperties: + $ref: '#/components/schemas/RegionSpec' + description: Physical location where MongoDB Cloud provisions cluster nodes. + title: Region Configuration + type: object + zoneName: + description: Human-readable label that identifies the zone in a Global Cluster. Provide this value only if **clusterType** is `GEOSHARDED`. + type: string + type: object + Link: + properties: + href: + description: Uniform Resource Locator (URL) that points another API resource to which this response has some relationship. This URL often begins with `https://cloud.mongodb.com/api/atlas`. + example: https://cloud.mongodb.com/api/atlas + type: string + rel: + description: Uniform Resource Locator (URL) that defines the semantic relationship between this resource and another API resource. This URL often begins with `https://cloud.mongodb.com/api/atlas`. + example: self + type: string + type: object + MonthlyScheduleView: + allOf: + - $ref: '#/components/schemas/OnlineArchiveSchedule' + - properties: + dayOfMonth: + description: Day of the month when the scheduled archive starts. + format: int32 + maximum: 31 + minimum: 1 + type: integer + endHour: + description: Hour of the day when the scheduled window to run one online archive ends. + format: int32 + maximum: 23 + minimum: 0 + type: integer + endMinute: + description: Minute of the hour when the scheduled window to run one online archive ends. + format: int32 + maximum: 59 + minimum: 0 + type: integer + startHour: + description: Hour of the day when the when the scheduled window to run one online archive starts. + format: int32 + maximum: 23 + minimum: 0 + type: integer + startMinute: + description: Minute of the hour when the scheduled window to run one online archive starts. + format: int32 + maximum: 59 + minimum: 0 + type: integer + type: object + required: + - type + type: object + OnDemandCpsSnapshotSource: + allOf: + - $ref: '#/components/schemas/IngestionSource' + - properties: + clusterName: + description: Human-readable name that identifies the cluster. + type: string + collectionName: + description: Human-readable name that identifies the collection. + type: string + databaseName: + description: Human-readable name that identifies the database. + type: string + groupId: + description: Unique 24-hexadecimal character string that identifies the project. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + type: object + description: On-Demand Cloud Provider Snapshots as Source for a Data Lake Pipeline. + title: On-Demand Cloud Provider Snapshot Source + type: object + OnlineArchiveSchedule: + description: Regular frequency and duration when archiving process occurs. + discriminator: + mapping: + DAILY: '#/components/schemas/DailyScheduleView' + DEFAULT: '#/components/schemas/DefaultScheduleView' + MONTHLY: '#/components/schemas/MonthlyScheduleView' + WEEKLY: '#/components/schemas/WeeklyScheduleView' + propertyName: type + oneOf: + - $ref: '#/components/schemas/DefaultScheduleView' + - $ref: '#/components/schemas/DailyScheduleView' + - $ref: '#/components/schemas/WeeklyScheduleView' + - $ref: '#/components/schemas/MonthlyScheduleView' + properties: + type: + description: Type of schedule. + enum: + - DEFAULT + - DAILY + - WEEKLY + - MONTHLY + type: string + required: + - type + title: Online Archive Schedule + type: object + OrgActiveUserResponse: + allOf: + - $ref: '#/components/schemas/OrgUserResponse' + - properties: + country: + description: Two alphabet characters that identifies MongoDB Cloud user's geographic location. This parameter uses the ISO 3166-1a2 code format. + example: US + pattern: ^([A-Z]{2})$ + readOnly: true + type: string + createdAt: + description: Date and time when MongoDB Cloud created the current account. This value is in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + firstName: + description: First or given name that belongs to the MongoDB Cloud user. + example: John + readOnly: true + type: string + lastAuth: + description: Date and time when the current account last authenticated. This value is in the ISO 8601 timestamp format in UTC. + format: date-time + readOnly: true + type: string + lastName: + description: Last name, family name, or surname that belongs to the MongoDB Cloud user. + example: Doe + readOnly: true + type: string + mobileNumber: + description: Mobile phone number that belongs to the MongoDB Cloud user. + pattern: (?:(?:\\+?1\\s*(?:[.-]\\s*)?)?(?:(\\s*([2-9]1[02-9]|[2-9][02-8]1|[2-9][02-8][02-9])\\s*)|([2-9]1[02-9]|[2-9][02-8]1|[2-9][02-8][02-9]))\\s*(?:[.-]\\s*)?)([2-9]1[02-9]|[2-9][02-9]1|[2-9][02-9]{2})\\s*(?:[.-]\\s*)?([0-9]{4})$ + readOnly: true + type: string + type: object + required: + - createdAt + - firstName + - id + - lastName + - orgMembershipStatus + - roles + - username + type: object + OrgPendingUserResponse: + allOf: + - $ref: '#/components/schemas/OrgUserResponse' + - properties: + invitationCreatedAt: + description: Date and time when MongoDB Cloud sent the invitation. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC. + format: date-time + readOnly: true + type: string + invitationExpiresAt: + description: Date and time when the invitation from MongoDB Cloud expires. MongoDB Cloud represents this timestamp in ISO 8601 format in UTC. + format: date-time + readOnly: true + type: string + inviterUsername: + description: Username of the MongoDB Cloud user who sent the invitation to join the organization. + format: email + readOnly: true + type: string + type: object + required: + - id + - invitationCreatedAt + - invitationExpiresAt + - inviterUsername + - orgMembershipStatus + - roles + - username + type: object + OrgUserResponse: + discriminator: + mapping: + ACTIVE: '#/components/schemas/OrgActiveUserResponse' + PENDING: '#/components/schemas/OrgPendingUserResponse' + propertyName: orgMembershipStatus + oneOf: + - $ref: '#/components/schemas/OrgPendingUserResponse' + - $ref: '#/components/schemas/OrgActiveUserResponse' + properties: + id: + description: Unique 24-hexadecimal digit string that identifies the MongoDB Cloud user. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + orgMembershipStatus: + description: String enum that indicates whether the MongoDB Cloud user has a pending invitation to join the organization or they are already active in the organization. + enum: + - PENDING + - ACTIVE + readOnly: true + type: string + roles: + $ref: '#/components/schemas/OrgUserRolesResponse' + teamIds: + description: List of unique 24-hexadecimal digit strings that identifies the teams to which this MongoDB Cloud user belongs. + items: + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + readOnly: true + type: array + uniqueItems: true + username: + description: Email address that represents the username of the MongoDB Cloud user. + format: email + readOnly: true + type: string + required: + - id + - orgMembershipStatus + - roles + - username + type: object + OrgUserRolesResponse: + description: Organization and project level roles assigned to one MongoDB Cloud user within one organization. + properties: + groupRoleAssignments: + description: List of project level role assignments assigned to the MongoDB Cloud user. + items: + $ref: '#/components/schemas/GroupRoleAssignment' + type: array + orgRoles: + description: One or more organization level roles assigned to the MongoDB Cloud user. + items: + enum: + - ORG_OWNER + - ORG_GROUP_CREATOR + - ORG_BILLING_ADMIN + - ORG_BILLING_READ_ONLY + - ORG_READ_ONLY + - ORG_MEMBER + type: string + type: array + uniqueItems: true + readOnly: true + type: object + PaginatedAdvancedClusterDescriptionView: + properties: + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + results: + description: List of returned documents that MongoDB Cloud provides when completing this request. + items: + $ref: '#/components/schemas/AdvancedClusterDescription' + readOnly: true + type: array + totalCount: + description: Total number of documents available. MongoDB Cloud omits this value if `includeCount` is set to `false`. + format: int32 + minimum: 0 + readOnly: true + type: integer + type: object + PaginatedClusterDescription20240805: + properties: + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + results: + description: List of returned documents that MongoDB Cloud provides when completing this request. + items: + $ref: '#/components/schemas/ClusterDescription20240805' + readOnly: true + type: array + totalCount: + description: Total number of documents available. MongoDB Cloud omits this value if `includeCount` is set to `false`. + format: int32 + minimum: 0 + readOnly: true + type: integer + type: object + PaginatedLegacyClusterView: + properties: + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + results: + description: List of returned documents that MongoDB Cloud provides when completing this request. + items: + $ref: '#/components/schemas/LegacyAtlasCluster' + readOnly: true + type: array + totalCount: + description: Total number of documents available. MongoDB Cloud omits this value if `includeCount` is set to `false`. + format: int32 + minimum: 0 + readOnly: true + type: integer + type: object + PeriodicCpsSnapshotSource: + allOf: + - $ref: '#/components/schemas/IngestionSource' + - properties: + clusterName: + description: Human-readable name that identifies the cluster. + type: string + collectionName: + description: Human-readable name that identifies the collection. + type: string + databaseName: + description: Human-readable name that identifies the database. + type: string + groupId: + description: Unique 24-hexadecimal character string that identifies the project. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + policyItemId: + description: Unique 24-hexadecimal character string that identifies a policy item. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + type: object + description: Scheduled Cloud Provider Snapshot as Source for a Data Lake Pipeline. + title: Periodic Cloud Provider Snapshot Source + type: object + RegionSpec: + description: Physical location where MongoDB Cloud provisions cluster nodes. + properties: + analyticsNodes: + description: Number of analytics nodes in the region. Analytics nodes handle analytic data such as reporting queries from MongoDB Connector for Business Intelligence on MongoDB Cloud. Analytics nodes are read-only, and can never become the primary. Use **replicationSpecs[n].{region}.analyticsNodes** instead. + format: int32 + type: integer + electableNodes: + description: Number of electable nodes to deploy in the specified region. Electable nodes can become the primary and can facilitate local reads. Use **replicationSpecs[n].{region}.electableNodes** instead. + enum: + - 0 + - 3 + - 5 + - 7 + format: int32 + type: integer + priority: + description: Number that indicates the election priority of the region. To identify the Preferred Region of the cluster, set this parameter to `7`. The primary node runs in the **Preferred Region**. To identify a read-only region, set this parameter to `0`. + format: int32 + maximum: 7 + minimum: 0 + type: integer + readOnlyNodes: + description: Number of read-only nodes in the region. Read-only nodes can never become the primary member, but can facilitate local reads. Use **replicationSpecs[n].{region}.readOnlyNodes** instead. + format: int32 + type: integer + title: Region Configuration + type: object + ReplicationSpec: + description: Details that explain how MongoDB Cloud replicates data on the specified MongoDB database. + properties: + id: + description: Unique 24-hexadecimal digit string that identifies the replication object for a zone in a Multi-Cloud Cluster. If you include existing zones in the request, you must specify this parameter. If you add a new zone to an existing Multi-Cloud Cluster, you may specify this parameter. The request deletes any existing zones in the Multi-Cloud Cluster that you exclude from the request. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + numShards: + description: |- + Positive integer that specifies the number of shards to deploy in each specified zone. If you set this value to `1` and **clusterType** is `SHARDED`, MongoDB Cloud deploys a single-shard sharded cluster. Don't create a sharded cluster with a single shard for production environments. Single-shard sharded clusters don't provide the same benefits as multi-shard configurations. + + If you are upgrading a replica set to a sharded cluster, you cannot increase the number of shards in the same update request. You should wait until after the cluster has completed upgrading to sharded and you have reconnected all application clients to the MongoDB router before adding additional shards. Otherwise, your data might become inconsistent once MongoDB Cloud begins distributing data across shards. + format: int32 + minimum: 1 + type: integer + regionConfigs: + description: |- + Hardware specifications for nodes set for a given region. Each **regionConfigs** object describes the region's priority in elections and the number and type of MongoDB nodes that MongoDB Cloud deploys to the region. Each **regionConfigs** object must have either an **analyticsSpecs** object, **electableSpecs** object, or **readOnlySpecs** object. Tenant clusters only require **electableSpecs. Dedicated** clusters can specify any of these specifications, but must have at least one **electableSpecs** object within a **replicationSpec**. Every hardware specification must use the same **instanceSize**. + + **Example:** + + If you set `"replicationSpecs[n].regionConfigs[m].analyticsSpecs.instanceSize" : "M30"`, set `"replicationSpecs[n].regionConfigs[m].electableSpecs.instanceSize" : `"M30"` if you have electable nodes and `"replicationSpecs[n].regionConfigs[m].readOnlySpecs.instanceSize" : `"M30"` if you have read-only nodes. + items: + $ref: '#/components/schemas/CloudRegionConfig' + type: array + zoneName: + description: 'Human-readable label that identifies the zone in a Global Cluster. Provide this value only if `"clusterType" : "GEOSHARDED"`.' + type: string + title: Replication Specifications + type: object + ReplicationSpec20240805: + description: Details that explain how MongoDB Cloud replicates data on the specified MongoDB database. + properties: + id: + description: Unique 24-hexadecimal digit string that identifies the replication object for a shard in a Cluster. If you include existing shard replication configurations in the request, you must specify this parameter. If you add a new shard to an existing Cluster, you may specify this parameter. The request deletes any existing shards in the Cluster that you exclude from the request. This corresponds to Shard ID displayed in the UI. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + regionConfigs: + description: |- + Hardware specifications for nodes set for a given region. Each **regionConfigs** object describes the region's priority in elections and the number and type of MongoDB nodes that MongoDB Cloud deploys to the region. Each **regionConfigs** object must have either an **analyticsSpecs** object, **electableSpecs** object, or **readOnlySpecs** object. Tenant clusters only require **electableSpecs. Dedicated** clusters can specify any of these specifications, but must have at least one **electableSpecs** object within a **replicationSpec**. + + **Example:** + + If you set `"replicationSpecs[n].regionConfigs[m].analyticsSpecs.instanceSize" : "M30"`, set `"replicationSpecs[n].regionConfigs[m].electableSpecs.instanceSize" : `"M30"` if you have electable nodes and `"replicationSpecs[n].regionConfigs[m].readOnlySpecs.instanceSize" : `"M30"` if you have read-only nodes. + items: + $ref: '#/components/schemas/CloudRegionConfig20240805' + type: array + zoneId: + description: Unique 24-hexadecimal digit string that identifies the zone in a Global Cluster. This value can be used to configure Global Cluster backup policies. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + readOnly: true + type: string + zoneName: + description: 'Human-readable label that describes the zone this shard belongs to in a Global Cluster. Provide this value only if "clusterType" : "GEOSHARDED" but not "selfManagedSharding" : true.' + type: string + title: Replication Specifications + type: object + ResourceTag: + description: 'Key-value pair that tags and categorizes a MongoDB Cloud organization, project, or cluster. For example, `environment : production`.' + properties: + key: + description: 'Constant that defines the set of the tag. For example, `environment` in the `environment : production` tag.' + maxLength: 255 + minLength: 1 + type: string + value: + description: 'Variable that belongs to the set of the tag. For example, `production` in the `environment : production` tag.' + maxLength: 255 + minLength: 1 + type: string + required: + - key + - value + title: Resource Tag + type: object + SearchHostStatusDetail: + properties: + hostname: + description: Hostname that corresponds to the status detail. + type: string + mainIndex: + $ref: '#/components/schemas/SearchMainIndexStatusDetail' + queryable: + description: Flag that indicates whether the index is queryable on the host. + type: boolean + stagedIndex: + $ref: '#/components/schemas/SearchStagedIndexStatusDetail' + status: + description: | + Condition of the search index when you made this request. + + | Status | Index Condition | + |---|---| + | DELETING | The index is being deleted. | + | FAILED | The index build failed. Indexes can enter the FAILED state due to an invalid index definition. | + | STALE | The index is queryable but has stopped replicating data from the indexed collection. Searches on the index may return out-of-date data. | + | PENDING | Atlas has not yet started building the index. | + | BUILDING | Atlas is building or re-building the index after an edit. | + | READY | The index is ready and can support queries. | + enum: + - DELETING + - FAILED + - STALE + - PENDING + - BUILDING + - READY + - DOES_NOT_EXIST + type: string + title: Search Host Status Detail + type: object + SearchIndex: + allOf: + - $ref: '#/components/schemas/ClusterSearchIndex' + - properties: + analyzer: + default: lucene.standard + description: |- + Specific pre-defined method chosen to convert database field text into searchable words. This conversion reduces the text of fields into the smallest units of text. These units are called a **term** or **token**. This process, known as tokenization, involves a variety of changes made to the text in fields: + + - extracting words + - removing punctuation + - removing accents + - changing to lowercase + - removing common words + - reducing words to their root form (stemming) + - changing words to their base form (lemmatization) + MongoDB Cloud uses the selected process to build the Atlas Search index. + enum: + - lucene.standard + - lucene.simple + - lucene.whitespace + - lucene.keyword + - lucene.arabic + - lucene.armenian + - lucene.basque + - lucene.bengali + - lucene.brazilian + - lucene.bulgarian + - lucene.catalan + - lucene.chinese + - lucene.cjk + - lucene.czech + - lucene.danish + - lucene.dutch + - lucene.english + - lucene.finnish + - lucene.french + - lucene.galician + - lucene.german + - lucene.greek + - lucene.hindi + - lucene.hungarian + - lucene.indonesian + - lucene.irish + - lucene.italian + - lucene.japanese + - lucene.korean + - lucene.kuromoji + - lucene.latvian + - lucene.lithuanian + - lucene.morfologik + - lucene.nori + - lucene.norwegian + - lucene.persian + - lucene.portuguese + - lucene.romanian + - lucene.russian + - lucene.smartcn + - lucene.sorani + - lucene.spanish + - lucene.swedish + - lucene.thai + - lucene.turkish + - lucene.ukrainian + externalDocs: + description: Atlas Search Analyzers + url: https://dochub.mongodb.org/core/analyzers--fts + type: string + analyzers: + description: List of user-defined methods to convert database field text into searchable words. + externalDocs: + description: Custom Atlas Search Analyzers + url: https://dochub.mongodb.org/core/custom-fts + items: + $ref: '#/components/schemas/ApiAtlasFTSAnalyzersViewManual' + type: array + mappings: + $ref: '#/components/schemas/ApiAtlasFTSMappingsViewManual' + searchAnalyzer: + default: lucene.standard + description: Method applied to identify words when searching this index. + enum: + - lucene.standard + - lucene.simple + - lucene.whitespace + - lucene.keyword + - lucene.arabic + - lucene.armenian + - lucene.basque + - lucene.bengali + - lucene.brazilian + - lucene.bulgarian + - lucene.catalan + - lucene.chinese + - lucene.cjk + - lucene.czech + - lucene.danish + - lucene.dutch + - lucene.english + - lucene.finnish + - lucene.french + - lucene.galician + - lucene.german + - lucene.greek + - lucene.hindi + - lucene.hungarian + - lucene.indonesian + - lucene.irish + - lucene.italian + - lucene.japanese + - lucene.korean + - lucene.kuromoji + - lucene.latvian + - lucene.lithuanian + - lucene.morfologik + - lucene.nori + - lucene.norwegian + - lucene.persian + - lucene.portuguese + - lucene.romanian + - lucene.russian + - lucene.smartcn + - lucene.sorani + - lucene.spanish + - lucene.swedish + - lucene.thai + - lucene.turkish + - lucene.ukrainian + type: string + storedSource: + description: Flag that indicates whether to store all fields (true) on Atlas Search. By default, Atlas doesn't store (false) the fields on Atlas Search. Alternatively, you can specify an object that only contains the list of fields to store (include) or not store (exclude) on Atlas Search. To learn more, see documentation. + example: + include | exclude: + - field1 + - field2 + externalDocs: + description: Stored Source Fields + url: https://dochub.mongodb.org/core/atlas-search-stored-source + type: object + synonyms: + description: Rule sets that map words to their synonyms in this index. + externalDocs: + description: Synonym Mapping + url: https://dochub.mongodb.org/core/fts-synonym-mappings + items: + $ref: '#/components/schemas/SearchSynonymMappingDefinition' + type: array + type: object + required: + - collectionName + - database + - name + type: object + SearchIndexCreateRequest: + discriminator: + mapping: + search: '#/components/schemas/TextSearchIndexCreateRequest' + vectorSearch: '#/components/schemas/VectorSearchIndexCreateRequest' + propertyName: type + properties: + collectionName: + description: Label that identifies the collection to create an Atlas Search index in. + type: string + database: + description: Label that identifies the database that contains the collection to create an Atlas Search index in. + type: string + name: + description: Label that identifies this index. Within each namespace, names of all indexes in the namespace must be unique. + type: string + type: + description: Type of the index. The default type is search. + enum: + - search + - vectorSearch + type: string + required: + - collectionName + - database + - name + type: object + SearchIndexDefinition: + description: The search index definition set by the user. + title: Search Index Definition + type: object + SearchIndexDefinitionVersion: + description: Object which includes the version number of the index definition and the time that the index definition was created. + properties: + createdAt: + description: The time at which this index definition was created. + format: date-time + type: string + version: + description: The version number associated with this index definition when it was created. + format: int64 + type: integer + title: Search Index Definition Version + type: object + SearchIndexResponse: + discriminator: + mapping: + search: '#/components/schemas/TextSearchIndexResponse' + vectorSearch: '#/components/schemas/VectorSearchIndexResponse' + propertyName: type + properties: + collectionName: + description: Label that identifies the collection that contains one or more Atlas Search indexes. + type: string + database: + description: Label that identifies the database that contains the collection with one or more Atlas Search indexes. + type: string + indexID: + description: Unique 24-hexadecimal digit string that identifies this Atlas Search index. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + latestDefinition: + $ref: '#/components/schemas/SearchIndexDefinition' + latestDefinitionVersion: + $ref: '#/components/schemas/SearchIndexDefinitionVersion' + name: + description: Label that identifies this index. Within each namespace, the names of all indexes must be unique. + type: string + queryable: + description: Flag that indicates whether the index is queryable on all hosts. + type: boolean + status: + description: | + Condition of the search index when you made this request. + + | Status | Index Condition | + |---|---| + | DELETING | The index is being deleted. | + | FAILED | The index build failed. Indexes can enter the FAILED state due to an invalid index definition. | + | STALE | The index is queryable but has stopped replicating data from the indexed collection. Searches on the index may return out-of-date data. | + | PENDING | Atlas has not yet started building the index. | + | BUILDING | Atlas is building or re-building the index after an edit. | + | READY | The index is ready and can support queries. | + enum: + - DELETING + - FAILED + - STALE + - PENDING + - BUILDING + - READY + - DOES_NOT_EXIST + type: string + statusDetail: + description: List of documents detailing index status on each host. + items: + $ref: '#/components/schemas/SearchHostStatusDetail' + type: array + type: + description: Type of the index. The default type is search. + enum: + - search + - vectorSearch + type: string + title: Search Index Response + type: object + SearchMainIndexStatusDetail: + description: Contains status information about the active index. + properties: + definition: + $ref: '#/components/schemas/SearchIndexDefinition' + definitionVersion: + $ref: '#/components/schemas/SearchIndexDefinitionVersion' + message: + description: Optional message describing an error. + type: string + queryable: + description: Flag that indicates whether the index generation is queryable on the host. + type: boolean + status: + description: | + Condition of the search index when you made this request. + + | Status | Index Condition | + |---|---| + | DELETING | The index is being deleted. | + | FAILED | The index build failed. Indexes can enter the FAILED state due to an invalid index definition. | + | STALE | The index is queryable but has stopped replicating data from the indexed collection. Searches on the index may return out-of-date data. | + | PENDING | Atlas has not yet started building the index. | + | BUILDING | Atlas is building or re-building the index after an edit. | + | READY | The index is ready and can support queries. | + enum: + - DELETING + - FAILED + - STALE + - PENDING + - BUILDING + - READY + - DOES_NOT_EXIST + type: string + title: Search Main Index Status Detail + type: object + SearchMappings: + description: Index specifications for the collection's fields. + properties: + dynamic: + description: Flag that indicates whether the index uses dynamic or static mappings. Required if **mappings.fields** is omitted. + externalDocs: + description: Dynamic or Static Mappings + url: https://dochub.mongodb.org/core/field-mapping-definition-fts#static-and-dynamic-mappings + type: boolean + fields: + additionalProperties: + description: One or more field specifications for the Atlas Search index. Required if **mappings.dynamic** is omitted or set to **false**. + externalDocs: + description: Atlas Search Index + url: https://dochub.mongodb.org/core/index-definitions-fts + type: object + x-additionalPropertiesName: Field Name + description: One or more field specifications for the Atlas Search index. Required if **mappings.dynamic** is omitted or set to **false**. + externalDocs: + description: Atlas Search Index + url: https://dochub.mongodb.org/core/index-definitions-fts + type: object + x-additionalPropertiesName: Field Name + title: Mappings + type: object + SearchStagedIndexStatusDetail: + description: Contains status information about an index building in the background. + properties: + definition: + $ref: '#/components/schemas/SearchIndexDefinition' + definitionVersion: + $ref: '#/components/schemas/SearchIndexDefinitionVersion' + message: + description: Optional message describing an error. + type: string + queryable: + description: Flag that indicates whether the index generation is queryable on the host. + type: boolean + status: + description: | + Condition of the search index when you made this request. + + | Status | Index Condition | + |---|---| + | DELETING | The index is being deleted. | + | FAILED | The index build failed. Indexes can enter the FAILED state due to an invalid index definition. | + | STALE | The index is queryable but has stopped replicating data from the indexed collection. Searches on the index may return out-of-date data. | + | PENDING | Atlas has not yet started building the index. | + | BUILDING | Atlas is building or re-building the index after an edit. | + | READY | The index is ready and can support queries. | + enum: + - DELETING + - FAILED + - STALE + - PENDING + - BUILDING + - READY + - DOES_NOT_EXIST + type: string + title: Search Staged Index Status Detail + type: object + SearchSynonymMappingDefinition: + description: Synonyms used for this full text index. + properties: + analyzer: + description: Specific pre-defined method chosen to apply to the synonyms to be searched. + enum: + - lucene.standard + - lucene.simple + - lucene.whitespace + - lucene.keyword + - lucene.arabic + - lucene.armenian + - lucene.basque + - lucene.bengali + - lucene.brazilian + - lucene.bulgarian + - lucene.catalan + - lucene.chinese + - lucene.cjk + - lucene.czech + - lucene.danish + - lucene.dutch + - lucene.english + - lucene.finnish + - lucene.french + - lucene.galician + - lucene.german + - lucene.greek + - lucene.hindi + - lucene.hungarian + - lucene.indonesian + - lucene.irish + - lucene.italian + - lucene.japanese + - lucene.korean + - lucene.kuromoji + - lucene.latvian + - lucene.lithuanian + - lucene.morfologik + - lucene.nori + - lucene.norwegian + - lucene.persian + - lucene.portuguese + - lucene.romanian + - lucene.russian + - lucene.smartcn + - lucene.sorani + - lucene.spanish + - lucene.swedish + - lucene.thai + - lucene.turkish + - lucene.ukrainian + type: string + name: + description: Label that identifies the synonym definition. Each **synonym.name** must be unique within the same index definition. + type: string + source: + $ref: '#/components/schemas/SynonymSource' + required: + - analyzer + - name + - source + title: Synonym Mapping Definition + type: object + ServerlessAWSTenantEndpointUpdate: + allOf: + - $ref: '#/components/schemas/ServerlessTenantEndpointUpdate' + - properties: + cloudProviderEndpointId: + description: Unique string that identifies the private endpoint's network interface. + pattern: ^vpce-[0-9a-f]{17}$ + type: string + writeOnly: true + type: object + description: Updates to a serverless AWS tenant endpoint. + required: + - providerName + title: AWS + type: object + ServerlessAzureTenantEndpointUpdate: + allOf: + - $ref: '#/components/schemas/ServerlessTenantEndpointUpdate' + - properties: + cloudProviderEndpointId: + description: Unique string that identifies the Azure private endpoint's network interface for this private endpoint service. + pattern: ^/subscriptions/[0-9a-f]{8}-([0-9a-f]{4}-){3}[0-9a-f]{12}/resource[gG]roups/private[Ll]ink/providers/Microsoft\.Network/privateEndpoints/[-\w._()]+$ + type: string + writeOnly: true + privateEndpointIpAddress: + description: IPv4 address of the private endpoint in your Azure VNet that someone added to this private endpoint service. + pattern: ^((25[0-5]|(2[0-4]|1\d|[1-9]|)\d)(\.(?!$)|$)){4}|([0-9a-f]{1,4}:){7}[0-9a-f]{1,4}$ + type: string + writeOnly: true + type: object + description: Updates to a serverless Azure tenant endpoint. + required: + - providerName + title: AZURE + type: object + ServerlessTenantEndpointUpdate: + description: Update view for a serverless tenant endpoint. + discriminator: + mapping: + AWS: '#/components/schemas/ServerlessAWSTenantEndpointUpdate' + AZURE: '#/components/schemas/ServerlessAzureTenantEndpointUpdate' + propertyName: providerName + properties: + comment: + description: Human-readable comment associated with the private endpoint. + maxLength: 80 + type: string + writeOnly: true + providerName: + description: Human-readable label that identifies the cloud provider of the tenant endpoint. + enum: + - AWS + - AZURE + type: string + writeOnly: true + required: + - providerName + type: object + StreamsClusterConnection: + allOf: + - $ref: '#/components/schemas/StreamsConnection' + - properties: + clusterName: + description: Name of the cluster configured for this connection. + type: string + dbRoleToExecute: + $ref: '#/components/schemas/DBRoleToExecute' + type: object + type: object + StreamsConnection: + description: Settings that define a connection to an external data store. + discriminator: + mapping: + Cluster: '#/components/schemas/StreamsClusterConnection' + Kafka: '#/components/schemas/StreamsKafkaConnection' + Sample: '#/components/schemas/StreamsSampleConnection' + propertyName: type + oneOf: + - $ref: '#/components/schemas/StreamsSampleConnection' + - $ref: '#/components/schemas/StreamsClusterConnection' + - $ref: '#/components/schemas/StreamsKafkaConnection' + properties: + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + name: + description: Human-readable label that identifies the stream connection. In the case of the Sample type, this is the name of the sample source. + type: string + type: + description: Type of the connection. Can be either Cluster or Kafka. + enum: + - Kafka + - Cluster + - Sample + type: string + readOnly: true + type: object + StreamsKafkaAuthentication: + description: User credentials required to connect to a Kafka Cluster. Includes the authentication type, as well as the parameters for that authentication mode. + properties: + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + mechanism: + description: Style of authentication. Can be one of PLAIN, SCRAM-256, or SCRAM-512. + type: string + password: + description: Password of the account to connect to the Kafka cluster. + format: password + type: string + writeOnly: true + username: + description: Username of the account to connect to the Kafka cluster. + type: string + type: object + StreamsKafkaConnection: + allOf: + - $ref: '#/components/schemas/StreamsConnection' + - properties: + authentication: + $ref: '#/components/schemas/StreamsKafkaAuthentication' + bootstrapServers: + description: Comma separated list of server addresses. + type: string + config: + additionalProperties: + description: A map of Kafka key-value pairs for optional configuration. This is a flat object, and keys can have '.' characters. + example: '{"group.protocol.type":"consumer","debug":"queue, msg, protocol"}' + type: string + description: A map of Kafka key-value pairs for optional configuration. This is a flat object, and keys can have '.' characters. + example: + debug: queue, msg, protocol + group.protocol.type: consumer + type: object + networking: + $ref: '#/components/schemas/StreamsKafkaNetworking' + security: + $ref: '#/components/schemas/StreamsKafkaSecurity' + type: object + type: object + StreamsKafkaNetworking: + description: Networking Access Type can either be 'PUBLIC' (default) or VPC. VPC type is in public preview, please file a support ticket to enable VPC Network Access + properties: + access: + $ref: '#/components/schemas/StreamsKafkaNetworkingAccess' + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + type: object + StreamsKafkaNetworkingAccess: + description: Information about the networking access. + properties: + connectionId: + description: Reserved. Will be used by PRIVATE_LINK connection type. + example: 32b6e34b3d91647abb20e7b8 + maxLength: 24 + minLength: 24 + pattern: ^([a-f0-9]{24})$ + type: string + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + name: + description: Reserved. Will be used by PRIVATE_LINK connection type. + type: string + type: + description: Selected networking type. Either PUBLIC, VPC or PRIVATE_LINK. Defaults to PUBLIC. For VPC, ensure that VPC peering exists and connectivity has been established between Atlas VPC and the VPC where Kafka cluster is hosted for the connection to function properly. PRIVATE_LINK support is coming soon. + enum: + - PUBLIC + - VPC + - PRIVATE_LINK + title: Networking Access Type + type: string + type: object + StreamsKafkaSecurity: + description: Properties for the secure transport connection to Kafka. For SSL, this can include the trusted certificate to use. + properties: + brokerPublicCertificate: + description: A trusted, public x509 certificate for connecting to Kafka over SSL. + type: string + links: + description: List of one or more Uniform Resource Locators (URLs) that point to API sub-resources, related API resources, or both. RFC 5988 outlines these relationships. + externalDocs: + description: Web Linking Specification (RFC 5988) + url: https://datatracker.ietf.org/doc/html/rfc5988 + items: + $ref: '#/components/schemas/Link' + readOnly: true + type: array + protocol: + description: Describes the transport type. Can be either PLAINTEXT or SSL. + type: string + type: object + StreamsSampleConnection: + allOf: + - $ref: '#/components/schemas/StreamsConnection' + type: object + SynonymMappingStatusDetail: + description: Contains the status of the index's synonym mappings on each search host. This field (and its subfields) only appear if the index has synonyms defined. + properties: + message: + description: Optional message describing an error. + type: string + queryable: + description: Flag that indicates whether the synonym mapping is queryable on a host. + type: boolean + status: + description: Status that describes this index's synonym mappings. This status appears only if the index has synonyms defined. + enum: + - FAILED + - BUILDING + - READY + type: string + title: Synonym Mapping Status Detail + type: object + SynonymMappingStatusDetailMap: + additionalProperties: + $ref: '#/components/schemas/SynonymMappingStatusDetail' + type: object + x-additionalPropertiesName: Synonym Mapping Name + SynonymSource: + description: Data set that stores words and their applicable synonyms. + properties: + collection: + description: Label that identifies the MongoDB collection that stores words and their applicable synonyms. + type: string + required: + - collection + type: object + TenantHardwareSpec: + properties: + instanceSize: + description: Hardware specification for the instances in this M0/M2/M5 tier cluster. + enum: + - M0 + - M2 + - M5 + title: Tenant Instance Sizes + type: string + type: object + TenantHardwareSpec20240805: + properties: + diskSizeGB: + description: |- + Storage capacity of instance data volumes expressed in gigabytes. Increase this number to add capacity. + + This value must be equal for all shards and node types. + + This value is not configurable on M0/M2/M5 clusters. + + MongoDB Cloud requires this parameter if you set **replicationSpecs**. + + If you specify a disk size below the minimum (10 GB), this parameter defaults to the minimum disk size value. + + Storage charge calculations depend on whether you choose the default value or a custom value. + + The maximum value for disk storage cannot exceed 50 times the maximum RAM for the selected cluster. If you require more storage space, consider upgrading your cluster to a higher tier. + format: double + maximum: 4096 + minimum: 10 + type: number + instanceSize: + description: Hardware specification for the instances in this M0/M2/M5 tier cluster. + enum: + - M0 + - M2 + - M5 + title: Tenant Instance Sizes + type: string + type: object + TenantRegionConfig: + allOf: + - $ref: '#/components/schemas/CloudRegionConfig' + - properties: + backingProviderName: + description: Cloud service provider on which MongoDB Cloud provisioned the multi-tenant cluster. The resource returns this parameter when **providerName** is `TENANT` and **electableSpecs.instanceSize** is `M0`, `M2` or `M5`. + enum: + - AWS + - GCP + - AZURE + type: string + type: object + description: Details that explain how MongoDB Cloud replicates data in one region on the specified MongoDB database. + title: Tenant Regional Replication Specifications + type: object + TenantRegionConfig20240805: + allOf: + - $ref: '#/components/schemas/CloudRegionConfig20240805' + - properties: + backingProviderName: + description: Cloud service provider on which MongoDB Cloud provisioned the multi-tenant cluster. The resource returns this parameter when **providerName** is `TENANT` and **electableSpecs.instanceSize** is `M0`, `M2` or `M5`. + enum: + - AWS + - GCP + - AZURE + type: string + type: object + description: Details that explain how MongoDB Cloud replicates data in one region on the specified MongoDB database. + title: Tenant Regional Replication Specifications + type: object + TextSearchHostStatusDetail: + properties: + hostname: + description: Hostname that corresponds to the status detail. + type: string + mainIndex: + $ref: '#/components/schemas/TextSearchIndexStatusDetail' + queryable: + description: Flag that indicates whether the index is queryable on the host. + type: boolean + stagedIndex: + $ref: '#/components/schemas/TextSearchIndexStatusDetail' + status: + description: | + Condition of the search index when you made this request. + + | Status | Index Condition | + |---|---| + | DELETING | The index is being deleted. | + | FAILED | The index build failed. Indexes can enter the FAILED state due to an invalid index definition. | + | STALE | The index is queryable but has stopped replicating data from the indexed collection. Searches on the index may return out-of-date data. | + | PENDING | Atlas has not yet started building the index. | + | BUILDING | Atlas is building or re-building the index after an edit. | + | READY | The index is ready and can support queries. | + enum: + - DELETING + - FAILED + - STALE + - PENDING + - BUILDING + - READY + - DOES_NOT_EXIST + type: string + title: Text Search Host Status Detail + type: object + TextSearchIndexCreateRequest: + allOf: + - $ref: '#/components/schemas/SearchIndexCreateRequest' + - properties: + definition: + $ref: '#/components/schemas/TextSearchIndexDefinition' + type: object + description: Text Search Index Create Request + required: + - collectionName + - database + - definition + - name + type: object + TextSearchIndexDefinition: + description: The text search index definition set by the user. + properties: + analyzer: + default: lucene.standard + description: |- + Specific pre-defined method chosen to convert database field text into searchable words. This conversion reduces the text of fields into the smallest units of text. These units are called a **term** or **token**. This process, known as tokenization, involves making the following changes to the text in fields: + + - extracting words + - removing punctuation + - removing accents + - changing to lowercase + - removing common words + - reducing words to their root form (stemming) + - changing words to their base form (lemmatization) + MongoDB Cloud uses the process you select to build the Atlas Search index. + enum: + - lucene.standard + - lucene.simple + - lucene.whitespace + - lucene.keyword + - lucene.arabic + - lucene.armenian + - lucene.basque + - lucene.bengali + - lucene.brazilian + - lucene.bulgarian + - lucene.catalan + - lucene.chinese + - lucene.cjk + - lucene.czech + - lucene.danish + - lucene.dutch + - lucene.english + - lucene.finnish + - lucene.french + - lucene.galician + - lucene.german + - lucene.greek + - lucene.hindi + - lucene.hungarian + - lucene.indonesian + - lucene.irish + - lucene.italian + - lucene.japanese + - lucene.korean + - lucene.kuromoji + - lucene.latvian + - lucene.lithuanian + - lucene.morfologik + - lucene.nori + - lucene.norwegian + - lucene.persian + - lucene.portuguese + - lucene.romanian + - lucene.russian + - lucene.smartcn + - lucene.sorani + - lucene.spanish + - lucene.swedish + - lucene.thai + - lucene.turkish + - lucene.ukrainian + externalDocs: + description: Atlas Search Analyzers + url: https://dochub.mongodb.org/core/analyzers--fts + type: string + analyzers: + description: List of user-defined methods to convert database field text into searchable words. + externalDocs: + description: Custom Atlas Search Analyzers + url: https://dochub.mongodb.org/core/custom-fts + items: + $ref: '#/components/schemas/AtlasSearchAnalyzer' + type: array + mappings: + $ref: '#/components/schemas/SearchMappings' + searchAnalyzer: + default: lucene.standard + description: Method applied to identify words when searching this index. + enum: + - lucene.standard + - lucene.simple + - lucene.whitespace + - lucene.keyword + - lucene.arabic + - lucene.armenian + - lucene.basque + - lucene.bengali + - lucene.brazilian + - lucene.bulgarian + - lucene.catalan + - lucene.chinese + - lucene.cjk + - lucene.czech + - lucene.danish + - lucene.dutch + - lucene.english + - lucene.finnish + - lucene.french + - lucene.galician + - lucene.german + - lucene.greek + - lucene.hindi + - lucene.hungarian + - lucene.indonesian + - lucene.irish + - lucene.italian + - lucene.japanese + - lucene.korean + - lucene.kuromoji + - lucene.latvian + - lucene.lithuanian + - lucene.morfologik + - lucene.nori + - lucene.norwegian + - lucene.persian + - lucene.portuguese + - lucene.romanian + - lucene.russian + - lucene.smartcn + - lucene.sorani + - lucene.spanish + - lucene.swedish + - lucene.thai + - lucene.turkish + - lucene.ukrainian + type: string + storedSource: + description: Flag that indicates whether to store all fields (true) on Atlas Search. By default, Atlas doesn't store (false) the fields on Atlas Search. Alternatively, you can specify an object that only contains the list of fields to store (include) or not store (exclude) on Atlas Search. To learn more, see Stored Source Fields. + example: + include | exclude: + - field1 + - field2 + externalDocs: + description: Stored Source Fields + url: https://dochub.mongodb.org/core/atlas-search-stored-source + type: object + synonyms: + description: Rule sets that map words to their synonyms in this index. + externalDocs: + description: Synonym Mapping + url: https://dochub.mongodb.org/core/fts-synonym-mappings + items: + $ref: '#/components/schemas/SearchSynonymMappingDefinition' + type: array + required: + - mappings + title: Text Search Index Definition + type: object + TextSearchIndexResponse: + allOf: + - $ref: '#/components/schemas/SearchIndexResponse' + - properties: + latestDefinition: + $ref: '#/components/schemas/TextSearchIndexDefinition' + statusDetail: + description: List of documents detailing index status on each host. + items: + $ref: '#/components/schemas/TextSearchHostStatusDetail' + type: array + synonymMappingStatus: + description: Status that describes this index's synonym mappings. This status appears only if the index has synonyms defined. + enum: + - FAILED + - BUILDING + - READY + type: string + synonymMappingStatusDetail: + description: A list of documents describing the status of the index's synonym mappings on each search host. Only appears if the index has synonyms defined. + items: + additionalProperties: + $ref: '#/components/schemas/SynonymMappingStatusDetail' + type: object + type: array + type: object + title: Text Search Index Response + type: object + TextSearchIndexStatusDetail: + description: Contains status information about a text search index. + properties: + definition: + $ref: '#/components/schemas/TextSearchIndexDefinition' + definitionVersion: + $ref: '#/components/schemas/SearchIndexDefinitionVersion' + message: + description: Optional message describing an error. + type: string + queryable: + description: Flag that indicates whether the index generation is queryable on the host. + type: boolean + status: + description: | + Condition of the search index when you made this request. + + | Status | Index Condition | + |---|---| + | DELETING | The index is being deleted. | + | FAILED | The index build failed. Indexes can enter the FAILED state due to an invalid index definition. | + | STALE | The index is queryable but has stopped replicating data from the indexed collection. Searches on the index may return out-of-date data. | + | PENDING | Atlas has not yet started building the index. | + | BUILDING | Atlas is building or re-building the index after an edit. | + | READY | The index is ready and can support queries. | + enum: + - DELETING + - FAILED + - STALE + - PENDING + - BUILDING + - READY + - DOES_NOT_EXIST + type: string + synonymMappingStatus: + description: Status that describes this index's synonym mappings. This status appears only if the index has synonyms defined. + enum: + - FAILED + - BUILDING + - READY + type: string + synonymMappingStatusDetail: + description: List of synonym statuses by mapping. + items: + $ref: '#/components/schemas/SynonymMappingStatusDetailMap' + type: array + title: Text Search Index Status Detail + type: object + TokenFilterEnglishPossessive: + description: Filter that removes possessives (trailing 's) from words. + properties: + type: + description: Human-readable label that identifies this token filter type. + enum: + - englishPossessive + type: string + required: + - type + title: englishPossessive + type: object + TokenFilterFlattenGraph: + description: Filter that transforms a token filter graph, such as the token filter graph that the wordDelimiterGraph token filter produces, into a flat form suitable for indexing. + properties: + type: + description: Human-readable label that identifies this token filter type. + enum: + - flattenGraph + type: string + required: + - type + title: flattenGraph + type: object + TokenFilterPorterStemming: + description: Filter that uses the porter stemming algorithm to remove the common morphological and inflectional suffixes from words in English. It expects lowercase text and doesn't work as expected for uppercase text. + properties: + type: + description: Human-readable label that identifies this token filter type. + enum: + - porterStemming + type: string + required: + - type + title: porterStemming + type: object + TokenFilterSpanishPluralStemming: + description: Filter that stems Spanish plural words. It expects lowercase text. + properties: + type: + description: Human-readable label that identifies this token filter type. + enum: + - spanishPluralStemming + type: string + required: + - type + title: spanishPluralStemming + type: object + TokenFilterStempel: + description: Filter that uses Lucene's default Polish stemmer table to stem words in the Polish language. It expects lowercase text. + externalDocs: + description: Default Polish stemmer table + url: https://lucene.apache.org/core/9_2_0/analysis/stempel/org/apache/lucene/analysis/pl/PolishAnalyzer.html#DEFAULT_STEMMER_FILE + properties: + type: + description: Human-readable label that identifies this token filter type. + enum: + - stempel + type: string + required: + - type + title: stempel + type: object + TokenFilterWordDelimiterGraph: + description: Filter that splits tokens into sub-tokens based on configured rules. + properties: + delimiterOptions: + description: Object that contains the rules that determine how to split words into sub-words. + properties: + concatenateAll: + default: false + description: Flag that indicates whether to concatenate runs. + type: boolean + concatenateNumbers: + default: false + description: Flag that indicates whether to concatenate runs of sub-numbers. + type: boolean + concatenateWords: + default: false + description: Flag that indicates whether to concatenate runs of sub-words. + type: boolean + generateNumberParts: + default: true + description: Flag that indicates whether to split tokens based on sub-numbers. For example, if `true`, this option splits `100-2` into `100` and `2`. + type: boolean + generateWordParts: + default: true + description: Flag that indicates whether to split tokens based on sub-words. + type: boolean + ignoreKeywords: + default: false + description: Flag that indicates whether to skip tokens with the `keyword` attribute set to `true` + type: boolean + preserveOriginal: + default: true + description: Flag that indicates whether to generate tokens of the original words. + type: boolean + splitOnCaseChange: + default: true + description: Flag that indicates whether to split tokens based on letter-case transitions. + type: boolean + splitOnNumerics: + default: true + description: Flag that indicates whether to split tokens based on letter-number transitions. + type: boolean + stemEnglishPossessive: + default: true + description: Flag that indicates whether to remove trailing possessives from each sub-word. + type: boolean + type: object + protectedWords: + description: Object that contains options for protected words. + properties: + ignoreCase: + default: true + description: Flag that indicates whether to ignore letter case sensitivity for protected words. + type: boolean + words: + description: List that contains the tokens to protect from delimination. + items: + type: string + type: array + required: + - words + type: object + type: + description: Human-readable label that identifies this token filter type. + enum: + - wordDelimiterGraph + type: string + required: + - type + title: wordDelimiterGraph + type: object + TokenFilterkStemming: + description: Filter that combines algorithmic stemming with a built-in dictionary for the English language to stem words. + properties: + type: + description: Human-readable label that identifies this token filter type. + enum: + - kStemming + type: string + required: + - type + title: kStemming + type: object + VectorSearchHostStatusDetail: + properties: + hostname: + description: Hostname that corresponds to the status detail. + type: string + mainIndex: + $ref: '#/components/schemas/VectorSearchIndexStatusDetail' + queryable: + description: Flag that indicates whether the index is queryable on the host. + type: boolean + stagedIndex: + $ref: '#/components/schemas/VectorSearchIndexStatusDetail' + status: + description: | + Condition of the search index when you made this request. + + | Status | Index Condition | + |---|---| + | DELETING | The index is being deleted. | + | FAILED | The index build failed. Indexes can enter the FAILED state due to an invalid index definition. | + | STALE | The index is queryable but has stopped replicating data from the indexed collection. Searches on the index may return out-of-date data. | + | PENDING | Atlas has not yet started building the index. | + | BUILDING | Atlas is building or re-building the index after an edit. | + | READY | The index is ready and can support queries. | + enum: + - DELETING + - FAILED + - STALE + - PENDING + - BUILDING + - READY + - DOES_NOT_EXIST + type: string + title: Vector Search Host Status Detail + type: object + VectorSearchIndex: + allOf: + - $ref: '#/components/schemas/ClusterSearchIndex' + - properties: + fields: + description: Settings that configure the fields, one per object, to index. You must define at least one "vector" type field. You can optionally define "filter" type fields also. + externalDocs: + description: Vector Search Fields + url: https://dochub.mongodb.org/core/avs-vector-type + items: + $ref: '#/components/schemas/BasicDBObject' + type: array + type: object + required: + - collectionName + - database + - name + type: object + VectorSearchIndexCreateRequest: + allOf: + - $ref: '#/components/schemas/SearchIndexCreateRequest' + - properties: + definition: + $ref: '#/components/schemas/VectorSearchIndexDefinition' + type: object + description: Vector Search Index Create Request + required: + - collectionName + - database + - definition + - name + type: object + VectorSearchIndexDefinition: + description: The vector search index definition set by the user. + properties: + fields: + description: Settings that configure the fields, one per object, to index. You must define at least one "vector" type field. You can optionally define "filter" type fields also. + externalDocs: + description: Vector Search Fields + url: https://dochub.mongodb.org/core/avs-vector-type + items: + $ref: '#/components/schemas/BasicDBObject' + type: array + title: Vector Search Index Definition + type: object + VectorSearchIndexResponse: + allOf: + - $ref: '#/components/schemas/SearchIndexResponse' + - properties: + latestDefinition: + $ref: '#/components/schemas/VectorSearchIndexDefinition' + statusDetail: + description: List of documents detailing index status on each host. + items: + $ref: '#/components/schemas/VectorSearchHostStatusDetail' + type: array + type: object + title: Vector Search Index Response + type: object + VectorSearchIndexStatusDetail: + description: Contains status information about a vector search index. + properties: + definition: + $ref: '#/components/schemas/VectorSearchIndexDefinition' + definitionVersion: + $ref: '#/components/schemas/SearchIndexDefinitionVersion' + message: + description: Optional message describing an error. + type: string + queryable: + description: Flag that indicates whether the index generation is queryable on the host. + type: boolean + status: + description: | + Condition of the search index when you made this request. + + | Status | Index Condition | + |---|---| + | DELETING | The index is being deleted. | + | FAILED | The index build failed. Indexes can enter the FAILED state due to an invalid index definition. | + | STALE | The index is queryable but has stopped replicating data from the indexed collection. Searches on the index may return out-of-date data. | + | PENDING | Atlas has not yet started building the index. | + | BUILDING | Atlas is building or re-building the index after an edit. | + | READY | The index is ready and can support queries. | + enum: + - DELETING + - FAILED + - STALE + - PENDING + - BUILDING + - READY + - DOES_NOT_EXIST + type: string + title: Vector Search Index Status Detail + type: object + WeeklyScheduleView: + allOf: + - $ref: '#/components/schemas/OnlineArchiveSchedule' + - properties: + dayOfWeek: + description: Day of the week when the scheduled archive starts. The week starts with Monday (`1`) and ends with Sunday (`7`). + format: int32 + maximum: 7 + minimum: 1 + type: integer + endHour: + description: Hour of the day when the scheduled window to run one online archive ends. + format: int32 + maximum: 23 + minimum: 0 + type: integer + endMinute: + description: Minute of the hour when the scheduled window to run one online archive ends. + format: int32 + maximum: 59 + minimum: 0 + type: integer + startHour: + description: Hour of the day when the when the scheduled window to run one online archive starts. + format: int32 + maximum: 23 + minimum: 0 + type: integer + startMinute: + description: Minute of the hour when the scheduled window to run one online archive starts. + format: int32 + maximum: 59 + minimum: 0 + type: integer + type: object + required: + - type + type: object + charFilterhtmlStrip: + description: Filter that strips out HTML constructs. + properties: + ignoredTags: + description: The HTML tags that you want to exclude from filtering. + items: + type: string + type: array + type: + description: Human-readable label that identifies this character filter type. + enum: + - htmlStrip + type: string + required: + - type + title: htmlStrip + type: object + charFiltericuNormalize: + description: Filter that processes normalized text with the ICU Normalizer. It is based on Lucene's ICUNormalizer2CharFilter. + externalDocs: + description: ICUNormalizer2CharFilter + url: https://lucene.apache.org/core/8_3_0/analyzers-icu/org/apache/lucene/analysis/icu/ICUNormalizer2CharFilter.html + properties: + type: + description: Human-readable label that identifies this character filter type. + enum: + - icuNormalize + type: string + required: + - type + title: icuNormalize + type: object + charFiltermapping: + description: Filter that applies normalization mappings that you specify to characters. + properties: + mappings: + description: |- + Comma-separated list of mappings. A mapping indicates that one character or group of characters should be substituted for another, using the following format: + + ` : ` + properties: + additionalProperties: + type: string + type: object + type: + description: Human-readable label that identifies this character filter type. + enum: + - mapping + type: string + required: + - mappings + - type + title: mapping + type: object + charFilterpersian: + description: Filter that replaces instances of a zero-width non-joiner with an ordinary space. It is based on Lucene's PersianCharFilter. + externalDocs: + description: PersianCharFilter + url: https://lucene.apache.org/core/8_0_0/analyzers-common/org/apache/lucene/analysis/fa/PersianCharFilter.html + properties: + type: + description: Human-readable label that identifies this character filter type. + enum: + - persian + type: string + required: + - type + title: persian + type: object + tokenFilterasciiFolding: + description: Filter that converts alphabetic, numeric, and symbolic Unicode characters that are not in the Basic Latin Unicode block to their ASCII equivalents, if available. + externalDocs: + description: Basic Latin Unicode block + url: https://en.wikipedia.org/wiki/Basic_Latin_(Unicode_block) + properties: + originalTokens: + default: omit + description: |- + Value that indicates whether to include or omit the original tokens in the output of the token filter. + + Choose `include` if you want to support queries on both the original tokens as well as the converted forms. + + Choose `omit` if you want to query only on the converted forms of the original tokens. + enum: + - omit + - include + type: string + type: + description: Human-readable label that identifies this token filter type. + enum: + - asciiFolding + type: string + required: + - type + title: asciiFolding + type: object + tokenFilterdaitchMokotoffSoundex: + description: |- + Filter that creates tokens for words that sound the same based on the Daitch-Mokotoff Soundex phonetic algorithm. This filter can generate multiple encodings for each input, where each encoded token is a 6 digit number. + + **NOTE**: Don't use the **daitchMokotoffSoundex** token filter in: + + -Synonym or autocomplete mapping definitions + - Operators where **fuzzy** is enabled. Atlas Search supports the **fuzzy** option only for the **autocomplete**, **term**, and **text** operators. + externalDocs: + description: Daitch-Mokotoff Soundex phonetic algorithm + url: https://en.wikipedia.org/wiki/Daitch%E2%80%93Mokotoff_Soundex + properties: + originalTokens: + default: include + description: |- + Value that indicates whether to include or omit the original tokens in the output of the token filter. + + Choose `include` if you want to support queries on both the original tokens as well as the converted forms. + + Choose `omit` if you want to query only on the converted forms of the original tokens. + enum: + - omit + - include + type: string + type: + description: Human-readable label that identifies this token filter type. + enum: + - daitchMokotoffSoundex + type: string + required: + - type + title: daitchMokotoffSoundex + type: object + tokenFilteredgeGram: + description: Filter that tokenizes input from the left side, or "edge", of a text input into n-grams of configured sizes. You can't use this token filter in synonym or autocomplete mapping definitions. + properties: + maxGram: + description: Value that specifies the maximum length of generated n-grams. This value must be greater than or equal to **minGram**. + type: integer + minGram: + description: Value that specifies the minimum length of generated n-grams. This value must be less than or equal to **maxGram**. + type: integer + termNotInBounds: + default: omit + description: Value that indicates whether to index tokens shorter than **minGram** or longer than **maxGram**. + enum: + - omit + - include + type: string + type: + description: Human-readable label that identifies this token filter type. + enum: + - edgeGram + type: string + required: + - maxGram + - minGram + - type + title: edgeGram + type: object + tokenFiltericuFolding: + description: 'Filter that applies character folding from Unicode Technical Report #30.' + externalDocs: + description: 'Unicode Technical Report #30' + url: http://www.unicode.org/reports/tr30/tr30-4.html + properties: + type: + description: Human-readable label that identifies this token filter type. + enum: + - icuFolding + type: string + required: + - type + title: icuFolding + type: object + tokenFiltericuNormalizer: + description: Filter that normalizes tokens using a standard Unicode Normalization Mode. + externalDocs: + description: Unicode Normalization Mode + url: https://unicode.org/reports/tr15/ + properties: + normalizationForm: + default: nfc + description: Normalization form to apply. + enum: + - nfd + - nfc + - nfkd + - nfkc + type: string + type: + description: Human-readable label that identifies this token filter type. + enum: + - icuNormalizer + type: string + required: + - type + title: icuNormalizer + type: object + tokenFilterlength: + description: Filter that removes tokens that are too short or too long. + properties: + max: + default: 255 + description: Number that specifies the maximum length of a token. Value must be greater than or equal to **min**. + type: integer + min: + default: 0 + description: Number that specifies the minimum length of a token. This value must be less than or equal to **max**. + type: integer + type: + description: Human-readable label that identifies this token filter type. + enum: + - length + type: string + required: + - type + title: length + type: object + tokenFilterlowercase: + description: Filter that normalizes token text to lowercase. + properties: + type: + description: Human-readable label that identifies this token filter type. + enum: + - lowercase + type: string + required: + - type + title: lowercase + type: object + tokenFilternGram: + description: Filter that tokenizes input into n-grams of configured sizes. You can't use this token filter in synonym or autocomplete mapping definitions. + properties: + maxGram: + description: Value that specifies the maximum length of generated n-grams. This value must be greater than or equal to **minGram**. + type: integer + minGram: + description: Value that specifies the minimum length of generated n-grams. This value must be less than or equal to **maxGram**. + type: integer + termNotInBounds: + default: omit + description: Value that indicates whether to index tokens shorter than **minGram** or longer than **maxGram**. + enum: + - omit + - include + type: string + type: + description: Human-readable label that identifies this token filter type. + enum: + - nGram + type: string + required: + - maxGram + - minGram + - type + title: nGram + type: object + tokenFilterregex: + description: Filter that applies a regular expression to each token, replacing matches with a specified string. + properties: + matches: + description: Value that indicates whether to replace only the first matching pattern or all matching patterns. + enum: + - all + - first + type: string + pattern: + description: Regular expression pattern to apply to each token. + type: string + replacement: + description: Replacement string to substitute wherever a matching pattern occurs. + type: string + type: + description: Human-readable label that identifies this token filter type. + enum: + - regex + type: string + required: + - matches + - pattern + - replacement + - type + title: regex + type: object + tokenFilterreverse: + description: Filter that reverses each string token. + properties: + type: + description: Human-readable label that identifies this token filter type. + enum: + - reverse + type: string + required: + - type + title: reverse + type: object + tokenFiltershingle: + description: Filter that constructs shingles (token n-grams) from a series of tokens. You can't use this token filter in synonym or autocomplete mapping definitions. + properties: + maxShingleSize: + description: Value that specifies the maximum number of tokens per shingle. This value must be greater than or equal to **minShingleSize**. + type: integer + minShingleSize: + description: Value that specifies the minimum number of tokens per shingle. This value must be less than or equal to **maxShingleSize**. + type: integer + type: + description: Human-readable label that identifies this token filter type. + enum: + - shingle + type: string + required: + - maxShingleSize + - minShingleSize + - type + title: shingle + type: object + tokenFiltersnowballStemming: + description: Filter that stems tokens using a Snowball-generated stemmer. + externalDocs: + description: Snowball-generated stemmer + url: https://snowballstem.org/ + properties: + stemmerName: + description: Snowball-generated stemmer to use. + enum: + - arabic + - armenian + - basque + - catalan + - danish + - dutch + - english + - finnish + - french + - german + - german2 + - hungarian + - irish + - italian + - kp + - lithuanian + - lovins + - norwegian + - porter + - portuguese + - romanian + - russian + - spanish + - swedish + - turkish + type: string + type: + description: Human-readable label that identifies this token filter type. + enum: + - snowballStemming + type: string + required: + - stemmerName + - type + title: snowballStemming + type: object + tokenFilterstopword: + description: Filter that removes tokens that correspond to the specified stop words. This token filter doesn't analyze the stop words that you specify. + properties: + ignoreCase: + default: true + description: Flag that indicates whether to ignore the case of stop words when filtering the tokens to remove. + type: boolean + tokens: + description: The stop words that correspond to the tokens to remove. Value must be one or more stop words. + items: + type: string + type: array + type: + description: Human-readable label that identifies this token filter type. + enum: + - stopword + type: string + required: + - tokens + - type + title: stopword + type: object + tokenFiltertrim: + description: Filter that trims leading and trailing whitespace from tokens. + properties: + type: + description: Human-readable label that identifies this token filter type. + enum: + - trim + type: string + required: + - type + title: trim + type: object + tokenizeredgeGram: + description: Tokenizer that splits input from the left side, or "edge", of a text input into n-grams of given sizes. You can't use the edgeGram tokenizer in synonym or autocomplete mapping definitions. + properties: + maxGram: + description: Characters to include in the longest token that Atlas Search creates. + type: integer + minGram: + description: Characters to include in the shortest token that Atlas Search creates. + type: integer + type: + description: Human-readable label that identifies this tokenizer type. + enum: + - edgeGram + type: string + required: + - maxGram + - minGram + - type + title: edgeGram + type: object + tokenizerkeyword: + description: Tokenizer that combines the entire input as a single token. + properties: + type: + description: Human-readable label that identifies this tokenizer type. + enum: + - keyword + type: string + required: + - type + title: keyword + type: object + tokenizernGram: + description: Tokenizer that splits input into text chunks, or "n-grams", of into given sizes. You can't use the nGram tokenizer in synonym or autocomplete mapping definitions. + properties: + maxGram: + description: Characters to include in the longest token that Atlas Search creates. + type: integer + minGram: + description: Characters to include in the shortest token that Atlas Search creates. + type: integer + type: + description: Human-readable label that identifies this tokenizer type. + enum: + - edgeGram + type: string + required: + - maxGram + - minGram + - type + title: nGram + type: object + tokenizerregexCaptureGroup: + description: Tokenizer that uses a regular expression pattern to extract tokens. + properties: + group: + description: Index of the character group within the matching expression to extract into tokens. Use `0` to extract all character groups. + type: integer + pattern: + description: Regular expression to match against. + type: string + type: + description: Human-readable label that identifies this tokenizer type. + enum: + - regexCaptureGroup + type: string + required: + - group + - pattern + - type + title: regexCaptureGroup + type: object + tokenizerregexSplit: + description: Tokenizer that splits tokens using a regular-expression based delimiter. + properties: + pattern: + description: Regular expression to match against. + type: string + type: + description: Human-readable label that identifies this tokenizer type. + enum: + - regexSplit + type: string + required: + - pattern + - type + title: regexSplit + type: object + tokenizerstandard: + description: Tokenizer that splits tokens based on word break rules from the Unicode Text Segmentation algorithm. + externalDocs: + description: Unicode Text Segmentation Algorithm + url: https://www.unicode.org/L2/L2019/19034-uax29-34-draft.pdf + properties: + maxTokenLength: + default: 255 + description: Maximum number of characters in a single token. Tokens greater than this length are split at this length into multiple tokens. + type: integer + type: + description: Human-readable label that identifies this tokenizer type. + enum: + - standard + type: string + required: + - type + title: standard + type: object + tokenizeruaxUrlEmail: + description: Tokenizer that creates tokens from URLs and email addresses. Although this tokenizer uses word break rules from the Unicode Text Segmentation algorithm, we recommend using it only when the indexed field value includes URLs and email addresses. For fields that don't include URLs or email addresses, use the **standard** tokenizer to create tokens based on word break rules. + externalDocs: + description: Unicode Text Segmentation Algorithm + url: https://www.unicode.org/L2/L2019/19034-uax29-34-draft.pdf + properties: + maxTokenLength: + default: 255 + description: Maximum number of characters in a single token. Tokens greater than this length are split at this length into multiple tokens. + type: integer + type: + description: Human-readable label that identifies this tokenizer type. + enum: + - uaxUrlEmail + type: string + required: + - type + title: uaxUrlEmail + type: object + tokenizerwhitespace: + description: Tokenizer that creates tokens based on occurrences of whitespace between words. + properties: + maxTokenLength: + default: 255 + description: Maximum number of characters in a single token. Tokens greater than this length are split at this length into multiple tokens. + type: integer + type: + description: Human-readable label that identifies this tokenizer type. + enum: + - whitespace + type: string + required: + - type + title: whitespace + type: object + securitySchemes: + DigestAuth: + scheme: digest + type: http From b0c032b23d6a0660e2182949a1b489e3df0ef5cf Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Thu, 25 Sep 2025 12:25:03 +0100 Subject: [PATCH 07/14] Update contributing.md --- CONTRIBUTING.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index d1238ca141..0328ee3f64 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -188,6 +188,15 @@ Before adding a command please make sure that your api exists in the GO SDK. > [!TIP] > Atlas CLI provides an experimental generator, make sure to try it out in [tools/cli-generator](./tools/cli-generator) +### Making changes to API Generator + +API generator is a tool that generates code based on Atlas OpenAPI specification. +It is used to generate `./internal/api/commands.go` file that contains all API commands. + +If you are making changes to the generator please make sure to run `make gen-api-commands` to update the generated code. + +Please also run `UPDATE_SNAPSHOTS=true go test ./...` from the `tools/cmd/api-generator` directory to update the snapshots. When you run the command for the first time it will fail, showing the diff. Upon running the command again the test will pass as the snapshots have been updated. + ### API Interactions Atlas CLI use [atlas-sdk-go](https://github.com/mongodb/atlas-sdk-go) for all backend integration. From d85b0fe415c82a107284747ffe613df2b57636c8 Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Thu, 25 Sep 2025 12:27:07 +0100 Subject: [PATCH 08/14] Use := instead of var --- internal/cli/api/api.go | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/internal/cli/api/api.go b/internal/cli/api/api.go index 90dacdd43e..9d827663c0 100644 --- a/internal/cli/api/api.go +++ b/internal/cli/api/api.go @@ -98,8 +98,8 @@ func createAPICommandGroupToCobraCommand(group shared_api.Group) *cobra.Command //nolint:gocyclo func convertAPIToCobraCommand(command shared_api.Command) (*cobra.Command, error) { // command properties - var commandName = strcase.ToLowerCamel(command.OperationID) - var commandAliases = command.Aliases + commandName := strcase.ToLowerCamel(command.OperationID) + commandAliases := command.Aliases // Prefer to use shortOperationID if present if command.ShortOperationID != "" { From eaa9ab9f1e5be0e70ac41fe44f81b770867132fe Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Fri, 26 Sep 2025 09:52:19 +0100 Subject: [PATCH 09/14] Move alias logic out of ExtractExtensionsFromOperation --- internal/cli/api/api.go | 5 +- tools/cmd/api-generator/convert_commands.go | 61 +++++++-------------- 2 files changed, 24 insertions(+), 42 deletions(-) diff --git a/internal/cli/api/api.go b/internal/cli/api/api.go index 9d827663c0..738b9a2943 100644 --- a/internal/cli/api/api.go +++ b/internal/cli/api/api.go @@ -101,10 +101,11 @@ func convertAPIToCobraCommand(command shared_api.Command) (*cobra.Command, error commandName := strcase.ToLowerCamel(command.OperationID) commandAliases := command.Aliases - // Prefer to use shortOperationID if present if command.ShortOperationID != "" { + // Add original operation ID to aliases + commandAliases = append(commandAliases, commandName) + // Use shortOperationID as command name commandName = strcase.ToLowerCamel(command.ShortOperationID) - commandAliases = append(commandAliases, strcase.ToLowerCamel(command.OperationID)) } shortDescription, longDescription := splitShortAndLongDescription(command.Description) diff --git a/tools/cmd/api-generator/convert_commands.go b/tools/cmd/api-generator/convert_commands.go index 407ee31352..d7d97cccdb 100644 --- a/tools/cmd/api-generator/convert_commands.go +++ b/tools/cmd/api-generator/convert_commands.go @@ -113,55 +113,32 @@ func extractExtensionsFromOperation(operation *openapi3.Operation) operationExte operationAliases: []string{}, } - processAtlasCLIExtensions(&ext, operation.Extensions) - processShortOperationIDOverride(&ext, operation) - - return ext -} - -func processAtlasCLIExtensions(ext *operationExtensions, extensions map[string]any) { - atlasCLIExt, ok := extensions["x-xgen-atlascli"].(map[string]any) - if !ok || atlasCLIExt == nil { - return + if shortOperationID, ok := operation.Extensions["x-xgen-operation-id-override"].(string); ok && shortOperationID != "" { + ext.shortOperationID = shortOperationID } - if extSkip, okSkip := atlasCLIExt["skip"].(bool); okSkip && extSkip { - ext.skip = extSkip - } + if extensions, okExtensions := operation.Extensions["x-xgen-atlascli"].(map[string]any); okExtensions && extensions != nil { + if extSkip, okSkip := extensions["skip"].(bool); okSkip && extSkip { + ext.skip = extSkip + } - if extAliases, okExtAliases := atlasCLIExt["command-aliases"].([]any); okExtAliases && extAliases != nil { - for _, alias := range extAliases { - if sAlias, ok := alias.(string); ok && sAlias != "" { - ext.operationAliases = append(ext.operationAliases, sAlias) + if extAliases, okExtAliases := extensions["command-aliases"].([]any); okExtAliases && extAliases != nil { + for _, alias := range extAliases { + if sAlias, ok := alias.(string); ok && sAlias != "" { + ext.operationAliases = append(ext.operationAliases, sAlias) + } } } - } - if overrides := extractOverrides(extensions); overrides != nil { - if overriddenOperationID, ok := overrides["operationId"].(string); ok && overriddenOperationID != "" { - ext.operationID = overriddenOperationID + if overrides := extractOverrides(operation.Extensions); overrides != nil { + if overriddenOperationID, ok := overrides["operationId"].(string); ok && overriddenOperationID != "" { + ext.operationID = overriddenOperationID + ext.shortOperationID = "" + } } } -} -func processShortOperationIDOverride(ext *operationExtensions, operation *openapi3.Operation) { - shortOperationID, ok := operation.Extensions["x-xgen-operation-id-override"].(string) - if !ok || shortOperationID == "" { - return - } - - ext.shortOperationID = shortOperationID - - // Only add original operation ID to aliases if there's no Atlas CLI operation ID override - overrides := extractOverrides(operation.Extensions) - if overrides == nil { - ext.operationAliases = append(ext.operationAliases, strcase.ToLowerCamel(operation.OperationID)) - return - } - - if _, hasOverride := overrides["operationId"].(string); !hasOverride { - ext.operationAliases = append(ext.operationAliases, strcase.ToLowerCamel(operation.OperationID)) - } + return ext } func operationToCommand(now time.Time, path, verb string, operation *openapi3.Operation) (*api.Command, error) { @@ -205,6 +182,10 @@ func operationToCommand(now time.Time, path, verb string, operation *openapi3.Op } } + if shortOperationID != "" { + aliases = append(aliases, strcase.ToLowerCamel(operationID)) + } + watcher, err := extractWatcherProperties(operation.Extensions) if err != nil { return nil, err From 84ac91089b06d56d54ddcb3684c4834a2bbce2db Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Fri, 26 Sep 2025 11:10:26 +0100 Subject: [PATCH 10/14] Remove duplicate check --- tools/cmd/api-generator/convert_commands.go | 7 ------- 1 file changed, 7 deletions(-) diff --git a/tools/cmd/api-generator/convert_commands.go b/tools/cmd/api-generator/convert_commands.go index d7d97cccdb..fa897bb2ed 100644 --- a/tools/cmd/api-generator/convert_commands.go +++ b/tools/cmd/api-generator/convert_commands.go @@ -175,13 +175,6 @@ func operationToCommand(now time.Time, path, verb string, operation *openapi3.Op return nil, fmt.Errorf("failed to clean description: %w", err) } - if overrides := extractOverrides(operation.Extensions); overrides != nil { - if overriddenOperationID, ok := overrides["operationId"].(string); ok && overriddenOperationID != "" { - operationID = overriddenOperationID - shortOperationID = "" - } - } - if shortOperationID != "" { aliases = append(aliases, strcase.ToLowerCamel(operationID)) } From cacaf244702e631b0a4d51406101ee3fb41b1ec5 Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Fri, 26 Sep 2025 14:26:25 +0100 Subject: [PATCH 11/14] Remove duplicate alias append and set cobra command operationID --- internal/cli/api/api.go | 6 ++++-- tools/cmd/api-generator/convert_commands.go | 4 ---- 2 files changed, 4 insertions(+), 6 deletions(-) diff --git a/internal/cli/api/api.go b/internal/cli/api/api.go index 738b9a2943..ac935793e6 100644 --- a/internal/cli/api/api.go +++ b/internal/cli/api/api.go @@ -99,13 +99,15 @@ func createAPICommandGroupToCobraCommand(group shared_api.Group) *cobra.Command func convertAPIToCobraCommand(command shared_api.Command) (*cobra.Command, error) { // command properties commandName := strcase.ToLowerCamel(command.OperationID) + commandOperationID := command.OperationID commandAliases := command.Aliases if command.ShortOperationID != "" { // Add original operation ID to aliases commandAliases = append(commandAliases, commandName) - // Use shortOperationID as command name + // Use shortOperationID commandName = strcase.ToLowerCamel(command.ShortOperationID) + commandOperationID = command.ShortOperationID } shortDescription, longDescription := splitShortAndLongDescription(command.Description) @@ -127,7 +129,7 @@ func convertAPIToCobraCommand(command shared_api.Command) (*cobra.Command, error Short: shortDescription, Long: longDescription, Annotations: map[string]string{ - "operationId": command.OperationID, + "operationId": commandOperationID, }, PreRunE: func(cmd *cobra.Command, _ []string) error { // Go through all commands that have not been touched/modified by the user and try to populate them from the users profile diff --git a/tools/cmd/api-generator/convert_commands.go b/tools/cmd/api-generator/convert_commands.go index fa897bb2ed..38e90d18e8 100644 --- a/tools/cmd/api-generator/convert_commands.go +++ b/tools/cmd/api-generator/convert_commands.go @@ -175,10 +175,6 @@ func operationToCommand(now time.Time, path, verb string, operation *openapi3.Op return nil, fmt.Errorf("failed to clean description: %w", err) } - if shortOperationID != "" { - aliases = append(aliases, strcase.ToLowerCamel(operationID)) - } - watcher, err := extractWatcherProperties(operation.Extensions) if err != nil { return nil, err From 22859db92def04e7b6690b9eeb7c3c22aa54cf1e Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Fri, 26 Sep 2025 14:29:01 +0100 Subject: [PATCH 12/14] Update snapshot --- .../12-short-operationid-override.yaml-commands.snapshot | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tools/cmd/api-generator/testdata/.snapshots/12-short-operationid-override.yaml-commands.snapshot b/tools/cmd/api-generator/testdata/.snapshots/12-short-operationid-override.yaml-commands.snapshot index 3752878325..f639d68d88 100644 --- a/tools/cmd/api-generator/testdata/.snapshots/12-short-operationid-override.yaml-commands.snapshot +++ b/tools/cmd/api-generator/testdata/.snapshots/12-short-operationid-override.yaml-commands.snapshot @@ -112,7 +112,7 @@ NOTE: Groups and projects are synonymous terms. Your group id is the same as you { OperationID: `listClusters`, ShortOperationID: `listClustersShort`, - Aliases: []string{`listClusters`}, + Aliases: nil, Description: `Returns the details for all clusters in the specific project to which you have access. Clusters contain a group of hosts that maintain the same data set. The response includes clusters with asymmetrically-sized shards. To use this resource, the requesting API Key must have the Project Read Only role. This feature is not available for serverless clusters. This command is autogenerated and corresponds 1:1 with the Atlas API endpoint https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-listclusters. From 3ba0e64b95b5a0b0cc3b9adc34c60f7ea7d81edd Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Mon, 6 Oct 2025 10:55:48 +0100 Subject: [PATCH 13/14] Revert removal of operationId override --- tools/cmd/api-generator/convert_commands.go | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/tools/cmd/api-generator/convert_commands.go b/tools/cmd/api-generator/convert_commands.go index 38e90d18e8..4bc0926b37 100644 --- a/tools/cmd/api-generator/convert_commands.go +++ b/tools/cmd/api-generator/convert_commands.go @@ -175,6 +175,12 @@ func operationToCommand(now time.Time, path, verb string, operation *openapi3.Op return nil, fmt.Errorf("failed to clean description: %w", err) } + if overrides := extractOverrides(operation.Extensions); overrides != nil { + if overriddenOperationID, ok := overrides["operationId"].(string); ok && overriddenOperationID != "" { + operationID = overriddenOperationID + } + } + watcher, err := extractWatcherProperties(operation.Extensions) if err != nil { return nil, err From cf73247a34283a14f1967890add8b107f62cc21b Mon Sep 17 00:00:00 2001 From: Luke Sanderson Date: Mon, 6 Oct 2025 12:02:19 +0100 Subject: [PATCH 14/14] Add comment about multiple operationID overrides for clarity --- tools/cmd/api-generator/convert_commands.go | 1 + 1 file changed, 1 insertion(+) diff --git a/tools/cmd/api-generator/convert_commands.go b/tools/cmd/api-generator/convert_commands.go index 4bc0926b37..764fd6b3b7 100644 --- a/tools/cmd/api-generator/convert_commands.go +++ b/tools/cmd/api-generator/convert_commands.go @@ -130,6 +130,7 @@ func extractExtensionsFromOperation(operation *openapi3.Operation) operationExte } } + // OperationID override for x-xgen-atlascli. This takes priority over x-xgen-operation-id-override. if overrides := extractOverrides(operation.Extensions); overrides != nil { if overriddenOperationID, ok := overrides["operationId"].(string); ok && overriddenOperationID != "" { ext.operationID = overriddenOperationID