Databases - Pause

Reference

Služba:: SQL Database

Verze rozhraní API:: 2021-11-01

Pozastaví databázi.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
databaseName	path	True	string	Název databáze, která se má pozastavit.
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Odpovědi

Name	Typ	Description
200 OK	Database	Databáze se úspěšně pozastavila.
202 Accepted		Probíhá pozastavení databáze.
Other Status Codes		Chybové odpovědi: *** 400 CannotDeactivateWhenDeactivatingInProgress – Pracovní postup deaktivace se nezdařil, protože je již spuštěný pracovní postup deaktivace. 400 FeatureDisabledOnSelectedEdition – uživatel se pokusil použít funkci, která je v aktuální edici databáze zakázaná. 404 SourceDatabaseNotFound – zdrojová databáze neexistuje. 500 ActivateOrDeactivateWorkflowThrottling – Pracovní postup aktivace nebo deaktivace selhal, protože existuje příliš mnoho souběžných pracovních postupů.

Name

Typ

Description

200 OK

Database

Databáze se úspěšně pozastavila.

202 Accepted

Probíhá pozastavení databáze.

Other Status Codes

Chybové odpovědi: ***

400 CannotDeactivateWhenDeactivatingInProgress – Pracovní postup deaktivace se nezdařil, protože je již spuštěný pracovní postup deaktivace.
400 FeatureDisabledOnSelectedEdition – uživatel se pokusil použít funkci, která je v aktuální edici databáze zakázaná.
404 SourceDatabaseNotFound – zdrojová databáze neexistuje.
500 ActivateOrDeactivateWorkflowThrottling – Pracovní postup aktivace nebo deaktivace selhal, protože existuje příliš mnoho souběžných pracovních postupů.

Příklady

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

Ukázková odpověď

Stavový kód:: 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"
}

Stavový kód:: 202

Definice

Name	Description
BackupStorageRedundancy	Typ účtu úložiště, který se používá k ukládání záloh pro tuto databázi.
CatalogCollationType	Kolace katalogu metadat.
CreateMode	Určuje režim vytváření databáze. Výchozí hodnota: běžné vytváření databáze. Kopírování: Vytvoří databázi jako kopii existující databáze. sourceDatabaseId musí být zadáno jako ID prostředku zdrojové databáze. Sekundární: Vytvoří databázi jako sekundární repliku existující databáze. sourceDatabaseId musí být zadáno jako ID prostředku existující primární databáze. PointInTimeRestore: Vytvoří databázi obnovením zálohy existující databáze k určitému bodu v čase. sourceDatabaseId musí být zadáno jako ID prostředku existující databáze a musí být zadáno restorePointInTime. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. sourceDatabaseId musí být zadáno jako ID obnovitelného prostředku databáze, které chcete obnovit. Obnovení: Vytvoří databázi obnovením zálohy odstraněné databáze. Musí být zadán sourceDatabaseId. Pokud sourceDatabaseId je ID původního prostředku databáze, musí být zadán sourceDatabaseDeletionDate. Jinak sourceDatabaseId musí být obnovitelné ID vyřazeného prostředku databáze a sourceDatabaseDeletionDate se ignoruje. restorePointInTime může být také zadán pro obnovení z dřívějšího bodu v čase. RestoreLongTermRetentionBackup: Vytvoří databázi obnovením z trezoru dlouhodobého uchovávání. recoveryServicesRecoveryPointResourceId musí být zadané jako ID prostředku bodu obnovení. Edice DataWarehouse nepodporují copy, secondary a RestoreLongTermRetentionBackup.
Database	Prostředek databáze.
DatabaseIdentity	Konfigurace identity Azure Active Directory pro prostředek
DatabaseIdentityType	Typ identity
DatabaseLicenseType	Typ licence, který se má použít pro tuto databázi. `LicenseIncluded`pokud potřebujete licenci nebo `BasePrice` pokud máte licenci a máte nárok na Zvýhodněné hybridní využití Azure.
DatabaseReadScale	Stav směrování jen pro čtení Pokud je povoleno, připojení, která mají v připojovací řetězec nastavený záměr aplikace na jen pro čtení, můžou být směrována na sekundární repliku jen pro čtení ve stejné oblasti. Nevztahuje se na databázi Hyperscale v rámci elastického fondu.
DatabaseStatus	Stav databáze.
DatabaseUserIdentity	Konfigurace identity Azure Active Directory pro prostředek
SampleName	Název ukázkového schématu, které se má použít při vytváření této databáze.
SecondaryType	Sekundární typ databáze, pokud se jedná o sekundární databázi. Platné hodnoty jsou Geo a Pojmenované.
Sku	Skladová položka prostředku ARM.

