azcopy set-properties (versión preliminar)
Dada una ubicación, cambie todas las propiedades válidas del sistema de ese almacenamiento (blob o archivo).
Sinopsis
azcopy set-properties [resourceURL] [flags]
Establece las propiedades de Blob y File Storage. Las propiedades admitidas actualmente por este comando son:
- Blobs -> nivel, metadatos, etiquetas
- Data Lake Storage Gen2 -> nivel, metadatos, etiquetas
- Archivos -> metadatos
Nota
Los puntos de conexión de Data Lake Storage Gen2 se reemplazarán por puntos de conexión de Blob Storage.
Consulte los ejemplos para más información.
Artículos conceptuales relacionados
- Introducción a AzCopy
- Reemplazo de las propiedades y los metadatos de blob mediante AzCopy v10 (versión preliminar)
Ejemplos
Cambie el nivel de blob a acceso frecuente:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot
Cambie el nivel de blob de archivo a acceso esporádico con prioridad de rehidratación establecida en alta:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cool --rehydrate-priority=high
Cambie el nivel de todos los archivos de un directorio a archivo:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --block-blob-tier=archive --recursive=true
Cambie los metadatos del blob a {key = "abc", val = "def"} y {key = "ghi", val = "jkl"}:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=abc=def;ghi=jkl
Cambie los metadatos de todos los archivos de un directorio a {key = "abc", val = "def"} y {key = "ghi", val = "jkl"}:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --metadata=abc=def;ghi=jkl --recursive=true
Borre todos los metadatos existentes del blob:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --metadata=clear
Cambie las etiquetas del blob de blob a {key = "abc", val = "def"} y {key = "ghi", val = "jkl"}:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=abc=def&ghi=jkl
Al establecer etiquetas en los blobs, hay otros permisos (”t” para etiquetas) con SAS. Sin esas etiquetas, el servicio devolverá un error de autorización.
Borre todas las etiquetas de blob existentes del blob:
azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --blob-tags=clear
Al establecer etiquetas en los blobs, hay otros permisos (”t” para etiquetas) con SAS. Sin esas etiquetas, el servicio devolverá un error de autorización.
Opciones
--blob-tags string Establezca etiquetas en blobs para clasificar los datos de la cuenta de almacenamiento (separados por '&')
--block-blob-tier (cadena) Cambia el nivel de acceso de los blobs al nivel especificado (el valor predeterminado es "None")
--dry-run Imprime las rutas de archivo que copiará este comando. Esta marca no copia los archivos reales.
Cadena --exclude-path: excluye estas rutas de acceso al eliminar. Esta opción no permite caracteres comodín (*). Comprueba el prefijo de ruta de acceso relativa. Por ejemplo: myFolder;myFolder/subDirName/file.pdf.
Cadena --exclude-pattern: excluye los archivos en los que el nombre coincide con la lista de patrones. Por ejemplo: .jpg; .pdf; exactName.
Cadena --from-to: opcionalmente, especifica la combinación de destino de origen. Valores válidos: BlobNone, FileNone, BlobFSNone
-h, --help ayuda para set-properties
--include-path (cadena) Incluye solo estas rutas de acceso al eliminar. Esta opción no permite caracteres comodín (*). Comprueba el prefijo de ruta de acceso relativa. Por ejemplo: myFolder;myFolder/subDirName/file.pdf
Cadena --include-pattern: incluye solo los archivos en los que el nombre coincide con la lista de patrones. Por ejemplo: .jpg; .pdf; exactName.
--list-of-files (cadena) Define la ubicación del archivo de texto que tiene la lista de archivos que se van a copiar.
--metadata (cadena) Establece la ubicación especificada con estos pares clave-valor (separados por ";") como metadatos.
Cadena --page-blob-tier: carga un blob en páginas en Azure Storage con este nivel de blobs. (el valor predeterminado es "None") (el valor predeterminado es "None")
--recursive Busca en subdirectorios de forma recursiva al cargar desde el sistema de archivos local.
--rehydrate-priority (cadena) Marca opcional que establece la prioridad de rehidratación para la rehidratación. Valores válidos: Standard, High. Valor predeterminado: standard (valor predeterminado "Standard")
Opciones heredadas de comandos primarios
--cap-mbps float Limita la velocidad de transferencia, en megabits por segundo. El rendimiento en un momento dado puede variar ligeramente del límite. Si esta opción se establece en cero o se omite, el rendimiento no se limita.
--log-level (string) Define el nivel de detalle para el archivo de registro; los niveles disponibles son: INFO (todas las solicitudes y respuestas), WARNING (respuestas lentas), ERROR (solo solicitudes con error) y NONE (sin registros de salida). (Valor predeterminado: "INFO"). (Valor predeterminado: "INFO").
Cadena --output-type Formato de la salida del comando. Las opciones incluyen: text, json. El valor predeterminado es "text". (Valor predeterminado: "text").
--output-level (cadena) Define el nivel de detalle de salida. Niveles disponibles: essential, quiet. (Valor predeterminado: "default")
--trusted-microsoft-suffixes (cadena) Especifica otros sufijos de dominio en los que se pueden enviar tokens de inicio de sesión de Microsoft Entra ID. El valor predeterminado es ".core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net". Los valores que se muestran aquí se agregan al valor predeterminado. Por seguridad, solo debe poner aquí dominios de Microsoft Azure. Separe las entradas con punto y coma.