다음을 통해 공유

Azure File Storage

Microsoft Azure Storage는 클라우드의 데이터에 대해 확장성이 뛰어나고 내구성이 뛰어나며 고가용성 스토리지를 제공하며 최신 애플리케이션을 위한 데이터 스토리지 솔루션으로 사용됩니다. File Storage에 연결하여 Azure Storage 계정의 파일 만들기, 업데이트, 가져오기 및 삭제와 같은 다양한 작업을 수행합니다.

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스 클래스 Regions
Copilot Studio Premium 모든 Power Automate 지역
논리 앱 스탠다드 모든 Logic Apps 지역
Power Apps Premium 모든 Power Apps 지역
Power Automate Premium 모든 Power Automate 지역
연락처
이름 Microsoft
URL Microsoft LogicApps 지원
Microsoft Power Automate 지원
Microsoft Power Apps 지원
커넥터 메타데이터
게시자 Microsoft
웹 사이트 https://azure.microsoft.com/services/storage/files/

청크 분할 기능을 지원하는 작업입니다.

이러한 작업은 최대 300MB의 파일을 처리하는 데 사용할 수 있습니다. 이 기능은 기본적으로 사용하도록 설정되어 있습니다.

알려진 문제 및 제한 사항

  1. 논리 앱은 동일한 지역에 있는 경우 방화벽 뒤에 있는 스토리지 계정에 직접 액세스할 수 없습니다. 해결 방법으로 논리 앱과 스토리지 계정을 다른 지역에 둘 수 있습니다. Azure Logic Apps에서 방화벽 뒤의 스토리지 계정으로 액세스를 사용하도록 설정하는 방법에 대한 자세한 내용은 방화벽 뒤에 있는 Access Storage 계정을 참조하세요.

파일 엔드포인트를 사용하여 Azure File 커넥터에 연결

  • 매개 변수에 전체 Azure Storage 파일 엔드포인트를 입력합니다 Azure Storage account name or file endpoint .

  • 스키마를 포함하여 전체 엔드포인트를 제공해야 합니다. 예를 들면 다음과 같습니다.

    • https://account.file.core.windows.net/
    • https://account-secondary.file.core.windows.net/ (보조 엔드포인트에 연결하는 경우)
    • 상대 URL(예: account.file.core.windows.net)이 거부됩니다.

지정된 스토리지 계정에 대한 Azure Storage 파일 엔드포인트 가져오기

이 파일 엔드포인트를 가져오는 방법에는 여러 가지가 있습니다.

  • Azure Portal 사용

    1. Microsoft Azure에서 연결하려는 Azure Storage 계정으로 이동합니다.
    2. 섹션(왼쪽 블레이드)에서 SettingsEndpoints
    3. 파일 엔드포인트는 텍스트 상자의 file service파일 서비스 아래에 있습니다.

  • 스토리지 계정 사용 - 속성 REST API 호출 가져오기

    1. Azure Storage 계정 subscription Id 및 resource group name.
    2. 스토리지 계정으로 이동 - 속성 가져오기
    3. HTTP 호출의 Try it 오른쪽 위 모서리에 있는 단추를 클릭합니다.
    4. 로그인(사용자에게 스토리지 계정에 대한 액세스 권한이 있어야 합니다.)
    5. Azure Storage 계정이 있는 Azure 테넌트 선택
    6. Azure Storage의 계정 이름, 리소스 그룹 이름을 입력하고 스토리지 계정이 있는 구독을 선택합니다.
    7. 클릭 Run
    8. 파일 엔드포인트는 응답의 file 개체 아래에 primaryEndpoints 있는 속성에 있습니다.

일반 제한

이름 가치
최대 파일 크기(MB) 50
대역폭 시간 간격(연결당) 내에서 커넥터 간 전송되는 최대 메가바이트 수 1000
대역폭 시간 간격(밀리초) 60000

연결을 만드는 중

커넥터는 다음 인증 유형을 지원합니다.
기본값 연결을 만들기 위한 매개 변수입니다. 모든 지역 공유 가능

기본값

적용 가능: 모든 지역

연결을 만들기 위한 매개 변수입니다.

공유 가능한 연결입니다. 전원 앱이 다른 사용자와 공유되면 연결도 공유됩니다. 자세한 내용은 캔버스 앱에 대한 커넥터 개요를 참조하세요. - Power Apps | Microsoft Docs

이름 유형 Description 필수
Azure Storage 계정 이름 또는 파일 엔드포인트 문자열 커넥터에서 사용해야 하는 Azure Storage 계정의 이름 또는 파일 엔드포인트입니다. 진실
Azure Storage 계정 액세스 키 시큐어스트링 (보안 문자열) 유효한 기본/보조 Azure Storage 계정 액세스 키를 지정합니다. 진실

제한 한도

Name 호출 갱신 기간
연결당 API 호출 600 60초

동작

경로를 사용하여 파일 메타데이터 가져오기

이 작업은 경로를 사용하여 파일 메타데이터를 검색합니다.
경로를 사용하여 파일 콘텐츠 가져오기

이 작업은 경로를 사용하여 파일 콘텐츠를 검색합니다.
파일 나열

이 작업은 폴더의 파일을 나열합니다.
파일 만들기

이 작업은 Azure File Storage에 파일을 업로드합니다.
파일 메타데이터 가져오기

