Delen via


Servers - Update

Updates een bestaande server. De aanvraagbody kan een of veel van de eigenschappen bevatten die aanwezig zijn in de normale serverdefinitie.

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

serverName
path True

string

De naam van de server.

subscriptionId
path True

string

De id van het doelabonnement.

api-version
query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Type Description
identity

ResourceIdentity

De Azure Active Directory-identiteit van de server.

properties.administratorLoginPassword

string

Het wachtwoord van de beheerdersaanmelding.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Dwing een minimale TLS-versie af voor de server.

properties.publicNetworkAccess

PublicNetworkAccessEnum

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

properties.replicationRole

string

De replicatiefunctie van de server.

properties.sslEnforcement

SslEnforcementEnum

Ssl-afdwinging inschakelen of niet wanneer u verbinding maakt met de server.

properties.storageProfile

StorageProfile

Opslagprofiel van een server.

properties.version

ServerVersion

De versie van een server.

sku

Sku

De SKU (prijscategorie) van de server.

tags

object

Toepassingsspecifieke metagegevens in de vorm van sleutel-waardeparen.

Antwoorden

Name Type Description
200 OK

Server

OK

202 Accepted

Geaccepteerd

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation uw gebruikersaccount imiteren

Voorbeelden

ServerUpdate

Sample Request

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

Sample Response

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

Definities

Name Description
CloudError

Een foutreactie van de Batch-service.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorResponse

Foutreactie

GeoRedundantBackup

Schakel geografisch redundant of niet in voor serverback-up.

IdentityType

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

InfrastructureEncryption

Voeg een tweede versleutelingslaag toe voor uw gegevens met behulp van een nieuw versleutelingsalgoritmen die extra gegevensbeveiliging bieden. De waarde is optioneel, maar als deze wordt doorgegeven, moet deze 'Uitgeschakeld' of 'Ingeschakeld' zijn.

MinimalTlsVersionEnum

Dwing een minimale TLS-versie af voor de server.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Status van de privé-eindpuntverbinding.

PrivateLinkServiceConnectionStateActionsRequire

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

PrivateLinkServiceConnectionStateStatus

De verbindingsstatus van de Private Link-service.

PublicNetworkAccessEnum

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

ResourceIdentity

Azure Active Directory-identiteitsconfiguratie voor een resource.

Server

Vertegenwoordigt een server.

ServerPrivateEndpointConnection

Een privé-eindpuntverbinding onder een server

ServerPrivateEndpointConnectionProperties

Eigenschappen van een privé-eindpuntverbinding.

ServerPrivateLinkServiceConnectionStateProperty
ServerState

Een status van een server die zichtbaar is voor de gebruiker.

ServerUpdateParameters

Parameters die mogen worden bijgewerkt voor een server.

ServerVersion

De versie van een server.

Sku

Factureringsgegevens gerelateerde eigenschappen van een server.

SkuTier

De laag van de specifieke SKU, bijvoorbeeld Basic.

SslEnforcementEnum

Ssl-afdwinging inschakelen of niet wanneer u verbinding maakt met de server.

StorageAutogrow

Automatisch vergroten van opslag inschakelen.

StorageProfile

Eigenschappen van opslagprofiel van een server

CloudError

Een foutreactie van de Batch-service.

Name Type Description
error

ErrorResponse

Foutreactie
Algemene foutreactie voor alle Azure Resource Manager-API's om foutdetails voor mislukte bewerkingen te retourneren. (Dit volgt ook de indeling van de OData-foutreactie.)

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het type aanvullende informatie.

ErrorResponse

Foutreactie

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout aanvullende informatie.

code

string

De foutcode.

details

