Servers - Update

Odwołanie

Usługa:: SQL Database

Wersja interfejsu API:: 2023-08-01

Aktualizuje serwer.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
serverName	path	True	string	Nazwa serwera.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Typ	Opis
identity	ResourceIdentity	Tożsamość serwera
properties.administratorLogin	string	Nazwa użytkownika administratora serwera. Po utworzeniu nie można go zmienić.
properties.administratorLoginPassword	string	Hasło logowania administratora (wymagane do utworzenia serwera).
properties.administrators	ServerExternalAdministrator	Administrator usługi Azure Active Directory serwera. Może to być używane tylko w czasie tworzenia serwera. Jeśli jest używana do aktualizacji serwera, zostanie ona zignorowana lub spowoduje błąd. W przypadku aktualizacji należy użyć poszczególnych interfejsów API.
properties.federatedClientId	string (uuid)	Identyfikator klienta używany w scenariuszu cmK między dzierżawami
properties.isIPv6Enabled	ServerNetworkAccessFlag	Czy włączyć obsługę protokołu IPv6 dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"
properties.keyId	string	Identyfikator URI klucza cmK do użycia na potrzeby szyfrowania.
properties.minimalTlsVersion	MinimalTlsVersion	Minimalna wersja protokołu TLS. Dozwolone wartości: "None", 1.0", "1.1", "1.2", "1.3"
properties.primaryUserAssignedIdentityId	string	Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany.
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Określa, czy dostęp do publicznego punktu końcowego jest dozwolony dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone" lub "SecuredByPerimeter"
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Określa, czy ograniczyć dostęp do sieci wychodzącej dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"
properties.version	string	Wersja serwera.
tags	object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Server	Pomyślnie zaktualizowano serwer.
202 Accepted		Akceptowane Nagłówki Location: string
Other Status Codes	ErrorResponse	Odpowiedzi na błędy: *** 400 ManagedInstanceStoppingOrStopped — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie zatrzymania/zatrzymania 400 ManagedInstanceStarting — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie początkowym 400 NameAlreadyExistsSoftDeleted — żądana nazwa serwera jest pobierana przez serwer w stanie usunięcia nietrwałego. Przeczyść lub odzyskać serwer, aby odblokować. 400 MissingIdentityId — nie podano tożsamości przypisanej przez użytkownika, gdy typ tożsamości jest ustawiony na UserAssigned 400 InvalidPrimaryIdentityId — użytkownik udostępnia wartość PrimaryUserIdentityId, ale ten sam nie znajduje się na liście w parametrze IdentityId 400 PECsNotExistingToDenyPublicNetworkAccess — nie można ustawić opcji Odmów dostępu do sieci publicznej na wartość Tak, ponieważ nie ma włączonego prywatnego punktu końcowego dostępu do serwera. Skonfiguruj prywatne punkty końcowe i spróbuj ponownie wykonać operację (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists — podana nazwa już istnieje. 400 UmiMissingAkvPermissions — PrimaryUserAssignedIdentityId udostępniony przez użytkownika nie ma dostępu do podanego identyfikatora KeyId 400 MissingPrimaryIdentity — PrimaryUserAssignedIdentityId udostępniony przez użytkownika nie ma dostępu do podanego identyfikatora KeyId 400 ProvisioningDisabled — wyświetla komunikat o błędzie z autoryzatora operacji zasobów bez zmian 400 PrimaryIdentityMissingPermissionForKeyId — KeyId jest udostępniany przez użytkownika podczas tworzenia, ale parametr PrimaryUserAssignedIdentityId nie jest podany w wywołaniu interfejsu API 400 InvalidIdentityTypeForKeyId — identyfikator KeyId jest dostarczany przez użytkownika podczas tworzenia, ale typ tożsamości nie jest ustawiony na "UserAssigned" 400 InvalidLoginName — podana nazwa logowania jest nieprawidłowa. 400 InvalidUsername — podana nazwa użytkownika zawiera nieprawidłowe znaki. 400 Ipv6FeatureNotEnabled — użytkownik próbował włączyć obsługę protokołu Ipv6 na serwerze bez włączania flagi funkcji w subskrypcji lub obsługa funkcji jest obecnie wyłączona w regionie. 400 PasswordTooShort — podane hasło jest za krótkie 400 AadOnlyAuthenticationIsEnabled — włączono tylko uwierzytelnianie usługi Azure Active Directory. Skontaktuj się z administratorem systemu. 400 RegionDoesNotSupportVersion — użytkownik próbował utworzyć serwer określonej wersji w lokalizacji, w której ta wersja serwera nie jest obsługiwana. 400 PasswordTooLong — podane hasło jest za długie. 400 PasswordNotComplex — podane hasło nie jest wystarczająco złożone. 400 InvalidParameterValue — podano nieprawidłową wartość parametrowi. 400 InvalidLocation — określono nieprawidłową lokalizację. 400 InvalidServerName — określona nieprawidłowa nazwa serwera. 400 InvalidIdentifier — identyfikator zawiera wartość NULL lub nieprawidłowy znak Unicode. 400 TokenTooLong — podany token jest za długi. 400 CMKOperationNotAllowed — użytkownik próbował wykonać operację na serwerze, gdy serwer nie ma dostępu do usługi Azure Key Vault. 400 ServerNotFound — żądany serwer nie został znaleziony. 400 RegionDoesNotAllowProvisioning — wybrana lokalizacja nie akceptuje nowych serwerów usługi Windows Azure SQL Database. Może to ulec zmianie w późniejszym czasie. 400 InvalidMinimalTlsVersion — nieprawidłowa minimalna wersja protokołu TLS. 400 InvalidExternalAdministratorLogin — nieprawidłowa lub brak nazwy logowania administratora zewnętrznego. 400 InvalidExternalAdministratorSid — nieprawidłowy lub brak identyfikatora obiektu administratora zewnętrznego. 400 InvalidExternalAdministratorTenantId — nieprawidłowy lub brak identyfikatora dzierżawy administratora zewnętrznego. 400 ExternalAdministratorPrincipalType — nieprawidłowy lub brak typu podmiotu zabezpieczeń administratora zewnętrznego. Wybierz pozycję Użytkownik, Aplikacja lub Grupa. 400 MissingExternalAdministratorWithAadOnlyAuth — aby korzystać tylko z uwierzytelniania usługi Azure AD, podaj szczegóły administratora zewnętrznego. 400 ExternalAdministratorLoginSameAsSqlAdmin — nazwy administratora usługi Azure Active Directory i konta administratora serwera muszą być inne. Podaj różne wartości. 400 ServerAdministratorNameAlreadyExists — użytkownik próbował ustawić administratora zewnętrznego, a główna nazwa już istnieje w bazie danych master. 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 404 SubscriptionNotFound — żądana subskrypcja nie została znaleziona. 409 CannotCancelOperation — operacja zarządzania jest w stanie, którego nie można anulować. 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie. 409 UpsertLogicalServerRequestAlreadyInProgress — bieżące żądanie serwera logicznego jest już w toku, spróbuj ponownie później. 409 ServerDisabled — serwer jest wyłączony. 409 ConflictingServerOperation — operacja jest obecnie w toku dla serwera. 409 SubscriptionDisabled — subskrypcja jest wyłączona. 409 ServerQuotaExceeded — nie można dodać serwera do subskrypcji, ponieważ przekroczy limit przydziału. 409 ServerAlreadyExists — zduplikowana nazwa serwera. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 429 ConflictingSubscriptionOperation — operacja jest obecnie w toku dla subskrypcji. 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Nazwa

Typ

Opis

200 OK

Server

Pomyślnie zaktualizowano serwer.

202 Accepted

Akceptowane

Nagłówki

Location: string

Other Status Codes

ErrorResponse

Odpowiedzi na błędy: ***

400 ManagedInstanceStoppingOrStopped — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie zatrzymania/zatrzymania
400 ManagedInstanceStarting — operacja powodująca konflikt przesłana, gdy wystąpienie jest w stanie początkowym
400 NameAlreadyExistsSoftDeleted — żądana nazwa serwera jest pobierana przez serwer w stanie usunięcia nietrwałego. Przeczyść lub odzyskać serwer, aby odblokować.
400 MissingIdentityId — nie podano tożsamości przypisanej przez użytkownika, gdy typ tożsamości jest ustawiony na UserAssigned
400 InvalidPrimaryIdentityId — użytkownik udostępnia wartość PrimaryUserIdentityId, ale ten sam nie znajduje się na liście w parametrze IdentityId
400 PECsNotExistingToDenyPublicNetworkAccess — nie można ustawić opcji Odmów dostępu do sieci publicznej na wartość Tak, ponieważ nie ma włączonego prywatnego punktu końcowego dostępu do serwera. Skonfiguruj prywatne punkty końcowe i spróbuj ponownie wykonać operację (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database).
400 NameAlreadyExists — podana nazwa już istnieje.
400 UmiMissingAkvPermissions — PrimaryUserAssignedIdentityId udostępniony przez użytkownika nie ma dostępu do podanego identyfikatora KeyId
400 MissingPrimaryIdentity — PrimaryUserAssignedIdentityId udostępniony przez użytkownika nie ma dostępu do podanego identyfikatora KeyId
400 ProvisioningDisabled — wyświetla komunikat o błędzie z autoryzatora operacji zasobów bez zmian
400 PrimaryIdentityMissingPermissionForKeyId — KeyId jest udostępniany przez użytkownika podczas tworzenia, ale parametr PrimaryUserAssignedIdentityId nie jest podany w wywołaniu interfejsu API
400 InvalidIdentityTypeForKeyId — identyfikator KeyId jest dostarczany przez użytkownika podczas tworzenia, ale typ tożsamości nie jest ustawiony na "UserAssigned"
400 InvalidLoginName — podana nazwa logowania jest nieprawidłowa.
400 InvalidUsername — podana nazwa użytkownika zawiera nieprawidłowe znaki.
400 Ipv6FeatureNotEnabled — użytkownik próbował włączyć obsługę protokołu Ipv6 na serwerze bez włączania flagi funkcji w subskrypcji lub obsługa funkcji jest obecnie wyłączona w regionie.
400 PasswordTooShort — podane hasło jest za krótkie
400 AadOnlyAuthenticationIsEnabled — włączono tylko uwierzytelnianie usługi Azure Active Directory. Skontaktuj się z administratorem systemu.
400 RegionDoesNotSupportVersion — użytkownik próbował utworzyć serwer określonej wersji w lokalizacji, w której ta wersja serwera nie jest obsługiwana.
400 PasswordTooLong — podane hasło jest za długie.
400 PasswordNotComplex — podane hasło nie jest wystarczająco złożone.
400 InvalidParameterValue — podano nieprawidłową wartość parametrowi.
400 InvalidLocation — określono nieprawidłową lokalizację.
400 InvalidServerName — określona nieprawidłowa nazwa serwera.
400 InvalidIdentifier — identyfikator zawiera wartość NULL lub nieprawidłowy znak Unicode.
400 TokenTooLong — podany token jest za długi.
400 CMKOperationNotAllowed — użytkownik próbował wykonać operację na serwerze, gdy serwer nie ma dostępu do usługi Azure Key Vault.
400 ServerNotFound — żądany serwer nie został znaleziony.
400 RegionDoesNotAllowProvisioning — wybrana lokalizacja nie akceptuje nowych serwerów usługi Windows Azure SQL Database. Może to ulec zmianie w późniejszym czasie.
400 InvalidMinimalTlsVersion — nieprawidłowa minimalna wersja protokołu TLS.
400 InvalidExternalAdministratorLogin — nieprawidłowa lub brak nazwy logowania administratora zewnętrznego.
400 InvalidExternalAdministratorSid — nieprawidłowy lub brak identyfikatora obiektu administratora zewnętrznego.
400 InvalidExternalAdministratorTenantId — nieprawidłowy lub brak identyfikatora dzierżawy administratora zewnętrznego.
400 ExternalAdministratorPrincipalType — nieprawidłowy lub brak typu podmiotu zabezpieczeń administratora zewnętrznego. Wybierz pozycję Użytkownik, Aplikacja lub Grupa.
400 MissingExternalAdministratorWithAadOnlyAuth — aby korzystać tylko z uwierzytelniania usługi Azure AD, podaj szczegóły administratora zewnętrznego.
400 ExternalAdministratorLoginSameAsSqlAdmin — nazwy administratora usługi Azure Active Directory i konta administratora serwera muszą być inne. Podaj różne wartości.
400 ServerAdministratorNameAlreadyExists — użytkownik próbował ustawić administratora zewnętrznego, a główna nazwa już istnieje w bazie danych master.
404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji.
404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera
404 OperationIdNotFound — operacja o identyfikatorze nie istnieje.
404 SubscriptionNotFound — żądana subskrypcja nie została znaleziona.
409 CannotCancelOperation — operacja zarządzania jest w stanie, którego nie można anulować.
409 OperationCancelled — operacja została anulowana przez użytkownika.
409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie.
409 UpsertLogicalServerRequestAlreadyInProgress — bieżące żądanie serwera logicznego jest już w toku, spróbuj ponownie później.
409 ServerDisabled — serwer jest wyłączony.
409 ConflictingServerOperation — operacja jest obecnie w toku dla serwera.
409 SubscriptionDisabled — subskrypcja jest wyłączona.
409 ServerQuotaExceeded — nie można dodać serwera do subskrypcji, ponieważ przekroczy limit przydziału.
409 ServerAlreadyExists — zduplikowana nazwa serwera.
429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.
429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby.
429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.
429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby.
429 ConflictingSubscriptionOperation — operacja jest obecnie w toku dla subskrypcji.
500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji.
503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.
503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby.

Przykłady

Update a server

Przykładowe żądanie

HTTP

PATCH 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",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "isIPv6Enabled": "Enabled"
  }
}

