다음을 통해 공유


Azure Blob Storage REST API

Azure Blob Storage 텍스트 및 이진 데이터를 클라우드의 개체로 저장합니다. Blob Storage는 스토리지 계정, 컨테이너 및 Blob 리소스를 제공합니다. 저장소 계정에서 컨테이너는 Blob의 집합을 구성하는 방법을 제공합니다.

다음 유형의 Blob 중 하나에 텍스트와 이진 데이터를 저장할 수 있습니다.

  • 스트리밍용으로 최적화된 블록 Blob

  • 추가 작업에 최적화된 추가 Blob입니다.

  • 임의의 읽기/쓰기 작업에 최적화되고 Blob의 바이트 범위에 쓸 수 있는 기능을 제공하는 페이지 Blob입니다.

자세한 내용은 블록 Blob, 추가 Blob, 페이지 Blob 이해를 참조하세요.

Blob Storage용 REST API는 스토리지 계정, 컨테이너 및 Blob에 대한 HTTP 작업을 정의합니다. 다음 표에 API로 수행할 수 있는 작업이 나와 있습니다.

작업 리소스 유형 Description
컨테이너 나열 계정 저장소 계정에 있는 모든 컨테이너를 나열합니다.
Blob Storage 속성 설정 계정 로깅 및 메트릭 설정 및 기본 서비스 버전을 포함하여 Blob Storage의 속성을 설정합니다.
Blob Storage 속성 가져오기 계정 로깅 및 메트릭 설정 및 기본 서비스 버전을 포함하여 Blob Storage 속성을 가져옵니다.
실행 전 Blob 요청 계정 실제 요청을 보내기 전에 Blob Storage에 대한 CORS(원본 간 리소스 공유) 규칙을 쿼리합니다.
Blob Storage 통계 가져오기 계정 Blob Storage 복제와 관련된 통계를 검색합니다. 이 작업은 저장소 계정에 대해 읽기 액세스 지리적 중복 복제가 설정되어 있는 경우 보조 위치 엔드포인트에서만 사용할 수 있습니다.
계정 정보 가져오기 계정 지정된 계정에 대한 SKU 이름 및 계정 종류를 반환합니다.
사용자 위임 키 가져오기 계정 사용자 위임 공유 액세스 서명에 서명하는 데 사용할 수 있는 키를 가져옵니다. 이 서명은 Microsoft Entra 자격 증명을 사용하여 Blob Storage의 리소스에 대한 액세스 권한을 부여합니다.
컨테이너 만들기 컨테이너 스토리지 계정으로 새 컨테이너를 만듭니다.
컨테이너 속성 가져오기 컨테이너 컨테이너의 사용자 정의 메타데이터 및 시스템 속성을 반환합니다.
컨테이너 메타데이터 가져오기 컨테이너 컨테이너의 사용자 정의 메타데이터만 반환합니다.
컨테이너 메타데이터 설정 컨테이너 컨테이너의 사용자 정의 메타데이터를 설정합니다.
컨테이너 ACL 가져오기 컨테이너 컨테이너에 대한 공용 액세스 정책 및 저장된 액세스 정책을 가져옵니다.
컨테이너 ACL 설정 컨테이너 컨테이너에 대한 공용 액세스 정책 및 저장된 액세스 정책을 설정합니다.
컨테이너 임대 컨테이너 컨테이너의 삭제 작업에 대한 잠금을 설정하고 관리합니다.
컨테이너 삭제 컨테이너 컨테이너 및 포함된 모든 Blob를 삭제합니다.
Blob 나열 컨테이너 컨테이너에 있는 모든 Blob를 나열합니다.
Blob 배치 블록, 추가 및 페이지 Blob 새 Blob를 만들고 컨테이너 내의 기존 Blob를 교체합니다.
Blob 가져오기 블록, 추가 및 페이지 Blob 사용자 정의 메타데이터 및 시스템 속성을 포함하여 Blob Storage에서 Blob을 읽거나 다운로드합니다.
Blob 속성 가져오기 블록, 추가 및 페이지 Blob Blob의 모든 시스템 속성과 사용자 정의 메타데이터를 반환합니다.
Blob 속성 설정 블록, 추가 및 페이지 Blob 기존 Blob에 정의된 시스템 속성을 설정합니다.
Blob 만료 설정 블록 Blob 기존 Blob의 만료 시간을 설정합니다.
Blob 메타데이터 가져오기 블록, 추가 및 페이지 Blob 기존 Blob 또는 스냅숏의 모든 사용자 정의 메타데이터를 검색합니다.
Blob 메타데이터 설정 블록, 추가 및 페이지 Blob 기존 Blob의 사용자 정의 메타데이터를 설정합니다.
Blob 태그 가져오기 블록, 추가 및 페이지 Blob 기존 Blob의 사용자 정의 태그를 검색합니다.
Blob 태그 설정 블록, 추가 및 페이지 Blob 보조 인덱스를 형성하는 기존 Blob의 사용자 정의 태그를 설정합니다.
태그로 Blob 찾기 블록, 추가 및 페이지 Blob 사용자 정의 태그로 Blob을 Lists.
Blob 삭제 블록, 추가 및 페이지 Blob 삭제할 Blob를 표시합니다.
Blob 삭제 취소 블록, 추가 및 페이지 Blob 일시 삭제된 Blob 또는 연결된 모든 일시 삭제된 스냅샷의 내용과 메타데이터를 복원합니다.
Blob 임대 블록, 추가 및 페이지 Blob 쓰기 및 삭제 작업에 대한 잠금을 설정하고 관리합니다. 잠긴 Blob에 대한 삭제 또는 쓰기 작업을 수행하려면 클라이언트가 임대 ID를 제공해야 합니다.
Blob 스냅샷 블록, 추가 및 페이지 Blob Blob의 읽기 전용 스냅숏을 만듭니다.
Blob 복사 블록, 추가 및 페이지 Blob 원본 Blob을 해당 저장소 계정 또는 다른 저장소 계정의 대상 Blob에 복사합니다.
Blob 복사 중단 블록, 추가 및 페이지 Blob 보류 중인 Copy Blob 작업을 중지하고 길이가 0이고 메타데이터가 전체인 대상 Blob을 남깁니다.
블록 배치 블록 Blob만 해당 블록 Blob의 일부로 커밋될 새 블록을 만듭니다.
URL에서 블록 배치 블록 Blob만 해당 URL에서 콘텐츠를 읽는 블록 Blob의 일부로 커밋할 새 블록을 만듭니다.
블록 목록 배치 블록 Blob만 해당 블록 Blob을 구성하는 블록 ID의 집합을 지정하여 Blob을 커밋합니다.
블록 목록 가져오기 블록 Blob만 해당 블록 Blob의 일부로 업로드된 블록 목록을 검색합니다.
Blob 콘텐츠 쿼리 블록 Blob만 해당 Blob의 내용에 간단한 SQL(구조적 쿼리 언어) 문을 적용하고 쿼리된 데이터의 하위 집합만 반환합니다.
Blob 계층 설정 블록 및 페이지 Blob Blob의 계층을 설정합니다.
페이지 배치 페이지 Blob만 해당 페이지 Blob에 일정 범위의 페이지를 기록합니다.
페이지 범위 가져오기 페이지 Blob만 해당 페이지 Blob 또는 페이지 Blob의 스냅숏에 대해 유효한 페이지 범위 목록을 반환합니다.
Blob 증분 복사 페이지 Blob만 해당 원본 페이지 Blob의 스냅샷 대상 페이지 Blob에 복사합니다. 차등 변경 내용만 전송됩니다.
추가 블록 추가 Blob만 추가 Blob의 끝에 데이터 블록을 씁니다.

섹션 내용

Blob Storage 개념

계정에 대한 작업(Blob Storage)

컨테이너에 대한 작업

Blob에 대한 작업

Blob에 대한 작업(계층 구조 네임스페이스 사용 계정)

추가 정보

스토리지 서비스 REST