ErrorResponse[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

GeoRedundantBackup

Schakel geografisch redundant of niet in voor serverback-up.

Name Type Description
Disabled

string

Enabled

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
SystemAssigned

string

InfrastructureEncryption

Voeg een tweede versleutelingslaag toe voor uw gegevens met behulp van een nieuw versleutelingsalgoritmen die extra gegevensbeveiliging bieden. De waarde is optioneel, maar als deze wordt doorgegeven, moet deze 'Uitgeschakeld' of 'Ingeschakeld' zijn.

Name Type Description
Disabled

string

Extra (2e) versleutelingslaag voor data-at-rest

Enabled

string

Standaardwaarde voor één versleutelingslaag voor data-at-rest.

MinimalTlsVersionEnum

Dwing een minimale TLS-versie af voor de server.

Name Type Description
TLS1_0

string

TLS1_1

string

TLS1_2

string

TLSEnforcementDisabled

string

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

PrivateLinkServiceConnectionStateStatus

De verbindingsstatus van de Private Link-service.

Name Type Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PublicNetworkAccessEnum

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

Name Type Description
Disabled

string

Enabled

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.

Server

Vertegenwoordigt een server.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ResourceIdentity

De Azure Active Directory-identiteit van de server.

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties.administratorLogin

string

De aanmeldingsnaam van de beheerder van een server. Kan alleen worden opgegeven wanneer de server wordt gemaakt (en is vereist voor het maken).

properties.byokEnforcement

string

Status die aangeeft of de servergegevensversleuteling is ingeschakeld met door de klant beheerde sleutels.

properties.earliestRestoreDate

string

Vroegste aanmaaktijd van herstelpunten (ISO8601-indeling)

properties.fullyQualifiedDomainName

string

De volledig gekwalificeerde domeinnaam van een server.

properties.infrastructureEncryption

InfrastructureEncryption

Status die aangeeft of de server infrastructuurversleuteling heeft ingeschakeld.

properties.masterServerId

string

De hoofdserver-id van een replicaserver.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Dwing een minimale TLS-versie af voor de server.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lijst met privé-eindpuntverbindingen op een server

properties.publicNetworkAccess

PublicNetworkAccessEnum

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

properties.replicaCapacity

integer

Het maximum aantal replica's dat een hoofdserver kan hebben.

properties.replicationRole

string

De replicatiefunctie van de server.

properties.sslEnforcement

SslEnforcementEnum

Ssl-afdwinging inschakelen of niet wanneer u verbinding maakt met de server.

properties.storageProfile

StorageProfile

Opslagprofiel van een server.

properties.userVisibleState

ServerState

Een status van een server die zichtbaar is voor de gebruiker.

properties.version

ServerVersion

Serverversie.

sku

Sku

De SKU (prijscategorie) van de server.

tags

object

Resourcetags.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ServerPrivateEndpointConnection

Een privé-eindpuntverbinding onder een server

Name Type Description
id

string

Resource-id van de privé-eindpuntverbinding.

properties

ServerPrivateEndpointConnectionProperties

Eigenschappen van privé-eindpuntverbinding

ServerPrivateEndpointConnectionProperties

Eigenschappen van een privé-eindpuntverbinding.

Name Type Description
privateEndpoint

PrivateEndpointProperty

Privé-eindpunt waartoe de verbinding behoort.

privateLinkServiceConnectionState

ServerPrivateLinkServiceConnectionStateProperty

Verbindingsstatus van de privé-eindpuntverbinding.

provisioningState

PrivateEndpointProvisioningState

Status van de privé-eindpuntverbinding.

ServerPrivateLinkServiceConnectionStateProperty

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.

ServerState

Een status van een server die zichtbaar is voor de gebruiker.

Name Type Description
Disabled

string

Dropping

string

Inaccessible

string

Ready

string

ServerUpdateParameters

Parameters die mogen worden bijgewerkt voor een server.

Name Type Description
identity

ResourceIdentity

De Azure Active Directory-identiteit van de server.

properties.administratorLoginPassword

string

Het wachtwoord van de beheerdersaanmelding.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Dwing een minimale TLS-versie af voor de server.

properties.publicNetworkAccess

PublicNetworkAccessEnum

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

properties.replicationRole

string

De replicatiefunctie van de server.

properties.sslEnforcement

SslEnforcementEnum

Ssl-afdwinging inschakelen of niet wanneer u verbinding maakt met de server.

properties.storageProfile

StorageProfile

Opslagprofiel van een server.

properties.version

ServerVersion

De versie van een server.

sku

Sku

De SKU (prijscategorie) van de server.

tags

object

Toepassingsspecifieke metagegevens in de vorm van sleutel-waardeparen.

ServerVersion

De versie van een server.

Name Type Description
10

string

10.0

string

10.2

string

11

string

9.5

string

9.6

string

Sku

Factureringsgegevens gerelateerde eigenschappen van een server.

Name Type Description
capacity

integer

De capaciteit voor omhoog/uitschalen, die de rekeneenheden van de server vertegenwoordigt.

family

string

De hardwarefamilie.

name

string

De naam van de SKU, meestal laag + familie + kernen, bijvoorbeeld B_Gen4_1, GP_Gen5_8.

size

string

De groottecode, die door de resource moet worden geïnterpreteerd als van toepassing.

tier

SkuTier

De laag van de specifieke SKU, bijvoorbeeld Basic.

SkuTier

De laag van de specifieke SKU, bijvoorbeeld Basic.

Name Type Description
Basic

string

GeneralPurpose

string

MemoryOptimized

string

SslEnforcementEnum

Ssl-afdwinging inschakelen of niet wanneer u verbinding maakt met de server.

Name Type Description
Disabled

string

Enabled

string

StorageAutogrow

Automatisch vergroten van opslag inschakelen.

Name Type Description
Disabled

string

Enabled

string

StorageProfile

Eigenschappen van opslagprofiel van een server

Name Type Description
backupRetentionDays

integer

Back-up van retentiedagen voor de server.

geoRedundantBackup

GeoRedundantBackup

Schakel geografisch redundant of niet in voor serverback-up.

storageAutogrow

StorageAutogrow

Automatisch vergroten van opslag inschakelen.

storageMB

integer

Maximale opslag die is toegestaan voor een server.