Connectors - Update

Layanan:: Storage Resource Provider

Versi API:: 2026-04-01

Perbarui konektor penyimpanan.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Nama akun penyimpanan dalam grup sumber daya yang ditentukan. Panjang nama akun penyimpanan harus antara 3 dan 24 karakter dan hanya menggunakan angka dan huruf kecil.
connectorName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9](?!.*--)[a-z0-9-]{1,61}[a-z0-9]$	Nama Konektor Penyimpanan.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama	Jenis	Deskripsi
properties	StorageConnectorPropertiesUpdate	Properti Konektor Penyimpanan.
tags	object	Tag sumber daya.

Respons

Nama	Jenis	Deskripsi
200 OK	Connector	Operasi Azure berhasil diselesaikan.
202 Accepted		Permintaan pembaruan sumber daya diterima. Header Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Nama

Jenis

Deskripsi

200 OK

Connector

Operasi Azure berhasil diselesaikan.

202 Accepted

Permintaan pembaruan sumber daya diterima.

Header

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

UpdateConnector

Permintaan sampel

HTTP

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

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

Respon sampel

Kode status:: 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"
  }
}

Kode status:: 202

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

Definisi

Nama	Deskripsi
Connector	Konektor adalah sumber daya ARM yang dilacak yang dimodelkan sebagai sub-sumber daya dari Akun Penyimpanan.
ConnectorUpdate	Konektor adalah sumber daya ARM yang dilacak yang dimodelkan sebagai sub-sumber daya dari Akun Penyimpanan.
createdByType	Jenis identitas yang membuat sumber daya.
DataShareConnection	Detail koneksi untuk sumber Data Share
DataShareSource	Properti sumber berbagi data
DataShareSourceUpdate	Properti sumber berbagi data
ErrorResponse	Respons kesalahan dari penyedia sumber daya penyimpanan.
ErrorResponseBody	Kontrak isi respons kesalahan.
ManagedIdentityAuthProperties	Properti autentikasi identitas terkelola untuk koneksi dataShare.
ManagedIdentityAuthPropertiesUpdate	Properti autentikasi identitas terkelola untuk koneksi dataShare.
NativeDataSharingProvisioningState	Status provisi sumber daya pada saat operasi dipanggil.
StorageConnectorAuthType	Jenis autentikasi didukung untuk koneksi bucket di konektor penyimpanan.
StorageConnectorConnectionType	Jenis koneksi untuk koneksi bucket di konektor penyimpanan.
StorageConnectorDataSourceType	Jenis sumber data pendukung untuk konektor penyimpanan
StorageConnectorProperties	Properti konektor penyimpanan
StorageConnectorPropertiesUpdate	Properti konektor penyimpanan
StorageConnectorSourceType	Jenis sumber data pendukung untuk konektor penyimpanan
StorageConnectorState	Status - Aktif atau Tidak Aktif. Apakah Konektor Penyimpanan harus dimulai sebagai aktif atau tidak (default: Aktif) (Saat diatur ke false pada Konektor Penyimpanan, semua permintaan bidang data yang menggunakan Konektor Penyimpanan ini gagal, dan Konektor Penyimpanan ini tidak ditagih jika sebaliknya.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Connector

Objek

Konektor adalah sumber daya ARM yang dilacak yang dimodelkan sebagai sub-sumber daya dari Akun Penyimpanan.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Lokasi geografis tempat sumber daya berada
name	string	Nama sumber daya
properties	StorageConnectorProperties	Properti Konektor Penyimpanan.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya "Microsoft. Komputasi/virtualMachines" atau "Microsoft. Akun penyimpanan/penyimpanan"

ConnectorUpdate

Objek

Konektor adalah sumber daya ARM yang dilacak yang dimodelkan sebagai sub-sumber daya dari Akun Penyimpanan.

Nama	Jenis	Deskripsi
id	string (arm-id)	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nama sumber daya
properties	StorageConnectorPropertiesUpdate	Properti Konektor Penyimpanan.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
tags	object	Tag sumber daya.
type	string	Jenis sumber daya. Misalnya "Microsoft. Komputasi/virtualMachines" atau "Microsoft. Akun penyimpanan/penyimpanan"

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

DataShareConnection

Objek

Detail koneksi untuk sumber Data Share

Nama	Jenis	Deskripsi
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}$	URI dari DataShare pendukung. Harus dalam format: azds://< region>:<DataShareName>:<DataShareIdentifier>
type	string: DataShare	Jenis koneksi. Mengontrol jenis objek koneksi. Tidak dapat diubah setelah Konektor Penyimpanan dibuat.

DataShareSource

Objek

Properti sumber berbagi data

Nama	Jenis	Deskripsi
authProperties	StorageConnectorAuthProperties: ManagedIdentityAuthProperties	Detail tentang cara mengautentikasi ke penyimpanan data pendukung.
connection	StorageConnectorConnection: DataShareConnection	Detail tentang cara menyambungkan ke penyimpanan data pendukung.
type	string: DataShare	Jenis konektor penyimpanan. Tidak dapat diubah setelah Konektor Penyimpanan dibuat."

DataShareSourceUpdate

Objek

Properti sumber berbagi data

Nama	Jenis	Deskripsi
authProperties	StorageConnectorAuthPropertiesUpdate: ManagedIdentityAuthPropertiesUpdate	Detail tentang cara mengautentikasi ke penyimpanan data pendukung.
type	string: DataShare	Jenis konektor penyimpanan. Tidak dapat diubah setelah Konektor Penyimpanan dibuat."

