Databases - Get

Odwołanie

Usługa:: SQL Database

Wersja interfejsu API:: 2023-08-01

Pobiera bazę danych.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?api-version=2023-08-01

Z parametrami opcjonalnymi:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?$expand={$expand}&$filter={$filter}&api-version=2023-08-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
databaseName	path	True	string	Nazwa bazy danych.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.
$expand	query		string	Zasoby podrzędne do uwzględnienia w odpowiedzi.
$filter	query		string	Wyrażenie filtru OData, które filtruje elementy w kolekcji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Database	Pomyślnie pobrano określoną bazę danych.
Other Status Codes	ErrorResponse	Odpowiedzi na błędy: *** 400 ManagedInstanceStoppingOrStopped — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie zatrzymania/zatrzymania 400 ManagedInstanceStarting — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie początkowym 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 ResourceNotFound — żądany zasób nie został znaleziony.

Nazwa

Typ

Opis

200 OK

Database

Pomyślnie pobrano określoną bazę danych.

Other Status Codes

ErrorResponse

Odpowiedzi na błędy: ***

400 ManagedInstanceStoppingOrStopped — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie zatrzymania/zatrzymania
400 ManagedInstanceStarting — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie początkowym
404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.
404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera
404 ResourceNotFound — żądany zasób nie został znaleziony.

Przykłady

Gets a database configured with Default enclave type.

Gets a database configured with VBS enclave type.

Gets a database with Availability zone specified.

Gets a database with database level keys expanded.

Gets a database.

Gets a database configured with Default enclave type.

Przykładowe żądanie

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2023-08-01

Przykładowa odpowiedź

Kod stanu:: 200

