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 |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 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. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
subscription
|
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 |
As propriedades do serviço blob para eventos de feed de alterações. |
|
| properties.containerDeleteRetentionPolicy |
As propriedades do serviço blob para exclusão reversível 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 versões mais recentes. |
| properties.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 |
A propriedade do serviço blob para configurar a política de acompanhamento baseada em hora de acesso final. |
|
| properties.restorePolicy |
As propriedades do serviço blob para a política de restauração de blob. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
Operação de atualização do recurso 'BlobServiceProperties' bem-sucedida |
|
| Other Status Codes |
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
|
Blob |
|
Blob |
|
Put |
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 |
|---|---|
|
Allowed |
|
|
Blob |
As propriedades do serviço blob de uma conta de armazenamento. |
|
Change |
As propriedades do serviço blob para eventos de feed de alterações. |
|
Cors |
Especifica uma regra CORS para o serviço Blob. |
|
Cors |
Define as regras do CORS. Você pode incluir até cinco elementos CorsRule na solicitação. |
|
Delete |
As propriedades de serviço para exclusão reversível. |
|
Error |
Uma resposta de erro do provedor de recursos de armazenamento. |
|
Error |
Contrato do corpo da resposta de erro. |
|
Last |
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 |
|
Restore |
As propriedades do serviço blob para a política de restauração de blob |
| Sku |
A SKU da conta de armazenamento. |
|
Sku |
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. |
|
Sku |
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 |
As propriedades do serviço blob para eventos de feed de alterações. |
|
| properties.containerDeleteRetentionPolicy |
As propriedades do serviço blob para exclusão reversível 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 versões mais recentes. |
| properties.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 |
A propriedade do serviço blob para configurar a política de acompanhamento baseada em hora de acesso final. |
|
| properties.restorePolicy |
As propriedades do serviço blob para a política de restauração de blob. |
|
| 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: 1maximum: 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 |
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 |
Cors |
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: 1maximum: 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 |
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 |
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: 1maximum: 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 |
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 |
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 |