Servers - Update

서비스:: SQL Database

API 버전:: 2025-01-01

서버를 업데이트합니다.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2025-01-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
serverName	path	True	string	서버의 이름입니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
identity	ResourceIdentity	서버 ID
properties.administratorLogin	string	서버의 관리자 사용자 이름입니다. 만든 후에는 변경할 수 없습니다.
properties.administratorLoginPassword	string (password)	관리자 로그인 암호입니다(서버 생성에 필요).
properties.administrators	ServerExternalAdministrator	Azure Active Directory 관리자는 서버 생성 및 서버 업데이트 시 사용할 수 있지만, azureADOnlyAuthentication 속성은 제외됩니다. azureADOnlyAuthentication 속성을 업데이트하려면 개별 API를 사용해야 합니다.
properties.createMode	ServerCreateMode	서버에 대한 생성 모드, 이에 대한 유효한 값만 Normal 및 Restore입니다.
properties.federatedClientId	string (uuid)	테넌트 간 CMK 시나리오에 사용되는 클라이언트 ID
properties.isIPv6Enabled	ServerNetworkAccessFlag	이 서버에 대해 IPv6 지원을 사용하도록 설정할지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
properties.keyId	string	암호화에 사용할 키의 CMK URI입니다.
properties.minimalTlsVersion	MinimalTlsVersion	최소 TLS 버전입니다. 허용되는 값: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다.
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	이 서버에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함' 또는 'SecuredByPerimeter'여야 합니다.
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	이 서버에 대한 아웃바운드 네트워크 액세스를 제한할지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
properties.retentionDays	integer (int32)	이 서버가 일시 삭제된 상태로 유지되는 일 수입니다.
properties.version	string	서버의 버전입니다.
tags	object	리소스 태그.

응답

Name	형식	Description
200 OK	Server	Azure 운영이 성공적으로 완료되었습니다.
202 Accepted		리소스 업데이트 요청이 수락되었습니다. 헤더 Location: string Retry-After: integer
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

Server

Azure 운영이 성공적으로 완료되었습니다.

202 Accepted

리소스 업데이트 요청이 수락되었습니다.

헤더

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

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

보안

azure_auth

Azure Active Directory OAuth2 Flow.

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

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Update a server

샘플 요청

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2025-01-01

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "placeholder",
    "isIPv6Enabled": "Enabled",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "retentionDays": 7
  }
}

샘플 응답

상태 코드:: 200

{
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "kind": "v12.0",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "isIPv6Enabled": "Enabled",
    "privateEndpointConnections": [
      {
        "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645/privateEndpointConnections/private-endpoint-name-00000000-1111-2222-3333-444444444444",
        "properties": {
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "description": "Auto-approved",
            "actionsRequired": "None",
            "status": "Approved"
          },
          "provisioningState": "Ready"
        }
      }
    ],
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "retentionDays": 7,
    "state": "Ready",
    "version": "12.0"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

상태 코드:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/serverOperationResults/00000000-0000-0000-0000-000000000000?api-version=2024-08-01

정의

Name	Description
AdministratorType	심각도 관리자의 유형입니다.
createdByType	리소스를 만든 ID의 형식입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
ExternalGovernanceStatus	외부 거버넌스의 상태입니다.
IdentityType	ID 형식입니다. 리소스에 대해 자동으로 Azure Active Directory 프린시펄을 생성하고 할당하려면 'SystemAssigned'로 설정하세요.
MinimalTlsVersion	최소 TLS 버전입니다. 허용되는 값: 'None', 1.0', '1.1', '1.2', '1.3'
PrincipalType	서버 관리자의 보안 주체 유형입니다.
PrivateEndpointConnectionProperties	프라이빗 엔드포인트 연결의 속성입니다.
PrivateEndpointProperty
PrivateEndpointProvisioningState	프라이빗 엔드포인트 연결의 상태입니다.
PrivateLinkServiceConnectionStateActionsRequire	프라이빗 링크 서비스 연결에 필요한 작업입니다.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	프라이빗 링크 서비스 연결 상태입니다.
ResourceIdentity	Azure Active Directory identity configuration for a resource.
Server	Azure SQL Database 서버.
ServerCreateMode	서버에 대한 생성 모드, 이에 대한 유효한 값만 Normal 및 Restore입니다.
ServerExternalAdministrator	Active Directory 관리자의 속성입니다.
ServerNetworkAccessFlag	이 서버에 대한 아웃바운드 네트워크 액세스를 제한할지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
ServerPrivateEndpointConnection	서버 아래의 프라이빗 엔드포인트 연결
ServerPublicNetworkAccessFlag	이 서버에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함' 또는 'SecuredByPerimeter'여야 합니다.
ServerUpdate	Azure SQL Database 서버에 대한 업데이트 요청입니다.
ServerWorkspaceFeature	기존 서버에 작업 영역이 만들어졌는지 여부 및 작업 영역에서의 연결을 허용하는지 여부
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
UserIdentity	Azure Active Directory identity configuration for a resource.

AdministratorType