BackupStorageRedundancy

Enumeration

Typ účtu úložiště, který se používá k ukládání záloh pro tuto databázi.

Hodnota	Description
Geo
GeoZone
Local
Zone

CatalogCollationType

Enumeration

Kolace katalogu metadat.

Hodnota	Description
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

CreateMode

Enumeration

Určuje režim vytváření databáze.

Výchozí hodnota: běžné vytváření databáze.

Kopírování: Vytvoří databázi jako kopii existující databáze. sourceDatabaseId musí být zadáno jako ID prostředku zdrojové databáze.

Sekundární: Vytvoří databázi jako sekundární repliku existující databáze. sourceDatabaseId musí být zadáno jako ID prostředku existující primární databáze.

PointInTimeRestore: Vytvoří databázi obnovením zálohy existující databáze k určitému bodu v čase. sourceDatabaseId musí být zadáno jako ID prostředku existující databáze a musí být zadáno restorePointInTime.

Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. sourceDatabaseId musí být zadáno jako ID obnovitelného prostředku databáze, které chcete obnovit.

Obnovení: Vytvoří databázi obnovením zálohy odstraněné databáze. Musí být zadán sourceDatabaseId. Pokud sourceDatabaseId je ID původního prostředku databáze, musí být zadán sourceDatabaseDeletionDate. Jinak sourceDatabaseId musí být obnovitelné ID vyřazeného prostředku databáze a sourceDatabaseDeletionDate se ignoruje. restorePointInTime může být také zadán pro obnovení z dřívějšího bodu v čase.

RestoreLongTermRetentionBackup: Vytvoří databázi obnovením z trezoru dlouhodobého uchovávání. recoveryServicesRecoveryPointResourceId musí být zadané jako ID prostředku bodu obnovení.

Edice DataWarehouse nepodporují copy, secondary a RestoreLongTermRetentionBackup.

Hodnota	Description
Copy
Default
OnlineSecondary
PointInTimeRestore
Recovery
Restore
RestoreExternalBackup
RestoreExternalBackupSecondary
RestoreLongTermRetentionBackup
Secondary

Database

Object

Prostředek databáze.

