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 CORS (Partilha de Recursos Transversais à Origem).
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2023-01-01
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
account
|
path | True |
string |
O nome da conta de armazenamento no grupo de recursos especificado. Os nomes das contas de armazenamento têm de ter entre 3 e 24 carateres de comprimento e utilizar apenas números e letras minúsculas. Regex pattern: |
Blob
|
path | True |
O nome do Serviço blob na conta de armazenamento especificada. O Nome do Serviço blob tem de ser "predefinido" |
|
resource
|
path | True |
string |
O nome do grupo de recursos na subscrição do utilizador. O nome não é sensível a maiúsculas e minúsculas. Regex pattern: |
subscription
|
path | True |
string |
O ID da subscrição de destino. |
api-version
|
query | True |
string |
A versão da API a utilizar para esta operação. |
Corpo do Pedido
Name | Tipo | Description |
---|---|---|
properties.automaticSnapshotPolicyEnabled |
boolean |
Preterido a favor da propriedade isVersioningEnabled. |
properties.changeFeed |
As propriedades do serviço blob para eventos do feed de alterações. |
|
properties.containerDeleteRetentionPolicy |
As propriedades do serviço blob para a eliminação recuperável do contentor. |
|
properties.cors |
Especifica regras CORS para o serviço Blob. Pode incluir até cinco elementos CorsRule no pedido. Se não forem incluídos elementos CorsRule no corpo do pedido, todas as regras 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 para o serviço Blob se a versão de um pedido recebido 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 a eliminação recuperável de blobs. |
|
properties.isVersioningEnabled |
boolean |
O controlo de versões é ativado se estiver definido como verdadeiro. |
properties.lastAccessTimeTrackingPolicy |
A propriedade do serviço blob para configurar a política de controlo baseada na hora do último acesso. |
|
properties.restorePolicy |
As propriedades do serviço blob para a política de restauro de blobs. |
Respostas
Name | Tipo | 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 a sua conta de utilizador |
Exemplos
Blob |
Blob |
Put |
BlobServicesPutAllowPermanentDelete
Sample Request
PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2023-01-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=2023-01-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=2023-01-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
Name | Description |
---|---|
Allowed |
Necessário se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem. |
Blob |
As propriedades do serviço Blob de uma conta de armazenamento. |
Blob |
O nome do Serviço blob na conta de armazenamento especificada. O Nome do Serviço blob tem de ser "predefinido" |
Change |
As propriedades do serviço blob para eventos do feed de alterações. |
Cors |
Especifica uma regra CORS para o serviço Blob. |
Cors |
Define as regras CORS. Pode incluir até cinco elementos CorsRule no pedido. |
Delete |
As propriedades do serviço para eliminação recuperável. |
Last |
As propriedades do serviço blob para a política de controlo Baseada na hora do último acesso. |
name |
Nome da política. O valor válido é AccessTimeTracking. Este campo é atualmente só de leitura |
Restore |
As propriedades do serviço blob para a política de restauro de blobs |
Sku |
O SKU da conta de armazenamento. |
Sku |
O nome do SKU. Necessário para a criação da conta; opcional para atualização. Tenha em atenção que em versões mais antigas, o nome do SKU chamava-se accountType. |
Sku |
O escalão de SKU. Isto baseia-se no nome do SKU. |
AllowedMethods
Necessário se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que podem ser executados pela origem.
Name | Tipo | Description |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
BlobServiceProperties
As propriedades do serviço Blob de uma conta de armazenamento.
Name | Tipo | Description |
---|---|---|
id |
string |
ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
O nome do recurso |
properties.automaticSnapshotPolicyEnabled |
boolean |
Preterido a favor da propriedade isVersioningEnabled. |
properties.changeFeed |
As propriedades do serviço blob para eventos do feed de alterações. |
|
properties.containerDeleteRetentionPolicy |
As propriedades do serviço blob para a eliminação recuperável do contentor. |
|
properties.cors |
Especifica regras CORS para o serviço Blob. Pode incluir até cinco elementos CorsRule no pedido. Se não forem incluídos elementos CorsRule no corpo do pedido, todas as regras 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 para o serviço Blob se a versão de um pedido recebido 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 a eliminação recuperável de blobs. |
|
properties.isVersioningEnabled |
boolean |
O controlo de versões é ativado se estiver definido como verdadeiro. |
properties.lastAccessTimeTrackingPolicy |
A propriedade do serviço blob para configurar a política de controlo baseada na hora do último acesso. |
|
properties.restorePolicy |
As propriedades do serviço blob para a política de restauro de blobs. |
|
sku |
Nome e escalão do SKU. |
|
type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
BlobServicesName
O nome do Serviço blob na conta de armazenamento especificada. O Nome do Serviço blob tem de ser "predefinido"
Name | Tipo | Description |
---|---|---|
default |
string |
ChangeFeed
As propriedades do serviço blob para eventos do feed de alterações.
Name | Tipo | Description |
---|---|---|
enabled |
boolean |
Indica se o registo de eventos do feed de alterações está ativado 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 uma regra CORS para o serviço Blob.
Name | Tipo | Description |
---|---|---|
allowedHeaders |
string[] |
Necessário se o elemento CorsRule estiver presente. Uma lista de cabeçalhos permitidos para fazer parte do pedido de várias origens. |
allowedMethods |
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 através do 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 a clientes CORS. |
maxAgeInSeconds |
integer |
Necessário se o elemento CorsRule estiver presente. O número de segundos que o cliente/browser deve colocar em cache uma resposta de verificação prévia. |
CorsRules
Define as regras CORS. Pode incluir até cinco elementos CorsRule no pedido.
Name | Tipo | Description |
---|---|---|
corsRules |
Cors |
A Lista de regras CORS. Pode incluir até cinco elementos CorsRule no pedido. |
DeleteRetentionPolicy
As propriedades do serviço para eliminação recuperável.
Name | Tipo | Description |
---|---|---|
allowPermanentDelete |
boolean |
Esta propriedade quando definida como verdadeira permite a eliminação de versões e instantâneos de blobs eliminados de forma recuperável. Esta propriedade não pode ser utilizada na política de restauro de blobs. 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 item eliminado 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á ativado. |
LastAccessTimeTrackingPolicy
As propriedades do serviço blob para a política de controlo Baseada na hora do último acesso.
Name | Tipo | Description |
---|---|---|
blobType |
string[] |
Uma matriz de tipos de blobs suportados predefinidos. Apenas blockBlob é o valor suportado. Este campo é atualmente só de leitura |
enable |
boolean |
Quando definido como verdadeiro último acesso, o controlo baseado na hora é ativado. |
name |
Nome da política. O valor válido é AccessTimeTracking. Este campo é atualmente só de leitura |
|
trackingGranularityInDays |
integer |
O campo especifica a granularidade de controlo de objetos de blobs em dias, normalmente a frequência com que o objeto blob deve ser controlado. Atualmente, este campo é lido apenas com o valor como 1 |
name
Nome da política. O valor válido é AccessTimeTracking. Este campo é atualmente só de leitura
Name | Tipo | Description |
---|---|---|
AccessTimeTracking |
string |
RestorePolicyProperties
As propriedades do serviço blob para a política de restauro de blobs
Name | Tipo | Description |
---|---|---|
days |
integer |
durante quanto tempo este blob pode ser restaurado. Deve ser excelente do que zero e inferior a DeleteRetentionPolicy.days. |
enabled |
boolean |
O restauro de blobs é ativado se estiver definido como verdadeiro. |
lastEnabledTime |
string |
Preterido a favor da propriedade minRestoreTime. |
minRestoreTime |
string |
Devolve a data e hora mínimas em que o restauro pode ser iniciado. |
Sku
O SKU da conta de armazenamento.
Name | Tipo | Description |
---|---|---|
name |
O nome do SKU. Necessário para a criação da conta; opcional para atualização. Tenha em atenção que em versões mais antigas, o nome do SKU chamava-se accountType. |
|
tier |
O escalão de SKU. Isto baseia-se no nome do SKU. |
SkuName
O nome do SKU. Necessário para a criação da conta; opcional para atualização. Tenha em atenção que em versões mais antigas, o nome do SKU chamava-se accountType.
Name | Tipo | 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 escalão de SKU. Isto baseia-se no nome do SKU.
Name | Tipo | Description |
---|---|---|
Premium |
string |
|
Standard |
string |