Compartir a través de

az storage container immutability-policy

Administrar directivas de inmutabilidad del contenedor.

Comandos

Nombre Description Tipo Estado
az storage container immutability-policy create

Cree o actualice una directiva de inmutabilidad desbloqueada.

 Core GA
az storage container immutability-policy delete

Anula una directiva de inmutabilidad desbloqueada.

 Core GA
az storage container immutability-policy extend

Amplíe la inmutabilidadPeriodSinceCreationInDays de un valor immutabilityPolicy bloqueado.

 Core GA
az storage container immutability-policy lock

Establece immutabilityPolicy en Estado bloqueado.

 Core GA
az storage container immutability-policy show

Obtiene la directiva de inmutabilidad existente junto con la ETag correspondiente en los encabezados de respuesta y el cuerpo.

 Core GA

az storage container immutability-policy create

Editar

Cree o actualice una directiva de inmutabilidad desbloqueada.

az storage container immutability-policy create --account-name
                                                --container-name
                                                [--allow-protected-append-writes {false, true}]
                                                [--allow-protected-append-writes-all --w-all {false, true}]
                                                [--if-match]
                                                [--period]
                                                [--resource-group]

Parámetros requeridos

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT.

--container-name -c

Nombre del contenedor.

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.

--allow-protected-append-writes -w

Esta propiedad solo se puede cambiar para las directivas de retención basadas en tiempo desbloqueadas. Cuando se habilita, los nuevos bloques se pueden escribir en un blob en anexos al tiempo que se mantiene la protección y el cumplimiento de la inmutabilidad. Solo se pueden agregar nuevos bloques y no se pueden modificar ni eliminar los bloques existentes. Esta propiedad no se puede cambiar con ExtendImmutabilityPolicy API.

Propiedad Valor
Valores aceptados: false, true
--allow-protected-append-writes-all --w-all

Esta propiedad solo se puede cambiar para las directivas de retención basadas en tiempo desbloqueadas. Cuando se habilita, los nuevos bloques se pueden escribir en "Append y Block Blobs" al tiempo que se mantiene la protección y el cumplimiento de la inmutabilidad. Solo se pueden agregar nuevos bloques y no se pueden modificar ni eliminar los bloques existentes. Esta propiedad no se puede cambiar con ExtendImmutabilityPolicy API. Las propiedades 'allowProtectedAppendWrites' y 'allowProtectedAppendWritesAll' son mutuamente excluyentes.

Propiedad Valor
Valores aceptados: false, true
--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

Propiedad Valor
Grupo de parámetros: Precondition Arguments
--period

Período de inmutabilidad para los blobs del contenedor desde la creación de la directiva, en días.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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 container immutability-policy delete

Editar

Anula una directiva de inmutabilidad desbloqueada.

La respuesta de delete tiene immutabilityPeriodSinceCreationInDays establecido en 0. ETag en If-Match es necesario para esta operación. No se permite eliminar una directiva de inmutabilidad bloqueada, la única manera es eliminar el contenedor después de eliminar todos los blobs expirados dentro del contenedor bloqueado de directivas.

az storage container immutability-policy delete --account-name
                                                --container-name
                                                --if-match
                                                [--resource-group]

Parámetros requeridos

--account-name

Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuenta de almacenamiento deben tener entre 3 y 24 caracteres de longitud y usar solo números y letras minúsculas. Required.

--container-name -c

Nombre del contenedor.

--if-match

La versión de estado de entidad (ETag) de la directiva de inmutabilidad que se va a actualizar debe devolverse al servidor para todas las operaciones de actualización. El valor ETag debe incluir las comillas dobles iniciales y finales que devuelve el servicio. Required.

Propiedad Valor
Grupo de parámetros: Precondition Arguments

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.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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 container immutability-policy extend

Editar

Amplíe la inmutabilidadPeriodSinceCreationInDays de un valor immutabilityPolicy bloqueado.

