Servers - Create Or Update

Référence

Service:: SQL Database

Version d'API:: 2021-11-01

Crée ou met à jour un serveur.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
serverName	path	True	string	Le nom du serveur
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement de la ressource.
identity		ResourceIdentity	Identité Azure Active Directory du serveur.
properties.administratorLogin		string	Nom d’utilisateur administrateur pour le serveur. Une fois créé, il ne peut pas être modifié.
properties.administratorLoginPassword		string	Mot de passe de connexion administrateur (requis pour la création du serveur).
properties.administrators		ServerExternalAdministrator	Administrateur Azure Active Directory du serveur.
properties.federatedClientId		string	ID client utilisé pour le scénario CMK entre locataires
properties.keyId		string	URI CMK de la clé à utiliser pour le chiffrement.
properties.minimalTlsVersion		string	Version tls minimale. Valeurs autorisées : '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId		string	ID de ressource d’une identité affectée par l’utilisateur à utiliser par défaut.
properties.publicNetworkAccess		ServerNetworkAccessFlag	Indique si l’accès au point de terminaison public est autorisé ou non pour ce serveur. La valeur est facultative, mais si elle est transmise, doit être « Enabled » ou « Disabled »
properties.restrictOutboundNetworkAccess		ServerNetworkAccessFlag	Indique s’il faut ou non restreindre l’accès réseau sortant pour ce serveur. La valeur est facultative, mais si elle est transmise, doit être « Enabled » ou « Disabled »
properties.version		string	Version du serveur.
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	Server	Mise à jour réussie du serveur.
201 Created	Server	Le serveur a été correctement créé.
202 Accepted		Accepté
Other Status Codes		Réponses d’erreur : *** 400 MissingIdentityId : aucune identité affectée par l’utilisateur n’est fournie lorsque le type d’identité est défini sur UserAssigned 400 InvalidPrimaryIdentityId : l’utilisateur fournit une valeur pour PrimaryUserIdentityId, mais elle n’est pas répertoriée dans le paramètre IdentityId 400 PECsNotExistingToDenyPublicNetworkAccess - Impossible de définir Refuser l’accès au réseau public sur Oui, car aucun point de terminaison privé n’est activé pour accéder au serveur. Configurez des points de terminaison privés et réessayez l’opération (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists : le nom fourni existe déjà. 400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId fourni par l’utilisateur n’a pas accès à KeyId fourni 400 MissingPrimaryIdentity - PrimaryUserAssignedIdentityId fourni par l’utilisateur n’a pas accès à KeyId fourni 400 ProvisioningDisabled : affiche le message d’erreur de l’autorisation d’opération des ressources en l’état, sans modification 400 PrimaryIdentityMissingPermissionForKeyId : KeyId est fourni par l’utilisateur lors de la création, mais PrimaryUserAssignedIdentityId n’est pas fourni dans l’appel d’API 400 InvalidIdentityTypeForKeyId : KeyId est fourni par l’utilisateur lors de la création, mais le type d’identité n’est pas défini sur « UserAssigned » 400 InvalidLoginName : le nom de connexion fourni n’est pas valide. 400 InvalidUsername : le nom d’utilisateur fourni contient des caractères non valides. 400 Ipv6FeatureNotEnabled : l’utilisateur a essayé d’activer la prise en charge Ipv6 sur le serveur sans activer l’indicateur de fonctionnalité sur l’abonnement, ou la prise en charge des fonctionnalités est actuellement désactivée dans la région. 400 PasswordTooShort : le mot de passe fourni est trop court 400 AadOnlyAuthenticationIsEnabled : l’authentification Azure Active Directory uniquement est activée. Contactez votre administrateur système. 400 RegionDoesNotSupportVersion : un utilisateur a tenté de créer un serveur d’une version spécifiée à un emplacement où cette version de serveur n’est pas prise en charge. 400 PasswordTooLong : le mot de passe fourni est trop long. 400 PasswordNotComplex : le mot de passe fourni n’est pas assez complexe. 400 InvalidParameterValue : une valeur non valide a été donnée à un paramètre. 400 InvalidLocation : un emplacement non valide a été spécifié. 400 InvalidServerName : nom de serveur non valide spécifié. 400 InvalidIdentifier : l’identificateur contient NULL ou un caractère Unicode non valide. 400 TokenTooLong : le jeton fourni est trop long. 400 RegionDoesNotAllowProvisioning : l’emplacement sélectionné n’accepte pas les nouveaux serveurs de base de données Windows Azure SQL. Cela peut changer ultérieurement. 400 ServerNotFound : le serveur demandé est introuvable. 400 InvalidMinimalTlsVersion - Version TLS minimale non valide. 400 InvalidExternalAdministratorLogin : nom de connexion d’administrateur externe non valide ou manquant. 400 InvalidExternalAdministratorSid : ID d’objet administrateur externe non valide ou manquant. 400 InvalidExternalAdministratorTenantId : ID de locataire d’administrateur externe non valide ou manquant. 400 ExternalAdministratorPrincipalType : type de principal d’administrateur externe non valide ou manquant. Sélectionnez l’option Utilisateur, Application ou Groupe. 400 MissingExternalAdministratorWithAadOnlyAuth : pour utiliser l’authentification Azure AD uniquement, fournissez les détails d’un administrateur externe. 400 ExternalAdministratorLoginSameAsSqlAdmin : les noms de l’administrateur Azure Active Directory et du compte d’administrateur de serveur doivent être différents. Fournissez des valeurs différentes. 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés. 404 OperationIdNotFound : l’opération avec ID n’existe pas. 404 SubscriptionNotFound : l’abonnement demandé est introuvable. 409 OperationCancelled : l’opération a été annulée par l’utilisateur. 409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource. 409 UpsertLogicalServerRequestAlreadyInProgress - Une demande de serveur logique en cours est déjà en cours. Veuillez réessayer ultérieurement. 409 ServerDisabled : le serveur est désactivé. 409 ConflictingServerOperation : une opération est actuellement en cours pour le serveur. 409 SubscriptionDisabled - L’abonnement est désactivé. 409 ServerQuotaExceeded : le serveur ne peut pas être ajouté à un abonnement, car il dépassera le quota. 409 ServerAlreadyExists - Nom du serveur en double. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles. 429 ConflictingSubscriptionOperation : une opération est actuellement en cours pour l’abonnement. 500 OperationTimedOut : l’opération a expiré et a été restaurée automatiquement. Réessayez l’opération. 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles. 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

Exemples

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

Exemple de réponse

Code d’état:: 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"
          }
        }
      }
    ]
  }
}

