az sql db str-policy

SQL Database の短期リテンション 期間ポリシーを管理します。

コマンド

Name 説明 型 状態
az sql db str-policy set

ライブ データベースの短期保有期間の設定を更新します。

Core GA
az sql db str-policy show

ライブ データベースの短期保持ポリシーを表示します。

Core GA
az sql db str-policy wait

ポリシーが設定されるまで、CLI を待機状態にします。

Core GA

az sql db str-policy set

ライブ データベースの短期保有期間の設定を更新します。

バックアップの不変性のロックは元に戻すことができません。 確認は、--lock-immutability が true の場合にのみ必要です。 確認をスキップするには、--yes を使用します。 ロック時に --retention-days を含めます。 保持期間を維持するには、str-policy show の現在の値を使用します。 ロックされたポリシーのリテンション期間を増やす場合は、--lock-immutability true も指定します。 str-policy show を使用して、--no-wait 更新後にポリシーを確認します。

az sql db str-policy set [--acquire-policy-token]
                         [--change-reference]
                         [--diffbackup-hours]
                         [--ids]
                         [--lock-immutability {false, true}]
                         [--name]
                         [--no-wait]
                         [--resource-group]
                         [--retention-days]
                         [--server]
                         [--subscription]
                         [--yes]

例

ライブ データベースの短期リテンション期間を設定します。

az sql db str-policy set --resource-group mygroup --server myserver --name mydb --retention-days 7 --diffbackup-hours 24

バックアップの不変性を 7 日間のリテンション期間でロックし、確認をスキップします。

az sql db str-policy set --resource-group mygroup --server myserver --name mydb --retention-days 7 --lock-immutability true --yes

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

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

--acquire-policy-token

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

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

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

プロパティ 値
パラメーター グループ: Global Policy Arguments
--diffbackup-hours

新しいバックアップ短期保持ポリシーの差分バックアップ間隔 (時間単位)。ライブ データベースの有効な差分バックアップ間隔は、12 時間または 24 時間です。

--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--lock-immutability

バックアップの不変性をロックするかどうか。 ロックは元に戻すことができません。 false を設定しても、既にロックされているポリシーのロックは解除されません。

プロパティ 値
指定可能な値: false, true
--name -n

Azure SQL Databaseの名前。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ 値
規定値: False
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--retention-days

新しいバックアップ短期保持ポリシーの保有期間 (日数)。(DTU) Basic のライブ データベースの有効なリテンション期間は 1 ~ 7 日です。Rest モデルは 1 ~ 35 日です。

--server -s

Azure SQL Serverの名前。 既定値は、 az configure --defaults sql-server=<name>を使用して構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--subscription

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

プロパティ 値
パラメーター グループ: Resource Id Arguments
--yes -y

バックアップの不変性をロックするときに確認を求めないでください。

プロパティ 値
規定値: False
グローバル パラメーター
--debug

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

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

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

--only-show-errors

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

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

出力フォーマット。

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

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

--verbose

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

プロパティ 値
規定値: False

az sql db str-policy show

ライブ データベースの短期保持ポリシーを表示します。

immutabilityStatus 出力プロパティは、サービスから返されたときに Disabled、Enabled、または Locked を報告します。

az sql db str-policy show [--ids]
                          [--name]
                          [--resource-group]
                          [--server]
                          [--subscription]

例

ライブ データベースの短期保持ポリシーを表示します。

az sql db str-policy show -g mygroup -s myserver -n mydb

現在のバックアップ不変状態を表示します。

az sql db str-policy show --resource-group mygroup --server myserver --name mydb --query immutabilityStatus

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

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

--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--name -n

Azure SQL Databaseの名前。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--server -s

Azure SQL Serverの名前。 既定値は、 az configure --defaults sql-server=<name>を使用して構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--subscription

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

プロパティ 値
パラメーター グループ: Resource Id Arguments
グローバル パラメーター
--debug

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

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

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

--only-show-errors

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

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

出力フォーマット。

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

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

--verbose

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

プロパティ 値
規定値: False

az sql db str-policy wait

ポリシーが設定されるまで、CLI を待機状態にします。

az sql db str-policy wait --policy-name
                          [--acquire-policy-token]
                          [--change-reference]
                          [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--ids]
                          [--interval]
                          [--name]
                          [--resource-group]
                          [--server]
                          [--subscription]
                          [--timeout]
                          [--updated]

例

既定の短期保持ポリシーが存在するまで待ちます。

az sql db str-policy wait --resource-group mygroup --server myserver --name mydb --policy-name default --exists

バックアップの不変性がロックされるまで待ちます。

az sql db str-policy wait --resource-group mygroup --server myserver --name mydb --policy-name default --custom "immutabilityStatus=='Locked'"

必須パラメーター

--policy-name

ポリシー名。 常に "default" にする必要があります。

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

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

--acquire-policy-token

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

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

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

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

'provisioningState' が 'Succeeded' で作成されるまで待ちます。

プロパティ 値
パラメーター グループ: Wait Condition Arguments
規定値: False
--custom

条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。

プロパティ 値
パラメーター グループ: Wait Condition Arguments
--deleted

削除されるまで待ちます。

プロパティ 値
パラメーター グループ: Wait Condition Arguments
規定値: False
--exists

リソースが存在するまで待ちます。

プロパティ 値
パラメーター グループ: Wait Condition Arguments
規定値: False
--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--interval

ポーリング間隔 (秒単位)。

プロパティ 値
パラメーター グループ: Wait Condition Arguments
規定値: 30
--name -n

Azure SQL Databaseの名前。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--server -s

Azure SQL Serverの名前。 既定値は、 az configure --defaults sql-server=<name>を使用して構成できます。

プロパティ 値
パラメーター グループ: Resource Id Arguments
--subscription

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

プロパティ 値
パラメーター グループ: Resource Id Arguments
--timeout

最大待機時間 (秒単位)。

プロパティ 値
パラメーター グループ: Wait Condition Arguments
規定値: 3600
--updated

provisioningState が 'Succeeded' で更新されるまで待ちます。

プロパティ 値
パラメーター グループ: Wait Condition Arguments
規定値: False
グローバル パラメーター
--debug

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

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

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

--only-show-errors

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

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

出力フォーマット。

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

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

--verbose

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

プロパティ 値
規定値: False