Servers - Create Or Update

Reference

Služba:: SQL Database

Verze rozhraní API:: 2021-11-01

Vytvoří nebo aktualizuje server.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Vyžadováno	Typ	Description
location	True	string	Umístění prostředku.
identity		ResourceIdentity	Identita serveru v Azure Active Directory.
properties.administratorLogin		string	Uživatelské jméno správce pro server. Po vytvoření jej nelze změnit.
properties.administratorLoginPassword		string	Přihlašovací heslo správce (vyžadované pro vytvoření serveru)
properties.administrators		ServerExternalAdministrator	Správce Azure Active Directory serveru.
properties.federatedClientId		string	ID klienta použité pro scénář klíče CMK napříč tenanty
properties.keyId		string	Identifikátor URI klíče cmk, který se má použít k šifrování.
properties.minimalTlsVersion		string	Minimální verze protokolu TLS. Povolené hodnoty: 1.0, 1.1, 1.2
properties.primaryUserAssignedIdentityId		string	ID prostředku identity přiřazené uživatelem, které se použije ve výchozím nastavení.
properties.publicNetworkAccess		ServerNetworkAccessFlag	Určuje, jestli je pro tento server povolený přístup z veřejného koncového bodu. Hodnota je nepovinná, ale pokud je předána, musí být Povolená nebo Zakázaná.
properties.restrictOutboundNetworkAccess		ServerNetworkAccessFlag	Určuje, zda se má omezit odchozí síťový přístup pro tento server. Hodnota je nepovinná, ale pokud je předána, musí být Povolená nebo Zakázaná.
properties.version		string	Verze serveru.
tags		object	Značky prostředků.

Odpovědi

Name	Typ	Description
200 OK	Server	Server se úspěšně aktualizoval.
201 Created	Server	Server se úspěšně vytvořil.
202 Accepted		Přijato
Other Status Codes		Chybové odpovědi: *** 400 MissingIdentityId - No user assigned identity is provided when the identity type is set to UserAssigned 400 InvalidPrimaryIdentityId – Uživatel poskytuje hodnotu pro PrimaryUserIdentityId, ale stejná hodnota není uvedená v parametru IdentityId. 400 PECsNotExistingToDenyPublicNetworkAccess – Nejde nastavit odepřít přístup z veřejné sítě na Ano, protože pro přístup k serveru není povolený žádný privátní koncový bod. Nastavte privátní koncové body a zkuste operaci zopakovat (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database). 400 NameAlreadyExists – zadaný název již existuje. 400 UmiMissingAkvPermissions – PrimaryUserAssignedIdentityId poskytnuté uživatelem nemá přístup k zadanému id klíče. 400 MissingPrimaryIdentity – PrimaryUserAssignedIdentityId poskytnuté uživatelem nemá přístup k zadanému id klíče. 400 ProvisioningDisabled – zobrazí chybovou zprávu z operace prostředků authorizer tak, jak je, beze změn 400 PrimaryIdentityMissingPermissionForKeyId – Id klíče poskytne uživatel během vytváření, ale PrimaryUserAssignedIdentityId není k dispozici ve volání rozhraní API. 400 InvalidIdentityTypeForKeyId – id klíče zadává uživatel během vytváření, ale typ identity není nastavený na Hodnotu UserAssigned. 400 InvalidLoginName – zadané přihlašovací jméno je neplatné. 400 InvalidUsername – zadané uživatelské jméno obsahuje neplatné znaky. 400 Ipv6FeatureNotEnabled – uživatel se pokusil zapnout podporu IPv6 na serveru bez povolení příznaku funkce v předplatném nebo je podpora funkcí v této oblasti aktuálně zakázaná. 400 PasswordTooShort – zadané heslo je příliš krátké 400 AadOnlyAuthenticationIsEnabled – Je povolené pouze ověřování Azure Active Directory. Obraťte se na správce systému. 400 RegionDoesNotSupportVersion – uživatel se pokusil vytvořit server zadané verze v umístění, kde se tato verze serveru nepodporuje. 400 PasswordTooLong – zadané heslo je příliš dlouhé. 400 PasswordNotComplex – zadané heslo není dostatečně složité. 400 InvalidParameterValue – parametru byla přiřazena neplatná hodnota. 400 InvalidLocation – bylo zadáno neplatné umístění. 400 InvalidServerName – zadaný neplatný název serveru. 400 InvalidIdentifier – identifikátor obsahuje null nebo neplatný znak unicode. 400 TokenTooLong – zadaný token je příliš dlouhý. 400 RegionDoesNotAllowProvisioning – vybrané umístění nepřijímá nové databázové servery windows Azure SQL. To se může později změnit. 400 ServerNotFound – požadovaný server nebyl nalezen. 400 InvalidMinimalTlsVersion – neplatná minimální verze protokolu TLS. 400 InvalidExternalAdministratorLogin – neplatné nebo chybějící přihlašovací jméno externího správce. 400 InvalidExternalAdministratorSid – neplatné nebo chybějící ID objektu externího správce. 400 InvalidExternalAdministratorTenantId – neplatné nebo chybějící ID tenanta externího správce. 400 ExternalAdministratorPrincipalType – neplatný nebo chybějící typ objektu zabezpečení externího správce. Vyberte možnost Uživatel, Aplikace nebo Skupina. 400 MissingExternalAdministratorWithAadOnlyAuth – Pokud chcete použít pouze ověřování Azure AD, uveďte podrobnosti o externím správci. 400 ExternalAdministratorLoginSameAsSqlAdmin – Jména správce Azure Active Directory a účtu správce serveru se musí lišit. Zadejte jiné hodnoty. 404 SubscriptionDoesNotHaveServer – požadovaný server nebyl nalezen. 404 ServerNotInSubscriptionResourceGroup – zadaný server neexistuje v zadané skupině prostředků a předplatném. 404 OperationIdNotFound – operace s ID neexistuje. 404 SubscriptionNotFound –Požadované předplatné nebylo nalezeno. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 409 UpsertLogicalServerRequestAlreadyInProgress – probíhající požadavek logického serveru již probíhá. Zkuste prosím požadavek zopakovat později. 409 ServerDisabled – Server je zakázaný. 409 ConflictingServerOperation – aktuálně probíhá operace pro server. 409 SubscriptionDisabled – Předplatné je zakázané. 409 ServerQuotaExceed – Server nelze přidat do předplatného, protože překročí kvótu. 409 ServerAlreadyExists – duplicitní název serveru. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 ConflictingSubscriptionOperation – aktuálně probíhá operace pro předplatné. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

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

