다음을 통해 공유

az storage file metadata

Note

이 명령 그룹에는 Azure CLI 및 하나 이상의 확장 모두에 정의된 명령이 있습니다. 확장된 기능을 활용하려면 각 확장을 설치합니다. 확장 프로그램에 대해 자세히 알아보세요.

파일 메타데이터를 관리합니다.

명령

Name Description 형식 상태
az storage file metadata show

파일에 대한 모든 사용자 정의 메타데이터를 반환합니다.

 Core GA
az storage file metadata show (storage-preview 확장)

파일에 대한 모든 사용자 정의 메타데이터를 반환합니다.

 Extension GA
az storage file metadata update

파일 메타데이터를 업데이트합니다.

 Core GA
az storage file metadata update (storage-preview 확장)

파일 메타데이터를 업데이트합니다.

 Extension GA

az storage file metadata show

편집

파일에 대한 모든 사용자 정의 메타데이터를 반환합니다.

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent --enable-file-backup-request-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--file-endpoint]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

예제

파일에 대한 메타데이터 표시

az storage file metadata show -s MyShare --path /path/to/file

필수 매개 변수

--path -p

파일 공유 내의 파일 경로입니다.

--share-name -s

파일 공유 이름입니다.

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

스토리지 계정 키입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

속성 값
Parameter group: Storage Account Arguments
--account-name

스토리지 계정 이름입니다. 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 초과할 수 있습니다.

속성 값
Parameter group: Storage Account Arguments
--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

속성 값
허용되는 값: key, login
--backup-intent --enable-file-backup-request-intent

파일용 OAuth(Azure AD) 인증과 함께 사용하는 데 필요한 매개 변수입니다. 이렇게 하면 해당 파일/디렉터리에 대한 ACL이 있는 경우에도 파일/디렉터리 수준 권한 검사를 무시하고 허용된 데이터 작업에 따라 액세스를 허용합니다.

속성 값
Default value: False
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

속성 값
Parameter group: Storage Account Arguments
--disallow-trailing-dot

true이면 후행 점이 대상 URI에서 잘립니다. 기본값은 False입니다.

속성 값
Default value: False
허용되는 값: false, true
--file-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. az storage account show사용하여 각 서비스 기본 엔드포인트를 찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

속성 값
Parameter group: Storage Account Arguments
--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

속성 값
Parameter group: Storage Account Arguments
--snapshot

해당하는 경우 스냅샷 버전을 나타내는 문자열입니다.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az storage file metadata show (storage-preview 확장)

파일에 대한 모든 사용자 정의 메타데이터를 반환합니다.

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent --enable-file-backup-request-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

예제

파일에 대한 메타데이터 표시

az storage file metadata show -s MyShare --path /path/to/file

필수 매개 변수

--path -p

파일 공유 내의 파일 경로입니다.

--share-name -s

파일 공유 이름입니다.

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

스토리지 계정 키입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

속성 값
Parameter group: Storage Account Arguments
--account-name

스토리지 계정 이름입니다. 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 초과할 수 있습니다.

속성 값
Parameter group: Storage Account Arguments
--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

속성 값
허용되는 값: key, login
--backup-intent --enable-file-backup-request-intent

파일용 OAuth(Azure AD) 인증과 함께 사용하는 데 필요한 매개 변수입니다. 이렇게 하면 해당 파일/디렉터리에 대한 ACL이 있는 경우에도 파일/디렉터리 수준 권한 검사를 무시하고 허용된 데이터 작업에 따라 액세스를 허용합니다.

속성 값
Default value: False
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

속성 값
Parameter group: Storage Account Arguments
--disallow-trailing-dot

true이면 후행 점이 대상 URI에서 잘립니다. 기본값은 False입니다.

속성 값
Default value: False
허용되는 값: false, true
--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

속성 값
Parameter group: Storage Account Arguments
--snapshot

해당하는 경우 스냅샷 버전을 나타내는 문자열입니다.

--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az storage file metadata update

편집

파일 메타데이터를 업데이트합니다.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent --enable-file-backup-request-intent]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--file-endpoint]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

예제

파일에 대한 메타데이터 업데이트

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

필수 매개 변수

--path -p

