Replicas - List By Server

Wyświetl listę wszystkich replik dla danego serwera.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

serverName
path True

string

minLength: 1
maxLength: 63
pattern: ^[a-z0-9][-a-z0-9]*(?

Nazwa serwera.

subscriptionId
path True

string (uuid)

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa Typ Opis
200 OK

ServerListResult

Operacja platformy Azure została zakończona pomyślnie.

Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

List replicas for a server

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "value": [
    {
      "name": "mysqltestserver-repl",
      "type": "Microsoft.DBforMySQL/flexibleServers",
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestserver-repl",
      "location": "Southeast Asia",
      "properties": {
        "administratorLogin": "cloudsa",
        "availabilityZone": "1",
        "backup": {
          "backupRetentionDays": 7,
          "earliestRestoreDate": "2021-06-24T08:19:18.00+00:00",
          "geoRedundantBackup": "Disabled"
        },
        "fullVersion": "5.7.44",
        "fullyQualifiedDomainName": "mysqltestserver-repl.orcabrci-seas1-a.mscds.com",
        "highAvailability": {
          "mode": "Disabled",
          "state": "NotEnabled"
        },
        "maintenancePolicy": {
          "patchStrategy": "Regular"
        },
        "maintenanceWindow": {
          "customWindow": "Disabled",
          "dayOfWeek": 0,
          "startHour": 0,
          "startMinute": 0
        },
        "network": {
          "publicNetworkAccess": "Enabled"
        },
        "replicaCapacity": 0,
        "replicationRole": "Replica",
        "sourceServerResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestserver",
        "state": "Ready",
        "storage": {
          "autoGrow": "Enabled",
          "iops": 360,
          "storageRedundancy": "LocalRedundancy",
          "storageSizeGB": 20,
          "storageSku": "Premium_LRS"
        },
        "version": "5.7"
      },
      "sku": {
        "name": "Standard_D2ds_v4",
        "tier": "GeneralPurpose"
      },
      "tags": {
        "num": "1"
      }
    },
    {
      "name": "mysqltestserver-repl",
      "type": "Microsoft.DBforMySQL/flexibleServers",
      "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestserver-repl2",
      "location": "Southeast Asia",
      "properties": {
        "administratorLogin": "cloudsa",
        "availabilityZone": "1",
        "backup": {
          "backupRetentionDays": 7,
          "earliestRestoreDate": "2021-06-23T08:19:18.00+00:00",
          "geoRedundantBackup": "Disabled"
        },
        "fullVersion": "5.7.44",
        "fullyQualifiedDomainName": "mysqltestserver-repl2.orcabrci-seas1-a.mscds.com",
        "highAvailability": {
          "mode": "Disabled",
          "state": "NotEnabled"
        },
        "maintenancePolicy": {
          "patchStrategy": "Default"
        },
        "maintenanceWindow": {
          "batchOfMaintenance": "Default",
          "customWindow": "Disabled",
          "dayOfWeek": 0,
          "startHour": 0,
          "startMinute": 0
        },
        "network": {
          "publicNetworkAccess": "Enabled"
        },
        "replicaCapacity": 0,
        "replicationRole": "Replica",
        "sourceServerResourceId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestserver",
        "state": "Ready",
        "storage": {
          "autoGrow": "Enabled",
          "iops": 360,
          "storageRedundancy": "ZoneRedundancy",
          "storageSizeGB": 20,
          "storageSku": "Premium_ZRS"
        },
        "version": "5.7"
      },
      "sku": {
        "name": "Standard_D2ds_v4",
        "tier": "GeneralPurpose"
      },
      "tags": {
        "num": "1"
      }
    }
  ]
}

Definicje

Nazwa Opis
Backup

Właściwości profilu magazynu serwera

BatchOfMaintenance

Partia konserwacji po włączeniu niestandardowego zarządzanego okna obsługi serwera.

createdByType

Typ tożsamości, która utworzyła zasób.

CreateMode

Tryb tworzenia nowego serwera MySQL.

DataEncryption

Szyfrowanie dat dla narzędzia cmk.

DataEncryptionType

Typ klucza AzureKeyVault dla polecenia cmk, SystemManaged dla polecenia wyłącz cmk.

EnableStatusEnum

Wyliczenie wskazujące, czy wartość jest "włączona", czy "wyłączona"

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

HighAvailability

Właściwości wysokiej dostępności serwera

HighAvailabilityMode

Tryb wysokiej dostępności serwera.

HighAvailabilityState

Stan wysokiej dostępności serwera.

ImportSourceProperties

Importuj właściwości powiązane ze źródłem.