{
  "sku": {
    "name": "BC_Gen5",
    "tier": "BusinessCritical",
    "capacity": 2
  },
  "kind": "v12.0,user,vcore",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen5_2",
    "requestedServiceObjectiveName": "BC_Gen5_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "readScale": "Enabled",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 2
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "preferredEnclaveType": "Default"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Gets a database configured with VBS enclave type.

Przykładowe żądanie

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2023-08-01

Przykładowa odpowiedź

Kod stanu:: 200

{
  "sku": {
    "name": "BC_Gen5",
    "tier": "BusinessCritical",
    "capacity": 2
  },
  "kind": "v12.0,user,vcore",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen5_2",
    "requestedServiceObjectiveName": "BC_Gen5_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "readScale": "Enabled",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 2
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "preferredEnclaveType": "VBS"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Gets a database with Availability zone specified.

Przykładowe żądanie

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2023-08-01

Przykładowa odpowiedź

Kod stanu:: 200

{
  "sku": {
    "name": "S0",
    "tier": "Standard",
    "capacity": 10
  },
  "kind": "v12.0,user",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 1073741824,
    "status": "Online",
    "currentSku": {
      "name": "Standard",
      "tier": "Standard",
      "capacity": 10
    },
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentBackupStorageRedundancy": "Geo",
    "currentServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "North Europe",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "readScale": "Disabled",
    "requestedBackupStorageRedundancy": "Geo",
    "requestedServiceObjectiveName": "S0",
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "isLedgerOn": false,
    "availabilityZone": "1"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Gets a database with database level keys expanded.

Przykładowe żądanie

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?$expand=keys&api-version=2023-08-01

Przykładowa odpowiedź

Kod stanu:: 200

{
  "sku": {
    "name": "BC_Gen5",
    "tier": "BusinessCritical",
    "capacity": 2
  },
  "kind": "v12.0,user,vcore",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen5_2",
    "requestedServiceObjectiveName": "BC_Gen5_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "readScale": "Enabled",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 2
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false,
    "keys": {
      "https://your-key-vault-name.vault.azure.net/yourKey/yourKeyVersion": {},
      "https://your-key-vault-name.vault.azure.net/yourKey2/yourKey2Version": {}
    },
    "encryptionProtector": "https://your-key-vault-name.vault.azure.net/yourKey/yourKeyVersion"
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Gets a database.

Przykładowe żądanie

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb?api-version=2023-08-01

Przykładowa odpowiedź

Kod stanu:: 200

{
  "sku": {
    "name": "BC_Gen5",
    "tier": "BusinessCritical",
    "capacity": 2
  },
  "kind": "v12.0,user,vcore",
  "properties": {
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": 268435456000,
    "status": "Online",
    "databaseId": "6c764297-577b-470f-9af4-96d3d41e2ba3",
    "creationDate": "2017-06-07T04:41:33.937Z",
    "currentServiceObjectiveName": "BC_Gen5_2",
    "requestedServiceObjectiveName": "BC_Gen5_2",
    "defaultSecondaryLocation": "North Europe",
    "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
    "licenseType": "LicenseIncluded",
    "maxLogSizeBytes": 104857600,
    "isInfraEncryptionEnabled": false,
    "zoneRedundant": false,
    "readScale": "Enabled",
    "earliestRestoreDate": "2017-06-07T04:51:33.937Z",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_SouthEastAsia_1",
    "currentSku": {
      "name": "BC_Gen5",
      "tier": "BusinessCritical",
      "capacity": 2
    },
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "isLedgerOn": false
  },
  "location": "southeastasia",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases"
}

Definicje

Nazwa	Opis
AlwaysEncryptedEnclaveType	Typ enklawy żądanej w bazie danych, tj. domyślne lub enklawy VBS.
AvailabilityZoneType	Określa strefę dostępności, do których jest przypięta baza danych.
BackupStorageRedundancy	Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych.
CatalogCollationType	Sortowanie wykazu metadanych.
CreateMode	Określa tryb tworzenia bazy danych. Ustawienie domyślne: regularne tworzenie bazy danych. Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych. Pomocnicza: tworzy bazę danych jako replikę pomocniczą istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych. PointInTimeRestore: tworzy bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a element restorePointInTime musi być określony. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId musi być określony jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić. Przywracanie: tworzy bazę danych, przywracając kopię zapasową usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem usuniętej bazy danych, a parametr sourceDatabaseDeletionDate jest ignorowany. Można również określić element restorePointInTime w celu przywrócenia z wcześniejszego punktu w czasie. RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu przechowywania długoterminowego. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania. Funkcja Copy, Secondary i RestoreLongTermRetentionBackup nie jest obsługiwana w przypadku wersji DataWarehouse.
Database	Zasób bazy danych.
DatabaseIdentity	Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.
DatabaseIdentityType	Typ tożsamości
DatabaseKey	Klucz na poziomie bazy danych używany do szyfrowania magazynowanych.
DatabaseKeyType	Typ klucza bazy danych. Obsługiwana jest tylko wartość "AzureKeyVault".
DatabaseLicenseType	Typ licencji do zastosowania dla tej bazy danych. `LicenseIncluded`, jeśli potrzebujesz licencji lub `BasePrice`, jeśli masz licencję i kwalifikujesz się do korzyści użycia hybrydowego platformy Azure.
DatabaseReadScale	Stan routingu tylko do odczytu. Jeśli ta opcja jest włączona, połączenia, które mają intencję aplikacji ustawioną na odczyt w parametrach połączenia, mogą być kierowane do repliki pomocniczej tylko do odczytu w tym samym regionie. Nie dotyczy bazy danych w warstwie Hiperskala w puli elastycznej.
DatabaseStatus	Stan bazy danych.
DatabaseUserIdentity	Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
FreeLimitExhaustionBehavior	Określa zachowanie, gdy miesięczne limity bezpłatne są wyczerpane dla bezpłatnej bazy danych. Autopause: baza danych zostanie automatycznie wstrzymana po wyczerpaniu limitów bezpłatnych w pozostałej części miesiąca. BillForUsage: Baza danych będzie nadal w trybie online po wyczerpaniu bezpłatnych limitów, a wszelkie nadwyżki zostaną rozliczone.
SampleName	Nazwa przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych.
SecondaryType	Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo, Named i Standby.
Sku	Jednostka SKU zasobu usługi ARM.

AlwaysEncryptedEnclaveType

Wyliczanie

Typ enklawy żądanej w bazie danych, tj. domyślne lub enklawy VBS.

Wartość	Opis
Default
VBS

AvailabilityZoneType

Wyliczanie

Określa strefę dostępności, do których jest przypięta baza danych.

Wartość	Opis
1
2
3
NoPreference

BackupStorageRedundancy

Wyliczanie

Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych.

Wartość	Opis
Geo
GeoZone
Local
Zone

CatalogCollationType

Wyliczanie

Sortowanie wykazu metadanych.

Wartość	Opis
DATABASE_DEFAULT
SQL_Latin1_General_CP1_CI_AS

CreateMode

Wyliczanie

Określa tryb tworzenia bazy danych.

Ustawienie domyślne: regularne tworzenie bazy danych.

Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych.

Pomocnicza: tworzy bazę danych jako replikę pomocniczą istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych.

PointInTimeRestore: tworzy bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a element restorePointInTime musi być określony.

Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId musi być określony jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić.

Przywracanie: tworzy bazę danych, przywracając kopię zapasową usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem usuniętej bazy danych, a parametr sourceDatabaseDeletionDate jest ignorowany. Można również określić element restorePointInTime w celu przywrócenia z wcześniejszego punktu w czasie.

RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu przechowywania długoterminowego. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania.

Funkcja Copy, Secondary i RestoreLongTermRetentionBackup nie jest obsługiwana w przypadku wersji DataWarehouse.

Wartość	Opis
Copy
Default
OnlineSecondary
PointInTimeRestore
Recovery
Restore
RestoreExternalBackup
RestoreExternalBackupSecondary
RestoreLongTermRetentionBackup
Secondary

Database

Objekt

Zasób bazy danych.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
identity	DatabaseIdentity	Tożsamość usługi Azure Active Directory bazy danych.
kind	string	Rodzaj bazy danych. Są to metadane używane w środowisku witryny Azure Portal.
location	string	Lokalizacja zasobu.
managedBy	string	Zasób, który zarządza bazą danych.
name	string	Nazwa zasobu.
properties.autoPauseDelay	integer (int32)	Czas w minutach, po którym baza danych jest automatycznie wstrzymana. Wartość -1 oznacza, że automatyczne wstrzymanie jest wyłączone
properties.availabilityZone	AvailabilityZoneType	Określa strefę dostępności, do których jest przypięta baza danych.
properties.catalogCollation	CatalogCollationType	Sortowanie wykazu metadanych.
properties.collation	string	Sortowanie bazy danych.
properties.createMode	CreateMode	Określa tryb tworzenia bazy danych. Ustawienie domyślne: regularne tworzenie bazy danych. Kopiowanie: tworzy bazę danych jako kopię istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu źródłowej bazy danych. Pomocnicza: tworzy bazę danych jako replikę pomocniczą istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych. PointInTimeRestore: tworzy bazę danych, przywracając kopię zapasową istniejącej bazy danych do punktu w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a element restorePointInTime musi być określony. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId musi być określony jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić. Przywracanie: tworzy bazę danych, przywracając kopię zapasową usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem usuniętej bazy danych, a parametr sourceDatabaseDeletionDate jest ignorowany. Można również określić element restorePointInTime w celu przywrócenia z wcześniejszego punktu w czasie. RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu przechowywania długoterminowego. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania. Funkcja Copy, Secondary i RestoreLongTermRetentionBackup nie jest obsługiwana w przypadku wersji DataWarehouse.
properties.creationDate	string (date-time)	Data utworzenia bazy danych (format ISO8601).
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych.
properties.currentServiceObjectiveName	string	Bieżąca nazwa celu poziomu usługi bazy danych.
properties.currentSku	Sku	Nazwa i warstwa jednostki SKU.
properties.databaseId	string (uuid)	Identyfikator bazy danych.
properties.defaultSecondaryLocation	string	Domyślny region pomocniczy dla tej bazy danych.
properties.earliestRestoreDate	string (date-time)	Rejestruje najwcześniejszą datę i godzinę rozpoczęcia przywracania dla tej bazy danych (format ISO8601).
properties.elasticPoolId	string (arm-id)	Identyfikator zasobu elastycznej puli zawierającej tę bazę danych.
properties.encryptionProtector	string	Identyfikator URI usługi Azure Key Vault bazy danych, jeśli jest skonfigurowany przy użyciu kluczy zarządzanych przez klienta bazy danych.
properties.encryptionProtectorAutoRotation	boolean	Flaga włączania lub wyłączania automatycznego obracania klucza AKV ochrony bazy danych.
properties.failoverGroupId	string	Identyfikator zasobu grupy trybu failover, do którego należy ta baza danych.
properties.federatedClientId	string (uuid)	Identyfikator klienta używany dla scenariusza cmK dla dzierżawy między dzierżawami bazy danych
properties.freeLimitExhaustionBehavior	FreeLimitExhaustionBehavior	Określa zachowanie, gdy miesięczne limity bezpłatne są wyczerpane dla bezpłatnej bazy danych. Autopause: baza danych zostanie automatycznie wstrzymana po wyczerpaniu limitów bezpłatnych w pozostałej części miesiąca. BillForUsage: Baza danych będzie nadal w trybie online po wyczerpaniu bezpłatnych limitów, a wszelkie nadwyżki zostaną rozliczone.
properties.highAvailabilityReplicaCount	integer (int32)	Liczba replik pomocniczych skojarzonych z bazą danych Warstwy Krytyczne dla działania firmy, Premium lub Hiperskala, które są używane do zapewnienia wysokiej dostępności. Nie dotyczy bazy danych w warstwie Hiperskala w puli elastycznej.
properties.isInfraEncryptionEnabled	boolean	Szyfrowanie infra jest włączone dla tej bazy danych.
properties.isLedgerOn	boolean	Niezależnie od tego, czy ta baza danych jest bazą danych rejestru, co oznacza, że wszystkie tabele w bazie danych są tabelami rejestru. Uwaga: nie można zmienić wartości tej właściwości po utworzeniu bazy danych.
properties.keys	<string, DatabaseKey>	Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia
properties.licenseType	DatabaseLicenseType	Typ licencji do zastosowania dla tej bazy danych. `LicenseIncluded`, jeśli potrzebujesz licencji lub `BasePrice`, jeśli masz licencję i kwalifikujesz się do korzyści użycia hybrydowego platformy Azure.
properties.longTermRetentionBackupResourceId	string (arm-id)	Identyfikator zasobu kopii zapasowej długoterminowego przechowywania skojarzonej z operacją tworzenia tej bazy danych.
properties.maintenanceConfigurationId	string	Identyfikator konfiguracji konserwacji przypisany do bazy danych. Ta konfiguracja określa okres, w których będą wykonywane aktualizacje konserwacji.
properties.manualCutover	boolean	Niezależnie od tego, czy klient sterował ręczną migracją jednorazową, musi być wykonywany podczas operacji Aktualizacji bazy danych do warstwy Hiperskala. Ta właściwość ma zastosowanie tylko w przypadku skalowania bazy danych z warstwy Krytyczne dla działania firmy/Ogólnego przeznaczenia/Warstwy Premium/Standardowa do warstwy Hiperskala. Po określeniu instrukcji manualCutover operacja skalowania będzie czekać na wprowadzenie danych wejściowych użytkownika w celu wyzwolenia migracji jednorazowej do bazy danych w warstwie Hiperskala. Aby wyzwolić migrację jednorazową, podaj parametr "performCutover", gdy operacja skalowania jest w stanie oczekiwania.
properties.maxLogSizeBytes	integer (int64)	Maksymalny rozmiar dziennika dla tej bazy danych.
properties.maxSizeBytes	integer (int64)	Maksymalny rozmiar bazy danych wyrażony w bajtach.
properties.minCapacity	number (double)	Minimalna pojemność, którą baza danych zawsze będzie przydzielana, jeśli nie została wstrzymana
properties.pausedDate	string (date-time)	Data wstrzymania bazy danych przez konfigurację użytkownika lub akcję (ISO8601 format). Wartość null, jeśli baza danych jest gotowa.
properties.performCutover	boolean	W celu wyzwolenia ręcznego przejścia jednorazowego przez klienta w stanie oczekiwania podczas wykonywania operacji skalowania jest w toku. Ten parametr właściwości ma zastosowanie tylko do operacji skalowania, które są inicjowane wraz z parametrem "manualCutover". Ta właściwość ma zastosowanie tylko wtedy, gdy skalowanie bazy danych z warstwy Krytyczne dla działania firmy/Ogólnego przeznaczenia/Warstwy Premium/Standardowa do warstwy Hiperskala jest już w toku. Po określeniu funkcji performCutover operacja skalowania wyzwoli migrację jednorazową i wykona zmianę roli w bazie danych w warstwie Hiperskala.
properties.preferredEnclaveType	AlwaysEncryptedEnclaveType	Typ enklawy żądanej w bazie danych, tj. domyślne lub enklawy VBS.
properties.readScale	DatabaseReadScale	Stan routingu tylko do odczytu. Jeśli ta opcja jest włączona, połączenia, które mają intencję aplikacji ustawioną na odczyt w parametrach połączenia, mogą być kierowane do repliki pomocniczej tylko do odczytu w tym samym regionie. Nie dotyczy bazy danych w warstwie Hiperskala w puli elastycznej.
properties.recoverableDatabaseId	string (arm-id)	Identyfikator zasobu możliwej do odzyskania bazy danych skojarzonej z operacją tworzenia tej bazy danych.
properties.recoveryServicesRecoveryPointId	string (arm-id)	Identyfikator zasobu punktu odzyskiwania skojarzonego z operacją tworzenia tej bazy danych.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Typ konta magazynu, który ma być używany do przechowywania kopii zapasowych dla tej bazy danych.
properties.requestedServiceObjectiveName	string	Żądana nazwa celu poziomu usługi bazy danych.
properties.restorableDroppedDatabaseId	string (arm-id)	Identyfikator zasobu usuniętej bazy danych skojarzonej z operacją tworzenia tej bazy danych.
properties.restorePointInTime	string (date-time)	Określa punkt w czasie (ISO8601 format) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych.
properties.resumedDate	string (date-time)	Data wznowienia bazy danych przez akcję użytkownika lub identyfikator logowania bazy danych (ISO8601 format). Wartość null, jeśli baza danych jest wstrzymana.
properties.sampleName	SampleName	Nazwa przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych.
properties.secondaryType	SecondaryType	Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo, Named i Standby.
properties.sourceDatabaseDeletionDate	string (date-time)	Określa czas usunięcia bazy danych.
properties.sourceDatabaseId	string (arm-id)	Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych.
properties.sourceResourceId	string (arm-id)	Identyfikator zasobu źródła skojarzonego z operacją tworzenia tej bazy danych. Ta właściwość jest obsługiwana tylko w przypadku wersji DataWarehouse i umożliwia przywracanie między subskrypcjami. Jeśli parametr sourceResourceId jest określony, parametr sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId i sourceDatabaseDeletionDate nie może być określony, a właściwość CreateMode musi być typu PointInTimeRestore, Restore lub Recover. Jeśli parametr createMode to PointInTimeRestore, parametr sourceResourceId musi być identyfikatorem zasobu istniejącej bazy danych lub istniejącej puli SQL, a należy określić parametr restorePointInTime. Gdy tryb createMode to Restore, identyfikator sourceResourceId musi być identyfikatorem zasobu przywracalnej usuniętej bazy danych lub można przywrócić porzuconą pulę SQL. Gdy tryb createMode jest odzyskiwane, identyfikator sourceResourceId musi być identyfikatorem zasobu możliwej do odzyskania bazy danych lub możliwej do odzyskania puli SQL. Jeśli subskrypcja źródłowa należy do innej dzierżawy niż subskrypcja docelowa, nagłówek "x-ms-authorization-auxiliary" musi zawierać token uwierzytelniania dla dzierżawy źródłowej. Aby uzyskać więcej informacji na temat nagłówka "x-ms-authorization-auxiliary", zobacz https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
properties.status	DatabaseStatus	Stan bazy danych.
properties.useFreeLimit	boolean	Bez względu na to, czy baza danych korzysta z bezpłatnych limitów miesięcznych. Dozwolone w jednej bazie danych w subskrypcji.
properties.zoneRedundant	boolean	Niezależnie od tego, czy ta baza danych jest strefowo nadmiarowa, co oznacza, że repliki tej bazy danych będą rozłożone na wiele stref dostępności.
sku	Sku	Jednostka SKU bazy danych. Lista jednostek SKU może się różnić w zależności od regionu i oferty pomocy technicznej. Aby określić jednostki SKU (w tym nazwę jednostki SKU, warstwę/wydanie, rodzinę i pojemność), które są dostępne dla twojej subskrypcji w regionie świadczenia usługi Azure, użyj interfejsu API REST `Capabilities_ListByLocation` lub jednego z następujących poleceń: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
tags	object	Tagi zasobów.
type	string	Typ zasobu.

DatabaseIdentity

Objekt

Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.

Nazwa	Typ	Opis
tenantId	string (uuid)	Identyfikator dzierżawy usługi Azure Active Directory.
type	DatabaseIdentityType	Typ tożsamości
userAssignedIdentities	<string, DatabaseUserIdentity>	Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia

DatabaseIdentityType

Wyliczanie

Typ tożsamości

Wartość	Opis
None
UserAssigned

DatabaseKey

Objekt

Klucz na poziomie bazy danych używany do szyfrowania magazynowanych.

Nazwa	Typ	Opis
creationDate	string (date-time)	Data utworzenia klucza bazy danych.
subregion	string	Podregion klucza serwera.
thumbprint	string	Odcisk palca klucza bazy danych.
type	DatabaseKeyType	Typ klucza bazy danych. Obsługiwana jest tylko wartość "AzureKeyVault".

DatabaseKeyType

Wyliczanie

Typ klucza bazy danych. Obsługiwana jest tylko wartość "AzureKeyVault".

Wartość	Opis
AzureKeyVault

DatabaseLicenseType

Wyliczanie

Typ licencji do zastosowania dla tej bazy danych. LicenseIncluded, jeśli potrzebujesz licencji lub BasePrice, jeśli masz licencję i kwalifikujesz się do korzyści użycia hybrydowego platformy Azure.

Wartość	Opis
BasePrice
LicenseIncluded

DatabaseReadScale

Wyliczanie

Stan routingu tylko do odczytu. Jeśli ta opcja jest włączona, połączenia, które mają intencję aplikacji ustawioną na odczyt w parametrach połączenia, mogą być kierowane do repliki pomocniczej tylko do odczytu w tym samym regionie. Nie dotyczy bazy danych w warstwie Hiperskala w puli elastycznej.

Wartość	Opis
Disabled
Enabled

DatabaseStatus

Wyliczanie

Stan bazy danych.

Wartość	Opis
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

Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.

Nazwa	Typ	Opis
clientId	string (uuid)	Identyfikator klienta usługi Azure Active Directory.
principalId	string (uuid)	Identyfikator podmiotu zabezpieczeń usługi Azure Active Directory.

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

FreeLimitExhaustionBehavior

Wyliczanie

Określa zachowanie, gdy miesięczne limity bezpłatne są wyczerpane dla bezpłatnej bazy danych.

Autopause: baza danych zostanie automatycznie wstrzymana po wyczerpaniu limitów bezpłatnych w pozostałej części miesiąca.

BillForUsage: Baza danych będzie nadal w trybie online po wyczerpaniu bezpłatnych limitów, a wszelkie nadwyżki zostaną rozliczone.

Wartość	Opis
AutoPause
BillOverUsage

SampleName

Wyliczanie

Nazwa przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych.

Wartość	Opis
AdventureWorksLT
WideWorldImportersFull
WideWorldImportersStd

SecondaryType

Wyliczanie

Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo, Named i Standby.

Wartość	Opis
Geo
Named
Standby

Sku

Objekt

Jednostka SKU zasobu usługi ARM.

Nazwa	Typ	Opis
capacity	integer (int32)	Pojemność określonej jednostki SKU.
family	string	Jeśli usługa ma różne generacje sprzętu, dla tej samej jednostki SKU, można je przechwycić tutaj.
name	string	Nazwa jednostki SKU, zazwyczaj, litera + kod liczbowy, np. P3.
size	string	Rozmiar konkretnej jednostki SKU
tier	string	Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium.

Udostępnij za pośrednictwem

Databases - Get

Parametry identyfikatora URI

Odpowiedzi

Przykłady

Gets a database configured with Default enclave type.

Przykładowe żądanie

Przykładowa odpowiedź

Gets a database configured with VBS enclave type.

Przykładowe żądanie

Przykładowa odpowiedź

Gets a database with Availability zone specified.

Przykładowe żądanie

Przykładowa odpowiedź

Gets a database with database level keys expanded.

Przykładowe żądanie

Przykładowa odpowiedź

Gets a database.

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AlwaysEncryptedEnclaveType

AvailabilityZoneType

BackupStorageRedundancy

CatalogCollationType

CreateMode

Database

DatabaseIdentity

DatabaseIdentityType

DatabaseKey

DatabaseKeyType

DatabaseLicenseType

DatabaseReadScale

DatabaseStatus

DatabaseUserIdentity

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FreeLimitExhaustionBehavior

SampleName

SecondaryType

Sku

Dodatkowe zasoby