Connectors - Update

Tjänst:: Storage Resource Provider

API-version:: 2025-08-01

Uppdatera en Storage Connector.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Namnet på lagringskontot i den angivna resursgruppen. Lagringskontonamn måste vara mellan 3 och 24 tecken långa och endast använda siffror och gemener.
connectorName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9](?!.*--)[a-z0-9-]{1,61}[a-z0-9]$	Namnet på lagringskontakten.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
properties	StorageConnectorPropertiesUpdate	Egenskaperna hos Storage Connector.
tags	object	Resursetiketter.

Svar

Name	Typ	Description
200 OK	Connector	Azure-operationen slutfördes framgångsrikt.
202 Accepted		Begäran om resursuppdatering har godkänts. Sidhuvuden Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Name

Typ

Description

200 OK

Connector

Azure-operationen slutfördes framgångsrikt.

202 Accepted

Begäran om resursuppdatering har godkänts.

Sidhuvuden

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

UpdateConnector

Exempelbegäran

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

Exempelsvar

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

Statuskod:: 202

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

Definitioner

Name	Description
Connector	En Connector är en spårad ARM-resurs modellerad som en delresurs till ett lagringskonto.
ConnectorUpdate	En Connector är en spårad ARM-resurs modellerad som en delresurs till ett lagringskonto.
createdByType	Den typ av identitet som skapade resursen.
DataShareConnection	Anslutningsdetaljerna för Data Share-källan
DataShareSource	Egenskaperna hos datadelningskälla
DataShareSourceUpdate	Egenskaperna hos datadelningskälla
ErrorResponse	Ett felsvar från lagringsresursprovidern.
ErrorResponseBody	Brödtextkontrakt för felsvar.
ManagedIdentityAuthProperties	Egenskaperna för administrerad identitetsautentisering för dataShare-anslutningen.
ManagedIdentityAuthPropertiesUpdate	Egenskaperna för administrerad identitetsautentisering för dataShare-anslutningen.
NativeDataSharingProvisioningState	Provisioneringstillståndet för resursen vid tidpunkten då operationen anropades.
StorageConnectorAuthType	Auth-typen stöds för bucket-anslutning i lagringskontakten.
StorageConnectorConnectionType	Anslutningstypen för bucketanslutning i lagringskontakten.
StorageConnectorDataSourceType	Typen av backing-datakälla för lagringsanslutning
StorageConnectorProperties	Lagringskontaktens egenskaper
StorageConnectorPropertiesUpdate	Lagringskontaktens egenskaper
StorageConnectorSourceType	Typen av backing-datakälla för lagringsanslutning
StorageConnectorState	Tillstånd – Aktivt eller inaktivt. Om Storage Connector ska starta som aktiv (standard: Aktiv) (När den är inställd på false på Storage Connector misslyckas alla dataplansförfrågningar med denna Storage Connector, och denna Storage Connector faktureras inte om den annars skulle vara det.
systemData	Metadata som rör skapande och senaste ändring av resursen.

Connector

Objekt

En Connector är en spårad ARM-resurs modellerad som en delresurs till ett lagringskonto.

Name	Typ	Description
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties	StorageConnectorProperties	Egenskaperna hos Storage Connector.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags	object	Resursetiketter.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

ConnectorUpdate

Objekt

En Connector är en spårad ARM-resurs modellerad som en delresurs till ett lagringskonto.

Name	Typ	Description
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. T.ex. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Namnet på resursen
properties	StorageConnectorPropertiesUpdate	Egenskaperna hos Storage Connector.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags	object	Resursetiketter.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

DataShareConnection

Objekt

Anslutningsdetaljerna för Data Share-källan

Name	Typ	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}$	URI:n för stödet DataShare. Måste vara i formatet: azds://< region>:<DataShareName>:<DataShareIdentifier>
type	string: DataShare	Typ av anslutning. Styr typen av anslutningsobjektet. Inte föränderlig när lagringskontakten väl har skapats.

DataShareSource

Objekt

Egenskaperna hos datadelningskälla

Name	Typ	Description
authProperties	StorageConnectorAuthProperties: ManagedIdentityAuthProperties	Detaljer om hur man autentiserar sig till backup-datalagret.
connection	StorageConnectorConnection: DataShareConnection	Detaljer om hur man ansluter till backing-datalagret.
type	string: DataShare	Typ av lagringskontakt. Inte föränderlig när lagringskontakten väl är skapad."

DataShareSourceUpdate

Objekt

Egenskaperna hos datadelningskälla

Name	Typ	Description
authProperties	StorageConnectorAuthPropertiesUpdate: ManagedIdentityAuthPropertiesUpdate	Detaljer om hur man autentiserar sig till backup-datalagret.
type	string: DataShare	Typ av lagringskontakt. Inte föränderlig när lagringskontakten väl är skapad."

ErrorResponse

Objekt

Ett felsvar från lagringsresursprovidern.

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

ErrorResponseBody

Objekt

Brödtextkontrakt för felsvar.

Name	Typ	Description
code	string	En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt.
message	string	Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt.

ManagedIdentityAuthProperties

Objekt

Egenskaperna för administrerad identitetsautentisering för dataShare-anslutningen.

