Databases - List By Elastic Pool
Pobiera listę baz danych w elastycznej puli.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/elasticPools/{elasticPoolName}/databases?api-version=2021-11-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
elastic
|
path | True |
string |
Nazwa elastycznej puli. |
resource
|
path | True |
string |
Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API Resource Manager platformy Azure lub portalu. |
server
|
path | True |
string |
Nazwa serwera. |
subscription
|
path | True |
string |
Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure. |
api-version
|
query | True |
string |
Wersja interfejsu API do użycia dla żądania. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Pomyślnie pobrano listę baz danych w elastycznej puli. |
|
Other Status Codes |
Odpowiedzi na błędy: ***
|
Przykłady
Gets a list of databases in an elastic pool.
Przykładowe żądanie
Przykładowa odpowiedź
{
"value": [
{
"sku": {
"name": "ElasticPool",
"tier": "Standard"
},
"kind": "v12.0,user",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"maxSizeBytes": 268435456000,
"elasticPoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/elasticPools/Pool1",
"status": "Online",
"databaseId": "bfe0735f-bc87-447f-b2c2-481f4b100614",
"creationDate": "2017-07-12T22:08:39.163Z",
"currentServiceObjectiveName": "ElasticPool",
"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/DB001",
"name": "DB001",
"type": "Microsoft.Sql/servers/databases"
},
{
"sku": {
"name": "ElasticPool",
"tier": "Standard"
},
"kind": "v12.0,user",
"properties": {
"collation": "SQL_Latin1_General_CP1_CI_AS",
"maxSizeBytes": 268435456000,
"elasticPoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/elasticPools/Pool1",
"status": "Online",
"databaseId": "82246152-3177-4357-b81c-a16d87ce3593",
"creationDate": "2017-07-12T22:10:10.773Z",
"currentServiceObjectiveName": "ElasticPool",
"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/DB002",
"name": "DB002",
"type": "Microsoft.Sql/servers/databases"
}
]
}
Definicje
Nazwa | Opis |
---|---|
Backup |
Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych. |
Catalog |
Sortowanie wykazu metadanych. |
Create |
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 pomocniczą replikę istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych. PointInTimeRestore: tworzy bazę danych przez przywrócenie kopii zapasowej istniejącej bazy danych w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a należy określić wartość restorePointInTime. Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId należy określić jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić. Przywracanie: tworzy bazę danych przez przywrócenie kopii zapasowej usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli parametr sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem zasobu bazy danych, a element sourceDatabaseDeletionDate jest ignorowany. restorePointInTime można również określić, aby przywrócić z wcześniejszego punktu w czasie. RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu długoterminowego przechowywania. 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. |
Database |
Konfiguracja tożsamości usługi Azure Active Directory dla zasobu. |
Database |
Typ tożsamości |
Database |
Typ licencji do zastosowania dla tej bazy danych.
|
Database |
Lista baz danych. |
Database |
Stan routingu tylko do odczytu. W przypadku włączenia połączeń z intencją aplikacji ustawionych na odczyt w parametry połączenia mogą być kierowane do repliki pomocniczej odczytu w tym samym regionie. Nie dotyczy bazy danych hiperskala w puli elastycznej. |
Database |
Stan bazy danych. |
Database |
Konfiguracja tożsamości usługi Azure Active Directory dla zasobu. |
Sample |
Nazwa przykładowego schematu do zastosowania podczas tworzenia tej bazy danych. |
Secondary |
Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo i Nazwane. |
Sku |
Jednostka SKU zasobu usługi ARM. |
BackupStorageRedundancy
Typ konta magazynu używany do przechowywania kopii zapasowych dla tej bazy danych.
Nazwa | Typ | Opis |
---|---|---|
Geo |
string |
|
GeoZone |
string |
|
Local |
string |
|
Zone |
string |
CatalogCollationType
Sortowanie wykazu metadanych.
Nazwa | Typ | Opis |
---|---|---|
DATABASE_DEFAULT |
string |
|
SQL_Latin1_General_CP1_CI_AS |
string |
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 pomocniczą replikę istniejącej bazy danych. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej podstawowej bazy danych.
PointInTimeRestore: tworzy bazę danych przez przywrócenie kopii zapasowej istniejącej bazy danych w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a należy określić wartość restorePointInTime.
Odzyskiwanie: tworzy bazę danych przez przywrócenie kopii zapasowej replikowanej geograficznie. sourceDatabaseId należy określić jako identyfikator zasobu bazy danych, który można odzyskać, aby przywrócić.
Przywracanie: tworzy bazę danych przez przywrócenie kopii zapasowej usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli parametr sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem zasobu bazy danych, a element sourceDatabaseDeletionDate jest ignorowany. restorePointInTime można również określić, aby przywrócić z wcześniejszego punktu w czasie.
RestoreLongTermRetentionBackup: tworzy bazę danych przez przywrócenie z magazynu długoterminowego przechowywania. recoveryServicesRecoveryPointResourceId musi być określony jako identyfikator zasobu punktu odzyskiwania.
Funkcja Copy, Secondary i RestoreLongTermRetentionBackup nie jest obsługiwana w przypadku wersji DataWarehouse.
Nazwa | Typ | Opis |
---|---|---|
Copy |
string |
|
Default |
string |
|
OnlineSecondary |
string |
|
PointInTimeRestore |
string |
|
Recovery |
string |
|
Restore |
string |
|
RestoreExternalBackup |
string |
|
RestoreExternalBackupSecondary |
string |
|
RestoreLongTermRetentionBackup |
string |
|
Secondary |
string |
Database
Zasób bazy danych.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu. |
identity |
Tożsamość usługi Azure Active Directory bazy danych. |
|
kind |
string |
Rodzaj bazy danych. Są to metadane używane w środowisku Azure Portal. |
location |
string |
Lokalizacja zasobu. |
managedBy |
string |
Zasób, który zarządza bazą danych. |
name |
string |
Nazwa zasobu. |
properties.autoPauseDelay |
integer |
Czas w minutach, po którym baza danych jest automatycznie wstrzymana. Wartość -1 oznacza, że automatyczne wstrzymanie jest wyłączone |
properties.catalogCollation |
Sortowanie wykazu metadanych. |
|
properties.collation |
string |
Sortowanie bazy danych. |
properties.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 przez przywrócenie kopii zapasowej istniejącej bazy danych do punktu w czasie. sourceDatabaseId musi być określony jako identyfikator zasobu istniejącej bazy danych, a parametr 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 przez przywrócenie kopii zapasowej usuniętej bazy danych. parametr sourceDatabaseId musi być określony. Jeśli parametr sourceDatabaseId jest oryginalnym identyfikatorem zasobu bazy danych, należy określić parametr sourceDatabaseDeletionDate. W przeciwnym razie parametr sourceDatabaseId musi być identyfikatorem usuniętego zasobu bazy danych, a właściwość sourceDatabaseDeletionDate jest ignorowana. 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 długoterminowego przechowywania. 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 |
Data utworzenia bazy danych (format ISO8601). |
properties.currentBackupStorageRedundancy |
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 |
Nazwa i warstwa jednostki SKU. |
|
properties.databaseId |
string |
Identyfikator bazy danych. |
properties.defaultSecondaryLocation |
string |
Domyślny region pomocniczy dla tej bazy danych. |
properties.earliestRestoreDate |
string |
Rejestruje najwcześniejszą datę i godzinę rozpoczęcia przywracania dla tej bazy danych (format ISO8601). |
properties.elasticPoolId |
string |
Identyfikator zasobu elastycznej puli zawierającej tę bazę danych. |
properties.failoverGroupId |
string |
Identyfikator zasobu grupy trybu failover, do którego należy ta baza danych. |
properties.federatedClientId |
string |
Identyfikator klienta używany w scenariuszu cmK dla wielu dzierżaw na bazę danych |
properties.highAvailabilityReplicaCount |
integer |
Liczba replik pomocniczych skojarzonych z bazą danych, która jest używana do zapewnienia wysokiej dostępności. Nie dotyczy bazy danych w warstwie Hiperskala w elastycznej puli. |
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.licenseType |
Typ licencji do zastosowania dla tej bazy danych.
|
|
properties.longTermRetentionBackupResourceId |
string |
Identyfikator zasobu kopii zapasowej długoterminowego przechowywania skojarzony 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.maxLogSizeBytes |
integer |
Maksymalny rozmiar dziennika dla tej bazy danych. |
properties.maxSizeBytes |
integer |
Maksymalny rozmiar bazy danych wyrażony w bajtach. |
properties.minCapacity |
number |
Minimalna pojemność, którą baza danych będzie zawsze przydzielana, jeśli nie została wstrzymana |
properties.pausedDate |
string |
Data wstrzymania bazy danych przez konfigurację użytkownika lub akcję (format ISO8601). Wartość null, jeśli baza danych jest gotowa. |
properties.readScale |
Stan routingu tylko do odczytu. Jeśli ta opcja jest włączona, połączenia, które mają intencję aplikacji ustawioną na odczyt w parametry połączenia, mogą być kierowane do repliki pomocniczej tylko do odczytu w tym samym regionie. Nie dotyczy bazy danych w warstwie Hiperskala w elastycznej puli. |
|
properties.recoverableDatabaseId |
string |
Identyfikator zasobu możliwej do odzyskania bazy danych skojarzony z operacją tworzenia tej bazy danych. |
properties.recoveryServicesRecoveryPointId |
string |
Identyfikator zasobu punktu odzyskiwania skojarzonego z operacją tworzenia tej bazy danych. |
properties.requestedBackupStorageRedundancy |
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 |
Identyfikator zasobu usuniętej bazy danych skojarzonej z operacją tworzenia tej bazy danych. |
properties.restorePointInTime |
string |
Określa punkt w czasie (format ISO8601) źródłowej bazy danych, która zostanie przywrócona w celu utworzenia nowej bazy danych. |
properties.resumedDate |
string |
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 |
Nazwa przykładowego schematu, który ma być stosowany podczas tworzenia tej bazy danych. |
|
properties.secondaryType |
Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo i Named. |
|
properties.sourceDatabaseDeletionDate |
string |
Określa czas usunięcia bazy danych. |
properties.sourceDatabaseId |
string |
Identyfikator zasobu źródłowej bazy danych skojarzonej z operacją tworzenia tej bazy danych. |
properties.sourceResourceId |
string |
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 określono parametr sourceResourceId, sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId i sourceDatabaseDeletionDate nie może być określony, a parametr CreateMode musi mieć wartość 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 parametr restorePointInTime musi być określony. Gdy parametr createMode to Restore, sourceResourceId musi być identyfikatorem zasobu przywracalnej usuniętej bazy danych lub można przywrócić porzuconą pulę SQL. W przypadku odzyskiwania parametru createMode identyfikator sourceResourceId musi być identyfikatorem zasobu możliwej do odzyskania bazy danych lub możliwej do odzyskania puli SQL. Gdy 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 |
Stan bazy danych. |
|
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 |
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
|
|
tags |
object |
Tagi zasobów. |
type |
string |
Typ zasobu. |
DatabaseIdentity
Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.
Nazwa | Typ | Opis |
---|---|---|
tenantId |
string |
Identyfikator dzierżawy usługi Azure Active Directory. |
type |
Typ tożsamości |
|
userAssignedIdentities |
<string,
Database |
Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia |
DatabaseIdentityType
Typ tożsamości
Nazwa | Typ | Opis |
---|---|---|
None |
string |
|
UserAssigned |
string |
DatabaseLicenseType
Typ licencji do zastosowania dla tej bazy danych.
LicenseIncluded
jeśli potrzebujesz licencji lub BasePrice
masz licencję i kwalifikujesz się do Korzyść użycia hybrydowego platformy Azure.
Nazwa | Typ | Opis |
---|---|---|
BasePrice |
string |
|
LicenseIncluded |
string |
DatabaseListResult
Lista baz danych.
Nazwa | Typ | Opis |
---|---|---|
nextLink |
string |
Łącze, aby pobrać następną stronę wyników. |
value |
Database[] |
Tablica wyników. |
DatabaseReadScale
Stan routingu tylko do odczytu. W przypadku włączenia połączeń z intencją aplikacji ustawionych na odczyt w parametry połączenia mogą być kierowane do repliki pomocniczej odczytu w tym samym regionie. Nie dotyczy bazy danych hiperskala w puli elastycznej.
Nazwa | Typ | Opis |
---|---|---|
Disabled |
string |
|
Enabled |
string |
DatabaseStatus
Stan bazy danych.
Nazwa | Typ | Opis |
---|---|---|
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
Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.
Nazwa | Typ | Opis |
---|---|---|
clientId |
string |
Identyfikator klienta usługi Azure Active Directory. |
principalId |
string |
Identyfikator podmiotu zabezpieczeń usługi Azure Active Directory. |
SampleName
Nazwa przykładowego schematu do zastosowania podczas tworzenia tej bazy danych.
Nazwa | Typ | Opis |
---|---|---|
AdventureWorksLT |
string |
|
WideWorldImportersFull |
string |
|
WideWorldImportersStd |
string |
SecondaryType
Pomocniczy typ bazy danych, jeśli jest pomocniczy. Prawidłowe wartości to Geo i Nazwane.
Nazwa | Typ | Opis |
---|---|---|
Geo |
string |
|
Named |
string |
Sku
Jednostka SKU zasobu usługi ARM.
Nazwa | Typ | Opis |
---|---|---|
capacity |
integer |
Pojemność konkretnej 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 numeryczny, np. P3. |
size |
string |
Rozmiar konkretnej jednostki SKU |
tier |
string |
Warstwa lub wersja konkretnej jednostki SKU, np. Podstawowa, Premium. |