Servers - Create Or Update

참조

서비스:: SQL Database

API 버전:: 2021-11-01

서버를 만들거나 업데이트합니다.

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

URI 매개 변수

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

요청 본문

Name	필수	형식	Description
location	True	string	리소스 위치.
identity		ResourceIdentity	서버의 Azure Active Directory ID입니다.
properties.administratorLogin		string	서버의 관리자 사용자 이름입니다. 만든 후에는 변경할 수 없습니다.
properties.administratorLoginPassword		string	관리자 로그인 암호입니다(서버 만들기에 필요).
properties.administrators		ServerExternalAdministrator	서버의 Azure Active Directory 관리자입니다.
properties.federatedClientId		string	테넌트 간 CMK 시나리오에 사용되는 클라이언트 ID
properties.keyId		string	암호화에 사용할 키의 CMK URI입니다.
properties.minimalTlsVersion		string	최소 TLS 버전입니다. 허용되는 값: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId		string	기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다.
properties.publicNetworkAccess		ServerNetworkAccessFlag	이 서버에 대해 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
properties.restrictOutboundNetworkAccess		ServerNetworkAccessFlag	이 서버에 대한 아웃바운드 네트워크 액세스를 제한할지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
properties.version		string	서버의 버전입니다.
tags		object	리소스 태그.

응답

Name	형식	Description
200 OK	Server	서버를 업데이트했습니다.
201 Created	Server	서버를 만들었습니다.
202 Accepted		수락됨
Other Status Codes		오류 응답: *** 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 RegionDoesNotAllowProvisioning - 선택한 위치가 새 Windows Azure SQL 데이터베이스 서버를 허용하지 않습니다. 나중에 변경 될 수 있습니다. 400 ServerNotFound - 요청된 서버를 찾을 수 없습니다. 400 InvalidMinimalTlsVersion - 잘못된 최소 TLS 버전입니다. 400 InvalidExternalAdministratorLogin - 외부 관리자 로그인 이름이 잘못되었거나 누락되었습니다. 400 InvalidExternalAdministratorSid - 외부 관리자 개체 ID가 잘못되었거나 누락되었습니다. 400 InvalidExternalAdministratorTenantId - 외부 관리자 테넌트 ID가 잘못되었거나 누락되었습니다. 400 ExternalAdministratorPrincipalType - 외부 관리자 보안 주체 유형이 잘못되었거나 누락되었습니다. 사용자, 애플리케이션 또는 그룹에서 선택하세요. 400 MissingExternalAdministratorWithAadOnlyAuth - Azure AD 전용 인증을 사용하려면 외부 관리자의 세부 정보를 제공하세요. 400 ExternalAdministratorLoginSameAsSqlAdmin - Azure Active Directory 관리자와 서버 관리자 계정의 이름이 달라야 합니다. 다른 값을 제공하세요. 404 SubscriptionDoesNotHaveServer - 요청된 서버를 찾을 수 없습니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 404 SubscriptionNotFound - 요청된 구독을 찾을 수 없습니다. 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 - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Create server

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

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled"
  },
  "location": "Japan East"
}


import com.azure.resourcemanager.sql.fluent.models.ServerInner;
import com.azure.resourcemanager.sql.models.PrincipalType;
import com.azure.resourcemanager.sql.models.ServerExternalAdministrator;
import com.azure.resourcemanager.sql.models.ServerNetworkAccessFlag;
import java.util.UUID;

