Share via


Servers - List

Listet alle Server in einem bestimmten Abonnement auf.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.DBforMySQL/flexibleServers?api-version=2023-12-30

URI-Parameter

Name In Erforderlich Typ Beschreibung
subscriptionId
path True

string

uuid

Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name Typ Beschreibung
200 OK

ServerListResult

OK

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

List servers in a subscription

Sample Request

GET https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforMySQL/flexibleServers?api-version=2023-12-30

Sample Response

{
  "value": [
    {
      "sku": {
        "name": "Standard_B1ms",
        "tier": "Burstable"
      },
      "properties": {
        "administratorLogin": "cloudsa",
        "storage": {
          "storageSizeGB": 23,
          "iops": 369,
          "autoGrow": "Enabled",
          "storageSku": "Premium_LRS"
        },
        "version": "5.7",
        "state": "Ready",
        "fullyQualifiedDomainName": "mysqltestserver1.database.mysql.azure.com",
        "availabilityZone": "1",
        "maintenanceWindow": {
          "customWindow": "Disabled",
          "dayOfWeek": 0,
          "startHour": 0,
          "startMinute": 0
        },
        "replicationRole": "None",
        "replicaCapacity": 10,
        "network": {
          "publicNetworkAccess": "Enabled"
        },
        "backup": {
          "backupRetentionDays": 7,
          "backupIntervalHours": 24,
          "geoRedundantBackup": "Disabled",
          "earliestRestoreDate": "2021-06-17T07:08:17.4259886+00:00"
        },
        "highAvailability": {
          "mode": "Disabled",
          "state": "NotEnabled"
        }
      },
      "location": "Southeast Asia",
      "tags": {
        "num": "1"
      },
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestserver1",
      "name": "mysqltestserver1",
      "type": "Microsoft.DBforMySQL/flexibleServers"
    },
    {
      "sku": {
        "name": "Standard_B1ms",
        "tier": "Burstable"
      },
      "properties": {
        "administratorLogin": "cloudsa",
        "storage": {
          "storageSizeGB": 23,
          "iops": 369,
          "autoGrow": "Enabled",
          "storageSku": "Premium_LRS"
        },
        "version": "5.7",
        "state": "Ready",
        "fullyQualifiedDomainName": "mysqltestserver2.mysql.database.azure.com",
        "availabilityZone": "2",
        "maintenanceWindow": {
          "customWindow": "Disabled",
          "dayOfWeek": 0,
          "startHour": 0,
          "startMinute": 0
        },
        "replicationRole": "None",
        "replicaCapacity": 10,
        "network": {
          "publicNetworkAccess": "Enabled"
        },
        "backup": {
          "backupRetentionDays": 7,
          "backupIntervalHours": 24,
          "geoRedundantBackup": "Disabled",
          "earliestRestoreDate": "2021-06-17T07:08:17.4259886+00:00"
        },
        "highAvailability": {
          "mode": "Disabled",
          "state": "NotEnabled"
        }
      },
      "location": "Southeast Asia",
      "tags": {
        "num": "1"
      },
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup2/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestserver2",
      "name": "mysqltestserver2",
      "type": "Microsoft.DBforMySQL/flexibleServers"
    },
    {
      "sku": {
        "name": "Standard_E2ds_v4",
        "tier": "MemoryOptimized"
      },
      "properties": {
        "administratorLogin": "cloudsa",
        "storage": {
          "storageSizeGB": 100,
          "iops": 600,
          "autoGrow": "Enabled",
          "storageSku": "Premium_LRS"
        },
        "version": "5.7",
        "state": "Ready",
        "fullyQualifiedDomainName": "mysqltestserver3.mysql.database.azure.com",
        "availabilityZone": "1",
        "maintenanceWindow": {
          "customWindow": "Disabled",
          "dayOfWeek": 0,
          "startHour": 0,
          "startMinute": 0
        },
        "replicationRole": "None",
        "replicaCapacity": 10,
        "network": {
          "publicNetworkAccess": "Enabled"
        },
        "backup": {
          "backupRetentionDays": 7,
          "backupIntervalHours": 24,
          "geoRedundantBackup": "Disabled",
          "earliestRestoreDate": "2021-06-24T06:28:19.0611667+00:00"
        },
        "highAvailability": {
          "mode": "Disabled",
          "state": "NotEnabled"
        }
      },
      "location": "Southeast Asia",
      "tags": {
        "num": "1"
      },
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup3/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestserver3",
      "name": "mysqltestserver3",
      "type": "Microsoft.DBforMySQL/flexibleServers"
    }
  ]
}

