Servers - Create Or Update

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

Ukázkový požadavek

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

Ukázková odpověď

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

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

Konfigurace identity Azure Active Directory pro prostředek

Name Typ Description
clientId

string

ID klienta Azure Active Directory.

principalId

string

ID objektu zabezpečení Azure Active Directory.