Blob Services - Set Service Properties

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

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

Parâmetros de URI

Name In Required Type 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.

BlobServicesName
path True

O nome do Serviço de 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 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

Name Type Description
properties.automaticSnapshotPolicyEnabled
  • boolean

Preterido em favor da propriedade isVersioningEnabled.

properties.changeFeed

As propriedades do serviço blob para eventos de feed de alterações.

properties.containerDeleteRetentionPolicy

As propriedades do serviço blob para exclusão temporária do contêiner.

properties.cors

Especifica regras CORS para o serviço Blob. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule estiver incluído no corpo da solicitação, todas as regras CORS serão excluídas e o CORS será desabilitado para o serviço Blob.

properties.defaultServiceVersion
  • string

DefaultServiceVersion indica a versão padrão a ser usada para solicitações ao serviço Blob se a versão de uma solicitação de entrada não for especificada. Os valores possíveis incluem a versão 2008-10-27 e todas as mais recentes.

properties.deleteRetentionPolicy

As propriedades do serviço blob para exclusão temporária de blob.

properties.isVersioningEnabled
  • boolean

O controle de versão será habilitado se definido como true.

properties.lastAccessTimeTrackingPolicy

A propriedade do serviço blob para configurar a política de acompanhamento baseada em hora de último acesso.

properties.restorePolicy

As propriedades do serviço blob para a política de restauração de blob.

Respostas

Name Type Description
200 OK

OK -- Define as propriedades do serviço Blob de uma conta de armazenamento com êxito.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Scopes

Name Description
user_impersonation representar sua conta de usuário

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=2022-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=2022-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=2022-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 de 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 eventos de feed de alterações.

CorsRule

Especifica a regra de CORS para o serviço Blob.

CorsRules

Define as regras de CORS. Você pode incluir até cinco elementos CorsRule na solicitação.

DeleteRetentionPolicy

As propriedades de serviço para exclusão temporária.

LastAccessTimeTrackingPolicy

As propriedades do serviço blob para a política de acompanhamento baseada em hora de último acesso.

name

O nome da política. O valor válido é AccessTimeTracking. No momento, esse campo é somente leitura

RestorePolicyProperties

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

Sku

O SKU da conta de armazenamento.

SkuName

Nome do SKU. Necessário para a criação da conta; opcional para atualização. Observe que, em versões mais antigas, o nome do SKU era chamado accountType.

SkuTier

A camada da SKU. Isso é baseado no nome do SKU.

BlobServiceProperties

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

Name Type 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.automaticSnapshotPolicyEnabled
  • boolean

Preterido em favor da propriedade isVersioningEnabled.

properties.changeFeed

As propriedades do serviço blob para eventos de feed de alterações.

properties.containerDeleteRetentionPolicy

As propriedades do serviço blob para exclusão temporária do contêiner.

properties.cors

Especifica regras CORS para o serviço Blob. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule estiver incluído no corpo da solicitação, todas as regras CORS serão excluídas e o CORS será desabilitado para o serviço Blob.

properties.defaultServiceVersion
  • string

DefaultServiceVersion indica a versão padrão a ser usada para solicitações ao serviço Blob se a versão de uma solicitação de entrada não for especificada. Os valores possíveis incluem a versão 2008-10-27 e todas as mais recentes.

properties.deleteRetentionPolicy

As propriedades do serviço blob para exclusão temporária de blob.

properties.isVersioningEnabled
  • boolean

O controle de versão será habilitado se definido como true.

properties.lastAccessTimeTrackingPolicy

A propriedade do serviço blob para configurar a política de acompanhamento baseada em hora de último acesso.

properties.restorePolicy

As propriedades do serviço blob para a política de restauração de blob.

sku

Nome e camada de SKU.

type
  • string

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

BlobServicesName

O nome do Serviço de 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 eventos de feed de alterações.

Name Type Description
enabled
  • boolean

Indica se o log de eventos do feed de alterações está habilitado para o serviço Blob.

retentionInDays
  • integer

Indica a duração da retenção changeFeed em dias. O valor mínimo é de 1 dia e o valor máximo é 146000 dias (400 anos). Um valor nulo indica uma retenção infinita do feed de alterações.

CorsRule

Especifica a regra de CORS para o serviço Blob.

Name Type Description
allowedHeaders
  • string[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos permitidos para fazer parte da solicitação entre origens.

allowedMethods
  • string[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que têm permissão para serem executados pela origem.

allowedOrigins
  • string[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de domínios de origem que serão permitidos por meio do CORS ou "*" para permitir todos os domínios

exposedHeaders
  • string[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos de resposta a serem expostos a clientes CORS.

maxAgeInSeconds
  • integer

Obrigatório se o elemento CorsRule estiver presente. O número de segundos que o cliente/navegador deve armazenar em cache uma resposta de simulação.

CorsRules

Define as regras de CORS. Você pode incluir até cinco elementos CorsRule na solicitação.

Name Type Description
corsRules

A lista de regras cors. Você pode incluir até cinco elementos CorsRule na solicitação.

DeleteRetentionPolicy

As propriedades de serviço para exclusão temporária.

Name Type Description
allowPermanentDelete
  • boolean

Essa propriedade quando definida como true permite a exclusão das versões e instantâneos de blob excluídos temporariamente. Essa propriedade não pode ser usada na política de restauração de blob. Essa propriedade se aplica apenas ao serviço blob e não se aplica a contêineres ou compartilhamento de arquivos.

days
  • integer

Indica o número de dias em que o item excluído deve ser retido. O valor mínimo especificado pode ser 1 e o valor máximo pode ser 365.

enabled
  • boolean

Indica se DeleteRetentionPolicy está habilitado.

LastAccessTimeTrackingPolicy

As propriedades do serviço blob para a política de acompanhamento baseada em hora de último acesso.

Name Type Description
blobType
  • string[]

Uma matriz de tipos de blob com suporte predefinidos. Somente blockBlob é o valor com suporte. No momento, esse campo é somente leitura

enable
  • boolean

Quando definido como verdadeiro, o rastreamento baseado no último acesso está habilitado.

name

O nome da política. O valor válido é AccessTimeTracking. No momento, esse campo é somente leitura

trackingGranularityInDays
  • integer

O campo especifica a granularidade do rastreamento de objetos de blob em dias, normalmente com que frequência o objeto blob deve ser rastreado. No momento, esse campo é lido apenas com o valor como 1

name

O nome da política. O valor válido é AccessTimeTracking. No momento, esse campo é somente leitura

Name Type Description
AccessTimeTracking
  • string

RestorePolicyProperties

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

Name Type Description
days
  • integer

quanto tempo esse blob pode ser restaurado. Ele deve ser grande que zero e menor que DeleteRetentionPolicy.days.

enabled
  • boolean

A restauração de blob será habilitada se definida como true.

lastEnabledTime
  • string

Preterido em favor da propriedade minRestoreTime.

minRestoreTime
  • string

Retorna a data e a hora mínimas em que a restauração pode ser iniciada.

Sku

O SKU da conta de armazenamento.

Name Type Description
name

Nome do SKU. Necessário para a criação da conta; opcional para atualização. Observe que, em versões mais antigas, o nome do SKU era chamado accountType.

tier

A camada da SKU. Isso é baseado no nome do SKU.

SkuName

Nome do SKU. Necessário para a criação da conta; opcional para atualização. Observe que, em versões mais antigas, o nome do SKU era chamado accountType.

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

A camada da SKU. Isso é baseado no nome do SKU.

Name Type Description
Premium
  • string
Standard
  • string