Name	Typ	Description
id	string	ID prostředku.
identity	DatabaseIdentity	Identita Azure Active Directory databáze.
kind	string	Druh databáze. Jedná se o metadata používaná pro Azure Portal prostředí.
location	string	Umístění prostředku.
managedBy	string	Prostředek, který spravuje databázi.
name	string	Název prostředku.
properties.autoPauseDelay	integer	Čas v minutách, po jehož uplynutí se databáze automaticky pozastaví. Hodnota -1 znamená, že automatické pozastavení je zakázané.
properties.catalogCollation	CatalogCollationType	Kolace katalogu metadat.
properties.collation	string	Kolace databáze.
properties.createMode	CreateMode	Určuje režim vytváření databáze. Výchozí hodnota: běžné vytváření databáze. Kopírování: Vytvoří databázi jako kopii existující databáze. sourceDatabaseId musí být zadané jako ID prostředku zdrojové databáze. Sekundární: Vytvoří databázi jako sekundární repliku existující databáze. sourceDatabaseId musí být zadané jako ID prostředku existující primární databáze. PointInTimeRestore: Vytvoří databázi obnovením zálohy existující databáze k určitému bodu v čase. SourceDatabaseId musí být zadáno jako ID prostředku existující databáze a musí být zadán parametr restorePointInTime. Obnovení: Vytvoří databázi obnovením geograficky replikované zálohy. SourceDatabaseId musí být zadané jako ID obnovitelného prostředku databáze, které se má obnovit. Obnovení: Vytvoří databázi obnovením zálohy odstraněné databáze. Musí být zadán sourceDatabaseId. Pokud sourceDatabaseId je ID původního prostředku databáze, musí být zadán sourceDatabaseDeletionDate. Jinak musí být sourceDatabaseId ID obnovitelného vyřazeného prostředku databáze a sourceDatabaseDeletionDate se ignoruje. parametr restorePointInTime může být také určen pro obnovení z dřívějšího bodu v čase. RestoreLongTermRetentionBackup: Vytvoří databázi obnovením z trezoru dlouhodobého uchovávání. recoveryServicesRecoveryPointResourceId musí být zadané jako ID prostředku bodu obnovení. Edice DataWarehouse nepodporují kopírování, sekundární a restoreLongTermRetentionBackup.
properties.creationDate	string	Datum vytvoření databáze (ISO8601 formát).
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Typ účtu úložiště, který slouží k ukládání záloh pro tuto databázi.
properties.currentServiceObjectiveName	string	Aktuální název cíle na úrovni služby databáze.
properties.currentSku	Sku	Název a úroveň skladové položky.
properties.databaseId	string	ID databáze.
properties.defaultSecondaryLocation	string	Výchozí sekundární oblast pro tuto databázi.
properties.earliestRestoreDate	string	Zaznamenává nejdříve počáteční datum a čas, kdy je obnovení pro tuto databázi k dispozici (ISO8601 formátu).
properties.elasticPoolId	string	Identifikátor prostředku elastického fondu obsahujícího tuto databázi.
properties.failoverGroupId	string	Identifikátor prostředku skupiny převzetí služeb při selhání, do kterého tato databáze patří.
properties.federatedClientId	string	ID klienta používaného pro scénář klíče CMK mezi tenanty a databází
properties.highAvailabilityReplicaCount	integer	Počet sekundárních replik přidružených k databázi, které se používají k zajištění vysoké dostupnosti. Nevztahuje se na databázi Hyperscale v rámci elastického fondu.
properties.isInfraEncryptionEnabled	boolean	Šifrování infrastruktury je pro tuto databázi povolené.
properties.isLedgerOn	boolean	Určuje, zda je tato databáze databází registru, což znamená, že všechny tabulky v databázi jsou tabulky hlavní knihy. Poznámka: Hodnotu této vlastnosti nelze po vytvoření databáze změnit.
properties.licenseType	DatabaseLicenseType	Typ licence, která se má vztahovat na tuto databázi. `LicenseIncluded`pokud potřebujete licenci nebo `BasePrice` pokud máte licenci a máte nárok na Zvýhodněné hybridní využití Azure.
properties.longTermRetentionBackupResourceId	string	Identifikátor prostředku dlouhodobě uchovávané zálohy přidružené k operaci vytvoření této databáze.
properties.maintenanceConfigurationId	string	ID konfigurace údržby přiřazené k databázi. Tato konfigurace definuje období, kdy budou probíhat aktualizace údržby.
properties.maxLogSizeBytes	integer	Maximální velikost protokolu pro tuto databázi.
properties.maxSizeBytes	integer	Maximální velikost databáze vyjádřená v bajtech.
properties.minCapacity	number	Minimální kapacita, která bude mít databáze vždy přidělenou, pokud není pozastavená
properties.pausedDate	string	Datum, kdy byla databáze pozastavena konfigurací nebo akcí uživatele (ISO8601 formát). Null, pokud je databáze připravená.
properties.readScale	DatabaseReadScale	Stav směrování jen pro čtení. Pokud je tato možnost povolená, připojení, která mají v připojovací řetězec záměr aplikace nastavený na jen pro čtení, se můžou směrovat na sekundární repliku jen pro čtení ve stejné oblasti. Nevztahuje se na databázi Hyperscale v rámci elastického fondu.
properties.recoverableDatabaseId	string	Identifikátor prostředku obnovitelné databáze přidružené k operaci vytvoření této databáze.
properties.recoveryServicesRecoveryPointId	string	Identifikátor prostředku bodu obnovení přidruženého k operaci vytvoření této databáze.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Typ účtu úložiště, který se má použít k ukládání záloh pro tuto databázi.
properties.requestedServiceObjectiveName	string	Požadovaný název cíle na úrovni služby databáze.
properties.restorableDroppedDatabaseId	string	Identifikátor prostředku obnovitelné vyřazené databáze přidružené k operaci vytvoření této databáze.
properties.restorePointInTime	string	Určuje bod v čase (ISO8601 formát) zdrojové databáze, která se obnoví za účelem vytvoření nové databáze.
properties.resumedDate	string	Datum obnovení databáze akcí uživatele nebo přihlášením k databázi (ISO8601 formát). Null, pokud je databáze pozastavena.
properties.sampleName	SampleName	Název ukázkového schématu, které se má použít při vytváření této databáze.
properties.secondaryType	SecondaryType	Sekundární typ databáze, pokud se jedná o sekundární databázi. Platné hodnoty jsou Geo (Geografická oblast) a Named (Pojmenované).
properties.sourceDatabaseDeletionDate	string	Určuje čas odstranění databáze.
properties.sourceDatabaseId	string	Identifikátor prostředku zdrojové databáze přidružené k operaci vytvoření této databáze.
properties.sourceResourceId	string	Identifikátor zdroje přidruženého k operaci vytvoření této databáze. Tato vlastnost se podporuje pouze pro edici DataWarehouse a umožňuje obnovení napříč předplatnými. Pokud je zadán parametr sourceResourceId, nesmí být zadán parametr sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId a sourceDatabaseDeletionDate a položka CreateMode musí být PointInTimeRestore, Restore nebo Recover. Pokud je hodnota createMode PointInTimeRestore, sourceResourceId musí být ID prostředku existující databáze nebo existujícího fondu SQL a musí být zadán parametr restorePointInTime. Pokud createMode je Restore, sourceResourceId musí být ID prostředku obnovitelné vyřazené databáze nebo obnovitelného vyřazeného fondu SQL. Pokud createMode je Recover, sourceResourceId musí být ID prostředku obnovitelné databáze nebo obnovitelného fondu SQL. Pokud zdrojové předplatné patří do jiného tenanta než cílové předplatné, hlavička x-ms-authorization-auxiliary musí obsahovat ověřovací token pro zdrojového tenanta. Další podrobnosti o hlavičce x-ms-authorization-auxiliary najdete v tématu https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
properties.status	DatabaseStatus	Stav databáze.
properties.zoneRedundant	boolean	Jestli je tato databáze zónově redundantní, což znamená, že repliky této databáze budou rozdělené do několika zón dostupnosti.
sku	Sku	Skladová položka databáze. Seznam skladových položek se může lišit podle oblasti a nabídky podpory. Pokud chcete určit skladové položky (včetně názvu skladové položky, úrovně nebo edice, řady a kapacity), které jsou dostupné pro vaše předplatné v oblasti Azure, použijte `Capabilities_ListByLocation` rozhraní REST API nebo jeden z následujících příkazů: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
tags	object	Značky prostředků.
type	string	Typ prostředku.

