Blob 나열List Blobs

List Blobs작업은 지정 된 컨테이너 아래에 있는 blob의 목록을 반환 합니다.The List Blobs operation returns a list of the blobs under the specified container.

요청Request

다음과 같이 List Blobs 요청을 생성할 수 있습니다.The List Blobs request may be constructed as follows. HTTPS를 사용하는 것이 좋습니다.HTTPS is recommended. Myaccount 을 사용자의 저장소 계정 이름으로 바꿉니다.Replace myaccount with the name of your storage account:

방법Method 요청 URIRequest URI HTTP 버전HTTP Version
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list HTTP/1.1HTTP/1.1

에뮬레이트된 저장소 서비스 URIEmulated storage service URI

에뮬레이트된 저장소 서비스에 대해 요청을 수행할 때는 에뮬레이터 호스트 이름 및 Blob 서비스 포트를 127.0.0.1:10000으로 지정하고 뒤에 에뮬레이트된 저장소 계정 이름을 붙입니다.When making a request against the emulated storage service, specify the emulator hostname and Blob service port as 127.0.0.1:10000, followed by the emulated storage account name:

방법Method 요청 URIRequest URI HTTP 버전HTTP Version
GET http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list HTTP/1.1HTTP/1.1

자세한 내용은 개발 및 테스트에 Azure Storage 에뮬레이터 사용을 참조 하세요.For more information, see Using the Azure Storage Emulator for Development and Testing.

URI 매개 변수URI Parameters

URI에 다음과 같은 추가 매개 변수를 지정할 수 있습니다.The following additional parameters may be specified on the URI.

매개 변수Parameter DescriptionDescription
prefix 선택 사항입니다.Optional. 이름이 지정한 접두사로 시작하는 Blob만 반환하도록 결과를 필터링합니다.Filters the results to return only blobs whose names begin with the specified prefix.
delimiter 선택 사항입니다.Optional. 요청에 이 매개 변수가 포함되면 응답 본문에 구분 기호 문자까지 표시되는 하위 문자열과 동일한 이름으로 시작하는 모든 Blob에 대해 자리 표시자 역할을 하는 BlobPrefix 요소를 반환합니다.When the request includes this parameter, the operation returns a BlobPrefix element in the response body that acts as a placeholder for all blobs whose names begin with the same substring up to the appearance of the delimiter character. 이 구분 기호는 단일 문자이거나 문자열일 수 있습니다.The delimiter may be a single character or a string.
marker 선택 사항입니다.Optional. 다음 목록 작업으로 반환할 목록 부분을 식별하는 문자열 값입니다.A string value that identifies the portion of the list to be returned with the next list operation. 이 작업은 반환된 목록이 완전하지 않은 경우 응답 본문 내의 마커 값을 반환합니다.The operation returns a marker value within the response body if the list returned was not complete. 그런 다음 이 마커 값을 다음 목록 항목 집합을 요청하는 후속 호출에 사용할 수 있습니다.The marker value may then be used in a subsequent call to request the next set of list items.

마커 값은 클라이언트에 불투명합니다.The marker value is opaque to the client.
maxresults 선택 사항입니다.Optional. 모든 BlobPrefix 요소를 포함하여 반환할 최대 Blob 수를 지정합니다.Specifies the maximum number of blobs to return, including all BlobPrefix elements. 요청에서 maxresults를 지정하지 않거나 5,000보다 큰 값을 지정할 경우 서버는 최대 5,000개의 항목을 반환합니다.If the request does not specify maxresults or specifies a value greater than 5,000, the server will return up to 5,000 items.

0 이하로 maxresults를 설정하면 오류 응답 코드 400(잘못된 요청)를 반환합니다.Setting maxresults to a value less than or equal to zero results in error response code 400 (Bad Request).
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions} 선택 사항입니다.Optional. 응답에 포함시킬 데이터 집합을 하나 이상 지정합니다.Specifies one or more datasets to include in the response:

- snapshots: 스냅숏을 열거형에 포함 하도록 지정 합니다.- snapshots: Specifies that snapshots should be included in the enumeration. 응답에서 스냅숏은 생성된 시간 순서로 나열됩니다.Snapshots are listed from oldest to newest in the response.
- metadata: 응답에서 blob 메타 데이터를 반환 하도록 지정 합니다.- metadata: Specifies that blob metadata be returned in the response.
- uncommittedblobs: 블록을 업로드 했지만 Put 블록 목록을사용 하 여 커밋되지 않은 blob를 응답에 포함 하도록 지정 합니다.- uncommittedblobs: Specifies that blobs for which blocks have been uploaded, but which have not been committed using Put Block List, be included in the response.
- copy: 버전 2012-02-12 이상.- copy: Version 2012-02-12 and newer. 응답에 포함해야 할, 현재 또는 이전 Copy Blob 작업에 관련된 메타데이터를 지정합니다.Specifies that metadata related to any current or previous Copy Blob operation should be included in the response.
-deleted: 버전 2017-07-29 이상.-deleted: Version 2017-07-29 and newer. 일시 삭제 된 blob를 응답에 포함 하도록 지정 합니다.Specifies that soft deleted blobs should be included in the response.
-tags: 버전 2019-12-12 이상.-tags: Version 2019-12-12 and newer. 사용자 정의 Blob 인덱스 태그를 응답에 포함 하도록 지정 합니다.Specifies that user-defined Blob Index tags should be included in the response.
-versions: 버전 2019-12-12 이상.-versions: Version 2019-12-12 and newer. Blob 버전을 열거형에 포함 하도록 지정 합니다.Specifies that Versions of blobs should be included in the enumeration.