ImportSourceStorageType

Typ magazynu źródła importu.

MaintenancePolicy

Zasady konserwacji serwera.

MaintenanceWindow

Okno obsługi serwera.

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej.

MySQLServerIdentity

Właściwości umożliwiające skonfigurowanie tożsamości dla funkcji Bring Your Own Keys

MySQLServerSku

Właściwości powiązane z informacjami rozliczeniowymi serwera.

Network

Właściwości związane z siecią serwera

PatchStrategy

Wyliczenie wskazujące strategię stosowania poprawek serwera

PrivateEndpoint

Zasób prywatnego punktu końcowego.

PrivateEndpointConnection

Zasób połączenia prywatnego punktu końcowego.

PrivateEndpointConnectionProvisioningState

Bieżący stan aprowizacji.

PrivateEndpointServiceConnectionStatus

Stan połączenia prywatnego punktu końcowego.

PrivateLinkServiceConnectionState

Zbiór informacji o stanie połączenia między użytkownikiem usługi a dostawcą.

ReplicationRole

Rola replikacji.

Server

Reprezentuje serwer.

ServerListResult

Odpowiedź operacji listy serwerów.

ServerSkuTier

Warstwa konkretnej jednostki SKU, np. OgólnePurpose.

ServerState

Stan serwera.

ServerVersion

Główna wersja serwera. 8.0.21 oznacza MySQL 8.0, 5.7.44 oznacza MySQL 5.7

Storage

Właściwości profilu magazynu serwera

StorageRedundancyEnum

Nadmiarowy typ magazynu serwera. Parametr jest używany do tworzenia serwera.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

UserAssignedIdentity

Metadane tożsamości przypisanej przez użytkownika.

Backup

Właściwości profilu magazynu serwera

Nazwa Typ Domyślna wartość Opis
backupIntervalHours

integer (int32)

Godziny interwału tworzenia kopii zapasowej serwera.

backupRetentionDays

integer (int32)

Dni przechowywania kopii zapasowej serwera.

earliestRestoreDate

string (date-time)

Najwcześniejszy czas tworzenia punktu przywracania (format ISO8601)

geoRedundantBackup

EnableStatusEnum

Disabled

Określa, czy jest włączona geograficznie nadmiarowa kopia zapasowa.

BatchOfMaintenance

Partia konserwacji po włączeniu niestandardowego zarządzanego okna obsługi serwera.

Wartość Opis
Default
Batch1
Batch2

createdByType

Typ tożsamości, która utworzyła zasób.

Wartość Opis
User
Application
ManagedIdentity
Key

CreateMode

Tryb tworzenia nowego serwera MySQL.

Wartość Opis
Default
PointInTimeRestore
Replica
GeoRestore

DataEncryption

Szyfrowanie dat dla narzędzia cmk.

Nazwa Typ Opis
geoBackupKeyURI

string

Identyfikator URI klucza kopii zapasowej geograficznej, ponieważ magazyn kluczy nie może przechodzić między regionami, musi mieć klucz cmk w tym samym regionie co kopia zapasowa geograficzna

geoBackupUserAssignedIdentityId

string

Identyfikator zasobu tożsamości użytkownika kopii zapasowej geograficznej jako tożsamość nie może być w wielu regionach, potrzebujesz tożsamości w tym samym regionie co kopia zapasowa geograficzna

primaryKeyURI

string

Identyfikator URI klucza podstawowego

primaryUserAssignedIdentityId

string

Identyfikator zasobu tożsamości użytkownika podstawowego

type

DataEncryptionType

Typ klucza AzureKeyVault dla polecenia cmk, SystemManaged dla polecenia wyłącz cmk.

DataEncryptionType

Typ klucza AzureKeyVault dla polecenia cmk, SystemManaged dla polecenia wyłącz cmk.

Wartość Opis
AzureKeyVault
SystemManaged

EnableStatusEnum

Wyliczenie wskazujące, czy wartość jest "włączona", czy "wyłączona"

Wartość Opis
Enabled
Disabled

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

HighAvailability

Właściwości wysokiej dostępności serwera

Nazwa Typ Opis
mode

HighAvailabilityMode

Tryb wysokiej dostępności serwera.

standbyAvailabilityZone

string

Strefa dostępności serwera rezerwowego.

state

HighAvailabilityState

Stan wysokiej dostępności serwera.

HighAvailabilityMode

Tryb wysokiej dostępności serwera.

Wartość Opis
Disabled
ZoneRedundant
SameZone

HighAvailabilityState

Stan wysokiej dostępności serwera.

