Servers - Create Or Update

Service:: SQL Database

API Version:: 2020-11-01-preview

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

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

URI Parametreleri

Name	In	Required	Type	Description
resourceGroupName	path	True	string	Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API 'sinden veya portalından elde edebilirsiniz.
serverName	path	True	string	Sunucunun adı.
subscriptionId	path	True	string	Bir 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	Required	Type	Description
location	True	string	Kaynak konumu.
identity		ResourceIdentityWithUserAssignedIdentities	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şturma için gereklidir).
properties.administrators		ServerExternalAdministrator	Sunucunun Azure Active Directory kimliği.
properties.keyId		string	Şifreleme için kullanılacak anahtarın CMK URI 'SI.
properties.minimalTlsVersion		string	En az 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		ServerPublicNetworkAccess	Bu sunucu için genel uç nokta erişimine izin verilip verilmeyeceğini belirtir. Değer isteğe bağlıdır, ancak geçirilmezse ' Enabled ' veya ' Disabled ' olmalıdır
properties.version		string	Sunucu sürümü.
tags		object	Kaynak etiketleri.

Yanıtlar

Name	Type	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 Amacgöztexistingtodenypublicnetworkaccess-sunucuya erişmek için etkin bir özel uç nokta olmadığından ortak ağ erişimini reddetme özelliği Evet olarak ayarlanamıyor. Lütfen özel uç noktaları ayarlayın ve işlemi yeniden deneyin ( https://docs.microsoft.com/azure/sql-database/sql-database-private-endpoint-overview#how-to-set-up-private-link-for-azure-sql-database) . 400 NameAlreadyExists-belirtilen ad zaten var. 400 ProvisioningDisabled-kaynak işlem yetkilendirmeden, değişiklikler olmadan, hata iletisini görüntüler 400 InvalidLoginName-girilen oturum açma adı geçersiz. 400 ınvalidusername-sağlanan Kullanıcı adı geçersiz karakterler içeriyor. 400 PasswordTooShort-girilen parola çok kısa 400 AadOnlyAuthenticationIsEnabled-Azure Active Directory yalnızca kimlik doğrulaması etkindir. Sistem yöneticinize başvurun. 400 Regionmayan Notsupportversion-Kullanıcı, sunucu sürümünün desteklenmediği bir konumda belirtilen bir sürümün sunucusunu oluşturmaya çalıştı. 400 PasswordTooLong-girilen parola çok uzun. 400 PasswordNotComplex-girilen parola yeterince karmaşık değil. 400 SubscriptionNotFound-istenen abonelik bulunamadı. 400 InvalidParameterValue-bir parametreye geçersiz bir değer verildi. 400 ınvalidlocation-geçersiz bir konum belirtildi. 400 ınvalidservername-geçersiz sunucu adı belirtildi. 400 InvalidIdentifier-tanımlayıcı NULL veya geçersiz bir Unicode karakteri içeriyor. 400 TokenTooLong-belirtilen belirteç çok uzun. 400 Regionınotallowsağlamasını-Seçili konum yeni Windows Azure SQL veritabanı sunucularını kabul etmiyor. Bu, daha sonraki bir zamanda değişebilir. 400 ServerNotFound-istenen sunucu bulunamadı. 400 ınvalidminimaltlsversion-geçersiz en az TLS sürümü. 400 ınvalidexternaladministratorlogin-geçersiz veya eksik dış yönetici oturum açma adı. 400 ınvalidexternaladministratorsıd-geçersiz veya eksik dış yönetici nesne kimliği. 400 ınvalidexternaladministratortenantıd-geçersiz veya eksik dış yönetici Kiracı kimliği. 400 Externaladministratorsprincipaltype-geçersiz veya eksik dış yönetici asıl türü. Lütfen Kullanıcı, uygulama veya grup arasından seçim yapın. 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. 404 Subscriptionlınothaveserver-istenen sunucu bulunamadı 404 ServerNotInSubscriptionResourceGroup-belirtilen sunucu, belirtilen kaynak grubunda ve abonelikte yok. 404 Operationıdnotfound-kimliği olan işlem yok. 409 Operationiptal edildi-işlem Kullanıcı tarafından iptal edildi. 409 Operationkesintiye uğradı-kaynaktaki işlem, aynı kaynaktaki başka bir işlem tarafından kesintiye uğradığından tamamlanamadı. 409 UpsertLogicalServerRequestAlreadyInProgress-devam eden bir mantıksal sunucu isteği zaten devam ediyor, lütfen isteğinizi daha sonra tekrar 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 Serverquotaaşıldı-kotayı aşacağından sunucu bir aboneliğe eklenemiyor. 409 ServerAlreadyExists-yinelenen sunucu adı. 429 SubscriptionTooManyCreateUpdateRequests-kullanılabilir kaynaklar tarafından işlenebilecek en fazla isteklerin ötesinde Istekler. 429 SubscriptionTooManyRequests-kullanılabilir kaynaklar tarafından işlenebilecek en fazla isteklerin ötesinde Istek. 429 ConflictingSubscriptionOperation-abonelik için şu anda bir işlem devam ediyor. 500 OperationTimeout-iş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şlenebilecek en fazla isteklerin ötesinde Istek.

Örnekler

Create server

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-7398/providers/Microsoft.Sql/servers/sqlcrudtest-4645?api-version=2020-11-01-preview

Request Body

{
  "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
    }
  },
  "location": "Japan East"
}

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

