Dela via


Managed Databases - Update

Uppdateringar en befintlig databas.

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

URI-parametrar

Name I Obligatorisk Typ Description
databaseName
path True

string

Namnet på databasen.

managedInstanceName
path True

string

Namnet på den hanterade instansen.

resourceGroupName
path True

string

Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.

subscriptionId
path True

string

Det prenumerations-ID som identifierar en Azure-prenumeration.

api-version
query True

string

DEN API-version som ska användas för begäran.

Begärandetext

Name Typ Description
properties.autoCompleteRestore

boolean

Om den hanterade databasen ska återställas automatiskt.

properties.catalogCollation

CatalogCollationType

Sortering av metadatakatalogen.

properties.collation

string

Sortering av den hanterade databasen.

properties.createMode

ManagedDatabaseCreateMode

Läget skapa hanterad databas. PointInTimeRestore: Skapa en databas genom att återställa en tidpunktssäkerhetskopia av en befintlig databas. SourceDatabaseName, SourceManagedInstanceName och PointInTime måste anges. RestoreExternalBackup: Skapa en databas genom att återställa från externa säkerhetskopierade filer. Sortering, StorageContainerUri och StorageContainerSasToken måste anges. Återställning: Skapar en databas genom att återställa en geo-replikerad säkerhetskopia. RecoverableDatabaseId måste anges som det återställningsbara databasresurs-ID:t som ska återställas. RestoreLongTermRetentionBackup: Skapa en databas genom att återställa från en långsiktig kvarhållningssäkerhetskopia (longTermRetentionBackupResourceId krävs).

properties.lastBackupName

string

Namn på den senaste säkerhetskopieringsfilen för återställning av den hanterade databasen.

properties.longTermRetentionBackupResourceId

string

Namnet på säkerhetskopian för långsiktig kvarhållning som ska användas för återställning av den hanterade databasen.

properties.recoverableDatabaseId

string

Resursidentifieraren för den återställningsbara databas som är associerad med skapandeåtgärden för den här databasen.

properties.restorableDroppedDatabaseId

string

Det återställningsbara borttagna databasresurs-ID:t som ska återställas när den här databasen skapas.

properties.restorePointInTime

string

Villkorsstyrd. Om createMode är PointInTimeRestore krävs det här värdet. Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen.

properties.sourceDatabaseId

string

Resursidentifieraren för källdatabasen som är associerad med skapandeåtgärden för den här databasen.

properties.storageContainerSasToken

string

Villkorsstyrd. Om createMode är RestoreExternalBackup krävs det här värdet. Anger sas-token för lagringscontainern.

properties.storageContainerUri

string

Villkorsstyrd. Om createMode är RestoreExternalBackup krävs det här värdet. Anger URI för lagringscontainern där säkerhetskopior för den här återställningen lagras.

tags

object

Resurstaggar.

Svar

Name Typ Description
200 OK

ManagedDatabase

Databasen har uppdaterats.

202 Accepted

Uppdatering av den hanterade databasen pågår.

Other Status Codes

