Skip to main content

replicas

Creates, updates, deletes, gets or lists a replicas resource.

Overview

Namereplicas
TypeResource
Idazure.mysql_flexible_servers.replicas

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringFully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}".
namestringThe name of the resource.
administratorLoginstringThe administrator's login name of a server. Can only be specified when the server is being created (and is required for creation).
administratorLoginPasswordstringThe password of the administrator login (required for server creation).
availabilityZonestringavailability Zone information of the server.
backupobjectBackup related properties of a server.
createModestringThe mode to create a new MySQL server. Known values are: "Default", "PointInTimeRestore", "Replica", and "GeoRestore".
dataEncryptionobjectThe Data Encryption for CMK.
databasePortintegerThe server database port. Can only be specified when the server is being created.
fullVersionstringMajor version and actual engine version.
fullyQualifiedDomainNamestringThe fully qualified domain name of a server.
highAvailabilityobjectHigh availability related properties of a server.
identityobjectThe cmk identity for the server.
importSourcePropertiesobjectSource properties for import from storage.
locationstringThe geo-location where the resource lives. Required.
lowerCaseTableNamesintegerThe mysql parameter lower_case_table_names. Can only be specified when the server is being created. Allowed values 1 or 2.
maintenancePolicyobjectMaintenance policy of a server.
maintenanceWindowobjectMaintenance window of a server. Known issue: cannot be set during server creation or updated with other properties during server update; must be updated separately.
networkobjectNetwork related properties of a server.
privateEndpointConnectionsarrayPrivateEndpointConnections related properties of a server.
replicaCapacityintegerThe maximum number of replicas that a primary server can have.
replicationRolestringThe replication role. Known values are: "None", "Source", and "Replica".
restorePointInTimestring (date-time)Restore point creation time (ISO8601 format), specifying the time to restore from.
skuobjectThe SKU (pricing tier) of the server.
sourceServerResourceIdstringThe source MySQL server id.
statestringThe state of a server. Known values are: "Ready", "Dropping", "Disabled", "Starting", "Stopping", "Stopped", and "Updating".
storageobjectStorage related properties of a server.
systemDataobjectAzure Resource Manager metadata containing createdBy and modifiedBy information.
tagsobjectResource tags.
typestringThe type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts".
versionstringMajor version of MySQL. 8.0.21 stands for MySQL 8.0, 5.7.44 stands for MySQL 5.7. Known values are: "5.7", "8.0.21", and "8.4".

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
list_by_serverselectresource_group_name, server_name, subscription_idList all the replicas for a given server.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
resource_group_namestringThe name of the resource group. The name is case insensitive. Required.
server_namestringThe name of the server. Required.
subscription_idstring

SELECT examples

List all the replicas for a given server.

SELECT
id,
name,
administratorLogin,
administratorLoginPassword,
availabilityZone,
backup,
createMode,
dataEncryption,
databasePort,
fullVersion,
fullyQualifiedDomainName,
highAvailability,
identity,
importSourceProperties,
location,
lowerCaseTableNames,
maintenancePolicy,
maintenanceWindow,
network,
privateEndpointConnections,
replicaCapacity,
replicationRole,
restorePointInTime,
sku,
sourceServerResourceId,
state,
storage,
systemData,
tags,
type,
version
FROM azure.mysql_flexible_servers.replicas
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND server_name = '{{ server_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;