Wartość Opis
NotEnabled
CreatingStandby
Healthy
FailingOver
RemovingStandby

ImportSourceProperties

Importuj właściwości powiązane ze źródłem.

Nazwa Typ Opis
dataDirPath

string

Względna ścieżka katalogu danych w magazynie.

sasToken

string (password)

Token sygnatury dostępu współdzielonego do uzyskiwania dostępu do magazynu źródłowego. Uprawnienia do odczytu i listy są wymagane dla tokenu sas.

storageType

ImportSourceStorageType

Typ magazynu źródła importu.

storageUrl

string

Identyfikator URI magazynu źródłowego importu.

ImportSourceStorageType

Typ magazynu źródła importu.

Wartość Opis
AzureBlob

MaintenancePolicy

Zasady konserwacji serwera.

Nazwa Typ Opis
patchStrategy

PatchStrategy

Strategia stosowania poprawek tego serwera

MaintenanceWindow

Okno obsługi serwera.

Nazwa Typ Opis
batchOfMaintenance

BatchOfMaintenance

Partia konserwacji po włączeniu niestandardowego zarządzanego okna obsługi serwera.

customWindow

string

wskazuje, czy okno niestandardowe jest włączone, czy wyłączone

dayOfWeek

integer (int32)

dzień tygodnia dla okna obsługi

startHour

integer (int32)

godzina rozpoczęcia okna obsługi

startMinute

integer (int32)

minuta rozpoczęcia okna obsługi

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej.

Wartość Opis
UserAssigned

MySQLServerIdentity

Właściwości umożliwiające skonfigurowanie tożsamości dla funkcji Bring Your Own Keys

Nazwa Typ Opis
principalId

string

ObjectId z usługi KeyVault

tenantId

string

TenantId z usługi KeyVault

type

ManagedServiceIdentityType

Typ tożsamości usługi zarządzanej.

userAssignedIdentities

<string,  UserAssignedIdentity>

Metadane tożsamości przypisanej przez użytkownika.

MySQLServerSku

Właściwości powiązane z informacjami rozliczeniowymi serwera.

Nazwa Typ Opis
name

string

Nazwa jednostki SKU, np. Standard_D32s_v3.

tier

ServerSkuTier

Warstwa konkretnej jednostki SKU, np. OgólnePurpose.

Network

Właściwości związane z siecią serwera

Nazwa Typ Opis
delegatedSubnetResourceId

string

Identyfikator zasobu delegowanej podsieci używany do konfigurowania sieci wirtualnej dla serwera.

privateDnsZoneResourceId

string

Identyfikator zasobu prywatnej strefy DNS.

publicNetworkAccess

EnableStatusEnum

Określa, czy dostęp do sieci publicznej jest dozwolony dla tego serwera. Wartość jest wyłączona, gdy serwer ma integrację z siecią wirtualną.

PatchStrategy

Wyliczenie wskazujące strategię stosowania poprawek serwera

Wartość Opis
Regular
VirtualCanary

PrivateEndpoint

Zasób prywatnego punktu końcowego.

Nazwa Typ Opis
id

string

Identyfikator usługi ARM dla prywatnego punktu końcowego.

PrivateEndpointConnection

Zasób połączenia prywatnego punktu końcowego.

Nazwa Typ Opis
id

string (arm-id)

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

Nazwa zasobu

properties.groupIds

string[]

Identyfikatory grupy dla zasobu prywatnego punktu końcowego.

properties.privateEndpoint

PrivateEndpoint

Zasób prywatnego punktu końcowego.

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Zbiór informacji o stanie połączenia między użytkownikiem usługi a dostawcą.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

Stan aprowizacji zasobu połączenia prywatnego punktu końcowego.

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionProvisioningState

Bieżący stan aprowizacji.

Wartość Opis
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

Stan połączenia prywatnego punktu końcowego.

Wartość Opis
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

Zbiór informacji o stanie połączenia między użytkownikiem usługi a dostawcą.

Nazwa Typ Opis
actionsRequired

string

Komunikat wskazujący, czy zmiany u dostawcy usług wymagają aktualizacji odbiorcy.

description

string

Przyczyna zatwierdzenia/odrzucenia połączenia.

status

PrivateEndpointServiceConnectionStatus

Wskazuje, czy połączenie zostało zatwierdzone/odrzucone/usunięte przez właściciela usługi.

ReplicationRole

Rola replikacji.

Wartość Opis
None
Source
Replica

Server

Reprezentuje serwer.

Nazwa Typ Opis
id

string (arm-id)

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

identity

MySQLServerIdentity

Tożsamość narzędzia cmk dla serwera.

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties.administratorLogin