열거형

심각도 관리자의 유형입니다.

값	Description
ActiveDirectory	ActiveDirectory(액티브디렉토리)

createdByType

열거형

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

값	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

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

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

ExternalGovernanceStatus

열거형

외부 거버넌스의 상태입니다.

값	Description
Enabled	활성화됨
Disabled	비활성화

IdentityType

열거형

ID 형식입니다. 리소스에 대해 자동으로 Azure Active Directory 프린시펄을 생성하고 할당하려면 'SystemAssigned'로 설정하세요.

값	Description
None	없음
SystemAssigned	시스템 지정됨
UserAssigned	UserAssigned
SystemAssigned,UserAssigned	SystemAssigned, UserAssigned

MinimalTlsVersion

열거형

최소 TLS 버전입니다. 허용되는 값: 'None', 1.0', '1.1', '1.2', '1.3'

값	Description
None	없음
1.0	1.0
1.1	1.1
1.2	1.2
1.3	1.3

PrincipalType

열거형

서버 관리자의 보안 주체 유형입니다.

값	Description
User	사용자
Group	그룹
Application	Application

PrivateEndpointConnectionProperties

Object

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

Name	형식	Description
groupIds	string[]	그룹 ID.
privateEndpoint	PrivateEndpointProperty	연결이 속한 프라이빗 엔드포인트입니다.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	프라이빗 엔드포인트 연결의 연결 상태입니다.
provisioningState	PrivateEndpointProvisioningState	프라이빗 엔드포인트 연결의 상태입니다.

PrivateEndpointProperty

Object

Name	형식	Description
id	string	프라이빗 엔드포인트의 리소스 ID입니다.

PrivateEndpointProvisioningState

열거형

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

값	Description
Approving	승인
Ready	Ready
Dropping	떨어지고
Failed	실패
Rejecting	거부

PrivateLinkServiceConnectionStateActionsRequire

열거형

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

값	Description
None	없음

PrivateLinkServiceConnectionStateProperty

Object

Name	형식	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	프라이빗 링크 서비스 연결에 필요한 작업입니다.
description	string	프라이빗 링크 서비스 연결 설명입니다.
status	PrivateLinkServiceConnectionStateStatus	프라이빗 링크 서비스 연결 상태입니다.

PrivateLinkServiceConnectionStateStatus

열거형

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

값	Description
Approved	승인됨
Pending	보류 중
Rejected	거절됨
Disconnected	연결 해제됨

ResourceIdentity

Object

Azure Active Directory identity configuration for a resource.

Name	형식	Description
principalId	string (uuid)	The Azure Active Directory principal id.
tenantId	string (uuid)	The Azure Active Directory tenant id.
type	IdentityType	ID 형식입니다. 리소스에 대해 자동으로 Azure Active Directory 프린시펄을 생성하고 할당하려면 'SystemAssigned'로 설정하세요.
userAssignedIdentities	<string, UserIdentity>	사용할 사용자 할당 ID의 리소스 ID

Server

Object

Azure SQL Database 서버.

Name	형식	Description
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ResourceIdentity	서버의 Azure Active Directory 식별자.
kind	string	Sql Server의 종류입니다. 이 메타데이터는 Azure 포털 경험에 사용됩니다.
location	string	리소스가 있는 지리적 위치
name	string	리소스의 이름
properties.administratorLogin	string	서버의 관리자 사용자 이름입니다. 만든 후에는 변경할 수 없습니다.
properties.administratorLoginPassword	string (password)	관리자 로그인 암호입니다(서버 생성에 필요).
properties.administrators	ServerExternalAdministrator	Azure Active Directory 관리자는 서버 생성 및 서버 업데이트 시 사용할 수 있지만, azureADOnlyAuthentication 속성은 제외됩니다. azureADOnlyAuthentication 속성을 업데이트하려면 개별 API를 사용해야 합니다.
properties.createMode	ServerCreateMode	서버에 대한 생성 모드, 이에 대한 유효한 값만 Normal 및 Restore입니다.
properties.externalGovernanceStatus	ExternalGovernanceStatus	외부 거버넌스의 상태입니다.
properties.federatedClientId	string (uuid)	테넌트 간 CMK 시나리오에 사용되는 클라이언트 ID
properties.fullyQualifiedDomainName	string	서버의 정규화된 도메인 이름입니다.
properties.isIPv6Enabled	ServerNetworkAccessFlag	이 서버에 대해 IPv6 지원을 사용하도록 설정할지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
properties.keyId	string	암호화에 사용할 키의 CMK URI입니다.
properties.minimalTlsVersion	MinimalTlsVersion	최소 TLS 버전입니다. 허용되는 값: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	서버의 프라이빗 엔드포인트 연결 목록
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	이 서버에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함' 또는 'SecuredByPerimeter'여야 합니다.
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	이 서버에 대한 아웃바운드 네트워크 액세스를 제한할지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
properties.retentionDays	integer (int32)	이 서버가 일시 삭제된 상태로 유지되는 일 수입니다.
properties.state	string	서버의 상태입니다.
properties.version	string	서버의 버전입니다.
properties.workspaceFeature	ServerWorkspaceFeature	기존 서버에 작업 영역이 만들어졌는지 여부 및 작업 영역에서의 연결을 허용하는지 여부
systemData	systemData	Azure Resource Manager 메타데이터에 createdBy 및 modifiedBy 정보가 포함되어 있습니다.
tags	object	리소스 태그.
type	string	리소스의 형식입니다. 예를 들어, "Microsoft. 컴퓨트/가상 머신" 또는 "Microsoft." 저장소/저장소 계정"

