Поделиться через


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-объектов должно быть "по умолчанию"

resourceGroupName
path True

string

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

Имя группы ресурсов в подписке пользователя. Имя не зависит от регистра.

subscriptionId
path True

string

minLength: 1

Идентификатор целевой подписки.

api-version
query True

string

minLength: 1

Версия API, используемая для данной операции.

Текст запроса

Имя Тип Описание
properties.automaticSnapshotPolicyEnabled

boolean

Не рекомендуется использовать свойство isVersioningEnabled.

properties.changeFeed

ChangeFeed

Свойства службы BLOB-объектов для событий канала изменений.

properties.containerDeleteRetentionPolicy

DeleteRetentionPolicy

Свойства службы BLOB-объектов для обратимого удаления контейнера.

properties.cors

CorsRules

Задает правила CORS для службы BLOB-объектов. В запрос можно включить до пяти элементов CorsRule. Если элементы CorsRule не включены в текст запроса, все правила CORS будут удалены, и CORS будет отключен для службы BLOB-объектов.

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

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: 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-объектов должно быть "по умолчанию"

ChangeFeed

Свойства службы BLOB-объектов для событий канала изменений.

CorsRule

Задает правило CORS для службы BLOB-объектов.

CorsRules

Задает правила CORS. В запрос можно включить до пяти элементов CorsRule.

DeleteRetentionPolicy

Свойства службы для обратимого удаления.

LastAccessTimeTrackingPolicy

Свойства службы BLOB-объектов для политики отслеживания на основе времени последнего доступа.

name

Имя политики. Допустимое значение — AccessTimeTracking. Это поле в настоящее время доступно только для чтения

RestorePolicyProperties

Свойства службы BLOB-объектов для политики восстановления BLOB-объектов

Sku

Номер SKU учетной записи хранения.

SkuName

Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType.

SkuTier

Уровень SKU. Это основано на имени SKU.

AllowedMethods

Требуется, если элемент CorsRule присутствует. Список методов HTTP, которые могут выполняться источником.

Значение Описание
DELETE
GET
HEAD
MERGE
POST
OPTIONS
PUT
PATCH
CONNECT
TRACE

BlobServiceProperties

Свойства службы BLOB-объектов учетной записи хранения.

Имя Тип Описание
id

string

Полный идентификатор ресурса для ресурса. 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

Задает правила CORS для службы BLOB-объектов. В запрос можно включить до пяти элементов CorsRule. Если элементы CorsRule не включены в текст запроса, все правила CORS будут удалены, и CORS будет отключен для службы BLOB-объектов.

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

ChangeFeed

Свойства службы BLOB-объектов для событий канала изменений.

Имя Тип Описание
enabled

boolean

Указывает, включена ли ведение журнала событий канала изменений для службы BLOB-объектов.

retentionInDays

integer (int32)

minimum: 1
maximum: 146000

Указывает длительность хранения changeFeed в днях. Минимальное значение равно 1 день и максимальное значение — 146000 дней (400 лет). Значение NULL означает бесконечное хранение канала изменений.

CorsRule

Задает правило CORS для службы BLOB-объектов.

Имя Тип Описание
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-объектов и не применяется к контейнерам или общей папке.

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-объектов в днях, как правило, частоту отслеживания объекта БОЛЬШОго двоичного объекта. Это поле в настоящее время считывается только со значением 1

name

Имя политики. Допустимое значение — AccessTimeTracking. Это поле в настоящее время доступно только для чтения

Значение Описание
AccessTimeTracking

RestorePolicyProperties

Свойства службы BLOB-объектов для политики восстановления BLOB-объектов

Имя Тип Описание
days

integer

minimum: 1
maximum: 365

как долго этот большой двоичный объект можно восстановить. Оно должно быть больше нуля и меньше, чем DeleteRetentionPolicy.days.

enabled

boolean

Восстановление BLOB-объектов включено, если задано значение true.

lastEnabledTime

string (date-time)

Не рекомендуется использовать свойство minRestoreTime.

minRestoreTime

string (date-time)

Возвращает минимальную дату и время запуска восстановления.

Sku

Номер SKU учетной записи хранения.

Имя Тип Описание
name

SkuName

Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType.

tier

SkuTier

Уровень SKU. Это основано на имени SKU.

SkuName

Имя номера SKU. Требуется для создания учетной записи; необязательно для обновления. Обратите внимание, что в более ранних версиях имя SKU было названо accountType.

Значение Описание
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

Уровень SKU. Это основано на имени SKU.

Значение Описание
Standard
Premium