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
resourceGroupName
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.

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à 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

ServerExternalAdministrator

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

ServerNetworkAccessFlag

Se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato"

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 "Abilitato" o "Disabilitato"

properties.version

string

Versione del server.

tags

object

Tag di risorse.

Risposte

Nome Tipo Descrizione
200 OK

Server

Aggiornato correttamente il server.

202 Accepted

Accettato

Other Status Codes

Risposte agli errori: **

  • 400 MissingIdentityId - Nessuna identità assegnata dall'utente 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 riprovare 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 fornito

  • 400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId fornito dall'utente non ha accesso a KeyId fornito

  • 400 ProvisioningDisabled - Visualizza il messaggio di errore dall'autorizzazione dell'operazione delle risorse, 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 fornita è troppo breve

  • 400 AadOnlyAuthenticationIsEnabled : l'autenticazione solo di Azure Active Directory è abilitata. 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 fornita non è abbastanza complessa.

  • 400 InvalidParameterValue: un valore non valido è stato assegnato 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 RegionDoesNotAllowProvisioning - La posizione selezionata non accetta nuovi server di database di Windows Azure SQL. Questo può cambiare in un secondo momento.

  • 400 ServerNotFound : il server richiesto non è stato trovato.

  • 400 InvalidMinimalTlsVersion - Versione TLS minima 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 da User, Application o Group.

  • 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.

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 404 OperationIdNotFound: l'operazione con ID non esiste.

  • 404 SubscriptionNotFound : la sottoscrizione richiesta non è stata trovata.

  • 409 OperationCancelled: l'operazione è stata annullata dall'utente.

  • 409 Operazione interrotta: impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa.

  • 409 UpsertLogicalServerRequestAlreadyInProgress : una richiesta di server logico continua è già 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 server a una sottoscrizione perché supera la quota.

  • 409 ServerAlreadyExists - Nome del server duplicato.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 429 ConflictingSubscriptionOperation : un'operazione è attualmente in corso per la sottoscrizione.

  • 500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. 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

Sample Request

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"
  }
}

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",
    "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
AdministratorType

Tipo dell'amministratore di sever.

IdentityType

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

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 di connessione del servizio di collegamento privato.

ResourceIdentity

Configurazione delle identità di Azure Active Directory per una risorsa.

Server

Server di database Azure SQL.

ServerExternalAdministrator

Proprietà di un amministratore di Active Directory.

ServerNetworkAccessFlag

Se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato"

ServerPrivateEndpointConnection

Connessione endpoint privato in un server

ServerUpdate

Richiesta di aggiornamento per un server di database Azure SQL.

ServerWorkspaceFeature

Se il server esistente ha un'area di lavoro creata e se consente la connessione dall'area di lavoro

UserIdentity

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

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.

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

PrivateLinkServiceConnectionStateActionsRequire

Azioni necessarie per la connessione al servizio di collegamento privato.

description

string

Descrizione della connessione al servizio collegamento privato.

status

PrivateLinkServiceConnectionStateStatus

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

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

Server di database Azure SQL.

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 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

ServerExternalAdministrator

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

ServerPrivateEndpointConnection[]

Elenco delle connessioni endpoint private in un server

properties.publicNetworkAccess

ServerNetworkAccessFlag

Se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato"

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 "Abilitato" o "Disabilitato"

properties.state

string

Stato del server.

properties.version

string

Versione del server.

properties.workspaceFeature

ServerWorkspaceFeature

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

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

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

PrivateEndpointConnectionProperties

Proprietà di connessione dell'endpoint privato

ServerUpdate

Richiesta di aggiornamento per un server di database Azure SQL.

Nome Tipo Descrizione
identity

ResourceIdentity

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

ServerExternalAdministrator

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

ServerPrivateEndpointConnection[]

Elenco delle connessioni endpoint private in un server

properties.publicNetworkAccess

ServerNetworkAccessFlag

Se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere "Abilitato" o "Disabilitato"

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 "Abilitato" o "Disabilitato"

properties.state

string

Stato del server.

properties.version

string

Versione del server.

properties.workspaceFeature

ServerWorkspaceFeature

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.