For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/it/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/it/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/it/guides/web-cloud/web-hosting/api-webhosting.md.

Come creare e gestire un'applicazione web utilizzando l'API pubblica OVHcloud

Vedi come Markdown

Scopri come utilizzare l'API pubblica OVHcloud per creare un'applicazione web: collegare domini, gestire database e configurare i certificati SSL

Obiettivo

Questa guida ti spiega come utilizzare l'API pubblica OVHcloud per creare e gestire un'applicazione web sul tuo hosting. Imparerai a effettuare le operazioni principali: collegare domini, gestire database e configurare certificati SSL.

Prerequisiti

Warning

L'utilizzo delle API OVHcloud richiede conoscenze avanzate in questo ambito. In caso di difficoltà, contatta i partner OVHcloud.

Procedura

Recuperare le informazioni del servizio

Il primo passaggio consiste nel recuperare il serviceName, un identificativo univoco del tuo servizio di hosting web. Ti servirà per la maggior parte delle chiamate API seguenti.

GET/hosting/web

Questo comando restituisce la lista dei tuoi servizi di hosting web. Ogni voce della lista è un serviceName.

Esempio di risposta:

[
  "example.cluster01.hosting.ovh.net",
  "example2.cluster02.hosting.ovh.net"
]

Collegare un dominio

Collega un dominio al tuo servizio di hosting web:

ParametroObbligatorioDescrizione
serviceNamesìNome del servizio
bypassDNSConfigurationnoSe attivo, la zona DNS non viene aggiornata
cdnnoIndica se il dominio è collegato al CDN dell'hosting. Valori consentiti: active┃none
domainnoDominio da collegare
firewallnoIndica se il firewall è attivo per questo dominio. Valori consentiti: active┃none
ipLocationnoDefinisce la localizzazione IP associata al dominio. Valori consentiti: BE┃CA┃CZ┃DE┃ES┃FI┃FR┃IE┃IT┃LT┃NL┃PL┃PT┃UK
ownLognoDominio per separare i log
pathnoPercorso in cui vengono memorizzati i file web
runtimeIdnoIdentificativo della configurazione runtime utilizzata su questo dominio
sslnoOpzione per attivare l'SSL sul dominio

Esempio di risposta:

{
 "doneDate": "2024-08-22T08:13:50.740Z",
 "function": "abuse/close",
 "id": 0,
 "lastUpdate": "2024-08-22T08:13:50.740Z",
 "objectId": "string",
 "objectType": "Abuse",
 "startDate": "2024-08-22T08:13:50.740Z",
 "status": "cancelled"
}

Generare certificati SSL

Configura e gestisci i certificati SSL per proteggere il tuo sito web:

POST/hosting/web/{serviceName}/ssl
ParametroObbligatorioDescrizione
serviceNamesìNome del servizio
certificatenoCertificato SSL da installare
chainnoCatena di certificati utilizzata per convalidare il certificato SSL
keynoChiave privata associata al certificato SSL

Esempio di risposta:

{
 "isReportable": false,
 "provider": "COMODO",
 "regenerable": false,
 "status": "created",
 "taskId": 0,
 "type": "CUSTOM"
}

Gestire i database

Le API di hosting web OVHcloud ti permettono anche di gestire i tuoi database.

Creare un database

POST/hosting/web/{serviceName}/database
ParametroObbligatorioDescrizione
serviceNamesìNome del servizio
capacitysìCapacità del database. Valori: extraSqlPersonal┃local┃privateDatabase┃sqlLocal┃sqlPersonal┃sqlPro
usersìNome utente del database. Deve essere in minuscolo e iniziare con l'identificativo del tuo hosting web
passwordnoPassword del database
quotanoSpazio allocato. Valori: 25┃100┃200┃256┃400┃512┃800┃1024
typesìTipo di database. Valori: mariadb┃mysql┃postgresql┃redis
versionnoVersione del database

Esempio di risposta:

{
"doneDate": "2024-08-22T09:24:35.206Z",
"function": "string",
"id": 0,
"lastUpdate": "2024-08-22T09:24:35.206Z",
"objectId": "string",
"objectType": "Abuse",
"startDate": "2024-08-22T09:24:35.206Z",
"status": "cancelled"
}

Elencare i database esistenti

Elenca tutti i database associati al tuo servizio di hosting web:

GET/hosting/web/{serviceName}/database
ParametroObbligatorioDescrizione
serviceNamesìNome del servizio
modesìValori consentiti: besteffort ┃ classic ┃ module

Esempio di risposta:

[
 "example.mysql.db",
 "example2.mysql.db"
]

Gestire i moduli

Recuperare una lista di moduli

Ottieni la lista dei moduli disponibili che puoi installare sul tuo hosting web:

GET/hosting/web/moduleList
ParametroObbligatorioDescrizione
activenoFiltra i moduli attivati o disattivati
branchnoFiltra i moduli in base alla versione. Valori consentiti: old ┃ stable ┃ testing
latestnoFiltro che permette di visualizzare i moduli corrispondenti alla versione più recente

Esempio di risposta:

[
 195,
 184,
 38,
 176
]

Recuperare le informazioni di un modulo

Ottieni i dettagli di uno specifico modulo installato sul tuo hosting web:

GET/hosting/web/moduleList/{id}
ParametroObbligatorioDescrizione
idsìIdentificativo del modulo

Esempio di risposta:

