Azure SQL Database Maintenance Windows API

openapi: 3.2.0
info:
  title: SqlManagementClient Maintenance Windows API
  version: '2025-01-01'
  description: The Azure SQL Database management API provides a RESTful set of web APIs that interact with Azure SQL Database services to manage your databases. The API enables users to create, retrieve, update, and delete databases, servers, and other entities.
  x-typespec-generated:
  - emitter: '@azure-tools/typespec-autorest'
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: Maintenance Windows
paths:
  ? /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/maintenanceWindows/current
  : get:
      operationId: MaintenanceWindows_Get
      tags:
      - Maintenance Windows
      description: Gets maintenance windows settings for a database.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: serverName
        in: path
        description: The name of the server.
        required: true
        schema:
          type: string
      - name: databaseName
        in: path
        description: The name of the database.
        required: true
        schema:
          type: string
      - name: maintenanceWindowName
        in: query
        description: Maintenance window name.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MaintenanceWindows'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Maintenance windows get
      x-summary-source: derived
    put:
      operationId: MaintenanceWindows_CreateOrUpdate
      tags:
      - Maintenance Windows
      description: Sets maintenance windows settings for a database.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - $ref: '#/components/parameters/ResourceGroupNameParameter'
      - name: serverName
        in: path
        description: The name of the server.
        required: true
        schema:
          type: string
      - name: databaseName
        in: path
        description: The name of the database.
        required: true
        schema:
          type: string
      - name: maintenanceWindowName
        in: query
        description: Maintenance window name.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The request has succeeded.
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MaintenanceWindows'
        required: true
      summary: Maintenance windows create or update
      x-summary-source: derived
components:
  schemas:
    MaintenanceWindows:
      type: object
      description: Maintenance windows.
      properties:
        properties:
          $ref: '#/components/schemas/MaintenanceWindowsProperties'
          description: Resource properties.
          x-ms-client-flatten: true
      allOf:
      - $ref: '#/components/schemas/ProxyResource'
    ProxyResource:
      type: object
      title: Proxy Resource
      description: The resource model definition for a Azure Resource Manager proxy resource. It will not have tags and a location
      allOf:
      - $ref: '#/components/schemas/Resource'
    ErrorResponse:
      type: object
      title: Error response
      description: Common error response for all Azure Resource Manager APIs to return error details for failed operations. (This also follows the OData error response format.).
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
          description: The error object.
    MaintenanceWindowsProperties:
      type: object
      description: Maintenance windows resource properties.
      properties:
        timeRanges:
          type: array
          items:
            $ref: '#/components/schemas/MaintenanceWindowTimeRange'
    MaintenanceWindowTimeRange:
      type: object
      description: Maintenance window time range.
      properties:
        dayOfWeek:
          $ref: '#/components/schemas/DayOfWeek'
          description: Day of maintenance window.
        startTime:
          type: string
          description: Start time minutes offset from 12am.
        duration:
          type: string
          description: Duration of maintenance window in minutes.
  parameters:
    ResourceGroupNameParameter:
      name: resourceGroupName
      in: path
      description: The name of the resource group. The name is case insensitive.
      required: true
      x-ms-parameter-location: method
      schema:
        type: string
        maxLength: 90
        minLength: 1
    SubscriptionIdParameter:
      name: subscriptionId
      in: path
      description: The ID of the target subscription. The value must be an UUID.
      required: true
      schema:
        type: string
        format: uuid
    ApiVersionParameter:
      name: api-version
      in: query
      description: The API version to use for this operation.
      required: true
      schema:
        type: string
        minLength: 1
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          scopes:
            user_impersonation: impersonate your user account
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: Azure Active Directory OAuth2 Flow.