Servers - Create

Crea un nuevo servidor o actualiza un servidor existente. La acción de actualización sobrescribirá el servidor existente.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMariaDB/servers/{serverName}?api-version=2018-06-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
path True

string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

serverName
path True

string

El nombre del servidor.

subscriptionId
path True

string

Identificador de la suscripción de destino.

api-version
query True

string

Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre Tipo Description
parameters

ServerForCreate

Los parámetros necesarios para crear o actualizar un servidor.

Respuestas

Nombre Tipo Description
200 OK

Server

Aceptar

201 Created

Server

Creado

202 Accepted

Aceptado

Other Status Codes

CloudError

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

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

Scopes

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

Create a database as a point in time restore
Create a new server
Create a replica server
Create a server as a geo restore

Create a database as a point in time restore

Sample Request

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TargetResourceGroup/providers/Microsoft.DBforMariaDB/servers/targetserver?api-version=2018-06-01

{
  "location": "brazilsouth",
  "properties": {
    "restorePointInTime": "2017-12-14T00:00:37.467Z",
    "createMode": "PointInTimeRestore",
    "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/SourceResourceGroup/providers/Microsoft.DBforMariaDB/servers/sourceserver"
  },
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "tags": {
    "ElasticServer": "1"
  }
}

Sample Response

{
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Enabled"
    },
    "version": "10.3",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "targetserver.mariadb.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00"
  },
  "location": "brazilsouth",
  "tags": {
    "ElasticServer": "1"
  },
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMariaDB/servers/targetserver",
  "name": "targetserver",
  "type": "Microsoft.DBforMariaDB/servers"
}
{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMariaDB/servers/targetserver",
  "name": "targetserver",
  "type": "Microsoft.DBforMariaDB/servers",
  "location": "brazilsouth",
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "tags": {
    "elasticServer": "1"
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Enabled"
    },
    "version": "10.3",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "targetserver.mariadb.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00"
  }
}

Create a new server

Sample Request

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMariaDB/servers/mariadbtestsvc4?api-version=2018-06-01

{
  "location": "westus",
  "properties": {
    "administratorLogin": "cloudsa",
    "administratorLoginPassword": "<administratorLoginPassword>",
    "sslEnforcement": "Enabled",
    "minimalTlsVersion": "TLS1_2",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Enabled"
    },
    "createMode": "Default"
  },
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "capacity": 2,
    "family": "Gen5"
  },
  "tags": {
    "ElasticServer": "1"
  }
}

Sample Response

{
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Enabled"
    },
    "version": "10.3",
    "sslEnforcement": "Enabled",
    "minimalTlsVersion": "TLS1_2",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "mariadbtestsvc4.mariadb.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00"
  },
  "location": "westus",
  "tags": {
    "ElasticServer": "1"
  },
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMariaDB/servers/mariadbtestsvc4",
  "name": "mariadbtestsvc4",
  "type": "Microsoft.DBforMariaDB/servers"
}
{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMariaDB/servers/mariadbtestsvc4",
  "name": "mariadbtestsvc4",
  "type": "Microsoft.DBforMariaDB/servers",
  "location": "westus",
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "tags": {
    "elasticServer": "1"
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Enabled"
    },
    "version": "10.3",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "mariadbtestsvc4.mariadb.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00"
  }
}

Create a replica server

Sample Request

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TargetResourceGroup/providers/Microsoft.DBforMariaDB/servers/targetserver?api-version=2018-06-01

{
  "location": "westus",
  "properties": {
    "createMode": "Replica",
    "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/MasterResourceGroup/providers/Microsoft.DBforMariaDB/servers/masterserver"
  }
}

Sample Response

{
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 14,
      "geoRedundantBackup": "Enabled"
    },
    "version": "10.3",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "targetserver.mariadb.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00",
    "replicationRole": "Replica",
    "masterServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/MasterResourceGroup/providers/Microsoft.DBforMariaDB/servers/masterserver",
    "replicaCapacity": 0
  },
  "location": "westus",
  "tags": {
    "ElasticServer": "1"
  },
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TargetResourceGroup/providers/Microsoft.DBforMariaDB/servers/targetserver",
  "name": "targetserver",
  "type": "Microsoft.DBforMariaDB/servers"
}
{
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 14,
      "geoRedundantBackup": "Enabled"
    },
    "version": "10.3",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "targetserver.mariadb.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00",
    "replicationRole": "Replica",
    "masterServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/MasterResourceGroup/providers/Microsoft.DBforMariaDB/servers/masterserver",
    "replicaCapacity": 0
  },
  "location": "westus",
  "tags": {
    "ElasticServer": "1"
  },
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TargetResourceGroup/providers/Microsoft.DBforMariaDB/servers/targetserver",
  "name": "targetserver",
  "type": "Microsoft.DBforMariaDB/servers"
}

