複雑なコマンド入力でのJSONの使用
Private Cloud Applianceでは、複雑なコマンド入力に、複数の値を持つ配列およびオブジェクトが含まれます。複合入力は、JSON形式のキー/値ペアのブロックとして渡されます。JSON形式の入力は、コマンドラインで文字列として、またはコマンドラインで参照されるファイルとして指定できます。
JSON文字列の使用
JSONブロックをCompute Web UIコマンドラインで文字列として渡すには、改行を削除します。macOS、LinuxまたはUNIXでは、JSONブロック全体を一重引用符で囲みます。Microsoft Windowsコマンドラインで、JSONブロックを二重引用符で囲み、ブロック内の二重引用符(\")をエスケープします。
OSまたはシェルでは、ドル記号などの他の文字をエスケープする必要がある場合があります。
「パラメータ'parameter_name'はJSON形式である必要があります」というメッセージを受信した場合、JSON形式が正しくありません。「フォーマット済JSONの生成」の説明に従ってJSON形式をコピーした場合は、コマンドライン形式(特にエスケープが必要な文字)を再チェックします。
-
macOS、LinuxまたはUNIX
oci compute instance update --instance-id ocid1.image.unique_ID --freeform-tags '{"Department":"Finance"}' -
Microsoft Windows
oci compute instance update --instance-id ocid1.image.unique_ID --freeform-tags "{\"Department\":\"Finance\"}"
JSONファイルの使用
複雑なオプション引数をファイルに格納する利点は、正しい形式であることがわかっている引数を簡単に再利用できることです。--generate-param-json-inputオプションまたは getコマンドの出力からデータをコピーする方法に正確に格納できます。コマンド行文字列に必要なため、改行を削除したり、特定の文字をエスケープしたりする必要はありません。
JSONファイルを使用して入力を渡す場合、オプション引数はfile://という接頭辞が付いたファイル名です。ファイル名には、コマンドを実行しているディレクトリと同じディレクトリにあるファイルの名前、ファイルへの相対パス、またはファイルへのフルパスを指定できます。