Servers - Update

Aktualizacje istniejącego serwera. Treść żądania może zawierać od jednej do wielu właściwości znajdujących się w normalnej definicji serwera.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

serverName
path True

string

Nazwa serwera.

subscriptionId
path True

string

Identyfikator subskrypcji docelowej.

api-version
query True

string

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Typ Opis
identity

ResourceIdentity

Tożsamość usługi Azure Active Directory serwera.

properties.administratorLoginPassword

string

Hasło logowania administratora.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Wymuś minimalną wersję protokołu Tls dla serwera.

properties.publicNetworkAccess

PublicNetworkAccessEnum

Określa, czy dostęp do sieci publicznej jest dozwolony dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"

properties.replicationRole

string

Rola replikacji serwera.

properties.sslEnforcement

SslEnforcementEnum

Włącz wymuszanie protokołu SSL lub nie podczas nawiązywania połączenia z serwerem.

properties.storageProfile

StorageProfile

Profil magazynu serwera.

properties.version

ServerVersion

Wersja serwera.

sku

Sku

Jednostka SKU (warstwa cenowa) serwera.

tags

object

Metadane specyficzne dla aplikacji w postaci par klucz-wartość.

Odpowiedzi

Nazwa Typ Opis
200 OK

Server

OK

202 Accepted

Zaakceptowano

Other Status Codes

CloudError

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

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

Definicje

Nazwa Opis
CloudError

Odpowiedź na błąd z usługi Batch.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorResponse

Odpowiedź na błąd

GeoRedundantBackup

Włącz geograficznie nadmiarowe lub nie dla kopii zapasowej serwera.

IdentityType

Typ tożsamości. Ustaw tę wartość na wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu.

InfrastructureEncryption

Dodaj drugą warstwę szyfrowania danych przy użyciu nowego algorytmu szyfrowania, który zapewnia dodatkową ochronę danych. Wartość jest opcjonalna, ale jeśli została przekazana, musi być "Wyłączona" lub "Włączona".

MinimalTlsVersionEnum

Wymuszaj minimalną wersję protokołu Tls dla serwera.

PrivateEndpointProperty
PrivateEndpointProvisioningState

Stan połączenia prywatnego punktu końcowego.

PrivateLinkServiceConnectionStateActionsRequire

Akcje wymagane do połączenia usługi private link.

PrivateLinkServiceConnectionStateStatus

Stan połączenia usługi private link.

PublicNetworkAccessEnum

Niezależnie od tego, czy dostęp do sieci publicznej jest dozwolony dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"

ResourceIdentity

Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.

Server

Reprezentuje serwer.

ServerPrivateEndpointConnection

Połączenie prywatnego punktu końcowego na serwerze

ServerPrivateEndpointConnectionProperties

Właściwości połączenia prywatnego punktu końcowego.

ServerPrivateLinkServiceConnectionStateProperty
ServerState

Stan serwera, który jest widoczny dla użytkownika.

ServerUpdateParameters

Parametry mogą być aktualizowane dla serwera.

ServerVersion

Wersja serwera.

Sku

Właściwości powiązane z informacjami rozliczeniowymi serwera.

SkuTier

Warstwa określonej jednostki SKU, np. Podstawowa.

SslEnforcementEnum

Włącz wymuszanie ssl lub nie podczas nawiązywania połączenia z serwerem.

StorageAutogrow

Włącz automatyczne zwiększanie magazynu.

StorageProfile

Właściwości profilu magazynu serwera

CloudError

Odpowiedź na błąd z usługi Batch.

Nazwa Typ Opis
error

ErrorResponse