파일 공유 내의 파일 경로입니다.

--share-name -s

파일 공유 이름입니다.

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

스토리지 계정 키입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

속성 값
Parameter group: Storage Account Arguments
--account-name

스토리지 계정 이름입니다. 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 초과할 수 있습니다.

속성 값
Parameter group: Storage Account Arguments
--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

속성 값
허용되는 값: key, login
--backup-intent --enable-file-backup-request-intent

파일용 OAuth(Azure AD) 인증과 함께 사용하는 데 필요한 매개 변수입니다. 이렇게 하면 해당 파일/디렉터리에 대한 ACL이 있는 경우에도 파일/디렉터리 수준 권한 검사를 무시하고 허용된 데이터 작업에 따라 액세스를 허용합니다.

속성 값
Default value: False
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

속성 값
Parameter group: Storage Account Arguments
--disallow-trailing-dot

true이면 후행 점이 대상 URI에서 잘립니다. 기본값은 False입니다.

속성 값
Default value: False
허용되는 값: false, true
--file-endpoint

스토리지 데이터 서비스 엔드포인트. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. az storage account show사용하여 각 서비스 기본 엔드포인트를 찾을 수 있습니다. 환경 변수: AZURE_STORAGE_SERVICE_ENDPOINT.

속성 값
Parameter group: Storage Account Arguments
--metadata

공백으로 구분된 키=값 쌍의 메타데이터입니다. 기존 메타데이터를 덮어씁니다.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름 또는 서비스 엔드포인트와 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

속성 값
Parameter group: Storage Account Arguments
--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az storage file metadata update (storage-preview 확장)

파일 메타데이터를 업데이트합니다.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent --enable-file-backup-request-intent]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

예제

파일에 대한 메타데이터 업데이트

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

필수 매개 변수

--path -p

파일 공유 내의 파일 경로입니다.

--share-name -s

파일 공유 이름입니다.

선택적 매개 변수

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--account-key

스토리지 계정 키입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_KEY.

속성 값
Parameter group: Storage Account Arguments
--account-name

스토리지 계정 이름입니다. 관련 환경 변수: AZURE_STORAGE_ACCOUNT. 스토리지 계정 키 또는 SAS 토큰과 함께 사용해야 합니다. 둘 다 없는 경우 명령은 인증된 Azure 계정을 사용하여 스토리지 계정 키를 쿼리하려고 합니다. 많은 수의 스토리지 명령이 실행되면 API 할당량이 초과할 수 있습니다.

속성 값
Parameter group: Storage Account Arguments
--auth-mode

명령을 실행할 모드입니다. "로그인" 모드는 인증에 로그인 자격 증명을 직접 사용합니다. 레거시 "키" 모드는 계정에 대한 인증 매개 변수가 제공되지 않은 경우 계정 키를 쿼리하려고 시도합니다. 환경 변수: AZURE_STORAGE_AUTH_MODE.

속성 값
허용되는 값: key, login
--backup-intent --enable-file-backup-request-intent

파일용 OAuth(Azure AD) 인증과 함께 사용하는 데 필요한 매개 변수입니다. 이렇게 하면 해당 파일/디렉터리에 대한 ACL이 있는 경우에도 파일/디렉터리 수준 권한 검사를 무시하고 허용된 데이터 작업에 따라 액세스를 허용합니다.

속성 값
Default value: False
--connection-string

스토리지 계정 연결 문자열입니다. 환경 변수: AZURE_STORAGE_CONNECTION_STRING.

속성 값
Parameter group: Storage Account Arguments
--disallow-trailing-dot

true이면 후행 점이 대상 URI에서 잘립니다. 기본값은 False입니다.

속성 값
Default value: False
허용되는 값: false, true
--metadata

공백으로 구분된 키=값 쌍의 메타데이터입니다. 기존 메타데이터를 덮어씁니다.

--sas-token

SAS(공유 액세스 서명)입니다. 스토리지 계정 이름과 함께 사용해야 합니다. 환경 변수: AZURE_STORAGE_SAS_TOKEN.

속성 값
Parameter group: Storage Account Arguments
--timeout

요청 시간 제한(초)입니다. 서비스에 대한 각 호출에 적용됩니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False