Definitionen

Name Beschreibung
Backup

Speicherprofileigenschaften eines Servers

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

CreateMode

Der Modus zum Erstellen eines neuen MySQL-Servers.

DataEncryption

Die Datumsverschlüsselung für cmk.

DataEncryptionType

Der Schlüsseltyp AzureKeyVault for enable cmk, SystemManaged for disable cmk.

EnableStatusEnum

Aufzählung, um anzugeben, ob der Wert "Aktiviert" oder "Deaktiviert" ist.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

HighAvailability

Hochverfügbarkeitseigenschaften eines Servers

HighAvailabilityMode

Hochverfügbarkeitsmodus für einen Server.

HighAvailabilityState

Der Status der Hochverfügbarkeit des Servers.

ImportSourceProperties

Importieren quellbezogener Eigenschaften.

ImportSourceStorageType

Speichertyp der Importquelle.

MaintenanceWindow

Wartungsfenster eines Servers.

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität.

MySQLServerSku

Abrechnungsinformationen bezogene Eigenschaften eines Servers.

Network

Netzwerkbezogene Eigenschaften eines Servers

PrivateEndpoint

Die private Endpunktressource.

PrivateEndpointConnection

Die Verbindungsressource des privaten Endpunkts.

PrivateEndpointConnectionProvisioningState

Der aktuelle Bereitstellungsstatus.

PrivateEndpointServiceConnectionStatus

Die private Endpunktverbindung status.

PrivateLinkServiceConnectionState

Eine Sammlung von Informationen über den Status der Verbindung zwischen dem Dienst consumer und dem Anbieter.

ReplicationRole

Die Replikationsrolle.

Server

Stellt einen Server dar.

ServerListResult

Eine Liste von Servern.

ServerSkuTier

Die Ebene der jeweiligen SKU, z. B. GeneralPurpose.

ServerState

Der Status eines Servers.

ServerVersion

Die Version eines Servers.

Storage

Speicherprofileigenschaften eines Servers

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Backup

Speicherprofileigenschaften eines Servers

Name Typ Standardwert Beschreibung
backupIntervalHours

integer

Sicherungsintervall stunden für den Server.

backupRetentionDays

integer

Sicherungsaufbewahrungstage für den Server.

earliestRestoreDate

string

Erstellungszeit des frühesten Wiederherstellungspunkts (ISO8601 Format)

geoRedundantBackup

EnableStatusEnum

Disabled

Gibt an, ob georedundante Sicherung aktiviert ist.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

CreateMode

Der Modus zum Erstellen eines neuen MySQL-Servers.

Name Typ Beschreibung
Default

string

GeoRestore

string

PointInTimeRestore

string

Replica

string

DataEncryption

Die Datumsverschlüsselung für cmk.

Name Typ Beschreibung
geoBackupKeyURI

string

Geosicherungsschlüssel-URI als Schlüsseltresor kann nicht regionsübergreifend sein. Cmk muss sich in derselben Region wie die Geosicherung befinden.

geoBackupUserAssignedIdentityId

string

Ressourcen-ID der Benutzeridentität für die Geosicherung als Identität kann nicht regionsübergreifend sein, identität in derselben Region wie die Geosicherung erforderlich

primaryKeyURI

string

Primärschlüssel-URI

primaryUserAssignedIdentityId

string

Ressourcen-ID der primären Benutzeridentität

type

DataEncryptionType

Der Schlüsseltyp AzureKeyVault für enable cmk, SystemManaged for disable cmk.

DataEncryptionType

Der Schlüsseltyp AzureKeyVault for enable cmk, SystemManaged for disable cmk.

Name Typ Beschreibung
AzureKeyVault

string

SystemManaged

string

EnableStatusEnum

Aufzählung, um anzugeben, ob der Wert "Aktiviert" oder "Deaktiviert" ist.

