你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Servers - Create Or Update

服务:: SQL Database

API 版本:: 2023-08-01

创建或更新服务器。

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

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string	包含资源的资源组的名称。可以从 Azure 资源管理器 API 或门户获取此值。
serverName	path	True	string	服务器的名称。
subscriptionId	path	True	string	标识 Azure 订阅的订阅 ID。
api-version	query	True	string	要用于请求的 API 版本。

请求正文

名称	必需	类型	说明
location	True	string	资源位置。
identity		ResourceIdentity	服务器的 Azure Active Directory 标识。
properties.administratorLogin		string	服务器的管理员用户名。创建后，无法更改它。
properties.administratorLoginPassword		string	管理员登录密码（创建服务器时需要）。
properties.administrators		ServerExternalAdministrator	服务器的 Azure Active Directory 管理员。这只能在服务器创建时使用。如果用于服务器更新，将忽略它，否则将导致错误。对于各个 API 的更新，需要使用这些 API。
properties.federatedClientId		string (uuid)	用于跨租户 CMK 方案的客户端 ID
properties.isIPv6Enabled		ServerNetworkAccessFlag	是否为此服务器启用 IPv6 支持。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”
properties.keyId		string	要用于加密的密钥的 CMK URI。
properties.minimalTlsVersion		MinimalTlsVersion	最低 TLS 版本。允许的值：“None”、“1.0”、“1.1”、“1.2”、“1.3”
properties.primaryUserAssignedIdentityId		string	默认情况下要使用的用户分配标识的资源 ID。
properties.publicNetworkAccess		ServerPublicNetworkAccessFlag	是否允许对此服务器使用公共终结点访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”或“SecuredByPerimeter”
properties.restrictOutboundNetworkAccess		ServerNetworkAccessFlag	是否限制此服务器的出站网络访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”
properties.version		string	服务器的版本。
tags		object	资源标记。

响应

名称	类型	说明
200 OK	Server	已成功更新服务器。
201 Created	Server	已成功创建服务器。
202 Accepted		接受标头 Location: string
Other Status Codes	ErrorResponse	错误响应： *** 400 ManagedInstanceStoppingOrStopped - 实例处于停止/停止状态时提交的冲突作 400 ManagedInstanceStarting - 实例处于启动状态时提交的冲突作 400 NameAlreadyExistsSoftDeleted - 请求的服务器名称由处于软删除状态的服务器获取。清除或恢复服务器以取消阻止。 400 MissingIdentityId - 当标识类型设置为 UserAssigned 时，不会提供用户分配的标识 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 由用户在创建期间提供，但在 API 调用中未提供 PrimaryUserAssignedIdentityId 400 InvalidIdentityTypeForKeyId - KeyId 在创建过程中由用户提供，但标识类型未设置为“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 或无效的 unicode 字符。 400 TokenTooLong - 提供的令牌太长。 400 CMKOperationNotAllowed - 当服务器没有 Azure Key Vault 访问时，用户尝试在服务器上执行作。 400 ServerNotFound - 找不到请求的服务器。 400 RegionDoesNotAllowProvisioning - 所选位置不接受新的 Windows Azure SQL 数据库服务器。这可能会在以后更改。 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 - 请求超出可用资源可以处理的最大请求数。

示例

Create server

PUT 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",
    "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",
    "isIPv6Enabled": "Enabled"
  },
  "location": "Japan East"
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ServerCreate.json
// this example is just showing the usage of "Servers_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://free.blessedness.top/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "sqlcrudtest-7398";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this SqlServerResource
SqlServerCollection collection = resourceGroupResource.GetSqlServers();

