내보내기(0) 인쇄
모두 확장

큐 메타데이터 설정

업데이트 날짜: 2015년 2월

Set Queue Metadata 작업은 지정된 큐에서 사용자 정의 메타데이터를 설정합니다. 메타데이터는 큐에 이름-값 쌍으로 연결됩니다.

다음과 같이 Set Queue Metadata 요청을 생성할 수 있습니다. HTTPS를 사용하는 것이 좋습니다.

 

방법 요청 URI HTTP 버전

PUT

https://myaccount.queue.core.windows.net/myqueue?comp=metadata

HTTP/1.1

에뮬레이트된 저장소 서비스에 대해 요청을 수행할 때는 에뮬레이터 호스트 이름 및 큐 서비스 포트를 127.0.0.1:10001으로 지정하고 뒤에 에뮬레이트된 저장소 계정 이름을 붙입니다.

 

방법 요청 URI HTTP 버전

PUT

http://127.0.0.1:10001/devstoreaccount1/myqueue?comp=metadata

HTTP/1.1

요청 URI에 다음과 같은 추가 매개 변수를 지정할 수 있습니다.

 

매개 변수 설명

timeout

선택적 요소입니다. timeout 매개 변수는 초 단위로 표시됩니다. 자세한 내용은 큐 서비스 작업의 제한 시간 설정를 참조하세요.

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.

 

요청 헤더 설명

Authorization

필수 사항입니다. 인증 체계, 계정 이름 및 서명을 지정합니다. 자세한 내용은 Azure 저장소 서비스에 대한 인증를 참조하세요.

Date 또는 x-ms-date

필수 사항입니다. 요청의 UCT(협정 세계시)를 지정합니다. 자세한 내용은 Azure 저장소 서비스에 대한 인증를 참조하세요.

x-ms-version

선택적 요소입니다. 이 요청에 사용할 작업의 버전을 지정합니다. 자세한 내용은 Windows Azure에서 Blob, 큐 및 테이블 서비스의 버전 관리를 참조하세요.

x-ms-meta-name:string-value

선택적 요소입니다. 큐를 메타데이터로 연결하기 위한 이름-값 쌍입니다.

이 작업을 호출할 때마다 큐에 연결된 기존의 모든 메타데이터가 바뀝니다. 큐에서 모든 메타데이터를 제거하려면 메타데이터 헤더 없이 이 작업을 호출하십시오.

2009-09-19 버전부터는 메타데이터 이름이 C# 식별자의 명명 규칙을 따라야 합니다.

x-ms-client-request-id

선택적 요소입니다. 저장소 분석 로깅을 사용하도록 설정한 경우 분석 로그에 기록된 1KB 문자 제한의 클라이언트에서 생성한 불투명 값을 제공합니다. 클라이언트 쪽 작업과 서버가 받은 요청의 상관 관계를 지정하는 데 이 헤더를 사용하는 것이 좋습니다. 자세한 내용은 저장소 분석 로깅 정보Azure 로깅: 로그를 사용하여 저장소 요청 추적을 참조하세요.

없음.

Request Syntax:
PUT https://myaccount.queue.core.windows.net/myqueue?comp=metadata HTTP/1.1

Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Fri, 16 Sep 2011 01:47:14 GMT
x-ms-meta-meta-sample1: sample1
x-ms-meta-meta-sample2: sample2
Authorization: SharedKey myaccount:u6PSIebDltGW5xHpO77epRpiUhcsTkWMvcM4GTmfqqA=

응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.

작업이 성공하면 상태 코드 204(콘텐츠 없음)이 반환됩니다.

상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하십시오.

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 따릅니다.

 

응답 헤더 설명

x-ms-request-id

이 헤더는 수행된 요청을 고유하게 식별하며, 이 헤더를 사용해서 요청 문제를 해결할 수 있습니다. 자세한 내용은 API 작업 문제 해결를 참조하세요.

x-ms-version

요청을 실행하는 데 사용되는 큐 서비스의 버전을 나타냅니다. 이 헤더는 2009-09-19 버전 이상에 대해 수행된 요청에 대해 반환됩니다.

Date

응답이 시작된 시간을 나타내는 서비스에서 생성된 UTC 날짜/시간 값입니다.

없음.

계정 소유자만 이 작업을 호출할 수 있습니다.

큐 메타데이터를 삭제하려면 메타데이터 헤더를 지정하지 않고 Set Queue Metadata을 호출합니다.

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2015 Microsoft