스토리지 작업

스토리지 작업에는 조건 및 작업 집합이 포함됩니다. 작업은 스토리지 태스크가 각 조건의 요구 사항을 충족하는 각 개체에 대해 수행하는 작업입니다. 이 문서에서는 스토리지 작업 작업의 JSON 형식을 설명합니다. Azure Portal(예: Azure PowerShell 또는 Azure CLI) 이외의 도구를 사용하여 스토리지 작업을 만들려는 경우 해당 형식을 이해하는 것이 중요합니다. 또한 이 문서에서는 각 매개 변수의 작업, 작업 매개 변수 및 허용 가능한 값을 나열합니다.

이 문서에서는 작업에 중점을 둡니다. 조건에 대한 자세한 내용은 Storage 작업 조건을 참조하세요.

Important

Azure 스토리지 작업은 현재 미리 보기로 제공되며 다음 지역에서 사용할 수 있습니다. 베타, 미리 보기로 제공되거나 아직 일반 공급으로 릴리스되지 않은 Azure 기능에 적용되는 약관은 Microsoft Azure 미리 보기에 대한 추가 사용 약관을 참조하세요.

작업 형식

작업에는 0개, 1개 또는 여러 매개 변수와 함께 이름이 있습니다. 다음 이미지는 스토리지 작업의 JSON 템플릿에서 작업에 대해 이러한 요소가 표시되는 방법을 보여 줍니다.

다음 표에서는 각 요소에 대해 설명합니다.

요소	설명
name	작업의 이름입니다.1
parameters	하나 이상의 매개 변수 컬렉션입니다. 각 매개 변수에는 매개 변수 이름과 매개 변수 값이 있습니다.1
onSuccess	개체에 대해 작업이 성공할 때 수행할 작업입니다. continue 는 미리 보기 중에 허용되는 유일한 값입니다.
onFailure	개체에 대한 작업이 실패할 때 수행할 작업입니다. break 는 미리 보기 중에 허용되는 유일한 값입니다.

¹ 작업 이름, 작업 매개 변수 및 매개 변수 값의 전체 목록은 이 문서의 지원되는 작업 섹션을 참조하세요.

다음 작업은 시간 기반 불변성 정책을 개체에 적용합니다.

{
    "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	계층	핫 | 쿨 | 보관
SetBlobExpiry	expiryTime, expiryOption	(expiryTime): 밀리초 수 (expiryOption): Absolute | NeverExpire | RelativeToCreation | RelativeToNow
DeleteBlob	None	None
UndeleteBlob	None	None
SetBlobTags	태그 이름1	태그 값
SetBlobImmutabilityPolicy	untilDate, mode	(untilDate): 정책이 종료되는 날짜/시간 (모드): 잠긴 | 잠금 해제
SetBlobLegalHold	legalHold	true | false

¹ 이 매개 변수의 이름은 태그의 이름입니다.

참고 항목

• 스토리지 작업 조건
• 조건 및 작업 정의