az sql midb short-term-retention-policy

Manage SQL Managed Instance database backup short term retention policy.

Commands

Name	Description	Type	Status
az sql midb short-term-retention-policy set	Update short term retention for automated backups on a single database.	Core	Preview
az sql midb short-term-retention-policy show	Show short term retention for automated backups on a single database.	Core	Preview

az sql midb short-term-retention-policy set

Edit

Preview

This command is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

Update short term retention for automated backups on a single database.

az sql midb short-term-retention-policy set --retention-days
                                            [--acquire-policy-token]
                                            [--change-reference]
                                            [--deleted-time]
                                            [--ids]
                                            [--managed-instance --mi]
                                            [--name]
                                            [--no-wait]
                                            [--resource-group]
                                            [--subscription]

Examples

Set backup short term retention for live managed database.

az sql midb short-term-retention-policy set -g mygroup --mi myinstance -n mymanageddb --retention-days retentionindays

Set backup short term retention for dropped managed database.

az sql midb short-term-retention-policy set -g mygroup --mi myinstance -n mymanageddb --deleted-time "2018-05-20T05:34:22" --retention-days retentionindays

Required Parameters

--retention-days

New backup short term retention policy in days.Valid policy for live database is 7-35 days, valid policy for dropped databases is 0-35 days.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--acquire-policy-token

Acquiring an Azure Policy token automatically for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--change-reference

The related change reference ID for this resource operation.

Property	Value
Parameter group:	Global Policy Arguments

--deleted-time

If specified, updates retention days for a deleted database, instead of an existing database.Must match the deleted time of a deleted database on the source Managed Instance.

--ids

One or more resource IDs (space-delimited). It should be a complete resource ID containing all information of 'Resource Id' arguments. You should provide either --ids or other 'Resource Id' arguments.

Property	Value
Parameter group:	Resource Id Arguments

--managed-instance --mi

Name of the Azure SQL Managed Instance.

Property	Value
Parameter group:	Resource Id Arguments

--name -n

The name of the Azure SQL Managed Database.

Property	Value
Parameter group:	Resource Id Arguments

--no-wait

Do not wait for the long-running operation to finish.

Property	Value
Default value:	False

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Property	Value
Parameter group:	Resource Id Arguments

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Property	Value
Parameter group:	Resource Id Arguments

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False