Felsvar: ***

  • 400 PitrPointInTimeInvalid – tidpunkten {0} är inte giltig. Giltigt tidsintervall från {1} dagar tidigt till nu och inte innan källservern skapas.

  • 400 CannotUseTrailingWhitespacesInDatabaseName – Verifieringen av databasnamn misslyckades.

  • 400 StorageAccountFull – Den hanterade instansen har nått den totala kapaciteten för det underliggande Azure-lagringskontot. Azure Premium Storage-kontot är begränsat till 35 TB allokerat utrymme.

  • 400 AkvHostNotResolvingFromNode – AKV-värden{0} kan inte matchas från SQL på servern .{1}

  • 400 InvalidBackupRetentionPeriod – kvarhållningsdagarna {0} för är inte en giltig konfiguration. Giltig kvarhållning av säkerhetskopior i dagar måste vara mellan {1} och {2}

  • 400 ManagedDatabaseNameInUse – databasen finns{0} redan. Välj ett annat databasnamn.

  • 400 NoMoreSpaceInManagedInstance – Den hanterade instansen har nått sin lagringsgräns. Lagringsanvändningen för den hanterade instansen får inte överskrida (%d) MB.

  • 400 ManagedInstanceUpdateSloInProgress – "Åtgärden kunde inte slutföras eftersom en ändring av tjänstnivån pågår för den hanterade instansen "{0}." Vänta tills åtgärden har slutförts och försök igen.”

  • 400 SameKeyMaterialNotFoundOnRemoteServer – den sekundära servern har inte nyckelmaterialet för den primära serverns krypteringsskydd.

  • 400 SourceDatabaseNotFound – källdatabasen finns inte.

  • 400 RegionDoesNotSupportVersion – En användare försökte skapa en server med en angiven version på en plats där serverversionen inte stöds.

  • 400 PasswordNotComplex – Det angivna lösenordet är inte tillräckligt komplext.

  • 400 CannotUseReservedDatabaseName – Det går inte att använda reserverade databasnamn i den här åtgärden.

  • 400 InvalidServerName – Ogiltigt servernamn har angetts.

  • 400 SourceServerNotFound – Serverdelen av ett källdatabas-ID som anges i ett CreateDatabaseAsCopy API-anrop mappas inte till en befintlig server.

  • 400 TokenTooLong – den angivna token är för lång.

  • 400 CurrentDatabaseSizeExceedsMaxSize – Användaren försökte minska den maximala storleken för en databas till en storlek som är mindre än den aktuella användningen.

  • 400 InvalidCollation – sorteringen känns inte igen av servern.

  • 400 AkvEndpointNotReachableFromNode – AKV-slutpunkten{0} kan inte nås från SQL på servern{1} .

  • 400 ServerNotFound – Den begärda servern hittades inte.

  • 400 UnsupportedServiceName – Det angivna namnet är ett ogiltigt namn eftersom det innehåller ett eller flera unicode-tecken som inte stöds.

  • 400 CurrentDatabaseLogSizeExceedsMaxSize – Användaren försökte ändra databasen till en SKU med lägre maximal loggstorlek än den aktuella användningen.

  • 400 DatabaseNumberLimitReached – Maximalt antal databaser för SQL Database hanterade instansen har nåtts.

  • 400 InvalidDatabaseCreateOrUpdateRequest – Begärandetexten för åtgärden skapa eller uppdatera databas är ogiltig.

  • 400 InvalidResourceId – Ogiltig resursidentifierare.

  • 400 InvalidSourceDatabaseId – Ogiltig källdatabasidentifierare.

  • 400 InvalidRestorableDroppedDatabaseId – Ogiltig återställningsbar borttagen databasidentifierare

  • 400 MismatchingResourceGroupNameWithUrl – Det angivna resursgruppsnamnet matchade inte namnet i URL:en.

  • 400 MismatchingServerNameWithUrl – det angivna servernamnet matchade inte namnet i URL:en.

  • 400 MismatchingSubscriptionWithUrl – den angivna prenumerationen matchade inte prenumerationen i URL:en.

  • 400 MissingCollation – Sortering krävs.

  • 400 MissingSourceDatabaseId – Källdatabasidentifierare saknas.

  • 400 MissingRestorePointInTime – Återställningspunkt saknas

  • 400 MissingStorageContainerSasToken – SAS-token för lagringscontainer saknas

  • 400 MissingStorageContainerUri – Lagringscontainer-URI saknas

  • 400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId – Det går inte att ange restoreableDroppedDatabaseId när sourceDatabaseId redan har angetts i återställningsläge

  • 400 CannotUseReservedDatabaseName – Det går inte att använda reserverade databasnamn i den här åtgärden.

  • 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte

  • 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

  • 404 ResourceNotFound – Den begärda resursen hittades inte.

  • 404 CannotFindServerCertificateWithThumbprint – Det går inte att hitta servercertifikatet med tumavtrycket .{0} Använd PowerShell-cmdleten Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate för att skapa certifikatet.

  • 404 CannotFindObject – Det går inte att hitta objektet eftersom det inte finns eller så har du inte behörighet

  • 404 SubscriptionNotFound – Det gick inte att hitta den begärda prenumerationen.

  • 404 DatabaseDoesNotExist – Användaren har angett ett databasnamn som inte finns på den här serverinstansen.

  • 404 ServerNotInSubscription – Den angivna servern finns inte i den angivna prenumerationen.

  • 404 RestoreSourceDatabaseNotFound – det gick inte att hitta databasen{0} vid den tidpunkten{1} som kan återställas.

  • 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen.

  • 409 RemoteDatabaseExists – måldatabasnamnet finns redan på målservern.

  • 409 ConflictingDatabaseOperation – Det finns redan en åtgärd på databasen och den aktuella åtgärden bör vänta tills den är klar.

  • 409 SubscriptionDisabled – Prenumerationen är inaktiverad.

  • 409 ManagementServiceDatabaseBusy – databasen är{0} upptagen med en annan åtgärd. Försök utföra åtgärden senare.

  • 409 ConflictingSystemOperationInProgress – En systemunderhållsåtgärd pågår på databasen och ytterligare åtgärder måste vänta tills den har slutförts.

  • 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 429 SubscriptionTooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 500 ActivateOrDeactivateWorkflowThrottling – Arbetsflödet för aktivering eller inaktivering misslyckades eftersom det finns för många samtidiga arbetsflöden

  • 503 DatabaseUnavailable – Åtgärden misslyckades eftersom databasen inte är tillgänglig.

  • 503 TooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser.

  • 504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen.

