recurso compartido de instantáneas
A partir de la versión 2017-04-17, la Snapshot Share operación crea una instantánea de solo lectura de un recurso compartido.
Disponibilidad del protocolo
| Protocolo de recurso compartido de archivos habilitado | Disponible | Estado |
|---|---|---|
| SMB |
|
GA |
| NFS |
|
GA |
Solicitud
Puede construir la Snapshot Share solicitud como se indica a continuación. Se recomienda HTTPS.
| Método | URI de solicitud | Versión de HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot |
HTTP/1.1 |
Reemplace los componentes de la ruta de acceso que se muestran en el URI de solicitud por los suyos de la siguiente manera:
| Componente de ruta de acceso | Descripción |
|---|---|
myaccount |
El nombre de la cuenta de almacenamiento. |
myshare |
El nombre del recurso compartido de archivos. |
Para más información sobre las restricciones de nomenclatura de rutas de acceso, consulte Nomenclatura y referencia a recursos compartidos, directorios, archivos y metadatos.
Parámetros del identificador URI
Puede especificar el siguiente parámetro adicional en el URI de solicitud.
| Parámetro | Descripción |
|---|---|
timeout |
Opcional. El parámetro timeout se expresa en segundos. Para más información, consulte Configuración de tiempos de espera para las operaciones de Azure Files. |
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 la cuenta y la firma. Para obtener más información, vea Autorización de solicitudes a Azure Storage. |
Date o x-ms-date |
Necesario. Especifica la hora universal coordinada (UTC) para la solicitud. Para obtener más información, vea Autorización de solicitudes a Azure Storage. |
x-ms-version |
Obligatorio para todas las solicitudes autorizadas. Especifica la versión de la operación que se utiliza para esta solicitud. Para obtener más información, vea Versiones de los servicios de Azure Storage. |
x-ms-meta-name:value |
Opcional. Especifica un par de nombre-valor definido por el usuario, asociado a la instantánea de recurso compartido. Si no especifica ningún par nombre-valor, la operación copia los metadatos del recurso compartido base en la instantánea. Si especifica uno o varios pares nombre-valor, la instantánea de recurso compartido se crea con los metadatos especificados. En este caso, los metadatos no se copian del recurso compartido base. Los nombres de metadatos deben cumplir las reglas de nomenclatura de los identificadores de C#. |
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 más información, consulte Supervisión de Azure Blob Storage. |
Cuerpo de la solicitud
Ninguno.
Solicitud de ejemplo
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=snapshot HTTP/1.1
Request Headers:
x-ms-version: 2017-04-17
x-ms-date: Mon, 10 May 2017 22:50:32 GMT
x-ms-meta-Name: StorageSample
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
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, vea Códigos de estado y de error.
Encabezados de respuesta
La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir encabezados HTTP adicionales y estándar. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.
| Encabezado de respuesta | Descripción |
|---|---|
ETag |
Contiene un valor que representa la versión de la instantánea del recurso compartido, entre comillas. No se puede modificar una instantánea de recurso compartido, por lo que la ETag de una instantánea de recurso compartido determinada nunca cambia. Sin embargo, si proporcionó nuevos metadatos con la Snapshot Share solicitud, la ETag de la instantánea de recurso compartido difiere de la del recurso compartido base. Si no especificó ningún metadato con la solicitud, la ETag de la instantánea del recurso compartido es idéntica a la del recurso compartido base, en el momento en que se tomó la instantánea del recurso compartido. |
Last-Modified |
Devuelve la fecha y hora en que se modificó por última vez el recurso compartido. Para obtener más información, vea Representación de valores de fecha y hora en encabezados. No se puede modificar una instantánea de recurso compartido, por lo que la hora de la última modificación de una instantánea de recurso compartido determinada nunca cambia. Sin embargo, si proporcionó nuevos metadatos con la Snapshot Share solicitud, la hora de la última modificación de la instantánea de recurso compartido difiere de la del recurso compartido base. Si no especificó ningún metadato con la solicitud, la hora de la última modificación de la instantánea de recurso compartido es idéntica a la del recurso compartido base, en el momento en que se tomó la instantánea del recurso compartido. |
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 |
Indica la versión de Azure Files que se usa para ejecutar la solicitud. |
Date o x-ms-date |
Valor de fecha y hora UTC que indica la hora a la que se inició la respuesta. El servicio genera este valor. |
x-ms-snapshot |
Valor DateTime que identifica de forma única la instantánea de recurso compartido. Puede usar el valor de este encabezado en las solicitudes posteriores para acceder a la instantánea del recurso compartido. Este valor es opaco. |
x-ms-client-request-id |
Se puede usar para solucionar problemas de solicitudes y respuestas correspondientes. El valor de este encabezado es igual al valor del x-ms-client-request-id encabezado, si está presente en la solicitud. El valor tiene como máximo 1024 caracteres ASCII visibles. Si el x-ms-client-request-id encabezado no está presente en la solicitud, no estará presente en la respuesta. |
Response body
Ninguno.
Respuesta de muestra
Response Status:
HTTP/1.1 201 Created
Response Headers:
Content-Length: 0
Date: Mon, 10 May 2017 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 10 May 2017 23:00:06 GMT
x-ms-version: 2017-04-17
x-ms-snapshot: 2017-05-10T17:52:33.9551861Z
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Authorization
Solo el propietario de la cuenta puede llamar a esta operación.
Comentarios
Las instantáneas de recurso compartido proporcionan versiones de solo lectura de recursos compartidos. Después de crear una instantánea de recurso compartido, no se puede modificar. Una instantánea de recurso compartido proporciona una manera cómoda de crear una copia de seguridad coherente de todos los archivos de un recurso compartido.
Cada vez que se llama a la Snapshot Share operación, se crea una nueva instantánea de recurso compartido, con un valor único DateTime que identifica la instantánea de recurso compartido con respecto a su recurso compartido base. Puede usar este DateTime valor para realizar más operaciones en la instantánea del recurso compartido y su contenido. Debe tratar este DateTime valor como opaco.
El DateTime valor identifica la instantánea de recurso compartido en el URI de solicitud. Por ejemplo, un archivo en el recurso compartido base y sus instantáneas tienen URI similares a los ejemplos siguientes:
- Archivo en el recurso compartido:
http://myaccount.file.core.windows.net/myshare/myfile - Archivo en la instantánea de recurso compartido:
http://myaccount.file.core.windows.net/myshare/myfile?sharesnapshot=<DateTime>
Un recurso compartido puede admitir la creación de 200 instantáneas de recurso compartido. Si intenta crear más de 200 instantáneas de recurso compartido, el servicio devuelve el código de error 409 (Conflicto). Si intenta crear una instantánea de recurso compartido mientras una operación anterior Snapshot Share está en curso, el servicio también devuelve el código de error 409 (conflicto).
Las instantáneas de recurso compartido existentes nunca se sobrescriben. Deben eliminarse explícitamente. Para eliminar explícitamente instantáneas de recurso compartido, llame a Eliminar recurso compartido y establezca el x-ms-include-snapshots encabezado, junto con el sharesnapshot parámetro de consulta, en el valor adecuado.
Puede ver las instantáneas del recurso compartido NFS en un cliente NFS mediante el directorio virtual de instantáneas (.snapshot), que normalmente se encuentra en la raíz del punto de montaje del recurso compartido. El acceso a este directorio se puede deshabilitar estableciendo el x-ms-enable-snapshot-virtual-directory-access encabezado en false en la API Establecer propiedades de recurso compartido . También puede establecer este encabezado en el momento de la creación del recurso compartido como parte de la operación Crear recurso compartido .