Servers - Update
更新伺服器。
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2021-11-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
resource
|
path | True |
string |
包含資源的資源群組名稱。 您可以從 Azure 資源管理員 API 或入口網站取得這個值。 |
server
|
path | True |
string |
伺服器的名稱。 |
subscription
|
path | True |
string |
可識別 Azure 訂用帳戶的訂用帳戶識別碼。 |
api-version
|
query | True |
string |
要用於要求的 API 版本。 |
要求本文
名稱 | 類型 | Description |
---|---|---|
identity |
伺服器身分識別 |
|
properties.administratorLogin |
string |
伺服器的系統管理員用戶名稱。 建立之後,就無法變更。 |
properties.administratorLoginPassword |
string |
伺服器建立) 所需的系統管理員登入密碼 (。 |
properties.administrators |
伺服器的 Azure Active Directory 系統管理員。 |
|
properties.federatedClientId |
string |
用於跨租使用者 CMK 案例的用戶端標識碼 |
properties.keyId |
string |
要用於加密之金鑰的 CMK URI。 |
properties.minimalTlsVersion |
string |
最低 TLS 版本。 允許的值:'1.0'、'1.1'、'1.2' |
properties.primaryUserAssignedIdentityId |
string |
預設會使用之使用者指派身分識別的資源標識碼。 |
properties.publicNetworkAccess |
是否允許此伺服器的公用端點存取。 值是選擇性的,但如果傳入,則必須是 'Enabled' 或 'Disabled' |
|
properties.restrictOutboundNetworkAccess |
是否要限制此伺服器的輸出網路存取。 值是選擇性的,但如果傳入,則必須是 'Enabled' 或 'Disabled' |
|
properties.version |
string |
伺服器版本。 |
tags |
object |
資源標籤。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
已成功更新伺服器。 |
|
202 Accepted |
已接受 |
|
Other Status Codes |
錯誤回應: ≦
|
範例
Update a server
範例要求
PATCH 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",
"publicNetworkAccess": "Disabled",
"restrictOutboundNetworkAccess": "Enabled"
}
}
範例回覆
{
"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",
"publicNetworkAccess": "Disabled",
"restrictOutboundNetworkAccess": "Enabled",
"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"
}
}
}
]
}
}
定義
名稱 | Description |
---|---|
Administrator |
伺服器管理員的類型。 |
Identity |
識別類型。 將此設定為 『SystemAssigned』,以便自動建立並指派資源的 Azure Active Directory 主體。 |
Principal |
伺服器管理員的主體類型。 |
Private |
私人端點連線的屬性。 |
Private |
|
Private |
私人端點連線的狀態。 |
Private |
私人鏈接服務連線所需的動作。 |
Private |
|
Private |
私人鏈接服務連線狀態。 |
Resource |
資源的 Azure Active Directory 身分識別設定。 |
Server |
Azure SQL 資料庫伺服器。 |
Server |
Active Directory 系統管理員的屬性。 |
Server |
是否允許此伺服器的公用端點存取。 值是選擇性的,但如果傳入,則必須是 'Enabled' 或 'Disabled' |
Server |
伺服器下的私人端點連線 |
Server |
Azure SQL 資料庫伺服器的更新要求。 |
Server |
現有伺服器是否已建立工作區,以及是否允許從工作區進行連線 |
User |
資源的 Azure Active Directory 身分識別設定。 |
AdministratorType
伺服器管理員的類型。
名稱 | 類型 | Description |
---|---|---|
ActiveDirectory |
string |
IdentityType
識別類型。 將此設定為 『SystemAssigned』,以便自動建立並指派資源的 Azure Active Directory 主體。
名稱 | 類型 | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned,UserAssigned |
string |
|
UserAssigned |
string |
PrincipalType
伺服器管理員的主體類型。
名稱 | 類型 | Description |
---|---|---|
Application |
string |
|
Group |
string |
|
User |
string |
PrivateEndpointConnectionProperties
私人端點連線的屬性。
名稱 | 類型 | Description |
---|---|---|
groupIds |
string[] |
群組標識碼。 |
privateEndpoint |
線上所屬的私人端點。 |
|
privateLinkServiceConnectionState |
私人端點連線的連接狀態。 |
|
provisioningState |
私人端點連線的狀態。 |
PrivateEndpointProperty
名稱 | 類型 | Description |
---|---|---|
id |
string |
私人端點的資源標識碼。 |
PrivateEndpointProvisioningState
私人端點連線的狀態。
名稱 | 類型 | Description |
---|---|---|
Approving |
string |
|
Dropping |
string |
|
Failed |
string |
|
Ready |
string |
|
Rejecting |
string |
PrivateLinkServiceConnectionStateActionsRequire
私人鏈接服務連線所需的動作。
名稱 | 類型 | Description |
---|---|---|
None |
string |
PrivateLinkServiceConnectionStateProperty
名稱 | 類型 | Description |
---|---|---|
actionsRequired |
私人鏈接服務連線所需的動作。 |
|
description |
string |
私人鏈接服務連線描述。 |
status |
私人鏈接服務連線狀態。 |
PrivateLinkServiceConnectionStateStatus
私人鏈接服務連線狀態。
名稱 | 類型 | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
ResourceIdentity
資源的 Azure Active Directory 身分識別設定。
名稱 | 類型 | Description |
---|---|---|
principalId |
string |
Azure Active Directory 主體標識符。 |
tenantId |
string |
Azure Active Directory 租用戶標識符。 |
type |
識別類型。 將此設定為 『SystemAssigned』,以便自動建立並指派資源的 Azure Active Directory 主體。 |
|
userAssignedIdentities |
<string,
User |
要使用的使用者指派身分識別的資源標識碼 |
Server
Azure SQL 資料庫伺服器。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源識別碼。 |
identity |
伺服器的 Azure Active Directory 身分識別。 |
|
kind |
string |
SQL Server 的類型。 這是用於 Azure 入口網站 體驗的元數據。 |
location |
string |
資源位置。 |
name |
string |
資源名稱。 |
properties.administratorLogin |
string |
伺服器的系統管理員用戶名稱。 建立之後,就無法變更。 |
properties.administratorLoginPassword |
string |
伺服器建立) 所需的系統管理員登入密碼 (。 |
properties.administrators |
伺服器的 Azure Active Directory 系統管理員。 |
|
properties.federatedClientId |
string |
用於跨租使用者 CMK 案例的用戶端標識碼 |
properties.fullyQualifiedDomainName |
string |
伺服器的完整功能變數名稱。 |
properties.keyId |
string |
要用於加密之金鑰的 CMK URI。 |
properties.minimalTlsVersion |
string |
最低 TLS 版本。 允許的值:'1.0'、'1.1'、'1.2' |
properties.primaryUserAssignedIdentityId |
string |
預設會使用之使用者指派身分識別的資源標識碼。 |
properties.privateEndpointConnections |
伺服器上的私人端點連線清單 |
|
properties.publicNetworkAccess |
是否允許此伺服器的公用端點存取。 值是選擇性的,但如果傳入,則必須是 'Enabled' 或 'Disabled' |
|
properties.restrictOutboundNetworkAccess |
是否要限制此伺服器的輸出網路存取。 值是選擇性的,但如果傳入,則必須是 'Enabled' 或 'Disabled' |
|
properties.state |
string |
伺服器的狀態。 |
properties.version |
string |
伺服器版本。 |
properties.workspaceFeature |
現有伺服器是否已建立工作區,以及是否允許從工作區進行連線 |
|
tags |
object |
資源標籤。 |
type |
string |
資源類型。 |
ServerExternalAdministrator
Active Directory 系統管理員的屬性。
名稱 | 類型 | Description |
---|---|---|
administratorType |
伺服器管理員的類型。 |
|
azureADOnlyAuthentication |
boolean |
僅啟用 Azure Active Directory 驗證。 |
login |
string |
伺服器管理員的登入名稱。 |
principalType |
伺服器管理員的主體類型。 |
|
sid |
string |
伺服器管理員) SID (物件識別碼。 |
tenantId |
string |
系統管理員的租用戶標識碼。 |
ServerNetworkAccessFlag
是否允許此伺服器的公用端點存取。 值是選擇性的,但如果傳入,則必須是 'Enabled' 或 'Disabled'
名稱 | 類型 | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ServerPrivateEndpointConnection
伺服器下的私人端點連線
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源識別碼。 |
properties |
私人端點連線屬性 |
ServerUpdate
Azure SQL 資料庫伺服器的更新要求。
名稱 | 類型 | Description |
---|---|---|
identity |
伺服器身分識別 |
|
properties.administratorLogin |
string |
伺服器的系統管理員用戶名稱。 建立之後,就無法變更。 |
properties.administratorLoginPassword |
string |
伺服器建立) 所需的系統管理員登入密碼 (。 |
properties.administrators |
伺服器的 Azure Active Directory 系統管理員。 |
|
properties.federatedClientId |
string |
用於跨租使用者 CMK 案例的用戶端標識碼 |
properties.fullyQualifiedDomainName |
string |
伺服器的完整功能變數名稱。 |
properties.keyId |
string |
要用於加密之金鑰的 CMK URI。 |
properties.minimalTlsVersion |
string |
最低 TLS 版本。 允許的值:'1.0'、'1.1'、'1.2' |
properties.primaryUserAssignedIdentityId |
string |
預設會使用之使用者指派身分識別的資源標識碼。 |
properties.privateEndpointConnections |
伺服器上的私人端點連線清單 |
|
properties.publicNetworkAccess |
是否允許此伺服器的公用端點存取。 值是選擇性的,但如果傳入,則必須是 'Enabled' 或 'Disabled' |
|
properties.restrictOutboundNetworkAccess |
是否要限制此伺服器的輸出網路存取。 值是選擇性的,但如果傳入,則必須是 'Enabled' 或 'Disabled' |
|
properties.state |
string |
伺服器的狀態。 |
properties.version |
string |
伺服器版本。 |
properties.workspaceFeature |
現有伺服器是否已建立工作區,以及是否允許從工作區進行連線 |
|
tags |
object |
資源標籤。 |
ServerWorkspaceFeature
現有伺服器是否已建立工作區,以及是否允許從工作區進行連線
名稱 | 類型 | Description |
---|---|---|
Connected |
string |
|
Disconnected |
string |
UserIdentity
資源的 Azure Active Directory 身分識別設定。
名稱 | 類型 | Description |
---|---|---|
clientId |
string |
Azure Active Directory 用戶端標識符。 |
principalId |
string |
Azure Active Directory 主體標識符。 |