Object Replication Policies - Create Or Update

サービス:: Storage Resource Provider

API バージョン:: 2025-08-01

ストレージアカウントのオブジェクトレプリケーションポリシーを作成または更新します。

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

URI パラメーター

名前	/	必須	型	説明
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	指定したリソースグループ内のストレージアカウントの名前。ストレージアカウント名の長さは 3 ~ 24 文字で、数字と小文字のみを使用する必要があります。
objectReplicationPolicyId	path	True	string minLength: 1	宛先アカウントには、値 'default' を指定します。最初に宛先アカウントでポリシーを設定します。ソースアカウントの場合は、デスティネーションアカウントで定義されたポリシーをダウンロードしたときに返されるポリシー ID の値を指定します。ポリシーは JSON ファイルとしてダウンロードされます。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前の大文字と小文字は区別されません。
subscriptionId	path	True	string (uuid)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	必須	型	説明
properties.destinationAccount	True	string	必須。宛先アカウント名。 allowCrossTenantReplication が false に設定されている場合は、完全なリソース ID にする必要があります。
properties.sourceAccount	True	string	必須。ソースアカウント名。 allowCrossTenantReplication が false に設定されている場合は、完全なリソース ID にする必要があります。
properties.metrics		ObjectReplicationPolicyPropertiesMetrics	このフィールドは省略可能です。オブジェクトレプリケーションポリシーメトリック機能オプション。
properties.priorityReplication		ObjectReplicationPolicyPropertiesPriorityReplication	このフィールドは省略可能です。オブジェクトレプリケーションポリシーの優先度レプリケーション機能オプション。
properties.rules		ObjectReplicationPolicyRule[]	ストレージアカウントオブジェクトのレプリケーション規則。
properties.tagsReplication		ObjectReplicationPolicyPropertiesTagsReplication	このフィールドは省略可能です。オブジェクトレプリケーションポリシーはレプリケーション機能オプションにタグ付けします。

応答

名前	型	説明
200 OK	ObjectReplicationPolicy	リソース「ObjectReplicationPolicy」更新操作が成功しました
Other Status Codes	ErrorResponse	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

StorageAccountCreateObjectReplicationPolicyOnDestination

StorageAccountCreateObjectReplicationPolicyOnSource

StorageAccountUpdateObjectReplicationPolicyOnDestination

StorageAccountUpdateObjectReplicationPolicyOnSource

StorageAccountCreateObjectReplicationPolicyOnDestination

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res7687/providers/Microsoft.Storage/storageAccounts/dst112/objectReplicationPolicies/default?api-version=2025-08-01

