Databases - Pause

Referens

Tjänst:: SQL Database

API-version:: 2021-11-01

Pausar en databas.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/pause?api-version=2021-11-01

URI-parametrar

Name	I	Obligatorisk	Typ	Description
databaseName	path	True	string	Namnet på databasen som ska pausas.
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.
serverName	path	True	string	Namnet på servern.
subscriptionId	path	True	string	Prenumerations-ID:t som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Svar

Name	Typ	Description
200 OK	Database	Databasen har pausats.
202 Accepted		Det pågår en paus av databasen.
Other Status Codes		Felsvar: *** 400 CannotDeactivateWhenDeactivatingInProgress – Inaktiveringsarbetsflödet misslyckades eftersom ett inaktiverat arbetsflöde redan körs. 400 FeatureDisabledOnSelectedEdition – Användaren försökte använda en funktion som är inaktiverad i den aktuella databasutgåvan. 404 SourceDatabaseNotFound – källdatabasen finns inte. 500 ActivateOrDeactivateWorkflowThrottling – Arbetsflödet för aktivering eller inaktivering misslyckades eftersom det finns för många samtidiga arbetsflöden

Name

Typ

Description

200 OK

Database

Databasen har pausats.

202 Accepted

Det pågår en paus av databasen.

Other Status Codes

Felsvar: ***

400 CannotDeactivateWhenDeactivatingInProgress – Inaktiveringsarbetsflödet misslyckades eftersom ett inaktiverat arbetsflöde redan körs.
400 FeatureDisabledOnSelectedEdition – Användaren försökte använda en funktion som är inaktiverad i den aktuella databasutgåvan.
404 SourceDatabaseNotFound – källdatabasen finns inte.
500 ActivateOrDeactivateWorkflowThrottling – Arbetsflödet för aktivering eller inaktivering misslyckades eftersom det finns för många samtidiga arbetsflöden

Exempel

Pauses a database.

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdwdb/pause?api-version=2021-11-01


