Получение предложения

  • Статья

Чтобы получить ресурс предложения, выполните get для ресурса Offer .

Запрос

Метод Универсальный код ресурса (URI) запроса Описание
GET https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} Обратите внимание, что {databaseaccount} — это имя учетной записи Azure Cosmos DB, созданной в рамках подписки. Значение {_rid-offer} — это созданный системой идентификатор ресурса предложения.

Заголовки

Заголовки, используемые всеми запросами Cosmos DB, см. в статье Общие заголовки запросов REST Azure Cosmos DB .

При создании хэш-подписи для маркера ключа master значение ResourceType должно иметь значение "предложения". ResourceLink должна быть только _rid предложения, которое вы хотите получить. Значение должно быть строчным. Например, при выполнении get в https://querydemo.documents.azure.com/offers/uT2Lпараметре ResourceLink в маркере ключа master должно быть задано значение "ut2l".

Текст

Нет.

Ответ

Возвращает запрошенный ресурс предложения.

Заголовки

Заголовки, возвращаемые всеми ответами Cosmos DB, см. в статье Общие заголовки ответов REST Azure Cosmos DB .

Коды состояния

В таблице ниже указаны стандартные коды состояния, возвращаемые этой операцией. Полный список кодов состояния см. в разделе Коды состояния HTTP.

Код состояния HTTP Описание
200 (ОК) Операция выполнена успешно.
404 — не найдено Предложение больше не является ресурсом, то есть ресурс родительской коллекции был удален.

Текст

Свойство Описание
OfferVersion Это значение может быть V1 для предварительно определенных уровней пропускной способности и V2 для определяемых пользователем уровней пропускной способности.
offerType Это значение указывает уровень производительности для версии предложения версии 1, допустимые значения для предложения версии 1: S1, S2 или S3. Для версии предложения версии 2 это свойство имеет значение Invalid.
content Он содержит сведения о предложении. Для предложений версии 2 она содержит пропускную способность коллекции.
resource При создании новой коллекции этому свойству присваивается самостоятельная связь коллекции, например dbs/pLJdAA==/colls/pLJdAOlEdgA=/.
offerResourceId Во время создания коллекции это свойство автоматически связывается с идентификатором ресурса, то есть _rid коллекции. В приведенном выше примере _rid для коллекции — pLJdAOlEdgA=.
идентификатор Это свойство, созданное системой. Идентификатор ресурса предложения создается автоматически при его создании. Он имеет то же значение, что и _rid для предложения.
_rid Это свойство, созданное системой. Идентификатор ресурса (_rid) — это уникальный идентификатор, который также является иерархическим для стека ресурсов в модели ресурсов. Он используется системой для размещения предложения и перемещения по нему.
_Ts Это свойство, созданное системой. Оно представляет метку времени последнего обновления ресурса. Значение — метка времени.
_Самостоятельно Это свойство, созданное системой. Это уникальный адресуемый URI для ресурса.
_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 ответа обозначает минимальную пропускную способность, определенную системой.

См. также: