Object Replication Policies - Create Or Update

Membuat atau memperbarui kebijakan replikasi objek dari akun penyimpanan.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
accountName
path True

string

Nama akun penyimpanan dalam grup sumber daya yang ditentukan. Nama akun penyimpanan harus sepanjang antara 3 dan 24 karakter dan hanya menggunakan angka dan huruf kecil.

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

objectReplicationPolicyId
path True

string

Untuk akun tujuan, berikan nilai 'default'. Konfigurasikan kebijakan pada akun tujuan terlebih dahulu. Untuk akun sumber, berikan nilai ID kebijakan yang dikembalikan saat Anda mengunduh kebijakan yang ditentukan pada akun tujuan. Kebijakan ini diunduh sebagai file JSON.

resourceGroupName
path True

string

Nama grup sumber daya dalam langganan pengguna. Nama tidak peka huruf besar/kecil.

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

subscriptionId
path True

string

ID langganan target.

api-version
query True

string

Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
properties.destinationAccount True

string

Wajib diisi. Nama akun tujuan. Ini harus menjadi id sumber daya penuh jika allowCrossTenantReplication diatur ke false.

properties.sourceAccount True

string

Wajib diisi. Nama akun sumber. Ini harus menjadi id sumber daya penuh jika allowCrossTenantReplication diatur ke false.

properties.rules

ObjectReplicationPolicyRule[]

Aturan replikasi objek akun penyimpanan.

Respons

Nama Jenis Deskripsi
200 OK

ObjectReplicationPolicy

OK -- Berhasil menempatkan kebijakan replikasi objek.

Other Status Codes

ErrorResponse

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

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

Scopes

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

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

Definisi

Nama Deskripsi
ErrorResponse

Respons kesalahan dari penyedia sumber daya penyimpanan.

ErrorResponseBody

Kontrak isi respons kesalahan.

ObjectReplicationPolicy

Kebijakan replikasi antara dua akun penyimpanan. Beberapa aturan dapat didefinisikan dalam satu kebijakan.

ObjectReplicationPolicyFilter

Filter membatasi replikasi ke subset blob dalam akun penyimpanan. OR logis dilakukan pada nilai dalam filter. Jika beberapa filter ditentukan, AND logis dilakukan pada semua filter.

ObjectReplicationPolicyRule

Aturan kebijakan replikasi antara dua kontainer.

ErrorResponse

Respons kesalahan dari penyedia sumber daya penyimpanan.

Nama Jenis Deskripsi
error

ErrorResponseBody

Isi respons kesalahan Penyedia Sumber Daya Azure Storage.

ErrorResponseBody

Kontrak isi respons kesalahan.

Nama Jenis Deskripsi
code

string

Pengidentifikasi untuk kesalahan. Kode tidak berubah dan dimaksudkan untuk dikonsumsi secara terprogram.

message

string

Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.

ObjectReplicationPolicy

Kebijakan replikasi antara dua akun penyimpanan. Beberapa aturan dapat didefinisikan dalam satu kebijakan.

Nama Jenis Deskripsi
id

string

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Nama sumber daya.

properties.destinationAccount

string

Wajib diisi. Nama akun tujuan. Ini harus menjadi id sumber daya penuh jika allowCrossTenantReplication diatur ke false.

properties.enabledTime

string

Menunjukkan kapan kebijakan diaktifkan pada akun sumber.

properties.policyId

string

Id unik untuk kebijakan replikasi objek.

properties.rules

ObjectReplicationPolicyRule[]

Aturan replikasi objek akun penyimpanan.

properties.sourceAccount

string

Wajib diisi. Nama akun sumber. Ini harus menjadi id sumber daya penuh jika allowCrossTenantReplication diatur ke false.

type

string

Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

ObjectReplicationPolicyFilter

Filter membatasi replikasi ke subset blob dalam akun penyimpanan. OR logis dilakukan pada nilai dalam filter. Jika beberapa filter ditentukan, AND logis dilakukan pada semua filter.

Nama Jenis Deskripsi
minCreationTime

string

Blob yang dibuat setelah waktu akan direplikasi ke tujuan. Ini harus dalam format tanggalwaktu 'yyyy-MM-ddTHH:mm:ssZ'. Contoh: 2020-02-19T16:05:00Z

prefixMatch

string[]

Opsional. Memfilter hasil untuk mereplikasi hanya blob yang namanya dimulai dengan awalan yang ditentukan.

ObjectReplicationPolicyRule

Aturan kebijakan replikasi antara dua kontainer.

Nama Jenis Deskripsi
destinationContainer

string

Wajib diisi. Nama kontainer tujuan.

filters

ObjectReplicationPolicyFilter

Pilihan. Objek yang menentukan set filter.

ruleId

string

Id Aturan dibuat secara otomatis untuk setiap aturan baru pada akun tujuan. Diperlukan untuk menempatkan kebijakan pada akun sumber.

sourceContainer

string

Wajib diisi. Nama kontainer sumber.