Code d’état:: 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"
          }
        }
      }
    ]
  }
}

Code d’état:: 202

Définitions

Nom	Description
AdministratorType	Type de l’administrateur de serveur.
IdentityType	Type d’identité. Définissez ce paramètre sur « SystemAssigned » afin de créer et d’affecter automatiquement un principal Azure Active Directory pour la ressource.
PrincipalType	Type principal de l’administrateur de serveur.
PrivateEndpointConnectionProperties	Propriétés d’une connexion de point de terminaison privé.
PrivateEndpointProperty
PrivateEndpointProvisioningState	État de la connexion de point de terminaison privé.
PrivateLinkServiceConnectionStateActionsRequire	Actions requises pour la connexion au service de liaison privée.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	La connexion au service de liaison privée status.
ResourceIdentity	Configuration de l’identité Azure Active Directory pour une ressource.
Server	Serveur de base de données Azure SQL.
ServerExternalAdministrator	Propriétés d’un administrateur Active Directory.
ServerNetworkAccessFlag	Indique si l’accès au point de terminaison public est autorisé ou non pour ce serveur. La valeur est facultative, mais si elle est transmise, doit être « Enabled » ou « Disabled »
ServerPrivateEndpointConnection	Connexion de point de terminaison privé sous un serveur
ServerWorkspaceFeature	Si un serveur existant a ou non un espace de travail créé et s’il autorise la connexion à partir de l’espace de travail
UserIdentity	Configuration de l’identité Azure Active Directory pour une ressource.

AdministratorType

Enumeration

Type de l’administrateur de serveur.

Valeur	Description
ActiveDirectory

IdentityType

Enumeration

Type d’identité. Définissez ce paramètre sur « SystemAssigned » afin de créer et d’affecter automatiquement un principal Azure Active Directory pour la ressource.

Valeur	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

PrincipalType

Enumeration

Type principal de l’administrateur de serveur.

Valeur	Description
Application
Group
User

PrivateEndpointConnectionProperties

Object

Propriétés d’une connexion de point de terminaison privé.

Nom	Type	Description
groupIds	string[]	ID de groupe.
privateEndpoint	PrivateEndpointProperty	Point de terminaison privé auquel la connexion appartient.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	État de la connexion du point de terminaison privé.
provisioningState	PrivateEndpointProvisioningState	État de la connexion de point de terminaison privé.

PrivateEndpointProperty

Object

Nom	Type	Description
id	string	ID de ressource du point de terminaison privé.

PrivateEndpointProvisioningState

Enumeration

État de la connexion de point de terminaison privé.

Valeur	Description
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Enumeration

