Connectors - Update

Služba:: Storage Resource Provider

Verze rozhraní API:: 2025-08-01

Aktualizujte konektor úložiště.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Název účtu úložiště v zadané skupině prostředků. Názvy účtů úložiště musí mít délku 3 až 24 znaků a musí obsahovat jenom číslice a malá písmena.
connectorName	path	True	string minLength: 3 maxLength: 63 pattern: ^[a-z0-9](?!.*--)[a-z0-9-]{1,61}[a-z0-9]$	Název Storage Connector.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Typ	Description
properties	StorageConnectorPropertiesUpdate	Vlastnosti Storage Connectoru.
tags	object	Značky prostředků

Odpovědi

Name	Typ	Description
200 OK	Connector	Operace Azure byla úspěšně dokončena.
202 Accepted		Žádost o aktualizaci prostředků byla přijata. Hlavičky Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

Connector

Operace Azure byla úspěšně dokončena.

202 Accepted

Žádost o aktualizaci prostředků byla přijata.

Hlavičky

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

UpdateConnector

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
  }
}

Stavový kód:: 202

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

Definice

Name	Description
Connector	Konektor je sledovaný ARM zdroj modelovaný jako podzdroj úložného účtu.
ConnectorUpdate	Konektor je sledovaný ARM zdroj modelovaný jako podzdroj úložného účtu.
createdByType	Typ identity, která prostředek vytvořila.
DataShareConnection	Detaily připojení ke zdroji Data Share
DataShareSource	Vlastnosti zdroje sdílení dat
DataShareSourceUpdate	Vlastnosti zdroje sdílení dat
ErrorResponse	Odpověď na chybu od poskytovatele prostředků úložiště
ErrorResponseBody	Kontrakt textu odpovědi na chybu
ManagedIdentityAuthProperties	Vlastnosti spravované identity autentizace pro dataShare připojení.
ManagedIdentityAuthPropertiesUpdate	Vlastnosti spravované identity autentizace pro dataShare připojení.
NativeDataSharingProvisioningState	Stav zajištění zdroje v době volání operace.
StorageConnectorAuthType	Typ autentizace podporován pro připojení bucket v úložném konektoru.
StorageConnectorConnectionType	Typ připojení pro bucket connection v úložném konektoru.
StorageConnectorDataSourceType	Typ zdroje podkladových dat pro úložný konektor
StorageConnectorProperties	Vlastnosti úložného konektoru
StorageConnectorPropertiesUpdate	Vlastnosti úložného konektoru
StorageConnectorSourceType	Typ zdroje podkladových dat pro úložný konektor
StorageConnectorState	Stav – Aktivní nebo neaktivní. Zda by měl Storage Connector začít jako aktivní (výchozí: Active) (Při nastavení false na Storage Connectoru všechny požadavky na datové rovině používající tento Storage Connector selžou a tento Storage Connector není fakturován, pokud by tomu jinak bylo.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

Connector

Objekt

Konektor je sledovaný ARM zdroj modelovaný jako podzdroj úložného účtu.

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties	StorageConnectorProperties	Vlastnosti Storage Connectoru.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Značky prostředků
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

ConnectorUpdate

Objekt

Konektor je sledovaný ARM zdroj modelovaný jako podzdroj úložného účtu.

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Název prostředku
properties	StorageConnectorPropertiesUpdate	Vlastnosti Storage Connectoru.
systemData	systemData	Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
tags	object	Značky prostředků
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

DataShareConnection

Objekt

Detaily připojení ke zdroji Data Share

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 podkladového DataShare. Musí být ve formátu: azds://< region>:<DataShareName>:<DataShareIdentifier>
type	string: DataShare	Typ připojení. Ovládá typ objektu spojení. Není to mutovatelné, jakmile je Storage Connector vytvořen.

DataShareSource

Objekt

Vlastnosti zdroje sdílení dat

Name	Typ	Description
authProperties	StorageConnectorAuthProperties: ManagedIdentityAuthProperties	Podrobnosti o tom, jak se autentizovat do zálohového datového úložiště.
connection	StorageConnectorConnection: DataShareConnection	Podrobnosti o tom, jak se připojit k datovému úložišti pro zálohu.
type	string: DataShare	Typ úložného konektoru. Není proměnlivý, jakmile je Storage Connector vytvořen."

DataShareSourceUpdate

Objekt

Vlastnosti zdroje sdílení dat

Name	Typ	Description
authProperties	StorageConnectorAuthPropertiesUpdate: ManagedIdentityAuthPropertiesUpdate	Podrobnosti o tom, jak se autentizovat do zálohového datového úložiště.
type	string: DataShare	Typ úložného konektoru. Není proměnlivý, jakmile je Storage Connector vytvořen."

ErrorResponse

Objekt

Odpověď na chybu od poskytovatele prostředků úložiště

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

ErrorResponseBody

Objekt

Kontrakt textu odpovědi na chybu

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
message	string	Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.

ManagedIdentityAuthProperties

Objekt

Vlastnosti spravované identity autentizace pro dataShare připojení.

Name	Typ	Description
identityResourceId	string	ARM ResourceId spravované identity, která by měla být použita k autentizaci ke zdroji podkladových dat.
type	string: ManagedIdentity	Typ autentizačních vlastností. Ovládá typ objektu authProperties

ManagedIdentityAuthPropertiesUpdate

Objekt

Vlastnosti spravované identity autentizace pro dataShare připojení.

Name	Typ	Description
identityResourceId	string	ARM ResourceId spravované identity, která by měla být použita k autentizaci ke zdroji podkladových dat.
type	string: ManagedIdentity	Typ autentizačních vlastností. Ovládá typ objektu authProperties

NativeDataSharingProvisioningState

Výčet

Stav zajištění zdroje v době volání operace.

Hodnota	Description
Accepted	Žádost byla přijata ke zpracování.
Creating	Prostředek se vytváří.
Succeeded	Zdroj byl úspěšně vytvořen.
Deleting	Prostředek se odstraňuje.
Canceled	Požadavek byl zrušen.
Failed	Vytvoření nebo smazání zdroje selhalo.

StorageConnectorAuthType

Výčet

Typ autentizace podporován pro připojení bucket v úložném konektoru.

Hodnota	Description
ManagedIdentity	Typ autentizace řízené identity

StorageConnectorConnectionType

Výčet

Typ připojení pro bucket connection v úložném konektoru.

Hodnota	Description
DataShare	Typ připojení DataShare

StorageConnectorDataSourceType

Výčet

Typ zdroje podkladových dat pro úložný konektor

Hodnota	Description
Azure_DataShare	Azure DataShare data source type.

StorageConnectorProperties

Objekt

Vlastnosti úložného konektoru

Name	Typ	Default value	Description
creationTime	string		Systém generoval čas vytvoření Storage Connectoru ve formátu ISO 8601 dat-čas (YYYY-MM-DDTHH:mm:ssZ). Není to platný vstupní parametr při tvorbě.
dataSourceType	StorageConnectorDataSourceType		Typ zdroje zálohových dat pro tento Storage Connector.
description	string maxLength: 250		Libovolný popis tohoto Storage Connectoru. Maximálně 250 znaků.
provisioningState	NativeDataSharingProvisioningState		Představuje stav provisioningu úložného konektoru.
source	StorageConnectorSource: DataShareSource		Informace o tom, jak komunikovat a autentizovat se do zálohového datového úložiště.
state	StorageConnectorState	Active	Stav – Aktivní nebo neaktivní. Zda by měl Storage Connector začít jako aktivní (výchozí: Active) (Při nastavení false na Storage Connectoru všechny požadavky na datové rovině používající tento Storage Connector selžou a tento Storage Connector není fakturován, pokud by tomu jinak bylo.
testConnection	boolean	False	Před vytvořením úložného konektoru otestujte připojení ke zdroji záloh.
uniqueId	string		Systémově generovaný identifikátor GUID pro Storage Connector. Není to platný vstupní parametr při tvorbě.

StorageConnectorPropertiesUpdate

Objekt

Vlastnosti úložného konektoru

Name	Typ	Default value	Description
description	string maxLength: 250		Libovolný popis tohoto Storage Connectoru. Maximálně 250 znaků.
source	StorageConnectorSourceUpdate: DataShareSourceUpdate		Informace o tom, jak komunikovat a autentizovat se do zálohového datového úložiště.
state	StorageConnectorState	Active	Stav – Aktivní nebo neaktivní. Zda by měl Storage Connector začít jako aktivní (výchozí: Active) (Při nastavení false na Storage Connectoru všechny požadavky na datové rovině používající tento Storage Connector selžou a tento Storage Connector není fakturován, pokud by tomu jinak bylo.
testConnection	boolean	False	Před vytvořením úložného konektoru otestujte připojení ke zdroji záloh.

StorageConnectorSourceType

Výčet

Typ zdroje podkladových dat pro úložný konektor

Hodnota	Description
DataShare	Typ zdroje - DataShare

StorageConnectorState

Výčet

Stav – Aktivní nebo neaktivní. Zda by měl Storage Connector začít jako aktivní (výchozí: Active) (Při nastavení false na Storage Connectoru všechny požadavky na datové rovině používající tento Storage Connector selžou a tento Storage Connector není fakturován, pokud by tomu jinak bylo.

Hodnota	Description
Active	Zda je konektor aktivní
Inactive	Zda je konektor neaktivní

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Sdílet prostřednictvím

Connectors - Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

UpdateConnector

Ukázkový požadavek

Ukázková odpověď

Definice

Connector

ConnectorUpdate

createdByType

DataShareConnection

DataShareSource

DataShareSourceUpdate

ErrorResponse

ErrorResponseBody

ManagedIdentityAuthProperties

ManagedIdentityAuthPropertiesUpdate

NativeDataSharingProvisioningState

StorageConnectorAuthType

StorageConnectorConnectionType

StorageConnectorDataSourceType

StorageConnectorProperties

StorageConnectorPropertiesUpdate

StorageConnectorSourceType

StorageConnectorState

systemData