Servers - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Hiermee wordt een server gemaakt of bijgewerkt.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	Resourcelocatie.
identity		ResourceIdentity	De Azure Active Directory-identiteit van de server.
properties.administratorLogin		string	Gebruikersnaam van beheerder voor de server. Zodra het is gemaakt, kan deze niet meer worden gewijzigd.
properties.administratorLoginPassword		string	Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van de server).
properties.administrators		ServerExternalAdministrator	De Azure Active Directory-beheerder van de server.
properties.federatedClientId		string	De client-id die wordt gebruikt voor CMK-scenario voor meerdere tenants
properties.keyId		string	Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling.
properties.minimalTlsVersion		string	Minimale TLS-versie. Toegestane waarden: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId		string	De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt.
properties.publicNetworkAccess		ServerNetworkAccessFlag	Of openbare eindpunttoegang is toegestaan voor deze server. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.restrictOutboundNetworkAccess		ServerNetworkAccessFlag	Hiermee wordt aangegeven of de uitgaande netwerktoegang voor deze server al dan niet moet worden beperkt. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.version		string	De versie van de server.
tags		object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	Server	De server is bijgewerkt.
201 Created	Server	De server is gemaakt.
202 Accepted		Geaccepteerd
Other Status Codes		Foutreacties: *** 400 MissingIdentityId - Er wordt geen door de gebruiker toegewezen identiteit opgegeven wanneer het identiteitstype is ingesteld op UserAssigned 400 InvalidPrimaryIdentityId - Gebruiker geeft een waarde op voor PrimaryUserIdentityId, maar hetzelfde wordt niet vermeld in de parameter IdentityId 400 PECsNotExistingToDenyPublicNetworkAccess - Kan Openbare netwerktoegang weigeren niet instellen op Ja omdat er geen privé-eindpunt is ingeschakeld voor toegang tot de server. Stel privé-eindpunten in en voer de bewerking opnieuw uit (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists : de opgegeven naam bestaat al. 400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId die door de gebruiker is opgegeven, heeft geen toegang tot opgegeven KeyId 400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId die door de gebruiker is opgegeven, heeft geen toegang tot de opgegeven KeyId 400 ProvisioningDisabled - Geeft een foutbericht weer van de resource operation authorizer zoals het is, zonder wijzigingen 400 PrimaryIdentityMissingPermissionForKeyId - KeyId wordt opgegeven door de gebruiker tijdens het maken, maar PrimaryUserAssignedIdentityId is niet opgegeven in de API-aanroep 400 InvalidIdentityTypeForKeyId - KeyId wordt opgegeven door de gebruiker tijdens het maken, maar het identiteitstype is niet ingesteld op 'UserAssigned' 400 InvalidLoginName - De opgegeven aanmeldingsnaam is ongeldig. 400 InvalidUsername - Opgegeven gebruikersnaam bevat ongeldige tekens. 400 Ipv6FeatureNotEnabled - Gebruiker heeft geprobeerd ipv6-ondersteuning in te schakelen op de server zonder functievlag in te schakelen voor het abonnement, of de functieondersteuning is momenteel uitgeschakeld in de regio. 400 PasswordTooShort - Het opgegeven wachtwoord is te kort 400 AadOnlyAuthenticationIsEnabled - Alleen Azure Active Directory-verificatie is ingeschakeld. Neem contact op met de systeembeheerder. 400 RegionDoesNotSupportVersion - Een gebruiker heeft geprobeerd een server van een opgegeven versie te maken op een locatie waar die serverversie niet wordt ondersteund. 400 PasswordTooLong - Het opgegeven wachtwoord is te lang. 400 PasswordNotComplex - Het opgegeven wachtwoord is niet complex genoeg. 400 InvalidParameterValue : er is een ongeldige waarde opgegeven voor een parameter. 400 InvalidLocation - Er is een ongeldige locatie opgegeven. 400 InvalidServerName - Ongeldige servernaam opgegeven. 400 InvalidIdentifier: de id bevat NULL of een ongeldig Unicode-teken. 400 TokenTooLong : het opgegeven token is te lang. 400 RegionDoesNotAllowProvisioning - De geselecteerde locatie accepteert geen nieuwe Windows Azure SQL Database-servers. Dit kan op een later tijdstip veranderen. 400 ServerNotFound - De aangevraagde server is niet gevonden. 400 InvalidMinimalTlsVersion - Ongeldige minimale TLS-versie. 400 InvalidExternalAdministratorLogin - Ongeldige of ontbrekende aanmeldingsnaam van externe beheerder. 400 InvalidExternalAdministratorSid - Ongeldige of ontbrekende object-id van externe beheerder. 400 InvalidExternalAdministratorTenantId - Ongeldige of ontbrekende tenant-id van de externe beheerder. 400 ExternalAdministratorPrincipalType : ongeldig of ontbreekt het principaltype van de externe beheerder. Selecteer een gebruiker, toepassing of groep. 400 MissingExternalAdministratorWithAadOnlyAuth - Geef de details van een externe beheerder op om Azure AD Alleen verificatie te gebruiken. 400 ExternalAdministratorLoginSameAsSqlAdmin: de namen van de Azure Active Directory-beheerder en van het serverbeheerdersaccount moeten verschillen. Geef verschillende waarden op. 404 SubscriptionDoesNotHaveServer - De aangevraagde server is niet gevonden 404 ServerNotInSubscriptionResourceGroup: de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 OperationIdNotFound - De bewerking met id bestaat niet. 404 SubscriptionNotFound - Het aangevraagde abonnement is niet gevonden. 409 OperationCancelled : de bewerking is geannuleerd door de gebruiker. 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource. 409 UpsertLogicalServerRequestAlreadyInProgress - Er wordt al een aanvraag voor een logische server uitgevoerd. Probeer het later opnieuw. 409 ServerDisabled - Server is uitgeschakeld. 409 ConflictingServerOperation : er wordt momenteel een bewerking uitgevoerd voor de server. 409 SubscriptionDisabled - Abonnement is uitgeschakeld. 409 ServerQuotaExceeded - Server kan niet worden toegevoegd aan een abonnement omdat het quotum wordt overschreden. 409 ServerAlreadyExists - Dubbele servernaam. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 ConflictingSubscriptionOperation : er wordt momenteel een bewerking uitgevoerd voor het abonnement. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren. 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 503 TooManyRequests : aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources.

Voorbeelden

Create server

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;
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),
            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

