Servers - Update

참조

서비스:: SQL Database

API 버전:: 2023-08-01

서버를 업데이트합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string	리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName	path	True	string	서버의 이름입니다.
subscriptionId	path	True	string	Azure 구독을 식별하는 구독 ID입니다.
api-version	query	True	string	요청에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
identity	ResourceIdentity	서버 ID
properties.administratorLogin	string	서버의 관리자 사용자 이름입니다. 만든 후에는 변경할 수 없습니다.
properties.administratorLoginPassword	string	관리자 로그인 암호입니다(서버 생성에 필요).
properties.administrators	ServerExternalAdministrator	서버의 Azure Active Directory 관리자입니다. 서버 만들기 시간에만 사용할 수 있습니다. 서버 업데이트에 사용되는 경우 무시되거나 오류가 발생합니다. 업데이트의 경우 개별 API를 사용해야 합니다.
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.version	string	서버의 버전입니다.
tags	object	리소스 태그.

응답

Name	형식	Description
200 OK	Server	서버를 업데이트했습니다.
202 Accepted		허용 헤더 Location: string
Other Status Codes	ErrorResponse	오류 응답: *** 400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업 400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업 400 NameAlreadyExistsSoftDeleted - 요청된 서버 이름은 일시 삭제된 상태의 서버에서 가져옵니다. 차단을 해제하려면 서버를 제거하거나 복구합니다. 400 MissingIdentityId - ID 유형이 UserAssigned로 설정된 경우 사용자 할당 ID가 제공되지 않습니다. 400 InvalidPrimaryIdentityId - 사용자가 PrimaryUserIdentityId에 대한 값을 제공하지만 IdentityId 매개 변수에 동일한 값이 나열되지 않습니다. 400 PECsNotExistingToDenyPublicNetworkAccess - 서버에 액세스할 수 있는 프라이빗 엔드포인트가 없으므로 공용 네트워크 액세스 거부를 예로 설정할 수 없습니다. 프라이빗 엔드포인트를 설정하고 작업(https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database)을 다시 시도하세요. 400 NameAlreadyExists - 제공된 이름이 이미 있습니다. 400 UmiMissingAkvPermissions - 사용자가 제공한 PrimaryUserAssignedIdentityId가 제공된 KeyId에 대한 액세스 권한이 없음 400 MissingPrimaryIdentity - 사용자가 제공한 PrimaryUserAssignedIdentityId가 제공된 KeyId에 대한 액세스 권한이 없음 400 ProvisioningDisabled - 리소스 작업 권한 부여자의 오류 메시지를 변경 없이 있는 그대로 표시합니다. 400 PrimaryIdentityMissingPermissionForKeyId - KeyId는 만드는 동안 사용자가 제공하지만 PrimaryUserAssignedIdentityId는 API 호출에 제공되지 않습니다. 400 InvalidIdentityTypeForKeyId - KeyId는 만드는 동안 사용자가 제공하지만 ID 유형이 'UserAssigned'로 설정되지 않았습니다. 400 InvalidLoginName - 제공된 로그인 이름이 잘못되었습니다. 400 InvalidUsername - 제공된 사용자 이름에 잘못된 문자가 포함되어 있습니다. 400 Ipv6FeatureNotEnabled - 사용자가 구독에서 기능 플래그를 사용하도록 설정하지 않고 서버에서 Ipv6 지원을 설정하려고 했거나 해당 지역에서 기능 지원을 현재 사용하지 않도록 설정했습니다. 400 PasswordTooShort - 제공된 암호가 너무 짧습니다. 400 AadOnlyAuthenticationIsEnabled - Azure Active Directory 전용 인증이 사용됩니다. 시스템 관리자에게 문의하세요. 400 RegionDoesNotSupportVersion - 사용자가 해당 서버 버전이 지원되지 않는 위치에 지정된 버전의 서버를 만들려고 했습니다. 400 PasswordTooLong - 제공된 암호가 너무 깁니다. 400 PasswordNotComplex - 제공된 암호가 충분히 복잡하지 않습니다. 400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다. 400 InvalidLocation - 잘못된 위치가 지정되었습니다. 400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다. 400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다. 400 TokenTooLong - 제공된 토큰이 너무 깁니다. 400 CMKOperationNotAllowed - 사용자가 서버에 Azure Key Vault 액세스 권한이 없을 때 서버에서 작업을 수행하려고 했습니다. 400 ServerNotFound - 요청된 서버를 찾을 수 없습니다. 400 RegionDoesNotAllowProvisioning - 선택한 위치가 새 Windows Azure SQL Database 서버를 허용하지 않습니다. 나중에 변경 될 수 있습니다. 400 InvalidMinimalTlsVersion - 최소 TLS 버전이 잘못되었습니다. 400 InvalidExternalAdministratorLogin - 잘못되었거나 외부 관리자 로그인 이름이 없습니다. 400 InvalidExternalAdministratorSid - 외부 관리자 개체 ID가 잘못되었거나 누락되었습니다. 400 InvalidExternalAdministratorTenantId - 외부 관리자 테넌트 ID가 잘못되었거나 누락되었습니다. 400 ExternalAdministratorPrincipalType - 잘못되었거나 누락된 외부 관리자 보안 주체 유형입니다. 사용자, 애플리케이션 또는 그룹에서 선택하세요. 400 MissingExternalAdministratorWithAadOnlyAuth - Azure AD 전용 인증을 사용하려면 외부 관리자의 세부 정보를 제공하세요. 400 ExternalAdministratorLoginSameAsSqlAdmin - Azure Active Directory 관리자 및 서버 관리자 계정의 이름은 달라야 합니다. 다른 값을 제공하세요. 400 ServerAdministratorNameAlreadyExists - 사용자가 외부 관리자를 설정하려고 시도했으며 보안 주체 이름이 'master' 데이터베이스에 이미 있습니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 404 SubscriptionNotFound - 요청된 구독을 찾을 수 없습니다. 409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 409 UpsertLogicalServerRequestAlreadyInProgress - 진행 중인 논리 서버 요청이 이미 진행 중입니다. 나중에 요청을 다시 시도하세요. 409 ServerDisabled - 서버를 사용할 수 없습니다. 409 ConflictingServerOperation - 서버에 대한 작업이 현재 진행 중입니다. 409 SubscriptionDisabled - 구독을 사용할 수 없습니다. 409 ServerQuotaExceeded - 할당량을 초과하므로 서버를 구독에 추가할 수 없습니다. 409 ServerAlreadyExists - 중복 서버 이름입니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 ConflictingSubscriptionOperation - 현재 구독에 대한 작업이 진행 중입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

