Freigeben über

Object Replication Policies - Create Or Update

Dienst:
Storage Resource Provider
API-Version:
2025-08-01

Erstellen oder aktualisieren Sie die Objektreplikationsrichtlinie des Speicherkontos.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
accountName
 path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

Der Name des Speicherkontos innerhalb der angegebenen Ressourcengruppe. Die Namen von Speicherkonten müssen zwischen 3 und 24 Zeichen lang sein und nur Zahlen und Kleinbuchstaben verwenden.
objectReplicationPolicyId
 path True

string

minLength: 1

Geben Sie für das Zielkonto den Wert "default" an. Konfigurieren Sie zuerst die Richtlinie für das Zielkonto. Geben Sie für das Quellkonto den Wert der Richtlinien-ID an, die zurückgegeben wird, wenn Sie die Richtlinie herunterladen, die für das Zielkonto definiert wurde. Die Richtlinie wird als JSON-Datei heruntergeladen.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId
 path True

string (uuid)

Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version
 query True

string

minLength: 1

Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.destinationAccount True

string

Erforderlich. Zielkontoname. Dies sollte die vollständige Ressourcen-ID sein, wenn "allowCrossTenantReplication" auf "false" festgelegt ist.
properties.sourceAccount True

string

Erforderlich. Name des Quellkontos. Dies sollte die vollständige Ressourcen-ID sein, wenn "allowCrossTenantReplication" auf "false" festgelegt ist.
properties.metrics

ObjectReplicationPolicyPropertiesMetrics

Dies ist optional. Die Featureoptionen für die Objektreplikationsrichtlinie.
properties.priorityReplication

ObjectReplicationPolicyPropertiesPriorityReplication

Dies ist optional. Die Optionen für die Replikationspriorität der Objektreplikationsrichtlinie.
properties.rules

ObjectReplicationPolicyRule[]

Die Replikationsregeln für speicherkontoobjekt.
properties.tagsReplication

ObjectReplicationPolicyPropertiesTagsReplication

Dies ist optional. Die Objekt-Replikationsrichtlinie kennzeichnet Optionen für Replikationsfunktionen.

Antworten

Name Typ Beschreibung
200 OK

ObjectReplicationPolicy

Die Aktualisierungsoperation der Ressource 'ObjectReplicationPolicy' war erfolgreich
Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

StorageAccountCreateObjectReplicationPolicyOnDestination
StorageAccountCreateObjectReplicationPolicyOnSource
StorageAccountUpdateObjectReplicationPolicyOnDestination
StorageAccountUpdateObjectReplicationPolicyOnSource

StorageAccountCreateObjectReplicationPolicyOnDestination

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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
    }
  }
}

Definitionen

Name Beschreibung
ErrorResponse

Eine Fehlerantwort des Speicherressourcenanbieters.
ErrorResponseBody

Fehlerantworttext-Vertrag.
ObjectReplicationPolicy

Die Replikationsrichtlinie zwischen zwei Speicherkonten. Mehrere Regeln können in einer Richtlinie definiert werden.
ObjectReplicationPolicyFilter

Filter beschränken die Replikation auf eine Teilmenge von Blobs innerhalb des Speicherkontos. Ein logisches OR wird für Werte im Filter ausgeführt. Wenn mehrere Filter definiert sind, wird für alle Filter ein logisches AND ausgeführt.
ObjectReplicationPolicyPropertiesMetrics

Dies ist optional. Die Featureoptionen für die Objektreplikationsrichtlinie.
ObjectReplicationPolicyPropertiesPriorityReplication

Dies ist optional. Die Optionen für die Replikationspriorität der Objektreplikationsrichtlinie.
ObjectReplicationPolicyPropertiesTagsReplication

Dies ist optional. Die Objekt-Replikationsrichtlinie kennzeichnet Optionen für Replikationsfunktionen.
ObjectReplicationPolicyRule

Die Replikationsrichtlinienregel zwischen zwei Containern.

ErrorResponse

Objekt

Eine Fehlerantwort des Speicherressourcenanbieters.

Name Typ Beschreibung
error

ErrorResponseBody

