Databases - List By Server

Riferimento

Servizio:: SQL Database

Versione API:: 2021-11-01

Ottiene un elenco di database.

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

Con parametri facoltativi:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases?$skipToken={$skipToken}&api-version=2021-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.
serverName	path	True	string	Nome del server.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.
$skipToken	query		string

Risposte

Nome	Tipo	Descrizione
200 OK	DatabaseListResult	È stato recuperato correttamente l'elenco dei database.
Other Status Codes		Risposte di errore: 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

Nome

Tipo

Descrizione

200 OK

DatabaseListResult

È stato recuperato correttamente l'elenco dei database.

Other Status Codes

Risposte di errore:

404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato
404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

Esempio

Gets a list of databases.

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


/**
 * Samples for Databases ListByServer.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ListVCoreDatabasesByServer.json
     */
    /**
     * Sample code: Gets a list of databases.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getsAListOfDatabases(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases().listByServer("Default-SQL-SouthEastAsia", "testsvr",
            null, 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

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "sku": {
        "name": "BC_Gen4",
        "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_Gen4_2",
        "requestedServiceObjectiveName": "BC_Gen4_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",
        "currentSku": {
          "name": "BC_Gen4",
          "tier": "BusinessCritical",
          "capacity": 2
        },
        "currentBackupStorageRedundancy": "Zone",
        "requestedBackupStorageRedundancy": "Zone",
        "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"
    },
    {
      "sku": {
        "name": "System0",
        "tier": "System",
        "capacity": 0
      },
      "kind": "v12.0,system",
      "properties": {
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "maxSizeBytes": 32212254720,
        "status": "Online",
        "databaseId": "e6be351f-2cc9-4604-9e52-b0b28b2710b0",
        "creationDate": "2017-06-07T04:23:42.537Z",
        "currentServiceObjectiveName": "System0",
        "requestedServiceObjectiveName": "System0",
        "defaultSecondaryLocation": "North Europe",
        "catalogCollation": "SQL_Latin1_General_CP1_CI_AS",
        "isInfraEncryptionEnabled": false,
        "zoneRedundant": false,
        "readScale": "Disabled",
        "currentSku": {
          "name": "System0",
          "tier": "System",
          "capacity": 0
        },
        "currentBackupStorageRedundancy": "Local",
        "requestedBackupStorageRedundancy": "Local",
        "isLedgerOn": false
      },
      "location": "southeastasia",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/master",
      "name": "master",
      "type": "Microsoft.Sql/servers/databases"
    }
  ]
}

Definizioni

Nome	Descrizione
BackupStorageRedundancy	Tipo di account di archiviazione usato per archiviare i backup per questo database.
CatalogCollationType	Regole di confronto del catalogo dei metadati.
CreateMode	Specifica la modalità di creazione del database. Impostazione predefinita: creazione regolare del database. Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine. Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente. PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime. Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un momento precedente. RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino. L'edizione Copy, Secondary e RestoreLongTermRetentionBackup non è supportata per l'edizione DataWarehouse.
Database	Una risorsa di database.
DatabaseIdentity	Configurazione dell'identità di Azure Active Directory per una risorsa.
DatabaseIdentityType	Tipo di identità
DatabaseLicenseType	Tipo di licenza da applicare per questo database. `LicenseIncluded`se è necessaria una licenza o `BasePrice` se si dispone di una licenza e si è idonei per il Vantaggio Azure Hybrid.
DatabaseListResult	Elenco di database.
DatabaseReadScale	Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nel stringa di connessione possono essere instradate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.
DatabaseStatus	Stato del database.
DatabaseUserIdentity	Configurazione dell'identità di Azure Active Directory per una risorsa.
SampleName	Nome dello schema di esempio da applicare durante la creazione di questo database.
SecondaryType	Tipo secondario del database se è secondario. I valori validi sono Geo e Named.
Sku	SKU della risorsa ARM.

BackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questo database.

Nome	Tipo	Descrizione
Geo	string
GeoZone	string
Local	string
Zone	string

CatalogCollationType

Regole di confronto del catalogo dei metadati.

Nome	Tipo	Descrizione
DATABASE_DEFAULT	string
SQL_Latin1_General_CP1_CI_AS	string

CreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un momento precedente.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

L'edizione Copy, Secondary e RestoreLongTermRetentionBackup non è supportata per l'edizione DataWarehouse.

Nome	Tipo	Descrizione
Copy	string
Default	string
OnlineSecondary	string
PointInTimeRestore	string
Recovery	string
Restore	string
RestoreExternalBackup	string
RestoreExternalBackupSecondary	string
RestoreLongTermRetentionBackup	string
Secondary	string

Database

Una risorsa di database.

Nome	Tipo	Descrizione
id	string	ID risorsa.
identity	DatabaseIdentity	Identità di Azure Active Directory del database.
kind	string	Tipo di database. Si tratta di metadati usati per l'esperienza di portale di Azure.
location	string	Percorso della risorsa.
managedBy	string	Risorsa che gestisce il database.
name	string	Nome risorsa.
properties.autoPauseDelay	integer	Tempo in minuti dopo il quale il database viene sospeso automaticamente. Il valore -1 indica che la sospensione automatica è disabilitata
properties.catalogCollation	CatalogCollationType	Regole di confronto del catalogo dei metadati.
properties.collation	string	Regole di confronto del database.
properties.createMode	CreateMode	Specifica la modalità di creazione del database. Impostazione predefinita: creazione regolare del database. Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine. Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente. PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime. Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database ripristinabile da ripristinare. Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un momento precedente. RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino. L'edizione Copy, Secondary e RestoreLongTermRetentionBackup non è supportata per l'edizione DataWarehouse.
properties.creationDate	string	Data di creazione del database (formato ISO8601).
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Tipo di account di archiviazione usato per archiviare i backup per questo database.
properties.currentServiceObjectiveName	string	Nome dell'obiettivo del livello di servizio corrente del database.
properties.currentSku	Sku	Nome e livello dello SKU.
properties.databaseId	string	ID del database.
properties.defaultSecondaryLocation	string	Area secondaria predefinita per questo database.
properties.earliestRestoreDate	string	Registra la data e l'ora di inizio meno recente disponibili per il database (ISO8601 formato).
properties.elasticPoolId	string	Identificatore di risorsa del pool elastico contenente il database.
properties.failoverGroupId	string	Identificatore di risorsa del gruppo di failover a cui appartiene il database.
properties.federatedClientId	string	ID client usato per lo scenario di cmk tra tenant per database
properties.highAvailabilityReplicaCount	integer	Numero di repliche secondarie associate al database utilizzato per garantire la disponibilità elevata. Non applicabile a un database Hyperscale all'interno di un pool elastico.
properties.isInfraEncryptionEnabled	boolean	La crittografia dell'infrastruttura è abilitata per questo database.
properties.isLedgerOn	boolean	Indica se il database è un database libro mastro, ovvero tutte le tabelle del database sono tabelle mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database.
properties.licenseType	DatabaseLicenseType	Tipo di licenza da applicare per questo database. `LicenseIncluded`se è necessaria una licenza o `BasePrice` se si dispone di una licenza e si è idonei per il Vantaggio Azure Hybrid.
properties.longTermRetentionBackupResourceId	string	Identificatore della risorsa del backup di conservazione a lungo termine associato all'operazione di creazione del database.
properties.maintenanceConfigurationId	string	ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui si verificheranno gli aggiornamenti di manutenzione.
properties.maxLogSizeBytes	integer	Dimensioni massime del log per questo database.
properties.maxSizeBytes	integer	Dimensione massima del database espressa in byte.
properties.minCapacity	number	Capacità minima allocata dal database, se non sospesa
properties.pausedDate	string	Data in cui il database è stato sospeso dalla configurazione o dall'azione dell'utente(formato ISO8601). Null se il database è pronto.
properties.readScale	DatabaseReadScale	Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nel stringa di connessione possono essere instradate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.
properties.recoverableDatabaseId	string	Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database.
properties.recoveryServicesRecoveryPointId	string	Identificatore della risorsa del punto di ripristino associato all'operazione di creazione del database.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	Tipo di account di archiviazione da usare per archiviare i backup per questo database.
properties.requestedServiceObjectiveName	string	Nome dell'obiettivo del livello di servizio richiesto del database.
properties.restorableDroppedDatabaseId	string	Identificatore della risorsa del database eliminato ripristinabile associato all'operazione di creazione del database.
properties.restorePointInTime	string	Specifica il punto nel tempo (ISO8601 formato) del database di origine che verrà ripristinato per creare il nuovo database.
properties.resumedDate	string	Data in cui il database è stato ripreso dall'azione dell'utente o dall'account di accesso al database (formato ISO8601). Null se il database è sospeso.
properties.sampleName	SampleName	Nome dello schema di esempio da applicare durante la creazione di questo database.
properties.secondaryType	SecondaryType	Tipo secondario del database se è secondario. I valori validi sono Geo e Named.
properties.sourceDatabaseDeletionDate	string	Specifica l'ora di eliminazione del database.
properties.sourceDatabaseId	string	Identificatore della risorsa del database di origine associato all'operazione di creazione del database.
properties.sourceResourceId	string	Identificatore della risorsa dell'origine associata all'operazione di creazione del database. Questa proprietà è supportata solo per l'edizione DataWarehouse e consente il ripristino tra sottoscrizioni. Quando si specifica sourceResourceId, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId e sourceDatabaseDeletionDate non devono essere specificati e CreateMode deve essere PointInTimeRestore, Restore o Recover. Quando createMode è PointInTimeRestore, sourceResourceId deve essere l'ID risorsa del database esistente o del pool SQL esistente e deve essere specificato restorePointInTime. Quando createMode è Restore, sourceResourceId deve essere l'ID risorsa del database eliminato ripristinabile o il pool SQL eliminato ripristinabile. Quando createMode è Recover, sourceResourceId deve essere l'ID risorsa del database recuperabile o il pool SQL ripristinabile. Quando la sottoscrizione di origine appartiene a un tenant diverso dalla sottoscrizione di destinazione, l'intestazione "x-ms-authorization-auxiliary" deve contenere token di autenticazione per il tenant di origine. Per altre informazioni sull'intestazione "x-ms-authorization-ausiliaria", vedere https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant
properties.status	DatabaseStatus	Stato del database.
properties.zoneRedundant	boolean	Indipendentemente dal fatto che il database sia con ridondanza della zona, ovvero le repliche di questo database verranno distribuite in più zone di disponibilità.
sku	Sku	SKU del database. L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API `Capabilities_ListByLocation` REST o uno dei comandi seguenti: `az sql db list-editions -l <location> -o table` `Get-AzSqlServerServiceObjective -Location <location>`
tags	object	Tag delle risorse.
type	string	Tipo di risorsa.

DatabaseIdentity

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome	Tipo	Descrizione
tenantId	string	ID tenant di Azure Active Directory.
type	DatabaseIdentityType	Tipo di identità
userAssignedIdentities	<string, DatabaseUserIdentity>	ID risorsa delle identità assegnate dall'utente da usare

DatabaseIdentityType

Tipo di identità

Nome	Tipo	Descrizione
None	string
UserAssigned	string

DatabaseLicenseType

Tipo di licenza da applicare per questo database. LicenseIncludedse è necessaria una licenza o BasePrice se si dispone di una licenza e si è idonei per il Vantaggio Azure Hybrid.

Nome	Tipo	Descrizione
BasePrice	string
LicenseIncluded	string

DatabaseListResult

Elenco di database.

Nome	Tipo	Descrizione
nextLink	string	Collegamento per recuperare la pagina successiva dei risultati.
value	Database[]	Matrice di risultati.

DatabaseReadScale

Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nel stringa di connessione possono essere instradate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

DatabaseStatus

Stato del database.

Nome	Tipo	Descrizione
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

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome	Tipo	Descrizione
clientId	string	ID client di Azure Active Directory.
principalId	string	ID entità di Azure Active Directory.

SampleName

Nome dello schema di esempio da applicare durante la creazione di questo database.

Nome	Tipo	Descrizione
AdventureWorksLT	string
WideWorldImportersFull	string
WideWorldImportersStd	string

SecondaryType

Tipo secondario del database se è secondario. I valori validi sono Geo e Named.

Nome	Tipo	Descrizione
Geo	string
Named	string

Sku

SKU della risorsa ARM.

Nome	Tipo	Descrizione
capacity	integer	Capacità dello SKU specifico.
family	string	Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, può essere acquisito qui.
name	string	Nome dello SKU, in genere una lettera + codice numerico, ad esempio P3.
size	string	Dimensioni dello SKU specifico
tier	string	Livello o edizione dello SKU specifico, ad esempio Basic, Premium.

Condividi tramite

Databases - List By Server

Parametri dell'URI

Risposte

Esempio

Gets a list of databases.

Esempio di richiesta

Risposta di esempio

Definizioni

BackupStorageRedundancy

CatalogCollationType

CreateMode

Database

DatabaseIdentity

DatabaseIdentityType

DatabaseLicenseType

DatabaseListResult

DatabaseReadScale

DatabaseStatus

DatabaseUserIdentity

SampleName

SecondaryType

Sku

Risorse aggiuntive