Przykładowa odpowiedź

Kod stanu:: 200

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "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": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "isIPv6Enabled": "Enabled",
    "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"
          }
        }
      }
    ]
  }
}

Kod stanu:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/serverOperationResults/00000000-0000-0000-0000-000000000000?api-version=2023-05-01

Definicje

Nazwa	Opis
AdministratorType	Typ administratora serwera.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
ExternalGovernanceStatus	Stan nadzoru zewnętrznego.
IdentityType	Typ tożsamości. Ustaw wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu.
MinimalTlsVersion	Minimalna wersja protokołu TLS. Dozwolone wartości: "None", 1.0", "1.1", "1.2", "1.3"
PrincipalType	Typ podmiotu zabezpieczeń administratora serwera.
PrivateEndpointConnectionProperties	Właściwości połączenia prywatnego punktu końcowego.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Stan połączenia prywatnego punktu końcowego.
PrivateLinkServiceConnectionStateActionsRequire	Akcje wymagane do nawiązania połączenia z usługą private link.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	Stan połączenia usługi private link.
ResourceIdentity	Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.
Server	Serwer usługi Azure SQL Database.
ServerExternalAdministrator	Właściwości administratora usługi Active Directory.
ServerNetworkAccessFlag	Określa, czy ograniczyć dostęp do sieci wychodzącej dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"
ServerPrivateEndpointConnection	Połączenie prywatnego punktu końcowego na serwerze
ServerPublicNetworkAccessFlag	Określa, czy dostęp do publicznego punktu końcowego jest dozwolony dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone" lub "SecuredByPerimeter"
ServerUpdate	Żądanie aktualizacji serwera usługi Azure SQL Database.
ServerWorkspaceFeature	Czy istniejący serwer ma utworzony obszar roboczy i czy zezwala na połączenie z obszaru roboczego
UserIdentity	Konfiguracja tożsamości usługi Azure Active Directory dla zasobu.