Sample Response

Status code:

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

Status code:

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

Status code:

202

Definities

Name	Description
AdministratorType	Type van de serverbeheerder.
IdentityType	Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen.
PrincipalType	Principal Type van de serverbeheerder.
PrivateEndpointConnectionProperties	Eigenschappen van een privé-eindpuntverbinding.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Status van de privé-eindpuntverbinding.
PrivateLinkServiceConnectionStateActionsRequire	De acties die zijn vereist voor een private link-serviceverbinding.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	De verbindingsstatus van de Private Link-service.
ResourceIdentity	Azure Active Directory-identiteitsconfiguratie voor een resource.
Server	Een Azure SQL Database-server.
ServerExternalAdministrator	Eigenschappen van een Active Directory-beheerder.
ServerNetworkAccessFlag	Of openbare eindpunttoegang is toegestaan voor deze server. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
ServerPrivateEndpointConnection	Een privé-eindpuntverbinding onder een server
ServerWorkspaceFeature	Of een bestaande server al dan niet een werkruimte heeft gemaakt en of verbinding vanuit de werkruimte is toegestaan
UserIdentity	Azure Active Directory-identiteitsconfiguratie voor een resource.

AdministratorType

Type van de serverbeheerder.

Name	Type	Description
ActiveDirectory	string

IdentityType

Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen.

Name	Type	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

PrincipalType

Principal Type van de serverbeheerder.

Name	Type	Description
Application	string
Group	string
User	string

PrivateEndpointConnectionProperties

Eigenschappen van een privé-eindpuntverbinding.

Name	Type	Description
groupIds	string[]	Groeps-id's.
privateEndpoint	PrivateEndpointProperty	Privé-eindpunt waartoe de verbinding behoort.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Verbindingsstatus van de privé-eindpuntverbinding.
provisioningState	PrivateEndpointProvisioningState	Status van de privé-eindpuntverbinding.

PrivateEndpointProperty

Name	Type	Description
id	string	Resource-id van het privé-eindpunt.

PrivateEndpointProvisioningState

Status van de privé-eindpuntverbinding.

Name	Type	Description
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

De acties die zijn vereist voor een private link-serviceverbinding.

Name	Type	Description
None	string

PrivateLinkServiceConnectionStateProperty

Name	Type	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	De acties die zijn vereist voor een private link-serviceverbinding.
description	string	De beschrijving van de private link-serviceverbinding.
status	PrivateLinkServiceConnectionStateStatus	De verbindingsstatus van de Private Link-service.

PrivateLinkServiceConnectionStateStatus

De verbindingsstatus van de Private Link-service.

Name	Type	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

ResourceIdentity

Azure Active Directory-identiteitsconfiguratie voor een resource.

Name	Type	Description
principalId	string	De principal-id van Azure Active Directory.
tenantId	string	De tenant-id van Azure Active Directory.
type	IdentityType	Het identiteitstype. Stel dit in op 'SystemAssigned' om automatisch een Azure Active Directory-principal voor de resource te maken en toe te wijzen.
userAssignedIdentities	<string,  UserIdentity>	De resource-id's van de door de gebruiker toegewezen identiteiten die moeten worden gebruikt

Server

Een Azure SQL Database-server.

Name	Type	Description
id	string	Resource-id.
identity	ResourceIdentity	De Azure Active Directory-identiteit van de server.
kind	string	Soort SQL-server. Dit zijn metagegevens die worden gebruikt voor de Azure Portal ervaring.
location	string	Resourcelocatie.
name	string	Resourcenaam.
properties.administratorLogin	string	Gebruikersnaam van beheerder voor de server. Zodra het is gemaakt, kan deze niet meer worden gewijzigd.
properties.administratorLoginPassword	string	Het aanmeldingswachtwoord van de beheerder (vereist voor het maken van de server).
properties.administrators	ServerExternalAdministrator	De Azure Active Directory-beheerder van de server.
properties.federatedClientId	string	De client-id die wordt gebruikt voor CMK-scenario voor meerdere tenants
properties.fullyQualifiedDomainName	string	De fully qualified domain name van de server.
properties.keyId	string	Een CMK-URI van de sleutel die moet worden gebruikt voor versleuteling.
properties.minimalTlsVersion	string	Minimale TLS-versie. Toegestane waarden: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId	string	De resource-id van een door de gebruiker toegewezen identiteit die standaard moet worden gebruikt.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lijst met privé-eindpuntverbindingen op een server
properties.publicNetworkAccess	ServerNetworkAccessFlag	Of openbare eindpunttoegang is toegestaan voor deze server. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Hiermee wordt aangegeven of de uitgaande netwerktoegang voor deze server al dan niet moet worden beperkt. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn
properties.state	string	De status van de server.
properties.version	string	De versie van de server.
properties.workspaceFeature	ServerWorkspaceFeature	Of een bestaande server al dan niet een werkruimte heeft gemaakt en of verbinding vanuit de werkruimte is toegestaan
tags	object	Resourcetags.
type	string	Resourcetype.

ServerExternalAdministrator

Eigenschappen van een Active Directory-beheerder.

Name	Type	Description
administratorType	AdministratorType	Type van de serverbeheerder.
azureADOnlyAuthentication	boolean	Alleen Azure Active Directory-verificatie ingeschakeld.
login	string	Aanmeldingsnaam van de serverbeheerder.
principalType	PrincipalType	Principal Type van de serverbeheerder.
sid	string	SID (object-id) van de serverbeheerder.
tenantId	string	Tenant-id van de beheerder.

ServerNetworkAccessFlag

Of openbare eindpunttoegang is toegestaan voor deze server. De waarde is optioneel, maar als deze is doorgegeven, moet 'Ingeschakeld' of 'Uitgeschakeld' zijn

Name	Type	Description
Disabled	string
Enabled	string

ServerPrivateEndpointConnection

Een privé-eindpuntverbinding onder een server

Name	Type	Description
id	string	Resource-id.
properties	PrivateEndpointConnectionProperties	Eigenschappen van privé-eindpuntverbinding

ServerWorkspaceFeature

Of een bestaande server al dan niet een werkruimte heeft gemaakt en of verbinding vanuit de werkruimte is toegestaan

Name	Type	Description
Connected	string
Disconnected	string

UserIdentity

Azure Active Directory-identiteitsconfiguratie voor een resource.

Name	Type	Description
clientId	string	De Azure Active Directory-client-id.
principalId	string	De principal-id van Azure Active Directory.