/**
 * Samples for Databases Pause.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/PauseDatabase.json
     */
    /**
     * Sample code: Pauses a database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void pausesADatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases().pause("Default-SQL-SouthEastAsia", "testsvr",
            "testdwdb", com.azure.core.util.Context.NONE);
    }
}

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

Exempelsvar

Statuskod:: 200

{
  "sku": {
    "name": "DataWarehouse"
  },
  "kind": "v12.0,user,datawarehouse",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 10995116277760,
    "status": "Paused",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-07-13T02:04:26.187Z",
    "currentServiceObjectiveName": "D1",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdwdb",
  "name": "testdwdb",
  "type": "Microsoft.Sql/servers/databases"
}

Statuskod:: 202

Definitioner

Name	Description
BackupStorageRedundancy	Lagringskontotypen som används för att lagra säkerhetskopior för den här databasen.
CatalogCollationType	Sortering av metadatakatalogen.
CreateMode	Anger läget för att skapa databasen. Standard: vanlig databasgenerering. Kopiera: skapar en databas som en kopia av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för källdatabasen. Sekundär: skapar en databas som en sekundär replik av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för den befintliga primära databasen. PointInTimeRestore: Skapar en databas genom att återställa en tidpunktssäkerhetskopia av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för den befintliga databasen och restorePointInTime måste anges. Återställning: Skapar en databas genom att återställa en geo-replikerad säkerhetskopia. sourceDatabaseId måste anges som det återställningsbara databasresurs-ID:t som ska återställas. Återställ: Skapar en databas genom att återställa en säkerhetskopia av en borttagen databas. sourceDatabaseId måste anges. Om sourceDatabaseId är databasens ursprungliga resurs-ID måste källanDatabaseDeletionDate anges. Annars måste sourceDatabaseId vara det återställningsbara borttagna databasresurs-ID:t och sourceDatabaseDeletionDate ignoreras. restorePointInTime kan också anges för återställning från en tidigare tidpunkt. RestoreLongTermRetentionBackup: Skapar en databas genom att återställa från ett långsiktigt kvarhållningsvalv. recoveryServicesRecoveryPointResourceId måste anges som resurs-ID för återställningspunkten. Copy, Secondary och RestoreLongTermRetentionBackup stöds inte för DataWarehouse Edition.
Database	En databasresurs.
DatabaseIdentity	Azure Active Directory-identitetskonfiguration för en resurs.
DatabaseIdentityType	Identitetstypen
DatabaseLicenseType	Den licenstyp som ska tillämpas för den här databasen. `LicenseIncluded`om du behöver en licens eller `BasePrice` om du har en licens och är berättigad till Azure Hybrid-förmån.
DatabaseReadScale	Tillståndet för skrivskyddad routning. Om aktiverad kan anslutningar som har program avsikt inställd på readonly i sina anslutningssträng dirigeras till en skrivskyddad sekundär replik i samma region. Gäller inte för en Hyperskala-databas i en elastisk pool.
DatabaseStatus	Databasens status.
DatabaseUserIdentity	Azure Active Directory-identitetskonfiguration för en resurs.
SampleName	Namnet på exempelschemat som ska tillämpas när du skapar den här databasen.
SecondaryType	Den sekundära typen av databas om den är sekundär. Giltiga värden är Geo och Named.
Sku	En ARM-resurs-SKU.

BackupStorageRedundancy

Uppräkning

Lagringskontotypen som används för att lagra säkerhetskopior för den här databasen.

Värde	Description
Geo
GeoZone
Local
Zone

CatalogCollationType

Uppräkning

Sortering av metadatakatalogen.

Värde	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

CreateMode

Uppräkning

Anger läget för att skapa databasen.

Standard: vanlig databasgenerering.

Kopiera: skapar en databas som en kopia av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för källdatabasen.

Sekundär: skapar en databas som en sekundär replik av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för den befintliga primära databasen.

PointInTimeRestore: Skapar en databas genom att återställa en tidpunktssäkerhetskopia av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för den befintliga databasen och restorePointInTime måste anges.

Återställning: Skapar en databas genom att återställa en geo-replikerad säkerhetskopia. sourceDatabaseId måste anges som det återställningsbara databasresurs-ID:t som ska återställas.

Återställ: Skapar en databas genom att återställa en säkerhetskopia av en borttagen databas. sourceDatabaseId måste anges. Om sourceDatabaseId är databasens ursprungliga resurs-ID måste källanDatabaseDeletionDate anges. Annars måste sourceDatabaseId vara det återställningsbara borttagna databasresurs-ID:t och sourceDatabaseDeletionDate ignoreras. restorePointInTime kan också anges för återställning från en tidigare tidpunkt.

RestoreLongTermRetentionBackup: Skapar en databas genom att återställa från ett långsiktigt kvarhållningsvalv. recoveryServicesRecoveryPointResourceId måste anges som resurs-ID för återställningspunkten.

Copy, Secondary och RestoreLongTermRetentionBackup stöds inte för DataWarehouse Edition.

Värde	Description
Copy
Default
OnlineSecondary
PointInTimeRestore
Recovery
Restore
RestoreExternalBackup
RestoreExternalBackupSecondary
RestoreLongTermRetentionBackup
Secondary

Database

Objekt

En databasresurs.

Name	Typ	Description
id	string	Resurs-ID.
identity	DatabaseIdentity	Azure Active Directory-identiteten för databasen.
kind	string	Typ av databas. Det här är metadata som används för Azure Portal upplevelse.
location	string	Resursplats.
managedBy	string	Resurs som hanterar databasen.
name	string	Resursnamn.
properties.autoPauseDelay	integer	Tid i minuter efter vilken databasen pausas automatiskt. Värdet -1 innebär att automatisk paus är inaktiverat
properties.catalogCollation	CatalogCollationType	Sortering av metadatakatalogen.
properties.collation	string	Sortering av databasen.
properties.createMode	CreateMode	Anger läget för att skapa databasen. Standard: vanlig databasgenerering. Kopiera: skapar en databas som en kopia av en befintlig databas. sourceDatabaseId måste anges som källdatabasens resurs-ID. Sekundär: skapar en databas som en sekundär replik av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för den befintliga primära databasen. PointInTimeRestore: Skapar en databas genom att återställa en säkerhetskopia av en befintlig databas. sourceDatabaseId måste anges som resurs-ID för den befintliga databasen och restorePointInTime måste anges. Återställning: Skapar en databas genom att återställa en geo-replikerad säkerhetskopia. sourceDatabaseId måste anges som det återställningsbara databasresurs-ID:t som ska återställas. Återställ: Skapar en databas genom att återställa en säkerhetskopia av en borttagen databas. sourceDatabaseId måste anges. Om sourceDatabaseId är databasens ursprungliga resurs-ID måste sourceDatabaseDeletionDate anges. Annars måste sourceDatabaseId vara det återställningsbara borttagna databasresurs-ID:t och sourceDatabaseDeletionDate ignoreras. restorePointInTime kan också anges för återställning från en tidigare tidpunkt. RestoreLongTermRetentionBackup: Skapar en databas genom att återställa från ett långsiktigt kvarhållningsvalv. recoveryServicesRecoveryPointResourceId måste anges som resurs-ID för återställningspunkten. Copy, Secondary och RestoreLongTermRetentionBackup stöds inte för DataWarehouse Edition.
properties.creationDate	string	Databasens skapandedatum (ISO8601 format).
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Den typ av lagringskonto som används för att lagra säkerhetskopior för den här databasen.
properties.currentServiceObjectiveName	string	Databasens aktuella servicenivåmålnamn.
properties.currentSku	Sku	SKU:ns namn och nivå.
properties.databaseId	string	ID:t för databasen.
properties.defaultSecondaryLocation	string	Den sekundära standardregionen för den här databasen.
properties.earliestRestoreDate	string	Detta registrerar det tidigaste startdatum och den tid som återställningen är tillgänglig för den här databasen (ISO8601 format).
properties.elasticPoolId	string	Resursidentifieraren för den elastiska poolen som innehåller den här databasen.
properties.failoverGroupId	string	Resursidentifierare för redundansgrupp som den här databasen tillhör.
properties.federatedClientId	string	Klient-ID:t som används för cmk-scenario mellan klienter per databas
properties.highAvailabilityReplicaCount	integer	Antalet sekundära repliker som är associerade med databasen som används för att tillhandahålla hög tillgänglighet. Gäller inte för en Hyperskala-databas i en elastisk pool.
properties.isInfraEncryptionEnabled	boolean	Infrakryptering är aktiverat för den här databasen.
properties.isLedgerOn	boolean	Om den här databasen är en transaktionsregisterdatabas eller inte, vilket innebär att alla tabeller i databasen är transaktionsregistertabeller. Obs! Det går inte att ändra värdet för den här egenskapen när databasen har skapats.
properties.licenseType	DatabaseLicenseType	Den licenstyp som ska gälla för den här databasen. `LicenseIncluded`om du behöver en licens eller `BasePrice` om du har en licens och är berättigad till Azure Hybrid-förmån.
properties.longTermRetentionBackupResourceId	string	Resursidentifieraren för den långsiktiga kvarhållningssäkerhetskopian som är associerad med skapandeåtgärden för den här databasen.
properties.maintenanceConfigurationId	string	Underhållskonfigurations-ID som tilldelats databasen. Den här konfigurationen definierar den period då underhållsuppdateringarna ska ske.
properties.maxLogSizeBytes	integer	Den maximala loggstorleken för den här databasen.
properties.maxSizeBytes	integer	Den maximala storleken på databasen uttryckt i byte.
properties.minCapacity	number	Minimal kapacitet som databasen alltid har allokerat, om den inte har pausats
properties.pausedDate	string	Det datum då databasen pausades av användarkonfiguration eller åtgärd (ISO8601 format). Null om databasen är klar.
properties.readScale	DatabaseReadScale	Status för skrivskyddad routning. Om det här alternativet är aktiverat kan anslutningar som har program avsikten readonly i sina anslutningssträng dirigeras till en skrivskyddad sekundär replik i samma region. Gäller inte för en Hyperskala-databas i en elastisk pool.
properties.recoverableDatabaseId	string	Resursidentifieraren för den återställningsbara databas som är associerad med skapandeåtgärden för den här databasen.
properties.recoveryServicesRecoveryPointId	string	Resursidentifieraren för återställningspunkten som är associerad med skapandeåtgärden för den här databasen.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Den typ av lagringskonto som ska användas för att lagra säkerhetskopior för den här databasen.
properties.requestedServiceObjectiveName	string	Det begärda servicenivåmålnamnet för databasen.
properties.restorableDroppedDatabaseId	string	Resursidentifieraren för den återställningsbara borttagna databas som är associerad med skapandeåtgärden för den här databasen.
properties.restorePointInTime	string	Anger tidpunkten (ISO8601 format) för källdatabasen som ska återställas för att skapa den nya databasen.
properties.resumedDate	string	Det datum då databasen återupptogs av användaråtgärd eller databasinloggning (ISO8601 format). Null om databasen har pausats.
properties.sampleName	SampleName	Namnet på exempelschemat som ska tillämpas när du skapar den här databasen.
properties.secondaryType	SecondaryType	Den sekundära typen av databas om den är sekundär. Giltiga värden är Geo och Named.
properties.sourceDatabaseDeletionDate	string	Anger den tid då databasen togs bort.
properties.sourceDatabaseId	string	Resursidentifieraren för källdatabasen som är associerad med skapandeåtgärden för den här databasen.
properties.sourceResourceId	string	Resursidentifieraren för källan som är associerad med skapandeåtgärden för den här databasen. Den här egenskapen stöds endast för DataWarehouse Edition och tillåter återställning mellan prenumerationer. När sourceResourceId har angetts får inte sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId och sourceDatabaseDeletionDate anges och CreateMode måste vara PointInTimeRestore, Restore eller Recover. När createMode är PointInTimeRestore måste sourceResourceId vara resurs-ID för den befintliga databasen eller den befintliga SQL-poolen och restorePointInTime måste anges. När createMode är Restore måste sourceResourceId vara resurs-ID för återställningsbar borttagen databas eller återställningsbar borttagen SQL-pool. När createMode är Återställ måste sourceResourceId vara resurs-ID för återställningsbar databas eller återställningsbar SQL-pool. När källprenumerationen tillhör en annan klientorganisation än målprenumerationen måste rubriken "x-ms-authorization-auxiliary" innehålla autentiseringstoken för källklienten. Mer information om rubriken "x-ms-authorization-auxiliary" finns i https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
properties.status	DatabaseStatus	Databasens status.
properties.zoneRedundant	boolean	Oavsett om den här databasen är zonredundant eller inte, vilket innebär att replikerna i den här databasen sprids över flera tillgänglighetszoner.
sku	Sku	Databasens SKU. Listan över SKU:er kan variera beroende på region och supporterbjudande. Om du vill fastställa vilka SKU:er (inklusive SKU-namn, nivå/utgåva, familj och kapacitet) som är tillgängliga för din prenumeration i en Azure-region använder du REST-API:et `Capabilities_ListByLocation` eller något av följande kommandon: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
tags	object	Resurstaggar.
type	string	Resurstyp.

DatabaseIdentity

Objekt

Azure Active Directory-identitetskonfiguration för en resurs.

Name	Typ	Description
tenantId	string	Klient-ID:t för Azure Active Directory.
type	DatabaseIdentityType	Identitetstypen
userAssignedIdentities	<string, DatabaseUserIdentity>	Resurs-ID:n för de användartilldelade identiteter som ska användas

DatabaseIdentityType

Uppräkning

Identitetstypen

Värde	Description
None
UserAssigned

DatabaseLicenseType

Uppräkning

Den licenstyp som ska tillämpas för den här databasen. LicenseIncludedom du behöver en licens eller BasePrice om du har en licens och är berättigad till Azure Hybrid-förmån.

Värde	Description
BasePrice
LicenseIncluded

DatabaseReadScale

Uppräkning

Tillståndet för skrivskyddad routning. Om aktiverad kan anslutningar som har program avsikt inställd på readonly i sina anslutningssträng dirigeras till en skrivskyddad sekundär replik i samma region. Gäller inte för en Hyperskala-databas i en elastisk pool.

Värde	Description
Disabled
Enabled

DatabaseStatus

Uppräkning

Databasens status.

Värde	Description
AutoClosed
Copying
Creating
Disabled
EmergencyMode
Inaccessible
Offline
OfflineChangingDwPerformanceTiers
OfflineSecondary
Online
OnlineChangingDwPerformanceTiers
Paused
Pausing
Recovering
RecoveryPending
Restoring
Resuming
Scaling
Shutdown
Standby
Starting
Stopped
Stopping
Suspect

DatabaseUserIdentity

Objekt

Azure Active Directory-identitetskonfiguration för en resurs.

Name	Typ	Description
clientId	string	Azure Active Directory-klient-ID: t.
principalId	string	Huvud-ID:t för Azure Active Directory.

SampleName

Uppräkning

Namnet på exempelschemat som ska tillämpas när du skapar den här databasen.

Värde	Description
AdventureWorksLT
WideWorldImportersFull
WideWorldImportersStd

SecondaryType

Uppräkning

Den sekundära typen av databas om den är sekundär. Giltiga värden är Geo och Named.

Värde	Description
Geo
Named

Sku

Objekt

En ARM-resurs-SKU.

Name	Typ	Description
capacity	integer	Kapacitet för den specifika SKU:n.
family	string	Om tjänsten har olika generationer av maskinvara, för samma SKU, kan den samlas in här.
name	string	Namnet på SKU:n, vanligtvis en bokstav + nummerkod, t.ex. P3.
size	string	Storleken på den specifika SKU:n
tier	string	Nivån eller utgåvan av den specifika SKU:n, t.ex. Basic, Premium.

Dela via

Databases - Pause

URI-parametrar

Svar

Exempel

Pauses a database.

Exempelbegäran

Exempelsvar

Definitioner

BackupStorageRedundancy

CatalogCollationType

CreateMode

Database

DatabaseIdentity

DatabaseIdentityType

DatabaseLicenseType

DatabaseReadScale

DatabaseStatus

DatabaseUserIdentity

SampleName

SecondaryType

Sku

Ytterligare resurser