Aracılığıyla paylaş


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

Örnek isteği

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

Örnek yanıt

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

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.