1 つのフレキシブルなクラスターのアップグレード

POST /api/atlas/v2/groups/{groupId}/flexClusters:tenantUpgrade
サービス アカウント DigestAuth

フレックス クラスターを指定されたプロジェクトの専有クラスター（M 10 +）にアップグレードします。このリソースを使用するには、リクエスト元のサービス アカウントまたは API キーにプロジェクト クラスター マネージャーのロールが必要です。

path パラメータ

  • グループ ID string 必須

    プロジェクトを識別する一意の 24 桁の 16 進数文字列。 認証済みユーザーがアクセスできるすべてのプロジェクトを取得するには、 /groups エンドポイントを使用します。

    注: グループとプロジェクトは同義語です。そのため、グループ ID はプロジェクト ID と同じです。既存のグループの場合、グループ/プロジェクト ID は同じままです。リソースおよび対応するエンドポイントでは、グループという用語が使用されます。

    形式は次のパターンと一致する必要があります: ^([a-f0-9]{24})$。

クエリ パラメータ

  • envelope ブール値

    アプリケーションがレスポンスを envelope JSON オブジェクトにラップするかどうかを示すフラグ。一部の API クライアントは、HTTP レスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope=true を設定します。結果のリストを返すエンドポイントは、結果オブジェクトをエンベロープとして使用します。アプリケーションは、レスポンス本体にステータス パラメータを追加します。

    デフォルト値はfalseです。

  • pretty ブール値

    レスポンス本体を pretty-print 形式にするかどうかを示すフラグ。

    デフォルト値はfalseです。

    Prettyprint
application/vnd.atlas.2024-11-13+json

body 必須

