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

Server Dns Aliases - Create Or Update

参考

服务:: SQL Database

API 版本:: 2021-11-01

创建服务器 DNS 别名。

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

URI 参数

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

响应

名称	类型	说明
200 OK	ServerDnsAlias	服务器 DNS 别名已存在。
201 Created	ServerDnsAlias	已成功创建服务器 DNS 别名。
202 Accepted		已接受
Other Status Codes		错误响应：*** 400 InvalidServerDnsAliasAcquireRequest - 获取服务器 DNS 别名请求正文为空或无效， (它应包含旧的服务器别名 ID，例如：/subscriptions/00000000-1111-2222-3333-44444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1) 。 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId - 请求正文中的旧服务器 DNS 别名 ID 为空或无效， (其格式应为：/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1) 。 400 ServerDnsAliasDoesNotExist - 服务器上不存在服务器 DNS 别名。 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - 服务器 DNS 别名对于已启用表审核的数据库无法正常工作 400 UnableToCreateServerDnsAliasDueToTableAuditing - 无法为已启用表审核的服务器创建服务器 DNS 别名。 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb - 无法为服务器“”{0}创建服务器 DNS 别名，因为数据库“”{1}已启用表审核或启用安全访问功能。 400 LimitOfServerDnsAliasesPerServerExceeded - 创建新的服务器 DNS 别名将超过每个服务器允许的服务器 DNS 别名数。 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias - 服务器 Dns 别名对于已启用表审核的服务器无法正常工作 400 CannotUseReservedDatabaseName - 此操作中无法使用保留的数据库名称。 400 TokenTooLong - 提供的令牌太长。 400 UnableToResolveRemoteServer - 由于服务器名称无效或 DNS 连接问题，无法解析远程伙伴服务器名称。 400 InvalidServerName - 指定的服务器名称无效。 400 InvalidIdentifier - 标识符包含 NULL 或无效的 unicode 字符。 400 InvalidServerDnsAliasName - 提供的服务器 DNS 别名无效。 400 ServerNotFound - 找不到请求的服务器。 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。 404 ResourceNotFound - 找不到请求的资源。 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。 404 ServerNotInSubscription - 指定的服务器不存在于指定的订阅中。 404 OperationIdNotFound - ID 为的操作不存在。 409 ServerDnsAliasBusy - 服务器 DNS 别名正忙于另一个操作。 409 SubscriptionDisabled - 订阅已禁用。 409 ServerDnsAliasDnsRecordInUse - 请求的终结点存在重复的 DNS 记录。 409 ServerDnsAliasAlreadyExists - 给定服务器上已存在服务器 DNS 别名。 409 ConflictingServerOperation - 服务器当前正在进行操作。 409 OperationCancelled - 用户已取消操作。 409 操作中断 - 无法完成对资源的操作，因为同一资源上的另一个操作中断了该操作。 429 SubscriptionTooManyCreateUpdateRequests - 请求数超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyRequests - 请求数超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyCreateUpdateRequests - 请求数超出可用资源可以处理的最大请求数。 429 SubscriptionTooManyRequests - 请求数超出可用资源可以处理的最大请求数。 500 OperationTimedOut - 操作超时并自动回滚。请重试该操作。 503 TooManyRequests - 请求数超出可用资源可以处理的最大请求数。 503 TooManyRequests - 请求数超出可用资源可以处理的最大请求数。 504 RequestTimeout - 服务请求超出了允许的超时。

示例

Create server DNS alias

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-server/dnsAliases/dns-alias-name-1?api-version=2021-11-01


/**
 * Samples for ServerDnsAliases CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerDnsAliasCreateOrUpdate.json
     */
    /**
     * Sample code: Create server DNS alias.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createServerDNSAlias(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerDnsAliases().createOrUpdate("Default", "dns-alias-server",
            "dns-alias-name-1", 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/Default/providers/Microsoft.Sql/servers/dns-alias-server/dnsAliases/dns-alias-name-1",
  "name": "dns-alias-name-1",
  "type": "Microsoft.Sql/servers/dnsAliases",
  "properties": {
    "azureDnsRecord": "dns-alias-name-1.database.windows.net"
  }
}

状态代码:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-server/dnsAliases/dns-alias-name-1",
  "name": "dns-alias-name-1",
  "type": "Microsoft.Sql/servers/dnsAliases",
  "properties": {
    "azureDnsRecord": "dns-alias-name-1.database.windows.net"
  }
}

状态代码:: 202

定义

ServerDnsAlias

服务器 DNS 别名。

名称	类型	说明
id	string	资源 ID。
name	string	资源名称。
properties.azureDnsRecord	string	别名的完全限定的 DNS 记录
type	string	资源类型。

通过