Servers - Create

Membuat server baru atau memperbarui server yang sudah ada. Tindakan pembaruan akan menimpa server yang ada.

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

Parameter URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API atau portal.

serverName
path True
  • string

Nama server.

subscriptionId
path True
  • string

ID langganan yang mengidentifikasi langganan Azure.

api-version
query True
  • string

Versi API yang digunakan untuk permintaan.

Isi Permintaan

Name Required Type Description
location True
  • string

Lokasi sumber daya berada.

properties True ServerPropertiesForCreate:

Properti server.

sku

SKU (tingkat harga) server.

tags
  • object

Metadata khusus aplikasi dalam bentuk pasangan kunci-nilai.

Respons

Name Type Description
200 OK

OK

201 Created

Dibuat

202 Accepted

Diterima

Keamanan

azure_auth

Azure Active Directory Flow OAuth2

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

Scopes

Name Description
user_impersonation meniru akun pengguna Anda

Contoh

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-preview

{
  "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-preview

{
  "location": "westus",
  "properties": {
    "administratorLogin": "cloudsa",
    "administratorLoginPassword": "<administratorLoginPassword>",
    "sslEnforcement": "Enabled",
    "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",
    "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-preview

{
  "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-preview

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

Definisi

GeoRedundantBackup

Aktifkan Geo-redundan atau tidak untuk pencadangan server.

IdentityType

Jenis identitas. Atur ini ke 'SystemAssigned' untuk membuat dan menetapkan prinsipal Azure Active Directory untuk sumber daya secara otomatis.

MinimalTlsVersionEnum

Terapkan versi Tls minimal untuk server.

ResourceIdentity

Azure Active Directory konfigurasi identitas untuk sumber daya.

Server

Mewakili server.

ServerForCreate

Mewakili server yang akan dibuat.

ServerPropertiesForDefaultCreate

Properti yang digunakan untuk membuat server baru.

ServerPropertiesForGeoRestore

Properti yang digunakan untuk membuat server baru dengan memulihkan ke wilayah yang berbeda dari cadangan yang direplikasi secara geografis.

ServerPropertiesForReplica

Properti untuk membuat replika baru.

ServerPropertiesForRestore

Properti yang digunakan untuk membuat server baru dengan memulihkan dari cadangan.

ServerState

Status server yang terlihat oleh pengguna.

ServerVersion

Versi server.

Sku

Properti terkait informasi penagihan server.

SkuTier

Tingkat SKU tertentu, misalnya Dasar.

SslEnforcementEnum

Aktifkan penegakan ssl atau tidak saat tersambung ke server.

StorageAutogrow

Aktifkan Storage Tumbuh Otomatis.

StorageProfile

Storage Properti profil server

GeoRedundantBackup

Aktifkan Geo-redundan atau tidak untuk pencadangan server.

Name Type Description
Disabled
  • string
Enabled
  • string

IdentityType

Jenis identitas. Atur ini ke 'SystemAssigned' untuk membuat dan menetapkan prinsipal Azure Active Directory untuk sumber daya secara otomatis.

Name Type Description
SystemAssigned
  • string

MinimalTlsVersionEnum

Terapkan versi Tls minimal untuk server.

Name Type Description
TLS1_0
  • string
TLS1_1
  • string
TLS1_2
  • string
TLSEnforcementDisabled
  • string

ResourceIdentity

Azure Active Directory konfigurasi identitas untuk sumber daya.

Name Type Description
principalId
  • string

Id utama Azure Active Directory.

tenantId
  • string

Id penyewa Azure Active Directory.

type

Jenis identitas. Atur ini ke 'SystemAssigned' untuk membuat dan menetapkan prinsipal Azure Active Directory untuk sumber daya secara otomatis.

Server

Mewakili server.

Name Type Description
id
  • string

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

Identitas Azure Active Directory server.

location
  • string

Lokasi geografis tempat sumber daya berada

name
  • string

Nama sumber daya.

properties.administratorLogin
  • string

Nama masuk administrator server. Hanya dapat ditentukan ketika server sedang dibuat (dan diperlukan untuk pembuatan).

properties.earliestRestoreDate
  • string

Waktu pembuatan titik pemulihan paling awal (format ISO8601)

properties.fullyQualifiedDomainName
  • string

Nama domain server yang sepenuhnya memenuhi syarat.

properties.masterServerId
  • string

Id server master dari server replika.

properties.minimalTlsVersion

Terapkan versi Tls minimal untuk server.

properties.replicaCapacity
  • integer

Jumlah maksimum replika yang dapat dimiliki server master.

properties.replicationRole
  • string

Peran replikasi server.

properties.sslEnforcement

Aktifkan penegakan ssl atau tidak saat tersambung ke server.

properties.storageProfile

Storage profil server.

properties.userVisibleState

Status server yang terlihat oleh pengguna.

properties.version

Versi server.

sku

SKU (tingkat harga) server.

tags
  • object

Tag sumber daya.

type
  • string

Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft. Storage/storageAccounts"

ServerForCreate

Mewakili server yang akan dibuat.

Name Type Description
location
  • string

Lokasi sumber daya berada.

properties ServerPropertiesForCreate:

Properti server.

sku

SKU (tingkat harga) server.

tags
  • object

Metadata khusus aplikasi dalam bentuk pasangan kunci-nilai.

ServerPropertiesForDefaultCreate

Properti yang digunakan untuk membuat server baru.

Name Type Description
administratorLogin
  • string

Nama masuk administrator server. Hanya dapat ditentukan ketika server sedang dibuat (dan diperlukan untuk pembuatan).

administratorLoginPassword
  • string

Kata sandi login administrator.

createMode string:
  • Default

Mode untuk membuat server baru.

minimalTlsVersion

Terapkan versi Tls minimal untuk server.

sslEnforcement

Aktifkan penegakan ssl atau tidak saat tersambung ke server.

storageProfile

Storage profil server.

version

Versi server.

ServerPropertiesForGeoRestore

Properti yang digunakan untuk membuat server baru dengan memulihkan ke wilayah yang berbeda dari cadangan yang direplikasi secara geografis.

Name Type Description
createMode string:
  • GeoRestore

Mode untuk membuat server baru.

minimalTlsVersion

Terapkan versi Tls minimal untuk server.

sourceServerId
  • string

Id server sumber untuk dipulihkan.

sslEnforcement

Aktifkan penegakan ssl atau tidak saat tersambung ke server.

storageProfile

Storage profil server.

version

Versi server.

ServerPropertiesForReplica

Properti untuk membuat replika baru.

Name Type Description
createMode string:
  • Replica

Mode untuk membuat server baru.

minimalTlsVersion

Terapkan versi Tls minimal untuk server.

sourceServerId
  • string

Id server master untuk membuat replika.

sslEnforcement

Aktifkan penegakan ssl atau tidak saat tersambung ke server.

storageProfile

Storage profil server.

version

Versi server.

ServerPropertiesForRestore

Properti yang digunakan untuk membuat server baru dengan memulihkan dari cadangan.

Name Type Description
createMode string:
  • PointInTimeRestore

Mode untuk membuat server baru.

minimalTlsVersion

Terapkan versi Tls minimal untuk server.

restorePointInTime
  • string

Waktu pembuatan titik pemulihan (format ISO8601), menentukan waktu untuk memulihkan.

sourceServerId
  • string

Id server sumber untuk dipulihkan.

sslEnforcement

Aktifkan penegakan ssl atau tidak saat tersambung ke server.

storageProfile

Storage profil server.

version

Versi server.

ServerState

Status server yang terlihat oleh pengguna.

Name Type Description
Disabled
  • string
Dropping
  • string
Ready
  • string

ServerVersion

Versi server.

Name Type Description
10.2
  • string
10.3
  • string

Sku

Properti terkait informasi penagihan server.

Name Type Description
capacity
  • integer

Kapasitas peningkatan/peluasan skala, mewakili unit komputasi server.

family
  • string

Keluarga perangkat keras.

name
  • string

Nama sku, biasanya, tingkat + keluarga + inti, misalnya B_Gen4_1, GP_Gen5_8.

size
  • string

Kode ukuran, yang akan ditafsirkan oleh sumber daya yang sesuai.

tier

Tingkat SKU tertentu, misalnya Dasar.

SkuTier

Tingkat SKU tertentu, misalnya Dasar.

Name Type Description
Basic
  • string
GeneralPurpose
  • string
MemoryOptimized
  • string

SslEnforcementEnum

Aktifkan penegakan ssl atau tidak saat tersambung ke server.

Name Type Description
Disabled
  • string
Enabled
  • string

StorageAutogrow

Aktifkan Storage Tumbuh Otomatis.

Name Type Description
Disabled
  • string
Enabled
  • string

StorageProfile

Storage Properti profil server

Name Type Description
backupRetentionDays
  • integer

Hari retensi cadangan untuk server.

geoRedundantBackup

Aktifkan Geo-redundan atau tidak untuk pencadangan server.

storageAutogrow

Aktifkan Storage Tumbuh Otomatis.

storageMB
  • integer

Penyimpanan maks yang diizinkan untuk server.