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 매개 변수

Name	In(다음 안에)	필수	형식	Description
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]$	스토리지 커넥터의 이름입니다.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
properties	StorageConnectorPropertiesUpdate	스토리지 커넥터의 특성.
tags	object	리소스 태그.

응답

Name	형식	Description
200 OK	Connector	Azure 운영이 성공적으로 완료되었습니다.
202 Accepted		리소스 업데이트 요청이 수락되었습니다. 헤더 Location: string Retry-After: integer
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

Connector

Azure 운영이 성공적으로 완료되었습니다.

202 Accepted

리소스 업데이트 요청이 수락되었습니다.

헤더

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
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

정의

Name	Description
Connector	커넥터는 스토리지 계정의 하위 자원으로 모델링된 추적형 ARM 자원입니다.
ConnectorUpdate	커넥터는 스토리지 계정의 하위 자원으로 모델링된 추적형 ARM 자원입니다.
createdByType	리소스를 만든 ID의 형식입니다.
DataShareConnection	Data Share 소스의 연결 세부사항은
DataShareSource	데이터 공유 소스의 특성
DataShareSourceUpdate	데이터 공유 소스의 특성
ErrorResponse	스토리지 리소스 공급자의 오류 응답입니다.
ErrorResponseBody	오류 응답 본문 계약입니다.
ManagedIdentityAuthProperties	dataShare 연결을 위한 관리 신원 인증 속성입니다.
ManagedIdentityAuthPropertiesUpdate	dataShare 연결을 위한 관리 신원 인증 속성입니다.
NativeDataSharingProvisioningState	연산이 호출된 시점의 리소스 프로비저닝 상태.
StorageConnectorAuthType	스토리지 커넥터에서 버킷 연결을 지원하는 인증 유형.
StorageConnectorConnectionType	스토리지 커넥터의 버킷 연결 방식입니다.
StorageConnectorDataSourceType	스토리지 커넥터의 백업 데이터 소스 유형
StorageConnectorProperties	스토리지 커넥터의 특성
StorageConnectorPropertiesUpdate	스토리지 커넥터의 특성
StorageConnectorSourceType	스토리지 커넥터의 백업 데이터 소스 유형
StorageConnectorState	상태 - 활성 또는 비활성 상태 스토리지 커넥터가 활성화로 시작해야 하는지 여부(기본값: 액티브) (스토리지 커넥터에서 false로 설정되어 있을 때, 이 스토리지 커넥터를 사용하는 모든 데이터 평면 요청은 실패하며, 그렇지 않으면 청구되지 않습니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Connector

Object

커넥터는 스토리지 계정의 하위 자원으로 모델링된 추적형 ARM 자원입니다.

Name	형식	Description
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	리소스가 있는 지리적 위치
name	string	리소스의 이름
properties	StorageConnectorProperties	스토리지 커넥터의 특성.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object	리소스 태그.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

ConnectorUpdate

Object

커넥터는 스토리지 계정의 하위 자원으로 모델링된 추적형 ARM 자원입니다.

Name	형식	Description
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	리소스의 이름
properties	StorageConnectorPropertiesUpdate	스토리지 커넥터의 특성.
systemData	systemData	createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object	리소스 태그.
type	string	리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

DataShareConnection

Object

Data Share 소스의 연결 세부사항은

Name	형식	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}$	DataShare를 지원하는 URI. 형식은 다음과 같아야 합니다: azds://< region>:<DataShareName>:<DataShareIdentifier>
type	string: DataShare	연결 유형입니다. 연결 객체의 유형을 제어합니다. Storage Connector가 생성되면 변경 불가능합니다.

DataShareSource

Object

데이터 공유 소스의 특성

Name	형식	Description
authProperties	StorageConnectorAuthProperties: ManagedIdentityAuthProperties	백업 데이터 저장소에 인증하는 방법에 대한 자세한 내용입니다.
connection	StorageConnectorConnection: DataShareConnection	백업 데이터 저장소에 연결하는 방법에 대한 자세한 내용입니다.
type	string: DataShare	저장 커넥터의 종류. 저장 커넥터가 만들어지면 변경 불가능해."

DataShareSourceUpdate

Object

데이터 공유 소스의 특성

Name	형식	Description
authProperties	StorageConnectorAuthPropertiesUpdate: ManagedIdentityAuthPropertiesUpdate	백업 데이터 저장소에 인증하는 방법에 대한 자세한 내용입니다.
type	string: DataShare	저장 커넥터의 종류. 저장 커넥터가 만들어지면 변경 불가능해."

ErrorResponse

Object

스토리지 리소스 공급자의 오류 응답입니다.

Name	형식	Description
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Object

오류 응답 본문 계약입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
message	string	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.

ManagedIdentityAuthProperties

Object

dataShare 연결을 위한 관리 신원 인증 속성입니다.

