Servers - Update

Riferimento

Servizio:: SQL Database

Versione API:: 2023-08-01

Aggiorna un server.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
serverName	path	True	string	Nome del server.
subscriptionId	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	ResourceIdentity	Identità del server
properties.administratorLogin	string	Nome utente amministratore per il server. Una volta creato, non è possibile modificarlo.
properties.administratorLoginPassword	string	Password di accesso dell'amministratore (necessaria per la creazione del server).
properties.administrators	ServerExternalAdministrator	Amministratore di Azure Active Directory del server. Questa operazione può essere usata solo in fase di creazione del server. Se usato per l'aggiornamento del server, verrà ignorato o verrà generato un errore. Per gli aggiornamenti è necessario usare le singole API.
properties.federatedClientId	string (uuid)	ID client usato per lo scenario cmk tra tenant
properties.isIPv6Enabled	ServerNetworkAccessFlag	Indica se abilitare o meno il supporto IPv6 per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
properties.keyId	string	URI della chiave da usare per la crittografia.
properties.minimalTlsVersion	MinimalTlsVersion	Versione minima di TLS. Valori consentiti: 'Nessuno', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita.
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Indica se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled' o 'SecuredByPerimeter'
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Indica se limitare o meno l'accesso alla rete in uscita per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
properties.version	string	Versione del server.
tags	object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	Server	Aggiornamento corretto del server.
202 Accepted		Accettato Intestazioni Location: string
Other Status Codes	ErrorResponse	Risposte di errore: 400 ManagedInstanceStoppingOrStopped - Operazione in conflitto inviata mentre l'istanza è in stato di arresto/arresto 400 ManagedInstanceStarting - Operazione in conflitto inviata mentre l'istanza è in stato di avvio 400 NameAlreadyExistsSoftDeleted - Il nome del server richiesto viene eseguito da un server in stato di eliminazione temporanea. Ripulire o ripristinare il server per sbloccarlo. 400 MissingIdentityId - Nessuna identità assegnata dall'utente viene fornita quando il tipo di identità è impostato su UserAssigned 400 InvalidPrimaryIdentityId - L'utente fornisce un valore per PrimaryUserIdentityId, ma lo stesso non è elencato nel parametro IdentityId 400 PECsNotExistingToDenyPublicNetworkAccess: impossibile impostare Nega accesso alla rete pubblica su Sì perché non è abilitato alcun endpoint privato per accedere al server. Configurare gli endpoint privati e ripetere l'operazione (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists - Il nome specificato esiste già. 400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId fornito dall'utente non ha accesso a KeyId specificato 400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId fornito dall'utente non ha accesso a KeyId specificato 400 ProvisioningDisabled - Visualizza il messaggio di errore dell'autorizzatore dell'operazione delle risorse così come è, senza modifiche 400 PrimaryIdentityMissingPermissionForKeyId - KeyId viene fornito dall'utente durante la creazione, ma PrimaryUserAssignedIdentityId non viene fornito nella chiamata API 400 InvalidIdentityTypeForKeyId - KeyId viene fornito dall'utente durante la creazione, ma il tipo di identità non è impostato su 'UserAssigned' 400 InvalidLoginName: il nome di accesso specificato non è valido. 400 InvalidUsername- Il nome utente specificato contiene caratteri non validi. 400 Ipv6FeatureNotEnabled : l'utente ha tentato di attivare il supporto Ipv6 nel server senza abilitare il flag di funzionalità nella sottoscrizione oppure il supporto delle funzionalità è attualmente disabilitato nell'area. 400 PasswordTooShort - La password specificata è troppo breve 400 AadOnlyAuthenticationIsEnabled - È abilitata solo l'autenticazione di Azure Active Directory. Contattare l'amministratore di sistema. 400 RegionDoesNotSupportVersion: un utente ha tentato di creare un server di una versione specificata in un percorso in cui tale versione del server non è supportata. 400 PasswordTooLong - La password specificata è troppo lunga. 400 PasswordNotComplex - La password specificata non è abbastanza complessa. 400 InvalidParameterValue- È stato assegnato un valore non valido a un parametro. 400 InvalidLocation: è stata specificata una posizione non valida. 400 InvalidServerName - Nome server non valido specificato. 400 InvalidIdentifier: l'identificatore contiene NULL o un carattere Unicode non valido. 400 TokenTooLong: il token fornito è troppo lungo. 400 CMKOperationNotAllowed: l'utente ha tentato di eseguire un'operazione sul server quando il server non ha accesso ad Azure Key Vault. 400 ServerNotFound - Il server richiesto non è stato trovato. 400 RegionDoesNotAllowProvisioning: la posizione selezionata non accetta nuovi server di database SQL di Windows Azure. Questo può cambiare in un secondo momento. 400 InvalidMinimalTlsVersion - Versione minima di TLS non valida. 400 InvalidExternalAdministratorLogin - Nome di accesso amministratore esterno non valido o mancante. 400 InvalidExternalAdministratorSid - ID oggetto amministratore esterno non valido o mancante. 400 InvalidExternalAdministratorTenantId - ID tenant amministratore esterno non valido o mancante. 400 ExternalAdministratorPrincipalType - Tipo di entità amministratore esterno non valido o mancante. Selezionare un utente, un'applicazione o un gruppo. 400 MissingExternalAdministratorWithAadOnlyAuth: per usare l'autenticazione solo di Azure AD, specificare i dettagli di un amministratore esterno. 400 ExternalAdministratorLoginSameAsSqlAdmin: i nomi dell'amministratore di Azure Active Directory e dell'account amministratore del server devono essere diversi. Specificare valori diversi. 400 ServerAdministratorNameAlreadyExists - L'utente ha tentato di impostare l'amministratore esterno e il nome dell'entità esiste già nel database 'master'. 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 OperationIdNotFound - L'operazione con ID non esiste. 404 SubscriptionNotFound - La sottoscrizione richiesta non è stata trovata. 409 CannotCancelOperation: l'operazione di gestione si trova in uno stato che non può essere annullato. 409 OperationCancelled - L'operazione è stata annullata dall'utente. 409 OperationInterrupted - Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa. 409 UpsertLogicalServerRequestAlreadyInProgress - È già in corso una richiesta di server logico in corso. Riprovare la richiesta in un secondo momento. 409 ServerDisabled - Il server è disabilitato. 409 ConflictingServerOperation: un'operazione è attualmente in corso per il server. 409 SubscriptionDisabled : la sottoscrizione è disabilitata. 409 ServerQuotaExceeded - Impossibile aggiungere il server a una sottoscrizione perché supererà la quota. 409 ServerAlreadyExists - Nome server duplicato. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 429 ConflictingSubscriptionOperation: un'operazione è attualmente in corso per la sottoscrizione. 500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione. 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Nome