指定されたプロジェクト内の Flex クラスターのアップグレードの詳細。

  • acceptDataRisksAndForceReplicaSetReconfig string(date-time)

    リージョン停止によりプライマリを復旧するために再構成が必要な場合は、トポロジーの再構成と一緒にこのフィールドを送信して、新たなリージョン停止に耐性のあるトポロジーをリクエストしてください。複製された書込み（過半数がコミットされた書込みであっても）が新しいプライマリ ノードに複製されていない場合、選挙可能なノードの大部分が停止している間に強制再構成を行うと、データが失われるリスクがあります。MongoDB Atlas のドキュメントに詳しい情報が記載されています。このリスクを伴う操作を続行するには、acceptDataRisksAndForceReplicaSetReconfig を現在の日付に設定してください。 このパラメーターは、UTC の ISO 8601 タイムスタンプ形式で値を表します。

    リージョン停止時のレプリカセットの再構成
  • 高度な構成 オブジェクト

    高度な構成の詳細のサブセットを構成する設定のグループ。

    advancedConfiguration 属性を非表示にする advancedConfiguration 属性の表示 オブジェクト
    • customOpensslCisphereConfigTls12 array[string]

      TLS 1.2 のカスタム OpenSSL 暗号スイート リスト。 このフィールドは、tlsCipherConfigMode が CUSTOM に設定されている場合にのみ有効です。

      値は TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 または TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 です。

    • minimumEnabledTlsProtocol string

      クラスターが受信接続に受け入れる TLS（Transport Layer Security）の最小バージョン。TLS 1.0 または 1.1 を使用するクラスターでは、TLS プロトコルの最小バージョンとして TLS 1.2 を設定することを検討する必要があります。

      値は TLS1_0、TLS1_1、または TLS1_2 です。

      このオプションは、`netsldisabledProtocols` `mongod`構成ファイルオプションに相当します
    • tlsCisphereConfigMode string

      TLS 暗号スイートの 構成モード。 デフォルトモードでは、デフォルトの暗号スイートが使用されます。 カスタムモードでは、 TLS 1.2 と TLS 1.3 の両方のカスタム暗号スイートを指定できます。

      値は CUSTOM または DEFAULT です。

  • backupEnabled ブール値

    クラスターがバックアップを実行できるかどうかを示すフラグ。true に設定されている場合、クラスターはバックアップを実行できます。true NVMe クラスターの場合、この値を に設定する必要があります。バックアップは、専有クラスターには クラウドバックアップ を使用し、テナント クラスターには 共有クラスター バックアップ を使用します。false に設定されている場合は、クラスターはバックアップを使用しません。

    デフォルト値はfalseです。

    クラウドバックアップ
  • BI Connector オブジェクト

    このクラスターの MongoDB Connector for Business Intelligence を構成するために必要な設定。

    MongoDB Connector for Business Intelligence
    bioConnector 属性を非表示にする bioConnector 属性の表示 オブジェクト
    • enabled ブール値

      MongoDB Connector for Business Intelligence が指定されたクラスターで有効になっているかどうかを示すフラグ。

    • readPreference string

      MongoDB Cloud 上のMongoDB Connector for Business Intelligence に指定されたデータソースノード。 MongoDB Cloud 上のMongoDB Connector for Business Intelligence は、 読み込み設定（read preference） に基づいて、プライマリ、セカンダリ、または分析ノードからデータを読み取ります。デフォルトは ANALYTICSノード、または ANALYTICS ノードがない場合は SECONDARY になります。

      値は PRIMARY、SECONDARY、または ANALYTICS です。

      BI Connector の 読み込み設定 (read preference)
  • clusterType string

    クラスターを構成するノードの構成。

    値は REPLICASET、SHARDED、または GEOSHARDED です。

  • configServerManagementMode string

    シャーディングされたクラスターを作成または更新するためのコンフィギュレーションサーバー マネジメント モード。

    ATLAS_MANAGED として構成されている場合、Atlas は最適なパフォーマンスとコスト削減のために、クラスターのコンフィギュレーションサーバーの種類を自動的に切り替える場合があります。

    FIXED_TO_DEDICATED として構成すると、クラスターは常に専用のコンフィギュレーションサーバーを使用します。

    値は ATLAS_MANAGED または FIXED_TO_DEDICATED です。デフォルト値は ATLAS_MANAGED です。

    MongoDB シャーディングされたクラスターのコンフィギュレーション サーバー
  • diskWarmingMode string

    ディスク ウォーミング モードの選択。

    値は FULLY_WARMED または VISIBLE_EARLIER です。デフォルト値は FULLY_WARMED です。

    セカンダリ ディスク ウォーミングの影響軽減
  • encryptionAtRestProvider string

    カスタマー キーを管理して、クラスターの保管時の暗号化の追加レイヤーを提供するクラウド サービス プロバイダー。保管時の暗号化のためのカスタマー キー管理を有効にするには、クラスター eplicationSpecs[n].regionConfigs[m].{type}Specs.instanceSize の設定は、M10 以上、かつ "backupEnabled" : false または完全に省略する必要があります。

    値は、NONE、AWS、AZURE、または GCP です。

    カスタマー キー管理を使用した保管時の暗号化
  • globalClusterSelfManagedSharding ブール値

    新しいグローバルクラスターを作成するときに、シャーディング管理モードを構成するには、このフィールドを に設定します。

    false に設定されている場合、マネジメント モードは Atlas マネージド シャーディングに設定されます。このモードはグローバルクラスターのシャーディングを完全に管理し、シームレスな配置エクスペリエンスを提供するように構築されています。

    true に設定されている場合、マネジメント モードは自己管理型シャーディングに設定されます。このモードは、シャードの管理をユーザーに委ね、高度で柔軟な配置エクスペリエンスを提供するように構築されています。

    この設定は、クラスターが配置されると変更できません。

    グローバルクラスターの作成
  • labels array[オブジェクト] 非推奨

    クラスターにタグを付けて分類する、長さが 1 から 255 文字のキーと値のペアのコレクション。MongoDB Cloud コンソールはラベルを表示しません。

    クラスター ラベルは非推奨であり、将来のリリースで削除される予定です。代わりにリソース タグを使用することを強くお勧めします。

    このMongoDB Cloud コンポーネントに適用された、人間が判読可能なラベル。

    Resource Tags
    ラベル属性を非表示 ラベル属性の表示 オブジェクト
    • キー string

      このコンポーネントをタグ付けおよび分類するために適用されるキー。

      最小長は 1、最大長は 255 です。

    • 価値 string

      このコンポーネントをタグ付けおよび分類するために適用されるキーに設定された値。

      最小長は 1、最大長は 255 です。

  • mongoDBEmployeeAccessGrant オブジェクト

    MongoDB 従業員に付与されるクラスターのアクセスレベルと有効期限。

    mongoDBEmployeeAccessGrant 属性を非表示 mongoDBEmployeeAccessGrant 属性の表示 オブジェクト
    • expirationTime string(date-time) 必須

      従業員アクセス権の有効期限。このパラメーターは、UTC の ISO 8601 タイムスタンプ形式で値を表します。

    • granType string 必須

      MongoDB 従業員に付与するアクセス権のレベル。

      値は CLUSTER_DATABASE_LOGS、CLUSTER_INFRASTRUCTURE、または CLUSTER_INFRASTRUCTURE_AND_APP_SERVICES_SYNC_DATA です。

  • mongoDBMajorVersion string

    クラスターのMongoDBメジャー バージョン。 バイナリ メジャー バージョンに設定します。

    作成時: 利用可能な MongoDB のバージョンから選択するか、MongoDB Cloud プラットフォームで現在推奨されているデフォルトを未指定のままにします。推奨バージョンは、最新の長期サポートバージョンです。デフォルト設定は、全リリース サイクルを通じて最新のリリース バージョンであることを保証するものではありません。特定のプロジェクトで利用可能なバージョンについては、リンクされたドキュメントを参照するか、プロジェクト LTS バージョン エンドポイントの API エンドポイントを使用してください。

    更新時: 一度に1メジャー バージョンを つだけ上げてください。 クラスターが、現在の MongoDB バージョンより 1 つ下の MongoDB 機能の互換性バージョンに固定されている場合は、MongoDB バージョンはそれ以前のメジャー バージョンにダウングレードできます。

    Atlas で利用可能な MongoDB のバージョン
  • name string 必須

    クラスターを識別する人間が判読できるラベル。

    形式は次のパターンと一致する必要があります: ^[a-zA-Z0-9][a-zA-Z0-9-]*$。

  • paused ブール値

    クラスターが一時停止しているかどうかを示すフラグ。

  • pitEnabled ブール値

    クラスターが継続的なクラウドバックアップを使用するかどうかを示すフラグ。

    継続的なクラウドバックアップ
  • redactClientLogData ブール値

    ログリダクションを有効または無効にします。

    この設定では、ロギング前に特定のログ イベントに付随するメッセージからドキュメント フィールドの内容をすべて編集するように mongod または mongos を構成します。これにより、データベースに格納されている機密性が高い可能性のあるデータをプログラムが診断ログに書き込むことを防止します。エラー コードや操作 コード、行番号、ソース ファイル名などのメタデータは、引き続きログに表示されます。

    規制要件へのコンプライアンスを支援するため、redactClientLogData を保管時の暗号化および TLS/SSL（トランスポート暗号化）と組み合わせて使用します。

    注: クラスターでこの設定を変更すると、クラスターの更新後すぐにローリング再起動がトリガーされます。

    ログ リダクション
  • replicaSetScalingStratey string

    クラスターのレプリカセット スケーリング モードを構成するには、このフィールドを に設定します。

    デフォルトでは、Atlas は WORKLOAD_Type の下でスケーリングされます。 このモードでは、Atlas は分析ノードを運用ノードと並行して拡張できます。

    SEQUENTIAL として構成すると、Atlas はすべてのノードを順番にスケーリングします。 このモードは、定常状態のワークロードとレイテンシの影響を受けやすいセカンダリ読み取りを実行するアプリケーションを対象としています。

    Node_type として構成すると、Atlas は選択可能なノードを読み取り専用ノードと分析ノードと並行してスケーリングします。 このモードは、頻繁にクラスター階層をスケーリングすることを必要とする大規模で動的ワークロードを対象としています。 これは最速のスケーリング戦略ですが、大量のセカンダリ読み取りを実行するとワークロードのレイテンシに影響を与える可能性があります。

    値は SEQUENTIAL、WORKLOAD_TYPE、または NODE_TYPE です。デフォルト値は WORKLOAD_TYPE です。

    レプリカセットのスケーリングモードの変更
  • replicationSpecs array[オブジェクト]

    クラスター リージョンを構成する設定のリスト。 この配列には、各シャードのノード構成を表すシャードごとに 1 つのオブジェクトが含まれます。 レプリカセットの場合、ノード構成を表すオブジェクトは 1 つだけです。

    MongoDB Cloud が指定されたMongoDBデータベースでデータを複製する方法を説明する詳細。

    replicationSpecs 属性を非表示にする replicationSpecs 属性の表示 オブジェクト
    • regionConfigs array[オブジェクト]

      特定のリージョンに設定されたノードのハードウェア仕様。各regionConfigsオブジェクトは、replicationSpec内のリージョンとクラウドプロバイダーによって一意である必要があります。各regionConfigsオブジェクトは、選挙におけるリージョンの優先順位と、MongoDB Cloud がリージョンに配置するMongoDBノードの数とタイプを記述します。各 regionConfigs オブジェクトには、AnalyticsSpecs オブジェクト、ElectronSpecs オブジェクト、または readOnlySpecs オブジェクトのいずれかが必要です。テナント クラスターには ElectableSpecs のみが必要です。専有クラスターはこれらの仕様のいずれかを指定できますが、 replicationSpec 内に少なくとも 1 つの selectableSpecs オブジェクトが必要です。

      例:

      "replicationSpecs[n].regionConfigs[m].analyticsSpecs.instanceSize" : "M30" を設定する場合は、"replicationSpecs[n].regionConfigs[m].electableSpecs.instanceSize" : "M 30 " if you have electable nodes and "replicationSpecs[n].regionConfigs[m].readOnlySpecs.instanceSize" を設定します: 読み取り専用ノードがある場合は "M30"。

      次の 1 つ：
      AWSオブジェクト AZUREオブジェクト GCPオブジェクト TENANTオブジェクト
    • zoneName string

      グローバルクラスター内のこのシャードが属するゾーンを説明する、人間が判読可能なラベル。 この値は、 "clusterType" : "GEOSHARDED" であり、 "SelfManagedSharding" : true でない場合にのみ提供します。

  • rootCertType string

    MongoDB Atlasクラスターが使用するルート認証局。MongoDB Cloud は Internet Research Group をサポートしています。

    値は ISRGROOTX1 です。デフォルト値は ISRGROOTX1 です。

  • tags array[オブジェクト]

    クラスターにタグを付けて分類する、長さが 1 から 255 文字のキーと値のペアを含むリスト。

    MongoDB Cloud の組織、プロジェクト、または クラスター をタグ付けして分類するキーと値のペア。例、environment : production。

    Resource Tags
    Hide tags attributes タグ属性の表示 オブジェクト
    • キー string 必須

      タグのセットを定義する定数。 たとえば、 environment : productionタグ内のenvironment 。

      最小長は 1、最大長は 255 です。

    • 価値 string 必須

      タグのセットに属する 変数 。 たとえば、 environment : productionタグ内のproduction 。

      最小長は 1、最大長は 255 です。

  • terminationProtectionEnabled ブール値

    クラスターで終了保護が有効になっているかどうかを示すフラグ。true に設定されていると、MongoDB Cloud はクラスターを削除しません。false に設定されていると、MongoDB Cloud はクラスターを削除します。

    デフォルト値はfalseです。

  • versionReleaseSystem string

    クラスターが MongoDB のバージョンを管理する方法。値が CONTINUOUS の場合、mongoDBMajorVersion を指定しないでください。

    値は LTS または CONTINUOUS です。デフォルト値は LTS です。

