Object Replication Policies - Create Or Update

Crie ou atualize a política de replicação de objeto da conta de armazenamento.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
accountName
path True

string

O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres, usar números e apenas letras minúsculas.

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

objectReplicationPolicyId
path True

string

Para a conta de destino, forneça o valor 'default'. Configure a política na conta de destino primeiro. Para a conta de origem, forneça o valor da ID da política retornada quando você baixa a política que foi definida na conta de destino. A política é baixada como um arquivo JSON.

resourceGroupName
path True

string

O nome do grupo de recursos na assinatura do usuário. O nome diferencia maiúsculas de minúsculas.

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

subscriptionId
path True

string

A ID da assinatura de destino.

api-version
query True

string

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Obrigatório Tipo Description
properties.destinationAccount True

string

Obrigatórios. Nome da conta de destino. Ele deverá ser a ID de recurso completa se allowCrossTenantReplication for definido como false.

properties.sourceAccount True

string

Obrigatórios. Nome da conta de origem. Ele deverá ser a ID de recurso completa se allowCrossTenantReplication for definido como false.

properties.rules

ObjectReplicationPolicyRule[]

As regras de replicação de objeto da conta de armazenamento.

Respostas

Nome Tipo Description
200 OK

ObjectReplicationPolicy

OK -- Coloque a política de replicação de objeto com êxito.

Other Status Codes

ErrorResponse

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Scopes

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

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

Definições

Nome Description
ErrorResponse

Uma resposta de erro do provedor de recursos de armazenamento.

ErrorResponseBody

Contrato do corpo da resposta de erro.

ObjectReplicationPolicy

A política de replicação entre duas contas de armazenamento. Várias regras podem ser definidas em uma política.

ObjectReplicationPolicyFilter

Os filtros limitam a replicação a um subconjunto de blobs dentro da conta de armazenamento. Um OR lógico é executado em valores no filtro. Se vários filtros forem definidos, um AND lógico será executado em todos os filtros.

ObjectReplicationPolicyRule

A regra de política de replicação entre dois contêineres.

ErrorResponse

Uma resposta de erro do provedor de recursos de armazenamento.

Nome Tipo Description
error

ErrorResponseBody

Corpo da resposta de erro do Provedor de Recursos do Armazenamento do Azure.

ErrorResponseBody

Contrato do corpo da resposta de erro.

Nome Tipo Description
code

string

Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.

message

string

Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.

ObjectReplicationPolicy

A política de replicação entre duas contas de armazenamento. Várias regras podem ser definidas em uma política.

Nome Tipo Description
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

O nome do recurso

properties.destinationAccount

string

Obrigatórios. Nome da conta de destino. Ele deverá ser a ID de recurso completa se allowCrossTenantReplication for definido como false.

properties.enabledTime

string

Indica quando a política está habilitada na conta de origem.

properties.policyId

string

Uma ID exclusiva para a política de replicação de objeto.

properties.rules

ObjectReplicationPolicyRule[]

As regras de replicação de objeto da conta de armazenamento.

properties.sourceAccount

string

Obrigatórios. Nome da conta de origem. Ele deverá ser a ID de recurso completa se allowCrossTenantReplication for definido como false.

type

string

Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ObjectReplicationPolicyFilter

Os filtros limitam a replicação a um subconjunto de blobs dentro da conta de armazenamento. Um OR lógico é executado em valores no filtro. Se vários filtros forem definidos, um AND lógico será executado em todos os filtros.

Nome Tipo Description
minCreationTime

string

Os blobs criados após a hora serão replicados para o destino. Ele deve estar no formato datetime 'y-MM-ddTHH:mm:ssZ'. Exemplo: 2020-02-19T16:05:00Z

prefixMatch

string[]

Opcional. Filtra os resultados para replicar apenas blobs cujos nomes começam com o prefixo especificado.

ObjectReplicationPolicyRule

A regra de política de replicação entre dois contêineres.

Nome Tipo Description
destinationContainer

string

Obrigatórios. Nome do contêiner de destino.

filters

ObjectReplicationPolicyFilter

Opcional. Um objeto que define o conjunto de filtros.

ruleId

string

A ID da regra é gerada automaticamente para cada nova regra na conta de destino. É necessário colocar a política na conta de origem.

sourceContainer

string

Obrigatórios. Nome do contêiner de origem.