Object Replication Policies - Create Or Update

Erstellen oder Aktualisieren der Objektreplikationsrichtlinie des Speicherkontos.

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

URI-Parameter

Name In Required Type Description
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.

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

Der Name der Ressourcengruppe innerhalb des Abonnements 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 Required Type Description
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. Quellkontoname. Es sollte die vollständige Ressourcen-ID sein, wenn allowCrossTenantReplication auf "false" festgelegt ist.

properties.rules

Die Replikationsregeln des Speicherkontos.

Antworten

Name Type Description
200 OK

OK – Objektreplikationsrichtlinie erfolgreich platzieren.

Other Status Codes

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 Description
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=2021-09-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=2021-09-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=2021-09-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=2021-09-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

ErrorResponse

Eine Fehlerantwort des Speicherressourcenanbieters.

ErrorResponseBody

Fehlerantworttextvertrag.

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 logischer OR wird für Werte im Filter ausgeführt. Wenn mehrere Filter definiert sind, wird eine logische UND für alle Filter ausgeführt.

ObjectReplicationPolicyRule

Die Replikationsrichtlinienregel zwischen zwei Containern.

ErrorResponse

Eine Fehlerantwort des Speicherressourcenanbieters.

Name Type Description
error

Azure Storage Fehlerantworttext des Ressourcenanbieters.

ErrorResponseBody

Fehlerantworttextvertrag.

Name Type Description
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 auf einer Benutzeroberfläche geeignet ist.

ObjectReplicationPolicy

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

Name Type Description
id
  • string

Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /subscriptionId}/resourceGroups/{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 auf dem Quellkonto aktiviert ist.

properties.policyId
  • string

Eine eindeutige ID für die Objektreplikationsrichtlinie.

properties.rules

Die Replikationsregeln des Speicherkontos.

properties.sourceAccount
  • string

Erforderlich. Quellkontoname. 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 logischer OR wird für Werte im Filter ausgeführt. Wenn mehrere Filter definiert sind, wird eine logische UND für alle Filter ausgeführt.

Name Type Description
minCreationTime
  • string

Blobs, die nach der Replikation auf das Ziel erstellt wurden. Es muss sich im Datetime-Format "yyyy-MM-ddTHH:mm:ssZ" befinden. 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.

ObjectReplicationPolicyRule

Die Replikationsrichtlinienregel zwischen zwei Containern.

Name Type Description
destinationContainer
  • string

Erforderlich. Name des Zielcontainers.

filters

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 Richtlinien für das Quellkonto zu platzieren.

sourceContainer
  • string

Erforderlich. Quellcontainername.