プロパティとは、gdcloud CLI の動作を制御する設定のことです。
プロパティを使用して、組織コンソール URL や、認証に gcloud CLI で使用されるプロジェクト、障害復旧サービスを使用する際に使用する情報、gcloud CLI コンポーネントの自動更新チェックをオフにするオプションなど、組織やプロジェクトのコンテキストの設定を定義できます。組織とプロジェクトのコンテキストの詳細については、コンテキストを表示して切り替えるをご覧ください。プロパティには gdcloud CLI の設定も定義できます。たとえば、gdcloud CLI コマンドのユーザー補助機能の構成などです。
プロパティとフラグ
gdcloud CLI では、gdcloud CLI プロパティと同じ効果を持つコマンドフラグがサポートされています。プロパティを使用すると、コマンドの実行中に同じ設定を維持できます。コマンドを呼び出すたびに、フラグによってコマンドの動作が制御されます。両方を設定すると、フラグによってプロパティがオーバーライドされます。
構成
構成とは、gdcloud CLI のプロパティのセットに名前を付けたものです。gdcloud CLI では、default
という名前の構成を最初の有効な構成として使用します。ほとんどのユースケースでは、default
構成で十分です。追加の構成を作成して、必要に応じて切り替えることもできます。
プロパティの一覧表示
アクティブな構成の中のプロパティを一覧表示するには、次のコマンドを実行します。
gdcloud config list
プロパティを設定する
アクティブな構成の中のプロパティを設定するには、gdcloud config set
を実行します。次の例では、project
プロパティを設定します。ここで、PROJECT_ID
はプロジェクトの一意の ID です。
gdcloud config set project PROJECT_ID
core
プロパティ セクションに含まれていないプロパティを設定するには、セクションを指定し、続けてスラッシュとプロパティ名を指定する必要があります。login_config_cert_path
プロパティを設定する例を次に示します。
gdcloud config set auth/login_config_cert_path CA_CERT_PATH
CA_CERT_PATH
変数を認証局(CA)証明書のパスに置き換えます。例: /tmp/web-tls-ca.cert
使用可能なプロパティ
すべてのプロパティのリストを表示するには、gdcloud topic configurations
コマンドを実行して、[Available Properties] セクションを探します。