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

Servers - Update

更新服务器。

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

URI 参数

Name In Required Type Description
resourceGroupName
path True
  • string

包含该资源的资源组名称。 可以从 Azure 资源管理器 API 或门户获取此值。

serverName
path True
  • string

服务器的名称。

subscriptionId
path True
  • string

用于标识 Azure 订阅的订阅 ID。

api-version
query True
  • string

要用于请求的 API 版本。

请求正文

Name Type Description
identity

服务器标识

properties.administratorLogin
  • string

服务器的管理员用户名。 创建后,无法更改它。

properties.administratorLoginPassword
  • string

创建服务器) 所需的管理员登录密码 (。

properties.minimalTlsVersion
  • string

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

properties.publicNetworkAccess

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

properties.version
  • string

服务器的版本。

tags
  • object

资源标记。

响应

Name Type Description
200 OK

已成功更新服务器。

202 Accepted

已接受

Other Status Codes

错误响应: ***

  • 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 ProvisioningDisabled - 按原样显示资源操作授权者的错误消息,无需更改

  • 400 InvalidLoginName - 提供的登录名无效。

  • 400 InvalidUsername - 提供的用户名包含无效字符。

  • 400 PasswordTooShort - 提供的密码太短

  • 400 AadOnlyAuthenticationIsEnabled - Azure Active Directory仅启用身份验证。 请联系你的系统管理员。

  • 400 RegionDoesNotSupportVersion - 用户尝试在不支持该服务器版本的位置创建指定版本的服务器。

  • 400 PasswordTooLong - 提供的密码太长。

  • 400 PasswordNotComplex - 提供的密码不够复杂。

  • 400 SubscriptionNotFound - 找不到请求的订阅。

  • 400 InvalidParameterValue - 向参数提供无效值。

  • 400 InvalidLocation - 指定了无效位置。

  • 400 InvalidServerName - 指定的服务器名称无效。

  • 400 InvalidIdentifier - 标识符包含 NULL 或无效 unicode 字符。

  • 400 TokenTooLong - 提供的令牌太长。

  • 400 RegionDoesNotAllowProvisioning - 所选位置不接受新的Windows Azure SQL 数据库服务器。 这可能会在以后更改。

  • 400 ServerNotFound - 找不到请求的服务器。

  • 400 InvalidMinimalTlsVersion - 最小 TLS 版本无效。

  • 404 SubscriptionDoesNotHaveServer - 找不到请求的服务器

  • 404 ServerNotInSubscriptionResourceGroup - 指定的服务器不存在于指定的资源组和订阅中。

  • 404 OperationIdNotFound - ID 的操作不存在。

  • 409 OperationCancelled - 操作已被用户取消。

  • 409 OperationInterrupted - 无法完成资源上的操作,因为它被同一资源上的另一个操作中断。

  • 409 UpsertLogicalServerRequestAlreadyInProgress - 正在进行的逻辑服务器请求正在进行中,请稍后再次尝试请求。

  • 409 ServerDisabled - 服务器已禁用。

  • 409 ConflictingServerOperation - 服务器当前正在进行操作。

  • 409 SubscriptionDisabled - 已禁用订阅。

  • 409 ServerQuotaExceeded - 无法将服务器添加到订阅,因为它将超过配额。

  • 409 ServerAlreadyExists - 重复服务器名称。

  • 429 SubscriptionTooManyCreateUpdateRequests - 请求超出了可用资源可以处理的最大请求。

  • 429 SubscriptionTooManyRequests - 请求超出可用资源可处理的最大请求数。

  • 429 ConflictingSubscriptionOperation - 订阅当前正在进行操作。

  • 500 OperationTimedOut - 操作超时并自动回滚。 请重试该操作。

  • 503 TooManyRequests - 请求超出可用资源可以处理的最大请求数。

示例

Update a server

Sample Request

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

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "<administratorLoginPassword>"
  }
}

Sample Response

{
  "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",
    "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"
          }
        }
      }
    ]
  }
}

