Dela via


Servers - List By Resource Group

Visa en lista över alla servrar i en viss resursgrupp.

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

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

subscriptionId
path True

string (uuid)

ID för målprenumerationen. Värdet måste vara ett UUID.

api-version
query True

string

minLength: 1

Den API-version som ska användas för den här åtgärden.

Svar

Name Typ Description
200 OK

ServerListResult

Azure-åtgärden har slutförts.

Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

List servers in a resource group

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
Backup

Egenskaper för lagringsprofil för en server

BatchOfMaintenance

Batchen med underhåll när den är aktiverad i det anpassade hanterade underhållsfönstret på en server.

createdByType

Den typ av identitet som skapade resursen.

CreateMode

Läget för att skapa en ny MySQL-server.

DataEncryption

Datumkryptering för cmk.

DataEncryptionType

Nyckeltypen AzureKeyVault för enable cmk, SystemManaged for disable cmk.

EnableStatusEnum

Uppräkning för att ange om värdet är "Aktiverat" eller "Inaktiverat"

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

HighAvailability

Egenskaper för hög tillgänglighet för en server

HighAvailabilityMode

Läge för hög tillgänglighet för en server.

HighAvailabilityState

Tillståndet för serverns höga tillgänglighet.

ImportSourceProperties

Importera källrelaterade egenskaper.

ImportSourceStorageType

Lagringstyp för importkälla.

MaintenancePolicy

Underhållsprincip för en server.

MaintenanceWindow

Underhållsperiod för en server.

ManagedServiceIdentityType

Typ av hanterad tjänstidentitet.

MySQLServerIdentity

Egenskaper för att konfigurera identitet för Bring Your Own Keys

MySQLServerSku

Egenskaper relaterade till faktureringsinformation för en server.

Network

Nätverksrelaterade egenskaper för en server

PatchStrategy

Uppräkning som anger korrigeringsstrategin för en server

PrivateEndpoint

Den privata slutpunktsresursen.

PrivateEndpointConnection

Den privata slutpunktsanslutningsresursen.

PrivateEndpointConnectionProvisioningState

Det aktuella etableringstillståndet.

PrivateEndpointServiceConnectionStatus

Anslutningsstatus för privat slutpunkt.

PrivateLinkServiceConnectionState

En samling med information om tillståndet för anslutningen mellan tjänstkonsumenten och leverantören.

ReplicationRole

Replikeringsrollen.

Server

Representerar en server.

ServerListResult

Svaret från en åtgärd för serverlista.

ServerSkuTier

Nivån för den specifika SKU:n, t.ex. GeneralPurpose.

ServerState

Tillståndet för en server.

ServerVersion

Huvudversionen av en server. 8.0.21 står för MySQL 8.0, 5.7.44 står för MySQL 5.7

Storage

Egenskaper för lagringsprofil för en server

StorageRedundancyEnum

Den redundanta typen av serverlagring. Parametern används för att skapa servern.

systemData

Metadata som rör skapande och senaste ändring av resursen.

UserAssignedIdentity

Metadata för användartilldelad identitet.

Backup

Egenskaper för lagringsprofil för en server

Name Typ Standardvärde Description
backupIntervalHours

integer (int32)

Säkerhetskopieringsintervalltimmar för servern.

backupRetentionDays

integer (int32)

Kvarhållningsdagar för säkerhetskopiering för servern.

earliestRestoreDate

string (date-time)

Tidigaste skapandetid för återställningspunkt (ISO8601 format)

geoRedundantBackup

EnableStatusEnum

Disabled

Om geo-redundant säkerhetskopiering är aktiverat eller inte.

BatchOfMaintenance

Batchen med underhåll när den är aktiverad i det anpassade hanterade underhållsfönstret på en server.

Värde Description
Default
Batch1
Batch2

createdByType

Den typ av identitet som skapade resursen.

Värde Description
User
Application
ManagedIdentity
Key

CreateMode

Läget för att skapa en ny MySQL-server.

Värde Description
Default
PointInTimeRestore
Replica
GeoRestore

DataEncryption

Datumkryptering för cmk.

Name Typ Description
geoBackupKeyURI

string

Geo-säkerhetskopieringsnyckel-URI som nyckelvalv kan inte korsa region, behöver cmk i samma region som geo-säkerhetskopiering

geoBackupUserAssignedIdentityId

string

Geo-säkerhetskopiering av användaridentitetsresurs-ID som identitet kan inte korsa region, behöver identitet i samma region som geo-säkerhetskopiering

primaryKeyURI

string

Primärnyckel-URI

primaryUserAssignedIdentityId

string

Resurs-ID för primär användaridentitet

type

DataEncryptionType

Nyckeltypen AzureKeyVault för enable cmk, SystemManaged for disable cmk.

