DocumentClient.ReadOfferAsync(String) Método

Definición

Espacio de nombres:

Microsoft.Azure.Documents.Client

Ensamblados:

Microsoft.Azure.DocumentDB.Core.dll, Microsoft.Azure.Documents.Client.dll

Paquetes:

Microsoft.Azure.DocumentDB v2.18.0, Microsoft.Azure.DocumentDB.Core v2.18.0

Lee un Offer elemento del servicio Azure Cosmos DB como una operación asincrónica.

public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Offer>> ReadOfferAsync (string offerLink);

abstract member ReadOfferAsync : string -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Offer>>
override this.ReadOfferAsync : string -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.Offer>>

Public Function ReadOfferAsync (offerLink As String) As Task(Of ResourceResponse(Of Offer))

Parámetros

offerLink

String

Vínculo a la oferta que se va a leer.

Devoluciones

Task<ResourceResponse<Offer>>

que System.Threading.Tasks contiene un ResourceResponse<TResource>Offer objeto que contiene el registro de recursos de lectura.

Implementaciones

ReadOfferAsync(String)

Excepciones

ArgumentNullException

Si offerLink no se establece.

DocumentClientException

Esta excepción puede encapsular muchos tipos diferentes de errores. Para determinar el error específico, examine siempre la propiedad StatusCode. Algunos códigos comunes que puede obtener al crear un documento son:

StatusCode	Motivo de la excepción
404	NotFound: significa que el recurso que intentó leer no existía.
429	TooManyRequests: esto significa que ha superado el número de unidades de solicitud por segundo. Consulte el valor DocumentClientException.RetryAfter para ver cuánto tiempo debe esperar antes de volver a intentar esta operación.

Ejemplos

//Reads an Offer resource from a Database
// - offer_id is the ID of the offer to be read
var offerLink = "/offers/offer_id";
Offer offer = await client.ReadOfferAsync(offerLink);

Comentarios

Realizar una lectura de un recurso es la manera más eficaz de obtener un recurso de la base de datos. Si conoce el identificador del recurso, realice una lectura en lugar de una consulta por identificador.

Para una oferta, el sistema siempre genera el identificador internamente cuando se crea el recurso vinculado. id y _rid siempre son los mismos para oferta.

Consulte para https://docs.microsoft.com/en-us/azure/cosmos-db/how-to-provision-container-throughput obtener más información sobre el rendimiento mínimo de un contenedor de Cosmos (o una base de datos) Para recuperar el rendimiento mínimo de una colección o base de datos, use el ejemplo siguiente.

// Find the offer for the collection by SelfLink
Offer offer = client.CreateOfferQuery(
    string.Format("SELECT * FROM offers o WHERE o.resource = '{0}'", collectionSelfLink)).AsEnumerable().FirstOrDefault();
ResourceResponse<Offer> response = await client.ReadOfferAsync(offer.SelfLink);
string minimumRUsForCollection = response.ResponseHeaders["x-ms-cosmos-min-throughput"];

Consulte también

• ResourceResponse<TResource>
• Task
• Uri
• Conflict
• RequestOptions