定义

IdentityType

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

PrivateEndpointConnectionProperties

专用终结点连接的属性。

PrivateEndpointProperty
PrivateEndpointProvisioningState

专用终结点连接的状态。

PrivateLinkServiceConnectionStateActionsRequire

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

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

专用链接服务连接状态。

ResourceIdentity

Azure Active Directory资源的标识配置。

Server

Azure SQL 数据库服务器。

ServerPrivateEndpointConnection

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

ServerPublicNetworkAccess

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

ServerUpdate

Azure SQL 数据库服务器的更新请求。

ServerWorkspaceFeature

现有服务器是否创建了工作区,并且是否允许从工作区进行连接

IdentityType

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

Name Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

PrivateEndpointConnectionProperties

专用终结点连接的属性。

Name Type Description
privateEndpoint

连接所属的专用终结点。

privateLinkServiceConnectionState

专用终结点连接的连接状态。

provisioningState

专用终结点连接的状态。

PrivateEndpointProperty

Name Type Description
id
  • string

专用终结点的资源 ID。

PrivateEndpointProvisioningState

专用终结点连接的状态。

Name Type Description
Approving
  • string
Dropping
  • string
Failed
  • string
Ready
  • string
Rejecting
  • string

PrivateLinkServiceConnectionStateActionsRequire

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

Name Type Description
None
  • string

PrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

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

description
  • string

专用链接服务连接说明。

status

专用链接服务连接状态。

PrivateLinkServiceConnectionStateStatus

专用链接服务连接状态。

Name Type Description
Approved
  • string
Disconnected
  • string
Pending
  • string
Rejected
  • string

ResourceIdentity

Azure Active Directory资源的标识配置。

Name Type Description
principalId
  • string

Azure Active Directory主体 ID。

tenantId
  • string

Azure Active Directory租户 ID。

type

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

Server

Azure SQL 数据库服务器。

Name Type Description
id
  • string

资源 ID。

identity

服务器的Azure Active Directory标识。

kind
  • string

SQL Server 的类型。 这是用于Azure 门户体验的元数据。

location
  • string

资源位置。

name
  • string

资源名称。

properties.administratorLogin
  • string

服务器的管理员用户名。 创建后,无法更改它。

properties.administratorLoginPassword
  • string

创建服务器) 所需的管理员登录密码 (。

properties.fullyQualifiedDomainName
  • string

服务器的完全限定域名。

properties.minimalTlsVersion
  • string

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

properties.privateEndpointConnections

服务器上的专用终结点连接列表

properties.publicNetworkAccess

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

properties.state
  • string

服务器的状态。

properties.version
  • string

服务器的版本。

properties.workspaceFeature

现有服务器是否创建了工作区,并且是否允许从工作区进行连接

tags
  • object

资源标记。

type
  • string

资源类型。

ServerPrivateEndpointConnection

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

Name Type Description
id
  • string

资源 ID。

properties

专用终结点连接属性

ServerPublicNetworkAccess

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

Name Type Description
Disabled
  • string
Enabled
  • string

ServerUpdate

Azure SQL 数据库服务器的更新请求。

Name Type Description
identity

服务器标识

properties.administratorLogin
  • string

服务器的管理员用户名。 创建后,无法更改它。

properties.administratorLoginPassword
  • string

创建服务器) 所需的管理员登录密码 (。

properties.fullyQualifiedDomainName
  • string

服务器的完全限定域名。

properties.minimalTlsVersion
  • string

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

properties.privateEndpointConnections

服务器上的专用终结点连接列表

properties.publicNetworkAccess

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

properties.state
  • string

服务器的状态。

properties.version
  • string

服务器的版本。

properties.workspaceFeature

现有服务器是否创建了工作区,并且是否允许从工作区进行连接

tags
  • object

资源标记。

ServerWorkspaceFeature

现有服务器是否创建了工作区,并且是否允许从工作区进行连接

Name Type Description
Connected
  • string
Disconnected
  • string