Name	Typ	Description
identityResourceId	string	ARM ResourceId för den hanterade identiteten som ska användas för att autentiseras mot den bakstående datakällan.
type	string: ManagedIdentity	Typ av autentiseringsegenskaper. Styr typen av authProperties-objektet

ManagedIdentityAuthPropertiesUpdate

Objekt

Egenskaperna för administrerad identitetsautentisering för dataShare-anslutningen.

Name	Typ	Description
identityResourceId	string	ARM ResourceId för den hanterade identiteten som ska användas för att autentiseras mot den bakstående datakällan.
type	string: ManagedIdentity	Typ av autentiseringsegenskaper. Styr typen av authProperties-objektet

NativeDataSharingProvisioningState

Uppräkning

Provisioneringstillståndet för resursen vid tidpunkten då operationen anropades.

Värde	Description
Accepted	Begäran har godkänts för behandling.
Creating	Resursen skapas.
Succeeded	Resursen har framgångsrikt skapats.
Deleting	Resursen tas bort.
Canceled	Denna begäran har annullerats.
Failed	Resursskapandet eller raderingen har misslyckats.

StorageConnectorAuthType

Uppräkning

Auth-typen stöds för bucket-anslutning i lagringskontakten.

Värde	Description
ManagedIdentity	Autentiseringstyp för hanterad identitet

StorageConnectorConnectionType

Uppräkning

Anslutningstypen för bucketanslutning i lagringskontakten.

Värde	Description
DataShare	DataShare-anslutningstyp

StorageConnectorDataSourceType

Uppräkning

Typen av backing-datakälla för lagringsanslutning

Värde	Description
Azure_DataShare	Azure DataShare datakällatyp.

StorageConnectorProperties

Objekt

Lagringskontaktens egenskaper

Name	Typ	Standardvärde	Description
creationTime	string		Systemgenererad skapandetid för Storage Connector i ISO 8601 datum-tidsformat (YYYYY-MM-DDTHH:mm:ssZ). Ingen giltig inmatningsparameter under skapandet.
dataSourceType	StorageConnectorDataSourceType		Typen av backingdatakälla för denna Storage Connector.
description	string maxLength: 250		Godtycklig beskrivning av denna lagringskoppling. Max 250 tecken.
provisioningState	NativeDataSharingProvisioningState		Representerar provisioneringstillståndet för lagringskontakten.
source	StorageConnectorSource: DataShareSource		Information om hur man kommunicerar med och autentiserar sig mot backup-datalagret.
state	StorageConnectorState	Active	Tillstånd – Aktivt eller inaktivt. Om Storage Connector ska starta som aktiv (standard: Aktiv) (När den är inställd på false på Storage Connector misslyckas alla dataplansförfrågningar med denna Storage Connector, och denna Storage Connector faktureras inte om den annars skulle vara det.
testConnection	boolean	False	Testa anslutningen till backup-datakällan innan du skapar lagringskopplingen.
uniqueId	string		Systemgenererad GUID-identifierare för Storage Connector. Ingen giltig inmatningsparameter vid skapande.

StorageConnectorPropertiesUpdate

Objekt

Lagringskontaktens egenskaper

Name	Typ	Standardvärde	Description
description	string maxLength: 250		Godtycklig beskrivning av denna lagringskoppling. Max 250 tecken.
source	StorageConnectorSourceUpdate: DataShareSourceUpdate		Information om hur man kommunicerar med och autentiserar sig mot backup-datalagret.
state	StorageConnectorState	Active	Tillstånd – Aktivt eller inaktivt. Om Storage Connector ska starta som aktiv (standard: Aktiv) (När den är inställd på false på Storage Connector misslyckas alla dataplansförfrågningar med denna Storage Connector, och denna Storage Connector faktureras inte om den annars skulle vara det.
testConnection	boolean	False	Testa anslutningen till backup-datakällan innan du skapar lagringskopplingen.

StorageConnectorSourceType

Uppräkning

Typen av backing-datakälla för lagringsanslutning

Värde	Description
DataShare	Källtyp - DataShare

StorageConnectorState

Uppräkning

Tillstånd – Aktivt eller inaktivt. Om Storage Connector ska starta som aktiv (standard: Aktiv) (När den är inställd på false på Storage Connector misslyckas alla dataplansförfrågningar med denna Storage Connector, och denna Storage Connector faktureras inte om den annars skulle vara det.

Värde	Description
Active	Om kontakten är aktiv
Inactive	Om kontakten är inaktiv

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för senaste ändring av resurs (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Dela via

Connectors - Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

UpdateConnector

Exempelbegäran

Exempelsvar

Definitioner

Connector

ConnectorUpdate

createdByType

DataShareConnection

DataShareSource

DataShareSourceUpdate

ErrorResponse

ErrorResponseBody

ManagedIdentityAuthProperties

ManagedIdentityAuthPropertiesUpdate

NativeDataSharingProvisioningState

StorageConnectorAuthType

StorageConnectorConnectionType

StorageConnectorDataSourceType

StorageConnectorProperties

StorageConnectorPropertiesUpdate

StorageConnectorSourceType

StorageConnectorState

systemData