Compartir vía

az storage file metadata

  • Referencia

Nota:

Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Administrar metadatos de archivo.

Comandos

Nombre Description Tipo Estado
az storage file metadata show

Devuelve todos los metadatos definidos por el usuario para el archivo.

 Core GA
az storage file metadata show (storage-preview extensión)

Devuelve todos los metadatos definidos por el usuario para el archivo.

 Extensión GA
az storage file metadata update

Actualice los metadatos del archivo.

 Core GA
az storage file metadata update (storage-preview extensión)

Actualice los metadatos del archivo.

 Extensión GA

az storage file metadata show

Editar

Devuelve todos los metadatos definidos por el usuario para el archivo.

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--file-endpoint]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

Ejemplos

Mostrar metadatos para el archivo

az storage file metadata show -s MyShare --path /path/to/file

Parámetros requeridos

--path -p

Ruta de acceso al archivo dentro del recurso compartido de archivos.

--share-name -s

Nombre del recurso compartido de archivos.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

Valores aceptados: key, login
--backup-intent --enable-file-backup-request-intent

Parámetro necesario para usar con la autenticación de OAuth (Azure AD) para archivos. Esto omitirá las comprobaciones de permisos de nivel de archivo o directorio y permitirá el acceso, en función de las acciones de datos permitidas, incluso si hay ACL en vigor para esos archivos o directorios.

Valor predeterminado: False
--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Si es true, el punto final se recortará del URI de destino. Valor predeterminado es False.

Valores aceptados: false, true
Valor predeterminado: False
--file-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Cadena que representa la versión de instantánea, si procede.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage file metadata show (storage-preview extensión)

Devuelve todos los metadatos definidos por el usuario para el archivo.

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

Ejemplos

Mostrar metadatos para el archivo

az storage file metadata show -s MyShare --path /path/to/file

Parámetros requeridos

--path -p

Ruta de acceso al archivo dentro del recurso compartido de archivos.

--share-name -s

Nombre del recurso compartido de archivos.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

Valores aceptados: key, login
--backup-intent --enable-file-backup-request-intent

Parámetro necesario para usar con la autenticación de OAuth (Azure AD) para archivos. Esto omitirá las comprobaciones de permisos de nivel de archivo o directorio y permitirá el acceso, en función de las acciones de datos permitidas, incluso si hay ACL en vigor para esos archivos o directorios.

Valor predeterminado: False
--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Si es true, el punto final se recortará del URI de destino. Valor predeterminado es False.

Valores aceptados: false, true
Valor predeterminado: False
--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--snapshot

Cadena que representa la versión de instantánea, si procede.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage file metadata update

Editar

Actualice los metadatos del archivo.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--file-endpoint]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

Ejemplos

Actualización de los metadatos del archivo

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

Parámetros requeridos

--path -p

Ruta de acceso al archivo dentro del recurso compartido de archivos.

--share-name -s

Nombre del recurso compartido de archivos.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

Valores aceptados: key, login
--backup-intent --enable-file-backup-request-intent

Parámetro necesario para usar con la autenticación de OAuth (Azure AD) para archivos. Esto omitirá las comprobaciones de permisos de nivel de archivo o directorio y permitirá el acceso, en función de las acciones de datos permitidas, incluso si hay ACL en vigor para esos archivos o directorios.

Valor predeterminado: False
--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Si es true, el punto final se recortará del URI de destino. Valor predeterminado es False.

Valores aceptados: false, true
Valor predeterminado: False
--file-endpoint

Punto de conexión de servicio de datos de almacenamiento. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Puede encontrar cada punto de conexión principal de servicio con az storage account show. Variable de entorno: AZURE_STORAGE_SERVICE_ENDPOINT.

--metadata

Metadatos en pares clave=valor separados por espacios. Esto sobrescribe los metadatos existentes.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento o el punto de conexión de servicio. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az storage file metadata update (storage-preview extensión)

Actualice los metadatos del archivo.

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

Ejemplos

Actualización de los metadatos del archivo

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

Parámetros requeridos

--path -p

Ruta de acceso al archivo dentro del recurso compartido de archivos.

--share-name -s

Nombre del recurso compartido de archivos.

Parámetros opcionales

--account-key

Clave de la cuenta de almacenamiento. Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_KEY.

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT. Debe usarse junto con una clave de cuenta de almacenamiento o un token de SAS. Si ninguno está presente, el comando intentará consultar la clave de la cuenta de almacenamiento mediante la cuenta de Azure autenticada. Si se ejecuta un gran número de comandos de almacenamiento, se puede alcanzar la cuota de API.

--auth-mode

Modo en el que se va a ejecutar el comando. El modo "login" usará directamente las credenciales de inicio de sesión para la autenticación. El modo "clave" heredado intentará consultar una clave de cuenta si no se proporcionan parámetros de autenticación para la cuenta. Variable de entorno: AZURE_STORAGE_AUTH_MODE.

Valores aceptados: key, login
--backup-intent --enable-file-backup-request-intent

Parámetro necesario para usar con la autenticación de OAuth (Azure AD) para archivos. Esto omitirá las comprobaciones de permisos de nivel de archivo o directorio y permitirá el acceso, en función de las acciones de datos permitidas, incluso si hay ACL en vigor para esos archivos o directorios.

Valor predeterminado: False
--connection-string

Cadena de conexión de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_CONNECTION_STRING.

--disallow-trailing-dot

Si es true, el punto final se recortará del URI de destino. Valor predeterminado es False.

Valores aceptados: false, true
Valor predeterminado: False
--metadata

Metadatos en pares clave=valor separados por espacios. Esto sobrescribe los metadatos existentes.

--sas-token

Una firma de acceso compartido (SAS). Debe usarse junto con el nombre de la cuenta de almacenamiento. Variable de entorno: AZURE_STORAGE_SAS_TOKEN.

--timeout

Tiempo de espera de la solicitud en segundos. Se aplica a cada llamada al servicio.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.