Connectors - Update

Hizmet:: Storage Resource Provider

API Sürümü:: 2025-08-01

Bir depolama konnektörünü güncelleyin.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/connectors/{connectorName}?api-version=2025-08-01

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Belirtilen kaynak grubu içindeki depolama hesabının adı. Depolama hesabı adlarının uzunluğu 3 ile 24 karakter arasında olmalı ve yalnızca sayıları ve küçük harfleri kullanmalıdır.
connectorName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9](?!.*--)[a-z0-9-]{1,61}[a-z0-9]$	Depolama Bağlantısı'nın adı.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.
subscriptionId	path	True	string (uuid)	Hedef aboneliğin kimliği. Değer bir UUID olmalıdır.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

İstek Gövdesi

Name	Tür	Description
properties	StorageConnectorPropertiesUpdate	Depolama Bağlayıcısının özellikleri.
tags	object	Kaynak etiketleri.

Yanıtlar

Name	Tür	Description
200 OK	Connector	Azure işlemi başarıyla tamamlandı.
202 Accepted		Kaynak güncelleştirme isteği kabul edildi. Üst Bilgiler Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Beklenmeyen bir hata yanıtı.

Name

Tür

Description

200 OK

Connector

Azure işlemi başarıyla tamamlandı.

202 Accepted

Kaynak güncelleştirme isteği kabul edildi.

Üst Bilgiler

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

UpdateConnector

Örnek isteği

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Storage/storageAccounts/teststorageaccount/connectors/testconnector?api-version=2025-08-01

{
  "properties": {
    "source": {
      "type": "DataShare",
      "authProperties": {
        "type": "ManagedIdentity",
        "identityResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/newTestIdentity"
      }
    }
  }
}

Örnek yanıt

Durum kodu:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.Storage/storageAccounts/teststorageaccount/connectors/testconnector",
  "name": "testconnector",
  "type": "Microsoft.Storage/storageAccounts/connectors",
  "location": "eastus",
  "properties": {
    "uniqueId": "12345678-1234-1234-1234-12345678912",
    "state": "Active",
    "creationTime": "2023-04-01T00:00:00Z",
    "description": "Example connector",
    "dataSourceType": "Azure_DataShare",
    "source": {
      "type": "DataShare",
      "connection": {
        "type": "DataShare",
        "dataShareUri": "azds://eastus:datashare1:12345678-1234-1234-1234-123456789123"
      },
      "authProperties": {
        "type": "ManagedIdentity",
        "identityResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testrg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/newTestIdentity"
      }
    },
    "provisioningState": "Succeeded"
  }
}

Durum kodu:: 202

Location: https://management.azure.com/subscriptions/xxxx/resourceGroups/rg-name/providers/Microsoft.Storage/operations/operation-98765
Retry-After: 30

Tanımlar

Name	Description
Connector	Bağlayıcı, Depolama Hesabının alt kaynağı olarak modellenmiş izli bir ARM kaynağıdır.
ConnectorUpdate	Bağlayıcı, Depolama Hesabının alt kaynağı olarak modellenmiş izli bir ARM kaynağıdır.
createdByType	Kaynağı oluşturan kimliğin türü.
DataShareConnection	Data Share kaynağı için bağlantı detayları
DataShareSource	Veri paylaşımı kaynağının özellikleri
DataShareSourceUpdate	Veri paylaşımı kaynağının özellikleri
ErrorResponse	Depolama kaynağı sağlayıcısından bir hata yanıtı.
ErrorResponseBody	Hata yanıtı gövde sözleşmesi.
ManagedIdentityAuthProperties	dataShare bağlantısı için yönetilen kimlik doğrulama özellikleri.
ManagedIdentityAuthPropertiesUpdate	dataShare bağlantısı için yönetilen kimlik doğrulama özellikleri.
NativeDataSharingProvisioningState	İşlemin çağrıldığı zamanki kaynağın provisioning durumu.
StorageConnectorAuthType	Doğrulama tipi, depolama konnektöründe kova bağlantısını destekler.
StorageConnectorConnectionType	Depolama konnektöründe kova bağlantısı için bağlantı türü.
StorageConnectorDataSourceType	Depolama konnektörü için destek veri kaynağı tipi
StorageConnectorProperties	Depolama konnektörünün özellikleri
StorageConnectorPropertiesUpdate	Depolama konnektörünün özellikleri
StorageConnectorSourceType	Depolama konnektörü için destek veri kaynağı tipi
StorageConnectorState	Durum - Aktif veya Aktif değil. Depolama Bağlayıcısının aktif olarak (varsayılan: Aktif) başlayıp başlamamaması (Depolama Bağlayıcısında false olarak ayarlandığında, bu Depolama Bağlayıcısını kullanan tüm veri düzlemi talepleri başarısız olur ve aksi takdirde bu Depolama Bağlayıcısı faturalandırılmaz).
systemData	Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Connector

