Partager via


Servers - Update

Met à jour un serveur existant. Le corps de la demande peut contenir une à plusieurs des propriétés présentes dans la définition de serveur normale.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DBforPostgreSQL/servers/{serverName}?api-version=2017-12-01

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
path True

string

Nom du groupe de ressources. Le nom ne respecte pas la casse.

serverName
path True

string

Le nom du serveur

subscriptionId
path True

string

ID de l’abonnement cible.

api-version
query True

string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Type Description
identity

ResourceIdentity

Identité Azure Active Directory du serveur.

properties.administratorLoginPassword

string

Mot de passe de la connexion administrateur.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Appliquez une version tls minimale pour le serveur.

properties.publicNetworkAccess

PublicNetworkAccessEnum

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

properties.replicationRole

string

Rôle de réplication du serveur.

properties.sslEnforcement

SslEnforcementEnum

Activez l’application ssl ou non lors de la connexion au serveur.

properties.storageProfile

StorageProfile

Profil de stockage d’un serveur.

properties.version

ServerVersion

Version d’un serveur.

sku

Sku

Référence SKU (niveau tarifaire) du serveur.

tags

object

Métadonnées spécifiques d’application sous la forme de paires clé/valeur.

Réponses

Nom Type Description
200 OK

Server

Ok

202 Accepted

Accepté

Other Status Codes

CloudError

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

ServerUpdate

Exemple de requête

PATCH https://management.azure.com/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc4?api-version=2017-12-01

{
  "properties": {
    "administratorLoginPassword": "<administratorLoginPassword>",
    "sslEnforcement": "Enabled",
    "minimalTlsVersion": "TLS1_2"
  }
}

Exemple de réponse

{
  "sku": {
    "name": "B_Gen4_2",
    "tier": "Basic",
    "family": "Gen4",
    "capacity": 2
  },
  "properties": {
    "administratorLogin": "cloudsa",
    "storageProfile": {
      "storageMB": 128000,
      "backupRetentionDays": 7,
      "geoRedundantBackup": "Disabled"
    },
    "version": "9.6",
    "sslEnforcement": "Enabled",
    "minimalTlsVersion": "TLS1_2",
    "userVisibleState": "Ready",
    "fullyQualifiedDomainName": "pgtestsvc4.postgres.database.azure.com",
    "earliestRestoreDate": "2018-03-14T21:08:24.637+00:00"
  },
  "location": "westus",
  "tags": {
    "ElasticServer": "1"
  },
  "id": "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testrg/providers/Microsoft.DBforPostgreSQL/servers/pgtestsvc4",
  "name": "pgtestsvc4",
  "type": "Microsoft.DBforPostgreSQL/servers"
}

Définitions

Nom Description
CloudError

Réponse d’erreur du service Batch.

ErrorAdditionalInfo

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

ErrorResponse

Réponse d’erreur

GeoRedundantBackup

Activez géoredondant ou non pour la sauvegarde du serveur.

IdentityType

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

InfrastructureEncryption

Ajoutez une deuxième couche de chiffrement pour vos données à l’aide d’un nouvel algorithme de chiffrement qui offre une protection supplémentaire des données. La valeur est facultative, mais si elle est transmise, doit être « Désactivé » ou « Activé ».

MinimalTlsVersionEnum

Appliquez une version tls minimale pour le serveur.

PrivateEndpointProperty
PrivateEndpointProvisioningState

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

PrivateLinkServiceConnectionStateActionsRequire

Actions requises pour la connexion au service private link.

PrivateLinkServiceConnectionStateStatus

La connexion au service de liaison privée status.

PublicNetworkAccessEnum

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

ResourceIdentity

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

Server

Représente un serveur.

ServerPrivateEndpointConnection

Connexion de point de terminaison privé sous un serveur

ServerPrivateEndpointConnectionProperties

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

ServerPrivateLinkServiceConnectionStateProperty
ServerState

État d’un serveur visible par l’utilisateur.

ServerUpdateParameters

Paramètres autorisés à mettre à jour pour un serveur.

ServerVersion

Version d’un serveur.

Sku

Propriétés liées aux informations de facturation d’un serveur.

SkuTier

Niveau de la référence SKU particulière, par exemple De base.

SslEnforcementEnum

Activez l’application ssl ou non lors de la connexion au serveur.

StorageAutogrow

Activez la croissance automatique du stockage.

StorageProfile

Propriétés du profil de stockage d’un serveur

CloudError

Réponse d’erreur du service Batch.

Nom Type Description
error

ErrorResponse

Réponse d’erreur
Réponse d’erreur courante pour toutes les API Azure Resource Manager pour retourner les détails de l’erreur concernant les opérations ayant échoué. (Cela suit également le format de réponse d’erreur OData.)

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émentaires.

ErrorResponse

Réponse d’erreur

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d'erreur.

details