Name

형식

Description

200 OK

Server

서버를 업데이트했습니다.

202 Accepted

허용

헤더

Location: string

Other Status Codes

ErrorResponse

오류 응답: ***

400 ManagedInstanceStoppingOrStopped - 인스턴스가 중지/중지된 상태인 동안 제출된 충돌 작업
400 ManagedInstanceStarting - 인스턴스가 시작 상태에 있는 동안 제출된 충돌 작업
400 NameAlreadyExistsSoftDeleted - 요청된 서버 이름은 일시 삭제된 상태의 서버에서 가져옵니다. 차단을 해제하려면 서버를 제거하거나 복구합니다.
400 MissingIdentityId - ID 유형이 UserAssigned로 설정된 경우 사용자 할당 ID가 제공되지 않습니다.
400 InvalidPrimaryIdentityId - 사용자가 PrimaryUserIdentityId에 대한 값을 제공하지만 IdentityId 매개 변수에 동일한 값이 나열되지 않습니다.
400 PECsNotExistingToDenyPublicNetworkAccess - 서버에 액세스할 수 있는 프라이빗 엔드포인트가 없으므로 공용 네트워크 액세스 거부를 예로 설정할 수 없습니다. 프라이빗 엔드포인트를 설정하고 작업(https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database)을 다시 시도하세요.
400 NameAlreadyExists - 제공된 이름이 이미 있습니다.
400 UmiMissingAkvPermissions - 사용자가 제공한 PrimaryUserAssignedIdentityId가 제공된 KeyId에 대한 액세스 권한이 없음
400 MissingPrimaryIdentity - 사용자가 제공한 PrimaryUserAssignedIdentityId가 제공된 KeyId에 대한 액세스 권한이 없음
400 ProvisioningDisabled - 리소스 작업 권한 부여자의 오류 메시지를 변경 없이 있는 그대로 표시합니다.
400 PrimaryIdentityMissingPermissionForKeyId - KeyId는 만드는 동안 사용자가 제공하지만 PrimaryUserAssignedIdentityId는 API 호출에 제공되지 않습니다.
400 InvalidIdentityTypeForKeyId - KeyId는 만드는 동안 사용자가 제공하지만 ID 유형이 'UserAssigned'로 설정되지 않았습니다.
400 InvalidLoginName - 제공된 로그인 이름이 잘못되었습니다.
400 InvalidUsername - 제공된 사용자 이름에 잘못된 문자가 포함되어 있습니다.
400 Ipv6FeatureNotEnabled - 사용자가 구독에서 기능 플래그를 사용하도록 설정하지 않고 서버에서 Ipv6 지원을 설정하려고 했거나 해당 지역에서 기능 지원을 현재 사용하지 않도록 설정했습니다.
400 PasswordTooShort - 제공된 암호가 너무 짧습니다.
400 AadOnlyAuthenticationIsEnabled - Azure Active Directory 전용 인증이 사용됩니다. 시스템 관리자에게 문의하세요.
400 RegionDoesNotSupportVersion - 사용자가 해당 서버 버전이 지원되지 않는 위치에 지정된 버전의 서버를 만들려고 했습니다.
400 PasswordTooLong - 제공된 암호가 너무 깁니다.
400 PasswordNotComplex - 제공된 암호가 충분히 복잡하지 않습니다.
400 InvalidParameterValue - 매개 변수에 잘못된 값이 지정되었습니다.
400 InvalidLocation - 잘못된 위치가 지정되었습니다.
400 InvalidServerName - 잘못된 서버 이름이 지정되었습니다.
400 InvalidIdentifier - 식별자에 NULL 또는 잘못된 유니코드 문자가 포함되어 있습니다.
400 TokenTooLong - 제공된 토큰이 너무 깁니다.
400 CMKOperationNotAllowed - 사용자가 서버에 Azure Key Vault 액세스 권한이 없을 때 서버에서 작업을 수행하려고 했습니다.
400 ServerNotFound - 요청된 서버를 찾을 수 없습니다.
400 RegionDoesNotAllowProvisioning - 선택한 위치가 새 Windows Azure SQL Database 서버를 허용하지 않습니다. 나중에 변경 될 수 있습니다.
400 InvalidMinimalTlsVersion - 최소 TLS 버전이 잘못되었습니다.
400 InvalidExternalAdministratorLogin - 잘못되었거나 외부 관리자 로그인 이름이 없습니다.
400 InvalidExternalAdministratorSid - 외부 관리자 개체 ID가 잘못되었거나 누락되었습니다.
400 InvalidExternalAdministratorTenantId - 외부 관리자 테넌트 ID가 잘못되었거나 누락되었습니다.
400 ExternalAdministratorPrincipalType - 잘못되었거나 누락된 외부 관리자 보안 주체 유형입니다. 사용자, 애플리케이션 또는 그룹에서 선택하세요.
400 MissingExternalAdministratorWithAadOnlyAuth - Azure AD 전용 인증을 사용하려면 외부 관리자의 세부 정보를 제공하세요.
400 ExternalAdministratorLoginSameAsSqlAdmin - Azure Active Directory 관리자 및 서버 관리자 계정의 이름은 달라야 합니다. 다른 값을 제공하세요.
400 ServerAdministratorNameAlreadyExists - 사용자가 외부 관리자를 설정하려고 시도했으며 보안 주체 이름이 'master' 데이터베이스에 이미 있습니다.
404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.
404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다.
404 OperationIdNotFound - ID가 있는 작업이 없습니다.
404 SubscriptionNotFound - 요청된 구독을 찾을 수 없습니다.
409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다.
409 OperationCancelled - 사용자가 작업을 취소했습니다.
409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.
409 UpsertLogicalServerRequestAlreadyInProgress - 진행 중인 논리 서버 요청이 이미 진행 중입니다. 나중에 요청을 다시 시도하세요.
409 ServerDisabled - 서버를 사용할 수 없습니다.
409 ConflictingServerOperation - 서버에 대한 작업이 현재 진행 중입니다.
409 SubscriptionDisabled - 구독을 사용할 수 없습니다.
409 ServerQuotaExceeded - 할당량을 초과하므로 서버를 구독에 추가할 수 없습니다.
409 ServerAlreadyExists - 중복 서버 이름입니다.
429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
429 ConflictingSubscriptionOperation - 현재 구독에 대한 작업이 진행 중입니다.
500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.
503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

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=2023-08-01

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