ServerCreateMode

열거형

서버에 대한 생성 모드, 이에 대한 유효한 값만 Normal 및 Restore입니다.

값	Description
Normal	정상
Restore	Restore

ServerExternalAdministrator

Object

Active Directory 관리자의 속성입니다.

Name	형식	Description
administratorType	AdministratorType	심각도 관리자의 유형입니다.
azureADOnlyAuthentication	boolean	Azure Active Directory만 인증이 활성화됨.
login	string	서버 관리자의 로그인 이름입니다.
principalType	PrincipalType	서버 관리자의 보안 주체 유형입니다.
sid	string (uuid)	서버 관리자의 SID(개체 ID)입니다.
tenantId	string (uuid)	관리자의 테넌트 ID입니다.

ServerNetworkAccessFlag

열거형

이 서버에 대한 아웃바운드 네트워크 액세스를 제한할지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.

값	Description
Enabled	활성화됨
Disabled	비활성화

ServerPrivateEndpointConnection

Object

서버 아래의 프라이빗 엔드포인트 연결

Name	형식	Description
id	string	리소스 ID입니다.
properties	PrivateEndpointConnectionProperties	프라이빗 엔드포인트 연결 속성

ServerPublicNetworkAccessFlag

열거형

이 서버에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함' 또는 'SecuredByPerimeter'여야 합니다.

값	Description
Enabled	활성화됨
Disabled	비활성화
SecuredByPerimeter	SecuredByPerimeter

ServerUpdate

Object

Azure SQL Database 서버에 대한 업데이트 요청입니다.

Name	형식	Description
identity	ResourceIdentity	서버 ID
properties.administratorLogin	string	서버의 관리자 사용자 이름입니다. 만든 후에는 변경할 수 없습니다.
properties.administratorLoginPassword	string (password)	관리자 로그인 암호입니다(서버 생성에 필요).
properties.administrators	ServerExternalAdministrator	Azure Active Directory 관리자는 서버 생성 및 서버 업데이트 시 사용할 수 있지만, azureADOnlyAuthentication 속성은 제외됩니다. azureADOnlyAuthentication 속성을 업데이트하려면 개별 API를 사용해야 합니다.
properties.createMode	ServerCreateMode	서버에 대한 생성 모드, 이에 대한 유효한 값만 Normal 및 Restore입니다.
properties.externalGovernanceStatus	ExternalGovernanceStatus	외부 거버넌스의 상태입니다.
properties.federatedClientId	string (uuid)	테넌트 간 CMK 시나리오에 사용되는 클라이언트 ID
properties.fullyQualifiedDomainName	string	서버의 정규화된 도메인 이름입니다.
properties.isIPv6Enabled	ServerNetworkAccessFlag	이 서버에 대해 IPv6 지원을 사용하도록 설정할지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
properties.keyId	string	암호화에 사용할 키의 CMK URI입니다.
properties.minimalTlsVersion	MinimalTlsVersion	최소 TLS 버전입니다. 허용되는 값: 'None', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	서버의 프라이빗 엔드포인트 연결 목록
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	이 서버에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함' 또는 'SecuredByPerimeter'여야 합니다.
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	이 서버에 대한 아웃바운드 네트워크 액세스를 제한할지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
properties.retentionDays	integer (int32)	이 서버가 일시 삭제된 상태로 유지되는 일 수입니다.
properties.state	string	서버의 상태입니다.
properties.version	string	서버의 버전입니다.
properties.workspaceFeature	ServerWorkspaceFeature	기존 서버에 작업 영역이 만들어졌는지 여부 및 작업 영역에서의 연결을 허용하는지 여부
tags	object	리소스 태그.

ServerWorkspaceFeature

열거형

기존 서버에 작업 영역이 만들어졌는지 여부 및 작업 영역에서의 연결을 허용하는지 여부

값	Description
Connected	연결됨
Disconnected	연결 해제됨

systemData

Object

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

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

UserIdentity

Object

Azure Active Directory identity configuration for a resource.

Name	형식	Description
clientId	string (uuid)	The Azure Active Directory client id.
principalId	string (uuid)	The Azure Active Directory principal id.

다음을 통해 공유

Servers - Update

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

Update a server

샘플 요청

샘플 응답

정의

AdministratorType

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

IdentityType

MinimalTlsVersion

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerCreateMode

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerPublicNetworkAccessFlag

ServerUpdate

ServerWorkspaceFeature

systemData

UserIdentity