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]$	ストレージコネクターの名前です。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	型	説明
properties	StorageConnectorPropertiesUpdate	ストレージコネクタの特性。
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 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 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	リソースを作成した ID の種類。
DataShareConnection	Data Shareの接続情報
DataShareSource	データ共有ソースの特性
DataShareSourceUpdate	データ共有ソースの特性
ErrorResponse	ストレージリソースプロバイダーからのエラー応答。
ErrorResponseBody	エラー応答本文コントラクト。
ManagedIdentityAuthProperties	dataShare接続のためのマネージドID認証プロパティです。
ManagedIdentityAuthPropertiesUpdate	dataShare接続のためのマネージドID認証プロパティです。
NativeDataSharingProvisioningState	操作が呼び出された時点でのリソースのプロビジョニング状態。
StorageConnectorAuthType	認証タイプはストレージコネクター内のバケット接続に対応しています。
StorageConnectorConnectionType	ストレージコネクター内のバケット接続の接続タイプ。
StorageConnectorDataSourceType	ストレージコネクタのバックアップデータソースの種類
StorageConnectorProperties	ストレージコネクタの特性
StorageConnectorPropertiesUpdate	ストレージコネクタの特性
StorageConnectorSourceType	ストレージコネクタのバックアップデータソースの種類
StorageConnectorState	州 - アクティブか非アクティブか。ストレージコネクタがアクティブとして開始すべきかどうか(デフォルト:アクティブ)(ストレージコネクタでfalseに設定されている間、このストレージコネクタを使うすべてのデータプレーンリクエストは失敗し、請求されない場合は請求されません。
systemData	リソースの作成と最後の変更に関連するメタデータ。

Connector

Object

コネクターは、ストレージアカウントのサブリソースとしてモデル化された追跡ARMリソースです。

名前	型	説明
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リソースです。

名前	型	説明
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 の種類。

値	説明
User
Application
ManagedIdentity
Key

DataShareConnection

Object

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}$	バックアップDataShareのURIです。形式は azds://<region>:<DataShareName>:<DataShareIdentifier>
type	string: DataShare	接続の種類。接続オブジェクトの種類を制御します。ストレージコネクタが作成されると、変更できません。

DataShareSource

Object

データ共有ソースの特性

名前	型	説明
authProperties	StorageConnectorAuthProperties: ManagedIdentityAuthProperties	バックアップデータストアへの認証方法の詳細。
connection	StorageConnectorConnection: DataShareConnection	バックアップデータストアへの接続方法の詳細。
type	string: DataShare	ストレージコネクタの種類。ストレージコネクターが作成されれば変更できません。」

DataShareSourceUpdate

Object

データ共有ソースの特性

名前	型	説明
authProperties	StorageConnectorAuthPropertiesUpdate: ManagedIdentityAuthPropertiesUpdate	バックアップデータストアへの認証方法の詳細。
type	string: DataShare	ストレージコネクタの種類。ストレージコネクターが作成されれば変更できません。」

ErrorResponse

Object

ストレージリソースプロバイダーからのエラー応答。

名前	型	説明
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Object

エラー応答本文コントラクト。

名前	型	説明
code	string	エラーの識別子。コードは不変であり、プログラムで使用することを目的としています。
message	string	ユーザーインターフェイスでの表示に適したエラーを説明するメッセージ。

ManagedIdentityAuthProperties

Object

dataShare接続のためのマネージドID認証プロパティです。

名前	型	説明
identityResourceId	string	バックアップデータソースへの認証に使用すべき管理IDのARM ResourceId。
type	string: ManagedIdentity	認証プロパティの種類。 authPropertiesオブジェクトのタイプを制御します

ManagedIdentityAuthPropertiesUpdate

Object

dataShare接続のためのマネージドID認証プロパティです。

名前	型	説明
identityResourceId	string	バックアップデータソースへの認証に使用すべき管理IDのARM ResourceId。
type	string: ManagedIdentity	認証プロパティの種類。 authPropertiesオブジェクトのタイプを制御します

NativeDataSharingProvisioningState

列挙

操作が呼び出された時点でのリソースのプロビジョニング状態。

値	説明
Accepted	申請は処理のために受理されました。
Creating	リソースを作成しています。
Succeeded	リソースは無事に作成されました。
Deleting	リソースが削除されています。
Canceled	要求がキャンセルされました。
Failed	リソースの作成または削除は失敗しました。

StorageConnectorAuthType

列挙

認証タイプはストレージコネクター内のバケット接続に対応しています。

値	説明
ManagedIdentity	マネージド・アイデンティティ認証タイプ

StorageConnectorConnectionType

列挙

ストレージコネクター内のバケット接続の接続タイプ。

値	説明
DataShare	DataShare接続タイプ

StorageConnectorDataSourceType

列挙

ストレージコネクタのバックアップデータソースの種類

値	説明
Azure_DataShare	Azure DataShare data source type

StorageConnectorProperties

Object

ストレージコネクタの特性

名前	型	規定値	説明
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

ストレージコネクタの特性

名前	型	規定値	説明
description	string maxLength: 250		このストレージコネクタの恣意的な説明。最大250文字。
source	StorageConnectorSourceUpdate: DataShareSourceUpdate		バックアップデータストアと通信し認証する方法に関する情報。
state	StorageConnectorState	Active	州 - アクティブか非アクティブか。ストレージコネクタがアクティブとして開始すべきかどうか(デフォルト:アクティブ)(ストレージコネクタでfalseに設定されている間、このストレージコネクタを使うすべてのデータプレーンリクエストは失敗し、請求されない場合は請求されません。
testConnection	boolean	False	ストレージコネクタを作成する前にバックアップデータソースへの接続をテストしてください。

StorageConnectorSourceType

列挙

ストレージコネクタのバックアップデータソースの種類

値	説明
DataShare	ソースタイプ - DataShare

StorageConnectorState

列挙

州 - アクティブか非アクティブか。ストレージコネクタがアクティブとして開始すべきかどうか(デフォルト:アクティブ)(ストレージコネクタでfalseに設定されている間、このストレージコネクタを使うすべてのデータプレーンリクエストは失敗し、請求されない場合は請求されません。

値	説明
Active	コネクタがアクティブかどうか
Inactive	コネクタが非アクティブかどうか

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前	型	説明
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