Servers - Create Or Update

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

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

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

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

Sunucu başarıyla güncelleştirildi.

201 Created

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

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

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

Bağlantının ait olduğu özel uç nokta.

privateLinkServiceConnectionState

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

provisioningState

Ö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

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

description
  • string

Özel bağlantı hizmeti bağlantı açıklaması.

status

Ö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

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

Kullanılacak kullanıcı tarafından atanan kimliklerin kaynak kimlikleri

Server

Azure SQL veritabanı sunucusu.

Name Type Description
id
  • string

Kaynak KIMLIĞI.

identity

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

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

Bir sunucudaki özel uç nokta bağlantılarının listesi

properties.publicNetworkAccess

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

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

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

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

Ö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

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

Name Type Description
clientId
  • string

Azure Active Directory istemci kimliği.

principalId
  • string

Azure Active Directory asıl kimliği.