Azure Database for MySQL

Azure Database for MySQL Flexible Servers API

Create and manage MySQL Flexible Servers, including SKU, storage, networking, high availability mode, maintenance windows, and identity. Flexible Server provides granular control and zone redundant high availability for production workloads.

GitHub OpenAPI

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/rest/api/mysql/flexibleserver/servers
📖
Authentication
https://learn.microsoft.com/en-us/azure/active-directory/develop/v2-oauth2-auth-code-flow
📖
GettingStarted
https://learn.microsoft.com/en-us/azure/mysql/flexible-server/quickstart-create-server-portal

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-mysql/refs/heads/main/openapi/microsoft-azure-mysql-openapi.yml

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-mysql/refs/heads/main/capabilities/microsoft-azure-mysql-operations.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/microsoft-azure-mysql/refs/heads/main/capabilities/microsoft-azure-mysql-servers.yaml

OpenAPI Specification

microsoft-azure-mysql-openapi.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Azure Database for MySQL REST API
  description: Azure Database for MySQL is a fully managed, scalable MySQL database service. The REST
    API manages flexible servers, databases, firewall rules, configurations, and backups.
  version: '2024-01-01'
externalDocs:
  description: Azure Database for MySQL REST API Documentation
  url: https://learn.microsoft.com/en-us/rest/api/mysql/flexibleserver/servers
servers:
- url: https://management.azure.com
  description: Azure Resource Manager
tags:
- name: Servers
  description: Servers operations
- name: Databases
  description: Databases operations
- name: Firewall Rules
  description: Firewall Rules operations
- name: Configurations
  description: Configurations operations
- name: Operations
  description: Operations operations
security:
- azure_auth:
  - user_impersonation
paths:
  /providers/Microsoft.DBforMySQL/operations:
    get:
      operationId: listOperations
      summary: Azure Database for MySQL REST API List operations
      description: Lists all available REST API operations for Microsoft.DBforMySQL.
      tags:
      - Operations
      parameters:
      - $ref: '#/components/parameters/apiVersion'
      responses:
        '200':
          description: Operations list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OperationList'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /subscriptions/{subscriptionId}/providers/Microsoft.DBforMySQL/flexibleServers:
    get:
      operationId: listFlexibleserversBySubscription
      summary: Azure Database for MySQL REST API List by subscription
      description: Lists all flexibleServers resources within the specified subscription.
      tags:
      - Servers
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/apiVersion'
      responses:
        '200':
          description: Resource list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceList'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/flexibleServers:
    get:
      operationId: listFlexibleserversByResourceGroup
      summary: Azure Database for MySQL REST API List by resource group
      description: Lists all flexibleServers resources within the specified resource group.
      tags:
      - Servers
      parameters:
      - $ref: '#/components/parameters/subscriptionId'
      - $ref: '#/components/parameters/resourceGroupName'
      - $ref: '#/components/parameters/apiVersion'
      responses:
        '200':
          description: Resource list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceList'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
  /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/flexibleServers/{name}:
    parameters:
    - $ref: '#/components/parameters/subscriptionId'
    - $ref: '#/components/parameters/resourceGroupName'
    - name: name
      in: path
      required: true
      description: Name of the resource.
      schema:
        type: string
    - $ref: '#/components/parameters/apiVersion'
    get:
      operationId: getFlexibleservers
      summary: Azure Database for MySQL REST API Get resource
      description: Gets a specific flexibleServers resource.
      tags:
      - Servers
      responses:
        '200':
          description: Resource
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Resource'
        '404':
          description: Not found
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    put:
      operationId: createOrUpdateFlexibleservers
      summary: Azure Database for MySQL REST API Create or update resource
      description: Creates or updates a flexibleServers resource.
      tags:
      - Servers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Resource'
      responses:
        '200':
          description: Resource updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Resource'
        '201':
          description: Resource created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Resource'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    patch:
      operationId: updateFlexibleservers
      summary: Azure Database for MySQL REST API Update resource
      description: Updates a flexibleServers resource.
      tags:
      - Servers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        '200':
          description: Resource updated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Resource'
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
    delete:
      operationId: deleteFlexibleservers
      summary: Azure Database for MySQL REST API Delete resource
      description: Deletes a flexibleServers resource.
      tags:
      - Servers
      responses:
        '200':
          description: Resource deleted
        '202':
          description: Deletion accepted
        '204':
          description: Resource not found or already deleted
        default:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  parameters:
    subscriptionId:
      name: subscriptionId
      in: path
      required: true
      description: The ID of the target subscription.
      schema:
        type: string
    resourceGroupName:
      name: resourceGroupName
      in: path
      required: true
      description: The name of the resource group.
      schema:
        type: string
    apiVersion:
      name: api-version
      in: query
      required: true
      description: The API version to use for this operation.
      schema:
        type: string
  schemas:
    Resource:
      type: object
      properties:
        id:
          type: string
          description: Resource ID.
        name:
          type: string
          description: Resource name.
        type:
          type: string
          description: Resource type.
        location:
          type: string
          description: Resource location.
        tags:
          type: object
          additionalProperties:
            type: string
        properties:
          type: object
          description: Resource-specific properties.
    ResourceList:
      type: object
      properties:
        value:
          type: array
          items:
            $ref: '#/components/schemas/Resource'
        nextLink:
          type: string
          description: URL to the next page of results.
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            target:
              type: string
    Operation:
      type: object
      properties:
        name:
          type: string
        display:
          type: object
          properties:
            provider:
              type: string
            resource:
              type: string
            operation:
              type: string
            description:
              type: string
        isDataAction:
          type: boolean
    OperationList:
      type: object
      properties:
        value:
          type: array
          items:
            $ref: '#/components/schemas/Operation'
        nextLink:
          type: string
  securitySchemes:
    azure_auth:
      type: oauth2
      description: Azure Active Directory OAuth2 Flow.
      flows:
        implicit:
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
          scopes:
            user_impersonation: Impersonate your user account
x-generated-from: https://learn.microsoft.com/en-us/rest/api/mysql/flexibleserver/servers
x-generated-by: claude-crawl-2026-05-08