// invoke the operation
string serverName = "sqlcrudtest-4645";
SqlServerData data = new SqlServerData(new AzureLocation("Japan East"))
{
    AdministratorLogin = "dummylogin",
    AdministratorLoginPassword = "PLACEHOLDER",
    PublicNetworkAccess = ServerNetworkAccessFlag.Enabled,
    Administrators = new ServerExternalAdministrator
    {
        PrincipalType = SqlServerPrincipalType.User,
        Login = "bob@contoso.com",
        Sid = Guid.Parse("00000011-1111-2222-2222-123456789111"),
        TenantId = Guid.Parse("00000011-1111-2222-2222-123456789111"),
        IsAzureADOnlyAuthenticationEnabled = true,
    },
    RestrictOutboundNetworkAccess = ServerNetworkAccessFlag.Enabled,
    IsIPv6Enabled = ServerNetworkAccessFlag.Enabled,
};
ArmOperation<SqlServerResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, serverName, data);
SqlServerResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlServerData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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",
    "isIPv6Enabled": "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",
    "isIPv6Enabled": "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

定义

名称	说明
AdministratorType	服务器管理员的类型。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
ExternalGovernanceStatus	外部治理的状态。
IdentityType	标识类型。将此设置为“SystemAssigned”，以便自动为资源创建和分配 Azure Active Directory 主体。
MinimalTlsVersion	最低 TLS 版本。允许的值：“None”、“1.0”、“1.1”、“1.2”、“1.3”
PrincipalType	服务器管理员的主体类型。
PrivateEndpointConnectionProperties	专用终结点连接的属性。
PrivateEndpointProperty
PrivateEndpointProvisioningState	专用终结点连接的状态。
PrivateLinkServiceConnectionStateActionsRequire	专用链接服务连接所需的作。
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	专用链接服务连接状态。
ResourceIdentity	资源的 Azure Active Directory 标识配置。
Server	Azure SQL 数据库服务器。
ServerExternalAdministrator	Active Directory 管理员的属性。
ServerNetworkAccessFlag	是否限制此服务器的出站网络访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”
ServerPrivateEndpointConnection	服务器下的专用终结点连接
ServerPublicNetworkAccessFlag	是否允许对此服务器使用公共终结点访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”或“SecuredByPerimeter”
ServerWorkspaceFeature	现有服务器是否创建了工作区，以及是否允许从工作区进行连接
UserIdentity	资源的 Azure Active Directory 标识配置。

AdministratorType

枚举

服务器管理员的类型。

值	说明
ActiveDirectory

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

ExternalGovernanceStatus

枚举

外部治理的状态。

值	说明
Enabled
Disabled

IdentityType

枚举

标识类型。将此设置为“SystemAssigned”，以便自动为资源创建和分配 Azure Active Directory 主体。

值	说明
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

MinimalTlsVersion

枚举

最低 TLS 版本。允许的值：“None”、“1.0”、“1.1”、“1.2”、“1.3”

值	说明
None
1.0
1.1
1.2
1.3

PrincipalType

枚举

服务器管理员的主体类型。

值	说明
User
Group
Application

PrivateEndpointConnectionProperties

Object

专用终结点连接的属性。

名称	类型	说明
groupIds	string[]	组 ID。
privateEndpoint	PrivateEndpointProperty	连接所属的专用终结点。
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	专用终结点连接的连接状态。
provisioningState	PrivateEndpointProvisioningState	专用终结点连接的状态。

PrivateEndpointProperty

Object

名称	类型	说明
id	string	专用终结点的资源 ID。

PrivateEndpointProvisioningState

枚举

专用终结点连接的状态。

值	说明
Approving
Ready
Dropping
Failed
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

枚举

专用链接服务连接所需的作。

值	说明
None

PrivateLinkServiceConnectionStateProperty

Object

名称	类型	说明
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	专用链接服务连接所需的作。
description	string	专用链接服务连接说明。
status	PrivateLinkServiceConnectionStateStatus	专用链接服务连接状态。

PrivateLinkServiceConnectionStateStatus

枚举

专用链接服务连接状态。

值	说明
Approved
Pending
Rejected
Disconnected

ResourceIdentity

Object

资源的 Azure Active Directory 标识配置。

