Servers - Update

更新伺服器。

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

URI 參數

Name In Required Type Description
resourceGroupName
path True
  • string

包含資源的資源群組名稱。 您可以從 Azure 資源管理員 API 或入口網站取得這個值。

serverName
path True
  • string

伺服器的名稱。

subscriptionId
path True
  • string

可識別 Azure 訂用帳戶的訂用帳戶識別碼。

api-version
query True
  • string

要用於要求的 API 版本。

要求本文

Name Type Description
properties.administratorLogin
  • string

伺服器的系統管理員使用者名稱。 一旦建立之後,就無法變更。

properties.administratorLoginPassword
  • string

伺服器建立) 所需的系統管理員登入密碼 (。

properties.minimalTlsVersion
  • string

基本 TLS 版本。 允許的值: ' 1.0 '、' 1.1 '、' 1.2 '

properties.publicNetworkAccess

此伺服器是否允許公用端點存取。 值是選擇性的,但如果傳入,則必須為「已啟用」或「已停用」

properties.version
  • string

伺服器版本。

tags
  • object

資源標籤。

回應

Name Type Description
200 OK

已成功補救伺服器。

202 Accepted

已接受

Other Status Codes

錯誤回應: * * _

_ 400 NameAlreadyExists-提供的名稱已經存在。

  • 400 ProvisioningDisabled-依原樣顯示來自資源作業授權者的錯誤訊息,不進行變更

  • 400 InvalidLoginName-提供的登入名稱無效。

  • 400 InvalidUsername 提供的使用者名稱包含不正確字元。

  • 400 PasswordTooShort-提供的密碼太短

  • 400 RegionDoesNotSupportVersion-使用者嘗試在不支援該伺服器版本的位置中,建立指定版本的伺服器。

  • 400 PasswordTooLong-提供的密碼太長。

  • 400 PasswordNotComplex-提供的密碼不夠複雜。

  • 400 SubscriptionNotFound-找不到要求的訂用帳戶。

  • 400 InvalidParameterValue-為參數提供了不正確值。

  • 400 InvalidLocation-指定了不正確位置。

  • 400 InvalidServerName-指定的伺服器名稱無效。

  • 400 InvalidIdentifier-識別碼包含 Null 或不正確 unicode 字元。

  • 400 TokenTooLong-提供的權杖太長。

  • 400 ServerNotFound-找不到要求的伺服器。

  • 400 RegionDoesNotAllowProvisioning-選取的位置不接受新的 Windows Azure SQL Database server。 這可能會在稍後變更。

  • 400 InvalidMinimalTlsVersion-不正確基本 TLS 版本。

  • 404 SubscriptionDoesNotHaveServer-找不到要求的伺服器

  • 404 ServerNotInSubscriptionResourceGroup-指定的資源群組和訂用帳戶中不存在指定的伺服器。

  • 404 OperationIdNotFound-識別碼的作業不存在。

  • 409 OperationCancelled-使用者已取消操作。

  • 409 OperationInterrupted-無法完成資源上的作業,因為相同資源上的另一個作業中斷了此作業。

  • 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=2019-06-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

Private link 服務連線所需的動作。

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

Private link 服務連接狀態。

ResourceIdentity

Azure Active Directory 資源的身分識別設定。

Server

Azure SQL Database 的伺服器。

ServerPrivateEndpointConnection

伺服器底下的私人端點連接

ServerPublicNetworkAccess

此伺服器是否允許公用端點存取。 值是選擇性的,但如果傳入,則必須為「已啟用」或「已停用」

ServerUpdate

Azure SQL Database 伺服器的更新要求。

IdentityType

身分識別類型。 將此設定為 ' SystemAssigned ',以便自動建立並指派資源的 Azure Active Directory 主體。

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

PrivateEndpointConnectionProperties

私人端點連接的屬性。

Name Type Description
privateEndpoint

連接所屬的私人端點。

privateLinkServiceConnectionState

私人端點連接的連接狀態。

provisioningState

私人端點連接的狀態。

PrivateEndpointProperty

Name Type Description
id
  • string

私人端點的資源識別碼。

PrivateEndpointProvisioningState

私人端點連接的狀態。

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

PrivateLinkServiceConnectionStateActionsRequire

Private link 服務連線所需的動作。

Name Type Description
None
  • string

PrivateLinkServiceConnectionStateProperty

Name Type Description
actionsRequired

Private link 服務連線所需的動作。

description
  • string

Private link 服務連接描述。

status

Private link 服務連接狀態。

PrivateLinkServiceConnectionStateStatus

Private link 服務連接狀態。

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

ResourceIdentity

Azure Active Directory 資源的身分識別設定。

Name Type Description
principalId
  • string

Azure Active Directory 主體識別碼。

tenantId
  • string

Azure Active Directory 的租使用者識別碼。

type

身分識別類型。 將此設定為 ' SystemAssigned ',以便自動建立並指派資源的 Azure Active Directory 主體。

Server

Azure SQL Database 的伺服器。

Name Type Description
id
  • string

資源識別碼。

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

此伺服器是否允許公用端點存取。 值是選擇性的,但如果傳入,則必須為「已啟用」或「已停用」

properties.state
  • string

伺服器的狀態。

properties.version
  • string

伺服器版本。

tags
  • object

資源標籤。

type
  • string

資源類型。

ServerPrivateEndpointConnection

伺服器底下的私人端點連接

Name Type Description
id
  • string

資源識別碼。

properties

私人端點連接屬性

ServerPublicNetworkAccess

此伺服器是否允許公用端點存取。 值是選擇性的,但如果傳入,則必須為「已啟用」或「已停用」

Name Type Description
Disabled
  • string
Enabled
  • string

ServerUpdate

Azure SQL Database 伺服器的更新要求。

Name Type Description
properties.administratorLogin
  • string

伺服器的系統管理員使用者名稱。 一旦建立之後,就無法變更。

properties.administratorLoginPassword
  • string

伺服器建立) 所需的系統管理員登入密碼 (。

properties.fullyQualifiedDomainName
  • string

伺服器的完整功能變數名稱。

properties.minimalTlsVersion
  • string

基本 TLS 版本。 允許的值: ' 1.0 '、' 1.1 '、' 1.2 '

properties.privateEndpointConnections

伺服器上的私人端點連接清單

properties.publicNetworkAccess

此伺服器是否允許公用端點存取。 值是選擇性的,但如果傳入,則必須為「已啟用」或「已停用」

properties.state
  • string

伺服器的狀態。

properties.version
  • string

伺服器版本。

tags
  • object

資源標籤。