Connectors - Update

Service:: Storage Resource Provider

API-versie:: 2025-08-01

Werk een Storage Connector bij.

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

URI-parameters

Name	In	Vereist	Type	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	De naam van het opslagaccount binnen de opgegeven resourcegroep. Namen van opslagaccounts mogen tussen de 3 en 24 tekens lang zijn en mogen alleen cijfers en kleine letters gebruiken.
connectorName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9](?!.*--)[a-z0-9-]{1,61}[a-z0-9]$	De naam van de Storage Connector.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Type	Description
properties	StorageConnectorPropertiesUpdate	De eigenschappen van de Storage Connector.
tags	object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	Connector	Azure-operatie succesvol voltooid.
202 Accepted		Aanvraag voor resource-update geaccepteerd. Kopteksten Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Name

Type

Description

200 OK

Connector

Azure-operatie succesvol voltooid.

202 Accepted

Aanvraag voor resource-update geaccepteerd.

Kopteksten

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

UpdateConnector

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name	Description
Connector	Een Connector is een gevolgde ARM-bron die is gemodelleerd als een subresource van een Storage Account.
ConnectorUpdate	Een Connector is een gevolgde ARM-bron die is gemodelleerd als een subresource van een Storage Account.
createdByType	Het type identiteit waarmee de resource is gemaakt.
DataShareConnection	De verbindingsdetails voor de bron van Data Share
DataShareSource	De eigenschappen van de bron van data share
DataShareSourceUpdate	De eigenschappen van de bron van data share
ErrorResponse	Een foutreactie van de opslagresourceprovider.
ErrorResponseBody	Contract voor antwoordtekst van fout.
ManagedIdentityAuthProperties	De beheerde identiteitsauthenticatie-eigenschappen voor dataShare-verbinding.
ManagedIdentityAuthPropertiesUpdate	De beheerde identiteitsauthenticatie-eigenschappen voor dataShare-verbinding.
NativeDataSharingProvisioningState	Provisioningstatus van de resource op het moment dat de operatie werd aangeroepen.
StorageConnectorAuthType	Het auth-type ondersteunt voor bucket-aansluiting in de opslagconnector.
StorageConnectorConnectionType	Het verbindingstype voor bucket-aansluiting in opslagconnector.
StorageConnectorDataSourceType	Het type van de backing-databron voor opslagconnector
StorageConnectorProperties	De eigenschappen van de opslagconnector
StorageConnectorPropertiesUpdate	De eigenschappen van de opslagconnector
StorageConnectorSourceType	Het type van de backing-databron voor opslagconnector
StorageConnectorState	Toestand - Actief of inactief. Of de Storage Connector als actief moet beginnen (standaard: Actief) (Terwijl deze op false staat op de Storage Connector, falen alle dataplane-verzoeken met deze Storage Connector, en deze Storage Connector wordt niet gefactureerd als dat anders zou gebeuren.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Connector

Object

Een Connector is een gevolgde ARM-bron die is gemodelleerd als een subresource van een Storage Account.

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties	StorageConnectorProperties	De eigenschappen van de Storage Connector.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ConnectorUpdate

Object

Een Connector is een gevolgde ARM-bron die is gemodelleerd als een subresource van een Storage Account.

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
name	string	De naam van de resource
properties	StorageConnectorPropertiesUpdate	De eigenschappen van de Storage Connector.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

DataShareConnection

Object

De verbindingsdetails voor de bron van Data Share

Name	Type	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}$	De URI van de backing DataShare. Moet in het formaat zijn: azds://< regio>:<DataShareName>:<DataShareIdentifier>
type	string: DataShare	Type verbinding. Regelt het type van het verbindingsobject. Niet meer veranderlijk zodra de Storage Connector is aangemaakt.

DataShareSource

Object

De eigenschappen van de bron van data share

Name	Type	Description
authProperties	StorageConnectorAuthProperties: ManagedIdentityAuthProperties	Details over hoe je authenticeert bij de backing datastore.
connection	StorageConnectorConnection: DataShareConnection	Details over hoe je verbinding maakt met de backing datastore.
type	string: DataShare	Type van de opslagconnector. Niet veranderlijk zodra de Storage Connector is gemaakt."

DataShareSourceUpdate

Object

De eigenschappen van de bron van data share

Name	Type	Description
authProperties	StorageConnectorAuthPropertiesUpdate: ManagedIdentityAuthPropertiesUpdate	Details over hoe je authenticeert bij de backing datastore.
type	string: DataShare	Type van de opslagconnector. Niet veranderlijk zodra de Storage Connector is gemaakt."

ErrorResponse

Object

Een foutreactie van de opslagresourceprovider.

Name	Type	Description
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Object

Contract voor antwoordtekst van fout.

Name	Type	Description
code	string	Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
message	string	Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

ManagedIdentityAuthProperties

Object

De beheerde identiteitsauthenticatie-eigenschappen voor dataShare-verbinding.

Name	Type	Description
identityResourceId	string	ARM ResourceId van de beheerde identiteit die gebruikt moet worden om te authenticeren met de backing-databron.
type	string: ManagedIdentity	Type van de authenticatie-eigenschappen. Regelt het type van het authProperties-object

