Servers - Create

Vytvoří nový server nebo aktualizuje existující server. Akce aktualizace přepíše existující server.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
resourceGroupName
path True

string

Název skupiny prostředků. V názvu se rozlišují malá a velká písmena.

serverName
path True

string

Název serveru.

subscriptionId
path True

string

ID cílového předplatného.

api-version
query True

string

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name Typ Description
parameters

ServerForCreate

Požadované parametry pro vytvoření nebo aktualizaci serveru.

Odpovědi

Name Typ Description
200 OK

Server

OK

201 Created

Server

Vytvořeno

202 Accepted

Přijato

Other Status Codes

CloudError

Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

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

Scopes

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

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

Definice

Name Description
CloudError

Chybová odpověď ze služby Batch.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorResponse

Odpověď na chybu

GeoRedundantBackup

Povolte geograficky redundantní zálohování serveru nebo ne.

MinimalTlsVersionEnum

Vynucujte minimální verzi protokolu TLS pro server.

PrivateEndpointProperty

Privátní koncový bod, ke kterému připojení patří.

PrivateEndpointProvisioningState

Stav připojení privátního koncového bodu

PrivateLinkServiceConnectionStateActionsRequire

Akce vyžadované pro připojení služby Private Link.

PrivateLinkServiceConnectionStateStatus

Stav připojení služby Private Link.

PublicNetworkAccessEnum

Určuje, jestli je pro tento server povolený veřejný síťový přístup. Hodnota je nepovinná, ale pokud je předána, musí být Povolená nebo Zakázaná.

Server

Představuje server.

ServerForCreate

Požadované parametry pro vytvoření nebo aktualizaci serveru.

ServerPrivateEndpointConnection

Seznam připojení privátních koncových bodů na serveru

ServerPrivateEndpointConnectionProperties

Vlastnosti připojení privátního koncového bodu

ServerPrivateLinkServiceConnectionStateProperty

Stav připojení privátního koncového bodu.

ServerState

Stav serveru, který je viditelný pro uživatele.

ServerVersion

Verze serveru.

Sku

Skladová položka (cenová úroveň) serveru.

SkuTier

Úroveň konkrétní skladové položky, například Basic.

SslEnforcementEnum

Povolte vynucování ssl nebo ne, když se připojujete k serveru.

StorageAutogrow

Povolte automatické zvětšování úložiště.

StorageProfile

Profil úložiště serveru.

CloudError

Chybová odpověď ze služby Batch.

Name Typ Description
error

ErrorResponse

Odpověď na chybu
Chybová zpráva

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Typ další informace.

ErrorResponse

Odpověď na chybu

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby

details

ErrorResponse[]

Podrobnosti o chybě.

message

string

Chybová zpráva

target

string

Cíl chyby.

GeoRedundantBackup

Povolte geograficky redundantní zálohování serveru nebo ne.

Name Typ Description
Disabled

string

Enabled

string

MinimalTlsVersionEnum

Vynucujte minimální verzi protokolu TLS pro server.

Name Typ Description
TLS1_0

string

TLS1_1

string

TLS1_2

string

TLSEnforcementDisabled

string

PrivateEndpointProperty

Privátní koncový bod, ke kterému připojení patří.

Name Typ Description
id

string

ID prostředku privátního koncového bodu

PrivateEndpointProvisioningState

Stav připojení privátního koncového bodu

Name Typ Description
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

Akce vyžadované pro připojení služby Private Link.

Name Typ Description
None

string

PrivateLinkServiceConnectionStateStatus

Stav připojení služby Private Link.

Name Typ Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PublicNetworkAccessEnum

Určuje, jestli je pro tento server povolený veřejný síťový přístup. Hodnota je nepovinná, ale pokud je předána, musí být Povolená nebo Zakázaná.

Name Typ Description
Disabled

string

Enabled

string

Server

Představuje server.

Name Typ Description
id

string

Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku}

location

string

Geografické umístění, kde se prostředek nachází

name

string

Název prostředku

properties.administratorLogin

string

Přihlašovací jméno správce serveru. Lze zadat pouze při vytváření serveru (a vyžaduje se k vytvoření).

properties.earliestRestoreDate

string

