Connectors - Update

Service:: Storage Resource Provider

Version d'API:: 2025-08-01

Mettez à jour un connecteur de stockage.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Nom du compte de stockage dans le groupe de ressources spécifié. Les noms de compte de stockage doivent être compris entre 3 et 24 caractères et utiliser des chiffres et des lettres minuscules uniquement.
connectorName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9](?!.*--)[a-z0-9-]{1,61}[a-z0-9]$	Le nom du Connecteur de Stockage.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Type	Description
properties	StorageConnectorPropertiesUpdate	Les propriétés du connecteur de stockage.
tags	object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	Connector	Opération Azure terminée avec succès.
202 Accepted		Demande de mise à jour de ressource acceptée. En-têtes Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Nom

Type

Description

200 OK

Connector

Opération Azure terminée avec succès.

202 Accepted

Demande de mise à jour de ressource acceptée.

En-têtes

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

UpdateConnector

Exemple de requête

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

Exemple de réponse

Code d’état:: 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"
  }
}

Code d’état:: 202

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

Définitions

Nom	Description
Connector	Un connecteur est une ressource ARM suivie modélisée comme une sous-ressource d’un compte de stockage.
ConnectorUpdate	Un connecteur est une ressource ARM suivie modélisée comme une sous-ressource d’un compte de stockage.
createdByType	Type d’identité qui a créé la ressource.
DataShareConnection	Les détails de la connexion pour Data Share source
DataShareSource	Les propriétés de la source de partage de données
DataShareSourceUpdate	Les propriétés de la source de partage de données
ErrorResponse	Réponse d’erreur du fournisseur de ressources de stockage.
ErrorResponseBody	Contrat du corps de la réponse d’erreur.
ManagedIdentityAuthProperties	Les propriétés d’authentification d’identité gérée pour la connexion dataShare.
ManagedIdentityAuthPropertiesUpdate	Les propriétés d’authentification d’identité gérée pour la connexion dataShare.
NativeDataSharingProvisioningState	L’état de provisionnement de la ressource au moment où l’opération a été appelée.
StorageConnectorAuthType	Le type d’authentification est pris en charge pour la connexion à godets dans le connecteur de stockage.
StorageConnectorConnectionType	Le type de connexion pour la connexion par godet dans le connecteur de stockage.
StorageConnectorDataSourceType	Le type de source de données de support pour le connecteur de stockage
StorageConnectorProperties	Les propriétés du connecteur de stockage
StorageConnectorPropertiesUpdate	Les propriétés du connecteur de stockage
StorageConnectorSourceType	Le type de source de données de support pour le connecteur de stockage
StorageConnectorState	État - Actif ou inactif. Que le connecteur de stockage doive démarrer activement (par défaut : actif) (Lorsqu’il est réglé sur false sur le connecteur de stockage, toutes les requêtes du plan de données utilisant ce connecteur échouent, et ce connecteur n’est pas facturé si cela aurait été autrement.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

Connector

Objet

Un connecteur est une ressource ARM suivie modélisée comme une sous-ressource d’un compte de stockage.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
location	string	Emplacement géographique où réside la ressource
name	string	Nom de la ressource
properties	StorageConnectorProperties	Les propriétés du connecteur de stockage.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ConnectorUpdate

Objet

Un connecteur est une ressource ARM suivie modélisée comme une sous-ressource d’un compte de stockage.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
name	string	Nom de la ressource
properties	StorageConnectorPropertiesUpdate	Les propriétés du connecteur de stockage.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

DataShareConnection

Objet

Les détails de la connexion pour Data Share source

Nom	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}$	L’URI du DataShare de soutien. Doit être dans le format : azds://<> région :< DataShareName> :<DataShareIdentifier>
type	string: DataShare	Type de la connexion. Contrôle le type de l’objet connexion. Ce n’est pas muable une fois le connecteur de stockage créé.

DataShareSource

Objet

Les propriétés de la source de partage de données

Nom	Type	Description
authProperties	StorageConnectorAuthProperties: ManagedIdentityAuthProperties	Détails pour s’authentifier auprès de la réserve de données de soutien.
connection	StorageConnectorConnection: DataShareConnection	Détails pour se connecter au stockage de données de sauvegarde.
type	string: DataShare	Type de connecteur de stockage. Pas mutable une fois le Connecteur de Stockage créé. »

DataShareSourceUpdate

Objet

Les propriétés de la source de partage de données

Nom	Type	Description
authProperties	StorageConnectorAuthPropertiesUpdate: ManagedIdentityAuthPropertiesUpdate	Détails pour s’authentifier auprès de la réserve de données de soutien.
type	string: DataShare	Type de connecteur de stockage. Pas mutable une fois le Connecteur de Stockage créé. »

ErrorResponse

Objet

Réponse d’erreur du fournisseur de ressources de stockage.

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

ErrorResponseBody

Objet

Contrat du corps de la réponse d’erreur.

Nom	Type	Description
code	string	Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
message	string	Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.

ManagedIdentityAuthProperties

Objet

Les propriétés d’authentification d’identité gérée pour la connexion dataShare.