AdministratorType

Wyliczanie

Typ administratora serwera.

Wartość	Opis
ActiveDirectory

ErrorAdditionalInfo

Objekt

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

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

ExternalGovernanceStatus

Wyliczanie

Stan nadzoru zewnętrznego.

Wartość	Opis
Disabled
Enabled

IdentityType

Wyliczanie

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

Wartość	Opis
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

MinimalTlsVersion

Wyliczanie

Minimalna wersja protokołu TLS. Dozwolone wartości: "None", 1.0", "1.1", "1.2", "1.3"

Wartość	Opis
1.0
1.1
1.2
1.3
None

PrincipalType

Wyliczanie

Typ podmiotu zabezpieczeń administratora serwera.

Wartość	Opis
Application
Group
User

PrivateEndpointConnectionProperties

Objekt

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

Nazwa	Typ	Opis
groupIds	string[]	Identyfikatory grup.
privateEndpoint	PrivateEndpointProperty	Prywatny punkt końcowy, do którego należy połączenie.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Stan połączenia prywatnego punktu końcowego.
provisioningState	PrivateEndpointProvisioningState	Stan połączenia prywatnego punktu końcowego.

PrivateEndpointProperty

Objekt

Nazwa	Typ	Opis
id	string	Identyfikator zasobu prywatnego punktu końcowego.