名称	类型	说明
principalId	string (uuid)	Azure Active Directory 主体 ID。
tenantId	string (uuid)	Azure Active Directory 租户 ID。
type	IdentityType	标识类型。将此设置为“SystemAssigned”，以便自动为资源创建和分配 Azure Active Directory 主体。
userAssignedIdentities	<string, UserIdentity>	要使用的用户分配标识的资源 ID

Server

Object

Azure SQL 数据库服务器。

名称	类型	说明
id	string	资源 ID。
identity	ResourceIdentity	服务器的 Azure Active Directory 标识。
kind	string	SQL Server 的类型。这是用于 Azure 门户体验的元数据。
location	string	资源位置。
name	string	资源名称。
properties.administratorLogin	string	服务器的管理员用户名。创建后，无法更改它。
properties.administratorLoginPassword	string	管理员登录密码（创建服务器时需要）。
properties.administrators	ServerExternalAdministrator	服务器的 Azure Active Directory 管理员。这只能在服务器创建时使用。如果用于服务器更新，将忽略它，否则将导致错误。对于各个 API 的更新，需要使用这些 API。
properties.externalGovernanceStatus	ExternalGovernanceStatus	外部治理的状态。
properties.federatedClientId	string (uuid)	用于跨租户 CMK 方案的客户端 ID
properties.fullyQualifiedDomainName	string	服务器的完全限定域名。
properties.isIPv6Enabled	ServerNetworkAccessFlag	是否为此服务器启用 IPv6 支持。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”
properties.keyId	string	要用于加密的密钥的 CMK URI。
properties.minimalTlsVersion	MinimalTlsVersion	最低 TLS 版本。允许的值：“None”、“1.0”、“1.1”、“1.2”、“1.3”
properties.primaryUserAssignedIdentityId	string	默认情况下要使用的用户分配标识的资源 ID。
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	服务器上的专用终结点连接列表
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	是否允许对此服务器使用公共终结点访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”或“SecuredByPerimeter”
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	是否限制此服务器的出站网络访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”
properties.state	string	服务器的状态。
properties.version	string	服务器的版本。
properties.workspaceFeature	ServerWorkspaceFeature	现有服务器是否创建了工作区，以及是否允许从工作区进行连接
tags	object	资源标记。
type	string	资源类型。

ServerExternalAdministrator

Object

Active Directory 管理员的属性。

名称	类型	说明
administratorType	AdministratorType	服务器管理员的类型。
azureADOnlyAuthentication	boolean	仅启用 Azure Active Directory 身份验证。
login	string	服务器管理员的登录名。
principalType	PrincipalType	服务器管理员的主体类型。
sid	string (uuid)	服务器管理员的 SID （对象 ID）。
tenantId	string (uuid)	管理员的租户 ID。

ServerNetworkAccessFlag

枚举

是否限制此服务器的出站网络访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”

值	说明
Enabled
Disabled

ServerPrivateEndpointConnection

Object

服务器下的专用终结点连接

名称	类型	说明
id	string	资源 ID。
properties	PrivateEndpointConnectionProperties	专用终结点连接属性

ServerPublicNetworkAccessFlag

枚举

是否允许对此服务器使用公共终结点访问。值是可选的，但如果传入，则必须为“Enabled”或“Disabled”或“SecuredByPerimeter”

值	说明
Enabled
Disabled
SecuredByPerimeter

ServerWorkspaceFeature

枚举

现有服务器是否创建了工作区，以及是否允许从工作区进行连接

值	说明
Connected
Disconnected

UserIdentity

Object

资源的 Azure Active Directory 标识配置。

名称	类型	说明
clientId	string (uuid)	Azure Active Directory 客户端 ID。
principalId	string (uuid)	Azure Active Directory 主体 ID。

通过

Servers - Create Or Update

URI 参数

请求正文

响应

示例

Create server

示例请求

示例响应

定义

AdministratorType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

IdentityType

MinimalTlsVersion

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerPublicNetworkAccessFlag

ServerWorkspaceFeature

UserIdentity