ErrorResponse

Objek

Respons kesalahan dari penyedia sumber daya penyimpanan.

Nama	Jenis	Deskripsi
error	ErrorResponseBody	Isi respons kesalahan Penyedia Sumber Daya Azure Storage.

ErrorResponseBody

Objek

Kontrak isi respons kesalahan.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
message	string	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.

ManagedIdentityAuthProperties

Objek

Properti autentikasi identitas terkelola untuk koneksi dataShare.

Nama	Jenis	Deskripsi
identityResourceId	string	ARM ResourceId dari identitas terkelola yang harus digunakan untuk mengautentikasi ke sumber data pendukung.
type	string: ManagedIdentity	Jenis properti autentikasi. Mengontrol jenis objek authProperties

ManagedIdentityAuthPropertiesUpdate

Objek

Properti autentikasi identitas terkelola untuk koneksi dataShare.

Nama	Jenis	Deskripsi
identityResourceId	string	ARM ResourceId dari identitas terkelola yang harus digunakan untuk mengautentikasi ke sumber data pendukung.
type	string: ManagedIdentity	Jenis properti autentikasi. Mengontrol jenis objek authProperties

NativeDataSharingProvisioningState

Enumerasi

Status provisi sumber daya pada saat operasi dipanggil.

Nilai	Deskripsi
Accepted	Permintaan telah diterima untuk diproses.
Creating	Sumber daya sedang dibuat.
Succeeded	Sumber daya telah berhasil dibuat.
Deleting	Sumber daya sedang dihapus.
Canceled	Permintaan telah dibatalkan.
Failed	Pembuatan atau penghapusan sumber daya telah gagal.

StorageConnectorAuthType

Enumerasi

Jenis autentikasi didukung untuk koneksi bucket di konektor penyimpanan.

Nilai	Deskripsi
ManagedIdentity	Jenis otentikasi Identitas Terkelola

StorageConnectorConnectionType

Enumerasi

Jenis koneksi untuk koneksi bucket di konektor penyimpanan.

Nilai	Deskripsi
DataShare	Jenis koneksi DataShare

StorageConnectorDataSourceType

Enumerasi

Jenis sumber data pendukung untuk konektor penyimpanan

Nilai	Deskripsi
Azure_DataShare	Jenis sumber data Azure DataShare.

StorageConnectorProperties

Objek

Properti konektor penyimpanan

Nama	Jenis	Nilai default	Deskripsi
creationTime	string		Waktu pembuatan Konektor Penyimpanan yang dihasilkan sistem dalam format tanggal-waktu ISO 8601 (YYYY-MM-DDTHH:mm:ssZ). Bukan parameter input yang valid selama pembuatan.
dataSourceType	StorageConnectorDataSourceType		Jenis sumber data pendukung untuk Konektor Penyimpanan ini.
description	string maxLength: 250		Deskripsi arbitrer dari Konektor Penyimpanan ini. Maksimal 250 karakter.
provisioningState	NativeDataSharingProvisioningState		Mewakili status provisi konektor penyimpanan.
source	StorageConnectorSource: DataShareSource		Informasi tentang cara berkomunikasi dengan dan mengautentikasi ke penyimpanan data pendukung.
state	StorageConnectorState	Active	Status - Aktif atau Tidak Aktif. Apakah Konektor Penyimpanan harus dimulai sebagai aktif atau tidak (default: Aktif) (Saat diatur ke false pada Konektor Penyimpanan, semua permintaan bidang data yang menggunakan Konektor Penyimpanan ini gagal, dan Konektor Penyimpanan ini tidak ditagih jika sebaliknya.
testConnection	boolean	False	Uji koneksi ke sumber data pendukung sebelum membuat konektor penyimpanan.
uniqueId	string		Pengidentifikasi GUID yang dihasilkan sistem untuk Konektor Penyimpanan. Bukan parameter input yang valid saat membuat.

StorageConnectorPropertiesUpdate

Objek

Properti konektor penyimpanan

Nama	Jenis	Nilai default	Deskripsi
description	string maxLength: 250		Deskripsi arbitrer dari Konektor Penyimpanan ini. Maksimal 250 karakter.
source	StorageConnectorSourceUpdate: DataShareSourceUpdate		Informasi tentang cara berkomunikasi dengan dan mengautentikasi ke penyimpanan data pendukung.
state	StorageConnectorState	Active	Status - Aktif atau Tidak Aktif. Apakah Konektor Penyimpanan harus dimulai sebagai aktif atau tidak (default: Aktif) (Saat diatur ke false pada Konektor Penyimpanan, semua permintaan bidang data yang menggunakan Konektor Penyimpanan ini gagal, dan Konektor Penyimpanan ini tidak ditagih jika sebaliknya.
testConnection	boolean	False	Uji koneksi ke sumber data pendukung sebelum membuat konektor penyimpanan.

StorageConnectorSourceType

Enumerasi

Jenis sumber data pendukung untuk konektor penyimpanan

Nilai	Deskripsi
DataShare	Jenis sumber - DataShare

StorageConnectorState

Enumerasi

Status - Aktif atau Tidak Aktif. Apakah Konektor Penyimpanan harus dimulai sebagai aktif atau tidak (default: Aktif) (Saat diatur ke false pada Konektor Penyimpanan, semua permintaan bidang data yang menggunakan Konektor Penyimpanan ini gagal, dan Konektor Penyimpanan ini tidak ditagih jika sebaliknya.

Nilai	Deskripsi
Active	Apakah konektor aktif
Inactive	Apakah konektor tidak aktif

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.