Condividi tramite


Servers - Update

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.

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

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "placeholder",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "isIPv6Enabled": "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",
    "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"
          }
        }
      }
    ]
  }
}
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

Tipo dell'amministratore di sever.

Valore Descrizione
ActiveDirectory

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

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

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

ExternalGovernanceStatus

Stato della governance esterna.

Valore Descrizione
Disabled
Enabled

IdentityType

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

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

Tipo di entità dell'amministratore di sever.

Valore Descrizione
Application
Group
User

PrivateEndpointConnectionProperties

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

Nome Tipo Descrizione
id

string

ID risorsa dell'endpoint privato.

PrivateEndpointProvisioningState

Stato della connessione dell'endpoint privato.

Valore Descrizione
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Azioni necessarie per la connessione al servizio di collegamento privato.

Valore Descrizione
None

PrivateLinkServiceConnectionStateProperty

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

Stato della connessione al servizio collegamento privato.

Valore Descrizione
Approved
Disconnected
Pending
Rejected

ResourceIdentity

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

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

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

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

Una connessione endpoint privato in un server

Nome Tipo Descrizione
id

string

ID risorsa.

properties

PrivateEndpointConnectionProperties

Proprietà di connessione dell'endpoint privato

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'

Valore Descrizione
Disabled
Enabled
SecuredByPerimeter

ServerUpdate

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

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

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.