{
 "keywords": [
   "gallery"
 ],
 "adminNameType": "string",
 "author": "OVH",
 "branch": "old",
 "id": 195,
 "size": {
   "value": 0,
   "unit": "B"
 },
 "name": "myname",
 "upgradeFrom": [],
 "language": [
   "en",
   "fr",
   "de",
   "es",
   "pl"
 ],
 "version": "1.4.2.2",
 "active": false,
 "languageRequirement": {
   "value": "php",
   "unit": "supported versions: ''\nnon supported versions: '8+'"
 },
 "latest": true
}

Installare un nuovo modulo

Installa un nuovo modulo sul tuo servizio di hosting web:

POST/hosting/web/{serviceName}/module
ParametroObbligatorioDescrizione
serviceNamesìNome del servizio
moduleIdsìIdentificativo del modulo da installare
adminNamenoNome dell'amministratore
adminpasswordnoPassword dell'account amministratore
domainnoNome di dominio su cui verrà installato il modulo
languagenoLingua dell'installazione del modulo
pathnoPercorso sul server in cui verrà installato il modulo
dependencies -> namenoNome del servizio dipendente
dependencies -> passwordnoPassword del servizio dipendente
dependencies -> portnoPorta di connessione del servizio
dependencies -> prefixnoPrefisso utilizzato nella configurazione del servizio
dependencies -> servernoIndirizzo del server del servizio dipendente
dependencies -> typenoTipo di servizio (es.: MySQL)
dependencies -> usernoNome utente del servizio dipendente

Esempio di risposta:

{
"doneDate": "2024-08-22T09:24:35.206Z",
"function": "string",
"id": 0,
"lastUpdate": "2024-08-22T09:24:35.206Z",
"objectId": "string",
"objectType": "Abuse",
"startDate": "2024-08-22T09:24:35.206Z",
"status": "cancelled"
}

Gestire gli utenti FTP

Gestisci gli utenti FTP/SSH del tuo hosting web per semplificare accessi e configurazioni.

Creare un nuovo utente FTP/SSH

Crea un nuovo utente FTP o SSH per accedere al tuo hosting web:

POST/hosting/web/{serviceName}/user
ParametroObbligatorioDescrizione
serviceNamesìNome del servizio
homesìDirectory principale
loginsìNome utente
passwordsìPassword
sshStatenoDetermina lo stato dell'accesso SSH per l'utente. Valori consentiti: active ┃none ┃sftponly

Esempio di risposta:

{
"doneDate": "2024-08-22T09:24:35.206Z",
"function": "string",
"id": 0,
"lastUpdate": "2024-08-22T09:24:35.206Z",
"objectId": "string",
"objectType": "Abuse",
"startDate": "2024-08-22T09:24:35.206Z",
"status": "cancelled"
}

Elencare gli utenti FTP/SSH

Elenca tutti gli utenti FTP/SSH esistenti sul tuo servizio di hosting:

GET/hosting/web/{serviceName}/user
ParametroObbligatorioDescrizione
serviceNamesìNome del servizio
homenoFiltra gli utenti in base alla loro directory principale
loginnoFiltra gli utenti in base al loro nome utente

Esempio di risposta:

[
 "user1",
 "user2",
 "user3",
 "user4"
]

Ripristinare un database

Crea, elenca e ripristina i backup dei database del tuo sito web.

Creare un backup di un database

Crea un backup del tuo database per ripristinarlo in caso di necessità:

ParametroObbligatorioDescrizione
serviceNamesìNome del servizio
namesìNome del database
datesìTipo di backup. Valori consentiti: daily.1┃now┃weekly.1
sendEmailnoSe questo parametro è attivo, viene inviata un'email quando il backup è disponibile

Esempio di risposta:

{
"doneDate": "2024-08-22T09:24:35.206Z",
"function": "string",
"id": 0,
"lastUpdate": "2024-08-22T09:24:35.206Z",
"objectId": "string",
"objectType": "Abuse",
"startDate": "2024-08-22T09:24:35.206Z",
"status": "cancelled"
}

Elencare i backup di database disponibili

Elenca tutti i backup disponibili per i tuoi database:

ParametroObbligatorioDescrizione
serviceNamesìNome del servizio
namesìNome del database
creationDate.fromnoFiltra i backup creati a partire da questa data
creationDate.tonoFiltra i backup creati fino a questa data
deletionDate.fromnoFiltra i backup eliminati a partire da questa data
deletionDate.tonoFiltra i backup eliminati fino a questa data
typenoFiltra i backup in base al tipo. Valori consentiti: daily.1┃now┃weekly.1

Esempio di risposta:

[
 1,
 12
]

Ripristinare un backup specifico di un database

Ripristina un backup specifico del tuo database in caso di problemi:

ParametroObbligatorioDescrizione
serviceNamesìNome del servizio
namesìNome del database
idsìIdentificativo del backup

Esempio di risposta:

{
"doneDate": "2024-08-22T09:24:35.206Z",
"function": "string",
"id": 0,
"lastUpdate": "2024-08-22T09:24:35.206Z",
"objectId": "string",
"objectType": "Abuse",
"startDate": "2024-08-22T09:24:35.206Z",
"status": "cancelled"
}

Conclusione

Questa guida ti ha presentato le principali richieste API per gestire il tuo hosting web OVHcloud, come il collegamento di domini e la gestione di certificati SSL e database.

Esistono tuttavia molte altre chiamate API disponibili, che puoi esplorare in base alle tue esigenze. Per ulteriori opzioni e funzionalità, consulta la sezione "" dell'API OVHcloud.

Per saperne di più

Order a domain name via API

Contatta la nostra Community di utenti.

Questa pagina ti è stata utile?