PrivateEndpointProvisioningState

Wyliczanie

Stan połączenia prywatnego punktu końcowego.

Wartość	Opis
Approving
Dropping
Failed
Ready
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

Wyliczanie

Akcje wymagane do nawiązania połączenia z usługą private link.

Wartość	Opis
None

PrivateLinkServiceConnectionStateProperty

Objekt

Nazwa	Typ	Opis
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	Akcje wymagane do nawiązania połączenia z usługą private link.
description	string	Opis połączenia usługi private link.
status	PrivateLinkServiceConnectionStateStatus	Stan połączenia usługi private link.

PrivateLinkServiceConnectionStateStatus

Wyliczanie

Stan połączenia usługi private link.

Wartość	Opis
Approved
Disconnected
Pending
Rejected

ResourceIdentity

Objekt

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

Nazwa	Typ	Opis
principalId	string (uuid)	Identyfikator podmiotu zabezpieczeń usługi Azure Active Directory.
tenantId	string (uuid)	Identyfikator dzierżawy usługi Azure Active Directory.
type	IdentityType	Typ tożsamości. Ustaw wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu.
userAssignedIdentities	<string, UserIdentity>	Identyfikatory zasobów tożsamości przypisanych przez użytkownika do użycia

Server

Objekt

Serwer usługi Azure SQL Database.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
identity	ResourceIdentity	Tożsamość usługi Azure Active Directory serwera.
kind	string	Rodzaj programu SQL Server. Są to metadane używane w środowisku witryny Azure Portal.
location	string	Lokalizacja zasobu.
name	string	Nazwa zasobu.
properties.administratorLogin	string	Nazwa użytkownika administratora serwera. Po utworzeniu nie można go zmienić.
properties.administratorLoginPassword	string	Hasło logowania administratora (wymagane do utworzenia serwera).
properties.administrators	ServerExternalAdministrator	Administrator usługi Azure Active Directory serwera. Może to być używane tylko w czasie tworzenia serwera. Jeśli jest używana do aktualizacji serwera, zostanie ona zignorowana lub spowoduje błąd. W przypadku aktualizacji należy użyć poszczególnych interfejsów API.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Stan nadzoru zewnętrznego.
properties.federatedClientId	string (uuid)	Identyfikator klienta używany w scenariuszu cmK między dzierżawami
properties.fullyQualifiedDomainName	string	W pełni kwalifikowana nazwa domeny serwera.
properties.isIPv6Enabled	ServerNetworkAccessFlag	Czy włączyć obsługę protokołu IPv6 dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"
properties.keyId	string	Identyfikator URI klucza cmK do użycia na potrzeby szyfrowania.
properties.minimalTlsVersion	MinimalTlsVersion	Minimalna wersja protokołu TLS. Dozwolone wartości: "None", 1.0", "1.1", "1.2", "1.3"
properties.primaryUserAssignedIdentityId	string	Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lista połączeń prywatnych punktów końcowych na serwerze
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Określa, czy dostęp do publicznego punktu końcowego jest dozwolony dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone" lub "SecuredByPerimeter"
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Określa, czy ograniczyć dostęp do sieci wychodzącej dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"
properties.state	string	Stan serwera.
properties.version	string	Wersja serwera.
properties.workspaceFeature	ServerWorkspaceFeature	Czy istniejący serwer ma utworzony obszar roboczy i czy zezwala na połączenie z obszaru roboczego
tags	object	Tagi zasobów.
type	string	Typ zasobu.