Tipo

Descrizione

200 OK

Server

Aggiornamento corretto del server.

202 Accepted

Accettato

Intestazioni

Location: string

Other Status Codes

ErrorResponse

Risposte di errore:

400 ManagedInstanceStoppingOrStopped - Operazione in conflitto inviata mentre l'istanza è in stato di arresto/arresto
400 ManagedInstanceStarting - Operazione in conflitto inviata mentre l'istanza è in stato di avvio
400 NameAlreadyExistsSoftDeleted - Il nome del server richiesto viene eseguito da un server in stato di eliminazione temporanea. Ripulire o ripristinare il server per sbloccarlo.
400 MissingIdentityId - Nessuna identità assegnata dall'utente viene fornita quando il tipo di identità è impostato su UserAssigned
400 InvalidPrimaryIdentityId - L'utente fornisce un valore per PrimaryUserIdentityId, ma lo stesso non è elencato nel parametro IdentityId
400 PECsNotExistingToDenyPublicNetworkAccess: impossibile impostare Nega accesso alla rete pubblica su Sì perché non è abilitato alcun endpoint privato per accedere al server. Configurare gli endpoint privati e ripetere l'operazione (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database).
400 NameAlreadyExists - Il nome specificato esiste già.
400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId fornito dall'utente non ha accesso a KeyId specificato
400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId fornito dall'utente non ha accesso a KeyId specificato
400 ProvisioningDisabled - Visualizza il messaggio di errore dell'autorizzatore dell'operazione delle risorse così come è, senza modifiche
400 PrimaryIdentityMissingPermissionForKeyId - KeyId viene fornito dall'utente durante la creazione, ma PrimaryUserAssignedIdentityId non viene fornito nella chiamata API
400 InvalidIdentityTypeForKeyId - KeyId viene fornito dall'utente durante la creazione, ma il tipo di identità non è impostato su 'UserAssigned'
400 InvalidLoginName: il nome di accesso specificato non è valido.
400 InvalidUsername- Il nome utente specificato contiene caratteri non validi.
400 Ipv6FeatureNotEnabled : l'utente ha tentato di attivare il supporto Ipv6 nel server senza abilitare il flag di funzionalità nella sottoscrizione oppure il supporto delle funzionalità è attualmente disabilitato nell'area.
400 PasswordTooShort - La password specificata è troppo breve
400 AadOnlyAuthenticationIsEnabled - È abilitata solo l'autenticazione di Azure Active Directory. Contattare l'amministratore di sistema.
400 RegionDoesNotSupportVersion: un utente ha tentato di creare un server di una versione specificata in un percorso in cui tale versione del server non è supportata.
400 PasswordTooLong - La password specificata è troppo lunga.
400 PasswordNotComplex - La password specificata non è abbastanza complessa.
400 InvalidParameterValue- È stato assegnato un valore non valido a un parametro.
400 InvalidLocation: è stata specificata una posizione non valida.
400 InvalidServerName - Nome server non valido specificato.
400 InvalidIdentifier: l'identificatore contiene NULL o un carattere Unicode non valido.
400 TokenTooLong: il token fornito è troppo lungo.
400 CMKOperationNotAllowed: l'utente ha tentato di eseguire un'operazione sul server quando il server non ha accesso ad Azure Key Vault.
400 ServerNotFound - Il server richiesto non è stato trovato.
400 RegionDoesNotAllowProvisioning: la posizione selezionata non accetta nuovi server di database SQL di Windows Azure. Questo può cambiare in un secondo momento.
400 InvalidMinimalTlsVersion - Versione minima di TLS non valida.
400 InvalidExternalAdministratorLogin - Nome di accesso amministratore esterno non valido o mancante.
400 InvalidExternalAdministratorSid - ID oggetto amministratore esterno non valido o mancante.
400 InvalidExternalAdministratorTenantId - ID tenant amministratore esterno non valido o mancante.
400 ExternalAdministratorPrincipalType - Tipo di entità amministratore esterno non valido o mancante. Selezionare un utente, un'applicazione o un gruppo.
400 MissingExternalAdministratorWithAadOnlyAuth: per usare l'autenticazione solo di Azure AD, specificare i dettagli di un amministratore esterno.
400 ExternalAdministratorLoginSameAsSqlAdmin: i nomi dell'amministratore di Azure Active Directory e dell'account amministratore del server devono essere diversi. Specificare valori diversi.
400 ServerAdministratorNameAlreadyExists - L'utente ha tentato di impostare l'amministratore esterno e il nome dell'entità esiste già nel database 'master'.
404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.
404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato
404 OperationIdNotFound - L'operazione con ID non esiste.
404 SubscriptionNotFound - La sottoscrizione richiesta non è stata trovata.
409 CannotCancelOperation: l'operazione di gestione si trova in uno stato che non può essere annullato.
409 OperationCancelled - L'operazione è stata annullata dall'utente.
409 OperationInterrupted - Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa.
409 UpsertLogicalServerRequestAlreadyInProgress - È già in corso una richiesta di server logico in corso. Riprovare la richiesta in un secondo momento.
409 ServerDisabled - Il server è disabilitato.
409 ConflictingServerOperation: un'operazione è attualmente in corso per il server.
409 SubscriptionDisabled : la sottoscrizione è disabilitata.
409 ServerQuotaExceeded - Impossibile aggiungere il server a una sottoscrizione perché supererà la quota.
409 ServerAlreadyExists - Nome server duplicato.
429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
429 ConflictingSubscriptionOperation: un'operazione è attualmente in corso per la sottoscrizione.
500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione.
503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.
503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

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=2023-08-01

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "placeholder",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "isIPv6Enabled": "Enabled"
  }
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ServerUpdate.json
// this example is just showing the usage of "Servers_Update" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlServerResource created on azure
// for more information of creating SqlServerResource, please refer to the document of SqlServerResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "sqlcrudtest-7398";
string serverName = "sqlcrudtest-4645";
ResourceIdentifier sqlServerResourceId = SqlServerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName);
SqlServerResource sqlServer = client.GetSqlServerResource(sqlServerResourceId);

