Object Replication Policies - Create Or Update

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

Parametry identyfikatora URI

Name In Required Type Description
accountName
path True
  • string

Nazwa konta magazynu w określonej grupie zasobów. Storage nazwy kont muszą mieć długość od 3 do 24 znaków, a tylko cyfry i małe litery.

objectReplicationPolicyId
path True
  • string

W przypadku konta docelowego podaj wartość "default". Najpierw skonfiguruj zasady na koncie docelowym. W przypadku konta źródłowego podaj wartość identyfikatora zasad zwracanego podczas pobierania zasad zdefiniowanych na koncie docelowym. Zasady są pobierane jako plik JSON.

resourceGroupName
path True
  • string

Nazwa grupy zasobów w ramach subskrypcji użytkownika. W nazwie jest uwzględniana wielkość liter.

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

subscriptionId
path True
  • string

Identyfikator subskrypcji docelowej.

api-version
query True
  • string

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Name Required Type Description
properties.destinationAccount True
  • string

Wymagane. Nazwa konta docelowego. Powinien być pełny identyfikator zasobu, jeśli wartość allowCrossTenantReplication jest ustawiona na wartość false.

properties.sourceAccount True
  • string

Wymagane. Nazwa konta źródłowego. Powinien być pełny identyfikator zasobu, jeśli wartość allowCrossTenantReplication jest ustawiona na wartość false.

properties.rules

Reguły replikacji obiektów konta magazynu.

Odpowiedzi

Name Type Description
200 OK

OK — pomyślnie umieść zasady replikacji obiektów.

Other Status Codes

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

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 personifikacja konta użytkownika

Przykłady

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

Definicje

ErrorResponse

Odpowiedź o błędzie od dostawcy zasobów magazynu.

ErrorResponseBody

Kontrakt treści odpowiedzi na błąd.

ObjectReplicationPolicy

Zasady replikacji między dwoma kontami magazynu. Wiele reguł można zdefiniować w ramach jednej zasady.

ObjectReplicationPolicyFilter

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

ObjectReplicationPolicyRule

Reguła zasad replikacji między dwoma kontenerami.

ErrorResponse

Odpowiedź o błędzie od dostawcy zasobów magazynu.

Name Type Description
error

Treść odpowiedzi dostawcy zasobów platformy Azure Storage.

ErrorResponseBody

Kontrakt treści odpowiedzi na błąd.

Name Type Description
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

Zasady replikacji między dwoma kontami magazynu. Wiele reguł można zdefiniować w ramach jednej zasady.

Name Type Description
id
  • string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Nazwa zasobu

properties.destinationAccount
  • string

Wymagane. Nazwa konta docelowego. Powinien być pełny identyfikator zasobu, jeśli wartość allowCrossTenantReplication jest ustawiona na wartość false.

properties.enabledTime
  • string

Wskazuje, kiedy zasady są włączone na koncie źródłowym.

properties.policyId
  • string

Unikatowy identyfikator zasad replikacji obiektów.

properties.rules

Reguły replikacji obiektów konta magazynu.

properties.sourceAccount
  • string

Wymagane. Nazwa konta źródłowego. Powinien być pełny identyfikator zasobu, jeśli wartość allowCrossTenantReplication jest ustawiona na wartość false.

type
  • string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft. Storage/storageAccounts"

ObjectReplicationPolicyFilter

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

Name Type Description
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[]

Opcjonalny. Filtruje wyniki, aby replikować tylko obiekty blob, których nazwy zaczynają się od określonego prefiksu.

ObjectReplicationPolicyRule

Reguła zasad replikacji między dwoma kontenerami.

Name Type Description
destinationContainer
  • string

Wymagane. Nazwa kontenera docelowego.

filters

Opcjonalny. Obiekt, który definiuje zestaw filtrów.

ruleId
  • string

Identyfikator reguły jest generowany automatycznie dla każdej nowej reguły na koncie docelowym. Jest to wymagane do umieszczania zasad na koncie źródłowym.

sourceContainer
  • string

Wymagane. Nazwa kontenera źródłowego.