Compartir a través de

az storage file metadata

Note

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.

 Extension 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.

 Extension 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 --enable-file-backup-request-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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--account-key

Clave de 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.

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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.

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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.

Propiedad Valor
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.

Propiedad Valor
Valor predeterminado: False
--connection-string

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

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--disallow-trailing-dot

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

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--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.

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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.

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --enable-file-backup-request-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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--account-key

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

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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.

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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.

Propiedad Valor
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.

Propiedad Valor
Valor predeterminado: False
--connection-string

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

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--disallow-trailing-dot

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

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--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.

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --enable-file-backup-request-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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--account-key

Clave de 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.

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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.

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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.

Propiedad Valor
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.

Propiedad Valor
Valor predeterminado: False
--connection-string

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

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--disallow-trailing-dot

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

Propiedad Valor
Valor predeterminado: False
Valores aceptados: false, true
--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.

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--metadata

Metadatos en forma de 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.

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --enable-file-backup-request-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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--account-key

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

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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.

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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.

Propiedad Valor
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.

Propiedad Valor
Valor predeterminado: False
--connection-string

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

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--disallow-trailing-dot

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

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

Metadatos en forma de 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.

Propiedad Valor
Grupo de parámetros: Storage Account Arguments
--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False