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 |
---|---|---|---|---|
resource
|
path | True |
string |
Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter. |
server
|
path | True |
string |
Nazwa serwera. |
subscription
|
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 |
Tożsamość usługi Azure Active Directory serwera. |
|
properties.administratorLoginPassword |
string |
Hasło logowania administratora. |
properties.minimalTlsVersion |
Wymuś minimalną wersję protokołu Tls dla serwera. |
|
properties.publicNetworkAccess |
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 |
Włącz wymuszanie protokołu SSL lub nie podczas nawiązywania połączenia z serwerem. |
|
properties.storageProfile |
Profil magazynu serwera. |
|
properties.version |
Wersja serwera. |
|
sku |
Jednostka SKU (warstwa cenowa) serwera. |
|
tags |
object |
Metadane specyficzne dla aplikacji w postaci par klucz-wartość. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Zaakceptowano |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Zabezpieczenia
azure_auth
Przepływ OAuth2 usługi Azure Active Directory
Typ:
oauth2
Flow:
implicit
Adres URL autoryzacji:
https://login.microsoftonline.com/common/oauth2/authorize
Zakresy
Nazwa | Opis |
---|---|
user_impersonation | personifikacja konta użytkownika |
Przykłady
ServerUpdate
Przykładowe żądanie
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"
}
}
Przykładowa odpowiedź
{
"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 |
---|---|
Cloud |
Odpowiedź na błąd z usługi Batch. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Odpowiedź na błąd |
Geo |
Włącz geograficznie nadmiarowe lub nie dla kopii zapasowej serwera. |
Identity |
Typ tożsamości. Ustaw tę wartość na wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu. |
Infrastructure |
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". |
Minimal |
Wymuszaj minimalną wersję protokołu Tls dla serwera. |
Private |
|
Private |
Stan połączenia prywatnego punktu końcowego. |
Private |
Akcje wymagane do połączenia usługi private link. |
Private |
Stan połączenia usługi private link. |
Public |
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" |
Resource |
Konfiguracja tożsamości usługi Azure Active Directory dla zasobu. |
Server |
Reprezentuje serwer. |
Server |
Połączenie prywatnego punktu końcowego na serwerze |
Server |
Właściwości połączenia prywatnego punktu końcowego. |
Server |
|
Server |
Stan serwera, który jest widoczny dla użytkownika. |
Server |
Parametry mogą być aktualizowane dla serwera. |
Server |
Wersja serwera. |
Sku |
Właściwości powiązane z informacjami rozliczeniowymi serwera. |
Sku |
Warstwa określonej jednostki SKU, np. Podstawowa. |
Ssl |
Włącz wymuszanie ssl lub nie podczas nawiązywania połączenia z serwerem. |
Storage |
Włącz automatyczne zwiększanie magazynu. |
Storage |
Właściwości profilu magazynu serwera |
CloudError
Odpowiedź na błąd z usługi Batch.
Nazwa | Typ | Opis |
---|---|---|
error |
Odpowiedź na błąd |
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 |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
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 |
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 |
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 |
Stan pokazujący, czy na serwerze włączono szyfrowanie infrastruktury. |
|
properties.masterServerId |
string |
Identyfikator serwera głównego serwera repliki. |
properties.minimalTlsVersion |
Wymuszaj minimalną wersję protokołu Tls dla serwera. |
|
properties.privateEndpointConnections |
Lista połączeń prywatnego punktu końcowego na serwerze |
|
properties.publicNetworkAccess |
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 |
Włącz wymuszanie ssl lub nie podczas nawiązywania połączenia z serwerem. |
|
properties.storageProfile |
Profil magazynu serwera. |
|
properties.userVisibleState |
Stan serwera, który jest widoczny dla użytkownika. |
|
properties.version |
Wersja serwera. |
|
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 |
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 |
Prywatny punkt końcowy, do którego należy połączenie. |
|
privateLinkServiceConnectionState |
Stan połączenia prywatnego punktu końcowego. |
|
provisioningState |
Stan połączenia prywatnego punktu końcowego. |
ServerPrivateLinkServiceConnectionStateProperty
Nazwa | Typ | Opis |
---|---|---|
actionsRequired |
Akcje wymagane do połączenia usługi private link. |
|
description |
string |
Opis połączenia usługi private link. |
status |
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 |
Tożsamość usługi Azure Active Directory serwera. |
|
properties.administratorLoginPassword |
string |
Hasło logowania administratora. |
properties.minimalTlsVersion |
Wymuszaj minimalną wersję protokołu Tls dla serwera. |
|
properties.publicNetworkAccess |
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 |
Włącz wymuszanie ssl lub nie podczas nawiązywania połączenia z serwerem. |
|
properties.storageProfile |
Profil magazynu serwera. |
|
properties.version |
Wersja serwera. |
|
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 |
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 |
Włącz geograficznie nadmiarowe lub nie dla kopii zapasowej serwera. |
|
storageAutogrow |
Włącz automatyczne zwiększanie magazynu. |
|
storageMB |
integer |
Maksymalna dozwolona ilość miejsca do magazynowania dla serwera. |