Server Advisors - Update
Aggiorna un advisor server.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/advisors/{advisorName}?api-version=2025-01-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
advisor
|
path | True |
string |
Nome di Server Advisor. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
server
|
path | True |
string |
Il nome del server. |
|
subscription
|
path | True |
string (uuid) |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| properties.autoExecuteStatus | True |
Ottiene lo stato di esecuzione automatica (se consentire al sistema di eseguire le raccomandazioni) di questo advisor. I valori possibili sono 'Enabled' e 'Disabled' |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Operazione Azure completata con successo. |
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
Update server advisor
Esempio di richiesta
PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/advisors/CreateIndex?api-version=2025-01-01
{
"properties": {
"autoExecuteStatus": "Disabled"
}
}
Risposta di esempio
{
"name": "CreateIndex",
"type": "Microsoft.Sql/servers/advisors",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/workloadinsight-demos/providers/Microsoft.Sql/servers/misosisvr/advisors/CreateIndex",
"kind": "",
"location": "East Asia",
"properties": {
"advisorStatus": "GA",
"autoExecuteStatus": "Disabled",
"autoExecuteStatusInheritedFrom": "Server"
}
}
Definizioni
| Nome | Descrizione |
|---|---|
| Advisor |
Database, Server o Advisor pool elastico. |
|
Advisor |
Ottiene lo stato della disponibilità di questo advisor per i clienti. I valori possibili sono 'GA', 'PublicPreview', 'LimitedPublicPreview' e 'PrivatePreview'. |
|
Auto |
Ottiene lo stato di esecuzione automatica (se consentire al sistema di eseguire le raccomandazioni) di questo advisor. I valori possibili sono 'Enabled' e 'Disabled' |
|
Auto |
Ottiene la risorsa da cui viene ereditato il valore corrente dello stato di esecuzione automatica. Lo stato di esecuzione automatica può essere impostato su (e ereditato da) livelli diversi nella gerarchia delle risorse. I valori possibili sono 'Subscription', 'Server', 'ElasticPool', 'Database' e 'Default' (quando lo stato non è impostato in modo esplicito su alcun livello). |
|
created |
Tipo di identità che ha creato la risorsa. |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
Risposta di errore |
|
Implementation |
Ottiene il metodo in cui questa azione consigliata può essere implementata manualmente. ad esempio TSql, AzurePowerShell. |
|
Is |
Ottiene un valore che indica se l'errore può essere ignorato e l'azione consigliata può essere ritentata. I valori possibili sono: Sì/No |
|
Recommended |
Azione consigliata per database, server o pool elastico. |
|
Recommended |
Stato corrente in cui si trova l'azione consigliata. Alcuni stati di uso comune sono: Attivo ->'azione consigliata è attiva e non è stata ancora eseguita alcuna azione. In sospeso:>'azione consigliata viene approvata per ed è in attesa di esecuzione. Esecuzione:>'azione consigliata viene applicata al database utente. Verifica:>'azione consigliata è stata applicata e ne viene verificata l'utilità dal sistema. Esito positivo:>'azione consigliata è stata applicata e il miglioramento rilevati durante la verifica. Ripristino in sospeso:> verifica ha trovato poco o nessun miglioramento, quindi l'azione consigliata viene accodata per il ripristino o l'utente ha ripristinato manualmente. Ripristino:> modifiche apportate durante l'applicazione dell'azione consigliata vengono ripristinate nel database utente. Ripristino:> ripristinato correttamente le modifiche apportate dall'azione consigliata nel database utente. Ignorato:>'utente ha ignorato/ignorato in modo esplicito l'azione consigliata. |
|
Recommended |
Contiene informazioni sugli errori per un'azione consigliata database SQL di Azure, Server o Elastic Pool. |
|
Recommended |
Contiene informazioni sull'impatto stimato o osservato su varie metriche per un'azione raccomandata database SQL di Azure, Server o Elastic Pool. |
|
Recommended |
Contiene informazioni per l'implementazione manuale di un'azione consigliata per database SQL di Azure, Server o Elastic Pool. |
|
Recommended |
Ottiene se l'approvazione per l'applicazione di questa azione consigliata è stata assegnata dall'utente/sistema. |
|
Recommended |
Contiene serie temporali di varie metriche impattate per un'azione consigliata database SQL di Azure, Server o Elastic Pool. |
|
Recommended |
Contiene informazioni sullo stato attuale per un'azione consigliata database SQL di Azure, Server o Elastic Pool. |
|
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
Advisor
Database, Server o Advisor pool elastico.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string (arm-id) |
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| kind |
string |
Tipo di risorsa. |
| location |
string |
Percorso della risorsa. |
| name |
string |
Nome della risorsa |
| properties.advisorStatus |
Ottiene lo stato della disponibilità di questo advisor per i clienti. I valori possibili sono 'GA', 'PublicPreview', 'LimitedPublicPreview' e 'PrivatePreview'. |
|
| properties.autoExecuteStatus |
Ottiene lo stato di esecuzione automatica (se consentire al sistema di eseguire le raccomandazioni) di questo advisor. I valori possibili sono 'Enabled' e 'Disabled' |
|
| properties.autoExecuteStatusInheritedFrom |
Ottiene la risorsa da cui viene ereditato il valore corrente dello stato di esecuzione automatica. Lo stato di esecuzione automatica può essere impostato su (e ereditato da) livelli diversi nella gerarchia delle risorse. I valori possibili sono 'Subscription', 'Server', 'ElasticPool', 'Database' e 'Default' (quando lo stato non è impostato in modo esplicito su alcun livello). |
|
| properties.lastChecked |
string (date-time) |
Ottiene l'ora in cui la risorsa corrente è stata analizzata per ottenere raccomandazioni da questo advisor. |
| properties.recommendationsStatus |
string |
Ottiene lo stato delle raccomandazioni per questo advisor e il motivo per cui non sono presenti raccomandazioni. I valori possibili includono, ma non sono limitati a, "Ok" (raccomandazioni disponibili), LowActivity (carico di lavoro insufficiente da analizzare), "DbSeemsTuned" (il database funziona bene) e così via. |
| properties.recommendedActions |
Ottiene le azioni consigliate per questo advisor. |
|
| systemData |
Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy. |
|
| type |
string |
Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts" |
AdvisorStatus
Ottiene lo stato della disponibilità di questo advisor per i clienti. I valori possibili sono 'GA', 'PublicPreview', 'LimitedPublicPreview' e 'PrivatePreview'.
| Valore | Descrizione |
|---|---|
| GA |
GA |
| PublicPreview |
PublicPreview |
| LimitedPublicPreview |
LimitedPublicPreview |
| PrivatePreview |
PrivatePreview |
AutoExecuteStatus
Ottiene lo stato di esecuzione automatica (se consentire al sistema di eseguire le raccomandazioni) di questo advisor. I valori possibili sono 'Enabled' e 'Disabled'
| Valore | Descrizione |
|---|---|
| Enabled |
Enabled |
| Disabled |
Disattivato |
| Default |
Valore predefinito |
AutoExecuteStatusInheritedFrom
Ottiene la risorsa da cui viene ereditato il valore corrente dello stato di esecuzione automatica. Lo stato di esecuzione automatica può essere impostato su (e ereditato da) livelli diversi nella gerarchia delle risorse. I valori possibili sono 'Subscription', 'Server', 'ElasticPool', 'Database' e 'Default' (quando lo stato non è impostato in modo esplicito su alcun livello).
| Valore | Descrizione |
|---|---|
| Default |
Valore predefinito |
| Subscription |
Abbonamento |
| Server |
Servidor |
| ElasticPool |
Piscina elastica |
| Database |
Banca dati |
createdByType
Tipo di identità che ha creato la risorsa.
| Valore | Descrizione |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| info |
object |
Informazioni aggiuntive. |
| type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
| Nome | Tipo | Descrizione |
|---|---|---|
| additionalInfo |
Informazioni aggiuntive sull'errore. |
|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore. |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
ImplementationMethod
Ottiene il metodo in cui questa azione consigliata può essere implementata manualmente. ad esempio TSql, AzurePowerShell.
| Valore | Descrizione |
|---|---|
| TSql |
TSql |
| AzurePowerShell |
AzurePowerShell |
IsRetryable
Ottiene un valore che indica se l'errore può essere ignorato e l'azione consigliata può essere ritentata. I valori possibili sono: Sì/No
| Valore | Descrizione |
|---|---|
| Yes |
Sì |
| No |
No |
RecommendedAction
Azione consigliata per database, server o pool elastico.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string (arm-id) |
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| kind |
string |
Tipo di risorsa. |
| location |
string |
Percorso della risorsa. |
| name |
string |
Nome della risorsa |
| properties.details |
object |
Ottiene dettagli aggiuntivi specifici di questa azione consigliata. |
| properties.errorDetails |
Ottiene i dettagli dell'errore se e perché questa azione consigliata viene inserita nello stato di errore. |
|
| properties.estimatedImpact |
Ottiene le informazioni sull'impatto stimato per questa azione consigliata, ad esempio il guadagno stimato della CPU, la modifica dello spazio su disco stimato |
|
| properties.executeActionDuration |
string (duration) |
Ottiene il tempo impiegato per applicare questa azione consigliata alla risorsa utente. ad esempio, tempo impiegato per la creazione dell'indice |
| properties.executeActionInitiatedBy |
Ottiene se l'approvazione per l'applicazione di questa azione consigliata è stata assegnata dall'utente/sistema. |
|
| properties.executeActionInitiatedTime |
string (date-time) |
Ottiene l'ora in cui questa azione consigliata è stata approvata per l'esecuzione. |
| properties.executeActionStartTime |
string (date-time) |
Ottiene l'ora in cui il sistema ha iniziato ad applicare questa azione consigliata alla risorsa utente. ad esempio, ora di inizio della creazione dell'indice |
| properties.implementationDetails |
Ottiene i dettagli di implementazione di questa azione consigliata per l'applicazione manuale da parte dell'utente. |
|
| properties.isArchivedAction |
boolean |
Ottiene se questa azione consigliata è stata suggerita qualche tempo fa, ma l'utente ha scelto di ignorare questo e il sistema ha aggiunto di nuovo una nuova azione consigliata. |
| properties.isExecutableAction |
boolean |
Ottiene se questa azione consigliata può essere eseguita dall'utente |
| properties.isRevertableAction |
boolean |
Ottiene se le modifiche applicate da questa azione consigliata possono essere ripristinate dall'utente |
| properties.lastRefresh |
string (date-time) |
Ottiene l'ora dell'ultimo aggiornamento dell'azione consigliata. |
| properties.linkedObjects |
string[] |
Ottiene gli oggetti collegati, se presenti. |
| properties.observedImpact |
Ottiene le informazioni sull'impatto osservato/effettivo per questa azione consigliata, ad esempio il guadagno effettivo della CPU, la modifica dello spazio su disco effettivo |
|
| properties.recommendationReason |
string |
Ottiene il motivo della raccomandazione di questa azione. ad esempio DuplicateIndex |
| properties.revertActionDuration |
string (duration) |
Ottiene il tempo impiegato per ripristinare le modifiche di questa azione consigliata sulla risorsa utente. Ad esempio, tempo impiegato per eliminare l'indice creato. |
| properties.revertActionInitiatedBy |
Ottiene se l'approvazione per il ripristino di questa azione consigliata è stata assegnata dall'utente/sistema. |
|
| properties.revertActionInitiatedTime |
string (date-time) |
Ottiene l'ora in cui questa azione consigliata è stata approvata per il ripristino. |
| properties.revertActionStartTime |
string (date-time) |
Ottiene l'ora in cui il sistema ha iniziato a ripristinare le modifiche di questa azione consigliata sulla risorsa utente. ad esempio l'ora in cui viene eseguita l'eliminazione dell'indice. |
| properties.score |
integer (int32) |
Ottiene l'impatto di questa azione consigliata. I valori possibili sono 1 - Impatto basso, 2 - Impatto medio e 3 - Impatto elevato |
| properties.state |
Ottiene le informazioni dello stato corrente in cui si trova l'azione consigliata. |
|
| properties.timeSeries |
Ottiene le informazioni sulle serie temporali delle metriche per questa azione consigliata, ad esempio le serie temporali di utilizzo della CPU |
|
| properties.validSince |
string (date-time) |
Ottiene l'ora da quando questa azione consigliata è valida. |
| systemData |
Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy. |
|
| type |
string |
Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts" |
RecommendedActionCurrentState
Stato corrente in cui si trova l'azione consigliata. Alcuni stati di uso comune sono: Attivo ->'azione consigliata è attiva e non è stata ancora eseguita alcuna azione. In sospeso:>'azione consigliata viene approvata per ed è in attesa di esecuzione. Esecuzione:>'azione consigliata viene applicata al database utente. Verifica:>'azione consigliata è stata applicata e ne viene verificata l'utilità dal sistema. Esito positivo:>'azione consigliata è stata applicata e il miglioramento rilevati durante la verifica. Ripristino in sospeso:> verifica ha trovato poco o nessun miglioramento, quindi l'azione consigliata viene accodata per il ripristino o l'utente ha ripristinato manualmente. Ripristino:> modifiche apportate durante l'applicazione dell'azione consigliata vengono ripristinate nel database utente. Ripristino:> ripristinato correttamente le modifiche apportate dall'azione consigliata nel database utente. Ignorato:>'utente ha ignorato/ignorato in modo esplicito l'azione consigliata.
| Valore | Descrizione |
|---|---|
| Active |
Active |
| Pending |
In sospeso |
| Executing |
Esecuzione |
| Verifying |
Verifica |
| PendingRevert |
PendingRevert |
| RevertCancelled |
RevertCancelled |
| Reverting |
Ritorno |
| Reverted |
Ritorno |
| Ignored |
Ignorato |
| Expired |
Scaduto |
| Monitoring |
Monitoraggio |
| Resolved |
Risolto |
| Success |
Success |
| Error |
Error |
RecommendedActionErrorInfo
Contiene informazioni sugli errori per un'azione consigliata database SQL di Azure, Server o Elastic Pool.
| Nome | Tipo | Descrizione |
|---|---|---|
| errorCode |
string |
Ottiene il motivo per cui l'azione consigliata è stata inserita nello stato di errore. ad esempio DatabaseHasQdsOff, IndexAlreadyExists |
| isRetryable |
Ottiene un valore che indica se l'errore può essere ignorato e l'azione consigliata può essere ritentata. I valori possibili sono: Sì/No |
RecommendedActionImpactRecord
Contiene informazioni sull'impatto stimato o osservato su varie metriche per un'azione raccomandata database SQL di Azure, Server o Elastic Pool.
| Nome | Tipo | Descrizione |
|---|---|---|
| absoluteValue |
number (double) |
Ottiene il valore assoluto di questa dimensione, se applicabile. Ad esempio, numero di query interessate |
| changeValueAbsolute |
number (double) |
Ottiene la modifica assoluta nel valore di questa dimensione. ad esempio, modifica dello spazio su disco assoluto in megabyte |
| changeValueRelative |
number (double) |
Ottiene la modifica relativa nel valore di questa dimensione. Ad esempio, variazione dello spazio relativo su disco in Percentuale |
| dimensionName |
string |
Ottiene il nome della dimensione di impatto. ad esempio CPUChange, DiskSpaceChange, NumberOfQueriesAffected. |
| unit |
string |
Ottiene il nome della dimensione di impatto. ad esempio CPUChange, DiskSpaceChange, NumberOfQueriesAffected. |
RecommendedActionImplementationInfo
Contiene informazioni per l'implementazione manuale di un'azione consigliata per database SQL di Azure, Server o Elastic Pool.
| Nome | Tipo | Descrizione |
|---|---|---|
| method |
Ottiene il metodo in cui questa azione consigliata può essere implementata manualmente. ad esempio TSql, AzurePowerShell. |
|
| script |
string |
Ottiene lo script di implementazione manuale. Ad esempio, lo script T-SQL che può essere eseguito nel database. |
RecommendedActionInitiatedBy
Ottiene se l'approvazione per l'applicazione di questa azione consigliata è stata assegnata dall'utente/sistema.
| Valore | Descrizione |
|---|---|
| User |
User |
| System |
System |
RecommendedActionMetricInfo
Contiene serie temporali di varie metriche impattate per un'azione consigliata database SQL di Azure, Server o Elastic Pool.
| Nome | Tipo | Descrizione |
|---|---|---|
| metricName |
string |
Ottiene il nome della metrica. ad esempio CPU, Numero di query. |
| startTime |
string (date-time) |
Ottiene l'ora di inizio dell'intervallo di tempo specificato da metricinfo. |
| timeGrain |
string |
Ottiene la durata dell'intervallo di tempo per il valore specificato da metricinfo. ad esempio PT1H (1 ora) |
| unit |
string |
Ottiene l'unità in cui viene misurata la metrica. ad esempio DTU, Frequenza |
| value |
number (double) |
Ottiene il valore della metrica nell'intervallo di tempo specificato da metricinfo. |
RecommendedActionStateInfo
Contiene informazioni sullo stato attuale per un'azione consigliata database SQL di Azure, Server o Elastic Pool.
| Nome | Tipo | Descrizione |
|---|---|---|
| actionInitiatedBy |
Ottiene chi ha avviato l'esecuzione di questa azione consigliata. Il valore possibile è: User -> When user explicity notified system to apply the recommended action ( Utente -> Quando l'utente riceve una notifica esplicita per applicare l'azione consigliata. Sistema :> Quando lo stato di esecuzione automatica di questo advisor è stato impostato su "Abilitato", nel qual caso il sistema lo ha applicato. |
|
| currentValue |
Stato corrente in cui si trova l'azione consigliata. Alcuni stati di uso comune sono: Attivo ->'azione consigliata è attiva e non è stata ancora eseguita alcuna azione. In sospeso:>'azione consigliata viene approvata per ed è in attesa di esecuzione. Esecuzione:>'azione consigliata viene applicata al database utente. Verifica:>'azione consigliata è stata applicata e ne viene verificata l'utilità dal sistema. Esito positivo:>'azione consigliata è stata applicata e il miglioramento rilevati durante la verifica. Ripristino in sospeso:> verifica ha trovato poco o nessun miglioramento, quindi l'azione consigliata viene accodata per il ripristino o l'utente ha ripristinato manualmente. Ripristino:> modifiche apportate durante l'applicazione dell'azione consigliata vengono ripristinate nel database utente. Ripristino:> ripristinato correttamente le modifiche apportate dall'azione consigliata nel database utente. Ignorato:>'utente ha ignorato/ignorato in modo esplicito l'azione consigliata. |
|
| lastModified |
string (date-time) |
Ottiene l'ora dell'ultima modifica dello stato |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| createdAt |
string (date-time) |
Timestamp della creazione della risorsa (UTC). |
| createdBy |
string |
Identità che ha creato la risorsa. |
| createdByType |
Tipo di identità che ha creato la risorsa. |
|
| lastModifiedAt |
string (date-time) |
Il timestamp dell'ultima modifica della risorsa (UTC) |
| lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
| lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |