az sql mi-arc config
Note
このリファレンスは、Azure CLI (バージョン 2.3.1 以降) の arcdata 拡張機能の一部です。 az sql mi-arc config コマンドを初めて実行すると、拡張機能が自動的にインストールされます。 拡張機能の詳細については、 を参照してください。
構成コマンド。
コマンド
| 名前 | 説明 | 型 | 状態 |
|---|---|---|---|
| az sql mi-arc config add |
構成ファイルに json パスの値を追加します。 |
Extension | GA |
| az sql mi-arc config init |
SQL マネージド インスタンスの CRD ファイルと仕様ファイルを初期化します。 |
Extension | GA |
| az sql mi-arc config patch |
json パッチ ファイルに基づいて構成ファイルにパッチを適用します。 |
Extension | GA |
| az sql mi-arc config remove |
構成ファイル内の json パスの値を削除します。 |
Extension | GA |
| az sql mi-arc config replace |
構成ファイル内の json パスの値を置き換えます。 |
Extension | GA |
az sql mi-arc config add
構成ファイルに json パスの値を追加します。
構成ファイルの json パスに値を追加します。 以下のすべての例は Bash で示されています。 別のコマンド ラインを使用する場合は、引用符を適切にエスケープすることが必要になる場合があります。 または、パッチ ファイルの機能を使用することもできます。
az sql mi-arc config add --json-values
--path
[--acquire-policy-token]
[--change-reference]
例
例 1 - ストレージを追加します。
az sql mi-arc config add --path custom/spec.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'
必須のパラメーター
値への json パスのキー値ペアリスト: key1.subkey1=value1,key2.subkey2=value2。
key='{"kind":"cluster","name":"test-cluster"}'などのインライン json 値を指定したり、key=./values.jsonなどのファイル パスを指定したりできます。 add コマンドは条件をサポートしていません。 指定するインライン値がキー値ペア自体と=,場合は、それらの文字をエスケープしてください。 たとえば、 key1=\"key2\=val2\,key3\=val3\"と指定します。 パスの外観の例については、http://jsonpatch.com/ を参照してください。 配列にアクセスする場合は、 key.0=valueなどのインデックスを指定してアクセスする必要があります。
カスタム リソース仕様へのパス(カスタム/spec.json)。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az sql mi-arc config init
SQL マネージド インスタンスの CRD ファイルと仕様ファイルを初期化します。
az sql mi-arc config init --path
[--acquire-policy-token]
[--change-reference]
例
SQL マネージド インスタンスの CRD ファイルと仕様ファイルを初期化します。
az sql mi-arc config init --path ./template
必須のパラメーター
SQL マネージド インスタンスの CRD と仕様を記述する必要があるパス。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az sql mi-arc config patch
json パッチ ファイルに基づいて構成ファイルにパッチを適用します。
指定されたパッチ ファイルに従って構成ファイルにパッチを適用します。 パスの構成方法の詳細については、 http://jsonpatch.com/ を参照してください。 置換操作では、jsonpath ライブラリが https://jsonpath.com/されるため、パスで条件を使用できます。 すべてのパッチ json ファイルは、対応する操作 (追加、置換、削除)、パス、および値を含むパッチの配列を持つ patch のキーで始まる必要があります。
remove演算には値は必要なく、パスだけが必要です。 次の例を参照してください。
az sql mi-arc config patch --patch-file
--path
[--acquire-policy-token]
[--change-reference]
例
例 1 - 1 つのエンドポイントのポートをパッチ ファイルに置き換えます。
az sql mi-arc config patch --path custom/spec.json --patch ./patch.json
Patch File Example (patch.json):
{"patch":[{"op":"replace","path":"$.spec.endpoints[?(@.name=='Controller')].port","value":30080}]}
例 2 - ストレージをパッチ ファイルに置き換えます。
az sql mi-arc config patch --path custom/spec.json --patch ./patch.json
Patch File Example (patch.json):
{"patch":[{"op":"replace","path":".spec.storage","value":{"accessMode":"ReadWriteMany","className":"managed-premium","size":"10Gi"}}]}
必須のパラメーター
jsonpatch ライブラリに基づくパッチ json ファイルへのパス: http://jsonpatch.com/。 パッチ json ファイルは、 patch という名前のキーを使用して開始する必要があります。その値は、実行するパッチ操作の配列です。 パッチ操作のパスには、ほとんどの操作に key1.key2 などのドット表記を使用できます。 置換操作を実行し、条件を必要とする配列の値を置き換える場合は、パスを $で始めて jsonpath 表記を使用してください。 これにより、 $.key1.key2[?(@.key3=="someValue"].key4などの条件付き操作を実行できます。以下の例を参照してください。 条件に関するその他のヘルプについては、「 https://jsonpath.com/」を参照してください。
カスタム リソース仕様へのパス (つまり、 custom/spec.json)。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az sql mi-arc config remove
構成ファイル内の json パスの値を削除します。
構成ファイルの json パスにある値を削除します。 以下のすべての例は Bash で示されています。 別のコマンド ラインを使用する場合は、引用符を適切にエスケープすることが必要になる場合があります。 または、パッチ ファイルの機能を使用することもできます。
az sql mi-arc config remove --json-path
--path
[--acquire-policy-token]
[--change-reference]
例
例 1 - ストレージを削除します。
az sql mi-arc config remove --path custom/spec.json --json-path '.spec.storage'
必須のパラメーター
削除する値を示す jsonpatch ライブラリに基づく json パスの一覧 (例: key1.subkey1,key2.subkey2)。 remove コマンドは、条件をサポートしていません。 パスの外観の例については、http://jsonpatch.com/ を参照してください。 配列にアクセスする場合は、 key.0=valueなどのインデックスを指定してアクセスする必要があります。
カスタム リソース仕様へのパス (つまり、 custom/spec.json)。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
az sql mi-arc config replace
構成ファイル内の json パスの値を置き換えます。
構成ファイルの json パスにある値を置き換えます。 以下のすべての例は Bash で示されています。 別のコマンド ラインを使用する場合は、引用符を適切にエスケープすることが必要になる場合があります。 または、パッチ ファイルの機能を使用することもできます。
az sql mi-arc config replace --json-values
--path
[--acquire-policy-token]
[--change-reference]
例
例 1 - 1 つのエンドポイントのポートを置き換えます。
az sql mi-arc config replace --path custom/spec.json --json-values '$.spec.endpoints[?(@.name=="Controller")].port=30080'
例 2 - ストレージを置き換えます。
az sql mi-arc config replace --path custom/spec.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'
必須のパラメーター
値への json パスのキー値ペアリスト: key1.subkey1=value1,key2.subkey2=value2。
key={"kind":"cluster","name":"test-cluster"}などのインライン json 値を指定したり、key=./values.jsonなどのファイル パスを指定したりできます。 replace コマンドは、jsonpath ライブラリを使用した条件付きをサポートします。 これを使用するには、$でパスを開始します。 これにより、 -j $.key1.key2[?(@.key3=="someValue"].key4=valueなどの条件付き操作を実行できます。 指定するインライン値がキー値ペア自体と=,場合は、それらの文字をエスケープしてください。 たとえば、 key1=\"key2\=val2\,key3\=val3\" です。 次の例を参照してください。 その他のヘルプについては、「 https://jsonpath.com/」を参照してください。
カスタム リソース仕様へのパス (つまり、 custom/spec.json)。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
このリソース操作のAzure Policy トークンを自動的に取得します。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
このリソース操作の関連する変更参照 ID。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Global Policy Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |