Connectors - Update

Serviço:: Storage Resource Provider

Versão da API:: 2025-08-01

Atualize um conector de armazenamento.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres de comprimento e usar apenas números e letras minúsculas.
connectorName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9](?!.*--)[a-z0-9-]{1,61}[a-z0-9]$	O nome do Conector de Armazenamento.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
properties	StorageConnectorPropertiesUpdate	As propriedades do Conector de Armazenamento.
tags	object	Tags de recursos.

Respostas

Nome	Tipo	Description
200 OK	Connector	Operação do Azure concluída com sucesso.
202 Accepted		Solicitação de atualização de recurso aceita. Cabeçalhos Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Nome

Tipo

Description

200 OK

Connector

Operação do Azure concluída com sucesso.

202 Accepted

Solicitação de atualização de recurso aceita.

Cabeçalhos

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

UpdateConnector

Solicitação de exemplo

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

Resposta de exemplo

Código de status:: 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"
  }
}

Código de status:: 202

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

Definições

Nome	Description
Connector	Um Conector é um recurso ARM rastreado modelado como um subrecurso de uma Conta de Armazenamento.
ConnectorUpdate	Um Conector é um recurso ARM rastreado modelado como um subrecurso de uma Conta de Armazenamento.
createdByType	O tipo de identidade que criou o recurso.
DataShareConnection	Detalhes da conexão para a fonte do Data Share
DataShareSource	As propriedades da fonte de compartilhamento de dados
DataShareSourceUpdate	As propriedades da fonte de compartilhamento de dados
ErrorResponse	Uma resposta de erro do provedor de recursos de armazenamento.
ErrorResponseBody	Contrato do corpo da resposta de erro.
ManagedIdentityAuthProperties	As propriedades gerenciadas de autenticação de identidade para conexão dataShare.
ManagedIdentityAuthPropertiesUpdate	As propriedades gerenciadas de autenticação de identidade para conexão dataShare.
NativeDataSharingProvisioningState	Estado de provisionamento do recurso no momento em que a operação foi chamada.
StorageConnectorAuthType	O tipo de autenticação suportado para conexão de balde no conector de armazenamento.
StorageConnectorConnectionType	O tipo de conexão para conexão de balde no conector de armazenamento.
StorageConnectorDataSourceType	O tipo da fonte de dados de suporte para conector de armazenamento
StorageConnectorProperties	As propriedades do conector de armazenamento
StorageConnectorPropertiesUpdate	As propriedades do conector de armazenamento
StorageConnectorSourceType	O tipo da fonte de dados de suporte para conector de armazenamento
StorageConnectorState	Estado - Ativo ou Inativo. Se o Conector de Armazenamento deve iniciar como ativo (padrão: Ativo) (Enquanto está configurado como falso no Conector de Armazenamento, todas as requisições do plano de dados usando este Conector falham, e este Conector de Armazenamento não é cobrado caso contrário.
systemData	Metadados relativos à criação e última modificação do recurso.

Connector

Objeto

Um Conector é um recurso ARM rastreado modelado como um subrecurso de uma Conta de Armazenamento.

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	A localização geográfica onde o recurso reside
name	string	O nome do recurso
properties	StorageConnectorProperties	As propriedades do Conector de Armazenamento.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ConnectorUpdate

Objeto

Um Conector é um recurso ARM rastreado modelado como um subrecurso de uma Conta de Armazenamento.

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties	StorageConnectorPropertiesUpdate	As propriedades do Conector de Armazenamento.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DataShareConnection

Objeto

Detalhes da conexão para a fonte do Data Share

Nome	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}$	O URI do DataShare de apoio. Deve estar no formato: azds://< região>:<DataShareName>:<DataShareIdentifier>
type	string: DataShare	Tipo da conexão. Controla o tipo do objeto de conexão. Não é mutável uma vez que o Conector de Armazenamento for criado.

DataShareSource

Objeto

As propriedades da fonte de compartilhamento de dados

Nome	Tipo	Description
authProperties	StorageConnectorAuthProperties: ManagedIdentityAuthProperties	Detalhes de como autenticar no armazenamento de dados de backup.
connection	StorageConnectorConnection: DataShareConnection	Detalhes de como conectar ao armazenamento de dados de backup.
type	string: DataShare	Tipo de conector de armazenamento. Não é mutável uma vez que o Conector de Armazenamento for criado."

DataShareSourceUpdate

Objeto

As propriedades da fonte de compartilhamento de dados

Nome	Tipo	Description
authProperties	StorageConnectorAuthPropertiesUpdate: ManagedIdentityAuthPropertiesUpdate	Detalhes de como autenticar no armazenamento de dados de backup.
type	string: DataShare	Tipo de conector de armazenamento. Não é mutável uma vez que o Conector de Armazenamento for criado."

ErrorResponse

Objeto

Uma resposta de erro do provedor de recursos de armazenamento.

Nome	Tipo	Description
error	ErrorResponseBody	Azure Storage Resource Provider erro response body.

ErrorResponseBody

Objeto

Contrato do corpo da resposta de erro.

Nome	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.
message	string	Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.

ManagedIdentityAuthProperties

Objeto

As propriedades gerenciadas de autenticação de identidade para conexão dataShare.

