Maintenance Window Options - Get

Serviço:

SQL Database

Versão da API:

2023-08-01

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?maintenanceWindowOptionsName={maintenanceWindowOptionsName}&api-version=2023-08-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
databaseName	path	True	string	O nome do banco de dados para o qual obter opções de janelas de manutenção.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor na API do Azure Resource Manager ou no portal.
serverName	path	True	string	O nome do servidor.
subscriptionId	path	True	string	A ID da assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.
maintenanceWindowOptionsName	query	True	string	Nome das opções da janela de manutenção.

Respostas

Nome	Tipo	Description
200 OK	MaintenanceWindowOptions	Recuperou com êxito a lista de opções de janelas de manutenção.
Other Status Codes	ErrorResponse	Respostas de erro: ***

Exemplos

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

Solicitação de exemplo

HTTP

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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/GetMaintenanceWindowOptions.json
// this example is just showing the usage of "MaintenanceWindowOptions_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this MaintenanceWindowOptionResource created on azure
// for more information of creating MaintenanceWindowOptionResource, please refer to the document of MaintenanceWindowOptionResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default-SQL-SouthEastAsia";
string serverName = "testsvr";
string databaseName = "testdb";
ResourceIdentifier maintenanceWindowOptionResourceId = MaintenanceWindowOptionResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, databaseName);
MaintenanceWindowOptionResource maintenanceWindowOption = client.GetMaintenanceWindowOptionResource(maintenanceWindowOptionResourceId);

// invoke the operation
string maintenanceWindowOptionsName = "current";
MaintenanceWindowOptionResource result = await maintenanceWindowOption.GetAsync(maintenanceWindowOptionsName);

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
MaintenanceWindowOptionData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta de exemplo

Código de status:

200

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

Definições

Nome	Description
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.

DayOfWeek

Enumeração

Dia da janela de manutenção.

Valor	Description
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

ErrorAdditionalInfo

Objeto

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

Objeto

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

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

MaintenanceWindowOptions

Objeto

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

Nome	Tipo	Description
id	string	ID do recurso.
name	string	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.
type	string	Tipo de recurso.

MaintenanceWindowTimeRange

Objeto

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.