Servers - Update

Bir sunucuyu güncelleştirir.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}?api-version=2021-08-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 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 Type Description
identity

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

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

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 Type Description
200 OK

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

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ı 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.

  • 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 isteğin ötesinde 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.

Örnekler

Update a server

Sample Request

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

{
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "placeholder",
    "publicNetworkAccess": "Disabled",
    "restrictOutboundNetworkAccess": "Enabled"
  }
}

Sample Response

{
  "tags": {
    "tagKey1": "TagValue1"
  },
  "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": "Disabled",
    "restrictOutboundNetworkAccess": "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": {
          "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 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 kaynağın kimlik yapılandırmasını Azure Active Directory.

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ı

ServerUpdate

Azure SQL Veritabanı sunucusu için güncelleştirme isteği.

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 kaynağın kimlik yapılandırmasını Azure Active Directory.

AdministratorType

Sunucu yöneticisinin türü.

Name Type 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 Type Description
None
  • string
SystemAssigned
  • string
SystemAssigned,UserAssigned
  • string
UserAssigned
  • string

PrincipalType

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

Name Type Description
Application
  • string
Group
  • string
User
  • string

PrivateEndpointConnectionProperties

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

Name Type Description
groupIds
  • string[]

Grup kimlikleri.

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

ResourceIdentity

Bir kaynağın kimlik yapılandırmasını Azure Active Directory.

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 otomatik olarak bir Azure Active Directory sorumlusu oluşturmak ve atamak için bunu 'SystemAssigned' olarak ayarlayın.

userAssignedIdentities

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

Server

bir 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 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şturma için gereklidir).

properties.administrators

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

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

properties.publicNetworkAccess

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

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

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 Type Description
administratorType

Sunucu yöneticisinin türü.

azureADOnlyAuthentication
  • boolean

Azure Active Directory yalnızca Kimlik Doğrulaması etkindir.

login
  • string

Sunucu yöneticisinin oturum açma adı.

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 Type Description
Disabled
  • string
Enabled
  • string

ServerPrivateEndpointConnection

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

Name Type Description
id
  • string

Kaynak Kimliği.

properties

Özel uç nokta bağlantı özellikleri

ServerUpdate

Azure SQL Veritabanı sunucusu için güncelleştirme isteği.

Name Type Description
identity

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

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

properties.publicNetworkAccess

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

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

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.

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 Type Description
Connected
  • string
Disconnected
  • string

UserIdentity

Bir kaynağın kimlik yapılandırmasını Azure Active Directory.

Name Type Description
clientId
  • string

Azure Active Directory istemci kimliği.

principalId
  • string

Azure Active Directory asıl kimliği.