Object Replication Policies - Create Or Update

服務:: Storage Resource Provider

API 版本:: 2026-09-01

建立或更新記憶體帳戶的物件複寫策略。

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

URI 參數

名稱	位於	必要	類型	Description
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)	目標訂用帳戶的標識碼。此值必須是 UUID。
api-version	query	True	string minLength: 1	用於此作業的 API 版本。

要求本文

名稱	必要	類型	Description
properties.destinationAccount	True	string	Required. 目的地帳戶名稱。如果allowCrossTenantReplication 設定為 false，它應該是完整的資源標識符。
properties.sourceAccount	True	string	Required. 來源帳戶名稱。如果allowCrossTenantReplication 設定為 false，它應該是完整的資源標識符。
properties.metrics		ObjectReplicationPolicyPropertiesMetrics	Optional. 對象複寫策略計量功能選項。
properties.priorityReplication		ObjectReplicationPolicyPropertiesPriorityReplication	Optional. 物件複寫原則優先順序複寫功能選項。
properties.rules		ObjectReplicationPolicyRule[]	記憶體帳戶物件復寫規則。
properties.tagsReplication		ObjectReplicationPolicyPropertiesTagsReplication	Optional. 物件複製政策標籤複製功能選項。

回覆

名稱	類型	Description
200 OK	ObjectReplicationPolicy	資源「ObjectReplicationPolicy」更新操作成功
Other Status Codes	ErrorResponse	未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
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=2026-09-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=2026-09-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=2026-09-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=2026-09-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
    }
  }
}

定義

名稱	Description
createdByType	建立此資源的身分識別類型。
ErrorResponse	記憶體資源提供者的錯誤回應。
ErrorResponseBody	錯誤回應本文合約。
ObjectReplicationPolicy	兩個記憶體帳戶之間的複製策略。您可以在一個原則中定義多個規則。
ObjectReplicationPolicyFilter	篩選會將復寫限制為記憶體帳戶內的 Blob 子集。邏輯 OR 會在篩選中的值上執行。如果定義了多個篩選條件，則會在所有篩選上執行邏輯AND。
ObjectReplicationPolicyPropertiesMetrics	Optional. 對象複寫策略計量功能選項。
ObjectReplicationPolicyPropertiesPriorityReplication	Optional. 物件複寫原則優先順序複寫功能選項。
ObjectReplicationPolicyPropertiesTagsReplication	Optional. 物件複製政策標籤複製功能選項。
ObjectReplicationPolicyRule	兩個容器之間的複製策略規則。
systemData	與建立和上次修改資源相關的元數據。

createdByType

列舉型別

建立此資源的身分識別類型。

值	Description
User
Application
ManagedIdentity
Key

ErrorResponse

Object

記憶體資源提供者的錯誤回應。

名稱	類型	Description
error	ErrorResponseBody	Azure 儲存體 Resource Provider error response body.

ErrorResponseBody

Object

錯誤回應本文合約。

名稱	類型	Description
code	string	錯誤的識別碼。程序代碼是不變的，而且是要以程序設計方式取用。
message	string	描述錯誤的訊息，適用於在使用者介面中顯示。

ObjectReplicationPolicy

Object

兩個記憶體帳戶之間的複製策略。您可以在一個原則中定義多個規則。

名稱	類型	Description
id	string (arm-id)	資源的完整資源標識碼。例如，“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
name	string	資源的名稱
properties.destinationAccount	string	Required. 目的地帳戶名稱。如果allowCrossTenantReplication 設定為 false，它應該是完整的資源標識符。
properties.enabledTime	string (date-time)	指出來源帳戶上啟用原則的時機。
properties.metrics	ObjectReplicationPolicyPropertiesMetrics	Optional. 對象複寫策略計量功能選項。
properties.policyId	string	對象複寫策略的唯一標識碼。
properties.priorityReplication	ObjectReplicationPolicyPropertiesPriorityReplication	Optional. 物件複寫原則優先順序複寫功能選項。
properties.rules	ObjectReplicationPolicyRule[]	記憶體帳戶物件復寫規則。
properties.sourceAccount	string	Required. 來源帳戶名稱。如果allowCrossTenantReplication 設定為 false，它應該是完整的資源標識符。
properties.tagsReplication	ObjectReplicationPolicyPropertiesTagsReplication	Optional. 物件複製政策標籤複製功能選項。
systemData	systemData	包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。
type	string	資源的類型。例如：「Microsoft.Compute/virtualMachines」或「Microsoft.Storage/storageAccounts」

ObjectReplicationPolicyFilter

Object

篩選會將復寫限制為記憶體帳戶內的 Blob 子集。邏輯 OR 會在篩選中的值上執行。如果定義了多個篩選條件，則會在所有篩選上執行邏輯AND。

名稱	類型	Description
minCreationTime	string	在時間之後建立的 Blob 將會復寫至目的地。它必須是日期時間格式 'yyyy-MM-ddTHH：mm：ssZ'。範例：2020-02-19T16：05：00Z
prefixMatch	string[]	Optional. 篩選結果，只復寫名稱開頭為指定前置詞的 Blob。

ObjectReplicationPolicyPropertiesMetrics

Object

Optional. 對象複寫策略計量功能選項。

名稱	類型	Description
enabled	boolean	指出是否為原則啟用物件複寫計量功能。

ObjectReplicationPolicyPropertiesPriorityReplication

Object

Optional. 物件複寫原則優先順序複寫功能選項。

名稱	類型	Description
enabled	boolean	指出是否為原則啟用物件複寫優先順序複寫功能。

ObjectReplicationPolicyPropertiesTagsReplication

Object

Optional. 物件複製政策標籤複製功能選項。

名稱	類型	Description
enabled	boolean	指示該政策是否啟用物件複製標籤複製功能。

ObjectReplicationPolicyRule

Object

兩個容器之間的複製策略規則。

名稱	類型	Description
destinationContainer	string	Required. 目的地容器名稱。
filters	ObjectReplicationPolicyFilter	Optional. 定義篩選集的物件。
ruleId	string	系統會針對目的地帳戶上每個新規則自動產生規則標識碼。需要將原則放在來源帳戶上。
sourceContainer	string	Required. 來源容器名稱。

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立此資源的身分。
createdByType	createdByType	建立此資源的身分識別類型。
lastModifiedAt	string (date-time)	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。