// invoke the operation
SqlServerPatch patch = new SqlServerPatch
{
    AdministratorLogin = "dummylogin",
    AdministratorLoginPassword = "placeholder",
    PublicNetworkAccess = ServerNetworkAccessFlag.Disabled,
    RestrictOutboundNetworkAccess = ServerNetworkAccessFlag.Enabled,
    IsIPv6Enabled = ServerNetworkAccessFlag.Enabled,
};
ArmOperation<SqlServerResource> lro = await sqlServer.UpdateAsync(WaitUntil.Completed, patch);
SqlServerResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlServerData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Risposta di esempio

Codice di stato:: 200

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

Codice di stato:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/serverOperationResults/00000000-0000-0000-0000-000000000000?api-version=2023-05-01

Definizioni

Nome	Descrizione
AdministratorType	Tipo dell'amministratore di sever.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ExternalGovernanceStatus	Stato della governance esterna.
IdentityType	Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di azure Active Directory per la risorsa.
MinimalTlsVersion	Versione minima di TLS. Valori consentiti: 'Nessuno', 1.0', '1.1', '1.2', '1.3'
PrincipalType	Tipo di entità dell'amministratore di sever.
PrivateEndpointConnectionProperties	Proprietà di una connessione endpoint privato.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Stato della connessione dell'endpoint privato.
PrivateLinkServiceConnectionStateActionsRequire	Azioni necessarie per la connessione al servizio di collegamento privato.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	Stato della connessione al servizio collegamento privato.
ResourceIdentity	Configurazione dell'identità di Azure Active Directory per una risorsa.
Server	Un server di database SQL di Azure.
ServerExternalAdministrator	Proprietà di un amministratore di Active Directory.
ServerNetworkAccessFlag	Indica se limitare o meno l'accesso alla rete in uscita per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
ServerPrivateEndpointConnection	Una connessione endpoint privato in un server
ServerPublicNetworkAccessFlag	Indica se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled' o 'SecuredByPerimeter'
ServerUpdate	Richiesta di aggiornamento per un server di database SQL di Azure.
ServerWorkspaceFeature	Indica se nel server esistente è stata creata un'area di lavoro e se consente la connessione dall'area di lavoro
UserIdentity	Configurazione dell'identità di Azure Active Directory per una risorsa.

