다음을 통해 공유


Servers - Detach V Net

서버에서 VNet을 분리합니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforMySQL/flexibleServers/{serverName}/detachVNet?api-version=2024-12-30

URI 매개 변수

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

string

minLength: 1
maxLength: 90

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

serverName
path True

string

minLength: 1
maxLength: 63
pattern: ^[a-z0-9][-a-z0-9]*(?

서버의 이름입니다.

subscriptionId
path True

string (uuid)

대상 구독의 ID입니다. 값은 UUID여야 합니다.

api-version
query True

string

minLength: 1

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

요청 본문

Name 형식 Description
publicNetworkAccess

EnableStatusEnum

이 서버에 대한 공용 네트워크 액세스가 허용되는지 여부입니다. 서버에 VNet 통합이 있는 경우 값은 '사용 안 함'입니다.

응답

Name 형식 Description
200 OK

Server

Azure 작업이 성공적으로 완료되었습니다.

202 Accepted

자원 작업이 허용되었습니다.

헤더

  • Azure-AsyncOperation: string
  • Location: string
Other Status Codes

ErrorResponse

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

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

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Detach VNet on a server

샘플 요청

POST https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/TestGroup/providers/Microsoft.DBforMySQL/flexibleServers/testserver/detachVNet?api-version=2024-12-30

{
  "publicNetworkAccess": "Enabled"
}

샘플 응답

{
  "name": "mysqltestserver",
  "type": "Microsoft.DBforMySQL/flexibleServers",
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforMySQL/flexibleServers/mysqltestserver",
  "location": "Southeast Asia",
  "properties": {
    "administratorLogin": "cloudsa",
    "availabilityZone": "3",
    "backup": {
      "backupIntervalHours": 24,
      "backupRetentionDays": 7,
      "earliestRestoreDate": "2021-06-17T06:11:38.4150019+00:00",
      "geoRedundantBackup": "Disabled"
    },
    "databasePort": 3306,
    "fullVersion": "5.7.44",
    "fullyQualifiedDomainName": "mysqltestserver.database.mysql.azure.com",
    "highAvailability": {
      "mode": "Disabled",
      "state": "NotEnabled"
    },
    "maintenancePolicy": {
      "patchStrategy": "Regular"
    },
    "maintenanceWindow": {
      "batchOfMaintenance": "Default",
      "customWindow": "Enabled",
      "dayOfWeek": 1,
      "startHour": 1,
      "startMinute": 0
    },
    "network": {
      "publicNetworkAccess": "Disabled"
    },
    "replicaCapacity": 10,
    "replicationRole": "None",
    "state": "Ready",
    "storage": {
      "autoGrow": "Disabled",
      "autoIoScaling": "Disabled",
      "iops": 200,
      "storageSizeGB": 30,
      "storageSku": "Premium_LRS"
    },
    "version": "5.7"
  },
  "sku": {
    "name": "Standard_D2ds_v4",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "num": "1"
  }
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforMySQL/locations/southeastasia/azureAsyncOperation/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-12-30
Location: https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/providers/Microsoft.DBforMySQL/locations/southeastasia/operationResults/e276a03a-1770-4549-86f5-0edffae8997c?api-version=2024-12-30

정의

Name Description
Backup

서버의 스토리지 프로필 속성

BatchOfMaintenance

사용하도록 설정된 경우 유지 관리의 일괄 처리: 서버의 사용자 지정 관리 유지 관리 기간입니다.

createdByType

리소스를 만든 ID의 형식입니다.

CreateMode

새 MySQL 서버를 만드는 모드입니다.

DataEncryption

cmk에 대한 날짜 암호화입니다.

DataEncryptionType

키 형식, cmk를 사용하도록 설정하기 위한 AzureKeyVault, cmk를 사용하지 않도록 설정하기 위한 SystemManaged입니다.

EnableStatusEnum

값이 'Enabled' 또는 'Disabled'인지 여부를 나타내는 열거형

ErrorAdditionalInfo

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

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

HighAvailability

서버의 고가용성 속성

HighAvailabilityMode

서버에 대한 고가용성 모드입니다.

HighAvailabilityState

서버 고가용성의 상태입니다.

ImportSourceProperties

원본 관련 속성을 가져옵니다.

ImportSourceStorageType

가져오기 원본의 스토리지 유형입니다.

MaintenancePolicy

서버의 유지 관리 정책입니다.

MaintenanceWindow

서버의 유지 관리 기간입니다.

ManagedServiceIdentityType

관리 서비스 ID의 유형입니다.

MySQLServerIdentity

Bring Your Own Keys에 대한 ID를 구성하는 속성

MySQLServerSku

서버의 청구 정보 관련 속성입니다.

Network

서버의 네트워크 관련 속성

PatchStrategy

서버의 패치 전략을 나타내는 열거형

PrivateEndpoint

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

PrivateEndpointConnection

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

PrivateEndpointConnectionProvisioningState

현재 프로비저닝 상태입니다.

PrivateEndpointServiceConnectionStatus

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

PrivateLinkServiceConnectionState

서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.

ReplicationRole

복제 역할입니다.

Server

서버를 나타냅니다.

ServerDetachVNetParameter

Vnet을 분리하는 매개 변수입니다.

ServerSkuTier

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

ServerState

서버의 상태입니다.

ServerVersion

서버의 주 버전입니다. 8.0.21은 MySQL 8.0, 5.7.44는 MySQL 5.7을 의미합니다.

Storage

서버의 스토리지 프로필 속성

StorageRedundancyEnum

서버 스토리지의 중복 형식입니다. 매개 변수는 서버를 만드는 데 사용됩니다.

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

UserAssignedIdentity

사용자 할당 ID의 메타데이터입니다.

Backup

서버의 스토리지 프로필 속성

Name 형식 Default value Description
backupIntervalHours

integer (int32)

서버에 대한 백업 간격 시간입니다.

backupRetentionDays

integer (int32)

서버의 백업 보존 기간(일)입니다.

earliestRestoreDate

string (date-time)

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

geoRedundantBackup

EnableStatusEnum

Disabled

지역 중복 백업을 사용할 수 있는지 여부입니다.

BatchOfMaintenance

사용하도록 설정된 경우 유지 관리의 일괄 처리: 서버의 사용자 지정 관리 유지 관리 기간입니다.

Description
Default
Batch1
Batch2

createdByType

리소스를 만든 ID의 형식입니다.

Description
User
Application
ManagedIdentity
Key

CreateMode

새 MySQL 서버를 만드는 모드입니다.

Description
Default
PointInTimeRestore
Replica
GeoRestore

DataEncryption

cmk에 대한 날짜 암호화입니다.

Name 형식 Description
geoBackupKeyURI

string

키 자격 증명 모음이 지역을 교차할 수 없으므로 지역 백업 키 URI, 지역 백업과 동일한 지역에 cmk 필요

geoBackupUserAssignedIdentityId

string

ID가 지역을 교차할 수 없으므로 지역 백업 사용자 ID 리소스 ID, 지역 백업과 동일한 지역에 ID가 필요합니다.

primaryKeyURI

string

기본 키 URI

primaryUserAssignedIdentityId

string

기본 사용자 ID 리소스 ID

type

DataEncryptionType

키 형식, cmk를 사용하도록 설정하기 위한 AzureKeyVault, cmk를 사용하지 않도록 설정하기 위한 SystemManaged입니다.

DataEncryptionType

키 형식, cmk를 사용하도록 설정하기 위한 AzureKeyVault, cmk를 사용하지 않도록 설정하기 위한 SystemManaged입니다.

Description
AzureKeyVault
SystemManaged

EnableStatusEnum

값이 'Enabled' 또는 'Disabled'인지 여부를 나타내는 열거형

Description
Enabled
Disabled

ErrorAdditionalInfo

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

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

HighAvailability

서버의 고가용성 속성

Name 형식 Description
mode

HighAvailabilityMode

서버에 대한 고가용성 모드입니다.

standbyAvailabilityZone

string

대기 서버의 가용성 영역입니다.

state

HighAvailabilityState

서버 고가용성의 상태입니다.

HighAvailabilityMode

서버에 대한 고가용성 모드입니다.

Description
Disabled
ZoneRedundant
SameZone

HighAvailabilityState

서버 고가용성의 상태입니다.

Description
NotEnabled
CreatingStandby
Healthy
FailingOver
RemovingStandby

ImportSourceProperties

원본 관련 속성을 가져옵니다.

Name 형식 Description
dataDirPath

string

스토리지에 있는 데이터 디렉터리의 상대 경로입니다.

sasToken

string (password)

원본 스토리지에 액세스하기 위한 Sas 토큰입니다. sas 토큰에는 읽기 및 목록 권한이 필요합니다.

storageType

ImportSourceStorageType

가져오기 원본의 스토리지 유형입니다.

storageUrl

string

가져오기 원본 스토리지의 URI입니다.

ImportSourceStorageType

가져오기 원본의 스토리지 유형입니다.

Description
AzureBlob

MaintenancePolicy

서버의 유지 관리 정책입니다.

Name 형식 Description
patchStrategy

PatchStrategy

이 서버의 패치 전략

MaintenanceWindow

서버의 유지 관리 기간입니다.

Name 형식 Description
batchOfMaintenance

BatchOfMaintenance

사용하도록 설정된 경우 유지 관리의 일괄 처리: 서버의 사용자 지정 관리 유지 관리 기간입니다.

customWindow

string

사용자 지정 창을 사용할지 여부를 나타냅니다.

dayOfWeek

integer (int32)

유지 관리 기간의 요일

startHour

integer (int32)

유지 관리 기간의 시작 시간

startMinute

integer (int32)

유지 관리 기간의 시작 시간(분)

ManagedServiceIdentityType

관리 서비스 ID의 유형입니다.

Description
UserAssigned

MySQLServerIdentity

Bring Your Own Keys에 대한 ID를 구성하는 속성

Name 형식 Description
principalId

string

KeyVault의 ObjectId

tenantId

string

KeyVault의 TenantId

type

ManagedServiceIdentityType

관리 서비스 ID의 유형입니다.

userAssignedIdentities

<string,  UserAssignedIdentity>

사용자 할당 ID의 메타데이터입니다.

MySQLServerSku

서버의 청구 정보 관련 속성입니다.

Name 형식 Description
name

string

sku의 이름(예: Standard_D32s_v3)입니다.

tier

ServerSkuTier

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

Network

서버의 네트워크 관련 속성

Name 형식 Description
delegatedSubnetResourceId

string

서버에 대한 vnet을 설정하는 데 사용되는 위임된 서브넷 리소스 ID입니다.

privateDnsZoneResourceId

string

프라이빗 DNS 영역 리소스 ID입니다.

publicNetworkAccess

EnableStatusEnum

이 서버에 대한 공용 네트워크 액세스가 허용되는지 여부입니다. 서버에 VNet 통합이 있는 경우 값은 '사용 안 함'입니다.

PatchStrategy

서버의 패치 전략을 나타내는 열거형

Description
Regular
VirtualCanary

PrivateEndpoint

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

Name 형식 Description
id

string

프라이빗 엔드포인트에 대한 ARM 식별자입니다.

PrivateEndpointConnection

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

Name 형식 Description
id

string (arm-id)

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

name

string

리소스의 이름

properties.groupIds

string[]

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

properties.privateEndpoint

PrivateEndpoint

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

properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.

properties.provisioningState

PrivateEndpointConnectionProvisioningState

프라이빗 엔드포인트 연결 리소스의 프로비전 상태입니다.

systemData

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.

type

string

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

PrivateEndpointConnectionProvisioningState

현재 프로비저닝 상태입니다.

Description
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

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

Description
Pending
Approved
Rejected

PrivateLinkServiceConnectionState

서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.

Name 형식 Description
actionsRequired

string

서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다.

description

string

연결의 승인/거부 이유입니다.

status

PrivateEndpointServiceConnectionStatus

서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다.

ReplicationRole

복제 역할입니다.

Description
None
Source
Replica

Server

서버를 나타냅니다.

Name 형식 Description
id

string (arm-id)

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

identity

MySQLServerIdentity

서버의 cmk ID입니다.

location

string

리소스가 있는 지리적 위치

name

string

리소스의 이름

properties.administratorLogin

string

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

properties.administratorLoginPassword

string (password)

관리자 로그인의 암호입니다(서버 생성에 필요).

properties.availabilityZone

string

서버의 가용성 영역 정보입니다.

properties.backup

Backup

서버의 관련 속성을 백업합니다.

properties.createMode

CreateMode

새 MySQL 서버를 만드는 모드입니다.

properties.dataEncryption

DataEncryption

CMK에 대한 데이터 암호화입니다.

properties.databasePort

integer (int32)

서버 데이터베이스 포트입니다. 서버를 만들 때만 지정할 수 있습니다.

properties.fullVersion

string

메이저 버전 및 실제 엔진 버전

properties.fullyQualifiedDomainName

string

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

properties.highAvailability

HighAvailability

서버의 고가용성 관련 속성입니다.

properties.importSourceProperties

ImportSourceProperties

스토리지에서 가져오기 위한 원본 속성입니다.

properties.maintenancePolicy

MaintenancePolicy

서버의 유지 관리 정책입니다.

properties.maintenanceWindow

MaintenanceWindow

서버의 유지 관리 기간입니다. 알려진 문제: 서버를 만드는 동안 설정하거나 서버 업데이트 중에 다른 속성으로 업데이트할 수 없습니다. 는 별도로 업데이트해야 합니다.

properties.network

Network

서버의 네트워크 관련 속성입니다.

properties.privateEndpointConnections

PrivateEndpointConnection[]

서버의 PrivateEndpointConnections 관련 속성입니다.

properties.replicaCapacity

integer (int32)

minimum: 0

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

properties.replicationRole

ReplicationRole

복제 역할입니다.

properties.restorePointInTime

string (date-time)

복원할 시간을 지정하는 복원 지점 생성 시간(ISO8601 형식)입니다.

properties.sourceServerResourceId

string

원본 MySQL 서버 ID입니다.

properties.state

ServerState

서버의 상태입니다.

properties.storage

Storage

서버의 스토리지 관련 속성입니다.

properties.version

ServerVersion

MySQL의 주 버전입니다. 8.0.21은 MySQL 8.0, 5.7.44는 MySQL 5.7을 의미합니다.

sku

MySQLServerSku

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

systemData

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.

tags

object

리소스 태그.

type

string

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

ServerDetachVNetParameter

Vnet을 분리하는 매개 변수입니다.

Name 형식 Description
publicNetworkAccess

EnableStatusEnum

이 서버에 대한 공용 네트워크 액세스가 허용되는지 여부입니다. 서버에 VNet 통합이 있는 경우 값은 '사용 안 함'입니다.

ServerSkuTier

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

Description
Burstable
GeneralPurpose
MemoryOptimized

ServerState

서버의 상태입니다.

Description
Ready
Dropping
Disabled
Starting
Stopping
Stopped
Updating

ServerVersion

서버의 주 버전입니다. 8.0.21은 MySQL 8.0, 5.7.44는 MySQL 5.7을 의미합니다.

Description
5.7
8.0.21

Storage

서버의 스토리지 프로필 속성

Name 형식 Default value Description
autoGrow

EnableStatusEnum

Disabled

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

autoIoScaling

EnableStatusEnum

Enabled

IO 자동 크기 조정을 사용하도록 설정합니다.

iops

integer (int32)

서버에 대한 스토리지 IOPS입니다.

logOnDisk

EnableStatusEnum

Disabled

로그온 디스크를 사용하도록 설정합니다.

storageRedundancy

StorageRedundancyEnum

LocalRedundancy

서버 스토리지의 중복 형식입니다. 매개 변수는 서버를 만드는 데 사용됩니다.

storageSizeGB

integer (int32)

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

storageSku

string

서버 스토리지의 sku 이름입니다.

StorageRedundancyEnum

서버 스토리지의 중복 형식입니다. 매개 변수는 서버를 만드는 데 사용됩니다.

Description
LocalRedundancy
ZoneRedundancy

systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string (date-time)

리소스 만들기의 타임스탬프(UTC)입니다.

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

리소스를 만든 ID의 형식입니다.

lastModifiedAt

string (date-time)

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID의 형식입니다.

UserAssignedIdentity

사용자 할당 ID의 메타데이터입니다.

Name 형식 Description
clientId

string

사용자 할당 ID의 클라이언트 ID

principalId

string

사용자 할당 ID의 보안 주체 ID