Servers - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Bir sunucu oluşturur veya güncelleştirir.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceGroupName	path	True	string	Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
serverName	path	True	string	Sunucunun adı.
subscriptionId	path	True	string	Azure aboneliğini tanımlayan abonelik kimliği.
api-version	query	True	string	İstek için kullanılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
location	True	string	Kaynak konumu.
identity		ResourceIdentity	Sunucunun Azure Active Directory kimliği.
properties.administratorLogin		string	Sunucu için yönetici kullanıcı adı. Oluşturulduktan sonra değiştirilemez.
properties.administratorLoginPassword		string	Yönetici oturum açma parolası (sunucu oluşturmak için gereklidir).
properties.administrators		ServerExternalAdministrator	Sunucunun Azure Active Directory yöneticisi.
properties.federatedClientId		string	Kiracılar arası CMK senaryosu için kullanılan İstemci kimliği
properties.keyId		string	Şifreleme için kullanılacak anahtarın CMK URI'si.
properties.minimalTlsVersion		string	En düşük TLS sürümü. İzin verilen değerler: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId		string	Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği.
properties.publicNetworkAccess		ServerNetworkAccessFlag	Bu sunucu için genel uç nokta erişimine izin verilip verilmeyeceği. Değer isteğe bağlıdır, ancak geçirilirse 'Etkin' veya 'Devre Dışı' olmalıdır
properties.restrictOutboundNetworkAccess		ServerNetworkAccessFlag	Bu sunucu için giden ağ erişiminin kısıtlanıp kısıtlanmadığı. Değer isteğe bağlıdır, ancak geçirilirse 'Etkin' veya 'Devre Dışı' olmalıdır
properties.version		string	Sunucunun sürümü.
tags		object	Kaynak etiketleri.

Yanıtlar

Name	Tür	Description
200 OK	Server	Sunucu başarıyla güncelleştirildi.
201 Created	Server	Sunucu başarıyla oluşturuldu.
202 Accepted		Kabul edildi
Other Status Codes		Hata Yanıtları: ** 400 MissingIdentityId - Kimlik türü UserAssigned olarak ayarlandığında kullanıcı tarafından atanan kimlik sağlanmadı 400 InvalidPrimaryIdentityId - Kullanıcı PrimaryUserIdentityId için bir değer sağlar, ancak identityid parametresinde aynı değer listelenmez 400 PECsNotExistingToDenyPublicNetworkAccess - Sunucuya erişmek için etkinleştirilmiş özel uç nokta olmadığından Genel Ağ Erişimini Reddet ayarı Evet olarak ayarlanamadı. Lütfen özel uç noktaları ayarlayın ve işlemi (https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database ) yeniden deneyin. 400 NameAlreadyExists - Sağlanan ad zaten var. 400 UmiMissingAkvPermissions - PrimaryUserAssignedIdentityId kullanıcı tarafından sağlanan KeyId erişimi yok 400 MissingPrimaryIdentity - Kullanıcı tarafından sağlanan PrimaryUserAssignedIdentityId, sağlanan KeyId erişimine sahip değil 400 ProvisioningDisabled - Kaynak işlem yetkilisinden gelen hata iletisini olduğu gibi, değişiklik yapmadan görüntüler 400 PrimaryIdentityMissingPermissionForKeyId - KeyId oluşturma sırasında kullanıcı tarafından sağlanır, ancak API çağrısında PrimaryUserAssignedIdentityId sağlanmaz 400 InvalidIdentityTypeForKeyId - KeyId oluşturma sırasında kullanıcı tarafından sağlanır ancak kimlik türü 'UserAssigned' olarak ayarlanmamış 400 InvalidLoginName - Sağlanan oturum açma adı geçersiz. 400 InvalidUsername - Sağlanan kullanıcı adı geçersiz karakterler içeriyor. 400 Ipv6FeatureNotEnabled - Kullanıcı, abonelikte özellik bayrağını etkinleştirmeden sunucuda Ipv6 desteğini açmaya çalıştı veya özellik desteği şu anda bölgede devre dışı bırakıldı. 400 PasswordTooShort - Sağlanan parola çok kısa 400 AadOnlyAuthenticationIsEnabled - Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi. Sistem yöneticinize başvurun. 400 RegionDoesNotSupportVersion - Kullanıcı, bu sunucu sürümünün desteklenmediği bir konumda belirtilen sürüme sahip bir sunucu oluşturmaya çalıştı. 400 PasswordTooLong - Sağlanan parola çok uzun. 400 PasswordNotComplex - Sağlanan parola yeterince karmaşık değil. 400 InvalidParameterValue - Parametreye geçersiz bir değer verildi. 400 InvalidLocation - Geçersiz bir konum belirtildi. 400 InvalidServerName - Geçersiz sunucu adı belirtildi. 400 InvalidIdentifier - Tanımlayıcı NULL veya geçersiz bir unicode karakter içeriyor. 400 TokenTooLong - Sağlanan belirteç çok uzun. 400 RegionDoesNotAllowProvisioning - Seçilen konum yeni Windows Azure SQL Veritabanı sunucularını kabul ediyor. Bu durum daha sonra değişebilir. 400 ServerNotFound - İstenen sunucu bulunamadı. 400 InvalidMinimalTlsVersion - Geçersiz en düşük TLS sürümü. 400 InvalidExternalAdministratorLogin - Geçersiz veya eksik dış yönetici oturum açma adı. 400 InvalidExternalAdministratorSid - Geçersiz veya eksik dış yönetici nesne kimliği. 400 InvalidExternalAdministratorTenantId - Geçersiz veya eksik dış yönetici kiracı kimliği. 400 ExternalAdministratorPrincipalType - Geçersiz veya eksik dış yönetici asıl türü. Lütfen Kullanıcı, Uygulama veya Grup'u seçin. 400 MissingExternalAdministratorWithAadOnlyAuth - Yalnızca Azure AD Kimlik Doğrulamasını kullanmak için lütfen bir dış yöneticinin ayrıntılarını sağlayın. 400 ExternalAdministratorLoginSameAsSqlAdmin - Azure Active Directory yöneticisinin ve sunucu yöneticisi hesabının adları farklı olmalıdır. Lütfen farklı değerler sağlayın. 404 SubscriptionDoesNotHaveServer - İstenen sunucu bulunamadı 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok. 404 OperationIdNotFound - Kimliği olan işlem yok. 404 SubscriptionNotFound - İstenen abonelik bulunamadı. 409 OperationCancelled - İşlem kullanıcı tarafından iptal edildi. 409 İşlem Kesildi - Aynı kaynakta başka bir işlem tarafından kesintiye uğradığından kaynak üzerindeki işlem tamamlanamadı. 409 UpsertLogicalServerRequestAlreadyInProgress - Devam eden bir mantıksal sunucu isteği zaten devam ediyor, lütfen isteğinizi daha sonra yeniden deneyin. 409 ServerDisabled - Sunucu devre dışı bırakıldı. 409 ConflictingServerOperation - Sunucu için şu anda bir işlem devam ediyor. 409 SubscriptionDisabled - Abonelik devre dışı bırakıldı. 409 ServerQuotaExceeded - Sunucu, kotayı aşacağından aboneliğe eklenemiyor. 409 ServerAlreadyExists - Yinelenen sunucu adı. 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler. 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler. 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler. 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum istekler dışında istekler. 429 ConflictingSubscriptionOperation - Abonelik için şu anda bir işlem devam ediyor. 500 OperationTimedOut - İşlem zaman aşımına uğradı ve otomatik olarak geri alındı. Lütfen işlemi yeniden deneyin. 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler. 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteğin ötesindeki istekler.

