Esporta (0) Stampa
Espandi tutto

Riferimenti all'API REST per la gestione di siti Web

Aggiornamento: gennaio 2014

In questa documentazione viene descritto come eseguire attività comuni in Siti Web di Microsoft Azure mediante l'API REST di gestione di Siti Web di Microsoft Azure.

noteNota
Per recuperare (HTTP GET) una sottoscrizione esistente utilizzando l'API REST, vedere Ottenere la sottoscrizione.

  • Sono necessari un account Azure valido e una sottoscrizione Azure attiva. In questa documentazione si presuppone che l'utente disponga già di una sottoscrizione attiva e di un ID sottoscrizione associato.

  • Un certificato di gestione per la sottoscrizione Azure. È necessario un certificato di gestione per autenticare l'accesso client alle risorse nella sottoscrizione. È necessario utilizzare un certificato X-509 v3 che contiene una chiave pubblica e ha un'estensione di file cer. Per ulteriori informazioni su come creare un certificato di gestione, vedere Creare e caricare un certificato di gestione per Azure. Il certificato di gestione deve trovarsi nell'archivio certificati personale predefinito nel computer locale e deve inoltre essere caricato nell'account Azure. Per caricare un certificato di gestione in Azure, nel portale di gestione principale, selezionare la pagina Impostazioni dal riquadro a sinistra. In Certificati di gestione, nella parte inferiore della pagina, selezionare Carica per caricare il file con estensione cert nell'account.

    noteNota
    È possibile caricare più certificati di gestione nella sottoscrizione di Azure. Ogni certificato di gestione è associato alla sottoscrizione e indipendente da qualsiasi distribuzione o servizio cloud. Per semplificare la gestione, è consigliabile limitare il numero di certificati di gestione e riutilizzare quelli esistenti.

L'API di gestione di Siti Web di Microsoft Azure fornisce un set RESTful di servizi Web che interagiscono con il servizio Siti Web di Microsoft Azure per gestire i siti Web. L'API dispone di entità che acquisiscono la relazione tra un utente finale e il servizio Siti Web di Microsoft Azure.

L'API di gestione del sito Web abilita un set principale di scenari per l'amministrazione di siti:

  1. Creare, eliminare e configurare siti Web.

  2. Eseguire query sullo stato dei siti Web.

  3. Eseguire query sulle metriche quali l'utilizzo delle risorse, le quote e i limiti.

  4. Recuperare i metadati quali i profili di pubblicazione.

  5. Configurare la scala dei siti Web.

Sono presenti due categorie principali di utenti finali dell'API REST di gestione di Siti Web di Microsoft Azure:

  1. Web site administrator crea e gestisce i siti e le risorse aggiuntive in Siti Web di Microsoft Azure. Questo ruolo corrisponde all'amministratore o al coamministratore della sottoscrizione Azure.

  2. Publisher accede al contenuto del sito e pubblica il contenuto utilizzando un protocollo quale FTP o WebDeploy. Dal punto di vista di un provider di hosting, un publisher è un utente FTP. Un publisher non può eseguire azioni di gestione su un sito.

L'API REST di Siti Web di Microsoft Azure espone la seguente gerarchia di risorse per la gestione dei servizi e delle distribuzioni:

/subscriptions

   /WebSpaces

      /sites

         /config

         /publishxml

         /usages

         /metrics

         /repository

   /ServerFarm

Nella tabella seguente sono riportate le descrizioni per ogni risorsa sopra riportata.

 

Risorsa Descrizione

Subscriptions

Per utilizzare Siti Web di Microsoft Azure, è necessaria una sottoscrizione Azure.

Webspaces

Uno spazio Web è un'entità logica associata alla sottoscrizione dell'utente in una regione specificata. Tutti i siti di una area specificata sono associazioni di uno spazio Web specificato.

Sites

Un sito è l'entità risorsa principale offerta dal servizio Siti Web di Microsoft Azure.

Config

Espone le proprietà di configurazione del sito quali AppSettings, ConnectionStrings, Error logging e FrameworkVersions.

Publishxml

File in formato XML contenente le impostazioni di un utente per pubblicare un'applicazione Web in Siti Web di Microsoft Azure. Questo file può essere importato e utilizzato da Visual Studio o WebMatrix.

Usages

Contiene informazioni sull'utilizzo corrente del sito Web.

Metrics

Contiene informazioni cronologiche (report) sull'utilizzo.

Repository

Il repository di gestione controllo del codice sorgente associato al sito.

Serverfarm

Un set di server dedicato per ospitare i siti per un tenant particolare in una regione specificata. Attualmente è supportata solo una server farm per datacenter.

Le nuove risorse vengono create con un verbo POST HTTP. Il nome della risorsa viene passato nel corpo della richiesta. Se la creazione della risorsa ha esito positivo, verrà restituito un codice di stato HTTP 201 (creato) e l'oggetto risorsa serializzato verrà incluso nel corpo della risposta. Se un client tenta di creare una risorsa già esistente, verrà restituito il codice HTTP 409 (conflitto).

Per leggere lo stato corrente di una risorsa esistente, viene utilizzato un verbo GET HTTP. Se la risorsa è presente, il codice di stato della risposta è 200 e il corpo della risposta conterrà un oggetto serializzato. Se la risorsa non esiste, il codice di stato della risposta è 404 (non trovato).

Le risorse esistenti vengono aggiornate con un verbo PUT HTTP. Il nome dell'oggetto viene passato nella stringa URL e il nuovo stato dell'oggetto nel corpo della richiesta. Se la risorsa viene aggiornata, verrà restituito un codice di stato HTTP 200. Se la risorsa da aggiornare non esiste, verrà restituito un codice di stato 404 (non trovato).

Una risorsa esistente viene eliminata con un verbo DELETE HTTP. Il nome dell'oggetto viene passato nella stringa URL. Se la risorsa viene eliminata, verrà restituito un codice di stato HTTP 200. Se l'oggetto è già stato eliminato o non esiste, verrà restituito il codice HTTP 404.

Tutte le API di gestione di Siti Web di Microsoft Azure supportano due formati di dati, ovvero "Plain Old Xml" (POX) o JSON. Il chiamante API può scegliere il formato impostando le intestazioni HTTP appropriate nella richiesta come segue:

 

Formato dati Intestazione HTTP

XML

"Content-Type: text/xml", "Accept: text/xml"

JSON

"Content-Type: application/json", "Accept: application/json"

Analogamente ad altri servizi Azure, anche Siti Web di Microsoft Azure è conforme al controllo delle versioni API REST di Azure. Le operazioni fornite dall'API REST di Siti Web di Microsoft Azure possono avere più versioni. È possibile specificare quale versione di un'operazione utilizzare impostando l'intestazione x-ms-version della richiesta. Se si omette l'intestazione x-ms-version, verrà utilizzata la versione predefinita. Se tramite il servizio viene chiamata una versione precedente di un'operazione e ne esiste una più recente, è possibile scegliere di continuare a chiamare tale versione precedente o modificare il codice in modo che venga chiamata la versione più recente.

WarningAvviso
Se la versione specificata è deprecata, verrà utilizzata la versione predefinita.

Il valore dell'intestazione della richiesta x-ms-version deve essere specificato nel formato AAAA-MM-GG. Esempio:

Request Headers:

x-ms-version: 2013-08-01

Per chiamare le API di Siti Web di Microsoft Azure, è necessario un certificato di gestione associato alla sottoscrizione. Per ulteriori informazioni, vedere Autenticazione di richieste di gestione del servizio.

Mostra:
© 2014 Microsoft