Nejstarší čas vytvoření bodu obnovení (formát ISO8601)

properties.fullyQualifiedDomainName

string

Plně kvalifikovaný název domény serveru.

properties.masterServerId

string

ID hlavního serveru serveru repliky.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Vynucujte minimální verzi protokolu TLS pro server.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Seznam připojení privátních koncových bodů na serveru

properties.publicNetworkAccess

PublicNetworkAccessEnum

Určuje, jestli je pro tento server povolený veřejný síťový přístup. Hodnota je nepovinná, ale pokud je předána, musí být Povolená nebo Zakázaná.

properties.replicaCapacity

integer

Maximální počet replik, které může mít hlavní server.

properties.replicationRole

string

Role replikace serveru.

properties.sslEnforcement

SslEnforcementEnum

Povolte vynucování ssl nebo ne, když se připojujete k serveru.

properties.storageProfile

StorageProfile

Profil úložiště serveru.

properties.userVisibleState

ServerState

Stav serveru, který je viditelný pro uživatele.

properties.version

ServerVersion

Verze serveru.

sku

Sku

Skladová položka (cenová úroveň) serveru.

tags

object

Značky prostředků.

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

ServerForCreate

Požadované parametry pro vytvoření nebo aktualizaci serveru.

Name Typ Description
location

string

Umístění, ve kterém se prostředek nachází.

properties

ServerPropertiesForCreate

Vlastnosti serveru.

sku

Sku

Skladová položka (cenová úroveň) serveru.

tags

object

Metadata specifická pro aplikaci ve formě párů klíč-hodnota.

ServerPrivateEndpointConnection

Seznam připojení privátních koncových bodů na serveru

Name Typ Description
id

string

ID prostředku připojení privátního koncového bodu.

properties

ServerPrivateEndpointConnectionProperties

Vlastnosti připojení privátního koncového bodu

ServerPrivateEndpointConnectionProperties

Vlastnosti připojení privátního koncového bodu

Name Typ Description
privateEndpoint

PrivateEndpointProperty

Privátní koncový bod, ke kterému připojení patří.

privateLinkServiceConnectionState

ServerPrivateLinkServiceConnectionStateProperty

Stav připojení privátního koncového bodu.

provisioningState

PrivateEndpointProvisioningState

Stav připojení privátního koncového bodu

ServerPrivateLinkServiceConnectionStateProperty

Stav připojení privátního koncového bodu.

Name Typ Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

Akce vyžadované pro připojení služby Private Link.

description

string

Popis připojení služby Private Link.

status

PrivateLinkServiceConnectionStateStatus

Stav připojení služby Private Link.

ServerState

Stav serveru, který je viditelný pro uživatele.

Name Typ Description
Disabled

string

Dropping

string

Ready

string

ServerVersion

Verze serveru.

Name Typ Description
10.2

string

10.3

string

Sku

Skladová položka (cenová úroveň) serveru.

Name Typ Description
capacity

integer

Kapacita vertikálního navýšení/snížení kapacity představující výpočetní jednotky serveru.

family

string

Rodina hardwaru.

name

string

Název skladové položky, obvykle vrstva + rodina + jádra, například B_Gen4_1, GP_Gen5_8.

size

string

Kód velikosti, který bude odpovídajícím způsobem interpretován prostředkem.

tier

SkuTier

Úroveň konkrétní skladové položky, například Basic.

SkuTier

Úroveň konkrétní skladové položky, například Basic.

Name Typ Description
Basic

string

GeneralPurpose

string

MemoryOptimized

string

SslEnforcementEnum

Povolte vynucování ssl nebo ne, když se připojujete k serveru.

Name Typ Description
Disabled

string

Enabled

string

StorageAutogrow

Povolte automatické zvětšování úložiště.

Name Typ Description
Disabled

string

Enabled

string

StorageProfile

Profil úložiště serveru.

Name Typ Description
backupRetentionDays

integer

Dny uchovávání záloh pro server.

geoRedundantBackup

GeoRedundantBackup

Povolte geograficky redundantní zálohování serveru nebo ne.

storageAutogrow

StorageAutogrow

Povolte automatické zvětšování úložiště.

storageMB

integer

Maximální povolené úložiště pro server