다음을 통해 공유


스토리지 작업 조건

스토리지 작업에는 조건 및 작업 집합이 포함됩니다. 이 문서에서는 조건의 JSON 형식에 대해 설명합니다. Azure Portal(예: Azure PowerShell 또는 Azure CLI) 이외의 도구를 사용하여 스토리지 작업을 만들려는 경우 해당 형식을 이해하는 것이 중요합니다. 이 문서에서는 조건의 절을 작성하는 데 사용할 수 있는 속성 및 연산자도 나열합니다.

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

Important

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

조건 형식

하나 이상의 절 컬렉션 조건입니다. 각 절에는 속성, 및 연산자가 포함됩니다. 스토리지 태스크가 실행되면 연산자를 사용하여 속성을 값과 비교해 대상 개체가 절을 충족하는지 확인합니다. 절에서 연산자는 항상 먼저 속성과 값 뒤에 나타납니다. 다음 이미지는 각 요소가 식에 배치되는 방법을 보여줍니다.

연산자, 속성 및 값이 있는 단순 조건의 형식을 보여 주는 다이어그램

다음 절에서는 Microsoft Word 문서에서만 작업을 수행할 수 있습니다. 이 절은 파일 확장 .docx으로 끝나는 모든 문서를 대상으로 합니다. 따라서 연산자는 endsWith속성이고 값은 Name.입니다 .docx.

{
   "condition": "[[[endsWith(Name, '.docx')]]"
}

연산자 및 속성 이름의 전체 목록은 이 문서의 지원되는 연산자 및 지원되는 속성 섹션을 참조하세요.

조건의 여러 절

조건에는 문자열 and 또는 or쉼표와 함께 쉼표로 구분된 여러 절이 포함될 수 있습니다. 문자열 and 은 조건의 모든 절에 있는 조건을 충족하는 개체를 대상으로 하지만 조건 or 의 모든 절에서 조건을 충족하는 개체를 대상으로 합니다. 다음 이미지는 두 절과 함께 문자열 orand 위치를 보여 줍니다.

두 절이 포함된 조건의 형식을 보여 주는 다이어그램

다음 JSON은 두 절이 포함된 조건을 보여 줍니다. and 이 식에 문자열이 사용되므로 개체에서 작업을 수행하기 전에 두 절이 모두 계산 true 되어야 합니다.

{
"condition": "[[and(endsWith(Name, '.docx'), equals(Tags.Value[readyForLegalHold], 'Yes'))]]"
}

조건 그룹

그룹화된 절은 나머지 절과 분리된 단일 단위로 작동합니다. 절 그룹화는 수학 방정식 또는 논리 식 주위에 괄호를 씌우는 것과 유사합니다. and 그룹의 첫 번째 절에 대한 문자열 또는 or 문자열이 전체 그룹에 적용됩니다.

다음 이미지는 함께 그룹화된 두 절을 보여 줍니다.

함께 그룹화된 두 절이 포함된 조건의 형식을 보여 주는 다이어그램.

다음 조건에서는 문서의 태그가 readyForLegalHoldYes으로 설정된 Microsoft Word 문서에서만 작업을 수행할 수 있습니다. 다른 두 조건이 true가 아니더라도 100바이트보다 큰 개체에서도 연산이 수행됩니다.

{
"condition": "[[[or(and(endsWith(Name, '.docx'), equals(Tags.Value[readyForLegalHold], 'Yes')), greater(Content-Length, '100'))]]"
}

Azure Portal의 코드 보기

Azure Portal에서 사용할 수 있는 시각적 편집기에서 조건의 JSON을 생성할 수 있습니다. 편집기를 사용하여 조건을 정의한 다음 코드 탭을 열어 JSON 식을 가져올 수 있습니다. 이 방법은 JSON 식이 크고 다루기 어렵고 직접 만들기 어려울 수 있으므로 복잡한 조건 집합을 만들 때 유용할 수 있습니다. 다음 이미지는 시각적 편집기의 코드 탭을 보여줍니다.

시각적 디자이너의 코드 탭에 표시되는 조건 JSON의 스크린샷.

시각적 편집기를 자세히 알아보려면 스토리지 작업 조건 및 작업 정의를 참조 하세요.

지원되는 속성

다음 표에는 조건의 각 절을 구성하는 데 사용할 수 있는 속성이 나와 있습니다. 절에는 문자열, 부울, 숫자 및 날짜 및 시간 속성이 포함될 수 있습니다.

문자열 날짜 및 시간3 숫자 부울
AccessTier1 AccessTierChangeTime Content-Length 삭제됨
Metadata.Value Creation-Time TagCount IsCurrentVersion
이름 DeletedTime
BlobType2 LastAccessTime
Container.Metadata.Value[Name] Last-Modified
컨테이너 이름
Container.Metadata.Value[Name]
컨테이너 이름
Tags.Value[Name]
VersionId

1 허용되는 값은 Hot, Cool 또는 Archive입니다.

2 허용되는 값은 BlockBlob, PageBlob 또는 AppendBlob입니다.

3 특정 시간으로 설정하거나 개체에서 동적으로 가져오는 메타데이터 값으로 설정할 수 있습니다. 개체 메타데이터에서 값 참조를 참조하세요.

지원되는 연산자

다음 표에서는 각 속성 형식의 값을 평가하기 위해 절에서 사용할 수 있는 연산자를 보여 줍니다.

문자열 날짜 및 시간 숫자 부울
contains 같음 같음 같음
empty greater greater not
같음 greaterOrEquals greaterOrEquals
endsWith less less
length lessOrEquals lessOrEquals
startsWith addToTime
일치 항목

참고 항목