URI에 이러한 작업을 하나 이상을 지정하려면 URL로 인코딩된 쉼표("%82")로 각 옵션을 구분해야 합니다.To specify more than one of these options on the URI, you must separate each option with a URL-encoded comma ("%82").
timeout 선택 사항입니다.Optional. timeout 매개 변수는 초 단위로 표시됩니다.The timeout parameter is expressed in seconds. 자세한 내용은 Blob 서비스 작업에 대 한 시간 제한 설정을 참조 하세요.For more information, see Setting Timeouts for Blob Service Operations.

요청 헤더Request Headers

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.The following table describes required and optional request headers.

요청 헤더Request Header DescriptionDescription
Authorization 필수 요소.Required. 인증 체계, 계정 이름 및 서명을 지정 합니다.Specifies the authorization scheme, account name, and signature. 자세한 내용은 Azure Storage에 요청 권한 부여를 참조 하세요.For more information, see Authorize requests to Azure Storage.
Date 또는 x-ms-dateDate or x-ms-date 필수 요소.Required. 요청에 대한 UTC(협정 세계시)를 지정합니다.Specifies the Coordinated Universal Time (UTC) for the request. 자세한 내용은 Azure Storage에 요청 권한 부여를 참조 하세요.For more information, see Authorize requests to Azure Storage.
x-ms-version 모든 권한이 부여 된 요청에 필요 합니다. 익명 요청의 경우 선택 사항입니다.Required for all authorized requests, optional for anonymous requests. 이 요청에 사용할 작업의 버전을 지정합니다.Specifies the version of the operation to use for this request. 자세한 내용은 Azure Storage Services에 대 한 버전 관리를 참조 하세요.For more information, see Versioning for the Azure Storage Services.
x-ms-client-request-id 선택 사항입니다.Optional. 저장소 분석 로깅을 사용 하도록 설정한 경우 분석 로그에 기록 되는 1 KiB 문자 제한이 있는 클라이언트 생성 불투명 값을 제공 합니다.Provides a client-generated, opaque value with a 1 KiB character limit that is recorded in the analytics logs when storage analytics logging is enabled. 이 헤더를 사용하면 클라이언트 쪽 작업을 서버에서 받은 요청과 관련시키는 것이 좋습니다.Using this header is highly recommended for correlating client-side activities with requests received by the server. 자세한 내용은 스토리지 분석 로깅Azure 로깅: 로그를 사용 하 여 저장소 요청 추적을 참조 하세요.For more information, see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.

요청 본문Request Body

없음None.

샘플 요청Sample Request

샘플 요청은 Blob 리소스 열거 를 참조 하세요.See Enumerating Blob Resources for a sample request.

응답이Response

응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 XML 형식으로 포함되어 있습니다.The response includes an HTTP status code, a set of response headers, and a response body in XML format.

상태 코드Status Code

작업에 성공하면 상태 코드 200(정상)이 반환됩니다.A successful operation returns status code 200 (OK).

상태 코드에 대 한 자세한 내용은 상태 및 오류 코드를 참조 하세요.For information about status codes, see Status and Error Codes.

응답 헤더Response Headers

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다.The response for this operation includes the following headers. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다.The response may also include additional standard HTTP headers. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을따릅니다.All standard headers conform to the HTTP/1.1 protocol specification.

응답 헤더Response header DescriptionDescription
Content-Type 결과가 반환될 형식을 지정합니다.Specifies the format in which the results are returned. 현재 이 값은 application/xml입니다.Currently this value is application/xml.
x-ms-request-id 이 헤더는 수행된 요청을 고유하게 식별하며, 이 헤더를 사용해서 요청 문제를 해결할 수 있습니다.This header uniquely identifies the request that was made and can be used for troubleshooting the request. 자세한 내용은 API 작업 문제 해결을 참조 하세요.For more information, see Troubleshooting API Operations.
x-ms-version 요청을 실행하는 데 사용되는 Blob 서비스의 버전을 나타냅니다.Indicates the version of the Blob service used to execute the request. 이 헤더는 2009-09-19 이전 버전을 사용하여 이루어진 요청에 대해 반환됩니다.This header is returned for requests made using version 2009-09-19 and newer.

Blob 서비스의 2009-09-19 버전을 사용해서 컨테이너가 공용 액세스용으로 표시된 경우 지정된 버전이 없는 익명 요청에 대해서도 이 헤더가 반환됩니다.This header is also returned for anonymous requests without a version specified if the container was marked for public access using the 2009-09-19 version of the Blob service.
Date 응답이 시작된 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
x-ms-client-request-id 이 헤더를 사용 하 여 요청 및 해당 응답의 문제를 해결할 수 있습니다.This header can be used to troubleshoot requests and corresponding responses. 이 헤더의 값은 요청에 있는 경우 헤더의 값과 같으며 x-ms-client-request-id , 값은 최대 1024 표시 ASCII 문자입니다.The value of this header is equal to the value of the x-ms-client-request-id header if it is present in the request and the value is at most 1024 visible ASCII characters. x-ms-client-request-id요청에 헤더가 없는 경우이 헤더는 응답에 표시 되지 않습니다.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.

응답 본문Response Body

XML 응답의 형식은 다음과 같습니다.The format of the XML response is as follows.

Prefix, Marker, MaxResultsDelimiter 요소의 경우 요청 URI에 지정된 경우에만 포함됩니다.Note that the Prefix, Marker, MaxResults, and Delimiter elements are present only if they were specified on the request URI. NextMarker 요소는 목록 결과가 완전하지 않은 경우에만 값을 포함합니다.The NextMarker element has a value only if the list results are not complete.

스냅숏, Blob 메타데이터 및 커밋되지 않은 Blob는 include 매개 변수를 사용하여 요청 URI에 지정된 경우에만 응답에 포함됩니다.Snapshots, blob metadata, and uncommitted blobs are included in the response only if they are specified with the include parameter on the request URI.

2009-09-19 이후 버전에서 Blob의 속성은 Properties요소 내에 캡슐화됩니다.In version 2009-09-19 and newer, the blob's properties are encapsulated within a Properties element.