ErrorResponse[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

GeoRedundantBackup

Activez géoredondant ou non pour la sauvegarde du serveur.

Nom Type Description
Disabled

string

Enabled

string

IdentityType

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

Nom Type Description
SystemAssigned

string

InfrastructureEncryption

Ajoutez une deuxième couche de chiffrement pour vos données à l’aide d’un nouvel algorithme de chiffrement qui offre une protection supplémentaire des données. La valeur est facultative, mais si elle est transmise, doit être « Désactivé » ou « Activé ».

Nom Type Description
Disabled

string

Couche supplémentaire (2e) de chiffrement pour les données au repos

Enabled

string

Valeur par défaut pour une seule couche de chiffrement pour les données au repos.

MinimalTlsVersionEnum

Appliquez une version tls minimale pour le serveur.

Nom Type Description
TLS1_0

string

TLS1_1

string

TLS1_2

string

TLSEnforcementDisabled

string

PrivateEndpointProperty

Nom Type Description
id

string

ID de ressource du point de terminaison privé.

PrivateEndpointProvisioningState

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

Nom Type Description
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

Actions requises pour la connexion au service private link.

Nom Type Description
None

string

PrivateLinkServiceConnectionStateStatus

La connexion au service de liaison privée status.

Nom Type Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PublicNetworkAccessEnum

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

Nom Type Description
Disabled

string

Enabled

string

ResourceIdentity

Configuration d’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 cette valeur sur « SystemAssigned » afin de créer et d’affecter automatiquement un principal Azure Active Directory pour la ressource.

Server

Représente un serveur.

Nom Type Description
id

string

ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ResourceIdentity

Identité Azure Active Directory du serveur.

location

string

Emplacement géographique où réside la ressource

name

string

nom de la ressource.

properties.administratorLogin

string

Nom de connexion de l’administrateur d’un serveur. Peut être spécifié uniquement lors de la création du serveur (et est requis pour la création).

properties.byokEnforcement

string

État indiquant si le chiffrement des données du serveur est activé avec des clés gérées par le client.

properties.earliestRestoreDate

string

Heure de création du point de restauration la plus ancienne (format ISO8601)

properties.fullyQualifiedDomainName

string

Nom de domaine complet d’un serveur.

properties.infrastructureEncryption

InfrastructureEncryption

État indiquant si le serveur a activé le chiffrement de l’infrastructure.

properties.masterServerId

string

ID de serveur master d’un serveur réplica.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Appliquez une version tls minimale pour le serveur.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Liste des connexions de point de terminaison privé sur un serveur

properties.publicNetworkAccess

PublicNetworkAccessEnum

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

properties.replicaCapacity

integer

Nombre maximal de réplicas qu’un serveur master peut avoir.

properties.replicationRole

string

Rôle de réplication du serveur.

properties.sslEnforcement

SslEnforcementEnum

Activez l’application ssl ou non lors de la connexion au serveur.

properties.storageProfile

StorageProfile

Profil de stockage d’un serveur.

properties.userVisibleState

ServerState

État d’un serveur visible par l’utilisateur.

properties.version

ServerVersion

Version du serveur.

sku

Sku

Référence SKU (niveau tarifaire) du serveur.

tags

object

Balises de ressource.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ServerPrivateEndpointConnection

Connexion de point de terminaison privé sous un serveur

Nom Type Description
id

string

ID de ressource de la connexion de point de terminaison privé.

properties

ServerPrivateEndpointConnectionProperties

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

ServerPrivateEndpointConnectionProperties

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

Nom Type Description
privateEndpoint

PrivateEndpointProperty

Point de terminaison privé auquel appartient la connexion.

privateLinkServiceConnectionState

ServerPrivateLinkServiceConnectionStateProperty

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

provisioningState

PrivateEndpointProvisioningState

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

ServerPrivateLinkServiceConnectionStateProperty

Nom Type Description
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

Actions requises pour la connexion au service private link.

description

string

Description de la connexion au service private link.

status

PrivateLinkServiceConnectionStateStatus

La connexion au service de liaison privée status.

ServerState

État d’un serveur visible par l’utilisateur.

Nom Type Description
Disabled

string

Dropping

string

Inaccessible

string

Ready

string

ServerUpdateParameters

Paramètres autorisés à mettre à jour pour un serveur.

Nom Type Description
identity

ResourceIdentity

Identité Azure Active Directory du serveur.

properties.administratorLoginPassword

string

Mot de passe de la connexion administrateur.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Appliquez une version tls minimale pour le serveur.

properties.publicNetworkAccess

PublicNetworkAccessEnum

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

properties.replicationRole

string

Rôle de réplication du serveur.

properties.sslEnforcement

SslEnforcementEnum

Activez l’application ssl ou non lors de la connexion au serveur.

properties.storageProfile

StorageProfile

Profil de stockage d’un serveur.

properties.version

ServerVersion

Version d’un serveur.

sku

Sku

Référence SKU (niveau tarifaire) du serveur.

tags

object

Métadonnées spécifiques d’application sous la forme de paires clé/valeur.

ServerVersion

Version d’un serveur.

Nom Type Description
10

string

10.0

string

10.2

string

11

string

9.5

string

9.6

string

Sku

Propriétés liées aux informations de facturation d’un serveur.

Nom Type Description
capacity

integer

Capacité de scale-up/out, représentant les unités de calcul du serveur.

family

string

Famille de matériel.

name

string

Nom de la référence SKU, généralement, niveau + famille + cœurs, par exemple B_Gen4_1, GP_Gen5_8.

size

string

Code de taille, à interpréter par la ressource comme il convient.

tier

SkuTier

Niveau de la référence SKU particulière, par exemple De base.

SkuTier

Niveau de la référence SKU particulière, par exemple De base.

Nom Type Description
Basic

string

GeneralPurpose

string

MemoryOptimized

string

SslEnforcementEnum

Activez l’application ssl ou non lors de la connexion au serveur.

Nom Type Description
Disabled

string

Enabled

string

StorageAutogrow

Activez la croissance automatique du stockage.

Nom Type Description
Disabled

string

Enabled

string

StorageProfile

Propriétés du profil de stockage d’un serveur

Nom Type Description
backupRetentionDays

integer

Jours de rétention des sauvegardes pour le serveur.

geoRedundantBackup

GeoRedundantBackup

Activez géoredondant ou non pour la sauvegarde du serveur.

storageAutogrow

StorageAutogrow

Activez la croissance automatique du stockage.

storageMB

integer

Stockage maximal autorisé pour un serveur.