DataEncryptionType

Nyckeltypen AzureKeyVault för enable cmk, SystemManaged for disable cmk.

Värde Description
AzureKeyVault
SystemManaged

EnableStatusEnum

Uppräkning för att ange om värdet är "Aktiverat" eller "Inaktiverat"

Värde Description
Enabled
Disabled

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

HighAvailability

Egenskaper för hög tillgänglighet för en server

Name Typ Description
mode

HighAvailabilityMode

Läge för hög tillgänglighet för en server.

standbyAvailabilityZone

string

Tillgänglighetszon för väntelägesservern.

state

HighAvailabilityState

Tillståndet för serverns höga tillgänglighet.

HighAvailabilityMode

Läge för hög tillgänglighet för en server.

Värde Description
Disabled
ZoneRedundant
SameZone

HighAvailabilityState

Tillståndet för serverns höga tillgänglighet.

Värde Description
NotEnabled
CreatingStandby
Healthy
FailingOver
RemovingStandby

ImportSourceProperties

Importera källrelaterade egenskaper.

Name Typ Description
dataDirPath

string

Relativ sökväg för datakatalogen i lagringen.

sasToken

string (password)

Sas-token för åtkomst till källlagring. Läs- och listbehörigheter krävs för sas-token.

storageType

ImportSourceStorageType

Lagringstyp för importkälla.

storageUrl

string

Uri för importkällans lagring.

ImportSourceStorageType

Lagringstyp för importkälla.

Värde Description
AzureBlob

MaintenancePolicy

Underhållsprincip för en server.

Name Typ Description
patchStrategy

PatchStrategy

Korrigeringsstrategin för den här servern

MaintenanceWindow

Underhållsperiod för en server.

Name Typ Description
batchOfMaintenance

BatchOfMaintenance

Batchen med underhåll när den är aktiverad i det anpassade hanterade underhållsfönstret på en server.

customWindow

string

anger om anpassat fönster är aktiverat eller inaktiverat

dayOfWeek

integer (int32)

dag i veckan för underhållsperiod

startHour

integer (int32)

starttimmes för underhållsperiod

startMinute

integer (int32)

startminut för underhållsperiod

ManagedServiceIdentityType

Typ av hanterad tjänstidentitet.

Värde Description
UserAssigned

MySQLServerIdentity

Egenskaper för att konfigurera identitet för Bring Your Own Keys

Name Typ Description
principalId

string

ObjectId från KeyVault

tenantId

string

TenantId från KeyVault

type

ManagedServiceIdentityType

Typ av hanterad tjänstidentitet.

userAssignedIdentities

<string,  UserAssignedIdentity>

Metadata för användartilldelad identitet.

MySQLServerSku

Egenskaper relaterade till faktureringsinformation för en server.

Name Typ Description
name

string

Namnet på sku:n, t.ex. Standard_D32s_v3.

tier

ServerSkuTier

Nivån för den specifika SKU:n, t.ex. GeneralPurpose.

Network

Nätverksrelaterade egenskaper för en server

Name Typ Description
delegatedSubnetResourceId

string

Delegerat resurs-ID för undernät som används för att konfigurera vnet för en server.

privateDnsZoneResourceId

string

Resurs-ID för privat DNS-zon.

publicNetworkAccess

EnableStatusEnum

Om offentlig nätverksåtkomst tillåts för den här servern eller inte. Värdet är Inaktiverat när servern har VNet-integrering.

PatchStrategy

Uppräkning som anger korrigeringsstrategin för en server

Värde Description
Regular
VirtualCanary

PrivateEndpoint

Den privata slutpunktsresursen.

Name Typ Description
id

string

ARM-identifieraren för privat slutpunkt.

PrivateEndpointConnection

Den privata slutpunktsanslutningsresursen.

Name Typ Description
id

string (arm-id)

Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Namnet på resursen

properties.groupIds

string[]

Grupp-ID:t för den privata slutpunktsresursen.

properties.privateEndpoint

PrivateEndpoint

Den privata slutpunktsresursen.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

En samling med information om tillståndet för anslutningen mellan tjänstkonsumenten och leverantören.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

Etableringstillståndet för den privata slutpunktsanslutningsresursen.

systemData

systemData

Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.

type

string

Resurstypen. T.ex. "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Det aktuella etableringstillståndet.

Värde Description
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

Anslutningsstatus för privat slutpunkt.

Värde Description
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

En samling med information om tillståndet för anslutningen mellan tjänstkonsumenten och leverantören.

Name Typ Description
actionsRequired

string

Ett meddelande som anger om ändringar på tjänstleverantören kräver några uppdateringar på konsumenten.

description

string

Orsak till godkännande/avvisande av anslutningen.

status

PrivateEndpointServiceConnectionStatus