Name	형식	Description
identityResourceId	string	백업 데이터 소스에 인증하는 데 사용해야 하는 관리 신원의 ARM ResourceId.
type	string: ManagedIdentity	인증 속성의 유형. authProperties 객체의 유형을 제어합니다

ManagedIdentityAuthPropertiesUpdate

Object

dataShare 연결을 위한 관리 신원 인증 속성입니다.

Name	형식	Description
identityResourceId	string	백업 데이터 소스에 인증하는 데 사용해야 하는 관리 신원의 ARM ResourceId.
type	string: ManagedIdentity	인증 속성의 유형. authProperties 객체의 유형을 제어합니다

NativeDataSharingProvisioningState

열거형

연산이 호출된 시점의 리소스 프로비저닝 상태.

값	Description
Accepted	처리 요청이 승인되었습니다.
Creating	리소스를 만드는 중입니다.
Succeeded	자원은 성공적으로 만들어졌습니다.
Deleting	리소스가 삭제되고 있습니다.
Canceled	요청이 취소되었습니다.
Failed	자원 생성이나 삭제가 실패했습니다.

StorageConnectorAuthType

열거형

스토리지 커넥터에서 버킷 연결을 지원하는 인증 유형.

값	Description
ManagedIdentity	관리 신원 인증 유형

StorageConnectorConnectionType

열거형

스토리지 커넥터의 버킷 연결 방식입니다.

값	Description
DataShare	DataShare 연결 유형

StorageConnectorDataSourceType

열거형

스토리지 커넥터의 백업 데이터 소스 유형

값	Description
Azure_DataShare	Azure DataShare 데이터 소스 유형.

StorageConnectorProperties

Object

스토리지 커넥터의 특성

Name	형식	Default value	Description
creationTime	string		ISO 8601 날짜-시간 형식(YYYY-MM-DDTHH:mm:ssZ)으로 생성된 스토리지 커넥터 생성 시간. 생성 중에 유효한 입력 파라미터가 아닙니다.
dataSourceType	StorageConnectorDataSourceType		이 스토리지 커넥터의 백업 데이터 소스의 유형.
description	string maxLength: 250		이 스토리지 커넥터에 대한 임의의 설명입니다. 최대 250자 이내.
provisioningState	NativeDataSharingProvisioningState		스토리지 커넥터의 프로비저닝 상태를 나타냅니다.
source	StorageConnectorSource: DataShareSource		백업 데이터 저장소와 통신하고 인증하는 방법에 관한 정보입니다.
state	StorageConnectorState	Active	상태 - 활성 또는 비활성 상태 스토리지 커넥터가 활성화로 시작해야 하는지 여부(기본값: 액티브) (스토리지 커넥터에서 false로 설정되어 있을 때, 이 스토리지 커넥터를 사용하는 모든 데이터 평면 요청은 실패하며, 그렇지 않으면 청구되지 않습니다.
testConnection	boolean	False	스토리지 커넥터를 만들기 전에 백업 데이터 소스와의 연결을 테스트하세요.
uniqueId	string		스토리지 커넥터에 대한 시스템 생성 GUID 식별자. 생성 시 유효한 입력 파라미터가 아닙니다.

StorageConnectorPropertiesUpdate

Object

스토리지 커넥터의 특성

Name	형식	Default value	Description
description	string maxLength: 250		이 스토리지 커넥터에 대한 임의의 설명입니다. 최대 250자 이내.
source	StorageConnectorSourceUpdate: DataShareSourceUpdate		백업 데이터 저장소와 통신하고 인증하는 방법에 관한 정보입니다.
state	StorageConnectorState	Active	상태 - 활성 또는 비활성 상태 스토리지 커넥터가 활성화로 시작해야 하는지 여부(기본값: 액티브) (스토리지 커넥터에서 false로 설정되어 있을 때, 이 스토리지 커넥터를 사용하는 모든 데이터 평면 요청은 실패하며, 그렇지 않으면 청구되지 않습니다.
testConnection	boolean	False	스토리지 커넥터를 만들기 전에 백업 데이터 소스와의 연결을 테스트하세요.

StorageConnectorSourceType

열거형

스토리지 커넥터의 백업 데이터 소스 유형

값	Description
DataShare	소스 유형 - DataShare

StorageConnectorState

열거형

상태 - 활성 또는 비활성 상태 스토리지 커넥터가 활성화로 시작해야 하는지 여부(기본값: 액티브) (스토리지 커넥터에서 false로 설정되어 있을 때, 이 스토리지 커넥터를 사용하는 모든 데이터 평면 요청은 실패하며, 그렇지 않으면 청구되지 않습니다.

값	Description
Active	커넥터가 활성화되어 있는지
Inactive	커넥터가 비활성화되어 있는지 여부

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

다음을 통해 공유

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