Object Replication Policies - Create Or Update

Usługa:: Storage Resource Provider

Wersja interfejsu API:: 2026-06-01

Utwórz lub zaktualizuj zasady replikacji obiektów konta magazynu.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	Nazwa konta magazynu w określonej grupie zasobów. Nazwy kont magazynu muszą mieć długość od 3 do 24 znaków i mogą zawierać wyłącznie cyfry oraz małe litery.
objectReplicationPolicyId	path	True	string minLength: 1	W przypadku konta docelowego podaj wartość "default". Najpierw skonfiguruj zasady na koncie docelowym. W przypadku konta źródłowego podaj wartość identyfikatora zasady, który jest zwracany podczas pobierania zasady zdefiniowanej na koncie docelowym. Zasady są pobierane jako plik JSON.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
properties.destinationAccount	True	string	Required. Nazwa konta docelowego. Powinien to być pełny identyfikator zasobu, jeśli parametr allowCrossTenantReplication ma wartość false.
properties.sourceAccount	True	string	Required. Nazwa konta źródłowego. Powinien to być pełny identyfikator zasobu, jeśli parametr allowCrossTenantReplication ma wartość false.
properties.metrics		ObjectReplicationPolicyPropertiesMetrics	Optional. Opcje funkcji metryk zasad replikacji obiektów.
properties.priorityReplication		ObjectReplicationPolicyPropertiesPriorityReplication	Optional. Opcje funkcji replikacji priorytetu zasad replikacji obiektów.
properties.rules		ObjectReplicationPolicyRule[]	Reguły replikacji obiektów konta magazynu.
properties.tagsReplication		ObjectReplicationPolicyPropertiesTagsReplication	Optional. Polityka replikacji obiektów oznacza opcje funkcji replikacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ObjectReplicationPolicy	Operacja aktualizacji zasobu 'ObjectReplicationPolicy' zakończyła się sukcesem
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	podszywaj się pod konto użytkownika

Przykłady

StorageAccountCreateObjectReplicationPolicyOnDestination

StorageAccountCreateObjectReplicationPolicyOnSource

StorageAccountUpdateObjectReplicationPolicyOnDestination

StorageAccountUpdateObjectReplicationPolicyOnSource

StorageAccountCreateObjectReplicationPolicyOnDestination

Przykładowe żądanie

HTTP

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

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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
    }
  }
}

Definicje

Nazwa	Opis
createdByType	Typ tożsamości, która utworzyła zasób.
ErrorResponse	Odpowiedź dostawcy zasobów magazynu na błąd.
ErrorResponseBody	Kontrakt treści odpowiedzi na błąd.
ObjectReplicationPolicy	Zasady replikacji między dwoma kontami magazynu. W jednej zasadach można zdefiniować wiele reguł.
ObjectReplicationPolicyFilter	Filtry ograniczają replikację do podzbioru obiektów blob na koncie magazynu. Wartość logiczna OR jest wykonywana na wartościach w filtrze. Jeśli zdefiniowano wiele filtrów, wartość logiczna AND jest wykonywana na wszystkich filtrach.
ObjectReplicationPolicyPropertiesMetrics	Optional. Opcje funkcji metryk zasad replikacji obiektów.
ObjectReplicationPolicyPropertiesPriorityReplication	Optional. Opcje funkcji replikacji priorytetu zasad replikacji obiektów.
ObjectReplicationPolicyPropertiesTagsReplication	Optional. Polityka replikacji obiektów oznacza opcje funkcji replikacji.
ObjectReplicationPolicyRule	Reguła zasad replikacji między dwoma kontenerami.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

ErrorResponse

Objekt

Odpowiedź dostawcy zasobów magazynu na błąd.

Nazwa	Typ	Opis
error	ErrorResponseBody	Azure Storage Resource Provider Error response body.

ErrorResponseBody

Objekt

Kontrakt treści odpowiedzi na błąd.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
message	string	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

ObjectReplicationPolicy

Objekt

Zasady replikacji między dwoma kontami magazynu. W jednej zasadach można zdefiniować wiele reguł.

Nazwa	Typ	Opis
id	string (arm-id)	W pełni określony identyfikator zasobu dla tego zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nazwa zasobu
properties.destinationAccount	string	Required. Nazwa konta docelowego. Powinien to być pełny identyfikator zasobu, jeśli parametr allowCrossTenantReplication ma wartość false.
properties.enabledTime	string (date-time)	Wskazuje, kiedy zasady są włączone na koncie źródłowym.
properties.metrics	ObjectReplicationPolicyPropertiesMetrics	Optional. Opcje funkcji metryk zasad replikacji obiektów.
properties.policyId	string	Unikatowy identyfikator zasad replikacji obiektów.
properties.priorityReplication	ObjectReplicationPolicyPropertiesPriorityReplication	Optional. Opcje funkcji replikacji priorytetu zasad replikacji obiektów.
properties.rules	ObjectReplicationPolicyRule[]	Reguły replikacji obiektów konta magazynu.
properties.sourceAccount	string	Required. Nazwa konta źródłowego. Powinien to być pełny identyfikator zasobu, jeśli parametr allowCrossTenantReplication ma wartość false.
properties.tagsReplication	ObjectReplicationPolicyPropertiesTagsReplication	Optional. Polityka replikacji obiektów oznacza opcje funkcji replikacji.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje „createdBy” i „modifiedBy”.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ObjectReplicationPolicyFilter

Objekt

Filtry ograniczają replikację do podzbioru obiektów blob na koncie magazynu. Wartość logiczna OR jest wykonywana na wartościach w filtrze. Jeśli zdefiniowano wiele filtrów, wartość logiczna AND jest wykonywana na wszystkich filtrach.

Nazwa	Typ	Opis
minCreationTime	string	Obiekty blob utworzone po upływie czasu zostaną zreplikowane do miejsca docelowego. Musi być w formacie daty/godziny "rrrr-MM-ddTHH:mm:ssZ". Przykład: 2020-02-19T16:05:00Z
prefixMatch	string[]	Optional. Filtruje wyniki, aby replikować tylko obiekty blob, których nazwy zaczynają się od określonego prefiksu.

ObjectReplicationPolicyPropertiesMetrics

Objekt

Optional. Opcje funkcji metryk zasad replikacji obiektów.

Nazwa	Typ	Opis
enabled	boolean	Wskazuje, czy dla zasad włączono funkcję metryk replikacji obiektów.

ObjectReplicationPolicyPropertiesPriorityReplication

Objekt

Optional. Opcje funkcji replikacji priorytetu zasad replikacji obiektów.

Nazwa	Typ	Opis
enabled	boolean	Wskazuje, czy dla zasady jest włączona funkcja replikacji priorytetu replikacji.

ObjectReplicationPolicyPropertiesTagsReplication

Objekt

Optional. Polityka replikacji obiektów oznacza opcje funkcji replikacji.

Nazwa	Typ	Opis
enabled	boolean	Wskazuje, czy funkcja replikacji tagów obiektów jest włączona dla polityki.

ObjectReplicationPolicyRule

Objekt

Reguła zasad replikacji między dwoma kontenerami.

Nazwa	Typ	Opis
destinationContainer	string	Required. Nazwa kontenera docelowego.
filters	ObjectReplicationPolicyFilter	Optional. Obiekt, który definiuje zestaw filtrów.
ruleId	string	Identyfikator reguły jest generowany automatycznie dla każdej nowej reguły na koncie docelowym. Wymagane jest umieszczenie zasad na koncie źródłowym.
sourceContainer	string	Required. Nazwa kontenera źródłowego.

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.