AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

FlexCluster カスタム リソース

MongoDB Kubernetes Atlas 演算子によってマネージドなフレキシブルなクラスター。

Name
タイプ
説明
必須

apiVersion

string

atlas.generated.mongodb.com/v1

true

kind

string

FlexCluster

true

metadata

オブジェクト

metadataフィールドのフィールドについては、 Kubernetes API のドキュメントを参照してください。

true

spec

オブジェクト

次のバージョンをサポートするフレキシブルなクラスターの仕様。

  • v20250312

バージョン化された spec を最大 1 つ指定できます。詳細については、 https://git.k8s.io/community/contributors/devel/sign-archives/api-conventions.md#spec-and-status検証:

  • (has(セルフ.v20250312.``groupId``)&=has(自分.`` connectionSecretRef``))|| (ディレクティブを使用した置換20250312spec.v20250312.``groupId`` が設定されている場合は、spec.`` connectionSecretRef`` を設定する必要があります。

false

status

オブジェクト

指定されたリソースバージョンのフレキシブルなクラスターの読み取り専用 status が最近確認されたリソース バージョンの読み取り専用。このデータは最新ではなく、システムによって入力されている場合があります。詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

false

次のバージョンをサポートするフレキシブルなクラスターの仕様。

  • v20250312

指定できるバージョン化された仕様は最大 1 つです。詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

Name
タイプ
説明
必須

connectionSecretRef

オブジェクト

SENSITIVE FIELD Atlas への接続を設定するための認証情報を含むシークレットへの参照。

false

v20250312

オブジェクト

バージョン v20250312 のフレキシブルなクラスターリソースの仕様。検証:

  • (has(自分自身.``groupId``)&+ !has(Self.``groupRef``))|| (!has(自分自身.``groupId``)& は(自己 .``groupRef``):groupIdgroupRef は相互に排他的です。設定できるのは 1 つだけです

false

機密フィールド

Atlas への接続を設定するための認証情報を含むシークレットへの参照。

Name
タイプ
説明
必須

name

string

Atlas 認証情報を含むシークレットの名前。

false

バージョン v20250312 のフレキシブルなクラスターリソースの仕様。

Name
タイプ
説明
必須

entry

オブジェクト

フレキシブルなリソース仕様の entry フィールド。これらのフィールドは、フレキシブルなクラスターの作成および更新に設定できます。

false

groupId

string

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

注意

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

検証:

  • 自己 == oldSelf: groupId は作成後に変更できません

false

groupRef

オブジェクト

"Group"リソースへの参照。"$.status.v20250312.id" の値は "groupId" を設定するために使用されます。"groupId"プロパティと排他関係にあります。

false

フレキシブルなリソース仕様のエントリ フィールド。これらのフィールドは、フレキシブルなクラスターの作成および更新に設定できます。

Name
タイプ
説明
必須

name

string

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

true

providerSettings

オブジェクト

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

true

tags

[]オブジェクト

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

false

terminationProtectionEnabled

ブール値

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

false

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

Name
タイプ
説明
必須

backingProviderName

string

MongoDB Cloud がフレキシブルなクラスターをプロビジョニングしたクラウド サービス プロバイダー。

true

regionName

string

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

true

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

Name
タイプ
説明
必須

key

string

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

true

value

string

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

true

"Group"リソースへの参照。"$.status.v20250312.id" の値は、"groupId" を設定するために使用されます。 "groupId"プロパティと排他関係にあります。

Name
タイプ
説明
必須

name

string

"Group"リソースの名前。

false

指定されたリソースバージョンの Flexクラスターの最近確認された読み取り専用ステータス。このデータは最新ではなく、システムによって入力されている場合があります。詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

Name
タイプ
説明
必須

conditions

[]オブジェクト

リソースの現在の状態に関する利用可能な最新の観察を表します。

false

v20250312

オブジェクト

バージョン v20250312 のフレキシブルなクラスターリソースの最後に確認された Atlas の状態。

false

Name
タイプ
説明
必須

status

string

条件のステータスは、True、False、Unknown のいずれか 1 つです。

true

type

string

条件のタイプ。

true

lastTransitionTime

string

条件があるステータスから別のステータスに最後に移行した時刻。形式: 日時

false

message

string

移行に関する詳細を示す、人間が判読可能な message

false

observedGeneration

integer

observedGeneration は、 を表します。条件が基づいて設定されたメタデータ. 生成。

false

reason

string

条件の最後の移行の reason

false

バージョン v20250312 のフレキシブルなクラスターリソースの最後に確認された Atlas の状態。

Name
タイプ
説明
必須

providerSettings

オブジェクト

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

true

backupSettings

オブジェクト

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

false

clusterType

string

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

false

connectionStrings

オブジェクト

MongoDBデータベースを点均一リソース ロケールのコレクション。

false

createDate

string

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

false

groupId

string

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

false

id

string

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

false

mongoDBVersion

string

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

false

name

string

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

false

stateName

string

Atlas コントロール プレーンによってこのクラスターで実行されている現在のアクティビティを示す、人間が判読できるラベル。CREATING 状態と DELETING 状態を除き、進行中のアクティビティを示す状態であっても、クラスターは常に使用可能であり、プライマリ ノードが存在する必要があります。

  • IDLE: Atlas はこのクラスターに変更を加えず、UI または API を介してリクエストされたすべての変更が適用されたと想定できます。

  • CREATING: 初めてプロビジョニングされたクラスターは、接続の準備が整うまで状態 CREATING を返します。接続を試みる前に、IPアクセス リストと DB ユーザーが構成されていることを確認します。

  • UPDATING: UIAPIAutoScaling、またはその他のスケジュールされたアクティビティからリクエストされた変更が実行されています。

  • DELETING: クラスターは削除プロセス中であり、すぐに削除される予定です。

  • REPAIRING: クラスター内の 1 つ以上のノードが Atlas コントロール プレーンによって使用可能に返されています。他のノードは、通常どおりサービスを提供し続ける必要があります。

false

versionReleaseSystem

string

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

false

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

Name
タイプ
説明
必須

backingProviderName

string

MongoDB Cloud がフレキシブルなクラスターをプロビジョニングしたクラウド サービス プロバイダー。

false

diskSizeGB

数値

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

false

providerName

string

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

false

regionName

string

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

false

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

Name
タイプ
説明
必須

enabled

ブール値

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

false

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

Name
タイプ
説明
必須

standard

string

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

false

standardSrv

string

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

false