Name Typ Beschreibung
Disabled

string

Enabled

string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.

type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

HighAvailability

Hochverfügbarkeitseigenschaften eines Servers

Name Typ Beschreibung
mode

HighAvailabilityMode

Hochverfügbarkeitsmodus für einen Server.

standbyAvailabilityZone

string

Verfügbarkeitszone des Standbyservers.

state

HighAvailabilityState

Der Status der Hochverfügbarkeit des Servers.

HighAvailabilityMode

Hochverfügbarkeitsmodus für einen Server.

Name Typ Beschreibung
Disabled

string

SameZone

string

ZoneRedundant

string

HighAvailabilityState

Der Status der Hochverfügbarkeit des Servers.

Name Typ Beschreibung
CreatingStandby

string

FailingOver

string

Healthy

string

NotEnabled

string

RemovingStandby

string

ImportSourceProperties

Importieren quellbezogener Eigenschaften.

Name Typ Beschreibung
dataDirPath

string

Relativer Pfad des Datenverzeichnisses im Speicher.

sasToken

string

Sas-Token für den Zugriff auf Den Quellspeicher. Lese- und Listenberechtigungen sind für sas-Token erforderlich.

storageType

ImportSourceStorageType

Speichertyp der Importquelle.

storageUrl

string

URI des Importquellspeichers.

ImportSourceStorageType

Speichertyp der Importquelle.

Name Typ Beschreibung
AzureBlob

string

MaintenanceWindow

Wartungsfenster eines Servers.

Name Typ Beschreibung
customWindow

string

gibt an, ob das benutzerdefinierte Fenster aktiviert oder deaktiviert ist.

dayOfWeek

integer

Wochentag für Wartungsfenster

startHour

integer

Startstunde für Wartungsfenster

startMinute

integer

Startminute für Wartungsfenster

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität.

Name Typ Beschreibung
UserAssigned

string

MySQLServerSku

Abrechnungsinformationen bezogene Eigenschaften eines Servers.

Name Typ Beschreibung
name

string

Der Name der SKU, z. B. Standard_D32s_v3.

tier

ServerSkuTier

Die Ebene der jeweiligen SKU, z. B. GeneralPurpose.

Network

Netzwerkbezogene Eigenschaften eines Servers

Name Typ Beschreibung
delegatedSubnetResourceId

string

Delegierte Subnetzressourcen-ID, die zum Einrichten des VNET für einen Server verwendet wird.

privateDnsZoneResourceId

string

Privates DNS Zonenressourcen-ID.

publicNetworkAccess

EnableStatusEnum

Gibt an, ob der Zugriff auf öffentliche Netzwerke für diesen Server zulässig ist. Der Wert ist "Disabled", wenn der Server über eine VNET-Integration verfügt.

PrivateEndpoint

Die private Endpunktressource.

Name Typ Beschreibung
id

string

Der ARM-Bezeichner für den privaten Endpunkt.

PrivateEndpointConnection

Die Verbindungsressource des privaten Endpunkts.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Der Name der Ressource

properties.groupIds

string[]

Die Gruppen-IDs für die private Endpunktressource.

properties.privateEndpoint

PrivateEndpoint

Die private Endpunktressource.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Eine Sammlung von Informationen über den Verbindungsstatus zwischen Dienstconsumer und Anbieter.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

Der Bereitstellungsstatus der Verbindungsressource des privaten Endpunkts.

systemData

systemData

Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.

type

string

Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Der aktuelle Bereitstellungsstatus.

Name Typ Beschreibung
Creating

string

Deleting

string

Failed

string

Succeeded

string

PrivateEndpointServiceConnectionStatus

Die private Endpunktverbindung status.

Name Typ Beschreibung
Approved

string

Pending

string

Rejected

string

PrivateLinkServiceConnectionState

Eine Sammlung von Informationen über den Status der Verbindung zwischen dem Dienst consumer und dem Anbieter.

Name Typ Beschreibung
actionsRequired

string

Eine Meldung, die angibt, ob Änderungen am Dienstanbieter Updates für den Consumer erfordern.

description

string

Der Grund für die Genehmigung/Ablehnung der Verbindung.

