Database.CreateContainerAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| CreateContainerAsync(ContainerProperties, ThroughputProperties, 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. |
| CreateContainerAsync(String, String, Nullable<Int32>, RequestOptions, CancellationToken) |
Crée un conteneur en tant qu’opération asynchrone dans le service Azure Cosmos. |
CreateContainerAsync(ContainerProperties, ThroughputProperties, RequestOptions, CancellationToken)
Crée un conteneur en tant qu’opération asynchrone dans le service Azure Cosmos.
public abstract System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.ContainerResponse> CreateContainerAsync (Microsoft.Azure.Cosmos.ContainerProperties containerProperties, Microsoft.Azure.Cosmos.ThroughputProperties throughputProperties, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);abstract member CreateContainerAsync : Microsoft.Azure.Cosmos.ContainerProperties * Microsoft.Azure.Cosmos.ThroughputProperties * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Cosmos.ContainerResponse>Public MustOverride Function CreateContainerAsync (containerProperties As ContainerProperties, throughputProperties As ThroughputProperties, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of ContainerResponse)Paramètres
- containerProperties
- ContainerProperties
Objet ContainerProperties.
- throughputProperties
- ThroughputProperties
(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.
- cancellationToken
- CancellationToken
(Facultatif) CancellationToken représentant l’annulation de la demande.
Retours
Task contenant un ContainerResponse qui encapsule un ContainerProperties contenant l’enregistrement de ressource de lecture.
Exceptions
Si 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 :
| StatusCode | Raison de l’exception |
|---|---|
| 400 | BadRequest : cela signifie qu’un problème s’est produit avec la demande fournie. Il est probable qu’aucun ID n’a été fourni pour le nouveau conteneur. |
| 403 | Interdit : cela signifie que vous avez tenté de dépasser votre quota pour les conteneurs. Contactez le support technique pour augmenter ce quota. |
| 409 | Conflit : 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,
ThroughputProperties.CreateAutoscaleThroughput(10000));
S’applique à
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<Microsoft.Azure.Cosmos.ContainerResponse> CreateContainerAsync (Microsoft.Azure.Cosmos.ContainerProperties containerProperties, int? throughput = default, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);abstract member CreateContainerAsync : Microsoft.Azure.Cosmos.ContainerProperties * Nullable<int> * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.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.
(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.
- cancellationToken
- CancellationToken
(Facultatif) CancellationToken représentant l’annulation de la demande.
Retours
Task contenant un ContainerResponse qui encapsule un ContainerProperties contenant l’enregistrement de ressource de lecture.
Exceptions
Si 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 :
| StatusCode | Raison de l’exception |
|---|---|
| 400 | BadRequest : cela signifie qu’un problème s’est produit avec la demande fournie. Il est probable qu’aucun ID n’a été fourni pour le nouveau conteneur. |
| 403 | Interdit : cela signifie que vous avez tenté de dépasser votre quota pour les conteneurs. Contactez le support technique pour augmenter ce quota. |
| 409 | Conflit : 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.
Voir aussi
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<Microsoft.Azure.Cosmos.ContainerResponse> CreateContainerAsync (string id, string partitionKeyPath, int? throughput = default, Microsoft.Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);abstract member CreateContainerAsync : string * string * Nullable<int> * Microsoft.Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.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
(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.
- cancellationToken
- CancellationToken
(Facultatif) CancellationToken représentant l’annulation de la demande.
Retours
Task contenant un ContainerResponse 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 :
| StatusCode | Raison de l’exception |
|---|---|
| 400 | BadRequest : cela signifie qu’un problème s’est produit avec la demande fournie. Il est probable qu’aucun ID n’a été fourni pour le nouveau conteneur. |
| 403 | Interdit : cela signifie que vous avez tenté de dépasser votre quota pour les conteneurs. Contactez le support technique pour augmenter ce quota. |
| 409 | Conflit : 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.
Voir aussi
S’applique à
Azure SDK for .NET
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour