Blob Services - Set Service Properties

Define as propriedades do serviço Blob de uma conta de armazenamento, incluindo propriedades para as regras Análise de Armazenamento e CORS (Partilha de Recursos de Origem Cruzada).

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

Parâmetros do URI

Name In Required Type Description
accountName
path True
  • string

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

BlobServicesName
path True

O nome do serviço blob dentro da conta de armazenamento especificada. O nome do serviço blob deve ser 'padrão'

resourceGroupName
path True
  • string

O nome do grupo de recursos dentro da subscrição do utilizador. O nome não é sensível a maiúsculas e minúsculas.

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

subscriptionId
path True
  • string

A identificação da assinatura do alvo.

api-version
query True
  • string

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

Corpo do Pedido

Name Type Description
properties.automaticSnapshotPolicyEnabled
  • boolean

Depreciado a favor da propriedade isVersioningEnabled.

properties.changeFeed

As propriedades do serviço blob para alterar eventos de alimentação.

properties.containerDeleteRetentionPolicy

As propriedades de serviço blob para eliminação suave do recipiente.

properties.cors

Especifica as regras CORS para o serviço Blob. Pode incluir até cinco elementos CorsRule no pedido. Se nenhum elemento CorsRule estiver incluído no organismo de pedido, todas as regras DO CORS serão eliminadas e o CORS será desativado para o serviço Blob.

properties.defaultServiceVersion
  • string

DefaultServiceVersion indica a versão predefinida a utilizar para pedidos ao serviço Blob se a versão de um pedido de entrada não for especificada. Os valores possíveis incluem a versão 2008-10-27 e todas as versões mais recentes.

properties.deleteRetentionPolicy

As propriedades de serviço blob para apagar suavemente blob.

properties.isVersioningEnabled
  • boolean

A versão está ativada se for definida como verdadeira.

properties.lastAccessTimeTrackingPolicy

A propriedade de serviço blob para configurar a última política de rastreio baseada no tempo de acesso.

properties.restorePolicy

As propriedades de serviço blob para a política de restauro de blob.

Respostas

Name Type Description
200 OK

Ok -- Define as propriedades de uma conta de armazenamento blob com sucesso.

Segurança

azure_auth

Flow de Azure Ative Directory OAuth2

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

Scopes

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

BlobServicesPutAllowPermanentDelete

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2021-09-01
{
  "properties": {
    "deleteRetentionPolicy": {
      "enabled": true,
      "days": 300,
      "allowPermanentDelete": true
    },
    "isVersioningEnabled": true
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/blobServices",
  "properties": {
    "deleteRetentionPolicy": {
      "enabled": true,
      "days": 300,
      "allowPermanentDelete": true
    },
    "isVersioningEnabled": true
  }
}

BlobServicesPutLastAccessTimeBasedTracking

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2021-09-01
{
  "properties": {
    "lastAccessTimeTrackingPolicy": {
      "enable": true,
      "name": "AccessTimeTracking",
      "trackingGranularityInDays": 1,
      "blobType": [
        "blockBlob"
      ]
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/blobServices",
  "properties": {
    "lastAccessTimeTrackingPolicy": {
      "enable": true,
      "name": "AccessTimeTracking",
      "trackingGranularityInDays": 1,
      "blobType": [
        "blockBlob"
      ]
    }
  }
}

PutBlobServices

Sample Request

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2021-09-01
{
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "maxAgeInSeconds": 100,
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ]
        },
        {
          "allowedOrigins": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "maxAgeInSeconds": 2,
          "exposedHeaders": [
            "*"
          ],
          "allowedHeaders": [
            "*"
          ]
        },
        {
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "maxAgeInSeconds": 2000,
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x -ms-meta-target*"
          ],
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ]
        }
      ]
    },
    "defaultServiceVersion": "2017-07-29",
    "deleteRetentionPolicy": {
      "enabled": true,
      "days": 300
    },
    "isVersioningEnabled": true,
    "changeFeed": {
      "enabled": true,
      "retentionInDays": 7
    }
  }
}

Sample Response

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/blobServices",
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "maxAgeInSeconds": 100,
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ]
        },
        {
          "allowedOrigins": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "maxAgeInSeconds": 2,
          "exposedHeaders": [
            "*"
          ],
          "allowedHeaders": [
            "*"
          ]
        },
        {
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "maxAgeInSeconds": 2000,
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x -ms-meta-target*"
          ],
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ]
        }
      ]
    },
    "defaultServiceVersion": "2017-07-29",
    "deleteRetentionPolicy": {
      "enabled": true,
      "days": 300
    },
    "isVersioningEnabled": true,
    "changeFeed": {
      "enabled": true,
      "retentionInDays": 7
    }
  },
  "sku": {
    "name": "Standard_GRS",
    "tier": "Standard"
  }
}

Definições

BlobServiceProperties

As propriedades do serviço Blob de uma conta de armazenamento.

BlobServicesName

O nome do serviço blob dentro da conta de armazenamento especificada. O nome do serviço blob deve ser 'padrão'

ChangeFeed

As propriedades do serviço blob para alterar eventos de alimentação.

CorsRule

Especifica uma regra CORS para o serviço Blob.

CorsRules

Define as regras do CORS. Pode incluir até cinco elementos CorsRule no pedido.

DeleteRetentionPolicy

As propriedades de serviço para eliminação suave.

LastAccessTimeTrackingPolicy

As propriedades do serviço blob para a última política de rastreio baseada no tempo de acesso.

name

O nome da apólice. O valor válido é AccessTimeTracking. Este campo é atualmente lido apenas

RestorePolicyProperties

As propriedades de serviço blob para a política de restauro do blob

Sku

O SKU da conta de armazenamento.

SkuName

O nome SKU. Requerido para a criação de conta; opcional para atualização. Note que em versões mais antigas, o nome SKU era chamado de contaType.

SkuTier

O nível SKU. Isto é baseado no nome SKU.

BlobServiceProperties

As propriedades do serviço Blob de uma conta de armazenamento.

Name Type Description
id
  • string

ID de recursos totalmente qualificado para o recurso. Ex - /subscrições/{subscriçãoD}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

O nome do recurso

properties.automaticSnapshotPolicyEnabled
  • boolean

Depreciado a favor da propriedade isVersioningEnabled.

properties.changeFeed

As propriedades do serviço blob para alterar eventos de alimentação.

properties.containerDeleteRetentionPolicy

As propriedades de serviço blob para eliminação suave do recipiente.

properties.cors

Especifica as regras CORS para o serviço Blob. Pode incluir até cinco elementos CorsRule no pedido. Se nenhum elemento CorsRule estiver incluído no organismo de pedido, todas as regras DO CORS serão eliminadas e o CORS será desativado para o serviço Blob.

properties.defaultServiceVersion
  • string

DefaultServiceVersion indica a versão predefinida a utilizar para pedidos ao serviço Blob se a versão de um pedido de entrada não for especificada. Os valores possíveis incluem a versão 2008-10-27 e todas as versões mais recentes.

properties.deleteRetentionPolicy

As propriedades de serviço blob para apagar suavemente blob.

properties.isVersioningEnabled
  • boolean

A versão está ativada se for definida como verdadeira.

properties.lastAccessTimeTrackingPolicy

A propriedade de serviço blob para configurar a última política de rastreio baseada no tempo de acesso.

properties.restorePolicy

As propriedades de serviço blob para a política de restauro de blob.

sku

Nome e nível sku.

type
  • string

O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft. Armazenamento/armazenamentoCotalhos"

BlobServicesName

O nome do serviço blob dentro da conta de armazenamento especificada. O nome do serviço blob deve ser 'padrão'

Name Type Description
default
  • string

ChangeFeed

As propriedades do serviço blob para alterar eventos de alimentação.

Name Type Description
enabled
  • boolean

Indica se a sessão de registo de eventos de alteração está ativada para o serviço Blob.

retentionInDays
  • integer

Indica a duração da mudançaAlisar retenção em dias. O valor mínimo é de 1 dia e o valor máximo é de 146000 dias (400 anos). Um valor nulo indica uma retenção infinita da alimentação de mudança.

