Sdílet prostřednictvím


Servers - Create Or Update

Vytvoří nebo aktualizuje server.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2023-08-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 Manageru nebo 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 azure Active Directory serveru.

properties.administratorLogin

string

Uživatelské jméno správce pro server. Po vytvoření se nedá změnit.

properties.administratorLoginPassword

string

Přihlašovací heslo správce (vyžaduje se k vytvoření serveru).

properties.administrators

ServerExternalAdministrator

Správce azure Active Directory serveru. Tuto možnost lze použít pouze v době vytvoření serveru. Pokud se používá pro aktualizaci serveru, bude ignorován nebo dojde k chybě. Pro aktualizace bude potřeba použít jednotlivá rozhraní API.

properties.federatedClientId

string (uuid)

ID klienta používaného pro scénář cmk napříč tenanty

properties.isIPv6Enabled

ServerNetworkAccessFlag

Jestli chcete povolit podporu protokolu IPv6 pro tento server, nebo ne. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno).

properties.keyId

string

Identifikátor URI klíče CMK, který se má použít k šifrování.

properties.minimalTlsVersion

MinimalTlsVersion

Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2, 1.2, 1.3

properties.primaryUserAssignedIdentityId

string

ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení.

properties.publicNetworkAccess

ServerPublicNetworkAccessFlag

Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu nebo ne. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno) nebo SecuredByPerimeter (SecuredByPerimeter).

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Určuje, jestli chcete omezit odchozí síťový přístup pro tento server. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno).

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řijal

Hlavičky

Location: string

Other Status Codes

ErrorResponse

Chybové odpovědi: ***

  • 400 ManagedInstanceStoppingOrStopped – Konfliktní operace odeslaná, když je instance v zastaveném nebo zastaveném stavu

  • 400 ManagedInstanceStarting – Konfliktní operace odeslaná při spuštění instance

  • 400 NameAlreadyExistsSoftDeleted – požadovaný název serveru převezme server ve stavu obnovitelného odstranění. Vyprázdnění nebo obnovení serveru, aby se odblokuje.

  • 400 MissingIdentityId – Pokud je typ identity nastavený na UserAssigned, není zadána žádná identita přiřazená uživatelem.

  • 400 InvalidPrimaryIdentityId – Uživatel poskytuje hodnotu PrimaryUserIdentityId, ale stejná hodnota není uvedená v parametru IdentityId.

  • 400 PECsNotExistingToDenyPublicNetworkAccess – Nelze nastavit odepření přístupu k veřejné síti 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 autorizátoru operace prostředků tak, jak je, beze změn.

  • 400 PrimaryIdentityMissingPermissionForKeyId – Id klíče poskytuje uživatel během vytváření, ale v volání rozhraní API není k dispozici PrimaryUserAssignedIdentityId.

  • 400 InvalidIdentityTypeForKeyId – Id klíče poskytuje uživatel během vytváření, ale typ identity není nastavený na 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 v dané 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 není podporovaná verze serveru.

  • 400 PasswordTooLong - Zadané heslo je příliš dlouhé.

  • 400 PasswordNotComplex - Zadané heslo není dostatečně složité.

  • 400 InvalidParameterValue – Parametr dostal neplatnou hodnotu.

  • 400 InvalidLocation – Bylo zadáno neplatné umístění.

  • 400 InvalidServerName – zadaný neplatný název serveru.

  • 400 InvalidIdentifier – identifikátor obsahuje hodnotu NULL nebo neplatný znak unicode.

  • 400 TokenTooLong - Poskytnutý token je příliš dlouhý.

  • 400 CMKOperationNotAllowed – Uživatel se pokusil provést operaci na serveru, když server neměl přístup ke službě Azure Key Vault.

  • 400 ServerNotFound – Požadovaný server nebyl nalezen.

  • 400 RegionDoesNotAllowProvisioning – Vybrané umístění nepřijímá nové servery služby Windows Azure SQL Database. To se může později změnit.

  • 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 prosím uživatele, aplikaci nebo skupinu.

  • 400 MissingExternalAdministratorWithAadOnlyAuth – Pokud chcete použít pouze ověřování Azure AD, uveďte podrobnosti o externím správci.

  • 400 ExternalAdministratorLoginSameAsSqlAdmin – Názvy správce Azure Active Directory a účtu správce serveru se musí lišit. Zadejte jiné hodnoty.

  • 400 ServerAdministratorNameAlreadyExists – Uživatel se pokusil nastavit externího správce a hlavní název již existuje v hlavní databázi.

  • 404 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném.

  • 404 SubscriptionDoesNotHaveServer – Požadovaný server nebyl nalezen.

  • 404 OperationIdNotFound – operace s ID neexistuje.

  • 404 SubscriptionNotFound – Požadované předplatné nebylo nalezeno.

  • 409 CannotCancelOperation – Operace správy je ve stavu, který nelze zrušit.

  • 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í na stejném prostředku.

  • 409 UpsertLogicalServerRequestAlreadyInProgress – probíhající požadavek logického serveru již probíhá, zkuste 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 ServerQuotaExceeded – 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ích požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 KonfliktníSubscriptionOperation – Aktuálně probíhá operace pro předplatné.

  • 500 OperationTimedOut – Vypršel časový limit operace a automaticky se vrátil zpět. Zkuste operaci zopakovat.

  • 503 TooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 503 TooManyRequests – Požadavky nad rámec maximálních 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=2023-08-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",
    "isIPv6Enabled": "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",
    "isIPv6Enabled": "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",
    "isIPv6Enabled": "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.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď

ExternalGovernanceStatus

Stav externích zásad správného řízení

IdentityType

Typ identity. Nastavte ho na SystemAssigned, aby se automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory pro daný prostředek.

MinimalTlsVersion

Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2, 1.2, 1.3

PrincipalType

Hlavní typ 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

Server Azure SQL Database.

ServerExternalAdministrator

Vlastnosti správce služby Active Directory

ServerNetworkAccessFlag

Určuje, jestli chcete omezit odchozí síťový přístup pro tento server. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno).

ServerPrivateEndpointConnection

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

ServerPublicNetworkAccessFlag

Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu nebo ne. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno) nebo SecuredByPerimeter (SecuredByPerimeter).

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.

Hodnota Description
ActiveDirectory

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby.

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva.

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

ExternalGovernanceStatus

Stav externích zásad správného řízení

Hodnota Description
Enabled
Disabled

IdentityType

Typ identity. Nastavte ho na SystemAssigned, aby se automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory pro daný prostředek.

Hodnota Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

MinimalTlsVersion

Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2, 1.2, 1.3

Hodnota Description
None
1.0
1.1
1.2
1.3

PrincipalType

Hlavní typ správce serveru.

Hodnota Description
User
Group
Application

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

Hodnota Description
Approving
Ready
Dropping
Failed
Rejecting

PrivateLinkServiceConnectionStateActionsRequire

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

Hodnota Description
None

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.

Hodnota Description
Approved
Pending
Rejected
Disconnected

ResourceIdentity

Konfigurace identity Azure Active Directory pro prostředek

Name Typ Description
principalId

string (uuid)

ID objektu zabezpečení Azure Active Directory.

tenantId

string (uuid)

ID tenanta Azure Active Directory.

type

IdentityType

Typ identity. Nastavte ho na SystemAssigned, aby se automaticky vytvořil a přiřadil objekt zabezpečení Azure Active Directory pro daný prostředek.

userAssignedIdentities

<string,  UserIdentity>

ID prostředků identit přiřazených uživatelem, které se mají použít

Server

Server Azure SQL Database.

Name Typ Description
id

string

ID prostředku.

identity

ResourceIdentity

Identita azure Active Directory serveru.

kind

string

Druh sql serveru. Toto jsou metadata používaná pro prostředí webu Azure Portal.

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í se nedá změnit.

properties.administratorLoginPassword

string

Přihlašovací heslo správce (vyžaduje se k vytvoření serveru).

properties.administrators

ServerExternalAdministrator

Správce azure Active Directory serveru. Tuto možnost lze použít pouze v době vytvoření serveru. Pokud se používá pro aktualizaci serveru, bude ignorován nebo dojde k chybě. Pro aktualizace bude potřeba použít jednotlivá rozhraní API.

properties.externalGovernanceStatus

ExternalGovernanceStatus

Stav externích zásad správného řízení

properties.federatedClientId

string (uuid)

ID klienta používaného pro scénář cmk napříč tenanty

properties.fullyQualifiedDomainName

string

Plně kvalifikovaný název domény serveru.

properties.isIPv6Enabled

ServerNetworkAccessFlag

Jestli chcete povolit podporu protokolu IPv6 pro tento server, nebo ne. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno).

properties.keyId

string

Identifikátor URI klíče CMK, který se má použít k šifrování.

properties.minimalTlsVersion

MinimalTlsVersion

Minimální verze protokolu TLS. Povolené hodnoty: None, 1.0, 1.1, 1.2, 1.2, 1.3

properties.primaryUserAssignedIdentityId

string

ID prostředku identity přiřazené uživatelem, které se má použít ve výchozím nastavení.

properties.privateEndpointConnections

ServerPrivateEndpointConnection[]

Seznam připojení privátních koncových bodů na serveru

properties.publicNetworkAccess

ServerPublicNetworkAccessFlag

Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu nebo ne. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno) nebo SecuredByPerimeter (SecuredByPerimeter).

properties.restrictOutboundNetworkAccess

ServerNetworkAccessFlag

Určuje, jestli chcete omezit odchozí síťový přístup pro tento server. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno).

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

Je povoleno pouze ověřování Azure Active Directory.

login

string

Přihlašovací jméno správce serveru.

principalType

PrincipalType

Hlavní typ správce serveru.

sid

string (uuid)

IDENTIFIKÁTOR SID (ID objektu) správce serveru.

tenantId

string (uuid)

ID tenanta správce.

ServerNetworkAccessFlag

Určuje, jestli chcete omezit odchozí síťový přístup pro tento server. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno).

Hodnota Description
Enabled
Disabled

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

ServerPublicNetworkAccessFlag

Určuje, jestli je pro tento server povolený přístup k veřejnému koncovému bodu nebo ne. Hodnota je nepovinná, ale pokud je předaná, musí být Enabled (Povoleno) nebo Disabled (Zakázáno) nebo SecuredByPerimeter (SecuredByPerimeter).

Hodnota Description
Enabled
Disabled
SecuredByPerimeter

ServerWorkspaceFeature

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

Hodnota Description
Connected
Disconnected

UserIdentity

Konfigurace identity Azure Active Directory pro prostředek

Name Typ Description
clientId

string (uuid)

ID klienta Azure Active Directory.

principalId

string (uuid)

ID objektu zabezpečení Azure Active Directory.