az storage container immutability-policy extend --account-name
                                                --container-name
                                                --if-match
                                                [--allow-protected-append-writes {false, true}]
                                                [--allow-protected-append-writes-all --w-all {false, true}]
                                                [--period]
                                                [--resource-group]

Parámetros requeridos

--account-name

Nombre de la cuenta de almacenamiento. Variable de entorno relacionada: AZURE_STORAGE_ACCOUNT.

--container-name -c

Nombre del contenedor.

--if-match

Un valor ETag o el carácter comodín (*). Especifique este encabezado para realizar la operación solo si la ETag del recurso coincide con el valor especificado.

Propiedad Valor
Grupo de parámetros: Precondition Arguments

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.

--allow-protected-append-writes -w

Esta propiedad solo se puede cambiar para las directivas de retención basadas en tiempo desbloqueadas. Cuando se habilita, los nuevos bloques se pueden escribir en un blob en anexos al tiempo que se mantiene la protección y el cumplimiento de la inmutabilidad. Solo se pueden agregar nuevos bloques y no se pueden modificar ni eliminar los bloques existentes. Esta propiedad no se puede cambiar con ExtendImmutabilityPolicy API.

Propiedad Valor
Valores aceptados: false, true
--allow-protected-append-writes-all --w-all

Esta propiedad solo se puede cambiar para las directivas de retención basadas en tiempo desbloqueadas. Cuando se habilita, los nuevos bloques se pueden escribir en "Append y Block Blobs" al tiempo que se mantiene la protección y el cumplimiento de la inmutabilidad. Solo se pueden agregar nuevos bloques y no se pueden modificar ni eliminar los bloques existentes. Esta propiedad no se puede cambiar con ExtendImmutabilityPolicy API. Las propiedades 'allowProtectedAppendWrites' y 'allowProtectedAppendWritesAll' son mutuamente excluyentes.

Propiedad Valor
Valores aceptados: false, true
--period

Período de inmutabilidad para los blobs del contenedor desde la creación de la directiva, en días.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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 container immutability-policy lock

Editar

Establece immutabilityPolicy en Estado bloqueado.

La única acción permitida en una directiva bloqueada es la acción ExtendImmutabilityPolicy. ETag en If-Match es necesario para esta operación.

az storage container immutability-policy lock --account-name
                                              --container-name
                                              --if-match
                                              [--resource-group]

Parámetros requeridos

--account-name

Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuenta de almacenamiento deben tener entre 3 y 24 caracteres de longitud y usar solo números y letras minúsculas. Required.

--container-name -c

Nombre del contenedor.

--if-match

La versión de estado de entidad (ETag) de la directiva de inmutabilidad que se va a actualizar debe devolverse al servidor para todas las operaciones de actualización. El valor ETag debe incluir las comillas dobles iniciales y finales que devuelve el servicio. Required.

Propiedad Valor
Grupo de parámetros: Precondition Arguments

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.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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 container immutability-policy show

Editar

Obtiene la directiva de inmutabilidad existente junto con la ETag correspondiente en los encabezados de respuesta y el cuerpo.

az storage container immutability-policy show --account-name
                                              --container-name
                                              [--if-match]
                                              [--resource-group]

Parámetros requeridos

--account-name

Nombre de la cuenta de almacenamiento dentro del grupo de recursos especificado. Los nombres de cuenta de almacenamiento deben tener entre 3 y 24 caracteres de longitud y usar solo números y letras minúsculas. Required.

--container-name -c

Nombre del contenedor.

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.

--if-match

La versión de estado de entidad (ETag) de la directiva de inmutabilidad que se va a actualizar debe devolverse al servidor para todas las operaciones de actualización. El valor ETag debe incluir las comillas dobles iniciales y finales que devuelve el servicio. El valor predeterminado es None.

Propiedad Valor
Grupo de parámetros: Precondition Arguments
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

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