AdministratorType

Enumerazione

Tipo dell'amministratore di sever.

Valore	Descrizione
ActiveDirectory

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ExternalGovernanceStatus

Enumerazione

Stato della governance esterna.

Valore	Descrizione
Disabled
Enabled

IdentityType

Enumerazione

Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di azure Active Directory per la risorsa.

Valore	Descrizione
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

MinimalTlsVersion

Enumerazione

Versione minima di TLS. Valori consentiti: 'Nessuno', 1.0', '1.1', '1.2', '1.3'

Valore	Descrizione
1.0
1.1
1.2
1.3
None

PrincipalType

Enumerazione

Tipo di entità dell'amministratore di sever.

Valore	Descrizione
Application
Group
User

PrivateEndpointConnectionProperties

Object

Proprietà di una connessione endpoint privato.

Nome	Tipo	Descrizione
groupIds	string[]	ID gruppo.
privateEndpoint	PrivateEndpointProperty	Endpoint privato a cui appartiene la connessione.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Stato della connessione dell'endpoint privato.
provisioningState	PrivateEndpointProvisioningState	Stato della connessione dell'endpoint privato.

PrivateEndpointProperty

Object

Nome	Tipo	Descrizione
id	string	ID risorsa dell'endpoint privato.

PrivateEndpointProvisioningState

