Object Replication Policies - Create Or Update

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=2023-01-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
accountName
path True

string

Der Name des Speicherkontos innerhalb der angegebenen Ressourcengruppe. Speicherkontonamen müssen zwischen 3 und 24 Zeichen lang sein und dürfen nur Zahlen und Kleinbuchstaben enthalten.

Regex pattern: ^[a-z0-9]+$

objectReplicationPolicyId
path True

string

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, der 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

Der Name der Ressourcengruppe im Abonnement des Benutzers. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Hierbei handelt es sich um die ID des Zielabonnements.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.destinationAccount True

string

Erforderlich. Name des Zielkontos. Es sollte die vollständige Ressourcen-ID sein, wenn allowCrossTenantReplication auf false festgelegt ist.

properties.sourceAccount True

string

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

properties.rules

ObjectReplicationPolicyRule[]

Die Speicherkontoobjektreplikationsregeln.

Antworten

Name Typ Beschreibung
200 OK

ObjectReplicationPolicy

OK – Setzen Sie die Objektreplikationsrichtlinie erfolgreich.

Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

StorageAccountCreateObjectReplicationPolicyOnDestination
StorageAccountCreateObjectReplicationPolicyOnSource
StorageAccountUpdateObjectReplicationPolicyOnDestination
StorageAccountUpdateObjectReplicationPolicyOnSource

StorageAccountCreateObjectReplicationPolicyOnDestination

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res7687/providers/Microsoft.Storage/storageAccounts/dst112/objectReplicationPolicies/default?api-version=2023-01-01

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

Sample Response

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

StorageAccountCreateObjectReplicationPolicyOnSource

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res7687/providers/Microsoft.Storage/storageAccounts/src1122/objectReplicationPolicies/2a20bb73-5717-4635-985a-5d4cf777438f?api-version=2023-01-01

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

Sample Response

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

StorageAccountUpdateObjectReplicationPolicyOnDestination

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res7687/providers/Microsoft.Storage/storageAccounts/dst112/objectReplicationPolicies/2a20bb73-5717-4635-985a-5d4cf777438f?api-version=2023-01-01

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

Sample Response

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

StorageAccountUpdateObjectReplicationPolicyOnSource

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res7687/providers/Microsoft.Storage/storageAccounts/src1122/objectReplicationPolicies/2a20bb73-5717-4635-985a-5d4cf777438f?api-version=2023-01-01

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

Sample Response

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

Definitionen

Name Beschreibung
ErrorResponse

Eine Fehlerantwort des Speicherressourcenanbieters.

ErrorResponseBody

Fehlerantworttextvertrag.

ObjectReplicationPolicy

Die Replikationsrichtlinie zwischen zwei Speicherkonten. In einer Richtlinie können mehrere Regeln 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.

ObjectReplicationPolicyRule

Die Replikationsrichtlinienregel zwischen zwei Containern.

ErrorResponse

Eine Fehlerantwort des Speicherressourcenanbieters.

Name Typ Beschreibung
error

ErrorResponseBody

Fehlerantworttext des Azure Storage-Ressourcenanbieters.

ErrorResponseBody

Fehlerantworttextvertrag.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollten programmgesteuert verwendet werden.

message

string

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

ObjectReplicationPolicy

Die Replikationsrichtlinie zwischen zwei Speicherkonten. In einer Richtlinie können mehrere Regeln definiert werden.

Name Typ Beschreibung
id

string

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

name

string

Der Name der Ressource

properties.destinationAccount

string

Erforderlich. Name des Zielkontos. Es sollte die vollständige Ressourcen-ID sein, wenn allowCrossTenantReplication auf false festgelegt ist.

properties.enabledTime

string

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

properties.policyId

string

Eine eindeutige ID für die Objektreplikationsrichtlinie.

properties.rules

ObjectReplicationPolicyRule[]

Die Speicherkontoobjektreplikationsregeln.

properties.sourceAccount

string

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

type

string

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

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.

Name Typ Beschreibung
minCreationTime

string

Blobs, die nach dem Zeitpunkt erstellt wurden, werden auf das Ziel repliziert. Sie muss im datetime-Format "jjJJ-MM-ddTHH:mm:ssZ" vorliegen. Beispiel: 2020-02-19T16:05:00Z

prefixMatch

string[]

Optional. Filtert die Ergebnisse so, dass nur Blobs repliziert werden, deren Namen mit dem angegebenen Präfix beginnen.

ObjectReplicationPolicyRule

Die Replikationsrichtlinienregel zwischen zwei Containern.

Name Typ Beschreibung
destinationContainer

string

Erforderlich. Zielcontainername.

filters

ObjectReplicationPolicyFilter

Optional. Ein Objekt, das den Filtersatz definiert.

ruleId

string

Die Regel-ID wird automatisch für jede neue Regel für das Zielkonto generiert. Dies ist erforderlich, um eine Richtlinie für das Quellkonto zu erstellen.

sourceContainer

string

Erforderlich. Quellcontainername.