Servers - Create Or Update

Služba:: SQL Database

Verze rozhraní API:: 2025-01-01

Vytvoří nebo aktualizuje server.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
serverName	path	True	string	Název serveru.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
location	True	string	Geografické umístění, ve kterém se nachází zdroj
identity		ResourceIdentity	Identita serveru v Azure Active Directory.
properties.administratorLogin		string	Uživatelské jméno správce pro server. Po vytvoření se nedá změnit.
properties.administratorLoginPassword		string (password)	Přihlašovací heslo správce (vyžaduje se k vytvoření serveru).
properties.administrators		ServerExternalAdministrator	Správce Azure Active Directory lze využít při vytváření serveru a při aktualizacích serveru, kromě vlastnosti azureADOnlyAuthentication. Pokud chcete aktualizovat vlastnost azureADOnlyAuthentication, je nutné použít jednotlivé rozhraní API.
properties.createMode		ServerCreateMode	Režim vytvoření pro server, platné pouze hodnoty jsou Normální a Obnovit.
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.retentionDays		integer (int32)	Počet dní, po které zůstane tento server odstraněn.
properties.version		string	Verze serveru.
tags		object	Značky prostředků

Odpovědi

Name	Typ	Description
200 OK	Server	Operace aktualizace prostředku Server byla úspěšná
201 Created	Server	Operace vytvoření prostředku "Server" byla úspěšná Hlavičky Location: string Retry-After: integer
202 Accepted		Operace prostředku byla přijata. Hlavičky Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

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=2025-01-01

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/SQL/stable/2025-01-01/examples/ServerCreate.json
// this example is just showing the usage of "Servers_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "sqlcrudtest-7398";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this SqlServerResource
SqlServerCollection collection = resourceGroupResource.GetSqlServers();

// invoke the operation
string serverName = "sqlcrudtest-4645";
SqlServerData data = new SqlServerData(new AzureLocation("Japan East"))
{
    AdministratorLogin = "dummylogin",
    AdministratorLoginPassword = "PLACEHOLDER",
    PublicNetworkAccess = ServerNetworkAccessFlag.Enabled,
    Administrators = new ServerExternalAdministrator
    {
        PrincipalType = SqlServerPrincipalType.User,
        Login = "bob@contoso.com",
        Sid = Guid.Parse("00000011-1111-2222-2222-123456789111"),
        TenantId = Guid.Parse("00000011-1111-2222-2222-123456789111"),
        IsAzureADOnlyAuthenticationEnabled = true,
    },
    RestrictOutboundNetworkAccess = ServerNetworkAccessFlag.Enabled,
    IsIPv6Enabled = ServerNetworkAccessFlag.Enabled,
    RetentionDays = 7,
    CreateMode = SqlServerCreateMode.Normal,
};
ArmOperation<SqlServerResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, serverName, data);
SqlServerResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlServerData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

{
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "kind": "v12.0",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "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": {
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "description": "Auto-approved",
            "actionsRequired": "None",
            "status": "Approved"
          },
          "provisioningState": "Ready"
        }
      }
    ],
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "retentionDays": 7,
    "state": "Ready",
    "version": "12.0"
  }
}

Stavový kód:: 201

{
  "name": "sqlcrudtest-4645",
  "type": "Microsoft.Sql/servers",
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645",
  "kind": "v12.0",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "fullyQualifiedDomainName": "sqlcrudtest-4645.database.windows.net",
    "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": {
          "privateEndpoint": {
            "id": "/subscriptions/55555555-6666-7777-8888-999999999999/resourceGroups/Default-Network/providers/Microsoft.Network/privateEndpoints/private-endpoint-name"
          },
          "privateLinkServiceConnectionState": {
            "description": "Auto-approved",
            "actionsRequired": "None",
            "status": "Approved"
          },
          "provisioningState": "Ready"
        }
      }
    ],
    "publicNetworkAccess": "Enabled",
    "restrictOutboundNetworkAccess": "Enabled",
    "retentionDays": 7,
    "state": "Ready",
    "version": "12.0"
  }
}

Stavový kód:: 202

Definice

Name	Description
AdministratorType	Typ správce serveru.
createdByType	Typ identity, která prostředek vytvořila.
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 to na 'SystemAssigned', abyste automaticky vytvořili a přiřadili princip Azure Active Directory pro tento zdroj.
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	Azure Active Directory identity configuration for a resource.
Server	An Azure SQL Database server.
ServerCreateMode	Režim vytvoření pro server, platné pouze hodnoty jsou Normální a Obnovit.
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.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
UserIdentity	Azure Active Directory identity configuration for a resource.