Enumerazione

Stato della connessione dell'endpoint privato.

Valore	Descrizione
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Enumerazione

Azioni necessarie per la connessione al servizio di collegamento privato.

Valore	Descrizione
None

PrivateLinkServiceConnectionStateProperty

Object

Nome	Tipo	Descrizione
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	Azioni necessarie per la connessione al servizio di collegamento privato.
description	string	Descrizione della connessione al servizio di collegamento privato.
status	PrivateLinkServiceConnectionStateStatus	Stato della connessione al servizio collegamento privato.

PrivateLinkServiceConnectionStateStatus

Enumerazione

Stato della connessione al servizio collegamento privato.

Valore	Descrizione
Approved
Disconnected
Pending
Rejected

ResourceIdentity

Object

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome	Tipo	Descrizione
principalId	string (uuid)	ID dell'entità di sicurezza di Azure Active Directory.
tenantId	string (uuid)	ID tenant di Azure Active Directory.
type	IdentityType	Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di azure Active Directory per la risorsa.
userAssignedIdentities	<string, UserIdentity>	ID risorsa delle identità assegnate dall'utente da usare

Server

Object

Un server di database SQL di Azure.

Nome	Tipo	Descrizione
id	string	ID risorsa.
identity	ResourceIdentity	Identità di Azure Active Directory del server.
kind	string	Tipo di sql server. Si tratta di metadati usati per l'esperienza del portale di Azure.
location	string	Percorso della risorsa.
name	string	Nome risorsa.
properties.administratorLogin	string	Nome utente amministratore per il server. Una volta creato, non è possibile modificarlo.
properties.administratorLoginPassword	string	Password di accesso dell'amministratore (necessaria per la creazione del server).
properties.administrators	ServerExternalAdministrator	Amministratore di Azure Active Directory del server. Questa operazione può essere usata solo in fase di creazione del server. Se usato per l'aggiornamento del server, verrà ignorato o verrà generato un errore. Per gli aggiornamenti è necessario usare le singole API.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Stato della governance esterna.
properties.federatedClientId	string (uuid)	ID client usato per lo scenario cmk tra tenant
properties.fullyQualifiedDomainName	string	Nome di dominio completo del server.
properties.isIPv6Enabled	ServerNetworkAccessFlag	Indica se abilitare o meno il supporto IPv6 per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
properties.keyId	string	URI della chiave da usare per la crittografia.
properties.minimalTlsVersion	MinimalTlsVersion	Versione minima di TLS. Valori consentiti: 'Nessuno', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Elenco delle connessioni di endpoint privato in un server
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Indica se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled' o 'SecuredByPerimeter'
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Indica se limitare o meno l'accesso alla rete in uscita per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
properties.state	string	Stato del server.
properties.version	string	Versione del server.
properties.workspaceFeature	ServerWorkspaceFeature	Indica se nel server esistente è stata creata un'area di lavoro e se consente la connessione dall'area di lavoro
tags	object	Tag di risorsa.
type	string	Tipo di risorsa.