2009-09-19 이후 버전부터 List Blobs은 응답 본문에서 다음과 같은 이름이 변경된 요소를 반환합니다.Beginning with version 2009-09-19, List Blobs returns the following renamed elements in the response body:

  • Last-Modified(이전 LastModified)Last-Modified (previously LastModified)

  • Content-Length(이전 Size)Content-Length (previously Size)

  • Content-Type(이전 ContentType)Content-Type (previously ContentType)

  • Content-Encoding(이전 ContentEncoding)Content-Encoding (previously ContentEncoding)

  • Content-Language(이전 ContentLanguage)Content-Language (previously ContentLanguage)

Content-MD5 요소는 2009-09-19 이후 버전으로 생성된 Blob에서 표시됩니다.The Content-MD5 element appears for blobs created with version 2009-09-19 and newer. 2012-02-12 이상 버전에서는 Content-MD5 put blob을 사용 하 여 blob을 업로드할 때 Blob service에서 값을 계산 하지만 put 블록 목록을사용 하 여 blob을 만들 때이 값을 계산 하지는 않습니다.In version 2012-02-12 and newer, the Blob service calculates the Content-MD5 value when you upload a blob using Put Blob, but does not calculate this when you create a blob using Put Block List. Content-MD5Blob을 만들 때 또는 블록 목록 배치 또는 blob 속성 작업 설정 작업을 호출 하 여 값을 명시적으로 설정할 수 있습니다.You can explicitly set the Content-MD5 value when you create the blob, or by calling Put Block List or Set Blob Properties operations.

2009-09-19 이상 버전에서 이전 2015-02-21 버전의 경우 추가 blob을 List Blobs 포함 하는 컨테이너에 대 한 호출은 목록 결과에 추가 blob이 포함 된 경우 상태 코드 409 (FeatureVersionMismatch)와 함께 실패 합니다.For versions from 2009-09-19 and newer but prior to version 2015-02-21, calling List Blobs on a container that includes append blobs will fail with status code 409 (FeatureVersionMismatch) if the result of listing contains an append blob.

LeaseState 및는 LeaseDuration 2012-02-12 이상 버전 에서만 나타납니다.LeaseState and LeaseDuration appear only in version 2012-02-12 and later.

CopyId, CopyStatus, CopySource, CopyProgress, CopyCompletionTimeCopyStatusDescription은 이 작업에 include={copy} 매개 변수가 포함될 경우 2012-02-12 이후 버전에서만 표시됩니다.CopyId, CopyStatus, CopySource, CopyProgress, CopyCompletionTime, and CopyStatusDescription only appear in version 2012-02-12 and later, when this operation includes the include={copy} parameter. 이 Blob가 Copy Blob 작업의 대상이 아니거나 Copy Blob, Set Blob Properties 또는 Put Blob를 사용하여 Put Block List 작업이 완료된 후 이 Blob가 수정된 경우 이 요소는 표시되지 않습니다.These elements do not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List. 이러한 요소는 버전 2012-02-12 이전 blob에서 만든 blob와 함께 표시 되지 않습니다.These elements also do not appear with a blob created by Copy Blob before version 2012-02-12.

2013-08-15 이상 버전에서 EnumerationResults 요소에는 Blob 엔드포인트를 지정하는 ServiceEndpoint 특성 및 컨테이너의 이름을 지정하는 ContainerName 필드가 포함됩니다.In version 2013-08-15 and newer, the EnumerationResults element contains a ServiceEndpoint attribute specifying the blob endpoint, and a ContainerName field specifying the name of the container. 이전 버전에서 이 두 특성은 ContainerName 필드 하나로 표현되었습니다.In previous versions these two attributes were combined together in the ContainerName field. 또한 2013-08-15 이상 버전에서는 UrlBlob 요소가 제거되었습니다.Also in version 2013-08-15 and newer, the Url element under Blob has been removed.

버전 2015-02-21 이상에서는 List Blobs 모든 형식의 blob (블록, 페이지 및 추가 blob)을 반환 합니다.For version 2015-02-21 and above, List Blobs returns blobs of all types (block, page, and append blobs).

버전 2015-12-11 이상에서는 요소를 List Blobs 반환 합니다 ServerEncrypted .For version 2015-12-11 and above, List Blobs returns the ServerEncrypted element. 이 요소는 true blob 및 응용 프로그램 메타 데이터가 완전히 암호화 된 경우로 설정 되 고, 그렇지 않으면로 설정 됩니다 false .This element is set to true if the blob and application metadata are completely encrypted, and false otherwise.

버전 2016-05-31 이상에서는 값이 List Blobs IncrementalCopy 로 설정 된 증분 복사 blob 및 스냅숏에 대 한 요소를 반환 true 합니다.For version 2016-05-31 and above, List Blobs returns the IncrementalCopy element for incremental copy blobs and snapshots with the value set to true.

버전 2017-04-17 이상에서는 List Blobs AccessTier 액세스 계층이 명시적으로 설정 된 경우에서 요소를 반환 합니다.For version 2017-04-17 and above, List Blobs returns the AccessTier element if an access tier has been explicitly set. 허용 되는 프리미엄 페이지 blob 계층 목록은 vm에 대 한 고성능 Premium Storage 및 managed disks를 참조 하세요.For a list of allowed premium page blob tiers, see High-performance Premium Storage and managed disks for VMs. Blob Storage 또는 범용 v2 계정의 경우 유효한 값은 Hot / Cool / Archive 입니다.For Blob Storage or General Purpose v2 accounts, valid values are Hot/Cool/Archive. Blob이 리하이드레이션 pending 상태 이면 ArchiveStatus 요소는 유효한 값 중 하나를 사용 하 여 반환 됩니다 rehydrate-pending-to-hot / rehydrate-pending-to-cool .If the blob is in rehydrate pending state then ArchiveStatus element is returned with one of the valid values rehydrate-pending-to-hot/rehydrate-pending-to-cool. 블록 blob 계층에 대 한 자세한 내용은 핫, 쿨 및 보관 저장소 계층을 참조 하세요.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