Nesne

Bağlayıcı, Depolama Hesabının alt kaynağı olarak modellenmiş izli bir ARM kaynağıdır.

Name	Tür	Description
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Kaynağın bulunduğu coğrafi konum
name	string	Kaynağın adı
properties	StorageConnectorProperties	Depolama Bağlayıcısının özellikleri.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags	object	Kaynak etiketleri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

ConnectorUpdate

Nesne

Bağlayıcı, Depolama Hesabının alt kaynağı olarak modellenmiş izli bir ARM kaynağıdır.

Name	Tür	Description
id	string (arm-id)	Kaynağın tam kaynak kimliği. Örneğin, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Kaynağın adı
properties	StorageConnectorPropertiesUpdate	Depolama Bağlayıcısının özellikleri.
systemData	systemData	createdBy ve modifiedBy bilgilerini içeren Azure Resource Manager meta verileri.
tags	object	Kaynak etiketleri.
type	string	Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"

createdByType

Numaralandırma

Kaynağı oluşturan kimliğin türü.

Değer	Description
User
Application
ManagedIdentity
Key

DataShareConnection

Nesne

Data Share kaynağı için bağlantı detayları

Name	Tür	Description
dataShareUri	string pattern: ^azds://[a-zA-Z0-9-]+:[a-zA-Z0-9-_]+:[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$	Destekleyici DataShare'in URI'si. Formatında olmalı: azds://< region>:<DataShareName>:<DataShareIdentifier>
type	string: DataShare	Bağlantının türü. Bağlantı nesnesinin türünü kontrol eder. Depolama Bağlantısı oluşturulduktan sonra değiştirilemez.

DataShareSource

Nesne

Veri paylaşımı kaynağının özellikleri

Name	Tür	Description
authProperties	StorageConnectorAuthProperties: ManagedIdentityAuthProperties	Yedekleme veri deposuna kimlik doğrulama yöntemleri için detaylar.
connection	StorageConnectorConnection: DataShareConnection	Yedekleme veri deposuna nasıl bağlanacağınıza dair detaylar.
type	string: DataShare	Depolama Bağlantı Tipi. Depolama Bağlantısı oluşturulduktan sonra değiştirilemez."

DataShareSourceUpdate

Nesne

Veri paylaşımı kaynağının özellikleri

Name	Tür	Description
authProperties	StorageConnectorAuthPropertiesUpdate: ManagedIdentityAuthPropertiesUpdate	Yedekleme veri deposuna kimlik doğrulama yöntemleri için detaylar.
type	string: DataShare	Depolama Bağlantı Tipi. Depolama Bağlantısı oluşturulduktan sonra değiştirilemez."

ErrorResponse

Nesne

Depolama kaynağı sağlayıcısından bir hata yanıtı.

Name	Tür	Description
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Nesne

Hata yanıtı gövde sözleşmesi.

Name	Tür	Description
code	string	Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.
message	string	Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.

ManagedIdentityAuthProperties

Nesne

dataShare bağlantısı için yönetilen kimlik doğrulama özellikleri.

Name	Tür	Description
identityResourceId	string	Yönetilen kimliğin ARM ResourceId'si, bu kimlik destek veri kaynağına kimlik doğrulama için kullanılmalıdır.
type	string: ManagedIdentity	Kimlik doğrulama özelliklerinin türü. authProperties nesnesinin türünü kontrol eder

ManagedIdentityAuthPropertiesUpdate

Nesne

dataShare bağlantısı için yönetilen kimlik doğrulama özellikleri.

Name	Tür	Description
identityResourceId	string	Yönetilen kimliğin ARM ResourceId'si, bu kimlik destek veri kaynağına kimlik doğrulama için kullanılmalıdır.
type	string: ManagedIdentity	Kimlik doğrulama özelliklerinin türü. authProperties nesnesinin türünü kontrol eder

NativeDataSharingProvisioningState

Numaralandırma

İşlemin çağrıldığı zamanki kaynağın provisioning durumu.

Değer	Description
Accepted	Talep işleme alındı.
Creating	Kaynak oluşturuluyor.
Succeeded	Kaynak başarıyla oluşturuldu.
Deleting	Kaynak siliniyor.
Canceled	İstek iptal edildi.
Failed	Kaynak oluşturma veya silme işlemi başarısız oldu.

StorageConnectorAuthType

Numaralandırma

Doğrulama tipi, depolama konnektöründe kova bağlantısını destekler.

Değer	Description
ManagedIdentity	Managed Identity auth type

StorageConnectorConnectionType

Numaralandırma

Depolama konnektöründe kova bağlantısı için bağlantı türü.

Değer	Description
DataShare	DataShare bağlantı türü

StorageConnectorDataSourceType

Numaralandırma

Depolama konnektörü için destek veri kaynağı tipi