Anger om anslutningen har godkänts/avvisats/tagits bort av tjänstens ägare.

ReplicationRole

Replikeringsrollen.

Värde Description
None
Source
Replica

Server

Representerar en server.

Name Typ Description
id

string (arm-id)

Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

MySQLServerIdentity

Cmk-identiteten för servern.

location

string

Den geo-plats där resursen finns

name

string

Namnet på resursen

properties.administratorLogin

string

Administratörens inloggningsnamn för en server. Kan bara anges när servern skapas (och krävs för att skapa).

properties.administratorLoginPassword

string (password)

Lösenordet för administratörsinloggningen (krävs för att skapa servern).

properties.availabilityZone

string

tillgänglighet Zoninformation för servern.

properties.backup

Backup

Säkerhetskopiera relaterade egenskaper för en server.

properties.createMode

CreateMode

Läget för att skapa en ny MySQL-server.

properties.dataEncryption

DataEncryption

Datakryptering för CMK.

properties.databasePort

integer (int32)

Serverdatabasporten. Det går bara att ange när servern skapas.

properties.fullVersion

string

Huvudversion och faktisk motorversion

properties.fullyQualifiedDomainName

string

Det fullständigt kvalificerade domännamnet för en server.

properties.highAvailability

HighAvailability

Egenskaper relaterade till hög tillgänglighet för en server.

properties.importSourceProperties

ImportSourceProperties

Källegenskaper för import från lagring.

properties.maintenancePolicy

MaintenancePolicy

Underhållsprincip för en server.

properties.maintenanceWindow

MaintenanceWindow

Underhållsperiod för en server. Känt problem: kan inte anges när servern skapas eller uppdateras med andra egenskaper under serveruppdateringen. måste uppdateras separat.

properties.network

Network

Nätverksrelaterade egenskaper för en server.

properties.privateEndpointConnections

PrivateEndpointConnection[]

PrivateEndpointConnections-relaterade egenskaper för en server.

properties.replicaCapacity

integer (int32)

minimum: 0

Det maximala antalet repliker som en primär server kan ha.

properties.replicationRole

ReplicationRole

Replikeringsrollen.

properties.restorePointInTime

string (date-time)

Skapandetid för återställningspunkt (ISO8601 format) som anger den tid som du ska återställa från.

properties.sourceServerResourceId

string

MySQL-källserverns ID.

properties.state

ServerState

Tillståndet för en server.

properties.storage

Storage

Lagringsrelaterade egenskaper för en server.

properties.version

ServerVersion

Huvudversion av MySQL. 8.0.21 står för MySQL 8.0, 5.7.44 står för MySQL 5.7

sku

MySQLServerSku

Serverns SKU (prisnivå).

systemData

systemData

Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.

tags

object

Resursetiketter.

type

string

Resurstypen. T.ex. "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

ServerListResult

Svaret från en åtgärd för serverlista.

Name Typ Description
nextLink

string (uri)

Länken till nästa sida med objekt

value

Server[]

Serverobjekten på den här sidan

ServerSkuTier

Nivån för den specifika SKU:n, t.ex. GeneralPurpose.

Värde Description
Burstable
GeneralPurpose
MemoryOptimized

ServerState

Tillståndet för en server.

Värde Description
Ready
Dropping
Disabled
Starting
Stopping
Stopped
Updating

ServerVersion

Huvudversionen av en server. 8.0.21 står för MySQL 8.0, 5.7.44 står för MySQL 5.7

Värde Description
5.7
8.0.21

Storage

Egenskaper för lagringsprofil för en server

Name Typ Standardvärde Description
autoGrow

EnableStatusEnum

Disabled

Aktivera Automatisk ökning av lagring eller inte.

autoIoScaling

EnableStatusEnum

Enabled

Aktivera automatisk I/O-skalning eller inte.

iops

integer (int32)

Lagrings-IOPS för en server.

logOnDisk

EnableStatusEnum

Disabled

Aktivera Inloggningsdisk eller inte.

storageRedundancy

StorageRedundancyEnum

LocalRedundancy

Den redundanta typen av serverlagring. Parametern används för att skapa servern.

storageSizeGB

integer (int32)

Maximal lagringsstorlek som tillåts för en server.

storageSku

string

SKU-namnet på serverlagringen.

StorageRedundancyEnum

Den redundanta typen av serverlagring. Parametern används för att skapa servern.

Värde Description
LocalRedundancy
ZoneRedundancy

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string (date-time)

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string (date-time)

Tidsstämpeln för resursens senaste ändring (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.

UserAssignedIdentity

Metadata för användartilldelad identitet.

Name Typ Description
clientId

string

Klient-ID för användartilldelad identitet

principalId

string

Huvudsakligt ID för användartilldelad identitet