Connectors - Update

Dienst:: Storage Resource Provider

API-Version:: 2025-08-01

Aktualisiere einen Storage Connector.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Der Name des Speicherkontos innerhalb der angegebenen Ressourcengruppe. Die Namen von Speicherkonten müssen zwischen 3 und 24 Zeichen lang sein und nur Zahlen und Kleinbuchstaben verwenden.
connectorName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9](?!.*--)[a-z0-9-]{1,61}[a-z0-9]$	Der Name des Storage Connector.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
properties	StorageConnectorPropertiesUpdate	Die Eigenschaften des Storage Connector.
tags	object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	Connector	Azure-Operation erfolgreich abgeschlossen.
202 Accepted		Ressourcenaktualisierungsanforderung akzeptiert. Header Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

200 OK

Connector

Azure-Operation erfolgreich abgeschlossen.

202 Accepted

Ressourcenaktualisierungsanforderung akzeptiert.

Header

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

UpdateConnector

Beispielanforderung

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

Beispiel für eine Antwort

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

Statuscode:: 202

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

Definitionen

Name	Beschreibung
Connector	Ein Connector ist eine verfolgte ARM-Ressource, die als Unterressource eines Speicherkontos modelliert wird.
ConnectorUpdate	Ein Connector ist eine verfolgte ARM-Ressource, die als Unterressource eines Speicherkontos modelliert wird.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DataShareConnection	Die Verbindungsdetails für die Data Share-Quelle
DataShareSource	Die Eigenschaften der Datenshare-Quelle
DataShareSourceUpdate	Die Eigenschaften der Datenshare-Quelle
ErrorResponse	Eine Fehlerantwort des Speicherressourcenanbieters.
ErrorResponseBody	Fehlerantworttext-Vertrag.
ManagedIdentityAuthProperties	Die Eigenschaften der verwalteten Identitätsauthentifizierung für die DataShare-Verbindung.
ManagedIdentityAuthPropertiesUpdate	Die Eigenschaften der verwalteten Identitätsauthentifizierung für die DataShare-Verbindung.
NativeDataSharingProvisioningState	Bereitstellungszustand der Ressource zum Zeitpunkt des Aufrufs der Operation.
StorageConnectorAuthType	Der Authentifizierungstyp wird für die Bucket-Verbindung im Storage Connector unterstützt.
StorageConnectorConnectionType	Der Verbindungstyp für den Eimeranschluss im Speicherstecker.
StorageConnectorDataSourceType	Der Typ der Backing-Datenquelle für den Speicheranschluss
StorageConnectorProperties	Eigenschaften des Speichersteckers
StorageConnectorPropertiesUpdate	Eigenschaften des Speichersteckers
StorageConnectorSourceType	Der Typ der Backing-Datenquelle für den Speicheranschluss
StorageConnectorState	Zustand – Aktiv oder inaktiv. Ob der Storage Connector als aktiv starten sollte (Standard: Aktiv) (Während auf dem Storage Connector auf false gesetzt, schlagen alle Datenplane-Anfragen mit diesem Storage Connector fehl, und dieser Storage Connector wird nicht berechnet, falls es anders wäre.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

Connector

Objekt

Ein Connector ist eine verfolgte ARM-Ressource, die als Unterressource eines Speicherkontos modelliert wird.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties	StorageConnectorProperties	Die Eigenschaften des Storage Connector.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ConnectorUpdate

Objekt

Ein Connector ist eine verfolgte ARM-Ressource, die als Unterressource eines Speicherkontos modelliert wird.

Name	Typ	Beschreibung
id	string (arm-id)	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties	StorageConnectorPropertiesUpdate	Die Eigenschaften des Storage Connector.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

DataShareConnection

Objekt

Die Verbindungsdetails für die Data Share-Quelle

Name	Typ	Beschreibung
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}$	Die URI der unterstützenden DataShare. Muss im Format sein: azds://< region>:<DataShareName>:<DataShareIdentifier>
type	string: DataShare	Typ der Verbindung. Kontrolliert den Typ des Verbindungsobjekts. Nicht mehr veränderbar, sobald der Storage Connector erstellt wurde.

DataShareSource

Objekt

Die Eigenschaften der Datenshare-Quelle

Name	Typ	Beschreibung
authProperties	StorageConnectorAuthProperties: ManagedIdentityAuthProperties	Details, wie man sich im Backup-Datenspeicher authentifiziert.
connection	StorageConnectorConnection: DataShareConnection	Details, wie man sich mit dem Backing-Datenspeicher verbindet.
type	string: DataShare	Typ des Speicheranschlusses. Nicht mehr veränderbar, sobald der Storage Connector erstellt ist."

DataShareSourceUpdate

Objekt

Die Eigenschaften der Datenshare-Quelle

Name	Typ	Beschreibung
authProperties	StorageConnectorAuthPropertiesUpdate: ManagedIdentityAuthPropertiesUpdate	Details, wie man sich im Backup-Datenspeicher authentifiziert.
type	string: DataShare	Typ des Speicheranschlusses. Nicht mehr veränderbar, sobald der Storage Connector erstellt ist."

ErrorResponse

Objekt

Eine Fehlerantwort des Speicherressourcenanbieters.

Name	Typ	Beschreibung
error	ErrorResponseBody	Azure Storage Resource Provider Error Response Body.

ErrorResponseBody

Objekt

Fehlerantworttext-Vertrag.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
message	string	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

ManagedIdentityAuthProperties

Objekt

Die Eigenschaften der verwalteten Identitätsauthentifizierung für die DataShare-Verbindung.

