Partilhar via


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 (Cross-Origin Resource Sharing).

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

Parâmetros URI

Nome Em Necessário Tipo Descrição
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

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

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string (uuid)

A ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

minLength: 1

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

Órgão do Pedido

Nome Tipo Descrição
properties.automaticSnapshotPolicyEnabled

boolean

Preterido em favor da propriedade isVersioningEnabled.

properties.changeFeed

ChangeFeed

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

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

As propriedades do serviço de blob para exclusão suave de contêiner.

properties.cors

CorsRules

Especifica regras CORS para o serviço Blob. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule for incluído no corpo da solicitação, todas as regras do 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 versões mais recentes.

properties.deleteRetentionPolicy

DeleteRetentionPolicy

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

properties.isVersioningEnabled

boolean

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

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

A propriedade de serviço de blob para configurar a política de rastreamento baseada no tempo do último acesso.

properties.restorePolicy

RestorePolicyProperties

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

Respostas

Nome Tipo Descrição
200 OK

BlobServiceProperties

Operação de atualização do recurso 'BlobServiceProperties' bem-sucedida

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Flow: implicit
URL de autorização: https://login.microsoftonline.com/common/oauth2/authorize

Alcances

Nome Descrição
user_impersonation personificar a sua conta de utilizador

Exemplos

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

BlobServicesPutAllowPermanentDelete

Pedido de exemplo

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2025-06-01

{
  "properties": {
    "deleteRetentionPolicy": {
      "allowPermanentDelete": true,
      "days": 300,
      "enabled": true
    },
    "isVersioningEnabled": true
  }
}

Resposta de exemplo

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

BlobServicesPutLastAccessTimeBasedTracking

Pedido de exemplo

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2025-06-01

{
  "properties": {
    "lastAccessTimeTrackingPolicy": {
      "name": "AccessTimeTracking",
      "blobType": [
        "blockBlob"
      ],
      "enable": true,
      "trackingGranularityInDays": 1
    }
  }
}

Resposta de exemplo

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

PutBlobServices

Pedido de exemplo

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2025-06-01

{
  "properties": {
    "changeFeed": {
      "enabled": true,
      "retentionInDays": 7
    },
    "cors": {
      "corsRules": [
        {
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "maxAgeInSeconds": 100
        },
        {
          "allowedHeaders": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "allowedOrigins": [
            "*"
          ],
          "exposedHeaders": [
            "*"
          ],
          "maxAgeInSeconds": 2
        },
        {
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x -ms-meta-target*"
          ],
          "maxAgeInSeconds": 2000
        }
      ]
    },
    "defaultServiceVersion": "2017-07-29",
    "deleteRetentionPolicy": {
      "days": 300,
      "enabled": true
    },
    "isVersioningEnabled": true
  }
}

Resposta de exemplo

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

Definições

Nome Descrição
AllowedMethods
BlobServiceProperties

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

ChangeFeed

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

CorsRule

Especifica uma regra CORS para o serviço Blob.

CorsRules

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

DeleteRetentionPolicy

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

ErrorResponse

Uma resposta de erro do provedor de recursos de armazenamento.

ErrorResponseBody

Contrato do corpo de resposta ao erro.

LastAccessTimeTrackingPolicy

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

Name

Nome da política. O valor válido é AccessTimeTracking. Este campo é atualmente somente leitura

RestorePolicyProperties

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

Sku

O SKU da conta de armazenamento.

SkuName

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

SkuTier

O nível de SKU. Isso é baseado no nome SKU.

AllowedMethods

Valor Descrição
DELETE
GET
HEAD
MERGE
POST
OPTIONS
PUT
PATCH
CONNECT
TRACE

BlobServiceProperties

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

Nome Tipo Descrição
id

string

ID de recurso totalmente qualificado 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

ChangeFeed

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

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

As propriedades do serviço de blob para exclusão suave de contêiner.

properties.cors

CorsRules

Especifica regras CORS para o serviço Blob. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule for incluído no corpo da solicitação, todas as regras do 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 versões mais recentes.

properties.deleteRetentionPolicy

DeleteRetentionPolicy

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

properties.isVersioningEnabled

boolean

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

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

A propriedade de serviço de blob para configurar a política de rastreamento baseada no tempo do último acesso.

properties.restorePolicy

RestorePolicyProperties

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

sku

Sku

Nome e camada da Sku.

type

string

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

ChangeFeed

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

Nome Tipo Descrição
enabled

boolean

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

retentionInDays

integer (int32)

minimum: 1
maximum: 146000

Indica a duração da retenção changeFeed 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 do feed de alterações.

CorsRule

Especifica uma regra CORS para o serviço Blob.

Nome Tipo Descrição
allowedHeaders

string[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos que podem fazer parte da solicitação de origem cruzada.

allowedMethods

AllowedMethods[]

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

allowedOrigins

string[]

Obrigató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[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos de resposta para expor aos clientes CORS.

maxAgeInSeconds

integer (int32)

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

CorsRules

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

Nome Tipo Descrição
corsRules

CorsRule[]

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

DeleteRetentionPolicy

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

Nome Tipo Descrição
allowPermanentDelete

boolean

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

days

integer (int32)

minimum: 1
maximum: 365

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

enabled

boolean

Indica se DeleteRetentionPolicy está habilitado.

ErrorResponse

Uma resposta de erro do provedor de recursos de armazenamento.

Nome Tipo Descrição
error

ErrorResponseBody

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

ErrorResponseBody

Contrato do corpo de resposta ao erro.

Nome Tipo Descrição
code

string

Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.

message

string

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

LastAccessTimeTrackingPolicy

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

Nome Tipo Descrição
blobType

string[]

Uma matriz de tipos de blob suportados predefinidos. Apenas blockBlob é o valor suportado. Este campo é atualmente somente leitura

enable

boolean

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

name

Name

Nome da política. O valor válido é AccessTimeTracking. Este campo é atualmente somente leitura

trackingGranularityInDays

integer (int32)

O campo especifica a granularidade do rastreamento do objeto blob em dias, normalmente a frequência com que o objeto blob deve ser rastreado. Atualmente, este campo é lido apenas com o valor 1

Name

Nome da política. O valor válido é AccessTimeTracking. Este campo é atualmente somente leitura

Valor Descrição
AccessTimeTracking

RestorePolicyProperties

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

Nome Tipo Descrição
days

integer (int32)

minimum: 1
maximum: 365

por quanto tempo este blob pode ser restaurado. Deve ser ótimo que zero e menor que DeleteRetentionPolicy.days.

enabled

boolean

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

lastEnabledTime

string (date-time)

Preterido em favor da propriedade minRestoreTime.

minRestoreTime

string (date-time)

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

Sku

O SKU da conta de armazenamento.

Nome Tipo Descrição
name

SkuName

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

tier

SkuTier

O nível de SKU. Isso é baseado no nome SKU.

SkuName

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

Valor Descrição
Standard_LRS
Standard_GRS
Standard_RAGRS
Standard_ZRS
Premium_LRS
Premium_ZRS
Standard_GZRS
Standard_RAGZRS
StandardV2_LRS
StandardV2_GRS
StandardV2_ZRS
StandardV2_GZRS
PremiumV2_LRS
PremiumV2_ZRS

SkuTier

O nível de SKU. Isso é baseado no nome SKU.

Valor Descrição
Standard
Premium