Odpowiedź na błąd
Typowa odpowiedź na błąd dla wszystkich interfejsów API usługi Azure Resource Manager zwraca szczegóły błędu dla operacji, które zakończyły się niepowodzeniem. (Jest to również zgodne z formatem odpowiedzi oData).

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorResponse[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

GeoRedundantBackup

Włącz geograficznie nadmiarowe lub nie dla kopii zapasowej serwera.

Nazwa Typ Opis
Disabled

string

Enabled

string

IdentityType

Typ tożsamości. Ustaw tę wartość na wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu.

Nazwa Typ Opis
SystemAssigned

string

InfrastructureEncryption

Dodaj drugą warstwę szyfrowania danych przy użyciu nowego algorytmu szyfrowania, który zapewnia dodatkową ochronę danych. Wartość jest opcjonalna, ale jeśli została przekazana, musi być "Wyłączona" lub "Włączona".

Nazwa Typ Opis
Disabled

string

Dodatkowa (druga) warstwa szyfrowania danych magazynowanych

Enabled

string

Wartość domyślna dla pojedynczej warstwy szyfrowania danych magazynowanych.

MinimalTlsVersionEnum

Wymuszaj minimalną wersję protokołu Tls dla serwera.

Nazwa Typ Opis
TLS1_0

string

TLS1_1

string

TLS1_2

string

TLSEnforcementDisabled

string

PrivateEndpointProperty

Nazwa Typ Opis
id

string

Identyfikator zasobu prywatnego punktu końcowego.

PrivateEndpointProvisioningState

Stan połączenia prywatnego punktu końcowego.

Nazwa Typ Opis
Approving

string

Dropping

string

Failed

string

Ready

string

Rejecting

string

PrivateLinkServiceConnectionStateActionsRequire

Akcje wymagane do połączenia usługi private link.

Nazwa Typ Opis
None

string

PrivateLinkServiceConnectionStateStatus

Stan połączenia usługi private link.

Nazwa Typ Opis
Approved

string

Disconnected

string

Pending

string

Rejected

string

PublicNetworkAccessEnum

Niezależnie od tego, czy dostęp do sieci publicznej jest dozwolony dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"

Nazwa Typ Opis
Disabled

string

Enabled

string

ResourceIdentity

Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.

Nazwa Typ Opis
principalId

string

Identyfikator podmiotu zabezpieczeń usługi Azure Active Directory.

tenantId

string

Identyfikator dzierżawy usługi Azure Active Directory.

type

IdentityType

Typ tożsamości. Ustaw tę wartość na wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu.

Server

Reprezentuje serwer.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

ResourceIdentity

Tożsamość usługi Azure Active Directory serwera.

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties.administratorLogin

string

Nazwa logowania administratora serwera. Można określić tylko wtedy, gdy serwer jest tworzony (i jest wymagany do utworzenia).

properties.byokEnforcement

string

Stan pokazujący, czy szyfrowanie danych serwera jest włączone przy użyciu kluczy zarządzanych przez klienta.

properties.earliestRestoreDate

string

Najwcześniejszy czas tworzenia punktu przywracania (format ISO8601)

properties.fullyQualifiedDomainName

string

W pełni kwalifikowana nazwa domeny serwera.

properties.infrastructureEncryption

InfrastructureEncryption

Stan pokazujący, czy na serwerze włączono szyfrowanie infrastruktury.

properties.masterServerId

string

Identyfikator serwera głównego serwera repliki.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Wymuszaj minimalną wersję protokołu Tls dla serwera.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Lista połączeń prywatnego punktu końcowego na serwerze

properties.publicNetworkAccess

PublicNetworkAccessEnum

Niezależnie od tego, czy dostęp do sieci publicznej jest dozwolony dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"

properties.replicaCapacity

integer

Maksymalna liczba replik, które może mieć serwer główny.

properties.replicationRole

string

Rola replikacji serwera.

properties.sslEnforcement

SslEnforcementEnum

Włącz wymuszanie ssl lub nie podczas nawiązywania połączenia z serwerem.

properties.storageProfile

StorageProfile

Profil magazynu serwera.

properties.userVisibleState

ServerState

Stan serwera, który jest widoczny dla użytkownika.

properties.version

ServerVersion

Wersja serwera.

sku

Sku

Jednostka SKU (warstwa cenowa) serwera.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ServerPrivateEndpointConnection

Połączenie prywatnego punktu końcowego na serwerze

Nazwa Typ Opis
id

string

Identyfikator zasobu połączenia prywatnego punktu końcowego.

properties

ServerPrivateEndpointConnectionProperties

Właściwości połączenia prywatnego punktu końcowego

ServerPrivateEndpointConnectionProperties

Właściwości połączenia prywatnego punktu końcowego.

Nazwa Typ Opis
privateEndpoint

PrivateEndpointProperty

Prywatny punkt końcowy, do którego należy połączenie.

privateLinkServiceConnectionState

ServerPrivateLinkServiceConnectionStateProperty

Stan połączenia prywatnego punktu końcowego.

provisioningState

PrivateEndpointProvisioningState

Stan połączenia prywatnego punktu końcowego.

ServerPrivateLinkServiceConnectionStateProperty

Nazwa Typ Opis
actionsRequired

PrivateLinkServiceConnectionStateActionsRequire

Akcje wymagane do połączenia usługi private link.

description

string

Opis połączenia usługi private link.

status

PrivateLinkServiceConnectionStateStatus

Stan połączenia usługi private link.

ServerState

Stan serwera, który jest widoczny dla użytkownika.

Nazwa Typ Opis
Disabled

string

Dropping

string

Inaccessible

string

Ready

string

ServerUpdateParameters

Parametry mogą być aktualizowane dla serwera.

Nazwa Typ Opis
identity

ResourceIdentity

Tożsamość usługi Azure Active Directory serwera.

properties.administratorLoginPassword

string

Hasło logowania administratora.

properties.minimalTlsVersion

MinimalTlsVersionEnum

Wymuszaj minimalną wersję protokołu Tls dla serwera.

properties.publicNetworkAccess

PublicNetworkAccessEnum

Niezależnie od tego, czy dostęp do sieci publicznej jest dozwolony dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"

properties.replicationRole

string

Rola replikacji serwera.

properties.sslEnforcement

SslEnforcementEnum

Włącz wymuszanie ssl lub nie podczas nawiązywania połączenia z serwerem.

properties.storageProfile

StorageProfile

Profil magazynu serwera.

properties.version

ServerVersion

Wersja serwera.

sku

Sku

Jednostka SKU (warstwa cenowa) serwera.

tags

object

Metadane specyficzne dla aplikacji w postaci par klucz-wartość.

ServerVersion

Wersja serwera.

Nazwa Typ Opis
10

string

10.0

string

10.2

string

11

string

9.5

string

9.6

string

Sku

Właściwości powiązane z informacjami rozliczeniowymi serwera.

Nazwa Typ Opis
capacity

integer

Pojemność skalowania w górę/w poziomie reprezentująca jednostki obliczeniowe serwera.

family

string

Rodzina sprzętu.

name

string

Nazwa jednostki SKU, zazwyczaj warstwa + rodzina i rdzenie, np. B_Gen4_1, GP_Gen5_8.

size

string

Kod rozmiaru, który ma być interpretowany przez zasób zgodnie z potrzebami.

tier

SkuTier

Warstwa określonej jednostki SKU, np. Podstawowa.

SkuTier

Warstwa określonej jednostki SKU, np. Podstawowa.

Nazwa Typ Opis
Basic

string

GeneralPurpose

string

MemoryOptimized

string

SslEnforcementEnum

Włącz wymuszanie ssl lub nie podczas nawiązywania połączenia z serwerem.

Nazwa Typ Opis
Disabled

string

Enabled

string

StorageAutogrow

Włącz automatyczne zwiększanie magazynu.

Nazwa Typ Opis
Disabled

string

Enabled

string

StorageProfile

Właściwości profilu magazynu serwera

Nazwa Typ Opis
backupRetentionDays

integer

Dni przechowywania kopii zapasowych serwera.

geoRedundantBackup

GeoRedundantBackup

Włącz geograficznie nadmiarowe lub nie dla kopii zapasowej serwera.

storageAutogrow

StorageAutogrow

Włącz automatyczne zwiększanie magazynu.

storageMB

integer

Maksymalna dozwolona ilość miejsca do magazynowania dla serwera.