Name	Typ	Beschreibung
identityResourceId	string	ARM ResourceId der verwalteten Identität, die zur Authentifizierung der unterstützenden Datenquelle verwendet werden sollte.
type	string: ManagedIdentity	Typ der Authentifizierungseigenschaften. Kontrolliert den Typ des AuthProperties-Objekts

ManagedIdentityAuthPropertiesUpdate

Objekt

Die Eigenschaften der verwalteten Identitätsauthentifizierung für die DataShare-Verbindung.

Name	Typ	Beschreibung
identityResourceId	string	ARM ResourceId der verwalteten Identität, die zur Authentifizierung der unterstützenden Datenquelle verwendet werden sollte.
type	string: ManagedIdentity	Typ der Authentifizierungseigenschaften. Kontrolliert den Typ des AuthProperties-Objekts

NativeDataSharingProvisioningState

Enumeration

Bereitstellungszustand der Ressource zum Zeitpunkt des Aufrufs der Operation.

Wert	Beschreibung
Accepted	Der Antrag wurde zur Bearbeitung angenommen.
Creating	Die Ressource wird erstellt.
Succeeded	Die Ressource wurde erfolgreich erstellt.
Deleting	Die Ressource wird gelöscht.
Canceled	Die Anforderung wurde storniert.
Failed	Die Ressourcenerstellung oder -löschung ist fehlgeschlagen.

StorageConnectorAuthType

Enumeration

Der Authentifizierungstyp wird für die Bucket-Verbindung im Storage Connector unterstützt.

Wert	Beschreibung
ManagedIdentity	Typ der Managed Identity-Auth

StorageConnectorConnectionType

Enumeration

Der Verbindungstyp für den Eimeranschluss im Speicherstecker.

Wert	Beschreibung
DataShare	DataShare-Verbindungstyp

StorageConnectorDataSourceType

Enumeration

Der Typ der Backing-Datenquelle für den Speicheranschluss

Wert	Beschreibung
Azure_DataShare	Azure DataShare Data Source Type.

StorageConnectorProperties

Objekt

Eigenschaften des Speichersteckers

Name	Typ	Standardwert	Beschreibung
creationTime	string		Systemgenerierte Erstellungszeit des Storage Connector im ISO 8601 Date-Time-Format (YYYYY-MM-DDTHH:mm:ssZ). Kein gültiger Eingabeparameter beim Erstellen.
dataSourceType	StorageConnectorDataSourceType		Die Art der Backing-Datenquelle für diesen Storage Connector.
description	string maxLength: 250		Beliebige Beschreibung dieses Storage Connectors. Maximal 250 Zeichen.
provisioningState	NativeDataSharingProvisioningState		Repräsentiert den Bereitstellungszustand des Speicheranschlusses.
source	StorageConnectorSource: DataShareSource		Informationen darüber, wie man mit dem Backup-Datenspeicher kommuniziert und sich authentifiziert.
state	StorageConnectorState	Active	Zustand – Aktiv oder inaktiv. Ob der Storage Connector als aktiv starten sollte (Standard: Aktiv) (Während auf dem Storage Connector auf false gesetzt, schlagen alle Datenplane-Anfragen mit diesem Storage Connector fehl, und dieser Storage Connector wird nicht berechnet, falls es anders wäre.
testConnection	boolean	False	Teste die Verbindung zur Sicherungsdatenquelle, bevor du den Speicheranschluss erstellst.
uniqueId	string		Systemgenerierte GUID-Kennung für den Storage Connector. Kein gültiger Eingabeparameter beim Erstellen.

StorageConnectorPropertiesUpdate

Objekt

Eigenschaften des Speichersteckers

Name	Typ	Standardwert	Beschreibung
description	string maxLength: 250		Beliebige Beschreibung dieses Storage Connectors. Maximal 250 Zeichen.
source	StorageConnectorSourceUpdate: DataShareSourceUpdate		Informationen darüber, wie man mit dem Backup-Datenspeicher kommuniziert und sich authentifiziert.
state	StorageConnectorState	Active	Zustand – Aktiv oder inaktiv. Ob der Storage Connector als aktiv starten sollte (Standard: Aktiv) (Während auf dem Storage Connector auf false gesetzt, schlagen alle Datenplane-Anfragen mit diesem Storage Connector fehl, und dieser Storage Connector wird nicht berechnet, falls es anders wäre.
testConnection	boolean	False	Teste die Verbindung zur Sicherungsdatenquelle, bevor du den Speicheranschluss erstellst.

StorageConnectorSourceType

Enumeration

Der Typ der Backing-Datenquelle für den Speicheranschluss

Wert	Beschreibung
DataShare	Quelltyp – DataShare

StorageConnectorState

Enumeration

Zustand – Aktiv oder inaktiv. Ob der Storage Connector als aktiv starten sollte (Standard: Aktiv) (Während auf dem Storage Connector auf false gesetzt, schlagen alle Datenplane-Anfragen mit diesem Storage Connector fehl, und dieser Storage Connector wird nicht berechnet, falls es anders wäre.

Wert	Beschreibung
Active	Ob der Stecker aktiv ist
Inactive	Ob der Stecker inaktiv ist

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

Freigeben über

Connectors - Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

UpdateConnector

Beispielanforderung

Beispiel für eine Antwort

Definitionen

Connector

ConnectorUpdate

createdByType

DataShareConnection

DataShareSource

DataShareSourceUpdate

ErrorResponse

ErrorResponseBody

ManagedIdentityAuthProperties

ManagedIdentityAuthPropertiesUpdate

NativeDataSharingProvisioningState

StorageConnectorAuthType

StorageConnectorConnectionType

StorageConnectorDataSourceType

StorageConnectorProperties

StorageConnectorPropertiesUpdate

StorageConnectorSourceType

StorageConnectorState

systemData