Connectors - Update

Служба:: Storage Resource Provider

Версия API:: 2025-08-01

Обновите разъём хранилища.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Имя учетной записи хранения в указанной группе ресурсов. Имена учетных записей хранения должны быть от 3 до 24 символов длиной и использовать только цифры и строчные буквы.
connectorName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9](?!.*--)[a-z0-9-]{1,61}[a-z0-9]$	Название Storage Connector.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Текст запроса

Имя	Тип	Описание
properties	StorageConnectorPropertiesUpdate	Свойства Storage Connector.
tags	object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	Connector	Операция Azure успешно завершена.
202 Accepted		Принятый запрос на обновление ресурсов. Заголовки Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

Connector

Операция Azure успешно завершена.

202 Accepted

Принятый запрос на обновление ресурсов.

Заголовки

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Azure Active Directory OAuth2 Flow.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	олицетворения учетной записи пользователя

Примеры

UpdateConnector

Образец запроса

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

Пример ответа

Код состояния:: 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"
  }
}

Код состояния:: 202

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

Определения

Имя	Описание
Connector	Соединитель — это отслеживаемый ресурс ARM, смоделированный как подресурс учетной записи хранения.
ConnectorUpdate	Соединитель — это отслеживаемый ресурс ARM, смоделированный как подресурс учетной записи хранения.
createdByType	Тип удостоверения, создавшего ресурс.
DataShareConnection	Детали соединения для источника Data Share
DataShareSource	Свойства источника совместного использования данных
DataShareSourceUpdate	Свойства источника совместного использования данных
ErrorResponse	Ответ на ошибку от поставщика ресурсов хранилища.
ErrorResponseBody	Контракт текста ответа на ошибку.
ManagedIdentityAuthProperties	Свойства аутентификации управляемой идентификации для соединения dataShare.
ManagedIdentityAuthPropertiesUpdate	Свойства аутентификации управляемой идентификации для соединения dataShare.
NativeDataSharingProvisioningState	Состояние снабжения ресурса на момент вызова операции.
StorageConnectorAuthType	Тип аутентификации, поддерживающий соединение с ведром в разъёме хранения.
StorageConnectorConnectionType	Тип соединения для соединения с ведром в разъёме хранения.
StorageConnectorDataSourceType	Тип источника данных поддержки для разъёма хранения
StorageConnectorProperties	Свойства разъёма хранения
StorageConnectorPropertiesUpdate	Свойства разъёма хранения
StorageConnectorSourceType	Тип источника данных поддержки для разъёма хранения
StorageConnectorState	Состояние — активное или неактивное. Должен ли Storage Connector запускаться как активный (по умолчанию: Active) (Хотя на Storage Connector установлен как false, все запросы на плоскость данных через этот Storage Connector не выполняются, и этот Storage Connector не выставляет счет, если бы было иначе.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

Connector

Объект

Соединитель — это отслеживаемый ресурс ARM, смоделированный как подресурс учетной записи хранения.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса
properties	StorageConnectorProperties	Свойства Storage Connector.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

ConnectorUpdate

Объект

Соединитель — это отслеживаемый ресурс ARM, смоделированный как подресурс учетной записи хранения.

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Имя ресурса
properties	StorageConnectorPropertiesUpdate	Свойства Storage Connector.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

DataShareConnection

Объект

Детали соединения для источника Data Share

Имя	Тип	Описание
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 поддерживающего DataShare. Должно быть в формате: azds://< region>:<DataShareName>:<DataShareIdentifier>
type	string: DataShare	Тип подключения. Управляет типом объекта соединения. Не изменяется после создания Storage Connector.

DataShareSource

Объект

Свойства источника совместного использования данных

Имя	Тип	Описание
authProperties	StorageConnectorAuthProperties: ManagedIdentityAuthProperties	Подробности о том, как аутентифицироваться в хранилище данных резерва.
connection	StorageConnectorConnection: DataShareConnection	Подробности о том, как подключиться к хранилищу данных резерва.
type	string: DataShare	Тип разъёма для хранения данных. Не изменяем, когда создан Storage Connector."

DataShareSourceUpdate

Объект

Свойства источника совместного использования данных

Имя	Тип	Описание
authProperties	StorageConnectorAuthPropertiesUpdate: ManagedIdentityAuthPropertiesUpdate	Подробности о том, как аутентифицироваться в хранилище данных резерва.
type	string: DataShare	Тип разъёма для хранения данных. Не изменяем, когда создан Storage Connector."

ErrorResponse

Объект

Ответ на ошибку от поставщика ресурсов хранилища.

Имя	Тип	Описание
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Объект

Контракт текста ответа на ошибку.

Имя	Тип	Описание
code	string	Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
message	string	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.

ManagedIdentityAuthProperties

Объект

Свойства аутентификации управляемой идентификации для соединения dataShare.

Имя	Тип	Описание
identityResourceId	string	ARM ResourceId управляемой идентичности, которая должна использоваться для аутентификации в источник поддерживающих данных.
type	string: ManagedIdentity	Тип свойств аутентификации. Управляет типом объекта authProperties

ManagedIdentityAuthPropertiesUpdate

Объект

Свойства аутентификации управляемой идентификации для соединения dataShare.

Имя	Тип	Описание
identityResourceId	string	ARM ResourceId управляемой идентичности, которая должна использоваться для аутентификации в источник поддерживающих данных.
type	string: ManagedIdentity	Тип свойств аутентификации. Управляет типом объекта authProperties

NativeDataSharingProvisioningState

Перечисление

Состояние снабжения ресурса на момент вызова операции.

Значение	Описание
Accepted	Запрос был принят к обработке.
Creating	Ресурс создается.
Succeeded	Ресурс был успешно создан.
Deleting	Ресурс удаляется.
Canceled	Запрос отменен.
Failed	Создание или удаление ресурсов не удалось.

StorageConnectorAuthType

Перечисление

Тип аутентификации, поддерживающий соединение с ведром в разъёме хранения.

Значение	Описание
ManagedIdentity	Тип аутентификации управляемой идентичности

StorageConnectorConnectionType

Перечисление

Тип соединения для соединения с ведром в разъёме хранения.

Значение	Описание
DataShare	Тип соединения DataShare

StorageConnectorDataSourceType

Перечисление

Тип источника данных поддержки для разъёма хранения

Значение	Описание
Azure_DataShare	Azure DataShare тип source данных.

StorageConnectorProperties

Объект

Свойства разъёма хранения

Имя	Тип	Default value	Описание
creationTime	string		Системно генерируемое время создания Storage Connector в формате дата-время ISO 8601 (YYYY-MM-DDTHH:mm:ssZ). Некорректный входный параметр при создании.
dataSourceType	StorageConnectorDataSourceType		Тип источника резервных данных для этого Storage Connector.
description	string maxLength: 250		Произвольное описание этого Storage Connector. Максимум 250 символов.
provisioningState	NativeDataSharingProvisioningState		Представляет состояние провизионирования разъёма хранилища.
source	StorageConnectorSource: DataShareSource		Информация о том, как взаимодействовать с хранилищем данных и аутентифицироваться в резервном хранилище.
state	StorageConnectorState	Active	Состояние — активное или неактивное. Должен ли Storage Connector запускаться как активный (по умолчанию: Active) (Хотя на Storage Connector установлен как false, все запросы на плоскость данных через этот Storage Connector не выполняются, и этот Storage Connector не выставляет счет, если бы было иначе.
testConnection	boolean	False	Тестируйте соединение с источником резервных данных перед созданием разъёма хранилища.
uniqueId	string		Системно генерируемый идентификатор GUID для Storage Connector. Недопустимый входный параметр при соображении.

StorageConnectorPropertiesUpdate

Объект

Свойства разъёма хранения

Имя	Тип	Default value	Описание
description	string maxLength: 250		Произвольное описание этого Storage Connector. Максимум 250 символов.
source	StorageConnectorSourceUpdate: DataShareSourceUpdate		Информация о том, как взаимодействовать с хранилищем данных и аутентифицироваться в резервном хранилище.
state	StorageConnectorState	Active	Состояние — активное или неактивное. Должен ли Storage Connector запускаться как активный (по умолчанию: Active) (Хотя на Storage Connector установлен как false, все запросы на плоскость данных через этот Storage Connector не выполняются, и этот Storage Connector не выставляет счет, если бы было иначе.
testConnection	boolean	False	Тестируйте соединение с источником резервных данных перед созданием разъёма хранилища.

StorageConnectorSourceType

Перечисление

Тип источника данных поддержки для разъёма хранения

Значение	Описание
DataShare	Тип исходного кода — DataShare

StorageConnectorState

Перечисление

Состояние — активное или неактивное. Должен ли Storage Connector запускаться как активный (по умолчанию: Active) (Хотя на Storage Connector установлен как false, все запросы на плоскость данных через этот Storage Connector не выполняются, и этот Storage Connector не выставляет счет, если бы было иначе.

Значение	Описание
Active	Активен ли разъём
Inactive	Неактивен ли разъём

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string (date-time)	Временная метка последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

Поделиться через

Connectors - Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

UpdateConnector

Образец запроса

Пример ответа

Определения

Connector

ConnectorUpdate

createdByType

DataShareConnection

DataShareSource

DataShareSourceUpdate

ErrorResponse

ErrorResponseBody

ManagedIdentityAuthProperties

ManagedIdentityAuthPropertiesUpdate

NativeDataSharingProvisioningState

StorageConnectorAuthType

StorageConnectorConnectionType

StorageConnectorDataSourceType

StorageConnectorProperties

StorageConnectorPropertiesUpdate

StorageConnectorSourceType

StorageConnectorState

systemData