버전 2017-04-17 이상에서는 List Blobs AccessTierInferred Blob Storage 또는 범용 v2 계정에 대 한 요소를 반환 합니다.For version 2017-04-17 and above, List Blobs returns the AccessTierInferred element on Blob Storage or General Purpose v2 accounts. 블록 blob에 액세스 계층 집합이 없으면 저장소 계정 속성에서 계층을 유추 하 고이 값은로 설정 됩니다 true .If the block blob does not have the access tier set then we infer tier from storage account properties and this value is set to true. 이 헤더는 계정이 계정 속성에서 유추 되는 경우에만 존재 합니다.This header is present only if the tier is inferred from the account property. 블록 blob 계층에 대 한 자세한 내용은 핫, 쿨 및 보관 저장소 계층을 참조 하세요.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

버전 2017-04-17 이상에서는 List Blobs AccessTierChangeTime Blob Storage 또는 범용 v2 계정에 대 한 요소를 반환 합니다.For version 2017-04-17 and above, List Blobs returns the AccessTierChangeTime element on Blob Storage or General Purpose v2 accounts. 이는 블록 blob의 계층이 설정 된 경우에만 반환 됩니다.This is returned only if tier on block blob was ever set. 날짜 형식은 RFC 1123을 따릅니다.The date format follows RFC 1123. 자세한 내용은 헤더의 Date-Time 값 표현을 참조 하십시오.For more information, see Representation of Date-Time Values in Headers. 블록 blob 계층에 대 한 자세한 내용은 핫, 쿨 및 보관 저장소 계층을 참조 하세요.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

버전 2017-07-29 이상에서는 Deleted DeletedTime RemainingRetentionDays 이 작업에 매개 변수가 포함 된 경우이 표시 됩니다 include={deleted} .For version 2017-07-29 and above, Deleted, DeletedTime and RemainingRetentionDays appear when this operation includes the include={deleted} parameter. 이 blob이 삭제 되지 않은 경우 이러한 요소는 표시 되지 않습니다.These elements do not appear if this blob was not deleted. 이러한 요소는 DELETE 일시 삭제 기능을 사용 하도록 설정한 경우 작업으로 삭제 되는 blob 또는 스냅숏에 대해 표시 됩니다.These elements appear for blob or snapshot that are deleted with DELETE operation when soft delete feature was enabled. Deleted 일시 삭제 된 blob 및 스냅숏에 대해 요소는 true로 설정 됩니다.Deleted element is set to true for blobs and snapshots that are soft deleted. Deleted-Time blob이 삭제 된 시간에 해당 합니다.Deleted-Time corresponds to time when the blob was deleted. RemainingRetentionDays 일시 삭제 된 blob이 blob service에 의해 영구적으로 삭제 되는 일 수를 나타냅니다.RemainingRetentionDays indicates number of days after which soft deleted blob will be permanently deleted by blob service.

버전 2017-11-09 이상에서는 Creation-Time 이 blob이 만들어진 시간을 반환 합니다.For version 2017-11-09 and above, Creation-Time returns the time at which this blob was created.

버전 2019-02-02 이상에서는 List Blobs CustomerProvidedKeySha256 blob이 고객이 제공한 키로 암호화 된 경우 요소를 반환 합니다.For version 2019-02-02 and above, List Blobs returns the CustomerProvidedKeySha256 element if the blob is encrypted with a customer-provided key. 값은 blob을 암호화 하는 데 사용 되는 키의 SHA-256 해시로 설정 됩니다.The value will be set to the SHA-256 hash of the key used to encrypt the blob. 또한 작업에 매개 변수가 포함 되어 include={metadata} 있고 고객이 제공한 키를 사용 하 여 암호화 된 blob에 응용 프로그램 메타 데이터가 있는 경우이 Metadata 요소에는 Encrypted="true" 작업의 일부로 해독할 수 없는 메타 데이터가 포함 되어 있음을 나타내는 특성이 포함 됩니다 List Blobs .Additionally, if the operation includes the include={metadata} parameter and there is application metadata present on a blob encrypted with a customer-provided key, the Metadata element will have an Encrypted="true" attribute to indicate that the blob has metadata which cannot be decrypted as part of the List Blobs operation. Blob 속성 가져오기 또는 고객이 제공한 키를 사용 하 여 Blob 메타 데이터 가져오기 를 호출 하 여 이러한 blob에 대 한 메타 데이터에 액세스 합니다.Call Get Blob Properties or Get Blob Metadata with the customer-provided key to access the metadata for these blobs.

2019-02-02 이상 버전의 경우 List Blobs EncryptionScope blob이 암호화 범위를 사용 하 여 암호화 된 경우에는 요소를 반환 합니다.For version 2019-02-02 and above, List Blobs returns the EncryptionScope element if the blob is encrypted with an encryption scope. 값은 blob을 암호화 하는 데 사용 되는 암호화 범위의 이름으로 설정 됩니다.The value will be set to the name of the encryption scope used to encrypt the blob. 작업에 매개 변수가 포함 된 경우 include={metadata} blob의 응용 프로그램 메타 데이터는 투명 하 게 해독 되 고 요소에서 사용할 수 있습니다 Metadata .If the operation includes the include={metadata} parameter, application metadata on the blob will be transparently decrypted and available in the Metadata element.

2019-12-12 이상 버전의 경우 List Blobs RehydratePriority 개체가 리하이드레이션 pending 상태 이면 Blob Storage 또는 범용 v2 계정에 대 한 요소를 반환 합니다.For version 2019-12-12 and above, List Blobs returns the RehydratePriority element on Blob Storage or General Purpose v2 accounts if object is in rehydrate pending state. 유효한 값은 High / Standard 입니다.Valid values are High/Standard. 블록 blob 계층에 대 한 자세한 내용은 핫, 쿨 및 보관 저장소 계층을 참조 하세요.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