이 작업은 파일 ID를 사용하여 파일 메타데이터를 검색합니다.
파일 복사

이 작업은 파일을 복사합니다.
파일 삭제

이 작업은 파일을 삭제합니다.
파일 업데이트

이 작업은 Azure File Storage에서 파일을 업데이트합니다.
파일 콘텐츠 가져오기

이 작업은 ID를 사용하여 파일 콘텐츠를 검색합니다.
폴더에 보관 추출

이 작업은 보관 파일을 폴더(예: .zip)로 추출합니다.

경로를 사용하여 파일 메타데이터 가져오기

작업 ID:
GetFileMetadataByPath

이 작업은 경로를 사용하여 파일 메타데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
파일 경로
 path True string

파일에 대한 고유 경로 지정

반환

Blob 메타데이터

몸
BlobMetadata

경로를 사용하여 파일 콘텐츠 가져오기

작업 ID:
GetFileContentByPath

이 작업은 경로를 사용하여 파일 콘텐츠를 검색합니다.

매개 변수

Name 키 필수 형식 Description
파일 경로
 path True string

파일에 대한 고유 경로 지정
콘텐츠 형식 유추
 inferContentType boolean

확장에 따라 콘텐츠 형식 유추

반환

파일의 내용입니다.

File Content(파일 내용)
binary

파일 나열

작업 ID:
ListFolderV2

이 작업은 폴더의 파일을 나열합니다.

매개 변수

Name 키 필수 형식 Description
폴더
 id True string

폴더 지정

반환

Blob 메타데이터의 페이지를 나타냅니다.

몸
BlobMetadataPage

파일 만들기

작업 ID:
CreateFile

이 작업은 Azure File Storage에 파일을 업로드합니다.

매개 변수

Name 키 필수 형식 Description
폴더 경로
 folderPath True string

업로드할 폴더 경로 지정
파일 이름
 name True string

만들 파일의 이름 지정
파일 콘텐츠
 body True binary

업로드할 파일의 콘텐츠 지정

반환

Blob 메타데이터

몸
BlobMetadata

파일 메타데이터 가져오기

작업 ID:
GetFileMetadata

이 작업은 파일 ID를 사용하여 파일 메타데이터를 검색합니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

메타데이터를 가져올 파일 지정

반환

Blob 메타데이터

몸
BlobMetadata

파일 복사

작업 ID:
CopyFile

이 작업은 파일을 복사합니다.

매개 변수

Name 키 필수 형식 Description
원본 URL
 source True string

원본 파일의 URL 지정
대상 파일 경로
 destination True string

대상 파일 이름을 포함하여 대상 파일 경로 지정
덮어쓸?
 overwrite boolean

대상 파일을 덮어써야 하나요(true/false)?

반환

Blob 메타데이터

몸
BlobMetadata

파일 삭제

작업 ID:
DeleteFile

이 작업은 파일을 삭제합니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

삭제할 파일 지정

파일 업데이트

작업 ID:
UpdateFile

이 작업은 Azure File Storage에서 파일을 업데이트합니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

업데이트할 파일 지정
파일 콘텐츠
 body True binary

파일을 업데이트할 콘텐츠 지정

반환

Blob 메타데이터

몸
BlobMetadata

파일 콘텐츠 가져오기

작업 ID:
GetFileContent

이 작업은 ID를 사용하여 파일 콘텐츠를 검색합니다.

매개 변수

Name 키 필수 형식 Description
File
 id True string

콘텐츠를 가져올 파일 지정
콘텐츠 형식 유추
 inferContentType boolean

확장에 따라 콘텐츠 형식 유추

반환

파일의 내용입니다.

File Content(파일 내용)
binary

폴더에 보관 추출

작업 ID:
ExtractFolderV2

이 작업은 보관 파일을 폴더(예: .zip)로 추출합니다.

매개 변수

Name 키 필수 형식 Description
원본 보관 파일 경로
 source True string

보관 파일의 경로 지정
대상 폴더 경로
 destination True string

보관 콘텐츠를 추출할 경로를 Azure File Storage에 지정합니다.
덮어쓸?
 overwrite boolean

대상 파일을 덮어써야 하나요(true/false)?

반환

response
array of BlobMetadata

정의

BlobMetadata

Blob 메타데이터

Name 경로 형식 Description
아이디
 Id string

파일 또는 폴더의 고유 ID입니다.
이름
 Name string

파일 또는 폴더의 이름입니다.
디스플레이 이름
 DisplayName string

파일 또는 폴더의 표시 이름입니다.
경로
 Path string

파일 또는 폴더의 경로입니다.
마지막 수정
 LastModified date-time

파일 또는 폴더가 마지막으로 수정된 날짜와 시간입니다.
Size
 Size integer

파일 또는 폴더의 크기입니다.
미디어 유형
 MediaType string

파일 또는 폴더의 미디어 형식입니다.
IsFolder
 IsFolder boolean

Blob이 폴더인지 여부를 나타내는 부울 값(true, false)입니다.
ETag
 ETag string

파일 또는 폴더의 etag입니다.
FileLocator
 FileLocator string

파일 또는 폴더의 파일로케이터입니다.

BlobMetadataPage

Blob 메타데이터의 페이지를 나타냅니다.

Name 경로 형식 Description
value
 value array of BlobMetadata

Blob 메타데이터 컬렉션입니다.

이진법

기본 데이터 형식 'binary'입니다.