다음을 통해 공유


Servers - Create

새 서버를 만들거나 기존 서버를 업데이트합니다. 업데이트 작업은 기존 서버를 덮어씁 수 있습니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
resourceGroupName
path True

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

serverName
path True

string

서버의 이름입니다.

subscriptionId
path True

string

대상 구독의 ID입니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

요청 본문

Name 형식 Description
parameters

ServerForCreate

서버를 만들거나 업데이트하는 데 필요한 매개 변수입니다.

응답

Name 형식 Description
200 OK

Server

정상

201 Created

Server

생성일

202 Accepted

수락됨

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

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

샘플 요청

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

샘플 응답

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

샘플 요청

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

샘플 응답

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

샘플 요청

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

샘플 응답

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

샘플 요청

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

샘플 응답

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

정의

Name Description
CloudError

Batch 서비스의 오류 응답입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorResponse

오류 응답

GeoRedundantBackup

서버 백업에 지역 중복 여부를 사용하도록 설정합니다.

MinimalTlsVersionEnum

서버에 최소 Tls 버전을 적용합니다.

PrivateEndpointProperty

연결이 속한 프라이빗 엔드포인트입니다.

PrivateEndpointProvisioningState

프라이빗 엔드포인트 연결의 상태입니다.

PrivateLinkServiceConnectionStateActionsRequire

프라이빗 링크 서비스 연결에 필요한 작업입니다.

PrivateLinkServiceConnectionStateStatus

프라이빗 링크 서비스 연결 상태.

PublicNetworkAccessEnum

이 서버에 대한 공용 네트워크 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.

Server

서버를 나타냅니다.

ServerForCreate

서버를 만들거나 업데이트하는 데 필요한 매개 변수입니다.

ServerPrivateEndpointConnection

서버의 프라이빗 엔드포인트 연결 목록

ServerPrivateEndpointConnectionProperties

프라이빗 엔드포인트 연결 속성

ServerPrivateLinkServiceConnectionStateProperty

프라이빗 엔드포인트 연결의 연결 상태입니다.

ServerState

사용자에게 표시되는 서버의 상태입니다.

ServerVersion

서버 버전입니다.

Sku

서버의 SKU(가격 책정 계층)입니다.

SkuTier

특정 SKU의 계층(예: 기본)입니다.

SslEnforcementEnum

서버에 연결할 때 ssl 적용을 사용하도록 설정합니다.

StorageAutogrow

스토리지 자동 증가를 사용하도록 설정합니다.

StorageProfile

서버의 스토리지 프로필입니다.

CloudError

Batch 서비스의 오류 응답입니다.

Name 형식 Description
error

ErrorResponse

오류 응답
오류 메시지

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorResponse

오류 응답

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorResponse[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

GeoRedundantBackup

서버 백업에 지역 중복 여부를 사용하도록 설정합니다.

Name 형식 Description
Disabled

string

Enabled

string

MinimalTlsVersionEnum

서버에 최소 Tls 버전을 적용합니다.

Name 형식 Description
TLS1_0

string

TLS1_1

string

TLS1_2

string

TLSEnforcementDisabled

string

PrivateEndpointProperty

연결이 속한 프라이빗 엔드포인트입니다.

Name 형식 Description
id

string

프라이빗 엔드포인트의 리소스 ID입니다.

PrivateEndpointProvisioningState

프라이빗 엔드포인트 연결의 상태입니다.

Name 형식 Description
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

프라이빗 링크 서비스 연결에 필요한 작업입니다.

Name 형식 Description
None

string

PrivateLinkServiceConnectionStateStatus

프라이빗 링크 서비스 연결 상태.

Name 형식 Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PublicNetworkAccessEnum

이 서버에 대한 공용 네트워크 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.

Name 형식 Description
Disabled

string

Enabled

string

Server

서버를 나타냅니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

리소스가 있는 지리적 위치

name

string

리소스의 이름입니다.

properties.administratorLogin

string

서버의 관리자 로그인 이름입니다. 서버를 만들 때만 지정할 수 있습니다(만들기에 필요).

properties.earliestRestoreDate

string

가장 빠른 복원 지점 생성 시간(ISO8601 형식)

properties.fullyQualifiedDomainName

string

서버의 정규화된 도메인 이름입니다.

properties.masterServerId

string

복제본(replica) 서버의 master 서버 ID입니다.

properties.minimalTlsVersion

MinimalTlsVersionEnum

서버에 최소 Tls 버전을 적용합니다.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

서버의 프라이빗 엔드포인트 연결 목록

properties.publicNetworkAccess

PublicNetworkAccessEnum

이 서버에 대한 공용 네트워크 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.

properties.replicaCapacity

integer

master 서버에 있을 수 있는 최대 복제본 수입니다.

properties.replicationRole

string

서버의 복제 역할입니다.

properties.sslEnforcement

SslEnforcementEnum

서버에 연결할 때 ssl 적용을 사용하도록 설정합니다.

properties.storageProfile

StorageProfile

서버의 스토리지 프로필입니다.

properties.userVisibleState

ServerState

사용자에게 표시되는 서버의 상태입니다.

properties.version

ServerVersion

서버 버전입니다.

sku

Sku

서버의 SKU(가격 책정 계층)입니다.

tags

object

리소스 태그.

type

string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

ServerForCreate

서버를 만들거나 업데이트하는 데 필요한 매개 변수입니다.

Name 형식 Description
location

string

리소스가 있는 위치입니다.

properties

ServerPropertiesForCreate

서버의 속성입니다.

sku

Sku

서버의 SKU(가격 책정 계층)입니다.

tags

object

키-값 쌍 형태의 애플리케이션별 메타데이터입니다.

ServerPrivateEndpointConnection

서버의 프라이빗 엔드포인트 연결 목록

Name 형식 Description
id

string

프라이빗 엔드포인트 연결의 리소스 ID입니다.

properties

ServerPrivateEndpointConnectionProperties

프라이빗 엔드포인트 연결 속성

ServerPrivateEndpointConnectionProperties

프라이빗 엔드포인트 연결 속성

Name 형식 Description
privateEndpoint

PrivateEndpointProperty

연결이 속한 프라이빗 엔드포인트입니다.

privateLinkServiceConnectionState

ServerPrivateLinkServiceConnectionStateProperty

프라이빗 엔드포인트 연결의 연결 상태입니다.

provisioningState

PrivateEndpointProvisioningState

프라이빗 엔드포인트 연결의 상태입니다.

ServerPrivateLinkServiceConnectionStateProperty

프라이빗 엔드포인트 연결의 연결 상태입니다.

Name 형식 Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

프라이빗 링크 서비스 연결에 필요한 작업입니다.

description

string

프라이빗 링크 서비스 연결 설명입니다.

status

PrivateLinkServiceConnectionStateStatus

프라이빗 링크 서비스 연결 상태.

ServerState

사용자에게 표시되는 서버의 상태입니다.

Name 형식 Description
Disabled

string

Dropping

string

Ready

string

ServerVersion

서버 버전입니다.

Name 형식 Description
10.2

string

10.3

string

Sku

서버의 SKU(가격 책정 계층)입니다.

Name 형식 Description
capacity

integer

서버의 컴퓨팅 단위를 나타내는 스케일 업/아웃 용량입니다.

family

string

하드웨어 제품군입니다.

name

string

sku의 이름(일반적으로 계층 + 제품군 + 코어)(예: B_Gen4_1) GP_Gen5_8.

size

string

리소스에서 적절하게 해석할 크기 코드입니다.

tier

SkuTier

특정 SKU의 계층(예: 기본)입니다.

SkuTier

특정 SKU의 계층(예: 기본)입니다.

Name 형식 Description
Basic

string

GeneralPurpose

string

MemoryOptimized

string

SslEnforcementEnum

서버에 연결할 때 ssl 적용을 사용하도록 설정합니다.

Name 형식 Description
Disabled

string

Enabled

string

StorageAutogrow

스토리지 자동 증가를 사용하도록 설정합니다.

Name 형식 Description
Disabled

string

Enabled

string

StorageProfile

서버의 스토리지 프로필입니다.

Name 형식 Description
backupRetentionDays

integer

서버에 대한 백업 보존 일수입니다.

geoRedundantBackup

GeoRedundantBackup

서버 백업에 지역 중복 여부를 사용하도록 설정합니다.

storageAutogrow

StorageAutogrow

스토리지 자동 증가를 사용하도록 설정합니다.

storageMB

integer

서버에 허용되는 최대 스토리지입니다.