az sql instance-failover-group-arc

Note

このリファレンスは、Azure CLI (バージョン 2.3.1 以降) の arcdata 拡張機能の一部です。 拡張機能は、az sql instance-failover-group-arc コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

Arc 対応 SQL マネージド インスタンスフェールオーバー グループを管理します。

コマンド

名前	説明	型	Status
az sql instance-failover-group-arc create	フェールオーバー グループ リソースを作成します。	拡張	GA
az sql instance-failover-group-arc delete	Arc 対応 SQL Managed Instance フェールオーバー グループを削除します。	拡張	GA
az sql instance-failover-group-arc list	すべてのフェールオーバー グループを一覧表示します。	拡張	GA
az sql instance-failover-group-arc show	フェールオーバー グループ リソースの詳細を表示します。	拡張	GA
az sql instance-failover-group-arc update	フェールオーバー グループ リソースを更新します。	拡張	GA

az sql instance-failover-group-arc create

フェールオーバー グループ リソースを作成します。

Arc 対応 SQL Managed Instance フェールオーバー グループ リソースを作成して、分散型可用性グループを設定します。

az sql instance-failover-group-arc create --mi
                                          --name
                                          --partner-mi
                                          [--k8s-namespace]
                                          [--no-wait]
                                          [--partner-mirroring-cert-file]
                                          [--partner-mirroring-url]
                                          [--partner-resource-group]
                                          [--partner-sync-mode {async, sync}]
                                          [--primary-mirroring-url]
                                          [--resource-group]
                                          [--role {primary, secondary}]
                                          [--shared-name]
                                          [--use-k8s]

例

Kubernetes API を使用して、プライマリ SQL マネージド インスタンス sqlmi1 とパートナー SQL マネージド インスタンス sqlmi2 の間にフェールオーバー グループ リソースを作成します。パートナー ミラーエンドポイントと証明書ファイルが必要です。

az sql instance-failover-group-arc create --name fogcr --shared-name sharedname1 --mi sqlmi1 --role primary --partner-mi sqlmi2 --partner-mirroring-url 10.20.5.20:970 --partner-mirroring-cert-file ./sqlmi2.cer --use-k8s

Azure Resource Manager (ARM) を使用してフェールオーバー グループ リソースを作成します。

az sql instance-failover-group-arc create --name fogcr  --mi sqlmi1 --resource-group primary-rg-name  --partner-mi sqlmi2 --partner-resource-group partner-rg-name --partner-sync-mode async

ARM を使用して、カスタム ミラー URL を持つフェールオーバー グループを作成します。

az sql instance-failover-group-arc create --name fogcr  --mi sqlmi1 --resource-group primary-rg-name  --partner-mi sqlmi2 --partner-resource-group partner-rg-name --partner-sync-mode async --primary-mirroring-url 21.10.6.30:6603 --partner-mirroring-url 10.20.5.20:970

必須のパラメーター

--mi

プライマリ SQL マネージド インスタンスの名前。

--name -n

フェールオーバー グループ リソースの名前。

--partner-mi

パートナー SQL マネージド インスタンスまたはリモート SQL インスタンスの名前。 ARM を対象とする引数を使用する場合、これはディザスター リカバリー (DR) インスタンス名を指します。

省略可能のパラメーター

--k8s-namespace -k

フェールオーバー グループをデプロイする名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False

--partner-mirroring-cert-file -f

パートナー SQL マネージド インスタンスまたはリモート SQL インスタンス上の可用性グループのミラーエンドポイントパブリック証明書のファイル名。 PEM 形式のみがサポートされています。

--partner-mirroring-url -u

パートナー SQL マネージド インスタンスのミラーエンドポイント URL。

--partner-resource-group

DR パートナー Arc 対応 SQL マネージド インスタンスの Azure リソース グループ。

--partner-sync-mode -m

Arc 対応 SQL マネージド インスタンスのパートナー同期モード。

承認された値: async, sync

--primary-mirroring-url

プライマリ SQL マネージド インスタンスのミラーエンドポイント URL。

--resource-group -g

プライマリ Arc 対応 SQL マネージド インスタンスの Azure リソース グループ。

--role

フェールオーバー グループの要求されたロール。 ロールは変更できます。

承認された値: primary, secondary

--shared-name

この SQL マネージド インスタンスのフェールオーバー グループの共有名。 プライマリ SQL マネージド インスタンスとそのパートナーは、どちらも同じ共有名を使用する必要があります。

--use-k8s

ローカル Kubernetes API を使用して、Arc 対応 SQL マネージド インスタンス フェールオーバー グループを作成します。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql instance-failover-group-arc delete

Arc 対応 SQL Managed Instance フェールオーバー グループを削除します。

