Connectors - Update

Servicio:: Storage Resource Provider

Versión de la API:: 2025-08-01

Actualizar un conector de almacenamiento.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuenta de almacenamiento deben tener entre 3 y 24 caracteres de longitud y usar solo números y letras minúsculas.
connectorName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9](?!.*--)[a-z0-9-]{1,61}[a-z0-9]$	El nombre del Conector de Almacenamiento.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
properties	StorageConnectorPropertiesUpdate	Las propiedades del Conector de Almacenamiento.
tags	object	Etiquetas de recursos.

Respuestas

Nombre	Tipo	Description
200 OK	Connector	Operación de Azure completada con éxito.
202 Accepted		Solicitud de actualización de recursos aceptada. Encabezados Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Nombre

Tipo

Description

200 OK

Connector

Operación de Azure completada con éxito.

202 Accepted

Solicitud de actualización de recursos aceptada.

Encabezados

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

UpdateConnector

Solicitud de ejemplo

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

Respuesta de muestra

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

status code:: 202

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

Definiciones

Nombre	Description
Connector	Un Conector es un recurso ARM rastreado modelado como un subrecurso de una Cuenta de Almacenamiento.
ConnectorUpdate	Un Conector es un recurso ARM rastreado modelado como un subrecurso de una Cuenta de Almacenamiento.
createdByType	Tipo de identidad que creó el recurso.
DataShareConnection	Los detalles de la conexión para Data Share Source
DataShareSource	Las propiedades de la fuente de datos compartidos
DataShareSourceUpdate	Las propiedades de la fuente de datos compartidos
ErrorResponse	Respuesta de error del proveedor de recursos de almacenamiento.
ErrorResponseBody	Contrato del cuerpo de respuesta de error.
ManagedIdentityAuthProperties	Las propiedades de autenticación de identidad gestionada para la conexión dataShare.
ManagedIdentityAuthPropertiesUpdate	Las propiedades de autenticación de identidad gestionada para la conexión dataShare.
NativeDataSharingProvisioningState	Estado de aprovisionamiento del recurso en el momento en que se llamó la operación.
StorageConnectorAuthType	El tipo de autenticación soportado para la conexión de cubo en el conector de almacenamiento.
StorageConnectorConnectionType	El tipo de conexión para la conexión de cubo en el conector de almacenamiento.
StorageConnectorDataSourceType	El tipo de fuente de datos de respaldo para el conector de almacenamiento
StorageConnectorProperties	Las propiedades del conector de almacenamiento
StorageConnectorPropertiesUpdate	Las propiedades del conector de almacenamiento
StorageConnectorSourceType	El tipo de fuente de datos de respaldo para el conector de almacenamiento
StorageConnectorState	Estado - Activo o inactivo. Si el Conector de Almacenamiento debe iniciar activo o no (por defecto: Activo) (Mientras está configurado como falso en el Conector de Almacenamiento, todas las solicitudes del plano de datos que usan este Conector fallan, y este Conector de Almacenamiento no se factura si fuera de otra manera.
systemData	Metadatos relativos a la creación y última modificación del recurso.

Connector

Objeto

Un Conector es un recurso ARM rastreado modelado como un subrecurso de una Cuenta de Almacenamiento.

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Ubicación geográfica donde reside el recurso
name	string	Nombre del recurso
properties	StorageConnectorProperties	Las propiedades del Conector de Almacenamiento.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ConnectorUpdate

Objeto

Un Conector es un recurso ARM rastreado modelado como un subrecurso de una Cuenta de Almacenamiento.

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nombre del recurso
properties	StorageConnectorPropertiesUpdate	Las propiedades del Conector de Almacenamiento.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DataShareConnection

Objeto

Los detalles de la conexión para Data Share Source

Nombre	Tipo	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}$	El URI del DataShare de respaldo. Debe estar en el formato: azds://< región>:<DataShareName>:<DataShareIdentifier>
type	string: DataShare	Tipo de la conexión. Controla el tipo del objeto de conexión. No se puede cambiar una vez creado el Conector de Almacenamiento.

DataShareSource

Objeto

Las propiedades de la fuente de datos compartidos

Nombre	Tipo	Description
authProperties	StorageConnectorAuthProperties: ManagedIdentityAuthProperties	Detalles sobre cómo autenticarse en el almacén de datos de respaldo.
connection	StorageConnectorConnection: DataShareConnection	Detalles sobre cómo conectarse al almacén de datos de respaldo.
type	string: DataShare	Tipo de conector de almacenamiento. No mutable una vez creado el Conector de Almacenamiento."

DataShareSourceUpdate

Objeto

Las propiedades de la fuente de datos compartidos

Nombre	Tipo	Description
authProperties	StorageConnectorAuthPropertiesUpdate: ManagedIdentityAuthPropertiesUpdate	Detalles sobre cómo autenticarse en el almacén de datos de respaldo.
type	string: DataShare	Tipo de conector de almacenamiento. No mutable una vez creado el Conector de Almacenamiento."

ErrorResponse

Objeto

Respuesta de error del proveedor de recursos de almacenamiento.

Nombre	Tipo	Description
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Objeto

Contrato del cuerpo de respuesta de error.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.

ManagedIdentityAuthProperties

Objeto

Las propiedades de autenticación de identidad gestionada para la conexión dataShare.

