Partager via


CosmosDatabase.CreateContainerAsync Méthode

Définition

Surcharges

CreateContainerAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)

Crée un conteneur en tant qu’opération asynchrone dans le service Azure Cosmos.

CreateContainerAsync(String, String, Nullable<Int32>, RequestOptions, CancellationToken)

Crée un conteneur en tant qu’opération asynchrone dans le service Azure Cosmos.

CreateContainerAsync(ContainerProperties, Nullable<Int32>, RequestOptions, CancellationToken)

Crée un conteneur en tant qu’opération asynchrone dans le service Azure Cosmos.

public abstract System.Threading.Tasks.Task<Azure.Cosmos.ContainerResponse> CreateContainerAsync (Azure.Cosmos.ContainerProperties containerProperties, int? throughput = default, Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateContainerAsync : Azure.Cosmos.ContainerProperties * Nullable<int> * Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Cosmos.ContainerResponse>
Public MustOverride Function CreateContainerAsync (containerProperties As ContainerProperties, Optional throughput As Nullable(Of Integer) = Nothing, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ContainerResponse)

Paramètres

containerProperties
ContainerProperties

Objet ContainerProperties.

throughput
Nullable<Int32>

(Facultatif) Débit provisionné pour un conteneur dans la mesure des unités de demandes par seconde dans le service Azure Cosmos DB.

requestOptions
RequestOptions

(Facultatif) Options de la demande de conteneur RequestOptions

cancellationToken
CancellationToken

(Facultatif) CancellationToken représentant l’annulation de la demande.

Retours

Task contenant un Response qui encapsule un ContainerProperties contenant l’enregistrement de ressource de lecture.

Exceptions

Si l’un ou l’autre containerProperties n’est pas défini.

Représente une consolidation des échecs qui se sont produits pendant le traitement asynchrone. Recherchez la ou les exceptions réelles dans InnerExceptions.

Cette exception peut encapsuler de nombreux types d’erreurs différents. Pour déterminer l’erreur spécifique, examinez toujours la propriété StatusCode. Voici quelques codes courants que vous pouvez obtenir lors de la création d’un conteneur :

StatusCodeRaison de l’exception
400BadRequest : cela signifie qu’il y a eu un problème avec la demande fournie. Il est probable qu’un ID n’a pas été fourni pour le nouveau conteneur.
403Interdit : cela signifie que vous avez tenté de dépasser votre quota pour les conteneurs. Contactez le support technique pour augmenter ce quota.
409Conflit : cela signifie qu’un ContainerProperties avec un ID correspondant à l’ID que vous avez fourni existait déjà.

Exemples

ContainerProperties containerProperties = new ContainerProperties()
{
    Id = Guid.NewGuid().ToString(),
    PartitionKeyPath = "/pk",
    IndexingPolicy = new IndexingPolicy()
   {
        Automatic = false,
        IndexingMode = IndexingMode.Lazy,
   };
};

ContainerResponse response = await this.cosmosDatabase.CreateContainerAsync(containerProperties);

Remarques

https://docs.microsoft.com/azure/cosmos-db/request-units pour plus d’informations sur le débit d’approvisionnement.

S’applique à

CreateContainerAsync(String, String, Nullable<Int32>, RequestOptions, CancellationToken)

Crée un conteneur en tant qu’opération asynchrone dans le service Azure Cosmos.

public abstract System.Threading.Tasks.Task<Azure.Cosmos.ContainerResponse> CreateContainerAsync (string id, string partitionKeyPath, int? throughput = default, Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateContainerAsync : string * string * Nullable<int> * Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Cosmos.ContainerResponse>
Public MustOverride Function CreateContainerAsync (id As String, partitionKeyPath As String, Optional throughput As Nullable(Of Integer) = Nothing, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ContainerResponse)

Paramètres

id
String

ID de conteneur cosmos

partitionKeyPath
String

Chemin d’accès à la clé de partition. Exemple : /location

throughput
Nullable<Int32>

(Facultatif) Débit provisionné pour un conteneur dans la mesure des unités de demandes par seconde dans le service Azure Cosmos DB.

requestOptions
RequestOptions

(Facultatif) Options de la demande de conteneur RequestOptions

cancellationToken
CancellationToken

(Facultatif) CancellationToken représentant l’annulation de la demande.

Retours

Task contenant un Response qui encapsule un ContainerProperties contenant l’enregistrement de ressource de lecture.

Exceptions

Si id n’est pas défini.

Représente une consolidation des échecs qui se sont produits pendant le traitement asynchrone. Recherchez la ou les exceptions réelles dans InnerExceptions.

Cette exception peut encapsuler de nombreux types d’erreurs différents. Pour déterminer l’erreur spécifique, examinez toujours la propriété StatusCode. Voici quelques codes courants que vous pouvez obtenir lors de la création d’un conteneur :

StatusCodeRaison de l’exception
400BadRequest : cela signifie qu’il y a eu un problème avec la demande fournie. Il est probable qu’un ID n’a pas été fourni pour le nouveau conteneur.
403Interdit : cela signifie que vous avez tenté de dépasser votre quota pour les conteneurs. Contactez le support technique pour augmenter ce quota.
409Conflit : cela signifie qu’un ContainerProperties avec un ID correspondant à l’ID que vous avez fourni existait déjà.

Exemples

ContainerResponse response = await this.cosmosDatabase.CreateContainerAsync(Guid.NewGuid().ToString(), "/pk");

Remarques

https://docs.microsoft.com/azure/cosmos-db/request-units pour plus d’informations sur le débit d’approvisionnement.

S’applique à