Ukázková odpověď

Stavový kód:: 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"
          }
        }
      }
    ]
  }
}

Stavový kód:: 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"
          }
        }
      }
    ]
  }
}

Stavový kód:: 202

Definice

Name	Description
AdministratorType	Typ správce serveru.
IdentityType	Typ identity. Tuto možnost nastavte na SystemAssigned, aby se pro prostředek automaticky vytvořil a přiřadil objekt zabezpečení Služby Azure Active Directory.
PrincipalType	Typ objektu zabezpečení správce serveru.
PrivateEndpointConnectionProperties	Vlastnosti připojení privátního koncového bodu.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Stav připojení privátního koncového bodu
PrivateLinkServiceConnectionStateActionsRequire	Akce vyžadované pro připojení služby Private Link.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	Stav připojení služby Private Link.
ResourceIdentity	Konfigurace identity Azure Active Directory pro prostředek
Server	Databázový server Azure SQL.
ServerExternalAdministrator	Vlastnosti správce služby Active Directory.
ServerNetworkAccessFlag	Určuje, jestli je pro tento server povolený přístup z veřejného koncového bodu. Hodnota je nepovinná, ale pokud je předána, musí být Povolená nebo Zakázaná.
ServerPrivateEndpointConnection	Připojení privátního koncového bodu pod serverem
ServerWorkspaceFeature	Určuje, jestli má existující server vytvořený pracovní prostor a jestli umožňuje připojení z pracovního prostoru.
UserIdentity	Konfigurace identity Azure Active Directory pro prostředek

AdministratorType

Typ správce serveru.

Name	Typ	Description
ActiveDirectory	string

IdentityType

Typ identity. Tuto možnost nastavte na SystemAssigned, aby se pro prostředek automaticky vytvořil a přiřadil objekt zabezpečení Služby Azure Active Directory.

Name	Typ	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

PrincipalType

Typ objektu zabezpečení správce serveru.

Name	Typ	Description
Application	string
Group	string
User	string

PrivateEndpointConnectionProperties

Vlastnosti připojení privátního koncového bodu.

Name	Typ	Description
groupIds	string[]	ID skupin.
privateEndpoint	PrivateEndpointProperty	Privátní koncový bod, ke kterému připojení patří.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Stav připojení privátního koncového bodu.
provisioningState	PrivateEndpointProvisioningState	Stav připojení privátního koncového bodu