ServerExternalAdministrator

Object

Proprietà di un amministratore di Active Directory.

Nome	Tipo	Descrizione
administratorType	AdministratorType	Tipo dell'amministratore di sever.
azureADOnlyAuthentication	boolean	Autenticazione di Azure Active Directory abilitata solo.
login	string	Nome di accesso dell'amministratore del server.
principalType	PrincipalType	Tipo di entità dell'amministratore di sever.
sid	string (uuid)	SID (ID oggetto) dell'amministratore del server.
tenantId	string (uuid)	ID tenant dell'amministratore.

ServerNetworkAccessFlag

Enumerazione

Indica se limitare o meno l'accesso alla rete in uscita per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'

Valore	Descrizione
Disabled
Enabled

ServerPrivateEndpointConnection

Object

Una connessione endpoint privato in un server

Nome	Tipo	Descrizione
id	string	ID risorsa.
properties	PrivateEndpointConnectionProperties	Proprietà di connessione dell'endpoint privato

ServerPublicNetworkAccessFlag

Enumerazione

Indica se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled' o 'SecuredByPerimeter'

Valore	Descrizione
Disabled
Enabled
SecuredByPerimeter

ServerUpdate

Object

Richiesta di aggiornamento per un server di database SQL di Azure.

Nome	Tipo	Descrizione
identity	ResourceIdentity	Identità del server
properties.administratorLogin	string	Nome utente amministratore per il server. Una volta creato, non è possibile modificarlo.
properties.administratorLoginPassword	string	Password di accesso dell'amministratore (necessaria per la creazione del server).
properties.administrators	ServerExternalAdministrator	Amministratore di Azure Active Directory del server. Questa operazione può essere usata solo in fase di creazione del server. Se usato per l'aggiornamento del server, verrà ignorato o verrà generato un errore. Per gli aggiornamenti è necessario usare le singole API.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Stato della governance esterna.
properties.federatedClientId	string (uuid)	ID client usato per lo scenario cmk tra tenant
properties.fullyQualifiedDomainName	string	Nome di dominio completo del server.
properties.isIPv6Enabled	ServerNetworkAccessFlag	Indica se abilitare o meno il supporto IPv6 per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
properties.keyId	string	URI della chiave da usare per la crittografia.
properties.minimalTlsVersion	MinimalTlsVersion	Versione minima di TLS. Valori consentiti: 'Nessuno', 1.0', '1.1', '1.2', '1.3'
properties.primaryUserAssignedIdentityId	string	ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Elenco delle connessioni di endpoint privato in un server
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Indica se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled' o 'SecuredByPerimeter'
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Indica se limitare o meno l'accesso alla rete in uscita per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
properties.state	string	Stato del server.
properties.version	string	Versione del server.
properties.workspaceFeature	ServerWorkspaceFeature	Indica se nel server esistente è stata creata un'area di lavoro e se consente la connessione dall'area di lavoro
tags	object	Tag di risorsa.

ServerWorkspaceFeature

Enumerazione

Indica se nel server esistente è stata creata un'area di lavoro e se consente la connessione dall'area di lavoro

Valore	Descrizione
Connected
Disconnected

UserIdentity

Object

Configurazione dell'identità di Azure Active Directory per una risorsa.

Nome	Tipo	Descrizione
clientId	string (uuid)	ID client di Azure Active Directory.
principalId	string (uuid)	ID dell'entità di sicurezza di Azure Active Directory.

Condividi tramite

Servers - Update

Parametri dell'URI

Corpo della richiesta

Risposte

Esempio

Update a server

Esempio di richiesta

Risposta di esempio

Definizioni

AdministratorType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

IdentityType

MinimalTlsVersion

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerPublicNetworkAccessFlag

ServerUpdate

ServerWorkspaceFeature

UserIdentity