az sql instance-failover-group-arc delete --name
                                          [--k8s-namespace]
                                          [--mi]
                                          [--resource-group]
                                          [--use-k8s]

例

Kubernetes API を使用してフェールオーバー グループ リソースを削除します。

az sql instance-failover-group-arc delete --name fogcr --use-k8s

Azure Resource Manager を使用してフェールオーバー グループ リソースを削除します。

az sql instance-failover-group-arc delete --name fogcr --mi sqlmi1 -g rg-name

必須のパラメーター

--name -n

削除するフェールオーバー グループ リソースの名前。

省略可能のパラメーター

--k8s-namespace -k

フェールオーバー グループがデプロイされている名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

--mi

プライマリ Arc 対応 SQL マネージド インスタンスの名前。

--resource-group -g

プライマリ Arc 対応 SQL マネージド インスタンスの Azure リソース グループ。

--use-k8s

このアクションを実行するには、ローカルの Kubernetes API を使用します。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql instance-failover-group-arc list

すべてのフェールオーバー グループを一覧表示します。

az sql instance-failover-group-arc list [--k8s-namespace]
                                        [--mi]
                                        [--resource-group]
                                        [--use-k8s]

例

Kubernetes API を使用して、名前空間内のすべてのフェールオーバー グループを一覧表示します。

az sql instance-failover-group-arc list --k8s-namespace arcdata --use-k8s

Azure Resource Manager (ARM) にクエリを実行して、すべてのフェールオーバー グループを一覧表示します。

az sql instance-failover-group-arc list --mi sqlmi1 -g rg-name

省略可能のパラメーター

--k8s-namespace -k

フェールオーバー グループがデプロイされる名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

--mi

Arc 対応 SQL マネージド インスタンスの名前。

--resource-group -g

Arc 対応 SQL マネージド インスタンスの Azure リソース グループ。

--use-k8s

このアクションを実行するには、ローカルの Kubernetes API を使用します。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql instance-failover-group-arc show

フェールオーバー グループ リソースの詳細を表示します。

az sql instance-failover-group-arc show --name
                                        [--k8s-namespace]
                                        [--mi]
                                        [--resource-group]
                                        [--use-k8s]

例

Kubernetes API を使用してフェールオーバー グループの詳細を表示します。

az sql instance-failover-group-arc show --name fogcr --use-k8s

Azure Resource Manager (ARM) にクエリを実行して、フェールオーバー グループの詳細を表示します。

az sql instance-failover-group-arc show --name fogcr1 --mi sqlmi1 -g rg-name

必須のパラメーター

--name -n

フェールオーバー グループ リソースの名前。

省略可能のパラメーター

--k8s-namespace -k

フェールオーバー グループがデプロイされている名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

--mi

プライマリ Arc 対応 SQL マネージド インスタンスの名前。

--resource-group -g

プライマリ Arc 対応 SQL マネージド インスタンスの Azure リソース グループ。

--use-k8s

このアクションを実行するには、ローカルの Kubernetes API を使用します。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az sql instance-failover-group-arc update

フェールオーバー グループ リソースを更新します。

Arc 対応 SQL Managed Instance フェールオーバー グループ リソースを更新して、分散型可用性グループのロールを変更します。

az sql instance-failover-group-arc update --name
                                          [--k8s-namespace]
                                          [--mi]
                                          [--no-wait]
                                          [--partner-sync-mode {async, sync}]
                                          [--resource-group]
                                          [--role {force-primary-allow-data-loss, force-secondary, secondary}]
                                          [--use-k8s]

例

Kubernetes API を使用して、プライマリからセカンダリ ロールにフェールオーバー グループ リソースを更新します。

az sql instance-failover-group-arc update --name fogcr --role secondary --use-k8s

Azure Resource Manager を使用してフェールオーバー グループ リソースを更新します。

az sql instance-failover-group-arc update --name fogcr  --role secondary --mi sqlmi1 --resource-group rg-name

必須のパラメーター

--name -n

フェールオーバー グループ リソースの名前。

省略可能のパラメーター

--k8s-namespace -k

フェールオーバー グループが存在する名前空間。 名前空間が指定されていない場合は、kubeconfig で定義されている名前空間が使用されます。

--mi

更新する Arc 対応 SQL マネージド インスタンスの名前。

--no-wait

実行時間の長い操作の終了を待機しません。

既定値: False

--partner-sync-mode -m

SQL マネージド インスタンスのパートナー同期モード。

承認された値: async, sync

--resource-group -g

プライマリ Arc 対応 SQL マネージド インスタンスの Azure リソース グループ。

--role

フェールオーバー グループの要求されたロール。

承認された値: force-primary-allow-data-loss, force-secondary, secondary

--use-k8s

このアクションを実行するには、ローカルの Kubernetes API を使用します。

グローバル パラメーター

--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc

既定値: json

--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。