Maintenance Windows - Get

Obtiene la configuración de ventanas de mantenimiento de una base de datos.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
databaseName
path True

string

El nombre de la base de datos.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

serverName
path True

string

El nombre del servidor.

subscriptionId
path True

string (uuid)

Identificador de la suscripción de destino. El valor debe ser un UUID.

api-version
query True

string

minLength: 1

Versión de API que se usará para esta operación.

maintenanceWindowName
query True

string

Nombre de la ventana de mantenimiento.

Respuestas

Nombre Tipo Description
200 OK

MaintenanceWindows

Operación de Azure completada con éxito.

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar la cuenta de usuario

Ejemplos

Gets maintenance window settings for a selected database.

Solicitud de ejemplo

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

Respuesta de muestra

{
  "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/maintenancewindows/current",
  "properties": {
    "timeRanges": [
      {
        "dayOfWeek": "Saturday",
        "duration": "PT60M",
        "startTime": "00:00:00"
      }
    ]
  }
}

Definiciones

Nombre Description
createdByType

Tipo de identidad que creó el recurso.

DayOfWeek

Día de la ventana de mantenimiento.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

MaintenanceWindows

Ventanas de mantenimiento.

MaintenanceWindowTimeRange

Intervalo de tiempo de ventana de mantenimiento.

systemData

Metadatos relativos a la creación y última modificación del recurso.

createdByType

Tipo de identidad que creó el recurso.

Valor Description
User
Application
ManagedIdentity
Key

DayOfWeek

Día de la ventana de mantenimiento.

Valor Description
Sunday

Domingo

Monday

Lunes

Tuesday

Martes

Wednesday

Miércoles

Thursday

Jueves

Friday

Viernes

Saturday

Sábado

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

MaintenanceWindows

Ventanas de mantenimiento.

Nombre Tipo Description
id

string (arm-id)

Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nombre del recurso

properties.timeRanges

MaintenanceWindowTimeRange[]

Intervalo de tiempo de ventana de mantenimiento.

systemData

systemData

Azure Resource Manager metadatos que contienen información createdBy y modifiedBy.

type

string

Tipo de recurso. Por ejemplo, "Microsoft. Compute/virtualMachines" o "Microsoft. CuentasAlmacenamiento/Almacenamiento"

MaintenanceWindowTimeRange

Intervalo de tiempo de ventana de mantenimiento.

Nombre Tipo Description
dayOfWeek

DayOfWeek

Día de la ventana de mantenimiento.

duration

string

Duración del período de mantenimiento en minutos.

startTime

string

Desplazamiento de minutos de hora de inicio de 12 a. m.

systemData

Metadatos relativos a la creación y última modificación del recurso.

Nombre Tipo Description
createdAt

string (date-time)

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string (date-time)

La marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.