버전 2019-12-12 이상에서는 List Blobs VersionId 계정에서 버전 관리를 사용 하는 경우 blob 및 생성 된 blob 버전에 대 한 요소를 반환 합니다.For version 2019-12-12 and above, List Blobs returns the VersionId element for blobs and generated blob versions when Versioning is enabled on the account.

버전 2019-12-12 이상에서는 List Blobs IsCurrentVersion 값이로 설정 된 blob의 현재 버전에 대 한 요소를 반환 하 여 true 읽기 전용 자동 생성 버전과 구분 합니다.For version 2019-12-12 and above, List Blobs returns the IsCurrentVersion element for the current version of the blob with the value set to true, to differentiate it from the read-only automatically generated versions.

버전 2019-12-12 이상에서는 List Blobs TagCount 태그가 있는 blob에 대 한 요소를 반환 합니다.For version 2019-12-12 and above, List Blobs returns the TagCount element for blobs with any tags. Tags요소는이 작업에 매개 변수가 포함 된 경우에만 표시 됩니다 include={tags} .The Tags element appears only when this operation includes the include={tags} parameter. 이러한 요소는 blob에 태그가 없는 경우 표시 되지 않습니다.These elements do not appear if there are no tags on the blob.

버전 2020-02-10 이상에서는 요소를 List Blobs 반환 합니다 LastAccessTime .For version 2020-02-10 and above, List Blobs returns the LastAccessTime element. 요소는 저장소 계정의 마지막 액세스 시간 추적 정책에 따라 blob의 데이터에 마지막으로 액세스 한 시간을 표시 합니다.The elements shows when the blob's data was last accessed according to the storage account's last access time tracking policy. 저장소 계정에 마지막 액세스 시간 추적 정책이 없거나 정책이 사용 하지 않도록 설정 된 경우에는 요소가 반환 되지 않습니다.The element will not be returned if the storage account does not have a last access time tracking policy, or the policy is disabled. 계정에 대 한 마지막 액세스 시간 추적 정책 설정에 대 한 자세한 내용은 Blob SERVICE API를 참조 하세요.For information about setting account's last access time tracking policy, see Blob Service API. LastAccessTime이 요소는 blob의 메타 데이터에 마지막으로 액세스 한 시간을 추적 하지 않습니다.The LastAccessTime element does not track the last time when the blob's metadata is accessed.

<?xml version="1.0" encoding="utf-8"?>  
<EnumerationResults ServiceEndpoint="http://myaccount.blob.core.windows.net/"  ContainerName="mycontainer">  
  <Prefix>string-value</Prefix>  
  <Marker>string-value</Marker>  
  <MaxResults>int-value</MaxResults>  
  <Delimiter>string-value</Delimiter>  
  <Blobs>  
    <Blob>  
      <Name>blob-name</name>  
      <Snapshot>date-time-value</Snapshot>  
      <VersionId>date-time-vlue</VersionId>
      <IsCurrentVersion>true</IsCurrentVersion>
      <Deleted>true</Deleted>
      <Properties> 
        <Creation-Time>date-time-value</Creation-Time>
        <Last-Modified>date-time-value</Last-Modified>  
        <Etag>etag</Etag>  
        <Content-Length>size-in-bytes</Content-Length>  
        <Content-Type>blob-content-type</Content-Type>  
        <Content-Encoding />  
        <Content-Language />  
        <Content-MD5 />  
        <Cache-Control />  
        <x-ms-blob-sequence-number>sequence-number</x-ms-blob-sequence-number>  
        <BlobType>BlockBlob|PageBlob|AppendBlob</BlobType>  
        <AccessTier>tier</AccessTier>  
        <LeaseStatus>locked|unlocked</LeaseStatus>  
        <LeaseState>available | leased | expired | breaking | broken</LeaseState>  
        <LeaseDuration>infinite | fixed</LeaseDuration>  
        <CopyId>id</CopyId>  
        <CopyStatus>pending | success | aborted | failed </CopyStatus>  
        <CopySource>source url</CopySource>  
        <CopyProgress>bytes copied/bytes total</CopyProgress>  
        <CopyCompletionTime>datetime</CopyCompletionTime>  
        <CopyStatusDescription>error string</CopyStatusDescription>  
        <ServerEncrypted>true</ServerEncrypted> 
        <CustomerProvidedKeySha256>encryption-key-sha256</CustomerProvidedKeySha256>
        <EncryptionScope>encryption-scope-name</EncryptionScope>
        <IncrementalCopy>true</IncrementalCopy>
        <AccessTierInferred>true</AccessTierInferred>
        <AccessTierChangeTime>datetime</AccessTierChangeTime>
        <DeletedTime>datetime</DeletedTime>
        <RemainingRetentionDays>no-of-days</RemainingRetentionDays>
        <TagCount>number of tags between 1 to 10</TagCount>
        <RehydratePriority>rehydrate priority</RehydratePriority>
      </Properties>  
      <Metadata>     
        <Name>value</Name>  
      </Metadata>  
      <Tags>
          <TagSet>
              <Tag>
                  <Key>TagName</Key>
                  <Value>TagValue</Value>
              </Tag>
          </TagSet>
      </Tags>
      <OrMetadata />
    </Blob>  
    <BlobPrefix>  
      <Name>blob-prefix</Name>  
    </BlobPrefix>  
  </Blobs>  
  <NextMarker />  
</EnumerationResults>  

샘플 응답Sample Response

샘플 응답은 Blob 리소스 열거 를 참조 하세요.See Enumerating Blob Resources for a sample response.

인증과Authorization

