Servers - Update
Aggiorna un server.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2021-11-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
resource
|
path | True |
string |
Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale. |
server
|
path | True |
string |
Nome del server. |
subscription
|
path | True |
string |
ID sottoscrizione che identifica una sottoscrizione di Azure. |
api-version
|
query | True |
string |
Versione dell'API da usare per la richiesta. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
identity |
Identità server |
|
properties.administratorLogin |
string |
Nome utente amministratore per il server. Dopo aver creato non è possibile modificarlo. |
properties.administratorLoginPassword |
string |
Password di accesso amministratore (richiesta per la creazione del server). |
properties.administrators |
Amministratore di Azure Active Directory del server. |
|
properties.federatedClientId |
string |
ID client usato per lo scenario CMK multi-tenant |
properties.keyId |
string |
URI CMK della chiave da usare per la crittografia. |
properties.minimalTlsVersion |
string |
Versione TLS minima. Valori consentiti: '1.0', '1.1', '1.2' |
properties.primaryUserAssignedIdentityId |
string |
ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita. |
properties.publicNetworkAccess |
Se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato" |
|
properties.restrictOutboundNetworkAccess |
Indica se limitare o meno l'accesso alla rete in uscita per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato" |
|
properties.version |
string |
Versione del server. |
tags |
object |
Tag di risorse. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Aggiornato correttamente il server. |
|
202 Accepted |
Accettato |
|
Other Status Codes |
Risposte agli errori: **
|
Esempio
Update a server
Esempio di richiesta
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"
}
}
Risposta di esempio
{
"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"
}
}
}
]
}
}
Definizioni
Nome | Descrizione |
---|---|
Administrator |
Tipo dell'amministratore di sever. |
Identity |
Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa. |
Principal |
Tipo di entità dell'amministratore di sever. |
Private |
Proprietà di una connessione endpoint privato. |
Private |
|
Private |
Stato della connessione dell'endpoint privato. |
Private |
Azioni necessarie per la connessione al servizio di collegamento privato. |
Private |
|
Private |
Stato di connessione del servizio di collegamento privato. |
Resource |
Configurazione delle identità di Azure Active Directory per una risorsa. |
Server |
Server di database Azure SQL. |
Server |
Proprietà di un amministratore di Active Directory. |
Server |
Se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato" |
Server |
Connessione endpoint privato in un server |
Server |
Richiesta di aggiornamento per un server di database Azure SQL. |
Server |
Se il server esistente ha un'area di lavoro creata e se consente la connessione dall'area di lavoro |
User |
Configurazione delle identità di Azure Active Directory per una risorsa. |
AdministratorType
Tipo dell'amministratore di sever.
Nome | Tipo | Descrizione |
---|---|---|
ActiveDirectory |
string |
IdentityType
Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned,UserAssigned |
string |
|
UserAssigned |
string |
PrincipalType
Tipo di entità dell'amministratore di sever.
Nome | Tipo | Descrizione |
---|---|---|
Application |
string |
|
Group |
string |
|
User |
string |
PrivateEndpointConnectionProperties
Proprietà di una connessione endpoint privato.
Nome | Tipo | Descrizione |
---|---|---|
groupIds |
string[] |
ID gruppo. |
privateEndpoint |
Endpoint privato a cui appartiene la connessione. |
|
privateLinkServiceConnectionState |
Stato della connessione dell'endpoint privato. |
|
provisioningState |
Stato della connessione dell'endpoint privato. |
PrivateEndpointProperty
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa dell'endpoint privato. |
PrivateEndpointProvisioningState
Stato della connessione dell'endpoint privato.
Nome | Tipo | Descrizione |
---|---|---|
Approving |
string |
|
Dropping |
string |
|
Failed |
string |
|
Ready |
string |
|
Rejecting |
string |
PrivateLinkServiceConnectionStateActionsRequire
Azioni necessarie per la connessione al servizio di collegamento privato.
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
PrivateLinkServiceConnectionStateProperty
Nome | Tipo | Descrizione |
---|---|---|
actionsRequired |
Azioni necessarie per la connessione al servizio di collegamento privato. |
|
description |
string |
Descrizione della connessione al servizio collegamento privato. |
status |
Stato di connessione del servizio di collegamento privato. |
PrivateLinkServiceConnectionStateStatus
Stato di connessione del servizio di collegamento privato.
Nome | Tipo | Descrizione |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
ResourceIdentity
Configurazione delle identità di Azure Active Directory per una risorsa.
Nome | Tipo | Descrizione |
---|---|---|
principalId |
string |
ID entità di Azure Active Directory. |
tenantId |
string |
ID tenant di Azure Active Directory. |
type |
Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa. |
|
userAssignedIdentities |
<string,
User |
ID risorsa delle identità assegnate dall'utente da usare |
Server
Server di database Azure SQL.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa. |
identity |
Identità di Azure Active Directory del server. |
|
kind |
string |
Tipo di sql server. Si tratta di metadati usati per l'esperienza di portale di Azure. |
location |
string |
Percorso della risorsa. |
name |
string |
Nome risorsa. |
properties.administratorLogin |
string |
Nome utente amministratore per il server. Dopo aver creato non è possibile modificarlo. |
properties.administratorLoginPassword |
string |
Password di accesso amministratore (richiesta per la creazione del server). |
properties.administrators |
Amministratore di Azure Active Directory del server. |
|
properties.federatedClientId |
string |
ID client usato per lo scenario CMK multi-tenant |
properties.fullyQualifiedDomainName |
string |
Nome di dominio completo del server. |
properties.keyId |
string |
URI CMK della chiave da usare per la crittografia. |
properties.minimalTlsVersion |
string |
Versione TLS minima. Valori consentiti: '1.0', '1.1', '1.2' |
properties.primaryUserAssignedIdentityId |
string |
ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita. |
properties.privateEndpointConnections |
Elenco delle connessioni endpoint private in un server |
|
properties.publicNetworkAccess |
Se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato" |
|
properties.restrictOutboundNetworkAccess |
Indica se limitare o meno l'accesso alla rete in uscita per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato" |
|
properties.state |
string |
Stato del server. |
properties.version |
string |
Versione del server. |
properties.workspaceFeature |
Se il server esistente ha un'area di lavoro creata e se consente la connessione dall'area di lavoro |
|
tags |
object |
Tag di risorse. |
type |
string |
Tipo di risorsa. |
ServerExternalAdministrator
Proprietà di un amministratore di Active Directory.
Nome | Tipo | Descrizione |
---|---|---|
administratorType |
Tipo dell'amministratore di sever. |
|
azureADOnlyAuthentication |
boolean |
Solo autenticazione di Azure Active Directory abilitata. |
login |
string |
Nome di accesso dell'amministratore del server. |
principalType |
Tipo di entità dell'amministratore di sever. |
|
sid |
string |
SID (ID oggetto) dell'amministratore del server. |
tenantId |
string |
ID tenant dell'amministratore. |
ServerNetworkAccessFlag
Se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato"
Nome | Tipo | Descrizione |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ServerPrivateEndpointConnection
Connessione endpoint privato in un server
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa. |
properties |
Proprietà di connessione dell'endpoint privato |
ServerUpdate
Richiesta di aggiornamento per un server di database Azure SQL.
Nome | Tipo | Descrizione |
---|---|---|
identity |
Identità server |
|
properties.administratorLogin |
string |
Nome utente amministratore per il server. Dopo aver creato non è possibile modificarlo. |
properties.administratorLoginPassword |
string |
Password di accesso amministratore (richiesta per la creazione del server). |
properties.administrators |
Amministratore di Azure Active Directory del server. |
|
properties.federatedClientId |
string |
ID client usato per lo scenario CMK multi-tenant |
properties.fullyQualifiedDomainName |
string |
Nome di dominio completo del server. |
properties.keyId |
string |
URI CMK della chiave da usare per la crittografia. |
properties.minimalTlsVersion |
string |
Versione TLS minima. Valori consentiti: '1.0', '1.1', '1.2' |
properties.primaryUserAssignedIdentityId |
string |
ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita. |
properties.privateEndpointConnections |
Elenco delle connessioni endpoint private in un server |
|
properties.publicNetworkAccess |
Se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato" |
|
properties.restrictOutboundNetworkAccess |
Indica se limitare o meno l'accesso alla rete in uscita per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato" |
|
properties.state |
string |
Stato del server. |
properties.version |
string |
Versione del server. |
properties.workspaceFeature |
Se il server esistente ha un'area di lavoro creata e se consente la connessione dall'area di lavoro |
|
tags |
object |
Tag di risorse. |
ServerWorkspaceFeature
Se il server esistente ha un'area di lavoro creata e se consente la connessione dall'area di lavoro
Nome | Tipo | Descrizione |
---|---|---|
Connected |
string |
|
Disconnected |
string |
UserIdentity
Configurazione delle identità di Azure Active Directory per una risorsa.
Nome | Tipo | Descrizione |
---|---|---|
clientId |
string |
ID client di Azure Active Directory. |
principalId |
string |
ID entità di Azure Active Directory. |