Servers - Create

Cria um novo servidor ou atualiza um servidor existente. A ação de atualização substituirá o servidor existente.

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

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.

serverName
path True

string

O nome do servidor.

subscriptionId
path True

string

O ID da subscrição de destino.

api-version
query True

string

A versão da API a utilizar para esta operação.

Corpo do Pedido

Name Tipo Description
parameters

ServerForCreate

Os parâmetros necessários para criar ou atualizar um servidor.

Respostas

Name Tipo Description
200 OK

Server

OK

201 Created

Server

Criado

202 Accepted

Aceite

Other Status Codes

CloudError

Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Scopes

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

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"
  }
}

Definições

Name Description
CloudError

Uma resposta de erro do serviço Batch.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorResponse

Resposta a Erros

GeoRedundantBackup

Ative Georredundante ou não para cópia de segurança do servidor.

MinimalTlsVersionEnum

Impor uma versão mínima do TLS para o servidor.

PrivateEndpointProperty

Ponto final privado ao qual pertence a ligação.

PrivateEndpointProvisioningState

Estado da ligação de ponto final privado.

PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a ligação do serviço de ligação privada.

PrivateLinkServiceConnectionStateStatus

O estado da ligação do serviço de ligação privada.

PublicNetworkAccessEnum

Se o acesso à rede pública é ou não permitido para este servidor. O valor é opcional, mas, se for transmitido, tem de ser "Ativado" ou "Desativado"

Server

Representa um servidor.

ServerForCreate

Os parâmetros necessários para criar ou atualizar um servidor.

ServerPrivateEndpointConnection

Lista de ligações de ponto final privado num servidor

ServerPrivateEndpointConnectionProperties

Propriedades de ligação de ponto final privado

ServerPrivateLinkServiceConnectionStateProperty

Estado de ligação da ligação do ponto final privado.

ServerState

Um estado de um servidor que é visível para o utilizador.

ServerVersion

Versão do servidor.

Sku

O SKU (escalão de preço) do servidor.

SkuTier

O escalão do SKU específico, por exemplo, Básico.

SslEnforcementEnum

Ative a imposição de ssl ou não quando ligar ao servidor.

StorageAutogrow

Ativar o Aumento Automático do Armazenamento.

StorageProfile

Perfil de armazenamento de um servidor.

CloudError

Uma resposta de erro do serviço Batch.

Name Tipo Description
error

ErrorResponse

Resposta a Erros
Mensagem de erro

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informações adicionais.

ErrorResponse

