VENTAS: 1-800-867-1389

Create Container

Actualizado: febrero de 2014

La operación Create Container crea un nuevo contenedor en la cuenta especificada. Si ya existe un contenedor con el mismo nombre, se produce un error en la operación.

El recurso de contenedor incluye los metadatos y las propiedades del contenedor. No incluye una lista de los blobs del contenedor.

La solicitud Create Container se puede construir como sigue. Se recomienda HTTPS. El valor mycontainer solo puede incluir caracteres en minúsculas. Reemplace myaccount por el nombre de la cuenta de almacenamiento:

 

Método URI de solicitud Versión de HTTP

PUT

https://myaccount.blob.core.windows.net/mycontainer?restype=container

HTTP/1.1

Al realizar una solicitud en el servicio de almacenamiento emulado, especifique el nombre de host del emulador y el puerto del servicio Blob como 127.0.0.1:10000, seguido del nombre de la cuenta de almacenamiento emulado:

 

Método URI de solicitud Versión de HTTP

PUT

http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container

HTTP/1.1

Para obtener más información, vea Uso del emulador de almacenamiento de Azure para desarrollo y prueba y Diferencias entre el emulador de almacenamiento y los servicios de almacenamiento de Azure.

Se pueden especificar los parámetros adicionales siguientes en el URI de solicitud.

 

Parámetro Descripción

timeout

Opcional. El parámetro timeout se expresa en segundos. Para obtener más información, vea Establecer los tiempos de espera para las operaciones del servicio Blob.

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

 

Encabezado de solicitud Descripción

Authorization

Requerido. Especifica el esquema de autenticación, el nombre de la cuenta y la firma. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

Date O bien x-ms-date

Requerido. Especifica la hora universal coordinada (UTC) para la solicitud. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

x-ms-version

Obligatorio para todas las solicitudes autenticadas. Especifica la versión de la operación que se utiliza para esta solicitud. Para obtener más información, vea Control de versiones de los servicios de almacenamiento de Azure.

x-ms-meta-name:value

Opcional. Par nombre-valor que se va a asociar con el contenedor como metadatos.

Tenga en cuenta que, a partir de la versión 2009-09-19, los nombres de los metadatos deben cumplir las reglas de nomenclatura para los Identificadores de C#.

x-ms-blob-public-access

Opcional. Especifica si el acceso a los datos del contenedor es público, así como el nivel de acceso. Los valores posibles incluyen:

  • container: especifica el acceso de lectura público completo para los datos del contenedor y de los blobs. Los clientes pueden enumerar blobs en el contenedor a través de una solicitud anónima, pero no pueden enumerar contenedores en la cuenta de almacenamiento.

  • blob: especifica el acceso de lectura público para los blobs. Los datos de los blobs de este contenedor se pueden leer mediante una solicitud anónima, pero los datos del contenedor no están disponibles. Los clientes no pueden enumerar blobs en el contenedor a través una solicitud anónima.

Si no se incluye este encabezado en la solicitud, a los datos del contenedor solo podrá acceder el propietario de la cuenta.

x-ms-client-request-id

Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 KB que se graba en los registros de análisis cuando el registro de análisis de almacenamiento está habilitado. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor. Para obtener más información, vea Acerca del registro del análisis de almacenamiento y Registro de Windows Azure: usar registros para realizar el seguimiento de las solicitudes de almacenamiento.

Request Syntax:
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1

Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT
x-ms-meta-Name: StorageSample
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

Una operación correcta devuelve el código de estado 201 (Creado).

Para obtener información acerca de los códigos de estado, vea Códigos de estado y de error.

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir otros encabezados HTTP estándar. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1.

 

Encabezado de respuesta Descripción

ETag

La ETag del contenedor. Si la versión de la solicitud es 2011-08-18 o una más reciente, el valor ETag estará entre comillas.

Last-Modified

Devuelve la fecha y hora en que se modificó por última vez el contenedor. El formato de la fecha sigue las convenciones de RFC 1123. Para obtener más información, vea Representación de valores de fecha u hora en encabezados.

Cualquier operación que modifique el contenedor o sus propiedades o metadatos actualiza la hora de la última modificación. Las operaciones en los blobs no afectan a la hora de última modificación del contenedor.

x-ms-request-id

Este encabezado identifica de forma única la solicitud que se realizó y se puede utilizar para solucionar problemas relacionados con esta. Para obtener más información, vea Solucionar problemas relacionados con las operaciones de la API.

x-ms-version

Indica la versión del servicio Blob utilizado para ejecutar la solicitud. Este encabezado se devuelve para las solicitudes realizadas en la versión 2009-09-19 y versiones posteriores.

Date

Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta.

Response Status:
HTTP/1.1 201 Created

Response Headers:
Transfer-Encoding: chunked
Date: Sun, 25 Sep 2011 23:00:12 GMT
ETag: “0x8CB14C3E29B7E82”
Last-Modified: Sun, 25 Sep 2011 23:00:06 GMT
x-ms-version: 2011-08-18
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Solo el propietario de la cuenta puede llamar a esta operación.

Los contenedores se crean inmediatamente por debajo de la cuenta de almacenamiento. No es posible anidar un contenedor debajo de otro.

También se puede crear un contenedor raíz o predeterminado para la cuenta de almacenamiento. El contenedor raíz se puede deducir de una dirección URL que solicita un recurso de blob. El contenedor raíz permite hacer referencia a un blob desde el nivel superior de la jerarquía de cuentas de almacenamiento sin hacer referencia al nombre del contenedor.

Para agregar el contenedor raíz a la cuenta de almacenamiento, cree un nuevo contenedor denominado $root. Construya la solicitud de la forma siguiente:

Request Syntax:
PUT https://myaccount.blob.core.windows.net/$root?restype=container HTTP/1.1

Request Headers:
x-ms-version: 2011-08-18
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT
x-ms-meta-Name: StorageSample
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

Puede especificar metadatos para un contenedor en el momento de crearlo incluyendo uno o varios encabezados de metadatos en la solicitud. El formato del encabezado de metadatos es x-ms-meta-name:value.

Si se está eliminando un contenedor con el mismo nombre cuando se llama a Create Container, el servidor devolverá el código de estado 409 (conflicto), con información adicional que indica que el contenedor se está eliminando.

¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios
Mostrar:
© 2014 Microsoft