Een aanbieding krijgen
Als u een aanbiedingsresource wilt ophalen, voert u een GET uit op de resource Aanbieding .
Aanvraag
| Methode | Aanvraag-URI | Beschrijving |
|---|---|---|
| GET | https://{databaseaccount}.documents.azure.com/offers/{_rid-offer} |
Houd er rekening mee dat {databaseaccount} de naam is van het Azure Cosmos DB-account dat u hebt gemaakt onder uw abonnement. De waarde {_rid-offer} is de door het systeem gegenereerde resource-id van de aanbieding. |
Kopteksten
Zie Algemene Azure Cosmos DB REST-aanvraagheaders voor headers die worden gebruikt door alle Cosmos DB-aanvragen.
Bij het maken van de gehashte handtekening voor het hoofdsleuteltoken moet het ResourceType 'aanbiedingen' zijn. De ResourceLink mag alleen de _rid zijn van de aanbieding die u wilt ophalen. De waarde moet kleine letters zijn. Wanneer u bijvoorbeeld een GET uitvoert op https://querydemo.documents.azure.com/offers/uT2L, moet de ResourceLink in het hoofdsleuteltoken 'ut2l' zijn.
Hoofdtekst
Geen.
Antwoord
Retourneert de aangevraagde aanbiedingsresource.
Kopteksten
Zie Algemene Azure Cosmos DB REST-antwoordheaders voor headers die worden geretourneerd door alle Cosmos DB-antwoorden.
Statuscodes
De volgende tabel bevat algemene statuscodes die door deze bewerking worden geretourneerd. Zie HTTP-statuscodes voor een volledige lijst met statuscodes.
| HTTP-statuscode | Beschrijving |
|---|---|
| 200 Ok | De bewerking is geslaagd. |
| 404 Niet gevonden | De aanbieding is niet langer een resource, dat wil gezegd dat de bovenliggende verzamelingsresource is verwijderd. |
Hoofdtekst
| Eigenschap | Beschrijving |
|---|---|
| offerVersion | Deze waarde kan V1 zijn voor vooraf gedefinieerde doorvoerniveaus en V2 voor door de gebruiker gedefinieerde doorvoerniveaus. |
| offerType | Deze waarde geeft het prestatieniveau voor de versie van de V1-aanbieding aan. Toegestane waarden voor V1-aanbieding zijn S1, S2 of S3. Deze eigenschap is ingesteld op Ongeldig voor V2-aanbiedingsversie. |
| Inhoud | Het bevat informatie over de aanbieding. Voor V2-aanbiedingen bevat deze de doorvoer van de verzameling. |
| Resource | Wanneer u een nieuwe verzameling maakt, wordt deze eigenschap ingesteld op de zelfkoppeling van de verzameling, bijvoorbeeld dbs/pLJdAA==/colls/pLJdAOlEdgA=/. |
| offerResourceId | Tijdens het maken van een verzameling wordt deze eigenschap automatisch gekoppeld aan de resource-id, dat wil _rid van de verzameling. In het bovenstaande voorbeeld is de _rid voor de verzameling pLJdAOlEdgA=. |
| id | Het is een door het systeem gegenereerde eigenschap. De id voor de aanbiedingsresource wordt automatisch gegenereerd wanneer deze wordt gemaakt. Deze heeft dezelfde waarde als de _rid voor de aanbieding. |
| _Ontdoen | Het is een door het systeem gegenereerde eigenschap. De resource-id (_rid) is een unieke id die ook hiërarchisch is per resourcestack in het resourcemodel. Het wordt intern gebruikt voor plaatsing en navigatie van de aanbieding. |
| _Ts | Het is een door het systeem gegenereerde eigenschap. Hiermee wordt de tijdstempel van de resource voor het laatst bijgewerkt. De waarde is een tijdstempel. |
| _Zelf | Het is een door het systeem gegenereerde eigenschap. Dit is de unieke adresseerbare URI voor de resource. |
| _etag | Het is een door het systeem gegenereerde eigenschap die de resource-etag aangeeft die is vereist voor optimistisch gelijktijdigheidsbeheer. |
{
"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
}
Voorbeeld
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
}
Opmerkingen
Zie het artikel Doorvoer inrichten voor containers en databases voor meer informatie over de maximale en minimale ingerichte doorvoer die kan worden ingesteld voor een container of database.
Voer GET uit op de aanbiedingsresource om de minimale doorvoer op te halen die voor een bepaalde container of database kan worden ingesteld. De antwoordheader x-ms-cosmos-min-throughput geeft de door het systeem bepaalde minimale doorvoer aan.