Partager via


Servers - Create Or Update

Crée ou met à jour un serveur.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2023-08-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

Nom du serveur.

subscriptionId
path True

string

ID d’abonnement qui identifie 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 des ressources.

identity

ResourceIdentity

Identité Azure Active Directory du serveur.

properties.administratorLogin

string

Nom d’utilisateur administrateur du serveur. Une fois créée, elle ne peut pas être modifiée.

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. Cela ne peut être utilisé qu’au moment de la création du serveur. Si elle est utilisée pour la mise à jour du serveur, elle est ignorée ou entraîne une erreur. Pour les mises à jour, les API individuelles doivent être utilisées.

properties.federatedClientId

string (uuid)

ID client utilisé pour le scénario CMK interlocataire

properties.isIPv6Enabled

ServerNetworkAccessFlag

Indique si la prise en charge IPv6 de ce serveur doit être activé ou non. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé »

properties.keyId

string

URI CMK de la clé à utiliser pour le chiffrement.

properties.minimalTlsVersion

MinimalTlsVersion

Version TLS minimale. Valeurs autorisées : « None », 1.0 », « 1.1 », « 1.2 », « 1.3 »

properties.primaryUserAssignedIdentityId

string

ID de ressource d’une identité affectée par l’utilisateur à utiliser par défaut.

properties.publicNetworkAccess

ServerPublicNetworkAccessFlag

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

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Indique s’il faut restreindre ou non l’accès réseau sortant pour ce serveur. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé »

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

Création réussie du serveur.

202 Accepted

Accepté

En-têtes

Location: string

Other Status Codes

ErrorResponse

Réponses d’erreur : ***

  • 400 ManagedInstanceStoppingOrStopped : opération en conflit envoyée pendant l’arrêt/l’état arrêté de l’instance

  • 400 ManagedInstanceStarting - Opération en conflit envoyée pendant que l’instance est à l’état de démarrage

  • 400 NameAlreadyExistsSoftDeleted : le nom du serveur demandé est pris par un serveur dans un état de suppression réversible. Videz ou récupérez le serveur pour débloquer.

  • 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 le même n’est pas répertorié 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 de ressources tel qu’il est, sans modification

  • 400 PrimaryIdentityMissingPermissionForKeyId - KeyId est fourni par l’utilisateur pendant la création, mais PrimaryUserAssignedIdentityId n’est pas fourni dans l’appel d’API

  • 400 InvalidIdentityTypeForKeyId - KeyId est fourni par l’utilisateur pendant 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 dans 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 du 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 CMKOperationNotAllowed : l’utilisateur a essayé d’effectuer une opération sur le serveur lorsque le serveur n’a pas accès à Azure Key Vault.

  • 400 ServerNotFound : le serveur demandé est introuvable.

  • 400 RegionDoesNotAllowProvisioning : l’emplacement sélectionné n’accepte pas de nouveaux serveurs Windows Azure SQL Database. Cela peut changer ultérieurement.

  • 400 InvalidMinimalTlsVersion - Version TLS minimale non valide.

  • 400 InvalidExternalAdministratorLogin : nom de connexion 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’utilisateur, l’application ou le groupe.

  • 400 MissingExternalAdministratorWithAadOnlyAuth - Pour utiliser l’authentification Azure AD uniquement, fournissez des détails sur un administrateur externe.

  • 400 ExternalAdministratorLoginSameAsSqlAdmin : les noms de l’administrateur Azure Active Directory et du compte d’administrateur de serveur doivent être différents. Indiquez différentes valeurs.

  • 400 ServerAdministratorNameAlreadyExists : l’utilisateur a essayé de définir l’administrateur externe et le nom du principal existe déjà dans la base de données « master ».

  • 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.

  • 404 SubscriptionDoesNotHaveServer - Le serveur demandé est introuvable

  • 404 OperationIdNotFound : l’opération avec ID n’existe pas.

  • 404 SubscriptionNotFound : l’abonnement demandé est introuvable.

  • 409 CannotCancelOperation : l’opération de gestion est dans un état qui ne peut pas être annulé.

  • 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, réessayez votre demande ultérieurement.

  • 409 ServerDisabled : le serveur est désactivé.

  • 409 ConflictingServerOperation : une opération est en cours pour le serveur.

  • 409 SubscriptionDisabled : l’abonnement est désactivé.

  • 409 ServerQuotaExceededed : le serveur ne peut pas être ajouté à un abonnement, car il dépasse le quota.

  • 409 ServerAlreadyExists - Nom du serveur en double.

  • 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales 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à des requêtes maximales pouvant être traitées par les ressources disponibles.

  • 503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

Exemples

Create server

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
AdministratorType

Type de l’administrateur de serveur.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

ExternalGovernanceStatus

État de la gouvernance externe.

IdentityType

Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource.

MinimalTlsVersion

Version TLS minimale. Valeurs autorisées : « None », 1.0 », « 1.1 », « 1.2 », « 1.3 »

PrincipalType

Type de 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 de service de liaison privée.

PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus

État de connexion du service de liaison privée.

ResourceIdentity

Configuration d’identité Azure Active Directory pour une ressource.