Resposta a Erros

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorResponse[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

GeoRedundantBackup

Ative Georredundante ou não para cópia de segurança do servidor.

Name Tipo Description
Disabled

string

Enabled

string

MinimalTlsVersionEnum

Impor uma versão mínima do TLS para o servidor.

Name Tipo Description
TLS1_0

string

TLS1_1

string

TLS1_2

string

TLSEnforcementDisabled

string

PrivateEndpointProperty

Ponto final privado ao qual pertence a ligação.

Name Tipo Description
id

string

ID do recurso do ponto final privado.

PrivateEndpointProvisioningState

Estado da ligação de ponto final privado.

Name Tipo Description
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a ligação do serviço de ligação privada.

Name Tipo Description
None

string

PrivateLinkServiceConnectionStateStatus

O estado da ligação do serviço de ligação privada.

Name Tipo Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PublicNetworkAccessEnum

Se o acesso à rede pública é ou não permitido para este servidor. O valor é opcional, mas, se for transmitido, tem de ser "Ativado" ou "Desativado"

Name Tipo Description
Disabled

string

Enabled

string

Server

Representa um servidor.

Name Tipo Description
id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

A localização geográfica onde reside o recurso

name

string

O nome do recurso

properties.administratorLogin

string

O nome de início de sessão do administrador de um servidor. Só pode ser especificado quando o servidor está a ser criado (e é necessário para a criação).

properties.earliestRestoreDate

string

Hora de criação do ponto de restauro mais antigo (formato ISO8601)

properties.fullyQualifiedDomainName

string

O nome de domínio completamente qualificado de um servidor.

properties.masterServerId

string

O ID do servidor mestre de um servidor de réplica.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Impor uma versão mínima do TLS para o servidor.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lista de ligações de ponto final privado num servidor

properties.publicNetworkAccess

PublicNetworkAccessEnum

Se o acesso à rede pública é ou não permitido para este servidor. O valor é opcional, mas, se for transmitido, tem de ser "Ativado" ou "Desativado"

properties.replicaCapacity

integer

O número máximo de réplicas que um servidor mestre pode ter.

properties.replicationRole

string

A função de replicação do servidor.

properties.sslEnforcement

SslEnforcementEnum

Ative a imposição de ssl ou não quando ligar ao servidor.

properties.storageProfile

StorageProfile

Perfil de armazenamento de um servidor.

properties.userVisibleState

ServerState

Um estado de um servidor que é visível para o utilizador.

properties.version

ServerVersion

Versão do servidor.

sku

Sku

O SKU (escalão de preço) do servidor.

tags

object

Etiquetas de recursos.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ServerForCreate

Os parâmetros necessários para criar ou atualizar um servidor.

Name Tipo Description
location

string

A localização onde o recurso reside.

properties

ServerPropertiesForCreate

Propriedades do servidor.

sku

Sku

O SKU (escalão de preço) do servidor.

tags

object

Metadados específicos da aplicação sob a forma de pares chave-valor.

ServerPrivateEndpointConnection

Lista de ligações de ponto final privado num servidor

Name Tipo Description
id

string

ID do recurso da ligação de ponto final privado.

properties

ServerPrivateEndpointConnectionProperties

Propriedades de ligação de ponto final privado

ServerPrivateEndpointConnectionProperties

Propriedades de ligação de ponto final privado

Name Tipo Description
privateEndpoint

PrivateEndpointProperty

Ponto final privado ao qual pertence a ligação.

privateLinkServiceConnectionState

ServerPrivateLinkServiceConnectionStateProperty

Estado de ligação da ligação do ponto final privado.

provisioningState

PrivateEndpointProvisioningState

Estado da ligação de ponto final privado.

ServerPrivateLinkServiceConnectionStateProperty

Estado de ligação da ligação do ponto final privado.

Name Tipo Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

As ações necessárias para a ligação do serviço de ligação privada.

description

string

A descrição da ligação do serviço de ligação privada.

status

PrivateLinkServiceConnectionStateStatus

O estado da ligação do serviço de ligação privada.

ServerState

Um estado de um servidor que é visível para o utilizador.

Name Tipo Description
Disabled

string

Dropping

string

Ready

string

ServerVersion

Versão do servidor.

Name Tipo Description
10.2

string

10.3

string

Sku

O SKU (escalão de preço) do servidor.

Name Tipo Description
capacity

integer

A capacidade de aumento/aumento vertical, que representa as unidades de computação do servidor.

family

string

A família de hardware.

name

string

O nome do sku, normalmente, camada + família + núcleos, por exemplo, B_Gen4_1, GP_Gen5_8.

size

string

O código de tamanho, a ser interpretado pelo recurso conforme adequado.

tier

SkuTier

O escalão do SKU específico, por exemplo, Básico.

SkuTier

O escalão do SKU específico, por exemplo, Básico.

Name Tipo Description
Basic

string

GeneralPurpose

string

MemoryOptimized

string

SslEnforcementEnum

Ative a imposição de ssl ou não quando ligar ao servidor.

Name Tipo Description
Disabled

string

Enabled

string

StorageAutogrow

Ativar o Aumento Automático do Armazenamento.

Name Tipo Description
Disabled

string

Enabled

string

StorageProfile

Perfil de armazenamento de um servidor.

Name Tipo Description
backupRetentionDays

integer

Dias de retenção da cópia de segurança para o servidor.

geoRedundantBackup

GeoRedundantBackup

Ative Georredundante ou não para cópia de segurança do servidor.

storageAutogrow

StorageAutogrow

Ativar o Aumento Automático do Armazenamento.

storageMB

integer

Armazenamento máximo permitido para um servidor.