AdministratorType	Sunucu yöneticisinin türü.
IdentityType	Kimlik türü. Kaynak için bir Azure Active Directory sorumlusu otomatik olarak oluşturmak ve atamak için bunu ' SystemAssigned ' olarak ayarlayın.
PrincipalType	Sunucu yöneticisinin asıl türü.
PrivateEndpointConnectionProperties	Özel bir 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.
ResourceIdentityWithUserAssignedIdentities	Bir kaynak için Azure Active Directory kimlik yapılandırması.
Server	Azure SQL veritabanı sunucusu.
ServerExternalAdministrator	Bir Active Directory yöneticisinin özellikleri.
ServerPrivateEndpointConnection	Sunucu altında özel bir uç nokta bağlantısı
ServerPublicNetworkAccess	Bu sunucu için genel uç nokta erişimine izin verilip verilmeyeceğini belirtir. Değer isteğe bağlıdır, ancak geçirilmezse ' Enabled ' veya ' Disabled ' olmalıdır
ServerWorkspaceFeature	Var olan sunucuda oluşturulmuş bir çalışma alanı olup olmadığı ve çalışma alanından bağlantıya izin veriyorsa
UserIdentity	Bir kaynak için Azure Active Directory kimlik yapılandırması.

AdministratorType

Sunucu yöneticisinin türü.

Name	Type	Description
ActiveDirectory	string

IdentityType

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

Name	Type	Description
None	string
SystemAssigned	string
UserAssigned	string

PrincipalType

Sunucu yöneticisinin asıl türü.

Name	Type	Description
Application	string
Group	string
User	string

PrivateEndpointConnectionProperties

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

Name	Type	Description
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	Type	Description
id	string	Özel uç noktanın kaynak kimliği.

PrivateEndpointProvisioningState

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

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

PrivateLinkServiceConnectionStateActionsRequire

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

Name	Type	Description
None	string

PrivateLinkServiceConnectionStateProperty

Name	Type	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	Type	Description
Approved	string
Disconnected	string
Pending	string
Rejected	string

ResourceIdentityWithUserAssignedIdentities

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

Name	Type	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 bir Azure Active Directory sorumlusu otomatik olarak 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

Azure SQL veritabanı sunucusu.

Name	Type	Description
id	string	Kaynak KIMLIĞI.
identity	ResourceIdentityWithUserAssignedIdentities	Sunucunun Azure Active Directory kimliği.
kind	string	SQL Server türü. Bu, Azure portal deneyimi için kullanılan meta verileridir.
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şturma için gereklidir).
properties.administrators	ServerExternalAdministrator	Sunucunun Azure Active Directory 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 az 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[]	Bir sunucudaki özel uç nokta bağlantılarının listesi
properties.publicNetworkAccess	ServerPublicNetworkAccess	Bu sunucu için genel uç nokta erişimine izin verilip verilmeyeceğini belirtir. Değer isteğe bağlıdır, ancak geçirilmezse ' Enabled ' veya ' Disabled ' olmalıdır
properties.state	string	Sunucunun durumu.
properties.version	string	Sunucu sürümü.
properties.workspaceFeature	ServerWorkspaceFeature	Var olan sunucuda oluşturulmuş bir çalışma alanı olup olmadığı ve çalışma alanından bağlantıya izin veriyorsa
tags	object	Kaynak etiketleri.
type	string	Kaynak türü.

ServerExternalAdministrator

Bir Active Directory yöneticisinin özellikleri.

Name	Type	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 'SI (nesne KIMLIĞI).
tenantId	string	Yöneticinin kiracı KIMLIĞI.

ServerPrivateEndpointConnection

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

Name	Type	Description
id	string	Kaynak KIMLIĞI.
properties	PrivateEndpointConnectionProperties	Özel uç nokta bağlantısı özellikleri

ServerPublicNetworkAccess

Bu sunucu için genel uç nokta erişimine izin verilip verilmeyeceğini belirtir. Değer isteğe bağlıdır, ancak geçirilmezse ' Enabled ' veya ' Disabled ' olmalıdır

Name	Type	Description
Disabled	string
Enabled	string

ServerWorkspaceFeature

Var olan sunucuda oluşturulmuş bir çalışma alanı olup olmadığı ve çalışma alanından bağlantıya izin veriyorsa

Name	Type	Description
Connected	string
Disconnected	string

UserIdentity