컨테이너의 ACL(액세스 제어 목록)이 컨테이너에 대한 익명 액세스를 허용하도록 설정된 경우 클라이언트가 이 작업을 호출할 수 있습니다.If the container's access control list (ACL) is set to allow anonymous access to the container, any client may call this operation. 또는 계정 소유자 및 컨테이너의 Blob를 나열할 권한에 대한 공유 액세스 서명이 있는 모든 사용자가 이 작업을 호출할 수 있습니다.Otherwise, this operation can be called by the account owner and by anyone with a Shared Access Signature that has permission to list blobs in a container.

설명Remarks

응답에서의 Blob 속성Blob Properties in the Response

열거 시 커밋되지 않은 Blob를 포함하도록 요청한 경우 일부 속성은 Blob가 커밋되어야 설정되므로 응답에서 이러한 속성이 반환되지 않을 수 있습니다.If you have requested that uncommitted blobs be included in the enumeration, note that some properties are not set until the blob is committed, so some properties may not be returned in the response.

페이지 Blob에 대해 x-ms-blob-sequence-number 요소만 반환됩니다.The x-ms-blob-sequence-number element is only returned for page blobs.

OrMetadata요소는 블록 blob에 대해서만 반환 됩니다.The OrMetadata element is only returned for block blobs.

페이지 Blob의 경우 Content-Length 요소는 Blob의 x-ms-blob-content-length 헤더 값에 해당되는 값을 반환합니다.For page blobs, the value returned in the Content-Length element corresponds to the value of the blob's x-ms-blob-content-length header.

2009-09-19 이후 버전을 사용하여 Blob에 설정된 경우에만 응답 본문에 Content-MD5 요소가 표시됩니다.The Content-MD5 element appears in the response body only if it has been set on the blob using version 2009-09-19 or later. Content-MD5Blob을 만들 때 또는 Blob 속성 설정을 호출 하 여 속성을 설정할 수 있습니다.You can set the Content-MD5 property when the blob is created or by calling Set Blob Properties. 2012-02-12 버전 이상에서 Put BlobPut Blob 요청에 MD5 헤더가 포함되지 않은 경우에도 블록 blob의 MD5 값을 설정합니다.In version 2012-02-12 and newer, Put Blob sets a block blob’s MD5 value even when the Put Blob request doesn’t include an MD5 header.

응답의 메타데이터Metadata in the Response

Metadata 요소는 include=metadata 매개 변수가 URI에 지정된 경우에만 제공됩니다.The Metadata element is present only if the include=metadata parameter was specified on the URI. Metadata 요소 내에서 각 이름-값 쌍의 값은 해당 쌍의 이름에 해당하는 요소 내에 나열됩니다.Within the Metadata element, the value of each name-value pair is listed within an element corresponding to the pair's name.

이 매개 변수로 요청된 메타데이터는 2009-09-19 버전의 Blob 서비스에 해당하는 명명 제한 사항에 따라 저장해야 합니다.Note that metadata requested with this parameter must be stored in accordance with the naming restrictions imposed by the 2009-09-19 version of the Blob service. 이 버전부터 모든 메타 데이터 이름이 c # 식별자의 명명 규칙을 준수 해야 합니다.Beginning with this version, all metadata names must adhere to the naming conventions for C# identifiers.

메타데이터 이름-값 쌍이 2009-09-19 버전에 적용되는 명명 제한 사항을 위반할 경우, 다음 XML 형식에 표시된 것처럼 응답 본문에 x-ms-invalid-name 요소 내의 잘못된 이름이 표시됩니다.If a metadata name-value pair violates the naming restrictions enforced by the 2009-09-19 version, the response body indicates the problematic name within an x-ms-invalid-name element, as shown in the following XML fragment:

  
…  
<Metadata>  
  <MyMetadata1>first value</MyMetadata1>  
  <MyMetadata2>second value</MyMetadata2>  
  <x-ms-invalid-name>invalid-metadata-name</x-ms-invalid-name>  
</Metadata>  
…  
  

응답의 태그Tags in the Response

Tags요소는 include=tags URI에 매개 변수가 지정 된 경우와 blob에 태그가 있는 경우에만 존재 합니다.The Tags element is present only if the include=tags parameter was specified on the URI and if there are tags on the blob. 요소 내에는 TagSet 최대 10 개의 Tag 요소가 반환 되며 각 요소는 key value 사용자 정의 Blob 인덱스 태그의 및를 포함 합니다.Within the TagSet element, up to 10 Tag elements are returned, each containing the key and value of the user-defined Blob Index tags. 태그의 순서는 응답에서 보장 되지 않습니다.The ordering of tags is not guaranteed in the response.

Tags TagCount Blob에 태그가 없으면 및 요소가 반환 되지 않습니다.The Tags and TagCount elements are not returned if there are no tags on the blob.

저장소 서비스는 blob과 해당 태그 사이에서 강력한 일관성을 유지 하지만, 보조 인덱스는 궁극적으로 일치 합니다.The storage service maintains strong consistency between a blob and its tags, but the secondary index is eventually consistent. 태그 작업을 통해 Blob을 찾기 위해 태그를 표시 하기 전에 Blob을 나열 하는 응답에서 태그를 볼 수 있습니다.Tags may be visible in a response to List Blobs before they are visible to Find Blobs by Tags operations.

응답의 스냅숏Snapshots in the Response

URI에 include=snapshots 매개 변수가 지정된 경우에만 스냅숏이 응답에 나열됩니다.Snapshots are listed in the response only if the include=snapshots parameter was specified on the URI. 스냅숏은 활성 임대를 가질 수 없으므로 응답에 나열된 스냅숏에는 LeaseStatus 요소가 포함되지 않습니다.Snapshots listed in the response do not include the LeaseStatus element, as snapshots cannot have active leases.

구분 기호와 함께 List Blobs을 호출할 경우 열거형에 스냅숏을 포함할 수 없습니다.If you call List Blobs with a delimiter, you cannot also include snapshots in the enumeration. 요청에서 둘 다 포함하면 InvalidQueryParameter 오류(HTTP 상태 코드 400 - 잘못된 요청)를 반환합니다.A request that includes both returns an InvalidQueryParameter error (HTTP status code 400 – Bad Request).