샘플 응답

상태 코드:: 200

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

상태 코드:: 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=2023-05-01

정의

Name	Description
AdministratorType	심각도 관리자의 유형입니다.
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 ID 구성입니다.
Server	Azure SQL Database 서버.
ServerExternalAdministrator	Active Directory 관리자의 속성입니다.
ServerNetworkAccessFlag	이 서버에 대한 아웃바운드 네트워크 액세스를 제한할지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
ServerPrivateEndpointConnection	서버 아래의 프라이빗 엔드포인트 연결
ServerPublicNetworkAccessFlag	이 서버에 대한 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함' 또는 'SecuredByPerimeter'여야 합니다.
ServerUpdate	Azure SQL Database 서버에 대한 업데이트 요청입니다.
ServerWorkspaceFeature	기존 서버에 작업 영역이 만들어졌는지 여부 및 작업 영역에서의 연결을 허용하는지 여부
UserIdentity	리소스에 대한 Azure Active Directory ID 구성입니다.

AdministratorType

열거형

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

값	Description
ActiveDirectory

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
Disabled
Enabled

IdentityType

열거형

ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다.

값	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

MinimalTlsVersion

열거형

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

값	Description
1.0
1.1
1.2
1.3
None

PrincipalType

열거형

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

값	Description
Application
Group
User

