Dela via


Servers - Create

Skapar en ny server eller uppdaterar en befintlig server. Uppdateringsåtgärden skriver över den befintliga servern.

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

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

serverName
path True

string

Namnet på servern.

subscriptionId
path True

string

ID för målprenumerationen.

api-version
query True

string

Den API-version som ska användas för den här åtgärden.

Begärandetext

Name Typ Description
parameters

ServerForCreate

Nödvändiga parametrar för att skapa eller uppdatera en server.

Svar

Name Typ Description
200 OK

Server

OK

201 Created

Server

Skapad

202 Accepted

Har godkänts

Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

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

Definitioner

Name Description
CloudError

Ett felsvar från Batch-tjänsten.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorResponse

Felsvar

GeoRedundantBackup

Aktivera geo-redundant eller inte för serversäkerhetskopiering.

MinimalTlsVersionEnum

Framtvinga en minimal TLS-version för servern.

PrivateEndpointProperty

Privat slutpunkt som anslutningen tillhör.

PrivateEndpointProvisioningState

Tillstånd för den privata slutpunktsanslutningen.

PrivateLinkServiceConnectionStateActionsRequire

De åtgärder som krävs för privat länktjänstanslutning.

PrivateLinkServiceConnectionStateStatus

Anslutningsstatus för tjänsten Private Link.

PublicNetworkAccessEnum

Om offentlig nätverksåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat

Server

Representerar en server.

ServerForCreate

Nödvändiga parametrar för att skapa eller uppdatera en server.

ServerPrivateEndpointConnection

Lista över privata slutpunktsanslutningar på en server

ServerPrivateEndpointConnectionProperties

Egenskaper för privat slutpunktsanslutning

ServerPrivateLinkServiceConnectionStateProperty

Anslutningstillstånd för den privata slutpunktsanslutningen.

ServerState

Ett tillstånd för en server som är synlig för användaren.

ServerVersion

Serverversion.

Sku

Serverns SKU (prisnivå).

SkuTier

Nivån för den specifika SKU:n, t.ex. Basic.

SslEnforcementEnum

Aktivera ssl-tillämpning eller inte när du ansluter till servern.

StorageAutogrow

Aktivera Automatisk ökning av lagring.

StorageProfile

Lagringsprofil för en server.

CloudError

Ett felsvar från Batch-tjänsten.

Name Typ Description
error

ErrorResponse

Felsvar
Felmeddelande

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Den ytterligare informationen.

type

string

Ytterligare informationstyp.

ErrorResponse

