Compartilhar via


IDocumentClient.CreateDocumentCollectionAsync Método

Definição

Sobrecargas

CreateDocumentCollectionAsync(String, DocumentCollection, RequestOptions)

Cria uma coleção como uma operação assíncrona no serviço do Azure Cosmos DB.

CreateDocumentCollectionAsync(Uri, DocumentCollection, RequestOptions)

Cria uma coleção como uma operação assíncrona no serviço do Azure Cosmos DB.

CreateDocumentCollectionAsync(String, DocumentCollection, RequestOptions)

Cria uma coleção como uma operação assíncrona no serviço do 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

O link do banco de dados no qual criar a coleção. Por exemplo, dbs/db_rid/.

documentCollection
DocumentCollection

O objeto DocumentCollection.

options
RequestOptions

(Opcional) Qualquer um RequestOptions que você queira fornecer ao criar uma Coleção. Por exemplo, RequestOptions.OfferThroughput = 400.

Retornos

O DocumentCollection que foi criado contido em um Task objeto que representa a resposta de serviço para a operação assíncrona.

Exceções

Se ou databaseLinkdocumentCollection não estiver definido.

Representa uma consolidação de falhas que ocorreram durante o processamento assíncrono. Procure em InnerExceptions para encontrar as exceções reais.

Essa exceção pode encapsular muitos tipos diferentes de erros. Para determinar o erro específico, sempre examine a propriedade StatusCode. Alguns códigos comuns que você pode obter ao criar uma coleção são:

StatusCodeMotivo da exceção
400BadRequest - Isso significa que algo estava errado com a solicitação fornecida. É provável que uma ID não tenha sido fornecida para a nova coleção.
403Proibido – isso significa que você tentou exceder sua cota de coleções. Entre em contato com o suporte para aumentar essa cota.
409Conflito – isso significa que um DocumentCollection com uma ID correspondente à ID que você forneceu já existia.

Exemplos

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} );
}

Confira também

Aplica-se a

CreateDocumentCollectionAsync(Uri, DocumentCollection, RequestOptions)

Cria uma coleção como uma operação assíncrona no serviço do 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

O URI do banco de dados no qual criar a coleção.

documentCollection
DocumentCollection

O objeto DocumentCollection.

options
RequestOptions

(Opcional) O RequestOptions para a solicitação.

Retornos

O objeto de tarefa que representa a resposta de serviço para a operação assíncrona.

Aplica-se a