az sql db str-policy

管理 SQL Database 短期保留原則。

命令

名稱 Description 類型 狀態
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-不變性為真時才需要確認。 用 --yes 跳過確認。 鎖定時請加入 ---保留天數。 為了保留保留,請使用 str-policy show 的當前值。 在增加鎖定政策的保留時,也要指定 --lock-immutability 為真。 在無等待更新後,使用 str-policy show 檢查政策。

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

用七天保留鎖定備份不可變性,跳過確認。

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

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--diffbackup-hours

新的備份短期保留原則差異備份間隔以小時為單位。實時資料庫的有效差異備份間隔可以是12或24小時。

--ids

一或多個資源識別碼(以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性 值
參數群組: 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) 實時資料庫的有效保留天數可以是 1-7 天:Rest 模型可以是 1-35 天。

--server -s

Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>。

屬性 值
參數群組: Resource Id Arguments
--subscription

訂用帳戶的名稱或標識碼。 您可以使用 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

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--ids

一或多個資源識別碼(以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性 值
參數群組: 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

訂用帳戶的名稱或標識碼。 您可以使用 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」。

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

屬性 值
參數群組: 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

一或多個資源識別碼(以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

屬性 值
參數群組: 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

訂用帳戶的名稱或標識碼。 您可以使用 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