CorsRule

Especifica uma regra CORS para o serviço Blob.

Name Type Description
allowedHeaders
  • string[]

Necessário se o elemento CorsRule estiver presente. Uma lista de cabeçalhos autorizados a fazer parte do pedido de origem cruzada.

allowedMethods
  • string[]

Necessário se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem.

allowedOrigins
  • string[]

Necessário se o elemento CorsRule estiver presente. Uma lista de domínios de origem que serão permitidos via CORS, ou "*" para permitir todos os domínios

exposedHeaders
  • string[]

Necessário se o elemento CorsRule estiver presente. Uma lista de cabeçalhos de resposta para expor aos clientes cors.

maxAgeInSeconds
  • integer

Necessário se o elemento CorsRule estiver presente. O número de segundos que o cliente/browser deve cache uma resposta pré-voo.

CorsRules

Define as regras do CORS. Pode incluir até cinco elementos CorsRule no pedido.

Name Type Description
corsRules

A Lista das regras do CORS. Pode incluir até cinco elementos CorsRule no pedido.

DeleteRetentionPolicy

As propriedades de serviço para eliminação suave.

Name Type Description
allowPermanentDelete
  • boolean

Esta propriedade quando definida como verdadeira permite a eliminação das versões e instantâneos de bolhas apagadas suaves. Esta propriedade não pode ser usada como política de restauro de blob. Esta propriedade aplica-se apenas ao serviço blob e não se aplica a contentores ou partilha de ficheiros.

days
  • integer

Indica o número de dias em que o artigo eliminado deve ser mantido. O valor mínimo especificado pode ser 1 e o valor máximo pode ser de 365.

enabled
  • boolean

Indica se deleteRetentionPolicy está ativado.

LastAccessTimeTrackingPolicy

As propriedades do serviço blob para a última política de rastreio baseada no tempo de acesso.

Name Type Description
blobType
  • string[]

Uma matriz de tipos de bolhas pré-indefinidas suportadas. Apenas blockBlob é o valor suportado. Este campo é atualmente lido apenas

enable
  • boolean

Quando definido para o rastreio baseado no tempo de acesso verdadeiro está ativado.

name

O nome da apólice. O valor válido é AccessTimeTracking. Este campo é atualmente lido apenas

trackingGranularityInDays
  • integer

O campo especifica a granularidade do objeto blob em dias, tipicamente com que frequência o objeto blob deve ser rastreado. Este campo é atualmente lido apenas com valor como 1

name

O nome da apólice. O valor válido é AccessTimeTracking. Este campo é atualmente lido apenas

Name Type Description
AccessTimeTracking
  • string

RestorePolicyProperties

As propriedades de serviço blob para a política de restauro do blob

Name Type Description
days
  • integer

quanto tempo esta bolha pode ser restaurada. Deve ser grande do que zero e menos do que DeleteRetentionPolicy.days.

enabled
  • boolean

A restauração da bolha está ativada se for definida como verdadeira.

lastEnabledTime
  • string

Precitado a favor da propriedade minRestoreTime.

minRestoreTime
  • string

Devolve a data e hora mínimas para que o restauro possa ser iniciado.

Sku

O SKU da conta de armazenamento.

Name Type Description
name

O nome SKU. Requerido para a criação de conta; opcional para atualização. Note que em versões mais antigas, o nome SKU era chamado de contaType.

tier

O nível SKU. Isto é baseado no nome SKU.

SkuName

O nome SKU. Requerido para a criação de conta; opcional para atualização. Note que em versões mais antigas, o nome SKU era chamado de contaType.

Name Type Description
Premium_LRS
  • string
Premium_ZRS
  • string
Standard_GRS
  • string
Standard_GZRS
  • string
Standard_LRS
  • string
Standard_RAGRS
  • string
Standard_RAGZRS
  • string
Standard_ZRS
  • string

SkuTier

O nível SKU. Isto é baseado no nome SKU.

Name Type Description
Premium
  • string
Standard
  • string