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-values -j

値への json パスのキー値ペアリスト: key1.subkey1=value1,key2.subkey2=value2key='{"kind":"cluster","name":"test-cluster"}'などのインライン json 値を指定したり、key=./values.jsonなどのファイル パスを指定したりできます。 add コマンドは条件をサポートしていません。 指定するインライン値がキー値ペア自体と=,場合は、それらの文字をエスケープしてください。 たとえば、 key1=\"key2\=val2\,key3\=val3\"と指定します。 パスの外観の例については、http://jsonpatch.com/ を参照してください。 配列にアクセスする場合は、 key.0=valueなどのインデックスを指定してアクセスする必要があります。

--path -p

カスタム リソース仕様へのパス(カスタム/spec.json)。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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

必須のパラメーター

--path -p

SQL マネージド インスタンスの CRD と仕様を記述する必要があるパス。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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"}}]}

必須のパラメーター

--patch-file

jsonpatch ライブラリに基づくパッチ json ファイルへのパス: http://jsonpatch.com/。 パッチ json ファイルは、 patch という名前のキーを使用して開始する必要があります。その値は、実行するパッチ操作の配列です。 パッチ操作のパスには、ほとんどの操作に key1.key2 などのドット表記を使用できます。 置換操作を実行し、条件を必要とする配列の値を置き換える場合は、パスを $で始めて jsonpath 表記を使用してください。 これにより、 $.key1.key2[?(@.key3=="someValue"].key4などの条件付き操作を実行できます。以下の例を参照してください。 条件に関するその他のヘルプについては、「 https://jsonpath.com/」を参照してください。

--path -p

カスタム リソース仕様へのパス (つまり、 custom/spec.json)。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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'

必須のパラメーター

--json-path -j

削除する値を示す jsonpatch ライブラリに基づく json パスの一覧 (例: key1.subkey1,key2.subkey2)。 remove コマンドは、条件をサポートしていません。 パスの外観の例については、http://jsonpatch.com/ を参照してください。 配列にアクセスする場合は、 key.0=valueなどのインデックスを指定してアクセスする必要があります。

--path -p

カスタム リソース仕様へのパス (つまり、 custom/spec.json)。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --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-values -j

値への json パスのキー値ペアリスト: key1.subkey1=value1,key2.subkey2=value2key={"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/」を参照してください。

--path -p

カスタム リソース仕様へのパス (つまり、 custom/spec.json)。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--acquire-policy-token

このリソース操作のAzure Policy トークンを自動的に取得します。

プロパティ
パラメーター グループ: Global Policy Arguments
--change-reference

このリソース操作の関連する変更参照 ID。

プロパティ
パラメーター グループ: Global Policy Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False