Compartir por

azcopy set-properties

  • Artigo

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.

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 a frío:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=cold

Cambie el nivel de blob de frecuente a archivo:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=archive

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 blob de esporádico a frecuente con la prioridad rehidratación establecida en estándar:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --block-blob-tier=hot --rehydrate-priority=standard

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

Cambiar el nivel de un blob en páginas:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --page-blob-tier=[P10/P15/P20/P30/P4/P40/P50/P6]--rehydrate-priority=[Standard/High]

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

Borre todos los metadatos existentes de todos los archivos:

azcopy set-properties "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --recursive --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.

Consulte también