응답에서 커밋되지 않은 BlobUncommitted Blobs in the Response

URI에 include=uncommittedblobs 매개 변수가 지정된 경우에만 커밋되지 않은 Blob가 응답에 나열됩니다.Uncommitted blobs are listed in the response only if the include=uncommittedblobs parameter was specified on the URI. 응답에 나열된 커밋되지 않은 Blob에는 다음 요소가 포함되지 않습니다.Uncommitted blobs listed in the response do not include any of the following elements:

  • Last-Modified

  • Etag

  • Content-Type

  • Content-Encoding

  • Content-Language

  • Content-MD5

  • Cache-Control

  • Metadata

응답에서 Blob을 삭제 했습니다.Deleted Blobs in the Response

삭제 된 blob는 include=deleted URI에 매개 변수가 지정 된 경우에만 응답에 나열 됩니다.Deleted blobs are listed in the response only if the include=deleted parameter was specified on the URI. 응답에 나열 된 삭제 된 blob은 삭제 된 blob에 활성 임대가 있을 수 없기 때문에 임대 요소를 포함 하지 않습니다.Deleted blobs listed in the response do not include the Lease elements as deleted blobs cannot have active leases.

URI에가 지정 된 경우 삭제 된 스냅숏은 목록 응답에 포함 됩니다 include=deleted,snapshot .Deleted snapshots are included in list response if include=deleted,snapshot was specified on the URI.

응답의 개체 복제 메타 데이터Object Replication Metadata in the Response

OrMetadata요소는 blob에서 개체 복제 정책이 평가 되 고 목록 blob 호출이 버전 2019-12-12 이상을 사용 하 여 수행 된 경우에 존재 합니다.The OrMetadata element is present when an Object Replication policy has been evaluated on a blob and the List Blobs call was made using version 2019-12-12 or later. OrMetadata 요소 내에서 각 이름-값 쌍의 값은 해당 쌍의 이름에 해당하는 요소 내에 나열됩니다.Within the OrMetadata element, the value of each name-value pair is listed within an element corresponding to the pair's name. 이름 형식은입니다 or-{policy-id}_{rule-id} {policy-id} . 여기서는 저장소 계정의 개체 복제 정책 식별자를 나타내는 guid 이며 {rule-id} 은 저장소 컨테이너의 규칙 식별자를 나타내는 guid입니다.The format of name is or-{policy-id}_{rule-id}, where {policy-id} is a guid representing the object replication policy identifier on the storage account and {rule-id} is a guid representing the rule identifier on the storage container. 유효한 값은 complete / failed 입니다.Valid values are complete/failed.

  
…  
<OrMetadata>  
  <or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>complete</or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>  
  <or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>failed</or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>  
</OrMetadata>  
…  
  

표식 값을 사용하여 결과 집합 반환Returning Result Sets Using a Marker Value

지정된 maxresults 매개 변수의 값 또는 기본 maxresults의 기본값을 초과하는 수의 Blob를 반환해야 할 경우 응답 본문에는 후속 요청에 반환할 추가 Blob가 있음을 나타내는 NextMarker 요소가 포함됩니다.If you specify a value for the maxresults parameter and the number of blobs to return exceeds this value, or exceeds the default value for maxresults, the response body will contain a NextMarker element that indicates the next blob to return on a subsequent request. 다음 항목 집합을 반환하려면 후속 요청의 URI에서 마커 매개 변수로 NextMarker 값을 지정합니다.To return the next set of items, specify the value of NextMarker as the marker parameter on the URI for the subsequent request.

NextMarker 값은 불투명으로 처리해야 합니다.Note that the value of NextMarker should be treated as opaque.

구분 기호를 사용하여 Blob 네임스페이스 분리Using a Delimiter to Traverse the Blob Namespace

delimiter 매개 변수는 호출자가 사용자 구성 구분 기호를 사용하여 Blob 네임스페이스를 분리할 수 있도록 합니다.The delimiter parameter enables the caller to traverse the blob namespace by using a user-configured delimiter. 이렇게 하면 파일 시스템에서와 같이 blob의 가상 계층을 트래버스할 수 있습니다.In this way, you can traverse a virtual hierarchy of blobs as though it were a file system. 이 구분 기호는 단일 문자이거나 문자열일 수 있습니다.The delimiter may be a single character or a string. 요청에 이 매개 변수가 포함되면 작업이 BlobPrefix 요소를 반환합니다.When the request includes this parameter, the operation returns a BlobPrefix element. 구분 기호 문자까지 표시되는 하위 문자열과 동일한 이름으로 시작하는 모든 Blob 대신 BlobPrefix 요소가 반환됩니다.The BlobPrefix element is returned in place of all blobs whose names begin with the same substring up to the appearance of the delimiter character. 요소의 값은 BlobPrefix substring + delimiter이며, 여기서 substring 은 하나 이상의 blob 이름으로 시작 하는 공통 하위 문자열이 고, delimiterdelimiter 매개 변수의 값입니다.The value of the BlobPrefix element is substring+delimiter, where substring is the common substring that begins one or more blob names, and delimiter is the value of the delimiter parameter.

BlobPrefix 의 값을 사용해서 요청 URI에 prefix 매개 변수에 대한 BlobPrefix 값을 지정하여 이 접두사로 시작하는 blob를 나열하도록 후속 호출을 수행할 수 있습니다.You can use the value of BlobPrefix to make a subsequent call to list the blobs that begin with this prefix, by specifying the value of BlobPrefix for the prefix parameter on the request URI.

BlobPrefix 요소와 마찬가지로 최대 결과 수까지 각 Blob 요소가 반환됩니다.Note that each BlobPrefix element returned counts toward the maximum result, just as each Blob element does.

