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

Операции задачи хранилища

  • Статья

Задача хранилища содержит набор условий и операций. Операция — это действие, выполняемое задачей хранения для каждого объекта, соответствующего требованиям каждого условия. В этой статье описывается формат JSON операции задачи хранения. Понимание этого формата важно, если вы планируете создать задачу хранения с помощью средства, отличного от портал Azure (например, Azure PowerShell или Azure CLI). В этой статье также перечислены операции, параметры операции и допустимые значения каждого параметра.

В этой статье рассматриваются операции. Дополнительные сведения об условиях см. в разделе "Условия задачи хранилища".

Внимание

служба хранилища Azure Действия в настоящее время находятся в предварительной версии и доступны в этих регионах. Юридические условия, применимые к функциям Azure, которые находятся в состоянии бета-версии, предварительной версии или иным образом еще не выпущены в общедоступной версии, см. на странице Дополнительные условия использования предварительных версий в Microsoft Azure.

Формат операции

Операция имеет имя, а также ноль, один или несколько параметров. На следующем рисунке показано, как эти элементы отображаются для операции в шаблоне JSON задачи хранения.

Схема, показывающая формат операции.

Каждый из элементов описан в таблице ниже.

Элемент Description
name Имя операции.1
parameters Коллекция одного или нескольких параметров. Каждый параметр имеет имя параметра и значение параметра.1
onSuccess Действие, выполняемое при успешном выполнении операции для объекта. continue является единственным допустимым значением во время предварительной версии.
onFailure Действие, выполняемое при сбое операции для объекта. break является единственным допустимым значением во время предварительной версии.

1 Полный список имен операций, параметров операции и значений параметров см. в разделе "Поддерживаемые операции " этой статьи.

Следующая операция применяет политику неизменяемости на основе времени к объекту.

{
    "operations": [
        {
            "name": "SetBlobImmutabilityPolicy",
            "parameters": {
                "untilDate": "2024-11-15T21:54:22",
                "mode": "locked"
            },
            "onSuccess": "continue",
            "onFailure": "break"
        }
    ]
}

Несколько операций

Разделение нескольких операций с помощью запятой. На следующем рисунке показана позиция двух операций в списке операций.

Схема, показывающая формат двух операций.

В следующем формате JSON показаны две операции, разделенные запятыми.

"operations": [
    {
        "name": "SetBlobImmutabilityPolicy",
        "parameters": {
            "untilDate": "2024-11-15T21:54:22",
            "mode": "locked"
        },
        "onSuccess": "continue",
        "onFailure": "break"
    },
    {
        "name": "SetBlobTags",
        "parameters": {
            "ImmutabilityUpdatedBy": "contosoStorageTask"
        },
        "onSuccess": "continue",
        "onFailure": "break"
    }
]

Поддерживаемые операции

В следующей таблице показаны поддерживаемые операции, параметры и значения параметров:

Операция Параметры Значения
SetBlobTier tier Горячий | Холодный | Архив
SetBlobExpiry expiryTime, expiryOption (срок действия): количество миллисекундах
(срок действия). Absolute | NeverExpire | RelativeToCreation | RelativeToNow
DeleteBlob нет нет
Отмена leteBlob нет нет
SetBlobTags Имятега 1 Значение тега
SetBlobImmutabilityPolicy untilDate, mode (до момента окончания политики): DateTime

(режим): заблокирован | Разблокирован
SetBlobLegalHold legalHold true | ложный

1 Имя этого параметра — это имя тега.

См. также