応答

  • 200 application/vnd.atlas.2024-11-13+json

    OK

    応答属性の非表示 応答属性の表示 オブジェクト
    • backupSettings オブジェクト

      柔軟なバックアップ構成。

      backupSettings 属性を非表示 backupSettings 属性の表示 オブジェクト
      • enabled ブール値

        このフレキシブルなクラスターに対してバックアップが実行されているかどうかを示すフラグ。バックアップはフレキシブルなクラスターバックアップを使用します。

        デフォルト値はtrueです。

        フレキシブルなクラスターバックアップ
    • clusterType string

      柔軟なクラスタートポロジー。

      値は REPLICASET です。デフォルト値は REPLICASET です。

    • 接続文字列 オブジェクト

      MongoDB データベースを指すユニフォーム リソース ロケータのコレクション。

      接続文字列 URI形式
      connectionStrings 属性を非表示にする connectionStrings 属性の表示 オブジェクト
      • 標準 string

        このクラスターに接続するために使用できるパブリック接続文字列。この接続文字列では mongodb://プロトコルを使用します。

        接続文字列 URI 形式
      • standardSrv string

        このフレキシブルなクラスターに接続するために使用できるパブリック接続文字列。この接続文字列はmongodb+srv://プロトコルを使用します。

        接続文字列 URI 形式
    • createDate string(date-time)

      MongoDB Cloud がこのインスタンスを作成した日時。このパラメーターは、UTC の ISO 8601形式で値を表します。

    • グループ ID string

      プロジェクトを識別するユニークな 24 桁の 16 進数の文字列。

      形式は次のパターンと一致する必要があります: ^([a-f0-9]{24})$。

    • id string

      インスタンスを識別する一意の 24 桁の 16 進数文字列。

      形式は次のパターンと一致する必要があります: ^([a-f0-9]{24})$。

    • Links array[オブジェクト]

      APIサブリソース、関連APIリソース、またはその両方を点する 1 つ以上の Uniform Resource Locator（URL）のリスト。 RFC 5988 はこれらの関係の概要をまとめています。

      Web リンク仕様（RFC 5988）
      リンク属性を非表示にする リンク属性を表示する オブジェクト
      • href string

        この応答が何らかの関係を持つ別のAPIリソースを示す Uniform Resource Locator（ URL ）。このURL は、多くの場合、https://cloud.mongodb.com/api/atlas で始まります。

      • リリース string

        このリソースと別のAPIリソースの間のセマンティック関係を定義する Uniform Resource Locator ( URL ) 。このURL は、多くの場合、https://cloud.mongodb.com/api/atlas で始まります。

    • mongoDBVersion string

      インスタンスが実行するMongoDBのバージョン。

      形式は次のパターンと一致する必要があります: ([\d]+\.[\d]+\.[\d]+)。

    • name string

      インスタンスを識別する、人間が判読可能なラベル。

      形式は次のパターンと一致する必要があります: ^[a-zA-Z0-9][a-zA-Z0-9-]*$。

    • providerSettings オブジェクト 必須

      プロビジョニングされた MongoDB フレックスクラスタを構成するクラウドプロバイダー設定のグループ。

      providerSettings 属性を非表示にする providerSettings 属性の表示 オブジェクト
      • backupProviderName string

        MongoDB Cloud が Flex クラスターをプロビジョニングしたクラウド サービス プロバイダー。

        値は AWS、AZURE、または GCP です。

      • diskSizeGB number(double)

        フレキシブルなクラスターで使用可能なストレージキャパシティー（ギガバイト単位）。

      • providerName string

        プロバイダーの種類を識別する、人間が判読可能なラベル。

        値は FLEX です。デフォルト値は FLEX です。

      • regionName string

        MongoDB Flex クラスターの地理的ロケーションを識別する、人間に判読可能なラベル。選択したリージョンは、データベースにアクセスするクライアントのネットワークレイテンシに影響する可能性があります。リージョン名の完全なリストについては、 AWS 、 GCP 、 Azure を参照してください。

    • StateName string

      Atlas コントロール プレーンによってこのクラスターで実行されている現在のアクティビティを示す、人間が判読可能なラベル。CR表現と削除がノードな状態を除く

      • IDLE: Atlas はこのクラスターに変更を加えず、 UIまたはAPI経由でリクエストされたすべての変更が適用されたと想定できます。
      • CREATING: 初めてプロビジョニングされたクラスターは、接続の準備が整うまで状態が CRUDING を返します。接続を試みる前に、 IPアクセス リストと DB ユーザーが設定されていることを確認します。
      • UPDATING: UI、 API、AutoScaling、またはその他のスケジュールされたアクティビティからリクエストされた変更が実行されています。
      • DELETING: クラスターは削除プロセス中であり、すぐに削除される予定です。
      • REPAIRING: クラスター内の 1 つ以上のノードが Atlas コントロール プレーンによって使用可能に返されています。他のノードは、通常どおりサービスを提供し続ける必要があります。

      値は、IDLE、CREATING、UPDATING、DELETING、または REPAIRING です。

    • tags array[オブジェクト]

      インスタンスのタグ付けと分類に使用する、長さが 1 から 255 文字のキーと値のペアを含むリスト。

      MongoDB Cloud の組織、プロジェクト、または クラスター をタグ付けして分類するキーと値のペア。例、environment : production。

      Resource Tags
      Hide tags attributes タグ属性の表示 オブジェクト
      • キー string 必須

        タグのセットを定義する定数。 たとえば、 environment : productionタグ内のenvironment 。

        最小長は 1、最大長は 255 です。

      • 価値 string 必須

        タグのセットに属する 変数 。 たとえば、 environment : productionタグ内のproduction 。

        最小長は 1、最大長は 255 です。

    • terminationProtectionEnabled ブール値

      クラスターで終了保護が有効になっているかどうかを示すフラグ。true に設定されていると、MongoDB Cloud はクラスターを削除しません。false に設定されていると、MongoDB Cloud はクラスターを削除します。

      デフォルト値はfalseです。

    • versionReleaseSystem string

      クラスターがMongoDB のバージョンを管理する方法。

      値は LTS です。デフォルト値は LTS です。
  • 400 application/ JSON

    無効なリクエストです。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      無効なリクエストの詳細。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        クライアントリクエストにおけるすべての違反を説明します。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト
        • 説明 string 必須

          リクエスト要素が禁止されている理由の説明。

        • フィールド string 必須

          リクエスト本文内のフィールドにつながるパス。

    • 詳細 string

      各タイプのエラーの原因となる特定の条件または理由について説明します。

    • エラー integer(int32) 必須

      このエラーで返された HTTP ステータス コード。

      外部ドキュメント
    • errorCode string 必須

      このエラーで返されたアプリケーション エラー コード。

    • パラメーター array[オブジェクト]

      エラーに関する詳細情報を提供するために使用されるパラメーター。

    • 理由 string

      このエラーで返されたアプリケーション エラー メッセージ。
  • 401 application/ JSON

    許可されていません。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      無効なリクエストの詳細。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        クライアントリクエストにおけるすべての違反を説明します。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト
        • 説明 string 必須

          リクエスト要素が禁止されている理由の説明。

        • フィールド string 必須

          リクエスト本文内のフィールドにつながるパス。

    • 詳細 string

      各タイプのエラーの原因となる特定の条件または理由について説明します。

    • エラー integer(int32) 必須

      このエラーで返された HTTP ステータス コード。

      外部ドキュメント
    • errorCode string 必須

      このエラーで返されたアプリケーション エラー コード。

    • パラメーター array[オブジェクト]

      エラーに関する詳細情報を提供するために使用されるパラメーター。

    • 理由 string

      このエラーで返されたアプリケーション エラー メッセージ。
  • 402 application/ JSON

    支払いが必要です。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      無効なリクエストの詳細。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        クライアントリクエストにおけるすべての違反を説明します。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト
        • 説明 string 必須

          リクエスト要素が禁止されている理由の説明。

        • フィールド string 必須

          リクエスト本文内のフィールドにつながるパス。

    • 詳細 string

      各タイプのエラーの原因となる特定の条件または理由について説明します。

    • エラー integer(int32) 必須

      このエラーで返された HTTP ステータス コード。

      外部ドキュメント
    • errorCode string 必須

      このエラーで返されたアプリケーション エラー コード。

    • パラメーター array[オブジェクト]

      エラーに関する詳細情報を提供するために使用されるパラメーター。

    • 理由 string

      このエラーで返されたアプリケーション エラー メッセージ。
  • 403 application/ JSON

    Forbidden.

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      無効なリクエストの詳細。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        クライアントリクエストにおけるすべての違反を説明します。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト
        • 説明 string 必須

          リクエスト要素が禁止されている理由の説明。

        • フィールド string 必須

          リクエスト本文内のフィールドにつながるパス。

    • 詳細 string

      各タイプのエラーの原因となる特定の条件または理由について説明します。

    • エラー integer(int32) 必須

      このエラーで返された HTTP ステータス コード。

      外部ドキュメント
    • errorCode string 必須

      このエラーで返されたアプリケーション エラー コード。

    • パラメーター array[オブジェクト]

      エラーに関する詳細情報を提供するために使用されるパラメーター。

    • 理由 string

      このエラーで返されたアプリケーション エラー メッセージ。
  • 404 application/ JSON

    見つかりません。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      無効なリクエストの詳細。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        クライアントリクエストにおけるすべての違反を説明します。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト
        • 説明 string 必須

          リクエスト要素が禁止されている理由の説明。

        • フィールド string 必須

          リクエスト本文内のフィールドにつながるパス。

    • 詳細 string

      各タイプのエラーの原因となる特定の条件または理由について説明します。

    • エラー integer(int32) 必須

      このエラーで返された HTTP ステータス コード。

      外部ドキュメント
    • errorCode string 必須

      このエラーで返されたアプリケーション エラー コード。

    • パラメーター array[オブジェクト]

      エラーに関する詳細情報を提供するために使用されるパラメーター。

    • 理由 string

      このエラーで返されたアプリケーション エラー メッセージ。
  • 409 application/ JSON

    競合。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      無効なリクエストの詳細。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        クライアントリクエストにおけるすべての違反を説明します。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト
        • 説明 string 必須

          リクエスト要素が禁止されている理由の説明。

        • フィールド string 必須

          リクエスト本文内のフィールドにつながるパス。

    • 詳細 string

      各タイプのエラーの原因となる特定の条件または理由について説明します。

    • エラー integer(int32) 必須

      このエラーで返された HTTP ステータス コード。

      外部ドキュメント
    • errorCode string 必須

      このエラーで返されたアプリケーション エラー コード。

    • パラメーター array[オブジェクト]

      エラーに関する詳細情報を提供するために使用されるパラメーター。

    • 理由 string

      このエラーで返されたアプリケーション エラー メッセージ。
  • 500 application/ JSON

    内部サーバーエラー。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      無効なリクエストの詳細。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        クライアントリクエストにおけるすべての違反を説明します。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト
        • 説明 string 必須

          リクエスト要素が禁止されている理由の説明。

        • フィールド string 必須

          リクエスト本文内のフィールドにつながるパス。

    • 詳細 string

      各タイプのエラーの原因となる特定の条件または理由について説明します。

    • エラー integer(int32) 必須

      このエラーで返された HTTP ステータス コード。

      外部ドキュメント
    • errorCode string 必須

      このエラーで返されたアプリケーション エラー コード。

    • パラメーター array[オブジェクト]

      エラーに関する詳細情報を提供するために使用されるパラメーター。

    • 理由 string

      このエラーで返されたアプリケーション エラー メッセージ。
