Partager via


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
accountName
path True

string

minLength: 3
maxLength: 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.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
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

ChangeFeed

Propriétés du service blob pour les événements de flux de modification.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

Propriétés du service blob pour la suppression réversible de conteneur.

properties.cors

CorsRules

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

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

LastAccessTimeTrackingPolicy

Propriété du service blob pour configurer la stratégie de suivi basée sur le dernier accès.

properties.restorePolicy

RestorePolicyProperties

Propriétés du service blob pour la stratégie de restauration d’objets blob.

Réponses

Nom Type Description
200 OK

BlobServiceProperties

Opération de mise à jour de la ressource 'BlobServiceProperties' réussie

Other Status Codes

ErrorResponse

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

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

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
AllowedMethods
BlobServiceProperties

Propriétés du service Blob d’un compte de stockage.

ChangeFeed

Propriétés du service blob pour les événements de flux de modification.

CorsRule

Spécifie une règle CORS pour le service Blob.

CorsRules

Définit les 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.

ErrorResponse

Réponse d’erreur du fournisseur de ressources de stockage.

ErrorResponseBody

Contrat du corps de la réponse d’erreur.

LastAccessTimeTrackingPolicy

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

RestorePolicyProperties

Propriétés du service blob pour la stratégie de restauration d’objets blob

Sku

Référence SKU du compte de stockage.

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.

SkuTier

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

ChangeFeed

Propriétés du service blob pour les événements de flux de modification.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

Propriétés du service blob pour la suppression réversible de conteneur.

properties.cors

CorsRules

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

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

LastAccessTimeTrackingPolicy

Propriété du service blob pour configurer la stratégie de suivi basée sur le dernier accès.

properties.restorePolicy

RestorePolicyProperties

Propriétés du service blob pour la stratégie de restauration d’objets blob.

sku

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: 1
maximum: 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

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

CorsRule[]

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: 1
maximum: 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

ErrorResponseBody

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

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: 1
maximum: 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

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.

tier

SkuTier

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