PrivateEndpointConnectionProperties

Object

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

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

PrivateEndpointProperty

Object

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

PrivateEndpointProvisioningState

열거형

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

값	Description
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

열거형

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

값	Description
None

PrivateLinkServiceConnectionStateProperty

Object

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

PrivateLinkServiceConnectionStateStatus

열거형

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

값	Description
Approved
Disconnected
Pending
Rejected

ResourceIdentity

Object

리소스에 대한 Azure Active Directory ID 구성입니다.

Name	형식	Description
principalId	string (uuid)	Azure Active Directory 보안 주체 ID입니다.
tenantId	string (uuid)	Azure Active Directory 테넌트 ID입니다.
type	IdentityType	ID 형식입니다. 리소스에 대한 Azure Active Directory 보안 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다.
userAssignedIdentities	<string, UserIdentity>	사용할 사용자 할당 ID의 리소스 ID

Server

Object

Azure SQL Database 서버.

Name	형식	Description
id	string	리소스 ID입니다.
identity	ResourceIdentity	서버의 Azure Active Directory ID입니다.
kind	string	Sql Server의 종류입니다. Azure Portal 환경에 사용되는 메타데이터입니다.
location	string	리소스 위치입니다.
name	string	리소스 이름입니다.
properties.administratorLogin	string	서버의 관리자 사용자 이름입니다. 만든 후에는 변경할 수 없습니다.
properties.administratorLoginPassword	string	관리자 로그인 암호입니다(서버 생성에 필요).
properties.administrators	ServerExternalAdministrator	서버의 Azure Active Directory 관리자입니다. 서버 만들기 시간에만 사용할 수 있습니다. 서버 업데이트에 사용되는 경우 무시되거나 오류가 발생합니다. 업데이트의 경우 개별 API를 사용해야 합니다.
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.state	string	서버의 상태입니다.
properties.version	string	서버의 버전입니다.
properties.workspaceFeature	ServerWorkspaceFeature	기존 서버에 작업 영역이 만들어졌는지 여부 및 작업 영역에서의 연결을 허용하는지 여부
tags	object	리소스 태그.
type	string	리소스 종류입니다.

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
Disabled
Enabled

ServerPrivateEndpointConnection

Object

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

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

ServerPublicNetworkAccessFlag

열거형

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

값	Description
Disabled
Enabled
SecuredByPerimeter

ServerUpdate

Object

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

Name	형식	Description
identity	ResourceIdentity	서버 ID
properties.administratorLogin	string	서버의 관리자 사용자 이름입니다. 만든 후에는 변경할 수 없습니다.
properties.administratorLoginPassword	string	관리자 로그인 암호입니다(서버 생성에 필요).
properties.administrators	ServerExternalAdministrator	서버의 Azure Active Directory 관리자입니다. 서버 만들기 시간에만 사용할 수 있습니다. 서버 업데이트에 사용되는 경우 무시되거나 오류가 발생합니다. 업데이트의 경우 개별 API를 사용해야 합니다.
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.state	string	서버의 상태입니다.
properties.version	string	서버의 버전입니다.
properties.workspaceFeature	ServerWorkspaceFeature	기존 서버에 작업 영역이 만들어졌는지 여부 및 작업 영역에서의 연결을 허용하는지 여부
tags	object	리소스 태그.

ServerWorkspaceFeature

열거형

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

값	Description
Connected
Disconnected

UserIdentity

Object

리소스에 대한 Azure Active Directory ID 구성입니다.

Name	형식	Description
clientId	string (uuid)	Azure Active Directory 클라이언트 ID입니다.
principalId	string (uuid)	Azure Active Directory 보안 주체 ID입니다.

다음을 통해 공유

Servers - Update

URI 매개 변수

요청 본문

응답

예제

Update a server

샘플 요청

샘플 응답

정의

AdministratorType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

IdentityType

MinimalTlsVersion

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerPublicNetworkAccessFlag

ServerUpdate

ServerWorkspaceFeature

UserIdentity

추가 리소스