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
advisorName
path True

string

Nome di Server Advisor.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.

serverName
path True

string

Il nome del server.

subscriptionId
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

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'

Risposte

Nome Tipo Descrizione
200 OK

Advisor

Operazione Azure completata con successo.

Other Status Codes

ErrorResponse

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.

AdvisorStatus

Ottiene lo stato della disponibilità di questo advisor per i clienti. I valori possibili sono 'GA', 'PublicPreview', 'LimitedPublicPreview' e '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'

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).

createdByType

Tipo di identità che ha creato la risorsa.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

ImplementationMethod

Ottiene il metodo in cui questa azione consigliata può essere implementata manualmente. ad esempio TSql, 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

RecommendedAction

Azione consigliata per database, server o pool elastico.

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.

RecommendedActionErrorInfo

Contiene informazioni sugli errori per un'azione consigliata database SQL di Azure, Server o Elastic Pool.

RecommendedActionImpactRecord

Contiene informazioni sull'impatto stimato o osservato su varie metriche per un'azione raccomandata database SQL di Azure, Server o Elastic Pool.

RecommendedActionImplementationInfo

Contiene informazioni per l'implementazione manuale di un'azione consigliata per database SQL di Azure, Server o Elastic Pool.

RecommendedActionInitiatedBy

Ottiene se l'approvazione per l'applicazione di questa azione consigliata è stata assegnata dall'utente/sistema.

RecommendedActionMetricInfo

Contiene serie temporali di varie metriche impattate per un'azione consigliata database SQL di Azure, Server o Elastic Pool.

RecommendedActionStateInfo

Contiene informazioni sullo stato attuale per un'azione consigliata database SQL di Azure, Server o Elastic Pool.

systemData

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

AdvisorStatus

Ottiene lo stato della disponibilità di questo advisor per i clienti. I valori possibili sono 'GA', 'PublicPreview', 'LimitedPublicPreview' e 'PrivatePreview'.

properties.autoExecuteStatus

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

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

RecommendedAction[]

Ottiene le azioni consigliate per questo advisor.

systemData

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

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

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

RecommendedActionErrorInfo

Ottiene i dettagli dell'errore se e perché questa azione consigliata viene inserita nello stato di errore.

properties.estimatedImpact

RecommendedActionImpactRecord[]

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

RecommendedActionInitiatedBy

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

RecommendedActionImplementationInfo

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

RecommendedActionImpactRecord[]

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

RecommendedActionInitiatedBy

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

RecommendedActionStateInfo

Ottiene le informazioni dello stato corrente in cui si trova l'azione consigliata.

properties.timeSeries

RecommendedActionMetricInfo[]

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

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

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

ImplementationMethod

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

RecommendedActionInitiatedBy

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

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.

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

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

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.