Restaurar contenedor

Artículo
02/03/2024

La Restore Container operación restaura el contenido y las propiedades de un contenedor eliminado temporalmente en un contenedor especificado. La Restore Container operación está disponible en la versión 2019-12-12 y versiones posteriores.

Solicitud

Puede construir la Restore Container solicitud mediante una solicitud válida, autorizada mediante la clave compartida, la autorización de firma de acceso compartido de la cuenta o el control de acceso basado en roles.

Método	URI de solicitud	Versión de HTTP
`PUT`	`https://myaccount.blob.core.windows.net/destinationcontainer?restype=container&comp=undelete`	HTTP/1.1
`PUT`	`https://myaccount.blob.core.windows.net/destinationcontainer?restype=container&comp=undelete&sv=validsastoken`	HTTP/1.1

Parámetros del identificador URI

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

Parámetro	Descripción
`restype`	Necesario. El valor del `restype` parámetro debe ser `container`.
`comp`	Necesario. El valor del `comp` parámetro debe ser `undelete`.
`timeout`	Opcional. El parámetro `timeout` se expresa en segundos. Para más información, consulte Establecimiento de tiempos de espera para las operaciones de Blob Storage.

Encabezados de solicitud

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

Encabezado de solicitud	Descripción
`Authorization`	Necesario. Especifica el esquema de autorización, el nombre de cuenta y la firma. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
`Date or x-ms-date`	Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
`x-ms-version`	Necesario para todas las solicitudes autorizadas. Especifica la versión de la operación que se utiliza para esta solicitud. Para esta operación, la versión debe ser `2018-03-28` o posterior. Para obtener más información, vea Versiones de los servicios de Azure Storage.
`x-ms-client-request-id`	Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 kibibyte (KiB) que se registra en los registros cuando se configura el registro. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes que recibe el servidor. Para obtener más información, consulte Supervisión de Azure Blob Storage.
`x-ms-deleted-container-name`	Necesario. Use este encabezado para identificar de forma única el contenedor eliminado temporalmente que se debe restaurar.
`x-ms-deleted-container-version`	Necesario. Use este encabezado para identificar de forma única el contenedor eliminado temporalmente que se debe restaurar. Puede obtener este valor para especificar el `deleted` valor en el `include` parámetro de consulta de la `List Containers` operación. Para obtener más información, vea Enumerar contenedores.

Cuerpo de la solicitud

Ninguno.

Response

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

status code

Una operación correcta devuelve el código de estado 201 (Creado). Para obtener información sobre los códigos de estado, consulte Códigos de estado y error.

Encabezados de respuesta

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

Encabezado de respuesta	Descripción
`x-ms-request-id`	Identifica de forma única la solicitud que se realizó y se puede usar para solucionar problemas de la solicitud. Para más información, consulte Solución de problemas de operaciones de API.
`x-ms-version`	Versión 2009-09-19 y posteriores. Indica la versión de Azure Blob Storage usada para ejecutar la solicitud.
`Date`	Valor de fecha y hora UTC que indica la hora en la que se inició la respuesta. El servicio genera este valor.
`Content-Length`	Longitud del cuerpo de la solicitud. Para esta operación, la longitud del contenido siempre es cero.

Response body

Ninguno.

Respuesta de muestra

Response Status:  
HTTP/1.1 201 OK  
  
Response Headers:  
Date: Mon, 15 Jun 2020 12:43:08 GMT  
x-ms-version: 2019-12-12  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0

Authorization

La autorización es necesaria cuando se llama a cualquier operación de acceso a datos en Azure Storage. Puede autorizar la Restore Container operación como se describe en las secciones siguientes.

Azure Storage admite el uso de Microsoft Entra ID para autorizar solicitudes a datos de blobs. Con Microsoft Entra ID, puede usar el control de acceso basado en rol de Azure (RBAC de Azure) para conceder permisos a una entidad de seguridad. La entidad de seguridad puede ser un usuario, un grupo, una entidad de servicio de aplicación o una identidad administrada de Azure. La entidad de seguridad se autentica mediante Microsoft Entra ID para devolver un token de OAuth 2.0. Después, el token se puede usar para autorizar una solicitud en Blob Storage.

Para más información sobre la autorización mediante Microsoft Entra ID, consulte Autorización del acceso a blobs mediante Microsoft Entra ID.

Permisos

Las siguientes acciones de RBAC son necesarias para que un usuario, grupo o entidad de servicio de Microsoft Entra llame a la Restore Container operación y el rol RBAC integrado con privilegios mínimos que incluya esta acción:

Acción RBAC de Azure: Microsoft.Storage/storageAccounts/blobServices/containers/write
Rol integrado con privilegios mínimos: Colaborador de datos de Storage Blob

Para más información sobre cómo asignar roles mediante RBAC de Azure, consulte Asignación de un rol de Azure para acceder a datos de blobs.

Una firma de acceso compartido (SAS) proporciona acceso delegado seguro a los recursos de una cuenta de almacenamiento. Con una SAS, tiene un control pormenorizado sobre cómo un cliente puede acceder a los datos. Puede especificar a qué recurso puede acceder el cliente, qué permisos tienen para esos recursos y cuánto tiempo es válido la SAS.

La Restore Container operación admite la autorización mediante una SAS de cuenta.

Cuando no se permite el acceso a la clave compartida para la cuenta de almacenamiento, no se permitirá un token de SAS de cuenta en una solicitud a Blob Storage. Para más información, consulte Descripción de cómo no permitir la clave compartida afecta a los tokens de SAS.

SAS de cuenta

Una SAS de cuenta está protegida con la clave de cuenta de almacenamiento. SAS de cuenta delega el acceso a los recursos en uno o varios de los servicios de almacenamiento. Todas las operaciones disponibles con una SAS de servicio o delegación de usuarios están también disponibles con una SAS de cuenta.

En la tabla siguiente se indica el tipo de recurso firmado y los permisos firmados para especificar cuándo se delega el acceso:

Operación	Servicio firmado	Tipo de recurso firmado	Permiso firmado
Restaurar contenedor	Blob (b)	Contenedor (c)	Escritura (w)

Para más información sobre la SAS de la cuenta, consulte Creación de una SAS de cuenta.

Comentarios

Puede establecer la directiva de retención de eliminación de contenedores en la cuenta mediante el proveedor de recursos de almacenamiento.
El contenedor especificado no debe existir en el momento en que se realiza la Restore Container operación.
Si el contenedor especificado existe, se producirá un error en la Restore Container operación con un error 409 (conflicto).
Si el contenedor eliminado temporalmente no existe, ya se ha usado como origen de una Restore Container operación o ha superado sus días de retención, la operación producirá un error 409 (Conflicto).

Facturación

Las solicitudes de precios se pueden originar en clientes que usan las API de Blob Storage, ya sea directamente a través de la API rest de Blob Storage o de una biblioteca cliente de Azure Storage. Estas solicitudes acumulan cargos por transacción. El tipo de transacción afecta a cómo se cobra la cuenta. Por ejemplo, las transacciones de lectura se acumulan en una categoría de facturación diferente que las transacciones de escritura. En la tabla siguiente se muestra la categoría de facturación de Restore Container las solicitudes basadas en el tipo de cuenta de almacenamiento:

Operación	Tipo de cuenta de almacenamiento	Categoría de facturación
Restaurar contenedor	Blobs en bloques Premium De uso general, estándar, v2 De uso general, estándar, v1	Enumerar y crear operaciones de contenedor

Para obtener información sobre los precios de la categoría de facturación especificada, consulte precios Azure Blob Storage.