Değer	Description
Azure_DataShare	Azure DataShare veri kaynak tipi.

StorageConnectorProperties

Nesne

Depolama konnektörünün özellikleri

Name	Tür	Default value	Description
creationTime	string		ISO 8601 tarih-saat formatında (YYYY-MM-DDTHH:mm:ssZ) Depolama Konnektörünün sistem tarafından oluşturulan üretim zamanı. Oluşturma sırasında geçerli bir giriş parametresi değil.
dataSourceType	StorageConnectorDataSourceType		Bu Depolama Bağlayıcısı için destek veri kaynağı türü.
description	string maxLength: 250		Bu Depolama Bağlayıcısının rastgele tanımı. Maksimum 250 karakter.
provisioningState	NativeDataSharingProvisioningState		Depolama konnektörünün sağlama durumunu temsil eder.
source	StorageConnectorSource: DataShareSource		Destek veri deposuyla nasıl iletişim kurulacağı ve kimlik doğrulaması hakkında bilgiler.
state	StorageConnectorState	Active	Durum - Aktif veya Aktif değil. Depolama Bağlayıcısının aktif olarak (varsayılan: Aktif) başlayıp başlamamaması (Depolama Bağlayıcısında false olarak ayarlandığında, bu Depolama Bağlayıcısını kullanan tüm veri düzlemi talepleri başarısız olur ve aksi takdirde bu Depolama Bağlayıcısı faturalandırılmaz).
testConnection	boolean	False	Depolama konnektörünü oluşturmadan önce yedekleme veri kaynağına bağlantıyı test edin.
uniqueId	string		Depolama Bağlantısı için sistem tarafından oluşturulan GUID tanımlayıcısı. Oluştururken geçerli bir giriş parametresi değil.

StorageConnectorPropertiesUpdate

Nesne

Depolama konnektörünün özellikleri

Name	Tür	Default value	Description
description	string maxLength: 250		Bu Depolama Bağlayıcısının rastgele tanımı. Maksimum 250 karakter.
source	StorageConnectorSourceUpdate: DataShareSourceUpdate		Destek veri deposuyla nasıl iletişim kurulacağı ve kimlik doğrulaması hakkında bilgiler.
state	StorageConnectorState	Active	Durum - Aktif veya Aktif değil. Depolama Bağlayıcısının aktif olarak (varsayılan: Aktif) başlayıp başlamamaması (Depolama Bağlayıcısında false olarak ayarlandığında, bu Depolama Bağlayıcısını kullanan tüm veri düzlemi talepleri başarısız olur ve aksi takdirde bu Depolama Bağlayıcısı faturalandırılmaz).
testConnection	boolean	False	Depolama konnektörünü oluşturmadan önce yedekleme veri kaynağına bağlantıyı test edin.

StorageConnectorSourceType

Numaralandırma

Depolama konnektörü için destek veri kaynağı tipi

Değer	Description
DataShare	Kaynak türü - DataShare

StorageConnectorState

Numaralandırma

Durum - Aktif veya Aktif değil. Depolama Bağlayıcısının aktif olarak (varsayılan: Aktif) başlayıp başlamamaması (Depolama Bağlayıcısında false olarak ayarlandığında, bu Depolama Bağlayıcısını kullanan tüm veri düzlemi talepleri başarısız olur ve aksi takdirde bu Depolama Bağlayıcısı faturalandırılmaz).

Değer	Description
Active	Konnektörün aktif olup olmadığı
Inactive	Konnektörün aktif olup olmadığı

systemData

Nesne

Kaynağın oluşturulması ve son değiştirilmesiyle ilgili meta veriler.

Name	Tür	Description
createdAt	string (date-time)	Kaynak oluşturma (UTC) zaman damgası.
createdBy	string	Kaynağı oluşturan kimlik.
createdByType	createdByType	Kaynağı oluşturan kimliğin türü.
lastModifiedAt	string (date-time)	Kaynağın son değişikliğinin zaman damgası (UTC)
lastModifiedBy	string	Kaynağı en son değiştiren kimlik.
lastModifiedByType	createdByType	Kaynağı en son değiştiren kimlik türü.

Aracılığıyla paylaş

Connectors - Update

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

azure_auth

Kapsamlar

Örnekler

UpdateConnector

Örnek isteği

Örnek yanıt

Tanımlar

Connector

ConnectorUpdate

createdByType

DataShareConnection

DataShareSource

DataShareSourceUpdate

ErrorResponse

ErrorResponseBody

ManagedIdentityAuthProperties

ManagedIdentityAuthPropertiesUpdate

NativeDataSharingProvisioningState

StorageConnectorAuthType

StorageConnectorConnectionType

StorageConnectorDataSourceType

StorageConnectorProperties

StorageConnectorPropertiesUpdate

StorageConnectorSourceType

StorageConnectorState

systemData