API内のオブジェクトの状態をクエリで操作できます(例:Pod、Namespace、ConfigMap、Events)。ほとんどの操作は、APIを使用しているkubectlコマンドラインインターフェースもしくはkubeadmのような別のコマンドラインツールを通して実行できます。RESTコールを利用して直接APIにアクセスすることも可能です。librariesの利用を考えてみてください。完全なAPIの詳細は、OpenAPIを使用して文書化されています。v2仕様を提供します。次のように要求ヘッダーを使用して、応答フォーマットを要求できます。buffersをベースにしたシリアライズフォーマットを実装しています。serializationデザイン提案を参照してください。Language(IDL)ファイルは、APIオブジェクトを定義しているGoパッケージ内に配置されています。v3によるAPI仕様をベータサポートとして提供しています。これは、デフォルトで有効化されているベータ機能です。gateを切ることにより、このベータ機能を無効化することができます。/openapi/v3が、全ての利用可能なグループやバージョンの一覧を閲覧するためのディスカバリーエンドポイントとして提供されています。このエンドポイントは、JSONのみを返却します。利用可能なグループやバージョンは、次のような形式で提供されます。}}クライアントサイドのキャッシングを改善するために、相対URLはイミュータブルな(不変の)OpenAPI記述を指しています。APIサーバーも、同様の目的で適切なHTTPキャッシュヘッダー(Expiresには1年先の日付、Cache-Controlにはimmutable)をセットします。廃止されたURLが使用された場合、APIサーバーは最新のURLへのリダイレクトを返します。v3仕様を公開しています。受理されるリクエストヘッダーについては、以下の表の通りです。永続性KubernetesはAPIリソースの観点からシリアル化された状態をetcdに書き込むことで保存します。APIグループとバージョニングフィールドの削除やリソース表現の再構成を簡単に行えるようにするため、Kubernetesは複数のAPIバージョンをサポートしており、/api/v1や/apis/rbac.authorization.k8s.io/v1alpha1のように、それぞれ異なるAPIのパスが割り当てられています。APIが、システムリソースと動作について明確かつ一貫したビューを提供し、サポート終了、実験的なAPIへのアクセス制御を有効にするために、リソースまたはフィールドレベルではなく、APIレベルでバージョンが行われます。APIの発展や拡張を簡易に行えるようにするため、Kubernetesは有効もしくは無効を行えるAPIグループを実装しました。APIリソースは、APIグループ、リソースタイプ、ネームスペース(namespacedリソースのための)、名前によって区別されます。APIサーバーは、APIバージョン間の変換を透過的に処理します。すべてのバージョンの違いは、実際のところ同じ永続データとして表現されます。APIサーバーは、同じ基本的なデータを複数のAPIバージョンで提供することができます。同じリソースでv1とv1beta1の2つのバージョンが有ることを考えてみます。v1beta1バージョンのAPIを利用しオブジェクトを最初に作成したとして、v1beta1バージョンが非推奨となり削除されるまで、v1beta1もしくはv1どちらのAPIバージョンを利用してもオブジェクトのread、update、deleteができます。APIを使用してオブジェクトの修正やアクセスを継続することが可能です。成功を収めているシステムはすべて、新しいユースケースの出現や既存の変化に応じて成長し、変化する必要があります。APIを継続的に変更および拡張できる設計機能があります。その互換性を一定期間維持して、他のプロジェクトが適応する機会を提供することを目的としています。基本的に、新しいAPIリソースと新しいリソースフィールドは追加することができます。リソースまたはフィールドを削除するには、API非推奨ポリシーに従ってください。APIが一度一般提供(GA)に達した場合、互換性を維持することを強く確約します。APIバージョン経由で永続化されたデータとの互換性を維持します。APIバージョン経由でデータを変換してアクセスできることを保証します。APIに移行する必要があります。APIの非推奨期間中です。APIが非推奨期間を終えて提供されなくなったら、代替APIバージョンを使用する必要があります。APIバージョンについても互換性の維持に注力しますが、いくつかの事情により不可である場合もあります。APIバージョンを使っている場合、クラスターをアップグレードする時にKubernetesのリリースノートを確認してください。APIが互換性のない方法で変更された場合は、アップグレードをする前に既存のalphaオブジェクトをすべて削除する必要があります。APIバージョンレベルの定義に関する詳細はAPIバージョンのリファレンスを参照してください。APIは2つの方法で拡張できます。カスタムリソースは、APIサーバーが選択したリソースAPIをどのように提供するかを宣言的に定義します。APIを拡張することもできます。APIを拡張する方法について学んでください。APIのアクセス制御では、クラスターがAPIアクセスの認証と承認を管理する方法を説明しています。APIリファレンスを読んで、APIエンドポイント、リソースタイプやサンプルについて学んでください。どのようにAPIを変更するかについて学んでください。京ICP备17074266号-3。