Cambiar nombre del directorio
La Rename Directory
operación cambia el nombre de un directorio y, opcionalmente, puede establecer las propiedades del sistema para el directorio. Esta API está disponible en la versión 2021-04-10 y posteriores.
Disponibilidad del protocolo
Protocolo de recurso compartido de archivos habilitado | Disponible |
---|---|
SMB | |
NFS |
Solicitud
Puede construir la Rename Directory
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/mydirectorypath/mydirectory?restype=directory&comp=rename |
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. |
mydirectorypath |
Opcional. La ruta de acceso al directorio principal. |
mydirectory |
Nombre del directorio de destino. |
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 obtener más información, consulte Configuración de tiempos de espera para 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) de 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-file-rename-source:name |
Necesario. URI completo del directorio al que se va a cambiar el nombre. |
x-ms-file-rename-ignore-readonly |
Opcional. Si el directorio de destino existe con el readonly atributo , sobrescriba el directorio.Si es true, x-ms-file-rename-replace-if-exists también debe ser true. |
x-ms-file-permission |
Opcional si x-ms-file-permission-key no se especifica. Este permiso es el descriptor de seguridad del directorio especificado en el Lenguaje de definición de descriptores de seguridad (SDDL). Puede usar este encabezado si el tamaño de los permisos es de 8 kibibytes (KiB) o menos. De lo contrario, puede usar x-ms-file-permission-key . Si se especifica, este permiso debe tener una lista de control de acceso discrecional, grupo y propietario. Puede pasar un valor de preserve si desea mantener un valor existente sin cambios.Tenga en cuenta que puede especificar o x-ms-file-permission x-ms-file-permission-key , no ambos. |
x-ms-file-permission-key |
Opcional si x-ms-file-permission no se especifica. Clave del permiso que se va a establecer para el directorio. Puede crearlo mediante la Create-Permission API.Tenga en cuenta que puede especificar o x-ms-file-permission x-ms-file-permission-key , no ambos. |
x-ms-file-attributes |
Opcional. Atributos del sistema de archivos que se van a establecer en el directorio. Consulte la lista de atributos disponibles. Puede pasar un valor de preserve si desea mantener un valor existente sin cambios. Si esta propiedad no se especifica en la solicitud, se conservará la propiedad . |
x-ms-file-creation-time |
Opcional. Propiedad de hora de creación UTC de un directorio. Puede pasar un valor de preserve si desea mantener un valor existente sin cambios. Si esta propiedad no se especifica en la solicitud, se conservará la propiedad . |
x-ms-file-last-write-time |
Opcional. Propiedad utc de última escritura de un directorio. Puede pasar un valor de preserve si desea mantener un valor existente sin cambios. Si esta propiedad no se especifica en la solicitud, se conservará la propiedad . |
x-ms-destination-lease-id:<ID> |
Obligatorio si el archivo de destino tiene una concesión activa. |
x-ms-client-request-id |
Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 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, vea Supervisar Azure Blob Storage. |
x-ms-meta-name:value |
Opcional. Establece un par nombre-valor para el directorio. Cada llamada a esta operación reemplaza todos los metadatos existentes adjuntados al directorio. Los nombres de metadatos deben cumplir las reglas de nomenclatura de los identificadores de C#. Si esta propiedad no se especifica en la solicitud, se conservará la propiedad . |
x-ms-file-request-intent |
Obligatorio si Authorization el encabezado especifica un token de OAuth. El valor aceptable es backup . Este encabezado especifica que se debe conceder o Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action si se incluyen en la directiva de RBAC asignada a la identidad autorizada mediante el Authorization encabezado . Disponible para la versión 2022-11-02 y posteriores. |
x-ms-allow-trailing-dot: { <Boolean> } |
Opcional. Versión 2022-11-02 y posteriores. El valor booleano especifica si se debe recortar o no un punto final presente en la dirección URL de la solicitud. Para obtener más información, consulte Nomenclatura y referencia a recursos compartidos, directorios, archivos y metadatos. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Opcional. Versión 2022-11-02 y posteriores. El valor booleano especifica si se debe recortar o no un punto final presente en la dirección URL de origen. Este encabezado solo debe especificarse si el origen de copia es un recurso compartido de archivos de Azure. Este encabezado no se admite para ningún otro tipo de origen de copia. Para obtener más información, consulte Nomenclatura y referencia a recursos compartidos, directorios, archivos y metadatos. |
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 200 Correcto. 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 |
---|---|
ETag |
Contiene un valor que representa la versión del archivo, entre comillas. |
Last-Modified |
Devuelve la fecha y hora en que se modificó por última vez el archivo. Para obtener más información, vea Representación de valores de fecha y hora en encabezados. Cualquier operación que modifique el directorio, o sus propiedades, actualiza la hora de la última modificación. Las operaciones en archivos no afectan a la hora de la última modificación del directorio. |
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 usada para ejecutar la solicitud. |
Date o x-ms-date |
Valor de fecha y hora UTC que indica la hora en la que se inició la respuesta. El servicio genera este valor. |
x-ms-request-server-encrypted: true/false |
El valor de este encabezado se establece true en si el contenido de la solicitud se cifra correctamente mediante el algoritmo especificado. De lo contrario, el valor se establece en false . |
x-ms-file-permission-key |
Clave del permiso del archivo. |
x-ms-file-attributes |
Atributos del sistema de archivos en el archivo. Consulte la lista de atributos disponibles. |
x-ms-file-creation-time |
Valor de fecha y hora UTC que representa la propiedad de hora de creación del archivo. |
x-ms-file-last-write-time |
Valor de fecha y hora UTC que representa la última propiedad de hora de escritura del archivo. |
x-ms-file-change-time |
Fecha y hora UTC que representa la propiedad de hora de cambio del archivo. |
x-ms-file-file-id |
Identificador de archivo del archivo. |
x-ms-file-parent-id |
Identificador de archivo primario del archivo. |
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.
Authorization
Solo el propietario de la cuenta puede llamar a esta operación.
Atributos del sistema de archivos
Atributo | Atributo de archivo Win32 | Definición |
---|---|---|
ReadOnly |
FILE_ATTRIBUTE_READONLY | Directorio que es de solo lectura. |
Hidden |
FILE_ATTRIBUTE_HIDDEN | El directorio está oculto. No se incluye en una lista de directorios normal. |
System |
FILE_ATTRIBUTE_SYSTEM | Directorio del que el sistema operativo usa una parte de o usa exclusivamente. |
None |
FILE_ATTRIBUTE_NORMAL | Directorio que no tiene otros atributos establecidos. Este atributo solo es válido cuando se usa por sí solo. |
Directory |
FILE_ATTRIBUTE_DIRECTORY | Identificador que identifica un directorio. |
Archive |
FILE_ATTRIBUTE_ARCHIVE | Directorio que es un directorio de archivo. Las aplicaciones suelen usar este atributo para marcar los archivos de copia de seguridad o eliminación. |
Offline |
FILE_ATTRIBUTE_OFFLINE | Los datos de un directorio no están disponibles inmediatamente. Este atributo del sistema de archivos se presenta principalmente para proporcionar compatibilidad con Windows. Azure Files no admite las opciones de almacenamiento sin conexión. |
NotContentIndexed |
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | El servicio de indexación de contenido no indexa el directorio. |
NoScrubData |
FILE_ATTRIBUTE_NO_SCRUB_DATA | El analizador de integridad de datos en segundo plano no va a leer el flujo de datos de usuario. Este atributo del sistema de archivos se presenta principalmente para proporcionar compatibilidad con Windows. |
Comentarios
Si el destino es un directorio, el directorio no debe existir.
Rename Directory
no se admite en una instantánea de recurso compartido, que es una copia de solo lectura de un recurso compartido. Si intenta realizar esta operación en una instantánea de recurso compartido, el servicio devuelve el estado de error 400 (valor de parámetro de consulta no válido).
Si no especifica propiedades, se establecerá el comportamiento predeterminado de preserve
o now
.
Si el directorio tiene una concesión activa, el cliente debe especificar un identificador de concesión válido en la solicitud para cambiar el nombre del directorio. Si el cliente no especifica un identificador de concesión o especifica un identificador de concesión no válido, Azure Files devuelve el código de estado 412 (error en la condición previa). Si el cliente especifica un identificador de concesión, pero el directorio no tiene una concesión activa, Azure Files también devuelve el código de estado 412 (error de condición previa).