Servers - Create Or Update

Riferimento

Servizio:: SQL Database

Versione API:: 2021-11-01

Crea o aggiorna un server.

PUT 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	Necessario	Tipo	Descrizione
location	True	string	Percorso della risorsa.
identity		ResourceIdentity	Identità di Azure Active Directory del server.
properties.administratorLogin		string	Nome utente amministratore per il server. Una volta creata, non è possibile modificarla.
properties.administratorLoginPassword		string	Password di accesso dell'amministratore (necessaria 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 tra tenant
properties.keyId		string	URI cmk della chiave da usare per la crittografia.
properties.minimalTlsVersion		string	Versione minima di TLS. 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	Indica se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
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 delle risorse.

Risposte

Nome	Tipo	Descrizione
200 OK	Server	Aggiornamento corretto del server.
201 Created	Server	Creazione del server completata.
202 Accepted		Accettato
Other Status Codes		Risposte di errore: 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 fornito 400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId fornito dall'utente non ha accesso a KeyId fornito 400 ProvisioningDisabled - Visualizza il messaggio di errore dell'agente di autorizzazione dell'operazione 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 o 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: è stato specificato un percorso non valido. 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: il percorso selezionato non accetta nuovi server di database di Windows Azure SQL. Questa modifica può essere modificata in un secondo momento. 400 ServerNotFound: il server richiesto non è stato trovato. 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 utente, applicazione o 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. 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 - È 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: il server non può essere aggiunto 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

Create server

PUT 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",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled"
  },
  "location": "Japan East"
}


import com.azure.resourcemanager.sql.fluent.models.ServerInner;
import com.azure.resourcemanager.sql.models.PrincipalType;
import com.azure.resourcemanager.sql.models.ServerExternalAdministrator;
import com.azure.resourcemanager.sql.models.ServerNetworkAccessFlag;
import java.util.UUID;

/**
 * Samples for Servers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerCreate.json
     */
    /**
     * Sample code: Create server.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().createOrUpdate("sqlcrudtest-7398", "sqlcrudtest-4645",
            new ServerInner().withLocation("Japan East").withAdministratorLogin("dummylogin")
                .withAdministratorLoginPassword("fakeTokenPlaceholder")
                .withPublicNetworkAccess(ServerNetworkAccessFlag.ENABLED)
                .withAdministrators(new ServerExternalAdministrator().withPrincipalType(PrincipalType.USER)
                    .withLogin("bob@contoso.com").withSid(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withTenantId(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withAzureADOnlyAuthentication(true))
                .withRestrictOutboundNetworkAccess(ServerNetworkAccessFlag.ENABLED),
            com.azure.core.util.Context.NONE);
    }
}

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

{
  "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": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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:: 201

{
  "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",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "version": "12.0",
    "state": "Ready",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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

Definizioni

Nome	Descrizione
AdministratorType	Tipo di amministratore del server.
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 del server.
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 di collegamento privato.
ResourceIdentity	Configurazione dell'identità di Azure Active Directory per una risorsa.
Server	Un server di database Azure SQL.
ServerExternalAdministrator	Proprietà di un amministratore di Active Directory.
ServerNetworkAccessFlag	Indica se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
ServerPrivateEndpointConnection	Una connessione endpoint privato in un server
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 di amministratore del server.

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 del server.

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 di connessione 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 di collegamento privato.
status	PrivateLinkServiceConnectionStateStatus	Stato della connessione al servizio di collegamento privato.

PrivateLinkServiceConnectionStateStatus

Stato della connessione al servizio di collegamento privato.

Nome	Tipo	Descrizione
Approved	string
Disconnected	string
Pending	string
Rejected	string

ResourceIdentity

Configurazione dell'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

Un 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. Una volta creata, non è possibile modificarla.
properties.administratorLoginPassword	string	Password di accesso dell'amministratore (necessaria 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 tra 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 minima di TLS. 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 di connessioni di endpoint privato in un server
properties.publicNetworkAccess	ServerNetworkAccessFlag	Indica se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled'
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 delle risorse.
type	string	Tipo di risorsa.

ServerExternalAdministrator

Proprietà di un amministratore di Active Directory.

Nome	Tipo	Descrizione
administratorType	AdministratorType	Tipo di amministratore del server.
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 del server.
sid	string	SID (ID oggetto) dell'amministratore del server.
tenantId	string	ID tenant dell'amministratore.

ServerNetworkAccessFlag

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

Nome	Tipo	Descrizione
Disabled	string
Enabled	string

ServerPrivateEndpointConnection

Una connessione endpoint privato in un server

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

ServerWorkspaceFeature

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

Nome	Tipo	Descrizione
Connected	string
Disconnected	string

UserIdentity