Blob Services - Set Service Properties
Imposta le proprietà del servizio BLOB di un account di archiviazione, incluse le proprietà per Analisi archiviazione e CORS (Cross-Origin Resource Sharing).
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2023-01-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
account
|
path | True |
string |
Nome dell'account di archiviazione all'interno del gruppo di risorse specificato. I nomi degli account di archiviazione devono essere di lunghezza compresa tra 3 e 24 caratteri e utilizzare solo numeri e lettere minuscole. Regex pattern: |
Blob
|
path | True |
Nome del servizio BLOB all'interno dell'account di archiviazione specificato. Il nome del servizio BLOB deve essere 'default' |
|
resource
|
path | True |
string |
Nome del gruppo di risorse all'interno della sottoscrizione dell'utente. Per il nome non viene fatta distinzione tra maiuscole e minuscole. Regex pattern: |
subscription
|
path | True |
string |
ID della sottoscrizione di destinazione. |
api-version
|
query | True |
string |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
properties.automaticSnapshotPolicyEnabled |
boolean |
Deprecato a favore della proprietà isVersioningEnabled. |
properties.changeFeed |
Proprietà del servizio BLOB per gli eventi del feed di modifiche. |
|
properties.containerDeleteRetentionPolicy |
Proprietà del servizio BLOB per l'eliminazione temporanea del contenitore. |
|
properties.cors |
Specifica le regole CORS per il servizio BLOB. È possibile includere fino a cinque elementi CorsRule nella richiesta. Se non sono inclusi elementi CorsRule nel corpo della richiesta, tutte le regole CORS verranno eliminate e CORS verrà disabilitata per il servizio BLOB. |
|
properties.defaultServiceVersion |
string |
DefaultServiceVersion indica la versione predefinita da usare per le richieste al servizio BLOB se non è specificata la versione di una richiesta in ingresso. I valori possibili includono la versione 2008-10-27 e tutte le versioni più recenti. |
properties.deleteRetentionPolicy |
Proprietà del servizio BLOB per l'eliminazione temporanea del BLOB. |
|
properties.isVersioningEnabled |
boolean |
Il controllo delle versioni è abilitato se impostato su true. |
properties.lastAccessTimeTrackingPolicy |
Proprietà del servizio BLOB per configurare i criteri di rilevamento basati sull'ultimo accesso. |
|
properties.restorePolicy |
Proprietà del servizio BLOB per i criteri di ripristino BLOB. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK - Imposta le proprietà del servizio BLOB di un account di archiviazione correttamente. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
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"
}
}
Definizioni
Nome | Descrizione |
---|---|
Allowed |
Obbligatorio se è presente l'elemento CorsRule. Elenco di metodi HTTP che possono essere eseguiti dall'origine. |
Blob |
Proprietà del servizio BLOB di un account di archiviazione. |
Blob |
Nome del servizio BLOB all'interno dell'account di archiviazione specificato. Il nome del servizio BLOB deve essere "predefinito" |
Change |
Proprietà del servizio BLOB per gli eventi del feed di modifiche. |
Cors |
Specifica una regola CORS per il servizio Blob. |
Cors |
Imposta le regole CORS. È possibile includere fino a cinque elementi CorsRule nella richiesta. |
Delete |
Proprietà del servizio per l'eliminazione temporanea. |
Last |
Proprietà del servizio BLOB per i criteri di rilevamento basati sull'ultimo accesso. |
name |
Nome dei criteri. Il valore valido è AccessTimeTracking. Questo campo è attualmente in lettura solo |
Restore |
Proprietà del servizio BLOB per i criteri di ripristino BLOB |
Sku |
SKU dell'account di archiviazione. |
Sku |
Nome SKU. Obbligatorio per la creazione dell'account; facoltativo per l'aggiornamento. Si noti che nelle versioni precedenti, il nome dello SKU è stato chiamato accountType. |
Sku |
Livello SKU. In base al nome dello SKU. |
AllowedMethods
Obbligatorio se è presente l'elemento CorsRule. Elenco di metodi HTTP che possono essere eseguiti dall'origine.
Nome | Tipo | Descrizione |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
BlobServiceProperties
Proprietà del servizio BLOB di un account di archiviazione.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
nome della risorsa. |
properties.automaticSnapshotPolicyEnabled |
boolean |
Deprecato a favore della proprietà isVersioningEnabled. |
properties.changeFeed |
Proprietà del servizio BLOB per gli eventi del feed di modifiche. |
|
properties.containerDeleteRetentionPolicy |
Proprietà del servizio BLOB per l'eliminazione temporanea del contenitore. |
|
properties.cors |
Specifica le regole CORS per il servizio BLOB. È possibile includere fino a cinque elementi CorsRule nella richiesta. Se non sono inclusi elementi CorsRule nel corpo della richiesta, tutte le regole CORS verranno eliminate e CORS verrà disabilitata per il servizio BLOB. |
|
properties.defaultServiceVersion |
string |
DefaultServiceVersion indica la versione predefinita da usare per le richieste al servizio BLOB se non è specificata la versione di una richiesta in ingresso. I valori possibili includono la versione 2008-10-27 e tutte le versioni più recenti. |
properties.deleteRetentionPolicy |
Proprietà del servizio BLOB per l'eliminazione temporanea del BLOB. |
|
properties.isVersioningEnabled |
boolean |
Il controllo delle versioni è abilitato se impostato su true. |
properties.lastAccessTimeTrackingPolicy |
Proprietà del servizio BLOB per configurare i criteri di rilevamento basati sull'ultimo accesso. |
|
properties.restorePolicy |
Proprietà del servizio BLOB per i criteri di ripristino BLOB. |
|
sku |
Nome sku e livello. |
|
type |
string |
Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
BlobServicesName
Nome del servizio BLOB all'interno dell'account di archiviazione specificato. Il nome del servizio BLOB deve essere "predefinito"
Nome | Tipo | Descrizione |
---|---|---|
default |
string |
ChangeFeed
Proprietà del servizio BLOB per gli eventi del feed di modifiche.
Nome | Tipo | Descrizione |
---|---|---|
enabled |
boolean |
Indica se la registrazione eventi del feed di modifiche è abilitata per il servizio BLOB. |
retentionInDays |
integer |
Indica la durata della conservazione modificafeed in giorni. Il valore minimo è 1 giorno e il valore massimo è 146000 giorni (400 anni). Un valore Null indica una conservazione infinita del feed di modifiche. |
CorsRule
Specifica una regola CORS per il servizio Blob.
Nome | Tipo | Descrizione |
---|---|---|
allowedHeaders |
string[] |
Obbligatorio se è presente l'elemento CorsRule. Elenco di intestazioni consentite per far parte della richiesta tra origini. |
allowedMethods |
Obbligatorio se è presente l'elemento CorsRule. Elenco di metodi HTTP che possono essere eseguiti dall'origine. |
|
allowedOrigins |
string[] |
Obbligatorio se è presente l'elemento CorsRule. Elenco di domini di origine che saranno consentiti tramite CORS o "*" per consentire a tutti i domini |
exposedHeaders |
string[] |
Obbligatorio se è presente l'elemento CorsRule. Elenco di intestazioni di risposta da esporre ai client CORS. |
maxAgeInSeconds |
integer |
Obbligatorio se è presente l'elemento CorsRule. Numero di secondi durante i quali il client/browser deve memorizzare nella cache una risposta preliminare. |
CorsRules
Imposta le regole CORS. È possibile includere fino a cinque elementi CorsRule nella richiesta.
Nome | Tipo | Descrizione |
---|---|---|
corsRules |
Cors |
Elenco delle regole CORS. È possibile includere fino a cinque elementi CorsRule nella richiesta. |
DeleteRetentionPolicy
Proprietà del servizio per l'eliminazione temporanea.
Nome | Tipo | Descrizione |
---|---|---|
allowPermanentDelete |
boolean |
Questa proprietà quando impostata su true consente l'eliminazione delle versioni e degli snapshot del BLOB eliminati temporanea. Questa proprietà non può essere usata dai criteri di ripristino BLOB. Questa proprietà si applica solo al servizio BLOB e non si applica ai contenitori o alla condivisione file. |
days |
integer |
Indica il numero di giorni che l'elemento eliminato deve essere mantenuto. Il valore minimo specificato può essere 1 e il valore massimo può essere 365. |
enabled |
boolean |
Indica se DeleteRetentionPolicy è abilitato. |
LastAccessTimeTrackingPolicy
Proprietà del servizio BLOB per i criteri di rilevamento basati sull'ultimo accesso.
Nome | Tipo | Descrizione |
---|---|---|
blobType |
string[] |
Matrice di tipi BLOB supportati predefiniti. Solo blockBlob è il valore supportato. Questo campo è attualmente in lettura solo |
enable |
boolean |
Se impostato su true l'ultima ora di accesso basata sul rilevamento basato su è abilitato. |
name |
Nome dei criteri. Il valore valido è AccessTimeTracking. Questo campo è attualmente in lettura solo |
|
trackingGranularityInDays |
integer |
Il campo specifica la granularità del rilevamento degli oggetti BLOB in giorni, in genere la frequenza con cui deve essere monitorato l'oggetto BLOB. Questo campo è attualmente in lettura solo con il valore 1 |
name
Nome dei criteri. Il valore valido è AccessTimeTracking. Questo campo è attualmente in lettura solo
Nome | Tipo | Descrizione |
---|---|---|
AccessTimeTracking |
string |
RestorePolicyProperties
Proprietà del servizio BLOB per i criteri di ripristino BLOB
Nome | Tipo | Descrizione |
---|---|---|
days |
integer |
quanto tempo può essere ripristinato questo BLOB. Dovrebbe essere grande di zero e minore di DeleteRetentionPolicy.days. |
enabled |
boolean |
Il ripristino BLOB è abilitato se impostato su true. |
lastEnabledTime |
string |
Deprecato a favore della proprietà minRestoreTime. |
minRestoreTime |
string |
Restituisce la data e l'ora minima di avvio del ripristino. |
Sku
SKU dell'account di archiviazione.
Nome | Tipo | Descrizione |
---|---|---|
name |
Nome SKU. Obbligatorio per la creazione dell'account; facoltativo per l'aggiornamento. Si noti che nelle versioni precedenti, il nome dello SKU è stato chiamato accountType. |
|
tier |
Livello SKU. In base al nome dello SKU. |
SkuName
Nome SKU. Obbligatorio per la creazione dell'account; facoltativo per l'aggiornamento. Si noti che nelle versioni precedenti, il nome dello SKU è stato chiamato accountType.
Nome | Tipo | Descrizione |
---|---|---|
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
Livello SKU. In base al nome dello SKU.
Nome | Tipo | Descrizione |
---|---|---|
Premium |
string |
|
Standard |
string |