Nombre	Tipo	Description
identityResourceId	string	ARM ResourceId de la identidad gestionada que debe usarse para autenticarse a la fuente de datos de respaldo.
type	string: ManagedIdentity	Tipo de propiedades de autenticación. Controla el tipo del objeto authProperties

ManagedIdentityAuthPropertiesUpdate

Objeto

Las propiedades de autenticación de identidad gestionada para la conexión dataShare.

Nombre	Tipo	Description
identityResourceId	string	ARM ResourceId de la identidad gestionada que debe usarse para autenticarse a la fuente de datos de respaldo.
type	string: ManagedIdentity	Tipo de propiedades de autenticación. Controla el tipo del objeto authProperties

NativeDataSharingProvisioningState

Enumeración

Estado de aprovisionamiento del recurso en el momento en que se llamó la operación.

Valor	Description
Accepted	La solicitud ha sido aceptada para su procesamiento.
Creating	Se está creando el recurso.
Succeeded	El recurso ha sido creado con éxito.
Deleting	El recurso se está eliminando.
Canceled	Se ha cancelado la solicitud.
Failed	La creación o eliminación de recursos ha fallado.

StorageConnectorAuthType

Enumeración

El tipo de autenticación soportado para la conexión de cubo en el conector de almacenamiento.

Valor	Description
ManagedIdentity	Tipo de autenticación de Identidad Gestionada

StorageConnectorConnectionType

Enumeración

El tipo de conexión para la conexión de cubo en el conector de almacenamiento.

Valor	Description
DataShare	Tipo de conexión DataShare

StorageConnectorDataSourceType

Enumeración

El tipo de fuente de datos de respaldo para el conector de almacenamiento

Valor	Description
Azure_DataShare	Azure DataShare data source.

StorageConnectorProperties

Objeto

Las propiedades del conector de almacenamiento

Nombre	Tipo	Valor predeterminado	Description
creationTime	string		Tiempo de creación generado por el sistema del Conector de Almacenamiento en formato de fecha-hora ISO 8601 (AAAAAAA-MM-DDTHH:mm:ssZ). No es un parámetro de entrada válido durante la creación.
dataSourceType	StorageConnectorDataSourceType		El tipo de fuente de datos de respaldo para este Conector de Almacenamiento.
description	string maxLength: 250		Descripción arbitraria de este Conector de Almacenamiento. Máximo 250 caracteres.
provisioningState	NativeDataSharingProvisioningState		Representa el estado de aprovisionamiento del conector de almacenamiento.
source	StorageConnectorSource: DataShareSource		Información sobre cómo comunicarse y autenticarse con el almacén de datos que respalda.
state	StorageConnectorState	Active	Estado - Activo o inactivo. Si el Conector de Almacenamiento debe iniciar activo o no (por defecto: Activo) (Mientras está configurado como falso en el Conector de Almacenamiento, todas las solicitudes del plano de datos que usan este Conector fallan, y este Conector de Almacenamiento no se factura si fuera de otra manera.
testConnection	boolean	False	Prueba la conexión a la fuente de datos de respaldo antes de crear el conector de almacenamiento.
uniqueId	string		Identificador GUID generado por el sistema para el Conector de Almacenamiento. No es un parámetro de entrada válido al crear.

StorageConnectorPropertiesUpdate

Objeto

Las propiedades del conector de almacenamiento

Nombre	Tipo	Valor predeterminado	Description
description	string maxLength: 250		Descripción arbitraria de este Conector de Almacenamiento. Máximo 250 caracteres.
source	StorageConnectorSourceUpdate: DataShareSourceUpdate		Información sobre cómo comunicarse y autenticarse con el almacén de datos que respalda.
state	StorageConnectorState	Active	Estado - Activo o inactivo. Si el Conector de Almacenamiento debe iniciar activo o no (por defecto: Activo) (Mientras está configurado como falso en el Conector de Almacenamiento, todas las solicitudes del plano de datos que usan este Conector fallan, y este Conector de Almacenamiento no se factura si fuera de otra manera.
testConnection	boolean	False	Prueba la conexión a la fuente de datos de respaldo antes de crear el conector de almacenamiento.

StorageConnectorSourceType

Enumeración

El tipo de fuente de datos de respaldo para el conector de almacenamiento

Valor	Description
DataShare	Tipo de fuente - DataShare

StorageConnectorState

Enumeración

Estado - Activo o inactivo. Si el Conector de Almacenamiento debe iniciar activo o no (por defecto: Activo) (Mientras está configurado como falso en el Conector de Almacenamiento, todas las solicitudes del plano de datos que usan este Conector fallan, y este Conector de Almacenamiento no se factura si fuera de otra manera.

Valor	Description
Active	Si el conector está activo
Inactive	Si el conector está inactivo

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	La marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Compartir a través de

Connectors - Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

UpdateConnector

Solicitud de ejemplo

Respuesta de muestra

Definiciones

Connector

ConnectorUpdate

createdByType

DataShareConnection

DataShareSource

DataShareSourceUpdate

ErrorResponse

ErrorResponseBody

ManagedIdentityAuthProperties

ManagedIdentityAuthPropertiesUpdate

NativeDataSharingProvisioningState

StorageConnectorAuthType

StorageConnectorConnectionType

StorageConnectorDataSourceType

StorageConnectorProperties

StorageConnectorPropertiesUpdate

StorageConnectorSourceType

StorageConnectorState

systemData