Create a server as a geo restore

Sample Request

PUT https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TargetResourceGroup/providers/Microsoft.DBforMariaDB/servers/targetserver?api-version=2018-06-01

{
  "location": "westus",
  "properties": {
    "createMode": "GeoRestore",
    "sourceServerId": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/SourceResourceGroup/providers/Microsoft.DBforMariaDB/servers/sourceserver"
  },
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "tags": {
    "ElasticServer": "1"
  }
}

Sample Response

{
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 14,
      "geoRedundantBackup": "Enabled"
    },
    "version": "10.3",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "targetserver.mariadb.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00"
  },
  "location": "westus",
  "tags": {
    "ElasticServer": "1"
  },
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMariaDB/servers/targetserver",
  "name": "targetserver",
  "type": "Microsoft.DBforMariaDB/servers"
}
{
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMariaDB/servers/targetserver",
  "name": "targetserver",
  "type": "Microsoft.DBforMariaDB/servers",
  "location": "westus",
  "sku": {
    "name": "GP_Gen5_2",
    "tier": "GeneralPurpose",
    "family": "Gen5",
    "capacity": 2
  },
  "tags": {
    "elasticServer": "1"
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 14,
      "geoRedundantBackup": "Enabled"
    },
    "version": "10.3",
    "sslEnforcement": "Enabled",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "targetserver.mariadb.database.azure.com",
    "earliestRestoreDate": "2018-03-14T18:02:41.577+00:00"
  }
}

Definiciones

Nombre Description
CloudError

Respuesta de error del servicio Batch.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorResponse

Respuesta de error

GeoRedundantBackup

Habilite la redundancia geográfica o no para la copia de seguridad del servidor.

MinimalTlsVersionEnum

Aplique una versión mínima de Tls para el servidor.

PrivateEndpointProperty

Punto de conexión privado al que pertenece la conexión.

PrivateEndpointProvisioningState

Estado de la conexión del punto de conexión privado.

PrivateLinkServiceConnectionStateActionsRequire

Las acciones necesarias para la conexión del servicio Private Link.

PrivateLinkServiceConnectionStateStatus

Estado de conexión del servicio Private Link.

PublicNetworkAccessEnum

Si se permite o no el acceso a la red pública para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

Server

Representa un servidor.

ServerForCreate

Los parámetros necesarios para crear o actualizar un servidor.

ServerPrivateEndpointConnection

Lista de conexiones de punto de conexión privado en un servidor

ServerPrivateEndpointConnectionProperties

Propiedades de conexión de punto de conexión privado

ServerPrivateLinkServiceConnectionStateProperty

Estado de conexión de la conexión del punto de conexión privado.

ServerState

Estado de un servidor que es visible para el usuario.

ServerVersion

Versión del servidor.

Sku

SKU (plan de tarifa) del servidor.

SkuTier

El nivel de la SKU determinada, por ejemplo, Básico.

SslEnforcementEnum

Habilite la aplicación ssl o no cuando se conecte al servidor.

StorageAutogrow

Habilite El crecimiento automático del almacenamiento.

StorageProfile

Perfil de almacenamiento de un servidor.

CloudError

Respuesta de error del servicio Batch.

Nombre Tipo Description
error

ErrorResponse

Respuesta de error
Mensaje de error

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorResponse

Respuesta de error

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorResponse[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

GeoRedundantBackup

Habilite la redundancia geográfica o no para la copia de seguridad del servidor.

Nombre Tipo Description
Disabled

string

Enabled

string

MinimalTlsVersionEnum

Aplique una versión mínima de Tls para el servidor.

Nombre Tipo Description
TLS1_0

string

TLS1_1

string

TLS1_2

string

TLSEnforcementDisabled

string

PrivateEndpointProperty

Punto de conexión privado al que pertenece la conexión.

Nombre Tipo Description
id

string

Identificador de recurso del punto de conexión privado.

PrivateEndpointProvisioningState

Estado de la conexión del punto de conexión privado.

Nombre Tipo Description
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

Las acciones necesarias para la conexión del servicio Private Link.

Nombre Tipo Description
None

string

PrivateLinkServiceConnectionStateStatus

Estado de conexión del servicio Private Link.

Nombre Tipo Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PublicNetworkAccessEnum

Si se permite o no el acceso a la red pública para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

Nombre Tipo Description
Disabled

string

Enabled

string

Server

Representa un servidor.

Nombre Tipo Description
id

string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Ubicación geográfica donde reside el recurso

name

string

Nombre del recurso.

properties.administratorLogin

string

Nombre de inicio de sesión del administrador de un servidor. Solo se puede especificar cuando se crea el servidor (y es necesario para la creación).

properties.earliestRestoreDate

string

Hora de creación del punto de restauración más temprana (ISO8601 formato)

properties.fullyQualifiedDomainName

string

Nombre de dominio completo de un servidor.

properties.masterServerId

string

Identificador del servidor maestro de un servidor de réplica.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Aplique una versión mínima de Tls para el servidor.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lista de conexiones de punto de conexión privado en un servidor

properties.publicNetworkAccess

PublicNetworkAccessEnum

Si se permite o no el acceso a la red pública para este servidor. El valor es opcional, pero si se pasa, debe ser "Habilitado" o "Deshabilitado".

properties.replicaCapacity

integer

Número máximo de réplicas que puede tener un servidor maestro.

properties.replicationRole

string

Rol de replicación del servidor.

properties.sslEnforcement

SslEnforcementEnum

Habilite la aplicación ssl o no cuando se conecte al servidor.

properties.storageProfile

StorageProfile

Perfil de almacenamiento de un servidor.

properties.userVisibleState

ServerState

Estado de un servidor que es visible para el usuario.

properties.version

ServerVersion

Versión del servidor.

sku

Sku

SKU (plan de tarifa) del servidor.

tags

object

Etiquetas del recurso.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ServerForCreate

Los parámetros necesarios para crear o actualizar un servidor.

Nombre Tipo Description
location

string

Ubicación en la que reside el recurso.

properties

ServerPropertiesForCreate

Propiedades del servidor.

sku

Sku

SKU (plan de tarifa) del servidor.

tags

object

Metadatos específicos de la aplicación en forma de pares clave-valor.

ServerPrivateEndpointConnection

Lista de conexiones de punto de conexión privado en un servidor

Nombre Tipo Description
id

string

Identificador de recurso de la conexión de punto de conexión privado.

properties

ServerPrivateEndpointConnectionProperties

Propiedades de conexión de punto de conexión privado

ServerPrivateEndpointConnectionProperties

Propiedades de conexión de punto de conexión privado

Nombre Tipo Description
privateEndpoint

PrivateEndpointProperty

Punto de conexión privado al que pertenece la conexión.

privateLinkServiceConnectionState

ServerPrivateLinkServiceConnectionStateProperty

Estado de conexión de la conexión del punto de conexión privado.

provisioningState

PrivateEndpointProvisioningState

Estado de la conexión del punto de conexión privado.

ServerPrivateLinkServiceConnectionStateProperty

Estado de conexión de la conexión del punto de conexión privado.

Nombre Tipo Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

Las acciones necesarias para la conexión del servicio Private Link.

description

string

Descripción de la conexión del servicio Private Link.

status

PrivateLinkServiceConnectionStateStatus

Estado de conexión del servicio Private Link.

ServerState

Estado de un servidor que es visible para el usuario.

Nombre Tipo Description
Disabled

string

Dropping

string

Ready

string

ServerVersion

Versión del servidor.

Nombre Tipo Description
10.2

string

10.3

string

Sku

SKU (plan de tarifa) del servidor.

Nombre Tipo Description
capacity

integer

La capacidad de escalado vertical o horizontal, que representa las unidades de proceso del servidor.

family

string

Familia de hardware.

name

string

Nombre de la SKU, normalmente, nivel + familia + núcleos, por ejemplo, B_Gen4_1, GP_Gen5_8.

size

string

El código de tamaño, que el recurso interpretará según corresponda.

tier

SkuTier

El nivel de la SKU determinada, por ejemplo, Básico.

SkuTier

El nivel de la SKU determinada, por ejemplo, Básico.

Nombre Tipo Description
Basic

string

GeneralPurpose

string

MemoryOptimized

string

SslEnforcementEnum

Habilite la aplicación ssl o no cuando se conecte al servidor.

Nombre Tipo Description
Disabled

string

Enabled

string

StorageAutogrow

Habilite El crecimiento automático del almacenamiento.

Nombre Tipo Description
Disabled

string

Enabled

string

StorageProfile

Perfil de almacenamiento de un servidor.

Nombre Tipo Description
backupRetentionDays

integer

Días de retención de copia de seguridad para el servidor.

geoRedundantBackup

GeoRedundantBackup

Habilite la redundancia geográfica o no para la copia de seguridad del servidor.

storageAutogrow

StorageAutogrow

Habilite El crecimiento automático del almacenamiento.

storageMB

integer

Almacenamiento máximo permitido para un servidor.