你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Blob Services - Set Service Properties

设置存储帐户的 Blob 服务的属性,包括存储分析和 CORS(跨域资源共享)规则的属性。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default?api-version=2024-01-01

URI 参数

名称 必需 类型 说明
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

BlobServicesName
path True

BlobServicesName

指定存储帐户中的 Blob 服务的名称。 Blob 服务名称必须为“default”

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

用户订阅中的资源组的名称。 此名称不区分大小写。

subscriptionId
path True

string

minLength: 1

目标订阅的 ID。

api-version
query True

string

minLength: 1

用于此操作的 API 版本。

请求正文

名称 类型 说明
properties.automaticSnapshotPolicyEnabled

boolean

弃用支持 isVersioningEnabled 属性。

properties.changeFeed

ChangeFeed

更改源事件的 Blob 服务属性。

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

容器软删除的 Blob 服务属性。

properties.cors

CorsRules

指定 Blob 服务的 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。 如果请求正文中不包含 CorsRule 元素,将删除所有 CORS 规则,并且将禁用 Blob 服务的 CORS。

properties.defaultServiceVersion

string

如果未指定传入请求的版本,则 DefaultServiceVersion 指示用于对 Blob 服务的请求的默认版本。 可能的值包括版本 2008-10-27 和所有较新版本。

properties.deleteRetentionPolicy

DeleteRetentionPolicy

Blob 软删除的 Blob 服务属性。

properties.isVersioningEnabled

boolean

如果设置为 true,则启用版本控制。

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

用于配置基于上次访问时间的跟踪策略的 Blob 服务属性。

properties.restorePolicy

RestorePolicyProperties

Blob 还原策略的 Blob 服务属性。

响应

名称 类型 说明
200 OK

BlobServiceProperties

确定 - 成功设置存储帐户的 Blob 服务的属性。

安全性

azure_auth

Azure Active Directory OAuth2 流

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称 说明
user_impersonation 模拟用户帐户

示例

BlobServicesPutAllowPermanentDelete
BlobServicesPutLastAccessTimeBasedTracking
PutBlobServices

BlobServicesPutAllowPermanentDelete

示例请求

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2024-01-01

{
  "properties": {
    "deleteRetentionPolicy": {
      "enabled": true,
      "days": 300,
      "allowPermanentDelete": true
    },
    "isVersioningEnabled": true
  }
}

示例响应

{
  "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

示例请求

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2024-01-01

{
  "properties": {
    "lastAccessTimeTrackingPolicy": {
      "enable": true,
      "name": "AccessTimeTracking",
      "trackingGranularityInDays": 1,
      "blobType": [
        "blockBlob"
      ]
    }
  }
}

示例响应

{
  "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

示例请求

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/blobServices/default?api-version=2024-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
    }
  }
}

示例响应

{
  "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"
  }
}

定义

名称 说明
AllowedMethods

如果存在 CorsRule 元素,则为必需。 源允许执行的 HTTP 方法的列表。

BlobServiceProperties

存储帐户的 Blob 服务的属性。

BlobServicesName

指定存储帐户中的 Blob 服务的名称。 Blob 服务名称必须为“default”

ChangeFeed

更改源事件的 Blob 服务属性。

CorsRule

指定 Blob 服务的 CORS 规则。

CorsRules

设置 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。

DeleteRetentionPolicy

软删除的服务属性。

LastAccessTimeTrackingPolicy

基于上次访问时间的跟踪策略的 Blob 服务属性。

name

策略的名称。 有效值为 AccessTimeTracking。 此字段当前为只读

RestorePolicyProperties

Blob 还原策略的 Blob 服务属性

Sku

存储帐户的 SKU。

SkuName

SKU 名称。 创建帐户时需要;可选,用于更新。 请注意,在旧版本中,SKU 名称称为 accountType。

SkuTier

SKU 层。 这基于 SKU 名称。

AllowedMethods

如果存在 CorsRule 元素,则为必需。 源允许执行的 HTTP 方法的列表。

说明
CONNECT
DELETE
GET
HEAD
MERGE
OPTIONS
PATCH
POST
PUT
TRACE

BlobServiceProperties

存储帐户的 Blob 服务的属性。

名称 类型 说明
id

string

资源的完全限定资源 ID。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

资源的名称

properties.automaticSnapshotPolicyEnabled

boolean

弃用支持 isVersioningEnabled 属性。

properties.changeFeed

ChangeFeed

更改源事件的 Blob 服务属性。

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

容器软删除的 Blob 服务属性。

properties.cors

CorsRules

指定 Blob 服务的 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。 如果请求正文中不包含 CorsRule 元素,将删除所有 CORS 规则,并且将禁用 Blob 服务的 CORS。

properties.defaultServiceVersion

string