status

PrivateEndpointServiceConnectionStatus

Gibt an, ob die Verbindung vom Besitzer des Diensts genehmigt/abgelehnt/entfernt wurde.

ReplicationRole

Die Replikationsrolle.

Name Typ Beschreibung
None

string

Replica

string

Source

string

Server

Stellt einen Server dar.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity.principalId

string

ObjectId aus dem KeyVault

identity.tenantId

string

TenantId aus dem KeyVault

identity.type

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität.

identity.userAssignedIdentities

object

Metadaten der benutzerseitig zugewiesenen Identität.

location

string

Der geografische Standort, an dem sich die Ressource befindet

name

string

Der Name der Ressource

properties.administratorLogin

string

Der Anmeldename des Administrators eines Servers. Kann nur angegeben werden, wenn der Server erstellt wird (und für die Erstellung erforderlich ist).

properties.administratorLoginPassword

string

Das Kennwort der Administratoranmeldung (erforderlich für die Servererstellung).

properties.availabilityZone

string

Verfügbarkeitszoneninformationen des Servers.

properties.backup

Backup

Sichern sie die zugehörigen Eigenschaften eines Servers.

properties.createMode

CreateMode

Der Modus zum Erstellen eines neuen MySQL-Servers.

properties.dataEncryption

DataEncryption

Die Datenverschlüsselung für CMK.

properties.fullyQualifiedDomainName

string

Der vollqualifizierte Domänenname eines Servers.

properties.highAvailability

HighAvailability

Hochverfügbarkeitsbezogene Eigenschaften eines Servers.

properties.importSourceProperties

ImportSourceProperties

Quelleigenschaften für den Import aus dem Speicher.

properties.maintenanceWindow

MaintenanceWindow

Wartungsfenster eines Servers.

properties.network

Network

Netzwerkbezogene Eigenschaften eines Servers.

properties.privateEndpointConnections

PrivateEndpointConnection[]

PrivateEndpointConnections-bezogene Eigenschaften eines Servers.

properties.replicaCapacity

integer

Die maximale Anzahl von Replikaten, die ein primärer Server haben kann.

properties.replicationRole

ReplicationRole

Die Replikationsrolle.

properties.restorePointInTime

string

Erstellungszeit des Wiederherstellungspunkts (ISO8601 Format), in dem die Wiederherstellungszeit angegeben wird.

properties.sourceServerResourceId

string

Die MySQL-Quellserver-ID.

properties.state

ServerState

Der Status eines Servers.

properties.storage

Storage

Speicherbezogene Eigenschaften eines Servers.

properties.version

ServerVersion

Serverversion.

sku

MySQLServerSku

Die SKU (Tarif) des Servers.

systemData

systemData

Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.

tags

object

Ressourcentags.

type

string

Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ServerListResult

Eine Liste von Servern.

Name Typ Beschreibung
nextLink

string

Der Link, der verwendet wird, um die nächste Seite von Vorgängen abzurufen.

value

Server[]

Die Liste der Server

ServerSkuTier

Die Ebene der jeweiligen SKU, z. B. GeneralPurpose.

Name Typ Beschreibung
Burstable

string

GeneralPurpose

string

MemoryOptimized

string

ServerState

Der Status eines Servers.

Name Typ Beschreibung
Disabled

string

Dropping

string

Ready

string

Starting

string

Stopped

string

Stopping

string

Updating

string

ServerVersion

Die Version eines Servers.

Name Typ Beschreibung
5.7

string

8.0.21

string

Storage

Speicherprofileigenschaften eines Servers

Name Typ Standardwert Beschreibung
autoGrow

EnableStatusEnum

Disabled

Aktivieren Sie die automatische Speichervergrößerung oder nicht.

autoIoScaling

EnableStatusEnum

Enabled

Aktivieren Sie die automatische E/A-Skalierung oder nicht.

iops

integer

Speicher-IOPS für einen Server.

logOnDisk

EnableStatusEnum

Disabled

Aktivieren Sie Auf Datenträger anmelden oder nicht.

storageSizeGB

integer

Maximal zulässige Speichergröße für einen Server.

storageSku

string

Der SKU-Name des Serverspeichers.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.