string

Nazwa logowania administratora serwera. Można określić tylko wtedy, gdy serwer jest tworzony (i jest wymagany do utworzenia).

properties.administratorLoginPassword

string (password)

Hasło logowania administratora (wymagane do utworzenia serwera).

properties.availabilityZone

string

informacje o strefie dostępności serwera.

properties.backup

Backup

Tworzenie kopii zapasowych powiązanych właściwości serwera.

properties.createMode

CreateMode

Tryb tworzenia nowego serwera MySQL.

properties.dataEncryption

DataEncryption

Szyfrowanie danych dla klucza zarządzanego przez klienta.

properties.databasePort

integer (int32)

Port bazy danych serwera. Można określić tylko podczas tworzenia serwera.

properties.fullVersion

string

Wersja główna i aktualna wersja aparatu

properties.fullyQualifiedDomainName

string

W pełni kwalifikowana nazwa domeny serwera.

properties.highAvailability

HighAvailability

Właściwości związane z wysoką dostępnością serwera.

properties.importSourceProperties

ImportSourceProperties

Właściwości źródła do importowania z magazynu.

properties.maintenancePolicy

MaintenancePolicy

Zasady konserwacji serwera.

properties.maintenanceWindow

MaintenanceWindow

Okno obsługi serwera. Znany problem: nie można ustawić podczas tworzenia serwera ani aktualizować z innymi właściwościami podczas aktualizacji serwera; należy zaktualizować oddzielnie.

properties.network

Network

Właściwości związane z siecią serwera.

properties.privateEndpointConnections

PrivateEndpointConnection[]

PrivateEndpointConnections powiązane właściwości serwera.

properties.replicaCapacity

integer (int32)

minimum: 0

Maksymalna liczba replik, które może mieć serwer podstawowy.

properties.replicationRole

ReplicationRole

Rola replikacji.

properties.restorePointInTime

string (date-time)

Czas tworzenia punktu przywracania (ISO8601 format), określając czas do przywrócenia.

properties.sourceServerResourceId

string

Źródłowy identyfikator serwera MySQL.

properties.state

ServerState

Stan serwera.

properties.storage

Storage

Właściwości związane z magazynem serwera.

properties.version

ServerVersion

Wersja główna programu MySQL. 8.0.21 oznacza MySQL 8.0, 5.7.44 oznacza MySQL 5.7

sku

MySQLServerSku

Jednostka SKU (warstwa cenowa) serwera.

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ServerListResult

Odpowiedź operacji listy serwerów.

Nazwa Typ Opis
nextLink

string (uri)

Link do następnej strony z elementami

value

Server[]

Elementy serwera na tej stronie

ServerSkuTier

Warstwa konkretnej jednostki SKU, np. OgólnePurpose.

Wartość Opis
Burstable
GeneralPurpose
MemoryOptimized

ServerState

Stan serwera.

Wartość Opis
Ready
Dropping
Disabled
Starting
Stopping
Stopped
Updating

ServerVersion

Główna wersja serwera. 8.0.21 oznacza MySQL 8.0, 5.7.44 oznacza MySQL 5.7

Wartość Opis
5.7
8.0.21

Storage

Właściwości profilu magazynu serwera

Nazwa Typ Domyślna wartość Opis
autoGrow

EnableStatusEnum

Disabled

Włącz automatyczne zwiększanie magazynu lub nie.

autoIoScaling

EnableStatusEnum

Enabled

Włącz automatyczne skalowanie we/wy lub nie.

iops

integer (int32)

Operacje we/wy na sekundę magazynu dla serwera.

logOnDisk

EnableStatusEnum

Disabled

Włącz opcję Zaloguj się na dysku lub nie.

storageRedundancy

StorageRedundancyEnum

LocalRedundancy

Nadmiarowy typ magazynu serwera. Parametr jest używany do tworzenia serwera.

storageSizeGB

integer (int32)

Maksymalny dozwolony rozmiar magazynu dla serwera.

storageSku

string

Nazwa jednostki SKU magazynu serwera.

StorageRedundancyEnum

Nadmiarowy typ magazynu serwera. Parametr jest używany do tworzenia serwera.

Wartość Opis
LocalRedundancy
ZoneRedundancy

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string (date-time)

Znacznik czasu ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.

UserAssignedIdentity

Metadane tożsamości przypisanej przez użytkownika.

Nazwa Typ Opis
clientId

string

Identyfikator klienta tożsamości przypisanej przez użytkownika

principalId

string

Identyfikator podmiotu zabezpieczeń tożsamości przypisanej przez użytkownika