ManagedIdentityAuthPropertiesUpdate

Object

De beheerde identiteitsauthenticatie-eigenschappen voor dataShare-verbinding.

Name	Type	Description
identityResourceId	string	ARM ResourceId van de beheerde identiteit die gebruikt moet worden om te authenticeren met de backing-databron.
type	string: ManagedIdentity	Type van de authenticatie-eigenschappen. Regelt het type van het authProperties-object

NativeDataSharingProvisioningState

Opsomming

Provisioningstatus van de resource op het moment dat de operatie werd aangeroepen.

Waarde	Description
Accepted	Het verzoek is geaccepteerd voor verwerking.
Creating	De resource wordt gemaakt.
Succeeded	De bron is met succes gecreëerd.
Deleting	De resource wordt verwijderd.
Canceled	Het verzoek is geannuleerd.
Failed	Het aanmaken of verwijderen van een bron is mislukt.

StorageConnectorAuthType

Opsomming

Het auth-type ondersteunt voor bucket-aansluiting in de opslagconnector.

Waarde	Description
ManagedIdentity	Beheerd identiteitsauthenticatietype

StorageConnectorConnectionType

Opsomming

Het verbindingstype voor bucket-aansluiting in opslagconnector.

Waarde	Description
DataShare	DataShare-verbindingstype

StorageConnectorDataSourceType

Opsomming

Het type van de backing-databron voor opslagconnector

Waarde	Description
Azure_DataShare	Azure DataShare databrontype.

StorageConnectorProperties

Object

De eigenschappen van de opslagconnector

Name	Type	Default value	Description
creationTime	string		Systeemgegenereerde aanmaaktijd van de Storage Connector in ISO 8601 datum-tijdformaat (YYYYY-MM-DDTHH:mm:ssZ). Geen geldige invoerparameter tijdens het aanmaken.
dataSourceType	StorageConnectorDataSourceType		Het type backing-databron voor deze Storage Connector.
description	string maxLength: 250		Willekeurige beschrijving van deze Storage Connector. Maximaal 250 tekens.
provisioningState	NativeDataSharingProvisioningState		Geeft de provisioning-status van de opslagconnector weer.
source	StorageConnectorSource: DataShareSource		Informatie over hoe je kunt communiceren met en authenticeren met de backing datastorage.
state	StorageConnectorState	Active	Toestand - Actief of inactief. Of de Storage Connector als actief moet beginnen (standaard: Actief) (Terwijl deze op false staat op de Storage Connector, falen alle dataplane-verzoeken met deze Storage Connector, en deze Storage Connector wordt niet gefactureerd als dat anders zou gebeuren.
testConnection	boolean	False	Test de verbinding met de backing-databron voordat je de opslagconnector maakt.
uniqueId	string		Systeemgegenereerde GUID-identificatie voor de Storage Connector. Geen geldige invoerparameter bij het aanmaken.

StorageConnectorPropertiesUpdate

Object

De eigenschappen van de opslagconnector

Name	Type	Default value	Description
description	string maxLength: 250		Willekeurige beschrijving van deze Storage Connector. Maximaal 250 tekens.
source	StorageConnectorSourceUpdate: DataShareSourceUpdate		Informatie over hoe je kunt communiceren met en authenticeren met de backing datastorage.
state	StorageConnectorState	Active	Toestand - Actief of inactief. Of de Storage Connector als actief moet beginnen (standaard: Actief) (Terwijl deze op false staat op de Storage Connector, falen alle dataplane-verzoeken met deze Storage Connector, en deze Storage Connector wordt niet gefactureerd als dat anders zou gebeuren.
testConnection	boolean	False	Test de verbinding met de backing-databron voordat je de opslagconnector maakt.

StorageConnectorSourceType

Opsomming

Het type van de backing-databron voor opslagconnector

Waarde	Description
DataShare	Brontype - DataShare

StorageConnectorState

Opsomming

Toestand - Actief of inactief. Of de Storage Connector als actief moet beginnen (standaard: Actief) (Terwijl deze op false staat op de Storage Connector, falen alle dataplane-verzoeken met deze Storage Connector, en deze Storage Connector wordt niet gefactureerd als dat anders zou gebeuren.

Waarde	Description
Active	Of de connector actief is
Inactive	Of de connector inactief is

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	Het tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

Delen via

Connectors - Update

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

UpdateConnector

Voorbeeldaanvraag

Voorbeeldrespons

Definities

Connector

ConnectorUpdate

createdByType

DataShareConnection

DataShareSource

DataShareSourceUpdate

ErrorResponse

ErrorResponseBody

ManagedIdentityAuthProperties

ManagedIdentityAuthPropertiesUpdate

NativeDataSharingProvisioningState

StorageConnectorAuthType

StorageConnectorConnectionType

StorageConnectorDataSourceType

StorageConnectorProperties

StorageConnectorPropertiesUpdate

StorageConnectorSourceType

StorageConnectorState

systemData