Managed Databases - Update

Service:

SQL Database

API-versie:

2021-11-01

Updates een bestaande database.

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

URI-parameters

Name	In	Vereist	Type	Description
databaseName	path	True	string	De naam van de database.
managedInstanceName	path	True	string	De naam van het beheerde exemplaar.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Type	Description
properties.autoCompleteRestore	boolean	Of het herstellen van deze beheerde database automatisch moet worden voltooid.
properties.catalogCollation	CatalogCollationType	Sortering van de metagegevenscatalogus.
properties.collation	string	Sortering van de beheerde database.
properties.createMode	ManagedDatabaseCreateMode	Modus voor het maken van beheerde databases. PointInTimeRestore: maak een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. SourceDatabaseName, SourceManagedInstanceName en PointInTime moeten worden opgegeven. RestoreExternalBackup: maak een database door te herstellen vanuit externe back-upbestanden. Sortering, StorageContainerUri en StorageContainerSasToken moeten worden opgegeven. Herstel: hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. RecoverableDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen. RestoreLongTermRetentionBackup: maak een database door te herstellen vanuit een back-up met langetermijnretentie (longTermRetentionBackupResourceId vereist).
properties.lastBackupName	string	Naam van het laatste back-upbestand voor het herstellen van deze beheerde database.
properties.longTermRetentionBackupResourceId	string	De naam van de back-up voor langetermijnretentie die moet worden gebruikt voor het herstellen van deze beheerde database.
properties.recoverableDatabaseId	string	De resource-id van de herstelbare database die is gekoppeld aan de maakbewerking van deze database.
properties.restorableDroppedDatabaseId	string	De herstelbare verwijderde databaseresource-id die moet worden hersteld bij het maken van deze database.
properties.restorePointInTime	string	Voorwaardelijke. Als createMode PointInTimeRestore is, is deze waarde vereist. Hiermee geeft u het tijdstip (ISO8601 indeling) op van de brondatabase die wordt hersteld om de nieuwe database te maken.
properties.sourceDatabaseId	string	De resource-id van de brondatabase die is gekoppeld aan de maakbewerking van deze database.
properties.storageContainerSasToken	string	Voorwaardelijke. Als createMode RestoreExternalBackup is, is deze waarde vereist. Hiermee geeft u het SAS-token voor de opslagcontainer op.
properties.storageContainerUri	string	Voorwaardelijke. Als createMode RestoreExternalBackup is, is deze waarde vereist. Hiermee geeft u de URI van de opslagcontainer op waar back-ups voor deze herstelbewerking worden opgeslagen.
tags	object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	ManagedDatabase	De database is bijgewerkt.
202 Accepted		De beheerde database wordt bijgewerkt.
Other Status Codes		Foutreacties: *** 400 PitrPointInTimeInvalid - Het tijdstip {0} is ongeldig. Geldig tijdsbereik van {1} dagen vroeg tot nu en niet voordat de bronserver wordt gemaakt. 400 CannotUseTrailingWhitespacesInDatabaseName - De validatie van de databasenaam is mislukt. 400 StorageAccountFull - Managed Instance heeft de totale capaciteit van het onderliggende Azure-opslagaccount bereikt. Azure Premium Storage-account is beperkt tot 35 TB toegewezen ruimte. 400 AkvHostNotResolvingFromNode - AKV-host '{0}' kan niet worden omgezet vanuit SQL, op server '{1}'. 400 InvalidBackupRetentionPeriod- De retentiedagen van {0} is geen geldige configuratie. Geldige back-upretentie in dagen moet tussen {1} en {2} 400 ManagedDatabaseNameInUse - Database bestaat{0} al. Kies een andere databasenaam. 400 NoMoreSpaceInManagedInstance: het beheerde exemplaar heeft de opslaglimiet bereikt. Het opslaggebruik voor het beheerde exemplaar mag niet groter zijn dan (%d) MB's. 400 ManagedInstanceUpdateSloInProgress - 'De bewerking kan niet worden voltooid omdat er een wijziging in de servicelaag wordt uitgevoerd voor het beheerde exemplaar '{0}.' Wacht totdat de bewerking is voltooid en probeer het opnieuw.' 400 SameKeyMaterialNotFoundOnRemoteServer - Secundaire server beschikt niet over het sleutelmateriaal van de versleutelingsbeveiliging van de primaire server. 400 SourceDatabaseNotFound - De brondatabase bestaat niet. 400 RegionDoesNotSupportVersion : een gebruiker heeft geprobeerd een server van een opgegeven versie te maken op een locatie waar die serverversie niet wordt ondersteund. 400 PasswordNotComplex - Het opgegeven wachtwoord is niet complex genoeg. 400 CannotUseReservedDatabaseName : kan de gereserveerde databasenaam niet gebruiken in deze bewerking. 400 InvalidServerName - Ongeldige servernaam opgegeven. 400 SourceServerNotFound - Het servergedeelte van een brondatabase-id die is opgegeven in een CreateDatabaseAsCopy API-aanroep, wordt niet toegewezen aan een bestaande server. 400 TokenTooLong : het opgegeven token is te lang. 400 CurrentDatabaseSizeExceedsMaxSize - Gebruiker heeft geprobeerd de maximale grootte voor een database te verminderen tot een grootte die kleiner is dan het huidige gebruik. 400 InvalidCollation - Sortering wordt niet herkend door de server. 400 AkvEndpointNotReachableFromNode - AKV-eindpunt '{0}' is niet bereikbaar vanuit SQL, op server '{1}'. 400 ServerNotFound - De aangevraagde server is niet gevonden. 400 UnsupportedServiceName: de opgegeven naam is een ongeldige naam omdat deze een of meer niet-ondersteunde Unicode-tekens bevat. 400 CurrentDatabaseLogSizeExceedsMaxSize - Gebruiker heeft geprobeerd de database te wijzigen in een SKU met een lagere maximale logboekgrootte dan het huidige gebruik. 400 DatabaseNumberLimitReached - Maximum aantal databases voor SQL Database Managed Instance bereikt. 400 InvalidDatabaseCreateOrUpdateRequest - De aanvraagbody voor de bewerking voor het maken of bijwerken van de database is ongeldig. 400 InvalidResourceId - Ongeldige resource-id. 400 InvalidSourceDatabaseId - Ongeldige brondatabase-id. 400 InvalidRestorableDroppedDatabaseId - Ongeldige herstelbare verwijderde database-id 400 Komt niet overeenResourceGroupNameWithUrl - De opgegeven naam van de resourcegroep komt niet overeen met de naam in de URL. 400 MismatchingServerNameWithUrl - De opgegeven servernaam komt niet overeen met de naam in de URL. 400 Komt niet overeenSubscriptionWithUrl: het opgegeven abonnement komt niet overeen met het abonnement in de URL. 400 MissingCollation - Sortering is vereist. 400 MissingSourceDatabaseId - Ontbrekende brondatabase-id. 400 MissingRestorePointInTime - Ontbrekend herstelpunt 400 MissingStorageContainerSasToken - SAS-token voor opslagcontainer ontbreekt 400 MissingStorageContainerUri - Ontbrekende opslagcontainer-URI 400 RestorableDroppedDatabaseIdGivenForRestoreWithSourceDatabaseId - Kan restorableDroppedDatabaseId niet opgeven wanneer sourceDatabaseId al is opgegeven in de herstelmodus voor maken 400 CannotUseReservedDatabaseName : kan de gereserveerde databasenaam niet gebruiken in deze bewerking. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 ResourceNotFound - De aangevraagde resource is niet gevonden. 404 CannotFindServerCertificateWithThumbprint - Kan servercertificaat met vingerafdruk niet{0} vinden. Gebruik de PowerShell-cmdlet Add-AzureRmSqlManagedInstanceTransparentDataEncryptionCertificate om het certificaat te maken. 404 CannotFindObject - Kan het object niet vinden omdat het niet bestaat of omdat u geen machtigingen hebt 404 SubscriptionNotFound - Het aangevraagde abonnement is niet gevonden. 404 DatabaseDoesNotExist - Gebruiker heeft een databasenaam opgegeven die niet bestaat op dit serverexemplaren. 404 ServerNotInSubscription : de opgegeven server bestaat niet in het opgegeven abonnement. 404 RestoreSourceDatabaseNotFound - Kan de database '{0}' op het moment{1} niet vinden die kan worden hersteld. 404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 409 RemoteDatabaseExists - De naam van de doeldatabase bestaat al op de doelserver. 409 ConflictingDatabaseOperation - Er is al een bewerking op de database en de huidige bewerking moet wachten totdat deze is voltooid. 409 SubscriptionDisabled - Abonnement is uitgeschakeld. 409 ManagementServiceDatabaseBusy - Database '{0}' is bezig met een andere bewerking. Probeer de bewerking later uit. 409 ConflictingSystemOperationInProgress - Er wordt een systeemonderhoudsbewerking uitgevoerd op de database en verdere bewerkingen moeten wachten totdat deze is voltooid. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 ActivateOrDeactivateWorkflowThrottling - Activering of deactiveringswerkstroom is mislukt omdat er te veel gelijktijdige werkstromen zijn 503 DatabaseUnavailable - De bewerking is mislukt omdat de database niet beschikbaar is. 503 TooManyRequests: aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 504 RequestTimeout - Serviceaanvraag heeft de toegestane time-out overschreden.