POST /API/Atlas/v2/groups/{groupId}/FlexClusters:tenantアップグレード 
atlas api flexClusters tenantGroupFlexClusterUpgrade --help
import (
	"os"
	"context"
	"log"
	sdk "go.mongodb.org/atlas-sdk/v20250219001/admin"
)

func main() {
	ctx := context.Background()
	clientID := os.Getenv("MONGODB_ATLAS_CLIENT_ID")
	clientSecret := os.Getenv("MONGODB_ATLAS_CLIENT_SECRET")

	// See https://dochub.mongodb.org/core/atlas-go-sdk-oauth
	client, err := sdk.NewClient(sdk.UseOAuthAuth(clientID, clientSecret))

	if err != nil {
		log.Fatalf("Error: %v", err)
	}

	params = &sdk.TenantGroupFlexClusterUpgradeApiParams{}
	sdkResp, httpResp, err := client.FlexClustersApi.
		TenantGroupFlexClusterUpgradeWithParams(ctx, params).
		Execute()
}

curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "Accept: application/vnd.atlas.2025-02-19+json" \
  --header "Content-Type: application/json" \
  -X POST "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/flexClusters:tenantUpgrade" \
  -d '{ <Payload> }'
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
  --digest --include \
  --header "Accept: application/vnd.atlas.2025-02-19+json" \
  --header "Content-Type: application/json" \
  -X POST "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/flexClusters:tenantUpgrade" \
  -d '{ <Payload> }'
