Managed Backup Short Term Retention Policies - Create Or Update

Atualizações a política de retenção de curto prazo de um banco de dados gerenciado.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/backupShortTermRetentionPolicies/default?api-version=2021-11-01

Parâmetros de URI

Name In Required Type Description
databaseName
path True
  • string

O nome do banco de dados.

managedInstanceName
path True
  • string

O nome da instância gerenciada.

policyName
path True

O nome da política. Deve ser sempre "padrão".

resourceGroupName
path True
  • string

O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.

subscriptionId
path True
  • string

A ID de assinatura que identifica uma assinatura do Azure.

api-version
query True
  • string

A versão da API a ser usada para a solicitação.

Corpo da solicitação

Name Type Description
properties.retentionDays
  • integer

O período de retenção de backup em dias. Há suporte para quantos dias haverá suporte para a Restauração Pontual.

Respostas

Name Type Description
200 OK

Atualizou com êxito a política.

202 Accepted

Aceito

Other Status Codes

Respostas de erro: ***

  • 400 InvalidBackupRetentionDays – os dias de {0} retenção não são uma configuração válida. A retenção de backup válida deve estar em incrementos de 7 dias (7, 14, 21 etc.)

  • 400 InvalidRestorableDroppedDatabaseDeletionDate – a data de exclusão de banco de dados descartada restaurável fornecida é inválida

  • 400 InvalidRestorableDroppedDatabaseId - Identificador de banco de dados restaurado inválido

  • 400 InvalidParameterValue - Um valor inválido foi dado a um parâmetro.

  • 400 InvalidBackupRetentionPeriod – os dias de {0} retenção não são uma configuração válida. A retenção de backup válida em dias deve estar entre {1} e {2}

  • 404 SubscriptionDoesNotHaveServer – O servidor solicitado não foi encontrado

  • 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados.

  • 404 ResourceNotFound – O recurso solicitado não foi encontrado.

  • 404 SourceDatabaseNotFound – O banco de dados de origem não existe.

  • 404 CannotFindObject - Não é possível localizar o objeto porque ele não existe ou você não tem permissões

  • 404 OperationIdNotFound – A operação com id não existe.

  • 409 OperationCancelled – A operação foi cancelada pelo usuário.

  • 409 OperationInterrupted – A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis.

  • 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 500 OperationTimedOut – A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente.

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis.

  • 504 RequestTimeout – A solicitação de serviço excedeu o tempo limite permitido.

Exemplos

Update the short term retention policy for the database.

Sample Request

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb/backupShortTermRetentionPolicies/default?api-version=2021-11-01

{
  "properties": {
    "retentionDays": 14
  }
}

Sample Response

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/resourceGroup/providers/Microsoft.Sql/managedInstances/testsvr/databases/testdb/backupShortTermRetentionPolicies/default",
  "name": "default",
  "type": "Microsoft.Sql/managedInstances/databases/backupShortTermRetentionPolicies",
  "properties": {
    "retentionDays": 14
  }
}

Definições

ManagedBackupShortTermRetentionPolicy

Uma política de retenção de curto prazo.

ManagedShortTermRetentionPolicyName

O nome da política. Deve ser sempre "padrão".

ManagedBackupShortTermRetentionPolicy

Uma política de retenção de curto prazo.

Name Type Description
id
  • string

ID do recurso.

name
  • string

Nome do recurso.

properties.retentionDays
  • integer

O período de retenção de backup em dias. Há suporte para quantos dias haverá suporte para a Restauração Pontual.

type
  • string

Tipo de recurso.

ManagedShortTermRetentionPolicyName

O nome da política. Deve ser sempre "padrão".

Name Type Description
default
  • string