Nome	Tipo	Description
identityResourceId	string	ARM ResourceId da identidade gerenciada que deve ser usada para autenticar na fonte de dados de suporte.
type	string: ManagedIdentity	Tipo de propriedades de autenticação. Controla o tipo do objeto authProperties

ManagedIdentityAuthPropertiesUpdate

Objeto

As propriedades gerenciadas de autenticação de identidade para conexão dataShare.

Nome	Tipo	Description
identityResourceId	string	ARM ResourceId da identidade gerenciada que deve ser usada para autenticar na fonte de dados de suporte.
type	string: ManagedIdentity	Tipo de propriedades de autenticação. Controla o tipo do objeto authProperties

NativeDataSharingProvisioningState

Enumeração

Estado de provisionamento do recurso no momento em que a operação foi chamada.

Valor	Description
Accepted	O pedido foi aceito para processamento.
Creating	O recurso está sendo criado.
Succeeded	O recurso foi criado com sucesso.
Deleting	O recurso está sendo excluído.
Canceled	A solicitação foi cancelada.
Failed	A criação ou exclusão de recursos falhou.

StorageConnectorAuthType

Enumeração

O tipo de autenticação suportado para conexão de balde no conector de armazenamento.

Valor	Description
ManagedIdentity	Tipo de autenticação de Identidade Gerenciada

StorageConnectorConnectionType

Enumeração

O tipo de conexão para conexão de balde no conector de armazenamento.

Valor	Description
DataShare	Tipo de conexão DataShare

StorageConnectorDataSourceType

Enumeração

O tipo da fonte de dados de suporte para conector de armazenamento

Valor	Description
Azure_DataShare	Azure DataShare data source.

StorageConnectorProperties

Objeto

As propriedades do conector de armazenamento

Nome	Tipo	Valor padrão	Description
creationTime	string		Hora de criação gerada pelo sistema do Conector de Armazenamento no formato data-hora ISO 8601 (YYYY-MM-DDTHH:mm:ssZ). Não é um parâmetro válido de entrada durante a criação.
dataSourceType	StorageConnectorDataSourceType		O tipo de fonte de dados de backup para este Conector de Armazenamento.
description	string maxLength: 250		Descrição arbitrária deste Conector de Armazenamento. No máximo 250 caracteres.
provisioningState	NativeDataSharingProvisioningState		Representa o estado de provisionamento do conector de armazenamento.
source	StorageConnectorSource: DataShareSource		Informações sobre como se comunicar e autenticar com o armazenamento de dados de apoio.
state	StorageConnectorState	Active	Estado - Ativo ou Inativo. Se o Conector de Armazenamento deve iniciar como ativo (padrão: Ativo) (Enquanto está configurado como falso no Conector de Armazenamento, todas as requisições do plano de dados usando este Conector falham, e este Conector de Armazenamento não é cobrado caso contrário.
testConnection	boolean	False	Teste a conexão com a fonte de dados de backup antes de criar o conector de armazenamento.
uniqueId	string		Identificador GUID gerado pelo sistema para o Conector de Armazenamento. Não é um parâmetro de entrada válido na hora de criar.

StorageConnectorPropertiesUpdate

Objeto

As propriedades do conector de armazenamento

Nome	Tipo	Valor padrão	Description
description	string maxLength: 250		Descrição arbitrária deste Conector de Armazenamento. No máximo 250 caracteres.
source	StorageConnectorSourceUpdate: DataShareSourceUpdate		Informações sobre como se comunicar e autenticar com o armazenamento de dados de apoio.
state	StorageConnectorState	Active	Estado - Ativo ou Inativo. Se o Conector de Armazenamento deve iniciar como ativo (padrão: Ativo) (Enquanto está configurado como falso no Conector de Armazenamento, todas as requisições do plano de dados usando este Conector falham, e este Conector de Armazenamento não é cobrado caso contrário.
testConnection	boolean	False	Teste a conexão com a fonte de dados de backup antes de criar o conector de armazenamento.

StorageConnectorSourceType

Enumeração

O tipo da fonte de dados de suporte para conector de armazenamento

Valor	Description
DataShare	Tipo de fonte - DataShare

StorageConnectorState

Enumeração

Estado - Ativo ou Inativo. Se o Conector de Armazenamento deve iniciar como ativo (padrão: Ativo) (Enquanto está configurado como falso no Conector de Armazenamento, todas as requisições do plano de dados usando este Conector falham, e este Conector de Armazenamento não é cobrado caso contrário.

Valor	Description
Active	Se o conector está ativo
Inactive	Se o conector está inativo

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Compartilhar via

Connectors - Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

UpdateConnector

Solicitação de exemplo

Resposta de exemplo

Definições

Connector

ConnectorUpdate

createdByType

DataShareConnection

DataShareSource

DataShareSourceUpdate

ErrorResponse

ErrorResponseBody

ManagedIdentityAuthProperties

ManagedIdentityAuthPropertiesUpdate

NativeDataSharingProvisioningState

StorageConnectorAuthType

StorageConnectorConnectionType

StorageConnectorDataSourceType

StorageConnectorProperties

StorageConnectorPropertiesUpdate

StorageConnectorSourceType

StorageConnectorState

systemData