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에 대한 작업(계층 구조 네임스페이스 사용 계정)