如果未指定传入请求的版本,则 DefaultServiceVersion 指示用于对 Blob 服务的请求的默认版本。 可能的值包括版本 2008-10-27 和所有较新版本。

properties.deleteRetentionPolicy

DeleteRetentionPolicy

Blob 软删除的 Blob 服务属性。

properties.isVersioningEnabled

boolean

如果设置为 true,则启用版本控制。

properties.lastAccessTimeTrackingPolicy

LastAccessTimeTrackingPolicy

用于配置基于上次访问时间的跟踪策略的 Blob 服务属性。

properties.restorePolicy

RestorePolicyProperties

Blob 还原策略的 Blob 服务属性。

sku

Sku

Sku 名称和层。

type

string

资源的类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

BlobServicesName

指定存储帐户中的 Blob 服务的名称。 Blob 服务名称必须为“default”

说明
default

ChangeFeed

更改源事件的 Blob 服务属性。

名称 类型 说明
enabled

boolean

指示是否为 Blob 服务启用了更改源事件日志记录。

retentionInDays

integer (int32)

minimum: 1
maximum: 146000

指示 changeFeed 保留期(以天为单位)。 最小值为 1 天,最大值为 146000 天(400 年)。 null 值表示更改源的无限保留期。

CorsRule

指定 Blob 服务的 CORS 规则。

名称 类型 说明
allowedHeaders

string[]

如果存在 CorsRule 元素,则为必需。 允许作为跨域请求的一部分的标头列表。

allowedMethods

AllowedMethods[]

如果存在 CorsRule 元素,则为必需。 源允许执行的 HTTP 方法的列表。

allowedOrigins

string[]

如果存在 CorsRule 元素,则为必需。 将允许通过 CORS 或“*”允许所有域的源域列表

exposedHeaders

string[]

如果存在 CorsRule 元素,则为必需。 要向 CORS 客户端公开的响应标头列表。

maxAgeInSeconds

integer

如果存在 CorsRule 元素,则为必需。 客户端/浏览器应缓存预检响应的秒数。

CorsRules

设置 CORS 规则。 请求中最多可以包含五个 CorsRule 元素。

名称 类型 说明
corsRules

CorsRule[]

CORS 规则列表。 请求中最多可以包含五个 CorsRule 元素。

DeleteRetentionPolicy

软删除的服务属性。

名称 类型 说明
allowPermanentDelete

boolean

如果设置为 true,则此属性允许删除软删除的 Blob 版本和快照。 此属性不能使用 Blob 还原策略。 此属性仅适用于 Blob 服务,不适用于容器或文件共享。

days

integer

minimum: 1
maximum: 365

指示应保留已删除项的天数。 最小指定值可以是 1,最大值可以为 365。

enabled

boolean

指示是否启用 DeleteRetentionPolicy。

LastAccessTimeTrackingPolicy

基于上次访问时间的跟踪策略的 Blob 服务属性。

名称 类型 说明
blobType

string[]

预定义支持的 Blob 类型的数组。 仅 blockBlob 是受支持的值。 此字段当前为只读

enable

boolean

如果设置为 true,则启用基于上次访问时间的跟踪。

name

name

策略的名称。 有效值为 AccessTimeTracking。 此字段当前为只读

trackingGranularityInDays

integer (int32)

该字段指定 Blob 对象跟踪粒度(以天为单位),通常应跟踪 Blob 对象的频率。此字段当前为 1 的只读

name

策略的名称。 有效值为 AccessTimeTracking。 此字段当前为只读

说明
AccessTimeTracking

RestorePolicyProperties

Blob 还原策略的 Blob 服务属性

名称 类型 说明
days

integer

minimum: 1
maximum: 365

可以还原此 Blob 的时长。 它应大于零且小于 DeleteRetentionPolicy.days。

enabled

boolean

如果设置为 true,则启用 Blob 还原。

lastEnabledTime

string (date-time)

弃用了 minRestoreTime 属性。

minRestoreTime

string (date-time)

返回可以启动还原的最小日期和时间。

Sku

存储帐户的 SKU。

名称 类型 说明
name

SkuName

SKU 名称。 创建帐户时需要;可选,用于更新。 请注意,在旧版本中,SKU 名称称为 accountType。

tier

SkuTier

SKU 层。 这基于 SKU 名称。

SkuName

SKU 名称。 创建帐户时需要;可选,用于更新。 请注意,在旧版本中,SKU 名称称为 accountType。

说明
PremiumV2_LRS
PremiumV2_ZRS
Premium_LRS
Premium_ZRS
StandardV2_GRS
StandardV2_GZRS
StandardV2_LRS
StandardV2_ZRS
Standard_GRS
Standard_GZRS
Standard_LRS
Standard_RAGRS
Standard_RAGZRS
Standard_ZRS

SkuTier

SKU 层。 这基于 SKU 名称。

说明
Premium
Standard