Nom	Type	Description
identityResourceId	string	ARM ResourceId de l’identité gérée qui doit être utilisée pour s’authentifier auprès de la source de données de soutien.
type	string: ManagedIdentity	Type des propriétés d’authentification. Contrôle le type de l’objet authProperties

ManagedIdentityAuthPropertiesUpdate

Objet

Les propriétés d’authentification d’identité gérée pour la connexion dataShare.

Nom	Type	Description
identityResourceId	string	ARM ResourceId de l’identité gérée qui doit être utilisée pour s’authentifier auprès de la source de données de soutien.
type	string: ManagedIdentity	Type des propriétés d’authentification. Contrôle le type de l’objet authProperties

NativeDataSharingProvisioningState

Énumération

L’état de provisionnement de la ressource au moment où l’opération a été appelée.

Valeur	Description
Accepted	La demande a été acceptée pour traitement.
Creating	La ressource est en cours de création.
Succeeded	La ressource a été créée avec succès.
Deleting	La ressource est en cours de suppression.
Canceled	La demande a été annulée.
Failed	La création ou la suppression des ressources a échoué.

StorageConnectorAuthType

Énumération

Le type d’authentification est pris en charge pour la connexion à godets dans le connecteur de stockage.

Valeur	Description
ManagedIdentity	Type d’authentification d’identité gérée

StorageConnectorConnectionType

Énumération

Le type de connexion pour la connexion par godet dans le connecteur de stockage.

Valeur	Description
DataShare	Type de connexion DataShare

StorageConnectorDataSourceType

Énumération

Le type de source de données de support pour le connecteur de stockage

Valeur	Description
Azure_DataShare	Type de source de données Azure DataShare.

StorageConnectorProperties

Objet

Les propriétés du connecteur de stockage

Nom	Type	Valeur par défaut	Description
creationTime	string		Temps de création généré par le système du Connecteur de stockage au format date-heure ISO 8601 (YYYY-MM-DDTHH :mm :ssZ). Ce n’est pas un paramètre d’entrée valide lors de la création.
dataSourceType	StorageConnectorDataSourceType		Le type de source de données de soutien pour ce connecteur de stockage.
description	string maxLength: 250		Description arbitraire de ce connecteur de stockage. Maximum 250 caractères.
provisioningState	NativeDataSharingProvisioningState		Représente l’état de provisionnement du connecteur de stockage.
source	StorageConnectorSource: DataShareSource		Informations sur la façon de communiquer avec et de s’authentifier auprès du magasin de données de soutien.
state	StorageConnectorState	Active	État - Actif ou inactif. Que le connecteur de stockage doive démarrer activement (par défaut : actif) (Lorsqu’il est réglé sur false sur le connecteur de stockage, toutes les requêtes du plan de données utilisant ce connecteur échouent, et ce connecteur n’est pas facturé si cela aurait été autrement.
testConnection	boolean	False	Testez la connexion à la source de données de sauvegarde avant de créer le connecteur de stockage.
uniqueId	string		Identifiant GUID généré par le système pour le connecteur de stockage. Ce n’est pas un paramètre d’entrée valide lors de la création.

StorageConnectorPropertiesUpdate

Objet

Les propriétés du connecteur de stockage

Nom	Type	Valeur par défaut	Description
description	string maxLength: 250		Description arbitraire de ce connecteur de stockage. Maximum 250 caractères.
source	StorageConnectorSourceUpdate: DataShareSourceUpdate		Informations sur la façon de communiquer avec et de s’authentifier auprès du magasin de données de soutien.
state	StorageConnectorState	Active	État - Actif ou inactif. Que le connecteur de stockage doive démarrer activement (par défaut : actif) (Lorsqu’il est réglé sur false sur le connecteur de stockage, toutes les requêtes du plan de données utilisant ce connecteur échouent, et ce connecteur n’est pas facturé si cela aurait été autrement.
testConnection	boolean	False	Testez la connexion à la source de données de sauvegarde avant de créer le connecteur de stockage.

StorageConnectorSourceType

Énumération

Le type de source de données de support pour le connecteur de stockage

Valeur	Description
DataShare	Source type - DataShare

StorageConnectorState

Énumération

État - Actif ou inactif. Que le connecteur de stockage doive démarrer activement (par défaut : actif) (Lorsqu’il est réglé sur false sur le connecteur de stockage, toutes les requêtes du plan de données utilisant ce connecteur échouent, et ce connecteur n’est pas facturé si cela aurait été autrement.

Valeur	Description
Active	Savoir si le connecteur est actif
Inactive	Savoir si le connecteur est inactif

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

Partager via

Connectors - Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

UpdateConnector

Exemple de requête

Exemple de réponse

Définitions

Connector

ConnectorUpdate

createdByType

DataShareConnection

DataShareSource

DataShareSourceUpdate

ErrorResponse

ErrorResponseBody

ManagedIdentityAuthProperties

ManagedIdentityAuthPropertiesUpdate

NativeDataSharingProvisioningState

StorageConnectorAuthType

StorageConnectorConnectionType

StorageConnectorDataSourceType

StorageConnectorProperties

StorageConnectorPropertiesUpdate

StorageConnectorSourceType

StorageConnectorState

systemData