Servers - Create Or Update
Crea o aggiorna un server.
PUT 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 |
|---|---|---|---|---|
|
resource
|
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. |
|
server
|
path | True |
string |
Nome del server. |
|
subscription
|
path | True |
string |
ID sottoscrizione che identifica una sottoscrizione di Azure. |
|
api-version
|
query | True |
string |
Versione dell'API da usare per la richiesta. |
Corpo della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| location | True |
string |
Percorso della risorsa. |
| identity |
Identità di Azure Active Directory 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 |
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 |
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 |
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 |
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 |
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 |
Aggiornamento corretto del server. |
|
| 201 Created |
Creazione del server completata. |
|
| 202 Accepted |
Accettato Intestazioni Location: string |
|
| Other Status Codes |
Risposte di errore:
|
Esempio
Create server
Esempio di richiesta
PUT 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",
"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",
"isIPv6Enabled": "Enabled"
},
"location": "Japan East"
}
Risposta di esempio
{
"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",
"isIPv6Enabled": "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"
}
}
}
]
}
}
{
"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",
"isIPv6Enabled": "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"
}
}
}
]
}
}
Definizioni
| Nome | Descrizione |
|---|---|
|
Administrator |
Tipo dell'amministratore di sever. |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
Risposta di errore |
|
External |
Stato della governance esterna. |
|
Identity |
Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di azure Active Directory per la risorsa. |
|
Minimal |
Versione minima di TLS. Valori consentiti: 'Nessuno', 1.0', '1.1', '1.2', '1.3' |
|
Principal |
Tipo di entità dell'amministratore di sever. |
|
Private |
Proprietà di una connessione endpoint privato. |
|
Private |
|
|
Private |
Stato della connessione dell'endpoint privato. |
|
Private |
Azioni necessarie per la connessione al servizio di collegamento privato. |
|
Private |
|
|
Private |
Stato della connessione al servizio collegamento privato. |
|
Resource |
Configurazione dell'identità di Azure Active Directory per una risorsa. |
| Server |
Un server di database SQL di Azure. |
|
Server |
Proprietà di un amministratore di Active Directory. |
|
Server |
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' |
|
Server |
Una connessione endpoint privato in un server |
|
Server |
Indica se l'accesso all'endpoint pubblico è consentito per questo server. Il valore è facoltativo, ma se passato, deve essere 'Enabled' o 'Disabled' o 'SecuredByPerimeter' |
|
Server |
Indica se nel server esistente è stata creata un'area di lavoro e se consente la connessione dall'area di lavoro |
|
User |
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 |
Informazioni aggiuntive sull'errore. |
|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore. |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
ExternalGovernanceStatus
Stato della governance esterna.
| Valore | Descrizione |
|---|---|
| Enabled | |
| Disabled |
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 | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
MinimalTlsVersion
Versione minima di TLS. Valori consentiti: 'Nessuno', 1.0', '1.1', '1.2', '1.3'
| Valore | Descrizione |
|---|---|
| None | |
| 1.0 | |
| 1.1 | |
| 1.2 | |
| 1.3 |
PrincipalType
Tipo di entità dell'amministratore di sever.
| Valore | Descrizione |
|---|---|
| User | |
| Group | |
| Application |
PrivateEndpointConnectionProperties
Proprietà di una connessione endpoint privato.
| Nome | Tipo | Descrizione |
|---|---|---|
| groupIds |
string[] |
ID gruppo. |
| privateEndpoint |
Endpoint privato a cui appartiene la connessione. |
|
| privateLinkServiceConnectionState |
Stato della connessione dell'endpoint privato. |
|
| provisioningState |
Stato della connessione dell'endpoint privato. |
PrivateEndpointProperty
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string |
ID risorsa dell'endpoint privato. |
PrivateEndpointProvisioningState
Stato della connessione dell'endpoint privato.
| Valore | Descrizione |
|---|---|
| Approving | |
| Ready | |
| Dropping | |
| Failed | |
| Rejecting |
PrivateLinkServiceConnectionStateActionsRequire
Azioni necessarie per la connessione al servizio di collegamento privato.
| Valore | Descrizione |
|---|---|
| None |
PrivateLinkServiceConnectionStateProperty
| Nome | Tipo | Descrizione |
|---|---|---|
| actionsRequired |
Azioni necessarie per la connessione al servizio di collegamento privato. |
|
| description |
string |
Descrizione della connessione al servizio di collegamento privato. |
| status |
Stato della connessione al servizio collegamento privato. |
PrivateLinkServiceConnectionStateStatus
Stato della connessione al servizio collegamento privato.
| Valore | Descrizione |
|---|---|
| Approved | |
| Pending | |
| Rejected | |
| Disconnected |
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 |
Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di azure Active Directory per la risorsa. |
|
| userAssignedIdentities |
<string,
User |
ID risorsa delle identità assegnate dall'utente da usare |
Server
Un server di database SQL di Azure.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string |
ID risorsa. |
| identity |
Identità di Azure Active Directory del server. |
|
| kind |
string |
Tipo di sql server. Si tratta di metadati usati per l'esperienza 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 |
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 |
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 |
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 |
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 |
Elenco delle connessioni di endpoint privato in un server |
|
| properties.publicNetworkAccess |
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 |
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 |
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 |
Tipo dell'amministratore di sever. |
|
| azureADOnlyAuthentication |
boolean |
Autenticazione di Azure Active Directory abilitata solo. |
| login |
string |
Nome di accesso dell'amministratore del server. |
| 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 |
|---|---|
| Enabled | |
| Disabled |
ServerPrivateEndpointConnection
Una connessione endpoint privato in un server
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string |
ID risorsa. |
| properties |
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 |
|---|---|
| Enabled | |
| Disabled | |
| SecuredByPerimeter |
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. |