Exempel

Updates a managed database with maximal properties
Updates a managed database with minimal properties

Updates a managed database with maximal properties

Exempelbegäran

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Exempelsvar

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}

Updates a managed database with minimal properties

Exempelbegäran

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb?api-version=2021-11-01

{
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Exempelsvar

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb"
}

Definitioner

Name Description
CatalogCollationType

Sortering av metadatakatalogen.

ManagedDatabase

En hanterad databasresurs.

ManagedDatabaseCreateMode

Läget skapa hanterad databas. PointInTimeRestore: Skapa en databas genom att återställa en tidpunktssäkerhetskopia av en befintlig databas. SourceDatabaseName, SourceManagedInstanceName och PointInTime måste anges. RestoreExternalBackup: Skapa en databas genom att återställa från externa säkerhetskopierade filer. Sortering, StorageContainerUri och StorageContainerSasToken måste anges. Återställning: Skapar en databas genom att återställa en geo-replikerad säkerhetskopia. RecoverableDatabaseId måste anges som det återställningsbara databasresurs-ID:t som ska återställas. RestoreLongTermRetentionBackup: Skapa en databas genom att återställa från en långsiktig kvarhållningssäkerhetskopia (longTermRetentionBackupResourceId krävs).

ManagedDatabaseStatus

Databasens status.

ManagedDatabaseUpdate

En hanterad databasuppdatering.

CatalogCollationType

Sortering av metadatakatalogen.

Name Typ Description
DATABASE_DEFAULT

string

SQL_Latin1_General_CP1_CI_AS

string

ManagedDatabase

En hanterad databasresurs.

Name Typ Description
id

string

Resurs-ID.

location

string

Resursplats.

name

string

Resursnamn.

properties.autoCompleteRestore

boolean

Om den hanterade databasen ska återställas automatiskt.

properties.catalogCollation

CatalogCollationType

Sortering av metadatakatalogen.

properties.collation

string

Sortering av den hanterade databasen.

properties.createMode

ManagedDatabaseCreateMode

Läget skapa hanterad databas. PointInTimeRestore: Skapa en databas genom att återställa en tidpunktssäkerhetskopia av en befintlig databas. SourceDatabaseName, SourceManagedInstanceName och PointInTime måste anges. RestoreExternalBackup: Skapa en databas genom att återställa från externa säkerhetskopierade filer. Sortering, StorageContainerUri och StorageContainerSasToken måste anges. Återställning: Skapar en databas genom att återställa en geo-replikerad säkerhetskopia. RecoverableDatabaseId måste anges som det återställningsbara databasresurs-ID:t som ska återställas. RestoreLongTermRetentionBackup: Skapa en databas genom att återställa från en långsiktig kvarhållningssäkerhetskopia (longTermRetentionBackupResourceId krävs).

properties.creationDate

string

Skapandedatum för databasen.

properties.defaultSecondaryLocation

string

Geo-länkad region.

properties.earliestRestorePoint

string

Tidigaste återställningspunkt i tid för återställning till tidpunkt.

properties.failoverGroupId

string

Resursidentifierare för instansredundansgrupper som den hanterade databasen tillhör.

properties.lastBackupName

string

Namn på den senaste säkerhetskopieringsfilen för återställning av den hanterade databasen.

properties.longTermRetentionBackupResourceId

string

Namnet på säkerhetskopian för långsiktig kvarhållning som ska användas för återställning av den hanterade databasen.

properties.recoverableDatabaseId

string

Resursidentifieraren för den återställningsbara databas som är associerad med skapandeåtgärden för den här databasen.

properties.restorableDroppedDatabaseId

string

Det återställningsbara borttagna databasresurs-ID:t som ska återställas när den här databasen skapas.

properties.restorePointInTime

string

Villkorsstyrd. Om createMode är PointInTimeRestore krävs det här värdet. Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen.

properties.sourceDatabaseId

string

Resursidentifieraren för källdatabasen som är associerad med skapandeåtgärden för den här databasen.

