Databases - Pause

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

Exempel

Pauses a database.

Exempelbegäran

HTTP

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

Java

/**
 * 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. LicenseIncludedom 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

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

Name	Typ	Description
Geo	string
GeoZone	string
Local	string
Zone	string

CatalogCollationType

Sortering av metadatakatalogen.

Name	Typ	Description
DATABASE_DEFAULT	string
SQL_Latin1_General_CP1_CI_AS	string

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.

Name	Typ	Description
Copy	string
Default	string
OnlineSecondary	string
PointInTimeRestore	string
Recovery	string
Restore	string
RestoreExternalBackup	string
RestoreExternalBackupSecondary	string
RestoreLongTermRetentionBackup	string
Secondary	string

Database

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. LicenseIncludedom 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

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

Identitetstypen

Name	Typ	Description
None	string
UserAssigned	string

DatabaseLicenseType

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.

Name	Typ	Description
BasePrice	string
LicenseIncluded	string

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.

Name	Typ	Description
Disabled	string
Enabled	string

DatabaseStatus

Databasens status.

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

DatabaseUserIdentity

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

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

Name	Typ	Description
AdventureWorksLT	string
WideWorldImportersFull	string
WideWorldImportersStd	string

SecondaryType

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

Name	Typ	Description
Geo	string
Named	string

Sku

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.