AdministratorType

Výčet

Typ správce serveru.

Hodnota	Description
ActiveDirectory	Active Directory

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objekt

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

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

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

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

ExternalGovernanceStatus

Výčet

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

Hodnota	Description
Enabled	Enabled
Disabled	Disabled

IdentityType

Výčet

Typ identity. Nastavte to na 'SystemAssigned', abyste automaticky vytvořili a přiřadili princip Azure Active Directory pro tento zdroj.

Hodnota	Description
None	None
SystemAssigned	Přiřazen systémem
UserAssigned	Přiřazeno uživatelem
SystemAssigned,UserAssigned	SystémPřiřazené,Přiřazené uživatelem

MinimalTlsVersion

Výčet

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

Hodnota	Description
None	None
1.0	1.0
1.1	1.1
1.2	1,2
1.3	1.3

PrincipalType

Výčet

Hlavní typ správce serveru.

Hodnota	Description
User	User
Group	Skupina
Application	Přihláška

PrivateEndpointConnectionProperties

Objekt

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

Objekt

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

PrivateEndpointProvisioningState

Výčet

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

Hodnota	Description
Approving	Schvalování
Ready	Ready
Dropping	Upuštění
Failed	Nezdařilo se
Rejecting	Odmítnutí

PrivateLinkServiceConnectionStateActionsRequire

Výčet

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

Hodnota	Description
None	None

PrivateLinkServiceConnectionStateProperty

Objekt

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

Výčet

Stav připojení služby Private Link.

Hodnota	Description
Approved	Schváleno
Pending	Čeká na vyřízení
Rejected	Odmítnuto
Disconnected	Disconnected

ResourceIdentity

Objekt

Azure Active Directory identity configuration for a resource.

Name	Typ	Description
principalId	string (uuid)	The Azure Active Directory principal id.
tenantId	string (uuid)	Tenant id Azure Active Directory.
type	IdentityType	Typ identity. Nastavte to na 'SystemAssigned', abyste automaticky vytvořili a přiřadili princip Azure Active Directory pro tento zdroj.
userAssignedIdentities	<string, UserIdentity>	ID prostředků identit přiřazených uživatelem, které se mají použít

Server

Objekt

An Azure SQL Database server.

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ResourceIdentity	Identita serveru v Azure Active Directory.
kind	string	Druh sql serveru. Toto jsou metadata používaná pro Azure portálový zážitek.
location	string	Geografické umístění, ve kterém se nachází zdroj
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 (password)	Přihlašovací heslo správce (vyžaduje se k vytvoření serveru).
properties.administrators	ServerExternalAdministrator	Správce Azure Active Directory lze využít při vytváření serveru a při aktualizacích serveru, kromě vlastnosti azureADOnlyAuthentication. Pokud chcete aktualizovat vlastnost azureADOnlyAuthentication, je nutné použít jednotlivé rozhraní API.
properties.createMode	ServerCreateMode	Režim vytvoření pro server, platné pouze hodnoty jsou Normální a Obnovit.
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.retentionDays	integer (int32)	Počet dní, po které zůstane tento server odstraněn.
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.
systemData	systemData	Azure Resource Manager metadata obsahující informace createdBy a modifiedBy.
tags	object	Značky prostředků
type	string	Typ prostředku. Například "Microsoft. Compute/virtualMachines" nebo "Microsoft. Úložiště/úložištěÚčty"

ServerCreateMode

Výčet

Režim vytvoření pro server, platné pouze hodnoty jsou Normální a Obnovit.

Hodnota	Description
Normal	Normální
Restore	Restore

ServerExternalAdministrator

Objekt

Vlastnosti správce služby Active Directory

Name	Typ	Description
administratorType	AdministratorType	Typ správce serveru.
azureADOnlyAuthentication	boolean	Azure Active Directory pouze Authentication povolen.
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

Výčet

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	Enabled
Disabled	Disabled

ServerPrivateEndpointConnection

Objekt

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

Výčet

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	Enabled
Disabled	Disabled
SecuredByPerimeter	SecuredByPerimeter

ServerWorkspaceFeature

Výčet

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

Hodnota	Description
Connected	Connected
Disconnected	Disconnected

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

UserIdentity

Objekt

Azure Active Directory identity configuration for a resource.

Name	Typ	Description
clientId	string (uuid)	Client ID Azure Active Directory.
principalId	string (uuid)	The Azure Active Directory principal id.