{
  "properties": {
    "destinationAccount": "dst112",
    "metrics": {
      "enabled": true
    },
    "priorityReplication": {
      "enabled": true
    },
    "rules": [
      {
        "destinationContainer": "dcont139",
        "filters": {
          "prefixMatch": [
            "blobA",
            "blobB"
          ]
        },
        "sourceContainer": "scont139"
      }
    ],
    "sourceAccount": "src1122",
    "tagsReplication": {
      "enabled": true
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "name": "2a20bb73-5717-4635-985a-5d4cf777438f",
  "type": "Microsoft.Storage/storageAccounts/objectReplicationPolicies",
  "id": "/subscriptions/{subscription-id}/resourceGroups/res7687/providers/Microsoft.Storage/storageAccounts/dst112/objectReplicationPolicies/2a20bb73-5717-4635-985a-5d4cf777438f",
  "properties": {
    "destinationAccount": "dst112",
    "metrics": {
      "enabled": true
    },
    "priorityReplication": {
      "enabled": true
    },
    "policyId": "2a20bb73-5717-4635-985a-5d4cf777438f",
    "rules": [
      {
        "destinationContainer": "destContainer1",
        "filters": {
          "prefixMatch": [
            "blobA",
            "blobB"
          ]
        },
        "ruleId": "d5d18a48-8801-4554-aeaa-74faf65f5ef9",
        "sourceContainer": "sourceContainer1"
      }
    ],
    "sourceAccount": "src1122",
    "tagsReplication": {
      "enabled": true
    }
  }
}

StorageAccountCreateObjectReplicationPolicyOnSource

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res7687/providers/Microsoft.Storage/storageAccounts/src1122/objectReplicationPolicies/2a20bb73-5717-4635-985a-5d4cf777438f?api-version=2025-08-01

{
  "properties": {
    "destinationAccount": "dst112",
    "metrics": {
      "enabled": true
    },
    "priorityReplication": {
      "enabled": true
    },
    "rules": [
      {
        "destinationContainer": "dcont139",
        "filters": {
          "minCreationTime": "2020-02-19T16:05:00Z",
          "prefixMatch": [
            "blobA",
            "blobB"
          ]
        },
        "ruleId": "d5d18a48-8801-4554-aeaa-74faf65f5ef9",
        "sourceContainer": "scont139"
      }
    ],
    "sourceAccount": "src1122",
    "tagsReplication": {
      "enabled": true
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "name": "2a20bb73-5717-4635-985a-5d4cf777438f",
  "type": "Microsoft.Storage/storageAccounts/objectReplicationPolicies",
  "id": "/subscriptions/{subscription-id}/resourceGroups/res7687/providers/Microsoft.Storage/storageAccounts/src1122/objectReplicationPolicies/2a20bb73-5717-4635-985a-5d4cf777438f",
  "properties": {
    "destinationAccount": "dst112",
    "enabledTime": "2019-06-08T03:01:55.7168089Z",
    "metrics": {
      "enabled": true
    },
    "priorityReplication": {
      "enabled": true
    },
    "policyId": "2a20bb73-5717-4635-985a-5d4cf777438f",
    "rules": [
      {
        "destinationContainer": "destContainer1",
        "filters": {
          "minCreationTime": "2020-02-19T16:05:00Z",
          "prefixMatch": [
            "blobA",
            "blobB"
          ]
        },
        "ruleId": "d5d18a48-8801-4554-aeaa-74faf65f5ef9",
        "sourceContainer": "sourceContainer1"
      }
    ],
    "sourceAccount": "src1122",
    "tagsReplication": {
      "enabled": true
    }
  }
}

StorageAccountUpdateObjectReplicationPolicyOnDestination

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res7687/providers/Microsoft.Storage/storageAccounts/dst112/objectReplicationPolicies/2a20bb73-5717-4635-985a-5d4cf777438f?api-version=2025-08-01

{
  "properties": {
    "destinationAccount": "dst112",
    "metrics": {
      "enabled": true
    },
    "priorityReplication": {
      "enabled": true
    },
    "rules": [
      {
        "destinationContainer": "dcont139",
        "filters": {
          "prefixMatch": [
            "blobA",
            "blobB"
          ]
        },
        "ruleId": "d5d18a48-8801-4554-aeaa-74faf65f5ef9",
        "sourceContainer": "scont139"
      },
      {
        "destinationContainer": "dcont179",
        "sourceContainer": "scont179"
      }
    ],
    "sourceAccount": "src1122",
    "tagsReplication": {
      "enabled": true
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "name": "2a20bb73-5717-4635-985a-5d4cf777438f",
  "type": "Microsoft.Storage/storageAccounts/objectReplicationPolicies",
  "id": "/subscriptions/{subscription-id}/resourceGroups/res7687/providers/Microsoft.Storage/storageAccounts/dst112/objectReplicationPolicies/2a20bb73-5717-4635-985a-5d4cf777438f",
  "properties": {
    "destinationAccount": "dst112",
    "metrics": {
      "enabled": true
    },
    "priorityReplication": {
      "enabled": true
    },
    "policyId": "2a20bb73-5717-4635-985a-5d4cf777438f",
    "rules": [
      {
        "destinationContainer": "destContainer1",
        "filters": {
          "prefixMatch": [
            "blobA",
            "blobB"
          ]
        },
        "ruleId": "d5d18a48-8801-4554-aeaa-74faf65f5ef9",
        "sourceContainer": "sourceContainer1"
      },
      {
        "destinationContainer": "dcont179",
        "ruleId": "cfbb4bc2-8b60-429f-b05a-d1e0942b33b2",
        "sourceContainer": "scont179"
      }
    ],
    "sourceAccount": "src1122",
    "tagsReplication": {
      "enabled": true
    }
  }
}

StorageAccountUpdateObjectReplicationPolicyOnSource

要求のサンプル

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res7687/providers/Microsoft.Storage/storageAccounts/src1122/objectReplicationPolicies/2a20bb73-5717-4635-985a-5d4cf777438f?api-version=2025-08-01

{
  "properties": {
    "destinationAccount": "dst112",
    "metrics": {
      "enabled": true
    },
    "priorityReplication": {
      "enabled": true
    },
    "rules": [
      {
        "destinationContainer": "dcont139",
        "filters": {
          "prefixMatch": [
            "blobA",
            "blobB"
          ]
        },
        "ruleId": "d5d18a48-8801-4554-aeaa-74faf65f5ef9",
        "sourceContainer": "scont139"
      },
      {
        "destinationContainer": "dcont179",
        "ruleId": "cfbb4bc2-8b60-429f-b05a-d1e0942b33b2",
        "sourceContainer": "scont179"
      }
    ],
    "sourceAccount": "src1122",
    "tagsReplication": {
      "enabled": true
    }
  }
}

応答のサンプル

状態コード:: 200

{
  "name": "2a20bb73-5717-4635-985a-5d4cf777438f",
  "type": "Microsoft.Storage/storageAccounts/objectReplicationPolicies",
  "id": "/subscriptions/{subscription-id}/resourceGroups/res7687/providers/Microsoft.Storage/storageAccounts/src1122/objectReplicationPolicies/2a20bb73-5717-4635-985a-5d4cf777438f",
  "properties": {
    "destinationAccount": "dst112",
    "enabledTime": "2019-06-08T03:01:55.7168089Z",
    "metrics": {
      "enabled": true
    },
    "priorityReplication": {
      "enabled": true
    },
    "policyId": "2a20bb73-5717-4635-985a-5d4cf777438f",
    "rules": [
      {
        "destinationContainer": "destContainer1",
        "filters": {
          "prefixMatch": [
            "blobA",
            "blobB"
          ]
        },
        "ruleId": "d5d18a48-8801-4554-aeaa-74faf65f5ef9",
        "sourceContainer": "sourceContainer1"
      },
      {
        "destinationContainer": "dcont179",
        "ruleId": "cfbb4bc2-8b60-429f-b05a-d1e0942b33b2",
        "sourceContainer": "scont179"
      }
    ],
    "sourceAccount": "src1122",
    "tagsReplication": {
      "enabled": true
    }
  }
}

定義

名前	説明
createdByType	リソースを作成した ID の種類。
ErrorResponse	ストレージリソースプロバイダーからのエラー応答。
ErrorResponseBody	エラー応答本文コントラクト。
ObjectReplicationPolicy	2 つのストレージアカウント間のレプリケーションポリシー。 1 つのポリシーで複数のルールを定義できます。
ObjectReplicationPolicyFilter	フィルターを使用すると、レプリケーションはストレージアカウント内の BLOB のサブセットに制限されます。論理 OR は、フィルター内の値に対して実行されます。複数のフィルターが定義されている場合、論理 AND はすべてのフィルターに対して実行されます。
ObjectReplicationPolicyPropertiesMetrics	このフィールドは省略可能です。オブジェクトレプリケーションポリシーメトリック機能オプション。
ObjectReplicationPolicyPropertiesPriorityReplication	このフィールドは省略可能です。オブジェクトレプリケーションポリシーの優先度レプリケーション機能オプション。
ObjectReplicationPolicyPropertiesTagsReplication	このフィールドは省略可能です。オブジェクトレプリケーションポリシーはレプリケーション機能オプションにタグ付けします。
ObjectReplicationPolicyRule	2 つのコンテナー間のレプリケーションポリシー規則。
systemData	リソースの作成と最後の変更に関連するメタデータ。

createdByType

列挙

リソースを作成した ID の種類。

値	説明
User
Application
ManagedIdentity
Key

ErrorResponse

Object

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

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

ErrorResponseBody

Object

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

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

ObjectReplicationPolicy

Object

2 つのストレージアカウント間のレプリケーションポリシー。 1 つのポリシーで複数のルールを定義できます。

名前	型	説明
id	string (arm-id)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	リソースの名前
properties.destinationAccount	string	必須。宛先アカウント名。 allowCrossTenantReplication が false に設定されている場合は、完全なリソース ID にする必要があります。
properties.enabledTime	string (date-time)	ソースアカウントでポリシーが有効になっているタイミングを示します。
properties.metrics	ObjectReplicationPolicyPropertiesMetrics	このフィールドは省略可能です。オブジェクトレプリケーションポリシーメトリック機能オプション。
properties.policyId	string	オブジェクトレプリケーションポリシーの一意の ID。
properties.priorityReplication	ObjectReplicationPolicyPropertiesPriorityReplication	このフィールドは省略可能です。オブジェクトレプリケーションポリシーの優先度レプリケーション機能オプション。
properties.rules	ObjectReplicationPolicyRule[]	ストレージアカウントオブジェクトのレプリケーション規則。
properties.sourceAccount	string	必須。ソースアカウント名。 allowCrossTenantReplication が false に設定されている場合は、完全なリソース ID にする必要があります。
properties.tagsReplication	ObjectReplicationPolicyPropertiesTagsReplication	このフィールドは省略可能です。オブジェクトレプリケーションポリシーはレプリケーション機能オプションにタグ付けします。
systemData	systemData	createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type	string	リソースの型。例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

ObjectReplicationPolicyFilter

Object

フィルターを使用すると、レプリケーションはストレージアカウント内の BLOB のサブセットに制限されます。論理 OR は、フィルター内の値に対して実行されます。複数のフィルターが定義されている場合、論理 AND はすべてのフィルターに対して実行されます。

名前	型	説明
minCreationTime	string	時間の経過後に作成された BLOB は、宛先にレプリケートされます。 datetime 形式の 'yyyy-MM-ddTHH:mm:ssZ' である必要があります。例: 2020-02-19T16:05:00Z
prefixMatch	string[]	このフィールドは省略可能です。指定したプレフィックスで始まる名前の BLOB のみをレプリケートするように結果をフィルター処理します。

ObjectReplicationPolicyPropertiesMetrics

Object

このフィールドは省略可能です。オブジェクトレプリケーションポリシーメトリック機能オプション。

名前	型	説明
enabled	boolean	オブジェクトレプリケーションメトリック機能がポリシーに対して有効になっているかどうかを示します。

ObjectReplicationPolicyPropertiesPriorityReplication

Object

このフィールドは省略可能です。オブジェクトレプリケーションポリシーの優先度レプリケーション機能オプション。

名前	型	説明
enabled	boolean	オブジェクトレプリケーション優先レプリケーション機能がポリシーに対して有効になっているかどうかを示します。

ObjectReplicationPolicyPropertiesTagsReplication

Object

このフィールドは省略可能です。オブジェクトレプリケーションポリシーはレプリケーション機能オプションにタグ付けします。

名前	型	説明
enabled	boolean	ポリシーでオブジェクトレプリケーションタグのレプリケーション機能が有効かどうかを示します。

ObjectReplicationPolicyRule

Object

2 つのコンテナー間のレプリケーションポリシー規則。

名前	型	説明
destinationContainer	string	必須。宛先コンテナー名。
filters	ObjectReplicationPolicyFilter	このフィールドは省略可能です。フィルターセットを定義するオブジェクト。
ruleId	string	ルール ID は、移行先アカウントの新しいルールごとに自動生成されます。ソースアカウントにポリシーを設定する場合に必要です。
sourceContainer	string	必須。ソースコンテナー名。

systemData

Object

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

名前	型	説明
createdAt	string (date-time)	リソース作成のタイムスタンプ (UTC)。
createdBy	string	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

次の方法で共有

Object Replication Policies - Create Or Update

URI パラメーター

要求本文

応答

セキュリティ

azure_auth

スコープ

例

StorageAccountCreateObjectReplicationPolicyOnDestination

要求のサンプル

応答のサンプル

StorageAccountCreateObjectReplicationPolicyOnSource

要求のサンプル

応答のサンプル

StorageAccountUpdateObjectReplicationPolicyOnDestination

要求のサンプル

応答のサンプル

StorageAccountUpdateObjectReplicationPolicyOnSource

要求のサンプル

応答のサンプル

定義

createdByType

ErrorResponse

ErrorResponseBody

ObjectReplicationPolicy

ObjectReplicationPolicyFilter

ObjectReplicationPolicyPropertiesMetrics

ObjectReplicationPolicyPropertiesPriorityReplication

ObjectReplicationPolicyPropertiesTagsReplication

ObjectReplicationPolicyRule

systemData