Angebot abrufen
Um eine Angebotsressource abzurufen, führen Sie eine GET für die Angebotsressource aus.
Anforderung
| Methode | Anforderungs-URI | BESCHREIBUNG |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} |
Beachten Sie, dass {databaseaccount} der Name des Azure Cosmos DB-Kontos ist, das Sie unter Ihrem Abonnement erstellt haben. Der Wert {_rid-offer} ist die vom System generierte Ressourcen-ID des Angebots. |
Header
Informationen zu Headern, die von allen Cosmos DB-Anforderungen verwendet werden, finden Sie unter Allgemeine Azure Cosmos DB-REST-Anforderungsheader .
Beim Erstellen der Hashsignatur für das master Schlüsseltokens sollte der ResourceType "offers" sein.
Der ResourceLink sollte nur der _rid des Angebots sein, das Sie abrufen möchten. Der Wert muss kleingeschrieben sein. Wenn Sie beispielsweise eine GET auf https://querydemo.documents.azure.com/offers/uT2Lausführen, sollte der ResourceLink im master Schlüsseltoken "ut2l" sein.
Text
Keine.
Antwort
Gibt die angeforderte Angebotsressource zurück.
Header
Informationen zu Headern, die von allen Cosmos DB-Antworten zurückgegeben werden, finden Sie unter Allgemeine Azure Cosmos DB-REST-Antwortheader .
Statuscodes
In der folgenden Tabelle sind die allgemeinen Statuscodes aufgeführt, die von diesem Vorgang zurückgegeben werden. Eine vollständige Liste der status Codes finden Sie unter HTTP-Statuscodes.
| HTTP-Statuscode | BESCHREIBUNG |
|---|---|
| 200 Ok | Der Vorgang wurde durchgeführt. |
| 404 – Nicht gefunden | Das Angebot ist keine Ressource mehr, d. h. die übergeordnete Sammlungsressource wurde gelöscht. |
Body
| Eigenschaft | BESCHREIBUNG |
|---|---|
| offerVersion | Dieser Wert kann V1 für vordefinierte Durchsatzstufen und V2 für benutzerdefinierte Durchsatzstufen sein. |
| offerType | Dieser Wert gibt die Leistungsstufe für die V1-Angebotsversion an. Zulässige Werte für das V1-Angebot sind S1, S2 oder S3. Diese Eigenschaft ist für die V2-Angebotsversion auf Ungültig festgelegt. |
| content | Sie enthält Informationen zum Angebot. Bei V2-Angeboten enthält sie den Durchsatz der Auflistung. |
| resource | Beim Erstellen einer neuen Auflistung wird diese Eigenschaft auf die Selbstverknüpfung der Auflistung festgelegt, z. B. dbs/pLJdAA==/colls/pLJdAOlEdgA=/. |
| offerResourceId | Während der Erstellung einer Auflistung wird diese Eigenschaft automatisch der Ressourcen-ID zugeordnet, d. h. _rid der Auflistung. Im obigen Beispiel lautet der _rid für die Auflistung pLJdAOlEdgA=. |
| id | Es handelt sich um eine vom System generierte Eigenschaft. Die ID für die Angebotsressource wird automatisch generiert, wenn sie erstellt wird. Es hat den gleichen Wert wie die _rid für das Angebot. |
| _los | Es handelt sich um eine vom System generierte Eigenschaft. Die Ressourcen-ID (_rid) ist ein eindeutiger Bezeichner, der auch je nach Ressourcenstapel im Ressourcenmodell hierarchisch ist. Sie wird intern für die Platzierung und Navigation des Angebots verwendet. |
| _Ts | Es handelt sich um eine vom System generierte Eigenschaft. Sie gibt den zuletzt aktualisierten Zeitstempel der Ressource an. Der Wert ist ein Zeitstempel. |
| _Selbst | Es handelt sich um eine vom System generierte Eigenschaft. Es handelt sich um den eindeutigen, adressierbaren URI für die Ressource. |
| _Etag | Es handelt sich um eine vom System generierte Eigenschaft, die das Ressourcen-Etag angibt, das für die Kontrolle der optimistischen Parallelität erforderlich ist. |
{
"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
}
Beispiel
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
}
Hinweise
Weitere Informationen zum maximalen und minimalen bereitgestellten Durchsatz, der für einen Container oder eine Datenbank festgelegt werden kann, finden Sie im Artikel Bereitstellen von Durchsatz für Container und Datenbanken .
Führen Sie GET für die Angebotsressource aus, um den Mindestdurchsatz abzurufen, der für einen bestimmten Container oder eine Datenbank festgelegt werden kann. Der Antwortheader x-ms-cosmos-min-throughput gibt den vom System ermittelten Mindestdurchsatz an.