Object Replication Policies - Create Or Update

Creare o aggiornare i criteri di replica degli oggetti dell'account di archiviazione.

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

Parametri dell'URI

Name In Required Type Description
accountName
path True
  • string

Nome dell'account di archiviazione all'interno del gruppo di risorse specificato. I nomi degli account di archiviazione devono essere di lunghezza compresa tra 3 e 24 caratteri e utilizzare solo numeri e lettere minuscole.

objectReplicationPolicyId
path True
  • string

Per l'account di destinazione, specificare il valore "default". Configurare prima i criteri nell'account di destinazione. Per l'account di origine, specificare il valore dell'ID criterio restituito quando si scaricano i criteri definiti nell'account di destinazione. Il criterio viene scaricato come file JSON.

resourceGroupName
path True
  • string

Nome del gruppo di risorse all'interno della sottoscrizione dell'utente. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

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

subscriptionId
path True
  • string

ID della sottoscrizione di destinazione.

api-version
query True
  • string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Name Required Type Description
properties.destinationAccount True
  • string

Obbligatorio. Nome account di destinazione. Deve essere l'ID risorsa completo se allowCrossTenantReplication impostato su false.

properties.sourceAccount True
  • string

Obbligatorio. Nome dell'account di origine. Deve essere l'ID risorsa completo se allowCrossTenantReplication impostato su false.

properties.rules

Regole di replica dell'oggetto dell'account di archiviazione.

Risposte

Name Type Description
200 OK

OK : consente di inserire correttamente i criteri di replica degli oggetti.

Other Status Codes

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Azure Active Directory Flow OAuth2

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

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

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

Definizioni

ErrorResponse

Risposta di errore del provider di risorse di archiviazione.

ErrorResponseBody

Contratto del corpo della risposta all'errore.

ObjectReplicationPolicy

Criteri di replica tra due account di archiviazione. È possibile definire più regole in un unico criterio.

ObjectReplicationPolicyFilter

I filtri limitano la replica a un subset di BLOB all'interno dell'account di archiviazione. Un OR logico viene eseguito sui valori nel filtro. Se vengono definiti più filtri, viene eseguito un AND logico su tutti i filtri.

ObjectReplicationPolicyRule

Regola dei criteri di replica tra due contenitori.

ErrorResponse

Risposta di errore del provider di risorse di archiviazione.

Name Type Description
error

Archiviazione di Azure corpo della risposta di errore del provider di risorse.

ErrorResponseBody

Contratto del corpo della risposta all'errore.

Name Type Description
code
  • string

Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.

message
  • string

Messaggio che descrive l'errore, che deve essere adatto per la visualizzazione in un'interfaccia utente.

ObjectReplicationPolicy

Criteri di replica tra due account di archiviazione. È possibile definire più regole in un unico criterio.

Name Type Description
id
  • string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

nome della risorsa.

properties.destinationAccount
  • string

Obbligatorio. Nome account di destinazione. Deve essere l'ID risorsa completo se allowCrossTenantReplication impostato su false.

properties.enabledTime
  • string

Indica quando il criterio è abilitato nell'account di origine.

properties.policyId
  • string

ID univoco per i criteri di replica degli oggetti.

properties.rules

Regole di replica dell'oggetto dell'account di archiviazione.

properties.sourceAccount
  • string

Obbligatorio. Nome dell'account di origine. Deve essere l'ID risorsa completo se allowCrossTenantReplication impostato su false.

type
  • string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft. Archiviazione/storageAccounts"

ObjectReplicationPolicyFilter

I filtri limitano la replica a un subset di BLOB all'interno dell'account di archiviazione. Un OR logico viene eseguito sui valori nel filtro. Se vengono definiti più filtri, viene eseguito un AND logico su tutti i filtri.

Name Type Description
minCreationTime
  • string

I BLOB creati dopo il tempo verranno replicati nella destinazione. Deve essere in formato datetime 'yyyy-MM-ddTHH:mm:ssZ'. Esempio: 2020-02-19T16:05:00Z

prefixMatch
  • string[]

facoltativo. Filtra i risultati per replicare solo i BLOB i cui nomi iniziano con il prefisso specificato.

ObjectReplicationPolicyRule

Regola dei criteri di replica tra due contenitori.

Name Type Description
destinationContainer
  • string

Obbligatorio. Nome del contenitore di destinazione.

filters

facoltativo. Oggetto che definisce il set di filtri.

ruleId
  • string

L'ID regola viene generato automaticamente per ogni nuova regola nell'account di destinazione. È necessario per inserire i criteri nell'account di origine.

sourceContainer
  • string

Obbligatorio. Nome del contenitore di origine.