PrivateEndpointProperty

Name	Typ	Description
id	string	ID prostředku privátního koncového bodu

PrivateEndpointProvisioningState

Stav připojení privátního koncového bodu

Name	Typ	Description
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

Akce vyžadované pro připojení služby Private Link.

Name	Typ	Description
None	string

PrivateLinkServiceConnectionStateProperty

Name	Typ	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	Akce vyžadované pro připojení služby Private Link.
description	string	Popis připojení služby Private Link.
status	PrivateLinkServiceConnectionStateStatus	Stav připojení služby Private Link.

PrivateLinkServiceConnectionStateStatus

Stav připojení služby Private Link.

Name	Typ	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

ResourceIdentity

Konfigurace identity Azure Active Directory pro prostředek

Name	Typ	Description
principalId	string	ID objektu zabezpečení Azure Active Directory.
tenantId	string	ID tenanta Azure Active Directory.
type	IdentityType	Typ identity. Tuto možnost nastavte na SystemAssigned, aby se pro prostředek automaticky vytvořil a přiřadil objekt zabezpečení Služby Azure Active Directory.
userAssignedIdentities	<string, UserIdentity>	ID prostředků identit přiřazených uživatelem, které se mají použít

Server

Databázový server Azure SQL.

Name	Typ	Description
id	string	ID prostředku.
identity	ResourceIdentity	Identita serveru v Azure Active Directory.
kind	string	Druh sql serveru. Jedná se o metadata používaná pro Azure Portal prostředí.
location	string	Umístění prostředku.
name	string	Název prostředku.
properties.administratorLogin	string	Uživatelské jméno správce pro server. Po vytvoření jej nelze změnit.
properties.administratorLoginPassword	string	Přihlašovací heslo správce (vyžadované pro vytvoření serveru)
properties.administrators	ServerExternalAdministrator	Správce Azure Active Directory serveru.
properties.federatedClientId	string	ID klienta použité pro scénář klíče CMK napříč tenanty
properties.fullyQualifiedDomainName	string	Plně kvalifikovaný název domény serveru.
properties.keyId	string	Identifikátor URI klíče cmk, který se má použít k šifrování.
properties.minimalTlsVersion	string	Minimální verze protokolu TLS. Povolené hodnoty: 1.0, 1.1, 1.2
properties.primaryUserAssignedIdentityId	string	ID prostředku identity přiřazené uživatelem, které se použije ve výchozím nastavení.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Seznam připojení privátních koncových bodů na serveru
properties.publicNetworkAccess	ServerNetworkAccessFlag	Určuje, jestli je pro tento server povolený přístup z veřejného koncového bodu. Hodnota je nepovinná, ale pokud je předána, musí být Povolená nebo Zakázaná.
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Určuje, zda se má omezit odchozí síťový přístup pro tento server. Hodnota je nepovinná, ale pokud je předána, musí být Povolená nebo Zakázaná.
properties.state	string	Stav serveru.
properties.version	string	Verze serveru.
properties.workspaceFeature	ServerWorkspaceFeature	Určuje, jestli má existující server vytvořený pracovní prostor a jestli umožňuje připojení z pracovního prostoru.
tags	object	Značky prostředků.
type	string	Typ prostředku.

ServerExternalAdministrator

Vlastnosti správce služby Active Directory.

Name	Typ	Description
administratorType	AdministratorType	Typ správce serveru.
azureADOnlyAuthentication	boolean	Povolené ověřování pouze v Azure Active Directory.
login	string	Přihlašovací jméno správce serveru.
principalType	PrincipalType	Typ objektu zabezpečení správce serveru.
sid	string	IDENTIFIKÁTOR SID (ID objektu) správce serveru.
tenantId	string	ID tenanta správce.

ServerNetworkAccessFlag

Určuje, jestli je pro tento server povolený přístup z veřejného koncového bodu. Hodnota je nepovinná, ale pokud je předána, musí být Povolená nebo Zakázaná.

Name	Typ	Description
Disabled	string
Enabled	string

ServerPrivateEndpointConnection

Připojení privátního koncového bodu pod serverem

Name	Typ	Description
id	string	ID prostředku.
properties	PrivateEndpointConnectionProperties	Vlastnosti připojení privátního koncového bodu

ServerWorkspaceFeature

Určuje, jestli má existující server vytvořený pracovní prostor a jestli umožňuje připojení z pracovního prostoru.

Name	Typ	Description
Connected	string
Disconnected	string

UserIdentity