Felsvar

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorResponse[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

GeoRedundantBackup

Aktivera geo-redundant eller inte för serversäkerhetskopiering.

Name Typ Description
Disabled

string

Enabled

string

MinimalTlsVersionEnum

Framtvinga en minimal TLS-version för servern.

Name Typ Description
TLS1_0

string

TLS1_1

string

TLS1_2

string

TLSEnforcementDisabled

string

PrivateEndpointProperty

Privat slutpunkt som anslutningen tillhör.

Name Typ Description
id

string

Resurs-ID för den privata slutpunkten.

PrivateEndpointProvisioningState

Tillstånd för den privata slutpunktsanslutningen.

Name Typ Description
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

De åtgärder som krävs för privat länktjänstanslutning.

Name Typ Description
None

string

PrivateLinkServiceConnectionStateStatus

Anslutningsstatus för tjänsten Private Link.

Name Typ Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PublicNetworkAccessEnum

Om offentlig nätverksåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat

Name Typ Description
Disabled

string

Enabled

string

Server

Representerar en server.

Name Typ Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Exempel – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Den geo-plats där resursen finns

name

string

Namnet på resursen

properties.administratorLogin

string

Administratörens inloggningsnamn för en server. Kan bara anges när servern skapas (och krävs för att skapa).

properties.earliestRestoreDate

string

Tidigaste skapandetid för återställningspunkt (ISO8601 format)

properties.fullyQualifiedDomainName

string

Det fullständigt kvalificerade domännamnet för en server.

properties.masterServerId

string

Huvudserver-ID för en replikserver.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Framtvinga en minimal TLS-version för servern.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lista över privata slutpunktsanslutningar på en server

properties.publicNetworkAccess

PublicNetworkAccessEnum

Om offentlig nätverksåtkomst tillåts för den här servern eller inte. Värdet är valfritt, men om det skickas måste det vara Aktiverat eller Inaktiverat

properties.replicaCapacity

integer

Det maximala antalet repliker som en huvudserver kan ha.

properties.replicationRole

string

Serverns replikeringsroll.

properties.sslEnforcement

SslEnforcementEnum

Aktivera ssl-tillämpning eller inte när du ansluter till servern.

properties.storageProfile

StorageProfile

Lagringsprofil för en server.

properties.userVisibleState

ServerState

Ett tillstånd för en server som är synlig för användaren.

properties.version

ServerVersion

Serverversion.

sku

Sku

Serverns SKU (prisnivå).

tags

object

Resurstaggar.

type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

ServerForCreate

Nödvändiga parametrar för att skapa eller uppdatera en server.

Name Typ Description
location

string

Den plats som resursen finns på.

properties

ServerPropertiesForCreate

Egenskaper för servern.

sku

Sku

Serverns SKU (prisnivå).

tags

object

Programspecifika metadata i form av nyckel/värde-par.

ServerPrivateEndpointConnection

Lista över privata slutpunktsanslutningar på en server

Name Typ Description
id

string

Resurs-ID för den privata slutpunktsanslutningen.

properties

ServerPrivateEndpointConnectionProperties

Egenskaper för privat slutpunktsanslutning

ServerPrivateEndpointConnectionProperties

Egenskaper för privat slutpunktsanslutning

Name Typ Description
privateEndpoint

PrivateEndpointProperty

Privat slutpunkt som anslutningen tillhör.

privateLinkServiceConnectionState

ServerPrivateLinkServiceConnectionStateProperty

Anslutningstillstånd för den privata slutpunktsanslutningen.

provisioningState

PrivateEndpointProvisioningState

Tillstånd för den privata slutpunktsanslutningen.

ServerPrivateLinkServiceConnectionStateProperty

Anslutningstillstånd för den privata slutpunktsanslutningen.

Name Typ Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

De åtgärder som krävs för privat länktjänstanslutning.

description

string

Beskrivning av tjänstanslutningen för privat länk.

status

PrivateLinkServiceConnectionStateStatus

Anslutningsstatus för tjänsten Private Link.

ServerState

Ett tillstånd för en server som är synlig för användaren.

Name Typ Description
Disabled

string

Dropping

string

Ready

string

ServerVersion

Serverversion.

Name Typ Description
10.2

string

10.3

string

Sku

Serverns SKU (prisnivå).

Name Typ Description
capacity

integer

Upp- och utskalningskapaciteten som representerar serverns beräkningsenheter.

family

string

Maskinvarufamiljen.

name

string

Namnet på SKU:n, vanligtvis nivå + familj + kärnor, t.ex. B_Gen4_1, GP_Gen5_8.

size

string

Storlekskoden som ska tolkas av resursen efter behov.

tier

SkuTier

Nivån för den specifika SKU:n, t.ex. Basic.

SkuTier

Nivån för den specifika SKU:n, t.ex. Basic.

Name Typ Description
Basic

string

GeneralPurpose

string

MemoryOptimized

string

SslEnforcementEnum

Aktivera ssl-tillämpning eller inte när du ansluter till servern.

Name Typ Description
Disabled

string

Enabled

string

StorageAutogrow

Aktivera Automatisk ökning av lagring.

Name Typ Description
Disabled

string

Enabled

string

StorageProfile

Lagringsprofil för en server.

Name Typ Description
backupRetentionDays

integer

Kvarhållningsdagar för säkerhetskopior för servern.

geoRedundantBackup

GeoRedundantBackup

Aktivera geo-redundant eller inte för serversäkerhetskopiering.

storageAutogrow

StorageAutogrow

Aktivera Automatisk ökning av lagring.

storageMB

integer

Maximalt antal tillåtna lagringsutrymmen för en server.