DatabaseIdentity

Object

Konfigurace identity Azure Active Directory pro prostředek

Name	Typ	Description
tenantId	string	ID tenanta Azure Active Directory.
type	DatabaseIdentityType	Typ identity
userAssignedIdentities	<string, DatabaseUserIdentity>	ID prostředků identit přiřazených uživatelem, které se mají použít

DatabaseIdentityType

Enumeration

Typ identity

Hodnota	Description
None
UserAssigned

DatabaseLicenseType

Enumeration

Typ licence, který se má použít pro tuto databázi. LicenseIncludedpokud potřebujete licenci nebo BasePrice pokud máte licenci a máte nárok na Zvýhodněné hybridní využití Azure.

Hodnota	Description
BasePrice
LicenseIncluded

DatabaseReadScale

Enumeration

Stav směrování jen pro čtení Pokud je povoleno, připojení, která mají v připojovací řetězec nastavený záměr aplikace na jen pro čtení, můžou být směrována na sekundární repliku jen pro čtení ve stejné oblasti. Nevztahuje se na databázi Hyperscale v rámci elastického fondu.

Hodnota	Description
Disabled
Enabled

DatabaseStatus

Enumeration

Stav databáze.

Hodnota	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

Object

Konfigurace identity Azure Active Directory pro prostředek

Name	Typ	Description
clientId	string	ID klienta Azure Active Directory.
principalId	string	ID objektu zabezpečení Služby Azure Active Directory.

SampleName

Enumeration

Název ukázkového schématu, které se má použít při vytváření této databáze.

Hodnota	Description
AdventureWorksLT
WideWorldImportersFull
WideWorldImportersStd

SecondaryType

Enumeration

Sekundární typ databáze, pokud se jedná o sekundární databázi. Platné hodnoty jsou Geo a Pojmenované.

Hodnota	Description
Geo
Named

Sku

Object

Skladová položka prostředku ARM.

Name	Typ	Description
capacity	integer	Kapacita konkrétní skladové položky.
family	string	Pokud má služba různé generace hardwaru pro stejnou skladovou položku, můžete to tady zaznamenat.
name	string	Název skladové položky, obvykle písmeno + číslo, například P3.
size	string	Velikost konkrétní skladové položky
tier	string	Úroveň nebo edice konkrétní skladové položky, například Basic, Premium.

Sdílet prostřednictvím

Databases - Pause

Parametry identifikátoru URI

Odpovědi

Příklady

Pauses a database.

Ukázkový požadavek

Ukázková odpověď

Definice

BackupStorageRedundancy

CatalogCollationType

CreateMode

Database

DatabaseIdentity

DatabaseIdentityType

DatabaseLicenseType

DatabaseReadScale

DatabaseStatus

DatabaseUserIdentity

SampleName

SecondaryType

Sku

Další materiály