Örnekler

Create server

Sample Request

HTTP

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

Java

import com.azure.core.util.Context;
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),
            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

Sample Response

Status code:

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

Status code:

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

Status code:

202

Tanımlar

Name	Description
AdministratorType	Sunucu yöneticisinin türü.
IdentityType	Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.
PrincipalType	Sunucu yöneticisinin Asıl Türü.
PrivateEndpointConnectionProperties	Özel uç nokta bağlantısının özellikleri.
PrivateEndpointProperty
PrivateEndpointProvisioningState	Özel uç nokta bağlantısının durumu.
PrivateLinkServiceConnectionStateActionsRequire	Özel bağlantı hizmeti bağlantısı için gereken eylemler.
PrivateLinkServiceConnectionStateProperty
PrivateLinkServiceConnectionStateStatus	Özel bağlantı hizmeti bağlantı durumu.
ResourceIdentity	Bir kaynak için Azure Active Directory kimlik yapılandırması.
Server	bir Azure SQL Veritabanı sunucusu.
ServerExternalAdministrator	Active Directory yöneticisinin özellikleri.
ServerNetworkAccessFlag	Bu sunucu için genel uç nokta erişimine izin verilip verilmeyeceği. Değer isteğe bağlıdır, ancak geçirilirse 'Etkin' veya 'Devre Dışı' olmalıdır
ServerPrivateEndpointConnection	Sunucu altında özel uç nokta bağlantısı
ServerWorkspaceFeature	Var olan sunucunun oluşturulmuş bir çalışma alanı olup olmadığı ve çalışma alanından bağlantıya izin verip vermediği
UserIdentity	Bir kaynak için Azure Active Directory kimlik yapılandırması.

AdministratorType

Sunucu yöneticisinin türü.

Name	Tür	Description
ActiveDirectory	string

IdentityType

Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.

Name	Tür	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

PrincipalType

Sunucu yöneticisinin Asıl Türü.

Name	Tür	Description
Application	string
Group	string
User	string

PrivateEndpointConnectionProperties

Özel uç nokta bağlantısının özellikleri.

Name	Tür	Description
groupIds	string[]	Grup kimlikleri.
privateEndpoint	PrivateEndpointProperty	Bağlantının ait olduğu özel uç nokta.
privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Özel uç nokta bağlantısının bağlantı durumu.
provisioningState	PrivateEndpointProvisioningState	Özel uç nokta bağlantısının durumu.

PrivateEndpointProperty

Name	Tür	Description
id	string	Özel uç noktanın kaynak kimliği.

PrivateEndpointProvisioningState

