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 pour les 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=2023-01-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
account
|
path | True |
string |
Nom du compte de stockage au sein du groupe de ressources spécifié. Ce nom doit comprendre entre 3 et 24 caractères, uniquement des lettres en minuscules et des nombres. Regex pattern: |
Blob
|
path | True |
Nom du service blob dans le compte de stockage spécifié. Le nom du service Blob doit être « par défaut » |
|
resource
|
path | True |
string |
Nom du groupe de ressources dans l’abonnement de l’utilisateur. Le nom ne respecte pas la casse. Regex pattern: |
subscription
|
path | True |
string |
ID de l’abonnement cible. |
api-version
|
query | True |
string |
Version de l’API à utiliser pour cette opération. |
Corps de la demande
Nom | Type | Description |
---|---|---|
properties.automaticSnapshotPolicyEnabled |
boolean |
Déconseillé au profit 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. Incluez 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 sont supprimées, et les règles CORS sont désactivées pour le service BLOB. |
|
properties.defaultServiceVersion |
string |
DefaultServiceVersion indique la version par défaut à utiliser pour les demandes au service BLOB si une version de demande entrante n'est pas indiquée. Les valeurs possibles comprennent la version du 27/10/2008 et les versions les 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é s’il est défini sur true. |
properties.lastAccessTimeTrackingPolicy |
Propriété de service blob pour configurer la stratégie de suivi basée sur le temps de 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 |
OK : définit les propriétés du service Blob d’un compte de stockage. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nom | Description |
---|---|
user_impersonation | Emprunter l’identité de votre compte d’utilisateur |
Exemples
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"
}
}
Définitions
Nom | Description |
---|---|
Allowed |
Obligatoire si l'élément CorsRule est présent. Liste des méthodes HTTP autorisées à être exécutées par l’origine. |
Blob |
Propriétés du service Blob d’un compte de stockage. |
Blob |
Nom du service blob dans le compte de stockage spécifié. Le nom du service Blob doit être « par défaut » |
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. Incluez jusqu'à cinq éléments CorsRule dans la requête. |
Delete |
Propriétés de service pour la suppression réversible. |
Last |
Propriétés du service blob pour la stratégie de suivi basée sur le temps du dernier accès. |
name |
Nom de la stratégie. La valeur valide est AccessTimeTracking. Ce champ est actuellement en lecture seule |
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 |
Le nom du 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 était appelé accountType. |
Sku |
Niveau de référence SKU. Cela est basé sur le nom de la référence SKU. |
AllowedMethods
Obligatoire si l'élément CorsRule est présent. Liste des méthodes HTTP autorisées à être exécutées par l’origine.
Nom | Type | Description |
---|---|---|
CONNECT |
string |
|
DELETE |
string |
|
GET |
string |
|
HEAD |
string |
|
MERGE |
string |
|
OPTIONS |
string |
|
PATCH |
string |
|
POST |
string |
|
PUT |
string |
|
TRACE |
string |
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é au profit 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. Incluez 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 sont supprimées, et les règles CORS sont désactivées pour le service BLOB. |
|
properties.defaultServiceVersion |
string |
DefaultServiceVersion indique la version par défaut à utiliser pour les demandes au service BLOB si une version de demande entrante n'est pas indiquée. Les valeurs possibles comprennent la version du 27/10/2008 et les versions les 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é s’il est défini sur true. |
properties.lastAccessTimeTrackingPolicy |
Propriété de service blob pour configurer la stratégie de suivi basée sur le temps de 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 SKU. |
|
type |
string |
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts » |
BlobServicesName
Nom du service blob dans le compte de stockage spécifié. Le nom du service Blob doit être « par défaut »
Nom | Type | Description |
---|---|---|
default |
string |
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 |
Indique la durée de la rétention de changeFeed en jours. La valeur minimale est 1 jour et la valeur maximale est de 146 000 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 d’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 d’en-têtes de réponse à exposer aux clients CORS. |
maxAgeInSeconds |
integer |
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. Incluez jusqu'à cinq éléments CorsRule dans la requête.
Nom | Type | Description |
---|---|---|
corsRules |
Cors |
Liste des règles CORS. Incluez jusqu'à cinq éléments CorsRule dans la requête. |
DeleteRetentionPolicy
Propriétés de service pour la suppression réversible.
Nom | Type | Description |
---|---|---|
allowPermanentDelete |
boolean |
Cette propriété, lorsqu’elle est définie sur true, permet la suppression des versions et des instantanés d’objets blob supprimés de manière réversible. Cette propriété ne peut pas être utilisée stratégie de restauration d’objets blob. Cette propriété s’applique uniquement au service blob et ne s’applique pas aux conteneurs ou aux partages de fichiers. |
days |
integer |
Indique le nombre de jours pendant lesquels l’élément supprimé doit être conservé. La valeur minimale spécifiée peut être 1 et la valeur maximale peut être 365. |
enabled |
boolean |
Indique si DeleteRetentionPolicy est activé. |
LastAccessTimeTrackingPolicy
Propriétés du service blob pour la stratégie de suivi basée sur le temps du dernier accès.
Nom | Type | Description |
---|---|---|
blobType |
string[] |
Tableau de types d’objets blob prédéfinis pris en charge. Seule blockBlob est la valeur prise en charge. Ce champ est actuellement en lecture seule |
enable |
boolean |
Lorsqu’il est défini sur true, le suivi basé sur l’heure du dernier accès est activé. |
name |
Nom de la stratégie. La valeur valide est AccessTimeTracking. Ce champ est actuellement en lecture seule |
|
trackingGranularityInDays |
integer |
Le champ spécifie la granularité du suivi des objets blob en jours, généralement la fréquence à laquelle l’objet blob doit être suivi. Ce champ est actuellement en lecture seule avec la valeur 1 |
name
Nom de la stratégie. La valeur valide est AccessTimeTracking. Ce champ est actuellement en lecture seule
Nom | Type | Description |
---|---|---|
AccessTimeTracking |
string |
RestorePolicyProperties
Propriétés du service blob pour la stratégie de restauration d’objets blob
Nom | Type | Description |
---|---|---|
days |
integer |
la 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 |
Déconseillé au profit de la propriété minRestoreTime. |
minRestoreTime |
string |
Retourne la date et l’heure minimales de démarrage de la restauration. |
Sku
Référence SKU du compte de stockage.
Nom | Type | Description |
---|---|---|
name |
Le nom du 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 était appelé accountType. |
|
tier |
Niveau de référence SKU. Cela est basé sur le nom de la référence SKU. |
SkuName
Le nom du 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 était appelé accountType.
Nom | Type | 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
Niveau de référence SKU. Cela est basé sur le nom de la référence SKU.
Nom | Type | Description |
---|---|---|
Premium |
string |
|
Standard |
string |