Maintenance Window Options - Get

Ottiene un elenco delle finestre di manutenzione disponibili.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/maintenanceWindowOptions/current?api-version=2025-01-01&maintenanceWindowOptionsName={maintenanceWindowOptionsName}

Parametri dell'URI

Nome In Necessario Tipo Descrizione
databaseName
path True

string

Nome del database.

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.

maintenanceWindowOptionsName
query True

string

Nome delle opzioni della finestra di manutenzione.

Risposte

Nome Tipo Descrizione
200 OK

MaintenanceWindowOptions

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

Gets a list of available maintenance windows for a selected database.

Esempio di richiesta

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/maintenanceWindowOptions/current?api-version=2025-01-01&maintenanceWindowOptionsName=current

Risposta di esempio

{
  "name": "current",
  "type": "Microsoft.Sql/servers/databases/maintenancewindows",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/maintenancewindowoptions/current",
  "properties": {
    "allowMultipleMaintenanceWindowsPerCycle": true,
    "defaultDurationInMinutes": 120,
    "isEnabled": true,
    "maintenanceWindowCycles": [
      {
        "dayOfWeek": "Saturday",
        "duration": "PT60M",
        "startTime": "00:00:00"
      }
    ],
    "minCycles": 2,
    "minDurationInMinutes": 60,
    "timeGranularityInMinutes": 5
  }
}

Definizioni

Nome Descrizione
createdByType

Tipo di identità che ha creato la risorsa.

DayOfWeek

Giorno della finestra di manutenzione.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

MaintenanceWindowOptions

Opzioni della finestra di manutenzione.

MaintenanceWindowTimeRange

Intervallo di tempo della finestra di manutenzione.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

Valore Descrizione
User
Application
ManagedIdentity
Key

DayOfWeek

Giorno della finestra di manutenzione.

Valore Descrizione
Sunday

Domenica

Monday

Lunedì

Tuesday

Martedì

Wednesday

Mercoledì

Thursday

Giovedì

Friday

Venerdì

Saturday

Sabato

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.

MaintenanceWindowOptions

Opzioni della finestra di manutenzione.

Nome Tipo Descrizione
id

string (arm-id)

ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nome della risorsa

properties.allowMultipleMaintenanceWindowsPerCycle

boolean

Indica se sono consentite più finestre di manutenzione per ciclo.

properties.defaultDurationInMinutes

integer (int32)

Durata predefinita per la finestra di manutenzione.

properties.isEnabled

boolean

Indica se le finestre di manutenzione sono abilitate per il database.

properties.maintenanceWindowCycles

MaintenanceWindowTimeRange[]

Cicli di manutenzione disponibili, ad esempio {sabato, 0, 4860}, {mercoledì, 0, 2460}.

properties.minCycles

integer (int32)

Numero minimo di cicli di finestre di manutenzione da impostare nel database.

properties.minDurationInMinutes

integer (int32)

Durata minima della finestra di manutenzione.

properties.timeGranularityInMinutes

integer (int32)

Granularità del tempo in minuti per le finestre di manutenzione.

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"

MaintenanceWindowTimeRange

Intervallo di tempo della finestra di manutenzione.

Nome Tipo Descrizione
dayOfWeek

DayOfWeek

Giorno della finestra di manutenzione.

duration

string

Durata dell'intervallo di manutenzione in minuti.

startTime

string

Offset dei minuti di ora di inizio dalle 12:00.

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.