Voorbeelden

Updates a managed database with maximal properties

Updates a managed database with minimal properties

Updates a managed database with maximal properties

Voorbeeldaanvraag

HTTP

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"
  }
}

Java

import com.azure.resourcemanager.sql.models.ManagedDatabaseUpdate;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for ManagedDatabases Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseUpdateMax.json
     */
    /**
     * Sample code: Updates a managed database with maximal properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updatesAManagedDatabaseWithMaximalProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().update("Default-SQL-SouthEastAsia",
            "managedInstance", "testdb", new ManagedDatabaseUpdate().withTags(mapOf("tagKey1", "fakeTokenPlaceholder")),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "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"
}

Statuscode:

202

Updates a managed database with minimal properties

Voorbeeldaanvraag

HTTP

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"
  }
}

Java

import com.azure.resourcemanager.sql.models.ManagedDatabaseUpdate;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for ManagedDatabases Update.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedDatabaseUpdateMin.json
     */
    /**
     * Sample code: Updates a managed database with minimal properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        updatesAManagedDatabaseWithMinimalProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().update("Default-SQL-SouthEastAsia",
            "managedInstance", "testdb", new ManagedDatabaseUpdate().withTags(mapOf("tagKey1", "fakeTokenPlaceholder")),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "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"
}

Statuscode:

202

Definities

Name	Description
CatalogCollationType	Sortering van de metagegevenscatalogus.
ManagedDatabase	Een beheerde databaseresource.
ManagedDatabaseCreateMode	Modus voor het maken van beheerde databases. PointInTimeRestore: maak een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. SourceDatabaseName, SourceManagedInstanceName en PointInTime moeten worden opgegeven. RestoreExternalBackup: maak een database door te herstellen vanuit externe back-upbestanden. Sortering, StorageContainerUri en StorageContainerSasToken moeten worden opgegeven. Herstel: hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. RecoverableDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen. RestoreLongTermRetentionBackup: maak een database door te herstellen vanuit een back-up met langetermijnretentie (longTermRetentionBackupResourceId vereist).
ManagedDatabaseStatus	Status van de database.
ManagedDatabaseUpdate	Een update van een beheerde database.

CatalogCollationType

Enumeration

Sortering van de metagegevenscatalogus.

Waarde	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

ManagedDatabase

Object

Een beheerde databaseresource.

Name	Type	Description
id	string	Resource-id.
location	string	Resourcelocatie.
name	string	Resourcenaam.
properties.autoCompleteRestore	boolean	Of het herstellen van deze beheerde database automatisch moet worden voltooid.
properties.catalogCollation	CatalogCollationType	Sortering van de metagegevenscatalogus.
properties.collation	string	Sortering van de beheerde database.
properties.createMode	ManagedDatabaseCreateMode	Modus voor het maken van beheerde databases. PointInTimeRestore: maak een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. SourceDatabaseName, SourceManagedInstanceName en PointInTime moeten worden opgegeven. RestoreExternalBackup: maak een database door te herstellen vanuit externe back-upbestanden. Sortering, StorageContainerUri en StorageContainerSasToken moeten worden opgegeven. Herstel: hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. RecoverableDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen. RestoreLongTermRetentionBackup: maak een database door te herstellen vanuit een back-up met langetermijnretentie (longTermRetentionBackupResourceId vereist).
properties.creationDate	string	Aanmaakdatum van de database.
properties.defaultSecondaryLocation	string	Geografisch gekoppelde regio.
properties.earliestRestorePoint	string	Vroegst herstelpunt in de tijd voor herstel naar een bepaald tijdstip.
properties.failoverGroupId	string	Resource-id van exemplaarfailovergroep waartoe deze beheerde database behoort.
properties.lastBackupName	string	Naam van het laatste back-upbestand voor het herstellen van deze beheerde database.
properties.longTermRetentionBackupResourceId	string	De naam van de back-up voor langetermijnretentie die moet worden gebruikt voor het herstellen van deze beheerde database.
properties.recoverableDatabaseId	string	De resource-id van de herstelbare database die is gekoppeld aan de maakbewerking van deze database.
properties.restorableDroppedDatabaseId	string	De herstelbare verwijderde databaseresource-id die moet worden hersteld bij het maken van deze database.
properties.restorePointInTime	string	Voorwaardelijke. Als createMode PointInTimeRestore is, is deze waarde vereist. Hiermee geeft u het tijdstip (ISO8601 indeling) op van de brondatabase die wordt hersteld om de nieuwe database te maken.
properties.sourceDatabaseId	string	De resource-id van de brondatabase die is gekoppeld aan de maakbewerking van deze database.
properties.status	ManagedDatabaseStatus	Status van de database.
properties.storageContainerSasToken	string	Voorwaardelijke. Als createMode RestoreExternalBackup is, is deze waarde vereist. Hiermee geeft u het SAS-token voor de opslagcontainer op.
properties.storageContainerUri	string	Voorwaardelijke. Als createMode RestoreExternalBackup is, is deze waarde vereist. Hiermee geeft u de URI van de opslagcontainer op waar back-ups voor deze herstelbewerking worden opgeslagen.
tags	object	Resourcetags.
type	string	Resourcetype.

ManagedDatabaseCreateMode

Enumeration

Modus voor het maken van beheerde databases. PointInTimeRestore: maak een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. SourceDatabaseName, SourceManagedInstanceName en PointInTime moeten worden opgegeven. RestoreExternalBackup: maak een database door te herstellen vanuit externe back-upbestanden. Sortering, StorageContainerUri en StorageContainerSasToken moeten worden opgegeven. Herstel: hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. RecoverableDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen. RestoreLongTermRetentionBackup: maak een database door te herstellen vanuit een back-up met langetermijnretentie (longTermRetentionBackupResourceId vereist).

Waarde	Description
Default
PointInTimeRestore
Recovery
RestoreExternalBackup
RestoreLongTermRetentionBackup

ManagedDatabaseStatus

Enumeration

Status van de database.

Waarde	Description
Creating
Inaccessible
Offline
Online
Restoring
Shutdown
Updating

ManagedDatabaseUpdate

Object

Een update van een beheerde database.

Name	Type	Description
properties.autoCompleteRestore	boolean	Of het herstellen van deze beheerde database automatisch moet worden voltooid.
properties.catalogCollation	CatalogCollationType	Sortering van de metagegevenscatalogus.
properties.collation	string	Sortering van de beheerde database.
properties.createMode	ManagedDatabaseCreateMode	Modus voor het maken van beheerde databases. PointInTimeRestore: maak een database door een back-up naar een bepaald tijdstip van een bestaande database te herstellen. SourceDatabaseName, SourceManagedInstanceName en PointInTime moeten worden opgegeven. RestoreExternalBackup: maak een database door te herstellen vanuit externe back-upbestanden. Sortering, StorageContainerUri en StorageContainerSasToken moeten worden opgegeven. Herstel: hiermee maakt u een database door een geo-gerepliceerde back-up te herstellen. RecoverableDatabaseId moet worden opgegeven als de herstelbare databaseresource-id om te herstellen. RestoreLongTermRetentionBackup: maak een database door te herstellen vanuit een back-up met langetermijnretentie (longTermRetentionBackupResourceId vereist).
properties.creationDate	string	Aanmaakdatum van de database.
properties.defaultSecondaryLocation	string	Geografisch gekoppelde regio.
properties.earliestRestorePoint	string	Vroegst herstelpunt in de tijd voor herstel naar een bepaald tijdstip.
properties.failoverGroupId	string	Resource-id van exemplaarfailovergroep waartoe deze beheerde database behoort.
properties.lastBackupName	string	Naam van het laatste back-upbestand voor het herstellen van deze beheerde database.
properties.longTermRetentionBackupResourceId	string	De naam van de back-up voor langetermijnretentie die moet worden gebruikt voor het herstellen van deze beheerde database.
properties.recoverableDatabaseId	string	De resource-id van de herstelbare database die is gekoppeld aan de maakbewerking van deze database.
properties.restorableDroppedDatabaseId	string	De herstelbare verwijderde databaseresource-id die moet worden hersteld bij het maken van deze database.
properties.restorePointInTime	string	Voorwaardelijke. Als createMode PointInTimeRestore is, is deze waarde vereist. Hiermee geeft u het tijdstip (ISO8601 indeling) op van de brondatabase die wordt hersteld om de nieuwe database te maken.
properties.sourceDatabaseId	string	De resource-id van de brondatabase die is gekoppeld aan de maakbewerking van deze database.
properties.status	ManagedDatabaseStatus	Status van de database.
properties.storageContainerSasToken	string	Voorwaardelijke. Als createMode RestoreExternalBackup is, is deze waarde vereist. Hiermee geeft u het SAS-token voor de opslagcontainer op.
properties.storageContainerUri	string	Voorwaardelijke. Als createMode RestoreExternalBackup is, is deze waarde vereist. Hiermee geeft u de URI van de opslagcontainer op waar back-ups voor deze herstelbewerking worden opgeslagen.
tags	object	Resourcetags.