Blob service REST APIBlob service REST API

Blob service는 텍스트와 이진 데이터를 클라우드의 개체로 저장 합니다.The Blob service stores text and binary data as objects in the cloud. Blob service는 저장소 계정, 컨테이너 및 blob의 세 가지 리소스를 제공 합니다.The Blob service offers the following three resources: the storage account, containers, and blobs. 저장소 계정에서 컨테이너는 Blob의 집합을 구성하는 방법을 제공합니다.Within your storage account, containers provide a way to organize sets of blobs.

다음 유형의 Blob 중 하나에 텍스트와 이진 데이터를 저장할 수 있습니다.You can store text and binary data in one of the following types of blobs:

  • 스트리밍용으로 최적화된 블록 BlobBlock blobs, which are optimized for streaming.

  • 추가 작업에 최적화 된 추가 blob.Append blobs, which are optimized for append operations.

  • Blob에서 바이트 범위에 쓰기 기능을 제공하며 무작위 읽기/쓰기 작업용으로 최적화된 페이지 BlobPage blobs, which are optimized for random read/write operations and which provide the ability to write to a range of bytes in a blob.

블록 blob 및 페이지 blob에 대 한 자세한 내용은 블록 blob, 추가 blob 및 페이지 Blob 이해를 참조 하세요.For more information about block blobs and page blobs, see Understanding Block Blobs, Append Blobs, and Page Blobs.

Blob service에 대 한 REST API는 저장소 계정, 컨테이너 및 blob에 대 한 HTTP 작업을 정의 합니다.The REST API for the Blob service defines HTTP operations against the storage account, containers, and blobs. 다음 표에 API로 수행할 수 있는 작업이 나와 있습니다.The API includes the operations listed in the following table.

