제안 가져오기
제품 리소스를 검색하려면 제품 리소스에서 GET을 수행합니다.
요청
| 메서드 | 요청 URI | 설명 |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} |
{databaseaccount}는 구독에서 만든 Azure Cosmos DB 계정의 이름입니다. {_rid-offer} 값은 제품의 시스템 생성 리소스 ID입니다. |
헤더
모든 Cosmos DB 요청 에서 사용되는 헤더는 일반적인 Azure Cosmos DB REST 요청 헤더를 참조하세요.
master 키 토큰에 대한 해시된 서명을 생성할 때 ResourceType은 "제안"이어야 합니다. ResourceLink는 검색하려는 제품의 _rid 합니다. 값은 소문자여야 합니다. 예를 들어 에서 GEThttps://querydemo.documents.azure.com/offers/uT2L을 수행할 때 master 키 토큰의 ResourceLink는 "ut2l"이어야 합니다.
본문
없음
응답
요청된 제품 리소스를 반환합니다.
헤더
모든 Cosmos DB 응답 에서 반환되는 헤더는 일반적인 Azure Cosmos DB REST 응답 헤더를 참조하세요.
상태 코드
다음 표에는 이 작업에서 반환하는 일반적인 상태 코드가 나열되어 있습니다. 상태 코드의 전체 목록은 HTTP 상태 코드를 참조하세요.
| HTTP 상태 코드 | Description |
|---|---|
| 200 정상 | 작업이 완료되었습니다. |
| 404 찾을 수 없음 | 제품은 더 이상 리소스가 아닙니다. 즉, 부모 컬렉션 리소스가 삭제되었습니다. |
본문
| 속성 | Description |
|---|---|
| offerVersion | 이 값은 미리 정의된 처리량 수준의 경우 V1, 사용자 정의 처리량 수준의 경우 V2일 수 있습니다. |
| offerType | 이 값은 V1 제품 버전의 성능 수준을 나타내며, V1 제품에 허용되는 값은 S1, S2 또는 S3입니다. 이 속성은 V2 제품 버전에 대해 Invalid로 설정됩니다. |
| content | 제품에 대한 정보가 포함되어 있습니다. V2 제품의 경우 컬렉션의 처리량이 포함됩니다. |
| resource | 새 컬렉션을 만들 때 이 속성은 컬렉션의 자체 링크(예: dbs/pLJdAA==/colls/pLJdAOlEdgA=/)로 설정됩니다. |
| offerResourceId | 컬렉션을 만드는 동안 이 속성은 리소스 ID, 즉 컬렉션의 _rid 자동으로 연결됩니다. 위의 예제에서 컬렉션의 _rid pLJdAOlEdgA=입니다. |
| id | 시스템 생성 속성입니다. 제품 리소스의 ID 는 생성될 때 자동으로 생성됩니다. 제품의 _rid 값과 같습니다. |
| _rid | 시스템 생성 속성입니다. 리소스 ID(_rid)는 리소스 모델의 리소스 스택당 계층적인 고유 식별자입니다. 제안의 배치와 탐색용으로 내부에서 사용됩니다. |
| _ts | 시스템 생성 속성입니다. 리소스가 마지막으로 업데이트된 시간의 타임스탬프를 지정합니다. 값은 타임스탬프입니다. |
| _self | 시스템 생성 속성입니다. 고유한 주소를 지정할 수 있는 리소스의 URI입니다. |
| _etag | 낙관적 동시성 제어에 필요한 리소스 etag를 지정하는 시스템 생성 속성입니다. |
{
"offerVersion": "V2",
"offerType": "Invalid",
"content": {
"offerThroughput": 4000
},
"resource": "dbs/rgkVAA==/colls/rgkVAMHcJww=/",
"offerResourceId": "rgkVAMHcJww=",
"id": "uT2L",
"_rid": "uT2L",
"_self": "offers/uT2L/",
"_etag": "\"0000a600-0000-0000-0000-56fac0570000\"",
"_ts": 1459273815
}
예제
GET https://querydemo.documents.azure.com/offers/uT2L HTTP/1.1
x-ms-date: Tue, 29 Mar 2016 17:50:18 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dA9Y9JAZylsBHG%2bM1Rdb3PpzO3Fw7kMJbRUJ8Llh2kpo%3d
Cache-Control: no-cache
User-Agent: Microsoft.Azure.Documents.Client/1.6.0.0 samples-net/3
x-ms-version: 2015-12-16
Accept: application/json
Host: querydemo.documents.azure.com
HTTP/1.1 200 Ok
Cache-Control: no-store, no-cache
Pragma: no-cache
Transfer-Encoding: chunked
Content-Type: application/json
Content-Location: https://querydemo.documents.azure.com/offers/uT2L
Server: Microsoft-HTTPAPI/2.0
Strict-Transport-Security: max-age=31536000
x-ms-last-state-change-utc: Fri, 25 Mar 2016 21:27:20.035 GMT
etag: "0000a600-0000-0000-0000-56fac0570000"
x-ms-schemaversion: 1.1
x-ms-request-charge: 2
x-ms-serviceversion: version=1.6.52.5
x-ms-activity-id: bfa5991d-46f5-4c40-b3f0-957fccd8df9e
x-ms-session-token: M:8110
x-ms-gatewayversion: version=1.6.52.5
x-ms-cosmos-min-throughput: 400
Date: Tue, 29 Mar 2016 17:50:18 GMT
{
"offerVersion": "V2",
"offerType": "Invalid",
"content": {
"offerThroughput": 4000
},
"resource": "dbs/rgkVAA==/colls/rgkVAMHcJww=/",
"offerResourceId": "rgkVAMHcJww=",
"id": "uT2L",
"_rid": "uT2L",
"_self": "offers/uT2L/",
"_etag": "\"0000a600-0000-0000-0000-56fac0570000\"",
"_ts": 1459273815
}
설명
컨테이너 또는 데이터베이스에서 설정할 수 있는 최대 및 최소 프로비전된 처리량에 대한 자세한 내용은 컨테이너 및 데이터베이스에 처리량 프로비전 문서를 참조하세요.
제품 리소스에서 GET을 수행하여 지정된 컨테이너 또는 데이터베이스에 대해 설정할 수 있는 최소 처리량을 검색합니다. 응답 헤더 x-ms-cosmos-min-throughput 는 시스템에서 결정된 최소 처리량을 표시합니다.