Maintenance Window Options - Get

Obtém uma lista das janelas de manutenção disponíveis.

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}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
databaseName
path True

string

O nome do banco de dados.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser uma UUID.

api-version
query True

string

minLength: 1

A versão da API a ser usada para esta operação.

maintenanceWindowOptionsName
query True

string

Nome das opções da janela de manutenção.

Respostas

Nome Tipo Description
200 OK

MaintenanceWindowOptions

Operação do Azure concluída com sucesso.

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

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

Solicitação de exemplo

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

Resposta de exemplo

{
  "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
  }
}

Definições

Nome Description
createdByType

O tipo de identidade que criou o recurso.

DayOfWeek

Dia da janela de manutenção.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

MaintenanceWindowOptions

Opções de janela de manutenção.

MaintenanceWindowTimeRange

Intervalo de tempo da janela de manutenção.

systemData

Metadados relativos à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

DayOfWeek

Dia da janela de manutenção.

Valor Description
Sunday

Domingo

Monday

Segunda-feira

Tuesday

Terça-feira

Wednesday

Quarta-feira

Thursday

Quinta-feira

Friday

Sexta-feira

Saturday

sábado

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

MaintenanceWindowOptions

Opções de janela de manutenção.

Nome Tipo Description
id

string (arm-id)

ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

O nome do recurso

properties.allowMultipleMaintenanceWindowsPerCycle

boolean

Se permitimos várias janelas de manutenção por ciclo.

properties.defaultDurationInMinutes

integer (int32)

Duração padrão da janela de manutenção.

properties.isEnabled

boolean

Se as janelas de manutenção estão habilitadas para o banco de dados.

properties.maintenanceWindowCycles

MaintenanceWindowTimeRange[]

Ciclos de manutenção disponíveis, por exemplo, {Sábado, 0, 4860}, {Quarta-feira, 0, 2460}.

properties.minCycles

integer (int32)

Número mínimo de ciclos de janelas de manutenção a serem definidos no banco de dados.

properties.minDurationInMinutes

integer (int32)

Duração mínima da janela de manutenção.

properties.timeGranularityInMinutes

integer (int32)

Granularidade de tempo em minutos para janelas de manutenção.

systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.

type

string

O tipo do recurso. Por exemplo, "Microsoft. Compute/virtualMachines" ou "Microsoft. ContasArmazenamento/Armazenamento"

MaintenanceWindowTimeRange

Intervalo de tempo da janela de manutenção.

Nome Tipo Description
dayOfWeek

DayOfWeek

Dia da janela de manutenção.

duration

string

Duração da janela de manutenção em minutos.

startTime

string

Deslocamento de minutos de hora de início a partir das 12h.

systemData

Metadados relativos à criação e última modificação do recurso.

Nome Tipo Description
createdAt

string (date-time)

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string (date-time)

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.