Blob는 응답 본문에 대문자부터 시작하는 알파벳 순서로 나열됩니다.Blobs are listed in alphabetical order in the response body, with upper-case letters listed first.

CopyStatusDescription의 복사 오류Copy errors in CopyStatusDescription

CopyStatusDescription에는 Copy Blob 오류에 대한 자세한 정보가 포함됩니다.CopyStatusDescription contains more information about the Copy Blob failure.

  • 복사 시도가 실패하여 Blob service가 작업을 재시도할 때 CopyStatuspending으로 설정되며, CopyStatusDescription은 마지막 복사 시도에서 발생한 오류에 대해 설명합니다.When a copy attempt fails and the Blob service is still retrying the operation, CopyStatus is set to pending, and the CopyStatusDescription text describes the failure that may have occurred during the last copy attempt.

  • CopyStatusfailed로 설정되면 CopyStatusDescription은 복사 작업이 실패하게 된 오류를 설명합니다.When CopyStatus is set to failed, the CopyStatusDescription text describes the error that caused the copy operation to fail.

다음 표에서는 모든 CopyStatusDescription 값의 세 가지 필드에 대해 설명합니다.The following table describes the three fields of every CopyStatusDescription value.

구성 요소Component DescriptionDescription
HTTP 상태 코드HTTP status code 오류를 나타내는 표준 세 자리 정수입니다.Standard 3-digit integer specifying the failure.
오류 코드Error code Azure에서 <ErrorCode 요소에 제공 하는 오류를 설명 하는 키워드 > 입니다.Keyword describing error that is provided by Azure in the <ErrorCode> element. <ErrorCode > 요소가 표시 되지 않으면 http 사양의 3 자리 http 상태 코드와 연결 된 표준 오류 텍스트가 포함 된 키워드가 사용 됩니다.If no <ErrorCode> element appears, a keyword containing standard error text associated with the 3-digit HTTP status code in the HTTP specification is used. 일반적인 REST API 오류 코드를 참조 하세요.See Common REST API Error Codes.
정보Information 따옴표로 표시된 오류에 대한 자세한 설명입니다.Detailed description of failure, in quotes.

다음 표에서는 일반적인 오류 시나리오의 CopyStatusCopyStatusDescription 값에 대해 설명합니다.The following table describes the CopyStatus and CopyStatusDescription values of common failure scenarios.

중요

여기에 표시된 설명 텍스트는 버전 변경이 없더라도 경고 없이 변경될 수 있으므로 이 텍스트와 정확히 일치하지 않을 수 있습니다.Description text shown here can change without warning, even without a version change, so do not rely on matching this exact text.

시나리오Scenario CopyStatus 값CopyStatus value CopyStatusDescription 값CopyStatusDescription value
복사 작업이 성공적으로 완료되었습니다.Copy operation completed successfully. 성공success 비어 있음empty
사용자가 복사 작업이 완료되기 전에 작업을 중단했습니다.User aborted copy operation before it completed. 중단됨aborted 비어 있음empty
복사 작업 중 원본 blob에서 읽기를 수행할 때 오류가 발생했지만 작업이 다시 시도됩니다.A failure occurred when reading from the source blob during a copy operation, but the operation will be retried. 보류 중pending 502 잘못된 게이트웨이 "원본을 읽을 때 다시 시도 가능한 오류가 발생했습니다.502 BadGateway "Encountered a retryable error when reading the source. 다시 시도합니다.Will retry. 실패 시간: <시간 > "Time of failure: <time>"
복사 작업의 대상 blob에 쓰는 중 오류가 발생했지만 작업이 다시 시도됩니다.A failure occurred when writing to the destination blob of a copy operation, but the operation will be retried. 보류 중pending 500 InternalServerError "다시 시도 가능한 오류가 발생했습니다.500 InternalServerError "Encountered a retryable error. 다시 시도합니다.Will retry. 실패 시간: <시간 > "Time of failure: <time>"
복사 작업의 원본 blob에서 읽기를 수행할 때 복구할 수 없는 오류가 발생했습니다.An unrecoverable failure occurred when reading from the source blob of a copy operation. 실패failed 404 ResourceNotFound "원본을 읽을 때 복사가 실패했습니다."404 ResourceNotFound "Copy failed when reading the source." 참고: 이 기본 오류를 보고할 때 Azure는 ResourceNotFound <ErrorCode 요소에서를 반환 합니다 > .Note: When reporting this underlying error, Azure returns ResourceNotFound in the <ErrorCode> element. 응답에 <ErrorCode > 요소가 표시 되지 않으면와 같은 HTTP 상태의 표준 문자열 표현이 NotFound 표시 됩니다.If no <ErrorCode> element appeared in the response, a standard string representation of the HTTP status such as NotFound would appear.
모든 복사 작업을 제한하는 제한 시간이 경과되었습니다.The timeout period limiting all copy operations elapsed. (현재 제한 시간은 2주입니다.)(Currently the timeout period is 2 weeks.) 실패failed 500 OperationCancelled "복사에 허용된 최대 시간을 초과했습니다."500 OperationCancelled "The copy exceeded the maximum allowed time."
원본에서 읽을 때 복사 작업이 너무 자주 실패했고 최소한의 성공 시도 비율을 충족하지 않았습니다.The copy operation failed too often when reading from the source, and didn’t meet a minimum ratio of attempts to successes. (이 제한 시간은 품질 수준이 매우 낮은 원본이 실패하기 전에 2주 동안 다시 시도되지 않도록 방지합니다.)(This timeout prevents retrying a very poor source over 2 weeks before failing). 실패failed 500 OperationCancelled "원본을 읽을 때 복사가 실패했습니다."500 OperationCancelled "The copy failed when reading the source."

참고 항목See also

상태 및 오류 코드 Status and Error Codes
Blob 서비스 오류 코드Blob Service Error Codes