Blob Services - Set Service Properties
Définit les propriétés du service Blob d’un compte de stockage, y compris les propriétés des règles Storage Analytics et 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
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-z0-9]+$ |
Nom du compte de stockage dans le groupe de ressources spécifié. Ce nom doit comprendre entre 3 et 24 caractères, uniquement des lettres en minuscules et des nombres. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
subscription
|
path | True |
string (uuid) |
ID de l’abonnement cible. La valeur doit être un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Version de l’API à utiliser pour cette opération. |
Corps de la demande
| Nom | Type | Description |
|---|---|---|
| properties.automaticSnapshotPolicyEnabled |
boolean |
Déconseillé en faveur de la propriété isVersioningEnabled. |
| properties.changeFeed |
Propriétés du service blob pour les événements de flux de modification. |
|
| properties.containerDeleteRetentionPolicy |
Propriétés du service blob pour la suppression réversible de conteneur. |
|
| properties.cors |
Spécifie les règles CORS pour le service Blob. Vous pouvez inclure jusqu’à cinq éléments CorsRule dans la requête. Si aucun élément CorsRule n’est inclus dans le corps de la requête, toutes les règles CORS seront supprimées et CORS sera désactivée pour le service Blob. |
|
| properties.defaultServiceVersion |
string |
DefaultServiceVersion indique la version par défaut à utiliser pour les demandes adressées au service Blob si la version d’une requête entrante n’est pas spécifiée. Les valeurs possibles incluent la version 2008-10-27 et toutes les versions plus récentes. |
| properties.deleteRetentionPolicy |
Propriétés du service blob pour la suppression réversible d’objets blob. |
|
| properties.isVersioningEnabled |
boolean |
Le contrôle de version est activé si la valeur est true. |
| properties.lastAccessTimeTrackingPolicy |
Propriété du service blob pour configurer la stratégie de suivi basée sur le dernier accès. |
|
| properties.restorePolicy |
Propriétés du service blob pour la stratégie de restauration d’objets blob. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Opération de mise à jour de la ressource 'BlobServiceProperties' réussie |
|
| Other Status Codes |
Réponse d’erreur inattendue. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom | Description |
|---|---|
| user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
|
Blob |
|
Blob |
|
Put |
BlobServicesPutAllowPermanentDelete
Exemple de requête
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
}
}
Exemple de réponse
{
"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
Exemple de requête
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
}
}
}
Exemple de réponse
{
"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
Exemple de requête
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
}
}
Exemple de réponse
{
"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"
}
}
Définitions
| Nom | Description |
|---|---|
|
Allowed |
|
|
Blob |
Propriétés du service Blob d’un compte de stockage. |
|
Change |
Propriétés du service blob pour les événements de flux de modification. |
|
Cors |
Spécifie une règle CORS pour le service Blob. |
|
Cors |
Définit les règles CORS. Vous pouvez inclure jusqu’à cinq éléments CorsRule dans la requête. |
|
Delete |
Propriétés du service pour la suppression réversible. |
|
Error |
Réponse d’erreur du fournisseur de ressources de stockage. |
|
Error |
Contrat du corps de la réponse d’erreur. |
|
Last |
Propriétés du service blob pour la stratégie de suivi basée sur le dernier accès. |
| Name |
Nom de la stratégie. La valeur valide est AccessTimeTracking. Ce champ est actuellement lu uniquement |
|
Restore |
Propriétés du service blob pour la stratégie de restauration d’objets blob |
| Sku |
Référence SKU du compte de stockage. |
|
Sku |
Nom de la référence SKU. Obligatoire pour la création de compte ; facultatif pour la mise à jour. Notez que dans les versions antérieures, le nom de la référence SKU a été appelé accountType. |
|
Sku |
Niveau de référence SKU. Cela est basé sur le nom de la référence SKU. |
AllowedMethods
| Valeur | Description |
|---|---|
| DELETE | |
| GET | |
| HEAD | |
| MERGE | |
| POST | |
| OPTIONS | |
| PUT | |
| PATCH | |
| CONNECT | |
| TRACE |
BlobServiceProperties
Propriétés du service Blob d’un compte de stockage.
| Nom | Type | Description |
|---|---|---|
| id |
string |
ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
Nom de la ressource |
| properties.automaticSnapshotPolicyEnabled |
boolean |
Déconseillé en faveur de la propriété isVersioningEnabled. |
| properties.changeFeed |
Propriétés du service blob pour les événements de flux de modification. |
|
| properties.containerDeleteRetentionPolicy |
Propriétés du service blob pour la suppression réversible de conteneur. |
|
| properties.cors |
Spécifie les règles CORS pour le service Blob. Vous pouvez inclure jusqu’à cinq éléments CorsRule dans la requête. Si aucun élément CorsRule n’est inclus dans le corps de la requête, toutes les règles CORS seront supprimées et CORS sera désactivée pour le service Blob. |
|
| properties.defaultServiceVersion |
string |
DefaultServiceVersion indique la version par défaut à utiliser pour les demandes adressées au service Blob si la version d’une requête entrante n’est pas spécifiée. Les valeurs possibles incluent la version 2008-10-27 et toutes les versions plus récentes. |
| properties.deleteRetentionPolicy |
Propriétés du service blob pour la suppression réversible d’objets blob. |
|
| properties.isVersioningEnabled |
boolean |
Le contrôle de version est activé si la valeur est true. |
| properties.lastAccessTimeTrackingPolicy |
Propriété du service blob pour configurer la stratégie de suivi basée sur le dernier accès. |
|
| properties.restorePolicy |
Propriétés du service blob pour la stratégie de restauration d’objets blob. |
|
| sku |
Nom et niveau de la référence. |
|
| type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
ChangeFeed
Propriétés du service blob pour les événements de flux de modification.
| Nom | Type | Description |
|---|---|---|
| enabled |
boolean |
Indique si la journalisation des événements de flux de modification est activée pour le service Blob. |
| retentionInDays |
integer (int32) minimum: 1maximum: 146000 |
Indique la durée de rétention changeFeed en jours. La valeur minimale est 1 jour et la valeur maximale est de 146000 jours (400 ans). Une valeur Null indique une rétention infinie du flux de modification. |
CorsRule
Spécifie une règle CORS pour le service Blob.
| Nom | Type | Description |
|---|---|---|
| allowedHeaders |
string[] |
Obligatoire si l’élément CorsRule est présent. Liste des en-têtes autorisés à faire partie de la demande d’origine croisée. |
| allowedMethods |
Obligatoire si l’élément CorsRule est présent. Liste des méthodes HTTP autorisées à être exécutées par l’origine. |
|
| allowedOrigins |
string[] |
Obligatoire si l’élément CorsRule est présent. Liste des domaines d’origine qui seront autorisés via CORS ou « * » pour autoriser tous les domaines |
| exposedHeaders |
string[] |
Obligatoire si l’élément CorsRule est présent. Liste des en-têtes de réponse à exposer aux clients CORS. |
| maxAgeInSeconds |
integer (int32) |
Obligatoire si l’élément CorsRule est présent. Nombre de secondes pendant lesquelles le client/navigateur doit mettre en cache une réponse préliminaire. |
CorsRules
Définit les règles CORS. Vous pouvez inclure jusqu’à cinq éléments CorsRule dans la requête.
| Nom | Type | Description |
|---|---|---|
| corsRules |
Cors |
Liste des règles CORS. Vous pouvez inclure jusqu’à cinq éléments CorsRule dans la requête. |
DeleteRetentionPolicy
Propriétés du service pour la suppression réversible.
| Nom | Type | Description |
|---|---|---|
| allowPermanentDelete |
boolean |
Cette propriété lorsqu’elle est définie sur true autorise la suppression des versions et instantanés d’objets blob supprimés de manière réversible. Cette propriété ne peut pas être utilisée pour la stratégie de restauration d’objets blob. Cette propriété s’applique uniquement au service d’objets blob et ne s’applique pas aux conteneurs ou au partage de fichiers. |
| days |
integer (int32) minimum: 1maximum: 365 |
Indique le nombre de jours pendant lesquels l’élément supprimé doit être conservé. La valeur spécifiée minimale peut être 1 et la valeur maximale peut être 365. |
| enabled |
boolean |
Indique si DeleteRetentionPolicy est activé. |
ErrorResponse
Réponse d’erreur du fournisseur de ressources de stockage.
| Nom | Type | Description |
|---|---|---|
| error |
Corps de la réponse d’erreur du fournisseur de ressources de stockage Azure. |
ErrorResponseBody
Contrat du corps de la réponse d’erreur.
| Nom | Type | Description |
|---|---|---|
| code |
string |
Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme. |
| message |
string |
Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur. |
LastAccessTimeTrackingPolicy
Propriétés du service blob pour la stratégie de suivi basée sur le dernier accès.
| Nom | Type | Description |
|---|---|---|
| blobType |
string[] |
Tableau de types d’objets blob prédéfinis pris en charge. Seul blockBlob est la valeur prise en charge. Ce champ est actuellement lu uniquement |
| enable |
boolean |
Lorsque la valeur est true, le suivi basé sur l’heure d’accès est activé. |
| name |
Nom de la stratégie. La valeur valide est AccessTimeTracking. Ce champ est actuellement lu uniquement |
|
| trackingGranularityInDays |
integer (int32) |
Le champ spécifie la granularité de suivi des objets blob en jours, généralement la fréquence à laquelle l’objet blob doit être suivi. Ce champ est actuellement lu uniquement avec la valeur 1 |
Name
Nom de la stratégie. La valeur valide est AccessTimeTracking. Ce champ est actuellement lu uniquement
| Valeur | Description |
|---|---|
| AccessTimeTracking |
RestorePolicyProperties
Propriétés du service blob pour la stratégie de restauration d’objets blob
| Nom | Type | Description |
|---|---|---|
| days |
integer (int32) minimum: 1maximum: 365 |
durée pendant laquelle cet objet blob peut être restauré. Elle doit être supérieure à zéro et inférieure à DeleteRetentionPolicy.days. |
| enabled |
boolean |
La restauration d’objets blob est activée si la valeur est true. |
| lastEnabledTime |
string (date-time) |
Obsolète au profit de la propriété minRestoreTime. |
| minRestoreTime |
string (date-time) |
Renvoie la date et l’heure minimales auxquelles la restauration peut être démarrée. |
Sku
Référence SKU du compte de stockage.
| Nom | Type | Description |
|---|---|---|
| name |
Nom de la référence SKU. Obligatoire pour la création de compte ; facultatif pour la mise à jour. Notez que dans les versions antérieures, le nom de la référence SKU a été appelé accountType. |
|
| tier |
Niveau de référence SKU. Cela est basé sur le nom de la référence SKU. |
SkuName
Nom de la référence SKU. Obligatoire pour la création de compte ; facultatif pour la mise à jour. Notez que dans les versions antérieures, le nom de la référence SKU a été appelé accountType.
| Valeur | 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
Niveau de référence SKU. Cela est basé sur le nom de la référence SKU.
| Valeur | Description |
|---|---|
| Standard | |
| Premium |