Compartir a través de


Database.CreateContainerAsync Método

Definición

Sobrecargas

CreateContainerAsync(ContainerProperties, ThroughputProperties, RequestOptions, CancellationToken)

Crea un contenedor como una operación asincrónica en el servicio Azure Cosmos.

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

Crea un contenedor como una operación asincrónica en el servicio Azure Cosmos.

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

Crea un contenedor como una operación asincrónica en el servicio Azure Cosmos.

CreateContainerAsync(ContainerProperties, ThroughputProperties, RequestOptions, CancellationToken)

Crea un contenedor como una operación asincrónica en el servicio 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)

Parámetros

containerProperties
ContainerProperties

Objeto ContainerProperties.

throughputProperties
ThroughputProperties

(Opcional) Rendimiento aprovisionado para un contenedor en medida de unidades de solicitudes por segundo en el servicio Azure Cosmos DB.

requestOptions
RequestOptions

(Opcional) Opciones de la solicitud.

cancellationToken
CancellationToken

(Opcional) CancellationToken que representa la cancelación de la solicitud.

Devoluciones

que Task contiene un ContainerResponse objeto que contiene ContainerProperties el registro de recursos de lectura.

Excepciones

Si containerProperties no se establece.

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 un contenedor son:

StatusCodeMotivo de la excepción
400BadRequest: esto significa que algo estaba mal con la solicitud proporcionada. Es probable que no se haya proporcionado un identificador para el nuevo contenedor.
403Prohibido: esto significa que ha intentado superar la cuota de los contenedores. Póngase en contacto con el soporte técnico para aumentar esta cuota.
409Conflicto: significa que ContainerProperties un con un identificador que coincide con el identificador que proporcionó ya existía.

Ejemplos

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

Se aplica a

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

Crea un contenedor como una operación asincrónica en el servicio 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)

Parámetros

containerProperties
ContainerProperties

Objeto ContainerProperties.

throughput
Nullable<Int32>

(Opcional) Rendimiento aprovisionado para un contenedor en medida de unidades de solicitudes por segundo en el servicio Azure Cosmos DB.

requestOptions
RequestOptions

(Opcional) Opciones de la solicitud.

cancellationToken
CancellationToken

(Opcional) CancellationToken que representa la cancelación de la solicitud.

Devoluciones

que Task contiene un ContainerResponse objeto que contiene ContainerProperties el registro de recursos de lectura.

Excepciones

Si containerProperties no se establece.

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 un contenedor son:

StatusCodeMotivo de la excepción
400BadRequest: esto significa que algo estaba mal con la solicitud proporcionada. Es probable que no se haya proporcionado un identificador para el nuevo contenedor.
403Prohibido: esto significa que ha intentado superar la cuota de los contenedores. Póngase en contacto con el soporte técnico para aumentar esta cuota.
409Conflicto: significa que ContainerProperties un con un identificador que coincide con el identificador que proporcionó ya existía.

Ejemplos

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

Comentarios

https://docs.microsoft.com/azure/cosmos-db/request-units para más información sobre el rendimiento de aprovisionamiento.

Consulte también

Se aplica a

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

Crea un contenedor como una operación asincrónica en el servicio 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)

Parámetros

id
String

Identificador del contenedor de Cosmos

partitionKeyPath
String

Ruta de acceso a la clave de partición. Ejemplo: /location

throughput
Nullable<Int32>

(Opcional) Rendimiento aprovisionado para un contenedor en medida de unidades de solicitudes por segundo en el servicio Azure Cosmos DB.

requestOptions
RequestOptions

(Opcional) Opciones de la solicitud.

cancellationToken
CancellationToken

(Opcional) CancellationToken que representa la cancelación de la solicitud.

Devoluciones

que Task contiene un ContainerResponse objeto que contiene ContainerProperties el registro de recursos de lectura.

Excepciones

Si id no se establece.

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 un contenedor son:

StatusCodeMotivo de la excepción
400BadRequest: esto significa que algo estaba mal con la solicitud proporcionada. Es probable que no se haya proporcionado un identificador para el nuevo contenedor.
403Prohibido: esto significa que ha intentado superar la cuota de los contenedores. Póngase en contacto con el soporte técnico para aumentar esta cuota.
409Conflicto: significa que ContainerProperties un con un identificador que coincide con el identificador que proporcionó ya existía.

Ejemplos

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

Comentarios

https://docs.microsoft.com/azure/cosmos-db/request-units para más información sobre el rendimiento de aprovisionamiento.

Consulte también

Se aplica a