Compartilhar via


Blob Services - Set Service Properties

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

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
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 da conta de armazenamento devem ter entre 3 e 24 caracteres, usar números e apenas 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 uma UUID.

api-version
query True

string

minLength: 1

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

Corpo da solicitação

Nome Tipo Description
properties.automaticSnapshotPolicyEnabled

boolean

Preterido em favor da propriedade isVersioningEnabled.

properties.changeFeed

ChangeFeed

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

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

As propriedades do serviço blob para exclusão reversível do 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 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 versões mais recentes.

properties.deleteRetentionPolicy

DeleteRetentionPolicy

As propriedades do serviço blob para exclusão reversível de blob.

properties.isVersioningEnabled

boolean

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

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

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

properties.restorePolicy

RestorePolicyProperties

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

Respostas

Nome Tipo Description
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 do OAuth2 do Azure Active Directory.

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

BlobServicesPutAllowPermanentDelete

Solicitação 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

Solicitação 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

Solicitação 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 Description
AllowedMethods
BlobServiceProperties

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

ChangeFeed

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

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 reversível.

ErrorResponse

Uma resposta de erro do provedor de recursos de armazenamento.

ErrorResponseBody

Contrato do corpo da resposta de erro.

LastAccessTimeTrackingPolicy

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

Name

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

RestorePolicyProperties

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

Sku

A SKU da conta de armazenamento.

SkuName

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

SkuTier

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

AllowedMethods

Valor Description
DELETE
GET
HEAD
MERGE
POST
OPTIONS
PUT
PATCH
CONNECT
TRACE

BlobServiceProperties

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

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.automaticSnapshotPolicyEnabled

boolean

Preterido em favor da propriedade isVersioningEnabled.

properties.changeFeed

ChangeFeed

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

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

As propriedades do serviço blob para exclusão reversível do 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 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 versões mais recentes.

properties.deleteRetentionPolicy

DeleteRetentionPolicy

As propriedades do serviço blob para exclusão reversível de blob.

properties.isVersioningEnabled

boolean

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

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

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

properties.restorePolicy

RestorePolicyProperties

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

sku

Sku

Nome e camada do SKU.

type

string

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

ChangeFeed

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

Nome Tipo Description
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 do 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 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

AllowedMethods[]

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 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 a serem expostos a 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 pré-vôo.

CorsRules

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

Nome Tipo Description
corsRules

CorsRule[]

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

DeleteRetentionPolicy

As propriedades de serviço para exclusão reversível.

Nome Tipo Description
allowPermanentDelete

boolean

Essa propriedade quando definida como true permite a exclusão das versões e instantâneos de blob excluídos suavemente. Essa propriedade não pode ser usada na 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 Description
error

ErrorResponseBody

Corpo da resposta de erro do Provedor de Recursos de 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.

LastAccessTimeTrackingPolicy

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

Nome Tipo Description
blobType

string[]

Uma matriz de tipos de blob com suporte predefinidos. Somente blockBlob é o valor com suporte. Este campo é somente leitura no momento

enable

boolean

Quando definido como verdadeiro último controle baseado em tempo de acesso é habilitado.

name

Name

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

trackingGranularityInDays

integer (int32)

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

Name

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

Valor Description
AccessTimeTracking

RestorePolicyProperties

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

Nome Tipo Description
days

integer (int32)

minimum: 1
maximum: 365

por 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 (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

A SKU da conta de armazenamento.

Nome Tipo Description
name

SkuName

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

tier

SkuTier

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

SkuName

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

Valor Description
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

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

Valor Description
Standard
Premium