Server

Un serveur Azure SQL Database.

ServerExternalAdministrator

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

ServerNetworkAccessFlag

Indique s’il faut restreindre ou non l’accès réseau sortant pour ce serveur. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé »

ServerPrivateEndpointConnection

Connexion de point de terminaison privé sous un serveur

ServerPublicNetworkAccessFlag

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

ServerWorkspaceFeature

Indique si un serveur existant a un espace de travail créé et s’il autorise la connexion à partir de l’espace de travail

UserIdentity

Configuration d’identité Azure Active Directory pour une ressource.

AdministratorType

Type de l’administrateur de serveur.

Valeur Description
ActiveDirectory

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

ExternalGovernanceStatus

État de la gouvernance externe.

Valeur Description
Disabled
Enabled

IdentityType

Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource.

Valeur Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

MinimalTlsVersion

Version TLS minimale. Valeurs autorisées : « None », 1.0 », « 1.1 », « 1.2 », « 1.3 »

Valeur Description
1.0
1.1
1.2
1.3
None

PrincipalType

Type de principal de l’administrateur de serveur.

Valeur Description
Application
Group
User

PrivateEndpointConnectionProperties

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 connexion de la connexion de point de terminaison privé.

provisioningState

PrivateEndpointProvisioningState

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

PrivateEndpointProperty

Nom Type Description
id

string

ID de ressource du point de terminaison privé.

PrivateEndpointProvisioningState

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

Valeur Description
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

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

Valeur Description
None

PrivateLinkServiceConnectionStateProperty

Nom Type Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

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

description

string

Description de la connexion du service private link.

status

PrivateLinkServiceConnectionStateStatus

État de connexion du service de liaison privée.

PrivateLinkServiceConnectionStateStatus

État de connexion du service de liaison privée.

Valeur Description
Approved
Disconnected
Pending
Rejected

ResourceIdentity

Configuration d’identité Azure Active Directory pour une ressource.

Nom Type Description
principalId

string (uuid)

ID du principal Azure Active Directory.

tenantId

string (uuid)

ID de locataire Azure Active Directory.

type

IdentityType

Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et 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

Un serveur Azure SQL Database.

Nom Type Description
id

string

ID de 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 du portail Azure.

location

string

Emplacement des ressources.

name

string

Nom de la ressource.

properties.administratorLogin

string

Nom d’utilisateur administrateur du serveur. Une fois créée, elle ne peut pas être modifiée.

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. Cela ne peut être utilisé qu’au moment de la création du serveur. Si elle est utilisée pour la mise à jour du serveur, elle est ignorée ou entraîne une erreur. Pour les mises à jour, les API individuelles doivent être utilisées.

properties.externalGovernanceStatus

ExternalGovernanceStatus

État de la gouvernance externe.

properties.federatedClientId

string (uuid)

ID client utilisé pour le scénario CMK interlocataire

properties.fullyQualifiedDomainName

string

Nom de domaine complet du serveur.

properties.isIPv6Enabled

ServerNetworkAccessFlag

Indique si la prise en charge IPv6 de ce serveur doit être activé ou non. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé »

properties.keyId

string

URI CMK de la clé à utiliser pour le chiffrement.

properties.minimalTlsVersion

MinimalTlsVersion

Version TLS minimale. Valeurs autorisées : « None », 1.0 », « 1.1 », « 1.2 », « 1.3 »

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

ServerPublicNetworkAccessFlag

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

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Indique s’il faut restreindre ou non l’accès réseau sortant pour ce serveur. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé »

properties.state

string

État du serveur.

properties.version

string

Version du serveur.

properties.workspaceFeature

ServerWorkspaceFeature

Indique si un serveur existant a 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

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

Nom Type Description
administratorType

AdministratorType

Type de l’administrateur de serveur.

azureADOnlyAuthentication

boolean

Authentification Azure Active Directory uniquement activée.

login

string

Nom de connexion de l’administrateur du serveur.

principalType

PrincipalType

Type de principal de l’administrateur de serveur.

sid

string (uuid)

SID (ID d’objet) de l’administrateur du serveur.

tenantId

string (uuid)

ID de locataire de l’administrateur.

ServerNetworkAccessFlag

Indique s’il faut restreindre ou non l’accès réseau sortant pour ce serveur. La valeur est facultative, mais si elle est passée, doit être « Activé » ou « Désactivé »

Valeur Description
Disabled
Enabled

ServerPrivateEndpointConnection

Connexion de point de terminaison privé sous un serveur

Nom Type Description
id

string

ID de ressource.

properties

PrivateEndpointConnectionProperties

Propriétés de connexion de point de terminaison privé

ServerPublicNetworkAccessFlag

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

Valeur Description
Disabled
Enabled
SecuredByPerimeter

ServerWorkspaceFeature

Indique si un serveur existant a un espace de travail créé et s’il autorise la connexion à partir de l’espace de travail

Valeur Description
Connected
Disconnected

UserIdentity

Configuration d’identité Azure Active Directory pour une ressource.

Nom Type Description
clientId

string (uuid)

ID client Azure Active Directory.

principalId

string (uuid)

ID du principal Azure Active Directory.