Informazioni sull'API di gestione di database SQL di Windows Azure
L'API di gestione di Database SQL fornisce accesso a livello di programmazione alle stesse operazioni di gestione eseguite tramite il portale di gestione della piattaforma Windows Azure per la gestione di server Database SQL. L'utilizzo dell'API di gestione di Database SQL consente di gestire i server Database SQL per ciascuna sottoscrizione e le regole firewall associate a ogni server, risultando pertanto utile per l'automazione del supporto database di un'applicazione senza interagire direttamente con il portale di gestione.
L'API di gestione di database è un'API REST. Tutte le richieste di operazione vengono inviate crittografate tramite il protocollo SSL (Secure Sockets Layer) e autenticate utilizzando certificati X.509 v3. Le richieste API di gestione di database possono essere avviate da Windows Azure o direttamente in Internet da qualsiasi applicazione tramite cui è possibile inviare richieste HTTPS e ricevere risposte HTTPS. Tutte le richieste vengono inviate al servizio di gestione di Database SQL sulla porta 8443 utilizzando l'URL di base seguente: https://management.database.windows.net:8443.
Per ulteriori informazioni sui certificati, vedere Certificati.
Per ulteriori informazioni sull'autenticazione delle richieste API di gestione di Database SQL con certificati, vedere Autenticazione delle richieste API di gestione di database SQL di Windows Azure.
URL per le richieste API di gestione del database SQL
L'URL per ogni operazione supportata dall'API di gestione di Database SQL è mostrato nella tabella seguente. Come indicato in ogni URL in tale tabella, il servizio di gestione di Database SQL è in attesa sulla porta 8443. Nella tabella seguente viene inoltre fornita l'indicazione del metodo HTTP richiesto da utilizzare con ogni URL e dell'eventuale XML Schema richiesto nel corpo della richiesta. Inoltre, nelle sezioni successive vengono forniti esempi di codice per l'utilizzo degli URL.
| Descrizione | URL | Metodo HTTP utilizzato | XML Schema utilizzato nel corpo della richiesta |
|---|---|---|---|
|
Richiesta di operazione per l'enumerazione di server Database SQL per una sottoscrizione |
|
GET |
Nessuno |
|
Richiesta di operazione per la creazione di un server Database SQL per una sottoscrizione |
|
POST |
http://schemas.microsoft.com/sqlazure/2010/12/ Server.xsd |
|
Richiesta di operazione per l'eliminazione di un server Database SQL per una sottoscrizione |
|
DELETE |
Nessuno |
|
Richiesta di operazione per l'impostazione della password amministrativa per un server Database SQL |
|
POST |
http://schemas.microsoft.com/sqlazure/2010/12/ ResetServerPassword.xsd |
|
Richiesta di operazione per l'enumerazione delle regole firewall per un server Database SQL |
|
GET |
Nessuno |
|
Richiesta di operazione per la creazione di una nuova regola firewall o per l'aggiornamento dell'intervallo di indirizzi IP di una regola firewall esistente per un server Database SQL |
|
PUT |
http://schemas.microsoft.com/sqlazure/2010/12/ FirewallRule.xsd |
|
Richiesta di operazione per la creazione di una nuova regola firewall o per l'aggiornamento dell'intervallo di indirizzi IP di una regola firewall esistente per un server Database SQL, tramite l'indirizzo IP del client |
|
POST |
Nessuno |
|
Richiesta di operazione per l'eliminazione di una regola firewall per un server Database SQL |
|
DELETE |
Nessuno |
Gestione dei server Database SQL
Tramite l'API di gestione di Database SQL viene fornita la funzionalità per gestire i server Database SQL. In queste sezioni viene fornito il riferimento tecnico completo per ogni operazione insieme a esempi di codice per l'invio di richieste di operazioni.
| Sezione | Descrizione |
|---|---|
|
Viene illustrata la modalità di creazione di server Database SQL tramite l'API di gestione di Database SQL. |
|
|
Viene illustrata la modalità di eliminazione di server Database SQL tramite l'API di gestione di Database SQL. |
|
|
Viene illustrata la modalità di enumerazione di tutti i server Database SQL di cui è stato attualmente eseguito il provisioning per una sottoscrizione, tramite l'API di gestione di Database SQL. |
|
|
Viene illustrata la modalità di gestione delle password amministrative per un server Database SQL, tramite l'API di gestione di Database SQL. |
Gestione di regole firewall di livello server per server Database SQL
L'API di gestione di database Database SQL fornisce la funzionalità per gestire le regole firewall di livello server tramite cui viene limitato l'accesso ai server Database SQL. In queste sezioni viene fornito il riferimento tecnico completo per ogni operazione insieme a esempi di codice per l'invio di richieste di operazioni.
| Sezione | Descrizione |
|---|---|
|
Viene illustrata la modalità di creazione di regole firewall di livello server tramite l'API di gestione di Database SQL. |
|
|
Creazione di regole firewall di livello server con rilevamento IP |
Viene illustrata la modalità per creare regole firewall di livello server tramite l'API di gestione di Database SQL, con l'indirizzo IP del client aggiunto automaticamente alla regola. |
|
Viene illustrata la modalità per elencare tutte le regole firewall di livello server attive tramite l'API di gestione di Database SQL. |
|
|
Viene illustrata la modalità di eliminazione di regole firewall di livello server tramite l'API di gestione di Database SQL. |
Per ulteriori informazioni sulle regole firewall di livello server in Database SQL, vedere Firewall di database SQL di Windows Azure.
Supporto per chiamate API REST asincrone
Il servizio di gestione di Database SQL non supporta chiamate API REST asincrone.
Vedere anche