properties.status

ManagedDatabaseStatus

Databasens status.

properties.storageContainerSasToken

string

Villkorsstyrd. Om createMode är RestoreExternalBackup krävs det här värdet. Anger sas-token för lagringscontainern.

properties.storageContainerUri

string

Villkorsstyrd. Om createMode är RestoreExternalBackup krävs det här värdet. Anger URI för lagringscontainern där säkerhetskopior för den här återställningen lagras.

tags

object

Resurstaggar.

type

string

Resurstyp.

ManagedDatabaseCreateMode

Läget skapa hanterad databas. PointInTimeRestore: Skapa en databas genom att återställa en tidpunktssäkerhetskopia av en befintlig databas. SourceDatabaseName, SourceManagedInstanceName och PointInTime måste anges. RestoreExternalBackup: Skapa en databas genom att återställa från externa säkerhetskopierade filer. Sortering, StorageContainerUri och StorageContainerSasToken måste anges. Återställning: Skapar en databas genom att återställa en geo-replikerad säkerhetskopia. RecoverableDatabaseId måste anges som det återställningsbara databasresurs-ID:t som ska återställas. RestoreLongTermRetentionBackup: Skapa en databas genom att återställa från en långsiktig kvarhållningssäkerhetskopia (longTermRetentionBackupResourceId krävs).

Name Typ Description
Default

string

PointInTimeRestore

string

Recovery

string

RestoreExternalBackup

string

RestoreLongTermRetentionBackup

string

ManagedDatabaseStatus

Databasens status.

Name Typ Description
Creating

string

Inaccessible

string

Offline

string

Online

string

Restoring

string

Shutdown

string

Updating

string

ManagedDatabaseUpdate

En hanterad databasuppdatering.

Name Typ Description
properties.autoCompleteRestore

boolean

Om den hanterade databasen ska återställas automatiskt.

properties.catalogCollation

CatalogCollationType

Sortering av metadatakatalogen.

properties.collation

string

Sortering av den hanterade databasen.

properties.createMode

ManagedDatabaseCreateMode

Läget skapa hanterad databas. PointInTimeRestore: Skapa en databas genom att återställa en tidpunktssäkerhetskopia av en befintlig databas. SourceDatabaseName, SourceManagedInstanceName och PointInTime måste anges. RestoreExternalBackup: Skapa en databas genom att återställa från externa säkerhetskopierade filer. Sortering, StorageContainerUri och StorageContainerSasToken måste anges. Återställning: Skapar en databas genom att återställa en geo-replikerad säkerhetskopia. RecoverableDatabaseId måste anges som det återställningsbara databasresurs-ID:t som ska återställas. RestoreLongTermRetentionBackup: Skapa en databas genom att återställa från en långsiktig kvarhållningssäkerhetskopia (longTermRetentionBackupResourceId krävs).

properties.creationDate

string

Skapandedatum för databasen.

properties.defaultSecondaryLocation

string

Geo-länkad region.

properties.earliestRestorePoint

string

Tidigaste återställningspunkt i tid för återställning till tidpunkt.

properties.failoverGroupId

string

Resursidentifierare för instansredundansgrupper som den hanterade databasen tillhör.

properties.lastBackupName

string

Namn på den senaste säkerhetskopieringsfilen för återställning av den hanterade databasen.

properties.longTermRetentionBackupResourceId

string

Namnet på säkerhetskopian för långsiktig kvarhållning som ska användas för återställning av den hanterade databasen.

properties.recoverableDatabaseId

string

Resursidentifieraren för den återställningsbara databas som är associerad med skapandeåtgärden för den här databasen.

properties.restorableDroppedDatabaseId

string

Det återställningsbara borttagna databasresurs-ID:t som ska återställas när den här databasen skapas.

properties.restorePointInTime

string

Villkorsstyrd. Om createMode är PointInTimeRestore krävs det här värdet. Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen.

properties.sourceDatabaseId

string

Resursidentifieraren för källdatabasen som är associerad med skapandeåtgärden för den här databasen.

properties.status

ManagedDatabaseStatus

Databasens status.

properties.storageContainerSasToken

string

Villkorsstyrd. Om createMode är RestoreExternalBackup krävs det här värdet. Anger sas-token för lagringscontainern.

properties.storageContainerUri

string

Villkorsstyrd. Om createMode är RestoreExternalBackup krävs det här värdet. Anger URI för lagringscontainern där säkerhetskopior för den här återställningen lagras.

tags

object

Resurstaggar.