IDocumentClient.CreateDocumentCollectionAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
CreateDocumentCollectionAsync(String, DocumentCollection, RequestOptions) |
Crea una colección como una operación asincrónica en el servicio Azure Cosmos DB. |
CreateDocumentCollectionAsync(Uri, DocumentCollection, RequestOptions) |
Crea una colección como una operación asincrónica en el servicio Azure Cosmos DB. |
CreateDocumentCollectionAsync(String, DocumentCollection, RequestOptions)
Crea una colección como una operación asincrónica en el servicio Azure Cosmos DB.
public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.DocumentCollection>> CreateDocumentCollectionAsync (string databaseLink, Microsoft.Azure.Documents.DocumentCollection documentCollection, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member CreateDocumentCollectionAsync : string * Microsoft.Azure.Documents.DocumentCollection * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.DocumentCollection>>
Public Function CreateDocumentCollectionAsync (databaseLink As String, documentCollection As DocumentCollection, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of DocumentCollection))
Parámetros
- databaseLink
- String
Vínculo de la base de datos en la que se va a crear la colección. Por ejemplo, dbs/db_rid/.
- documentCollection
- DocumentCollection
Objeto DocumentCollection.
- options
- RequestOptions
(Opcional) Cualquier RequestOptions elemento que desee proporcionar al crear una colección. Por ejemplo, RequestOptions.OfferThroughput = 400.
Devoluciones
objeto DocumentCollection que se creó dentro de un Task objeto que representa la respuesta del servicio para la operación asincrónica.
Excepciones
Si se establece o databaseLink
documentCollection
no.
Representa una consolidación de errores que se produjeron durante el procesamiento asincrónico. Busque en InnerExceptions para buscar las excepciones reales.
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 una colección son:
StatusCode | Motivo de la excepción |
---|---|
400 | BadRequest: esto significa que algo estaba mal con la solicitud proporcionada. Es probable que no se haya proporcionado un identificador para la nueva colección. |
403 | Prohibido: esto significa que intentó superar la cuota de las colecciones. Póngase en contacto con el soporte técnico para aumentar esta cuota. |
409 | Conflicto: significa que DocumentCollection un con un identificador que coincide con el identificador que proporcionó ya existía. |
Ejemplos
using (IDocumentClient client = new DocumentClient(new Uri("service endpoint"), "auth key"))
{
//Create a new collection with an OfferThroughput set to 10000
//Not passing in RequestOptions.OfferThroughput will result in a collection with the default OfferThroughput set.
DocumentCollection coll = await client.CreateDocumentCollectionAsync(databaseLink,
new DocumentCollection { Id = "My Collection" },
new RequestOptions { OfferThroughput = 10000} );
}
Consulte también
Se aplica a
CreateDocumentCollectionAsync(Uri, DocumentCollection, RequestOptions)
Crea una colección como una operación asincrónica en el servicio Azure Cosmos DB.
public System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.DocumentCollection>> CreateDocumentCollectionAsync (Uri databaseUri, Microsoft.Azure.Documents.DocumentCollection documentCollection, Microsoft.Azure.Documents.Client.RequestOptions options = default);
abstract member CreateDocumentCollectionAsync : Uri * Microsoft.Azure.Documents.DocumentCollection * Microsoft.Azure.Documents.Client.RequestOptions -> System.Threading.Tasks.Task<Microsoft.Azure.Documents.Client.ResourceResponse<Microsoft.Azure.Documents.DocumentCollection>>
Public Function CreateDocumentCollectionAsync (databaseUri As Uri, documentCollection As DocumentCollection, Optional options As RequestOptions = Nothing) As Task(Of ResourceResponse(Of DocumentCollection))
Parámetros
- databaseUri
- Uri
URI de la base de datos en la que se va a crear la colección.
- documentCollection
- DocumentCollection
Objeto DocumentCollection.
- options
- RequestOptions
(Opcional) para RequestOptions la solicitud.
Devoluciones
Objeto de tarea que representa la respuesta del servicio para la operación asincrónica.
Se aplica a
Azure SDK for .NET
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de