Actions requises pour la connexion au service de liaison privée.

Valeur	Description
None

PrivateLinkServiceConnectionStateProperty

Object

Nom	Type	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	Actions requises pour la connexion au service de liaison privée.
description	string	Description de la connexion au service de liaison privée.
status	PrivateLinkServiceConnectionStateStatus	La connexion au service de liaison privée status.

PrivateLinkServiceConnectionStateStatus

Enumeration

La connexion au service de liaison privée status.

Valeur	Description
Approved
Disconnected
Pending
Rejected

ResourceIdentity

Object

Configuration de l’identité Azure Active Directory pour une ressource.

Nom	Type	Description
principalId	string	ID du principal Azure Active Directory.
tenantId	string	ID de locataire Azure Active Directory.
type	IdentityType	Type d’identité. Définissez ce paramètre sur « SystemAssigned » afin de créer et d’affecter automatiquement un principal Azure Active Directory pour la ressource.
userAssignedIdentities	<string, UserIdentity>	ID de ressource des identités affectées par l’utilisateur à utiliser

Server

Object

Serveur de base de données Azure SQL.

Nom	Type	Description
id	string	ID de la ressource
identity	ResourceIdentity	Identité Azure Active Directory du serveur.
kind	string	Type de serveur sql. Il s’agit des métadonnées utilisées pour l’expérience Portail Azure.
location	string	Emplacement de la ressource.
name	string	Nom de la ressource.
properties.administratorLogin	string	Nom d’utilisateur administrateur pour le serveur. Une fois créé, il ne peut pas être modifié.
properties.administratorLoginPassword	string	Mot de passe de connexion administrateur (requis pour la création du serveur).
properties.administrators	ServerExternalAdministrator	Administrateur Azure Active Directory du serveur.
properties.federatedClientId	string	ID client utilisé pour le scénario CMK entre locataires
properties.fullyQualifiedDomainName	string	Nom de domaine complet du serveur.
properties.keyId	string	URI CMK de la clé à utiliser pour le chiffrement.
properties.minimalTlsVersion	string	Version tls minimale. Valeurs autorisées : '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId	string	ID de ressource d’une identité affectée par l’utilisateur à utiliser par défaut.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Liste des connexions de point de terminaison privé sur un serveur
properties.publicNetworkAccess	ServerNetworkAccessFlag	Indique si l’accès au point de terminaison public est autorisé ou non pour ce serveur. La valeur est facultative, mais si elle est transmise, doit être « Enabled » ou « Disabled »
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Indique s’il faut ou non restreindre l’accès réseau sortant pour ce serveur. La valeur est facultative, mais si elle est transmise, doit être « Enabled » ou « Disabled »
properties.state	string	État du serveur.
properties.version	string	Version du serveur.
properties.workspaceFeature	ServerWorkspaceFeature	Si un serveur existant a ou non un espace de travail créé et s’il autorise la connexion à partir de l’espace de travail
tags	object	Balises de ressource.
type	string	Type de ressource.

ServerExternalAdministrator

Object

Propriétés d’un administrateur Active Directory.

Nom	Type	Description
administratorType	AdministratorType	Type de l’administrateur de serveur.
azureADOnlyAuthentication	boolean	Azure Active Directory uniquement Authentification activée.
login	string	Nom de connexion de l’administrateur du serveur.
principalType	PrincipalType	Type principal de l’administrateur de serveur.
sid	string	SID (ID d’objet) de l’administrateur du serveur.
tenantId	string	ID de locataire de l’administrateur.

ServerNetworkAccessFlag

Enumeration

Indique si l’accès au point de terminaison public est autorisé ou non pour ce serveur. La valeur est facultative, mais si elle est transmise, doit être « Enabled » ou « Disabled »

Valeur	Description
Disabled
Enabled

ServerPrivateEndpointConnection

Object

Connexion de point de terminaison privé sous un serveur

Nom	Type	Description
id	string	ID de la ressource
properties	PrivateEndpointConnectionProperties	Propriétés de connexion de point de terminaison privé

ServerWorkspaceFeature

Enumeration

Si un serveur existant a ou non un espace de travail créé et s’il autorise la connexion à partir de l’espace de travail

Valeur	Description
Connected
Disconnected

UserIdentity

Object

Configuration de l’identité Azure Active Directory pour une ressource.

Nom	Type	Description
clientId	string	ID client Azure Active Directory.
principalId	string	ID du principal Azure Active Directory.

Partager via

Servers - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Exemples

Create server

Exemple de requête

Exemple de réponse

Définitions

AdministratorType

IdentityType

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerWorkspaceFeature

UserIdentity

Ressources supplémentaires