작업(Operation)Operation 리소스 종류Resource Type DescriptionDescription
컨테이너 나열List Containers 계정Account 저장소 계정에 있는 모든 컨테이너를 나열합니다.Lists all of the containers in a storage account.
Blob 서비스 속성 설정Set Blob Service Properties 계정Account 로깅 및 통계 설정, 기본 서비스 버전을 포함하여 Blob 서비스의 속성을 설정합니다.Sets the properties of the Blob service, including logging and metrics settings, and the default service version.
Blob 서비스 속성 가져오기Get Blob Service Properties 계정Account 로깅 및 통계 설정, 기본 서비스 버전을 포함하여 Blob 서비스의 속성을 가져옵니다.Gets the properties of the Blob service, including logging and metrics settings, and the default service version.
실행 전 Blob 요청Preflight Blob Request 계정Account 실제 요청을 보내기 전에 Blob 서비스에 대한 CORS(크로스-원본 자원 공유) 규칙을 쿼리합니다.Queries the Cross-Origin Resource Sharing (CORS) rules for the Blob service prior to sending the actual request.
Blob 서비스 통계 가져오기Get Blob Service Stats 계정Account Blob 서비스에 대한 복제와 관련된 통계를 검색합니다.Retrieves statistics related to replication for the Blob service. 이 작업은 저장소 계정에 대해 읽기 액세스 지리적 중복 복제가 설정되어 있는 경우 보조 위치 엔드포인트에서만 사용할 수 있습니다.This operation is only available on the secondary location endpoint when read-access geo-redundant replication is enabled for the storage account.
계정 정보 가져오기Get Account Information 계정Account 지정 된 계정에 대 한 SKU 이름 및 계정 종류를 반환 합니다.Returns the SKU name and account kind for the specified account.
사용자 위임 키 가져오기Get User Delegation Key 계정Account 사용자 위임 SAS (공유 액세스 서명)에 서명 하는 데 사용할 수 있는 키를 가져옵니다.Gets a key that can be used to sign a user delegation SAS (shared access signature). 사용자 위임 SAS는 Azure Active Directory (Azure AD) 자격 증명을 사용 하 여 Blob service 리소스에 대 한 액세스 권한을 부여 합니다.A user delegation SAS grants access to resources in the Blob service using Azure Active Directory (Azure AD) credentials.
컨테이너 만들기Create Container 컨테이너Container 스토리지 계정으로 새 컨테이너를 만듭니다.Creates a new container in a storage account.
컨테이너 속성 가져오기Get Container Properties 컨테이너Container 컨테이너의 사용자 정의 메타데이터 및 시스템 속성을 반환합니다.Returns all user-defined metadata and system properties of a container.
컨테이너 메타데이터 가져오기Get Container Metadata 컨테이너Container 컨테이너의 사용자 정의 메타데이터만 반환합니다.Returns only user-defined metadata of a container.
컨테이너 메타데이터 설정Set Container Metadata 컨테이너Container 컨테이너의 사용자 정의 메타데이터를 설정합니다.Sets user-defined metadata of a container.
컨테이너 ACL 가져오기Get Container ACL 컨테이너Container 컨테이너에 대한 공용 액세스 정책 및 저장된 액세스 정책을 가져옵니다.Gets the public access policy and any stored access policies for the container.
컨테이너 ACL 설정Set Container ACL 컨테이너Container 컨테이너에 대한 공용 액세스 정책 및 저장된 액세스 정책을 설정합니다.Sets the public access policy and any stored access policies for the container.
컨테이너 임대Lease Container 컨테이너Container 컨테이너의 삭제 작업에 대한 잠금을 설정하고 관리합니다.Establishes and manages a lock on a container for delete operations.
컨테이너 삭제Delete Container 컨테이너Container 컨테이너 및 포함된 모든 Blob를 삭제합니다.Deletes the container and any blobs that it contains.
Blob 나열List Blobs 컨테이너Container 컨테이너에 있는 모든 Blob를 나열합니다.Lists all of the blobs in a container.
Blob 배치Put Blob 블록, 추가 및 페이지 blobBlock, append, and page blobs 새 Blob를 만들고 컨테이너 내의 기존 Blob를 교체합니다.Creates a new blob or replaces an existing blob within a container.
Blob 가져오기Get Blob 블록, 추가 및 페이지 blobBlock, append, and page blobs 사용자 정의 메타데이터 및 시스템 속성을 포함하여 Blob 서비스에서 Blob를 읽거나 다운로드합니다.Reads or downloads a blob from the Blob service, including its user-defined metadata and system properties.
Blob 속성 가져오기Get Blob Properties 블록, 추가 및 페이지 blobBlock, append, and page blobs Blob의 모든 시스템 속성과 사용자 정의 메타데이터를 반환합니다.Returns all system properties and user-defined metadata on the blob.
Blob 속성 설정Set Blob Properties 블록, 추가 및 페이지 blobBlock, append, and page blobs 기존 Blob에 정의된 시스템 속성을 설정합니다.Sets system properties defined for an existing blob.
Blob 만료 설정Set Blob Expiry 블록 BlobBlock blobs 기존 blob에 대 한 만료 시간을 설정 합니다.Sets expiry time for an existing blob.
Blob 메타데이터 가져오기Get Blob Metadata 블록, 추가 및 페이지 blobBlock, append, and page blobs 기존 Blob 또는 스냅숏의 모든 사용자 정의 메타데이터를 검색합니다.Retrieves all user-defined metadata of an existing blob or snapshot.
Blob 메타데이터 설정Set Blob Metadata 블록, 추가 및 페이지 blobBlock, append, and page blobs 기존 Blob의 사용자 정의 메타데이터를 설정합니다.Sets user-defined metadata of an existing blob.
Blob 태그 가져오기Get Blob Tags 블록, 추가 및 페이지 blobBlock, append, and page blobs 기존 blob의 사용자 정의 태그를 검색 합니다.Retrieves user-defined tags of an existing blob.
Blob 태그 설정Set Blob Tags 블록, 추가 및 페이지 blobBlock, append, and page blobs 보조 인덱스를 형성 하는 기존 blob의 사용자 정의 태그를 설정 합니다.Sets user-defined tags of an existing blob that form a secondary index.
태그로 Blob 찾기Find Blobs By Tags 블록, 추가 및 페이지 blobBlock, append, and page blobs 사용자 정의 태그로 blob을 나열 합니다.Lists blobs by their user-defined tags.
Blob 삭제Delete Blob 블록, 추가 및 페이지 BlobBlock, append and page blobs 삭제할 Blob를 표시합니다.Marks a blob for deletion.
Blob 삭제 취소Undelete Blob 블록, 추가 및 페이지 BlobBlock, append and page blobs 일시 삭제 된 blob 및/또는 연결 된 모든 일시 삭제 된 스냅숏의 내용과 메타 데이터를 복원 합니다.Restores the contents and metadata of soft deleted blob and/or all associated soft deleted snapshots.
Blob 임대Lease Blob 블록, 추가 및 페이지 blobBlock, append, and page blobs 쓰기 및 삭제 작업에 대한 잠금을 설정하고 관리합니다.Establishes and manages a lock on write and delete operations. 잠긴 Blob에 대한 삭제 또는 쓰기 작업을 수행하려면 클라이언트가 임대 ID를 제공해야 합니다.To delete or write to a locked blob, a client must provide the lease ID.
Blob 스냅샷Snapshot Blob 블록, 추가 및 페이지 blobBlock, append, and page blobs Blob의 읽기 전용 스냅숏을 만듭니다.Creates a read-only snapshot of a blob.
Blob 복사Copy Blob 블록, 추가 및 페이지 blobBlock, append, and page blobs 원본 Blob을 해당 저장소 계정 또는 다른 저장소 계정의 대상 Blob에 복사합니다.Copies a source blob to a destination blob in this storage account or in another storage account.
Blob 복사 중단Abort Copy Blob 블록, 추가 및 페이지 blobBlock, append, and page blobs 보류 중인 Copy Blob 작업을 중단하고 대상 Blob를 길이가 0이고 전체 메타데이터를 포함하는 상태로 둡니다.Aborts a pending Copy Blob operation, and leaves a destination blob with zero length and full metadata.
블록 배치Put Block 블록 Blob만 해당Block blobs only 블록 Blob의 일부로 커밋될 새 블록을 만듭니다.Creates a new block to be committed as part of a block blob.
URL에서 블록 배치Put Block From URL 블록 Blob만 해당Block blobs only URL에서 콘텐츠를 읽는 블록 blob의 일부로 커밋할 새 블록을 만듭니다.Creates a new block to be committed as part of a block blob where the contents are read from a URL.
블록 목록 배치Put Block List 블록 Blob만 해당Block blobs only 블록 Blob을 구성하는 블록 ID의 집합을 지정하여 Blob을 커밋합니다.Commits a blob by specifying the set of block IDs that comprise the block blob.
블록 목록 가져오기Get Block List 블록 Blob만 해당Block blobs only 블록 Blob의 일부로 업로드된 블록 목록을 검색합니다.Retrieves the list of blocks that have been uploaded as part of a block blob.
Blob 내용 쿼리Query Blob Contents 블록 Blob만 해당Block blobs only Blob 내용에 단순 구조적 쿼리 언어 (SQL) 문을 적용 하 고 데이터의 쿼리 된 하위 집합만 반환 합니다.Applies a simple Structured Query Language (SQL) statement on a blob's contents and returns only the queried subset of the data.
Blob 계층 설정Set Blob Tier 블록 및 페이지 BlobBlock and page blobs Blob의 계층을 설정 합니다.Sets the tier of a blob.
페이지 배치Put Page 페이지 Blob만 해당Page blobs only 페이지 Blob에 일정 범위의 페이지를 기록합니다.Writes a range of pages into a page blob.
페이지 범위 가져오기Get Page Ranges 페이지 Blob만 해당Page blobs only 페이지 Blob 또는 페이지 Blob의 스냅숏에 대해 유효한 페이지 범위 목록을 반환합니다.Returns a list of valid page ranges for a page blob or a snapshot of a page blob.
Blob 증분 복사Incremental Copy Blob 페이지 Blob만 해당Page blobs only 원본 페이지 blob의 스냅숏을 대상 페이지 blob에 복사 합니다.Copies a snapshot of a source page blob to a destination page blob. 차등 변경 내용만 전송 됩니다.Only differential changes are transferred.
추가 블록Append Block 추가 Blob만Append blobs only 추가 blob의 끝에 데이터 블록을 씁니다.Writes a block of data to the end of an append blob.

단원 내용In this section

Blob Service 개념Blob Service Concepts

계정에 대한 작업(Blob 서비스)Operations on the Account (Blob Service)

컨테이너에 대한 작업Operations on Containers

Blob에 대한 작업Operations on Blobs

Blob에 대 한 작업 (계층적 네임 스페이스 사용 계정)Operations on Blobs (Hierarchical Namespace enabled accounts)

참고 항목See also

Storage 서비스 RESTStorage Services REST