Servers - Create Or Update

Odwołanie

Usługa:: SQL Database

Wersja interfejsu API:: 2021-11-01

Tworzy lub aktualizuje serwer.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2021-11-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	Wymagane	Typ	Opis
location	True	string	Lokalizacja zasobu.
identity		ResourceIdentity	Tożsamość usługi Azure Active Directory 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.
properties.federatedClientId		string (uuid)	Identyfikator klienta używany w scenariuszu cmK między dzierżawami
properties.keyId		string	Identyfikator URI klucza cmK do użycia na potrzeby szyfrowania.
properties.minimalTlsVersion		string	Minimalna wersja protokołu TLS. Dozwolone wartości: "1.0", "1.1", "1.2"
properties.primaryUserAssignedIdentityId		string (arm-id)	Identyfikator zasobu tożsamości przypisanej przez użytkownika domyślnie używany.
properties.publicNetworkAccess		ServerNetworkAccessFlag	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"
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.
201 Created	Server	Pomyślnie utworzono serwer.
202 Accepted		Zaakceptowano
Other Status Codes		Odpowiedzi na błędy: *** 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 RegionDoesNotAllowProvisioning — wybrana lokalizacja nie akceptuje nowych serwerów usługi Windows Azure SQL Database. Może to ulec zmianie w późniejszym czasie. 400 ServerNotFound — żądany serwer nie został znaleziony. 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. 404 SubscriptionDoesNotHaveServer — nie znaleziono żądanego serwera 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji. 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 404 SubscriptionNotFound — żądana subskrypcja nie została znaleziona. 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

Create server

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2021-11-01

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled"
  },
  "location": "Japan East"
}


import com.azure.resourcemanager.sql.fluent.models.ServerInner;
import com.azure.resourcemanager.sql.models.PrincipalType;
import com.azure.resourcemanager.sql.models.ServerExternalAdministrator;
import com.azure.resourcemanager.sql.models.ServerNetworkAccessFlag;
import java.util.UUID;

/**
 * Samples for Servers CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerCreate.json
     */
    /**
     * Sample code: Create server.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createServer(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().createOrUpdate("sqlcrudtest-7398", "sqlcrudtest-4645",
            new ServerInner().withLocation("Japan East").withAdministratorLogin("dummylogin")
                .withAdministratorLoginPassword("fakeTokenPlaceholder")
                .withPublicNetworkAccess(ServerNetworkAccessFlag.ENABLED)
                .withAdministrators(new ServerExternalAdministrator().withPrincipalType(PrincipalType.USER)
                    .withLogin("bob@contoso.com").withSid(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withTenantId(UUID.fromString("00000011-1111-2222-2222-123456789111"))
                    .withAzureADOnlyAuthentication(true))
                .withRestrictOutboundNetworkAccess(ServerNetworkAccessFlag.ENABLED),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Przykładowa odpowiedź

Kod stanu:: 200

{
  "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": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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:: 201

{
  "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",
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "version": "12.0",
    "state": "Ready",
    "administrators": {
      "principalType": "User",
      "login": "bob@contoso.com",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "azureADOnlyAuthentication": true
    },
    "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

Definicje

Nazwa	Opis
AdministratorType	Typ administratora serwera.
IdentityType	Typ tożsamości. Ustaw wartość "SystemAssigned", aby automatycznie utworzyć i przypisać jednostkę usługi Azure Active Directory dla zasobu.
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 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"
ServerPrivateEndpointConnection	Połączenie prywatnego punktu końcowego na serwerze
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

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

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.
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.keyId	string	Identyfikator URI klucza cmK do użycia na potrzeby szyfrowania.
properties.minimalTlsVersion	string	Minimalna wersja protokołu TLS. Dozwolone wartości: "1.0", "1.1", "1.2"
properties.primaryUserAssignedIdentityId	string (arm-id)	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	ServerNetworkAccessFlag	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"
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 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"

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

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 - Create Or Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Przykłady

Create server

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

AdministratorType

IdentityType

PrincipalType

PrivateEndpointConnectionProperties

PrivateEndpointProperty

PrivateEndpointProvisioningState

PrivateLinkServiceConnectionStateActionsRequire

PrivateLinkServiceConnectionStateProperty

PrivateLinkServiceConnectionStateStatus

ResourceIdentity

Server

ServerExternalAdministrator

ServerNetworkAccessFlag

ServerPrivateEndpointConnection

ServerWorkspaceFeature

UserIdentity

Dodatkowe zasoby