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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
accountName
path True

string

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

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

objectReplicationPolicyId
path True

string

W przypadku konta docelowego podaj wartość "default". Najpierw skonfiguruj zasady na koncie docelowym. Dla 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

Nazwa Wymagane Typ Opis
properties.destinationAccount True

string

Wymagane. Nazwa konta docelowego. Powinien on mieć pełny identyfikator zasobu, jeśli parametr allowCrossTenantReplication ma wartość false.

properties.sourceAccount True

string

Wymagane. Nazwa konta źródłowego. Powinien on mieć pełny identyfikator zasobu, jeśli parametr allowCrossTenantReplication ma wartość false.

properties.rules

ObjectReplicationPolicyRule[]

Reguły replikacji obiektów konta magazynu.

Odpowiedzi

Nazwa Typ Opis
200 OK

ObjectReplicationPolicy

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

Other Status Codes

ErrorResponse

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

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Nazwa Opis
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=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"
      }
    ]
  }
}

Definicje

Nazwa Opis
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. W jednej zasadach można zdefiniować wiele reguł.

ObjectReplicationPolicyFilter

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

ObjectReplicationPolicyRule

Reguła zasad replikacji między dwoma kontenerami.

ErrorResponse

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

Nazwa Typ Opis
error

ErrorResponseBody

Treść odpowiedzi dostawcy zasobów usługi Azure Storage.

ErrorResponseBody

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

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

Nazwa Typ Opis
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 on mieć pełny identyfikator zasobu, jeśli parametr allowCrossTenantReplication ma 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

ObjectReplicationPolicyRule[]

Reguły replikacji obiektów konta magazynu.

properties.sourceAccount

string

Wymagane. Nazwa konta źródłowego. Powinien on mieć pełny identyfikator zasobu, jeśli parametr allowCrossTenantReplication ma wartość false.

type

string

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

ObjectReplicationPolicyFilter

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

Nazwa Typ Opis
minCreationTime

string

Obiekty blob utworzone po upływie czasu zostaną zreplikowane do miejsca docelowego. Musi być w formacie data/godzina "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.

Nazwa Typ Opis
destinationContainer

string

Wymagane. Nazwa kontenera docelowego.

filters

ObjectReplicationPolicyFilter

Opcjonalny. Obiekt definiujący zestaw filtrów.

ruleId

string

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

sourceContainer

string

Wymagane. Nazwa kontenera źródłowego.