Azure Storage Resource Provider error response body.

ErrorResponseBody

Objekt

Fehlerantworttext-Vertrag.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
message

string

Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

ObjectReplicationPolicy

Objekt

Die Replikationsrichtlinie zwischen zwei Speicherkonten. Mehrere Regeln können in einer Richtlinie definiert werden.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Zum Beispiel - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

Der Name der Ressource
properties.destinationAccount

string

Erforderlich. Zielkontoname. Dies sollte die vollständige Ressourcen-ID sein, wenn "allowCrossTenantReplication" auf "false" festgelegt ist.
properties.enabledTime

string (date-time)

Gibt an, wann die Richtlinie für das Quellkonto aktiviert ist.
properties.metrics

ObjectReplicationPolicyPropertiesMetrics

Dies ist optional. Die Featureoptionen für die Objektreplikationsrichtlinie.
properties.policyId

string

Eine eindeutige ID für die Objektreplikationsrichtlinie.
properties.priorityReplication

ObjectReplicationPolicyPropertiesPriorityReplication

Dies ist optional. Die Optionen für die Replikationspriorität der Objektreplikationsrichtlinie.
properties.rules

ObjectReplicationPolicyRule[]

Die Replikationsregeln für speicherkontoobjekt.
properties.sourceAccount

string

Erforderlich. Name des Quellkontos. Dies sollte die vollständige Ressourcen-ID sein, wenn "allowCrossTenantReplication" auf "false" festgelegt ist.
properties.tagsReplication

ObjectReplicationPolicyPropertiesTagsReplication

Dies ist optional. Die Objekt-Replikationsrichtlinie kennzeichnet Optionen für Replikationsfunktionen.
type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ObjectReplicationPolicyFilter

Objekt

Filter beschränken die Replikation auf eine Teilmenge von Blobs innerhalb des Speicherkontos. Ein logisches OR wird für Werte im Filter ausgeführt. Wenn mehrere Filter definiert sind, wird für alle Filter ein logisches AND ausgeführt.

Name Typ Beschreibung
minCreationTime

string

Blobs, die nach dem Zeitpunkt erstellt wurden, werden auf das Ziel repliziert. Er muss im Datumstimeformat "jjjj-MM-ddTHH:mm:ssZ" sein. Beispiel: 2020-02-19T16:05:00Z
prefixMatch

string[]

Dies ist optional. Filtert die Ergebnisse, um nur Blobs zu replizieren, deren Namen mit dem angegebenen Präfix beginnen.

ObjectReplicationPolicyPropertiesMetrics

Objekt

Dies ist optional. Die Featureoptionen für die Objektreplikationsrichtlinie.

Name Typ Beschreibung
enabled

boolean

Gibt an, ob das Feature zur Objektreplikationsmetrik für die Richtlinie aktiviert ist.

ObjectReplicationPolicyPropertiesPriorityReplication

Objekt

Dies ist optional. Die Optionen für die Replikationspriorität der Objektreplikationsrichtlinie.

Name Typ Beschreibung
enabled

boolean

Gibt an, ob die Replikationsprioritätsfunktion für die Objektreplikation für die Richtlinie aktiviert ist.

ObjectReplicationPolicyPropertiesTagsReplication

Objekt

Dies ist optional. Die Objekt-Replikationsrichtlinie kennzeichnet Optionen für Replikationsfunktionen.

Name Typ Beschreibung
enabled

boolean

Gibt an, ob Objekt-Replikations-Tags die Replikationsfunktion für die Richtlinie aktiviert ist.

ObjectReplicationPolicyRule

Objekt

Die Replikationsrichtlinienregel zwischen zwei Containern.

Name Typ Beschreibung
destinationContainer

string

Erforderlich. Zielcontainername.
filters

ObjectReplicationPolicyFilter

Dies ist optional. Ein Objekt, das den Filtersatz definiert.
ruleId

string

Regel-ID wird automatisch für jede neue Regel für das Zielkonto generiert. Es ist erforderlich, um eine Richtlinie auf das Quellkonto zu setzen.
sourceContainer

string

Erforderlich. Quellcontainername.