ServerExternalAdministrator

Objekt

Właściwości administratora usługi Active Directory.

Nazwa	Typ	Opis
administratorType	AdministratorType	Typ administratora serwera.
azureADOnlyAuthentication	boolean	Włączono tylko uwierzytelnianie usługi Azure Active Directory.
login	string	Nazwa logowania administratora serwera.
principalType	PrincipalType	Typ podmiotu zabezpieczeń administratora serwera.
sid	string (uuid)	Identyfikator SID (identyfikator obiektu) administratora serwera.
tenantId	string (uuid)	Identyfikator dzierżawy administratora.

ServerNetworkAccessFlag

Wyliczanie

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

Wartość	Opis
Disabled
Enabled

ServerPrivateEndpointConnection

Objekt

Połączenie prywatnego punktu końcowego na serwerze

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
properties	PrivateEndpointConnectionProperties	Właściwości połączenia prywatnego punktu końcowego

ServerPublicNetworkAccessFlag

Wyliczanie

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

Wartość	Opis
Disabled
Enabled
SecuredByPerimeter

ServerUpdate

Objekt

Żądanie aktualizacji serwera usługi Azure SQL Database.

Nazwa	Typ	Opis
identity	ResourceIdentity	Tożsamość serwera
properties.administratorLogin	string	Nazwa użytkownika administratora serwera. Po utworzeniu nie można go zmienić.
properties.administratorLoginPassword	string	Hasło logowania administratora (wymagane do utworzenia serwera).
properties.administrators	ServerExternalAdministrator	Administrator usługi Azure Active Directory serwera. Może to być używane tylko w czasie tworzenia serwera. Jeśli jest używana do aktualizacji serwera, zostanie ona zignorowana lub spowoduje błąd. W przypadku aktualizacji należy użyć poszczególnych interfejsów API.
properties.externalGovernanceStatus	ExternalGovernanceStatus	Stan nadzoru zewnętrznego.
properties.federatedClientId	string (uuid)	Identyfikator klienta używany w scenariuszu cmK między dzierżawami
properties.fullyQualifiedDomainName	string	W pełni kwalifikowana nazwa domeny serwera.
properties.isIPv6Enabled	ServerNetworkAccessFlag	Czy włączyć obsługę protokołu IPv6 dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"
properties.keyId	string	Identyfikator URI klucza cmK do użycia na potrzeby szyfrowania.
properties.minimalTlsVersion	MinimalTlsVersion	Minimalna wersja protokołu TLS. Dozwolone wartości: "None", 1.0", "1.1", "1.2", "1.3"
properties.primaryUserAssignedIdentityId	string	Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Lista połączeń prywatnych punktów końcowych na serwerze
properties.publicNetworkAccess	ServerPublicNetworkAccessFlag	Określa, czy dostęp do publicznego punktu końcowego jest dozwolony dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone" lub "SecuredByPerimeter"
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Określa, czy ograniczyć dostęp do sieci wychodzącej dla tego serwera. Wartość jest opcjonalna, ale jeśli została przekazana, musi mieć wartość "Włączone" lub "Wyłączone"
properties.state	string	Stan serwera.
properties.version	string	Wersja serwera.
properties.workspaceFeature	ServerWorkspaceFeature	Czy istniejący serwer ma utworzony obszar roboczy i czy zezwala na połączenie z obszaru roboczego
tags	object	Tagi zasobów.

ServerWorkspaceFeature

Wyliczanie

Czy istniejący serwer ma utworzony obszar roboczy i czy zezwala na połączenie z obszaru roboczego

Wartość	Opis
Connected
Disconnected

UserIdentity

Objekt

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

Nazwa	Typ	Opis
clientId	string (uuid)	Identyfikator klienta usługi Azure Active Directory.
principalId	string (uuid)	Identyfikator podmiotu zabezpieczeń usługi Azure Active Directory.

Udostępnij za pośrednictwem

Servers - Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

Update a server

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AdministratorType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

IdentityType

MinimalTlsVersion

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerPublicNetworkAccessFlag

ServerUpdate

ServerWorkspaceFeature

UserIdentity

Dodatkowe zasoby