Özel uç nokta bağlantısının durumu.

Name	Tür	Description
Approving	string
Dropping	string
Failed	string
Ready	string
Rejecting	string

PrivateLinkServiceConnectionStateActionsRequire

Özel bağlantı hizmeti bağlantısı için gereken eylemler.

Name	Tür	Description
None	string

PrivateLinkServiceConnectionStateProperty

Name	Tür	Description
actionsRequired	PrivateLinkServiceConnectionStateActionsRequire	Özel bağlantı hizmeti bağlantısı için gereken eylemler.
description	string	Özel bağlantı hizmeti bağlantı açıklaması.
status	PrivateLinkServiceConnectionStateStatus	Özel bağlantı hizmeti bağlantı durumu.

PrivateLinkServiceConnectionStateStatus

Özel bağlantı hizmeti bağlantı durumu.

Name	Tür	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

ResourceIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

Name	Tür	Description
principalId	string	Azure Active Directory asıl kimliği.
tenantId	string	Azure Active Directory kiracı kimliği.
type	IdentityType	Kimlik türü. Kaynak için otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.
userAssignedIdentities	<string,  UserIdentity>	Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri

Server

bir Azure SQL Veritabanı sunucusu.

Name	Tür	Description
id	string	Kaynak Kimliği.
identity	ResourceIdentity	Sunucunun Azure Active Directory kimliği.
kind	string	Sql server türü. Bu, Azure portal deneyimi için kullanılan meta verilerdir.
location	string	Kaynak konumu.
name	string	Kaynak adı.
properties.administratorLogin	string	Sunucu için yönetici kullanıcı adı. Oluşturulduktan sonra değiştirilemez.
properties.administratorLoginPassword	string	Yönetici oturum açma parolası (sunucu oluşturmak için gereklidir).
properties.administrators	ServerExternalAdministrator	Sunucunun Azure Active Directory yöneticisi.
properties.federatedClientId	string	Kiracılar arası CMK senaryosu için kullanılan İstemci kimliği
properties.fullyQualifiedDomainName	string	Sunucunun tam etki alanı adı.
properties.keyId	string	Şifreleme için kullanılacak anahtarın CMK URI'si.
properties.minimalTlsVersion	string	En düşük TLS sürümü. İzin verilen değerler: '1.0', '1.1', '1.2'
properties.primaryUserAssignedIdentityId	string	Varsayılan olarak kullanılacak kullanıcı tarafından atanan kimliğin kaynak kimliği.
properties.privateEndpointConnections	ServerPrivateEndpointConnection[]	Sunucudaki özel uç nokta bağlantılarının listesi
properties.publicNetworkAccess	ServerNetworkAccessFlag	Bu sunucu için genel uç nokta erişimine izin verilip verilmeyeceği. Değer isteğe bağlıdır, ancak geçirilirse 'Etkin' veya 'Devre Dışı' olmalıdır
properties.restrictOutboundNetworkAccess	ServerNetworkAccessFlag	Bu sunucu için giden ağ erişiminin kısıtlanıp kısıtlanmadığı. Değer isteğe bağlıdır, ancak geçirilirse 'Etkin' veya 'Devre Dışı' olmalıdır
properties.state	string	Sunucunun durumu.
properties.version	string	Sunucunun sürümü.
properties.workspaceFeature	ServerWorkspaceFeature	Var olan sunucunun oluşturulmuş bir çalışma alanı olup olmadığı ve çalışma alanından bağlantıya izin verip vermediği
tags	object	Kaynak etiketleri.
type	string	Kaynak türü.

ServerExternalAdministrator

Active Directory yöneticisinin özellikleri.

Name	Tür	Description
administratorType	AdministratorType	Sunucu yöneticisinin türü.
azureADOnlyAuthentication	boolean	Yalnızca Azure Active Directory Kimlik Doğrulaması etkinleştirildi.
login	string	Sunucu yöneticisinin oturum açma adı.
principalType	PrincipalType	Sunucu yöneticisinin Asıl Türü.
sid	string	Sunucu yöneticisinin SID (nesne kimliği).
tenantId	string	Yöneticinin kiracı kimliği.

ServerNetworkAccessFlag

Bu sunucu için genel uç nokta erişimine izin verilip verilmeyeceği. Değer isteğe bağlıdır, ancak geçirilirse 'Etkin' veya 'Devre Dışı' olmalıdır

Name	Tür	Description
Disabled	string
Enabled	string

ServerPrivateEndpointConnection

Sunucu altında özel uç nokta bağlantısı

Name	Tür	Description
id	string	Kaynak Kimliği.
properties	PrivateEndpointConnectionProperties	Özel uç nokta bağlantı özellikleri

ServerWorkspaceFeature

Var olan sunucunun oluşturulmuş bir çalışma alanı olup olmadığı ve çalışma alanından bağlantıya izin verip vermediği

Name	Tür	Description
Connected	string
Disconnected	string

UserIdentity

Bir kaynak için Azure Active Directory kimlik yapılandırması.

Name	Tür	Description
clientId	string	Azure Active Directory istemci kimliği.
principalId	string	Azure Active Directory asıl kimliği.