リクエスト例 
{
  "acceptDataRisksAndForceReplicaSetReconfig": "2025-05-04T09:42:00Z",
  "advancedConfiguration": {
    "customOpensslCipherConfigTls12": [
      "TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384"
    ],
    "minimumEnabledTlsProtocol": "TLS1_0",
    "tlsCipherConfigMode": "CUSTOM"
  },
  "backupEnabled": false,
  "biConnector": {
    "enabled": true,
    "readPreference": "PRIMARY"
  },
  "clusterType": "REPLICASET",
  "configServerManagementMode": "ATLAS_MANAGED",
  "diskWarmingMode": "FULLY_WARMED",
  "encryptionAtRestProvider": "NONE",
  "globalClusterSelfManagedSharding": true,
  "labels": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "mongoDBEmployeeAccessGrant": {
    "expirationTime": "2025-05-04T09:42:00Z",
    "grantType": "CLUSTER_DATABASE_LOGS"
  },
  "mongoDBMajorVersion": "string",
  "name": "string",
  "paused": true,
  "pitEnabled": true,
  "redactClientLogData": true,
  "replicaSetScalingStrategy": "WORKLOAD_TYPE",
  "replicationSpecs": [
    {
      "regionConfigs": [
        {
          "electableSpecs": {
            "diskSizeGB": 42.0,
            "diskIOPS": 42,
            "ebsVolumeType": "STANDARD",
            "instanceSize": "M10",
            "nodeCount": 42
          },
          "priority": 42,
          "providerName": "AWS",
          "regionName": "US_GOV_WEST_1",
          "analyticsAutoScaling": {
            "compute": {
              "enabled": true,
              "predictiveEnabled": true,
              "scaleDownEnabled": true
            },
            "diskGB": {
              "enabled": true
            }
          },
          "analyticsSpecs": {
            "diskSizeGB": 42.0,
            "nodeCount": 42,
            "diskIOPS": 42,
            "ebsVolumeType": "STANDARD",
            "instanceSize": "M10"
          },
          "autoScaling": {
            "compute": {
              "enabled": true,
              "predictiveEnabled": true,
              "scaleDownEnabled": true
            },
            "diskGB": {
              "enabled": true
            }
          },
          "readOnlySpecs": {
            "diskSizeGB": 42.0,
            "nodeCount": 42,
            "diskIOPS": 42,
            "ebsVolumeType": "STANDARD",
            "instanceSize": "M10"
          }
        }
      ],
      "zoneName": "string"
    }
  ],
  "rootCertType": "ISRGROOTX1",
  "tags": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "terminationProtectionEnabled": false,
  "versionReleaseSystem": "LTS"
}
応答の例（200） 
{
  "backupSettings": {
    "enabled": true
  },
  "clusterType": "REPLICASET",
  "connectionStrings": {
    "standard": "string",
    "standardSrv": "string"
  },
  "createDate": "2025-05-04T09:42:00Z",
  "groupId": "32b6e34b3d91647abb20e7b8",
  "id": "32b6e34b3d91647abb20e7b8",
  "links": [
    {
      "href": "https://cloud.mongodb.com/api/atlas",
      "rel": "self"
    }
  ],
  "mongoDBVersion": "string",
  "name": "string",
  "providerSettings": {
    "backingProviderName": "AWS",
    "diskSizeGB": 42.0,
    "providerName": "FLEX",
    "regionName": "string"
  },
  "stateName": "IDLE",
  "tags": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "terminationProtectionEnabled": false,
  "versionReleaseSystem": "LTS"
}
応答の例（400） 
{
  "error": 400,
  "detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
  "reason": "Bad Request",
  "errorCode": "VALIDATION_ERROR"
}
応答の例（401） 
{
  "error": 401,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Unauthorized",
  "errorCode": "NOT_ORG_GROUP_CREATOR"
}
応答の例（402） 
{
  "error": 402,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Payment Required",
  "errorCode": "NO_PAYMENT_INFORMATION_FOUND"
}
応答の例（403） 
{
  "error": 403,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Forbidden",
  "errorCode": "CANNOT_CHANGE_GROUP_NAME"
}
応答の例（404） 
{
  "error": 404,
  "detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
  "reason": "Not Found",
  "errorCode": "RESOURCE_NOT_FOUND"
}
応答の例（409） 
{
  "error": 409,
  "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",
  "reason": "Conflict",
  "errorCode": "CANNOT_DELETE_ORG_ACTIVE_LIVE_MIGRATION_ATLAS_ORG_LINK"
}
応答の例（500） 
{
  "error": 500,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Internal Server Error",
  "errorCode": "UNEXPECTED_ERROR"
}