/**
 * Samples for Servers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerCreate.json
     */
    /**
     * Sample code: Create server.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().createOrUpdate("sqlcrudtest-7398", "sqlcrudtest-4645",
            new ServerInner().withLocation("Japan East").withAdministratorLogin("dummylogin")
                .withAdministratorLoginPassword("fakeTokenPlaceholder")
                .withPublicNetworkAccess(ServerNetworkAccessFlag.ENABLED)
                .withAdministrators(new ServerExternalAdministrator().withPrincipalType(PrincipalType.USER)
                    .withLogin("bob@contoso.com").withSid(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withTenantId(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withAzureADOnlyAuthentication(true))
                .withRestrictOutboundNetworkAccess(ServerNetworkAccessFlag.ENABLED),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

{
  "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": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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"
          }
        }
      }
    ]
  }
}

상태 코드:: 201

{
  "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",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "version": "12.0",
    "state": "Ready",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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

정의

Name	Description
AdministratorType	심각도 관리자의 유형입니다.
IdentityType	ID 유형입니다. 리소스에 대한 Azure Active Directory 주체를 자동으로 만들고 할당하려면 이를 'SystemAssigned'로 설정합니다.
PrincipalType	보안 주체 관리자의 유형입니다.
PrivateEndpointConnectionProperties	프라이빗 엔드포인트 연결의 속성입니다.
PrivateEndpointProperty
PrivateEndpointProvisioningState	프라이빗 엔드포인트 연결의 상태입니다.
PrivateLinkServiceConnectionStateActionsRequire	프라이빗 링크 서비스 연결에 필요한 작업입니다.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	프라이빗 링크 서비스 연결 상태.
ResourceIdentity	리소스에 대한 Azure Active Directory ID 구성입니다.
Server	Azure SQL 데이터베이스 서버입니다.
ServerExternalAdministrator	Active Directory 관리자의 속성입니다.
ServerNetworkAccessFlag	이 서버에 대해 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
ServerPrivateEndpointConnection	서버 아래의 프라이빗 엔드포인트 연결
ServerWorkspaceFeature	기존 서버에 작업 영역이 만들어졌는지 여부 및 작업 영역에서의 연결을 허용하는지 여부
UserIdentity	리소스에 대한 Azure Active Directory ID 구성입니다.

AdministratorType

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

Name	형식	Description
ActiveDirectory	string

IdentityType

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

Name	형식	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

PrincipalType

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

Name	형식	Description
Application	string
Group	string
User	string

PrivateEndpointConnectionProperties

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

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

PrivateEndpointProperty

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

PrivateEndpointProvisioningState

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

Name	형식	Description
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

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

Name	형식	Description
None	string

PrivateLinkServiceConnectionStateProperty

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

PrivateLinkServiceConnectionStateStatus

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

Name	형식	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

ResourceIdentity

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

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

Server

Azure SQL 데이터베이스 서버입니다.

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 관리자입니다.
properties.federatedClientId	string	테넌트 간 CMK 시나리오에 사용되는 클라이언트 ID
properties.fullyQualifiedDomainName	string	서버의 정규화된 도메인 이름입니다.
properties.keyId	string	암호화에 사용할 키의 CMK URI입니다.
properties.minimalTlsVersion	string	최소 TLS 버전입니다. 허용되는 값: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId	string	기본적으로 사용할 사용자 할당 ID의 리소스 ID입니다.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	서버의 프라이빗 엔드포인트 연결 목록
properties.publicNetworkAccess	ServerNetworkAccessFlag	이 서버에 대해 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	이 서버에 대한 아웃바운드 네트워크 액세스를 제한할지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.
properties.state	string	서버의 상태입니다.
properties.version	string	서버의 버전입니다.
properties.workspaceFeature	ServerWorkspaceFeature	기존 서버에 작업 영역이 만들어졌는지 여부 및 작업 영역에서의 연결을 허용하는지 여부
tags	object	리소스 태그.
type	string	리소스 종류.

ServerExternalAdministrator

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

Name	형식	Description
administratorType	AdministratorType	심각도 관리자의 유형입니다.
azureADOnlyAuthentication	boolean	Azure Active Directory만 인증을 사용하도록 설정했습니다.
login	string	서버 관리자의 로그인 이름입니다.
principalType	PrincipalType	보안 주체 관리자의 유형입니다.
sid	string	서버 관리자의 SID(개체 ID)입니다.
tenantId	string	관리자의 테넌트 ID입니다.

ServerNetworkAccessFlag

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

Name	형식	Description
Disabled	string
Enabled	string

ServerPrivateEndpointConnection

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

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

ServerWorkspaceFeature

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

Name	형식	Description
Connected	string
Disconnected	string

UserIdentity