az sql mi-arc config

Note

Esta referencia forma parte de la extensión arcdata para el CLI de Azure (versión 2.3.1 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az sql mi-arc config. Obtenga más información sobre las extensiones.

Comandos de configuración.

Comandos

Nombre Description Tipo Estado
az sql mi-arc config add

Agregue un valor para una ruta de acceso json en un archivo de configuración.

Extension GA
az sql mi-arc config init

Inicialice el CRD y los archivos de especificación de una instancia administrada de SQL.

Extension GA
az sql mi-arc config patch

Aplique revisiones a un archivo de configuración basado en un archivo de revisión json.

Extension GA
az sql mi-arc config remove

Quite un valor de una ruta de acceso json en un archivo de configuración.

Extension GA
az sql mi-arc config replace

Reemplace un valor para una ruta de acceso json en un archivo de configuración.

Extension GA

az sql mi-arc config add

Agregue un valor para una ruta de acceso json en un archivo de configuración.

Agregue el valor en la ruta de acceso json en el archivo de configuración. Todos los ejemplos siguientes se proporcionan en Bash. Si usa otra línea de comandos, es posible que tenga que escapar las comillas correctamente. Como alternativa, puede usar la funcionalidad del archivo de revisión.

az sql mi-arc config add --json-values
                         --path
                         [--acquire-policy-token]
                         [--change-reference]

Ejemplos

Ejemplo 1: Agregar almacenamiento.

az sql mi-arc config add --path custom/spec.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

Parámetros requeridos

--json-values -j

Lista de pares clave-valor de rutas de acceso json a valores: key1.subkey1=value1,key2.subkey2=value2. Puede proporcionar valores JSON insertados como: key='{"kind":"cluster","name":"test-cluster"}' o proporcionar una ruta de acceso de archivo, como key=./values.json. El comando add no admite condicionales. Si el valor insertado que va a proporcionar es un par clave-valor con = y , escape esos caracteres. Por ejemplo: key1=\"key2\=val2\,key3\=val3\". Consulte http://jsonpatch.com/ para obtener ejemplos de cómo debería tener su ruta de acceso. Si desea acceder a una matriz, debe hacerlo indicando el índice, como key.0=value.

--path -p

Ruta de acceso a la especificación de recursos personalizada, es decir, custom/spec.json.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
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 sql mi-arc config init

Inicialice el CRD y los archivos de especificación de una instancia administrada de SQL.

az sql mi-arc config init --path
                          [--acquire-policy-token]
                          [--change-reference]

Ejemplos

Inicialice el CRD y los archivos de especificación de una instancia administrada de SQL.

az sql mi-arc config init --path ./template

Parámetros requeridos

--path -p

Ruta de acceso en la que se debe escribir la CRD y la especificación de la instancia administrada de SQL.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
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 sql mi-arc config patch

Aplique revisiones a un archivo de configuración basado en un archivo de revisión json.

Revise el archivo de configuración según el archivo de revisión especificado. Consulte http://jsonpatch.com/ para comprender mejor cómo se deben componer las rutas de acceso. La operación de reemplazo puede usar condicionales en su ruta de acceso debido a la biblioteca jsonpath https://jsonpath.com/. Todos los archivos JSON de revisión deben comenzar con una clave de patch que tenga una matriz de revisiones con su operación correspondiente (agregar, reemplazar, quitar), ruta de acceso y valor. La remove operación no requiere un valor, solo una ruta de acceso. Consulte los ejemplos más abajo.

az sql mi-arc config patch --patch-file
                           --path
                           [--acquire-policy-token]
                           [--change-reference]

Ejemplos

Ejemplo 1: reemplace el puerto de un único punto de conexión por el archivo de revisión.

az sql mi-arc config patch --path custom/spec.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":"$.spec.endpoints[?(@.name=='Controller')].port","value":30080}]}

Por ejemplo, 2: reemplace el almacenamiento por el archivo de revisión.

az sql mi-arc config patch --path custom/spec.json --patch ./patch.json

    Patch File Example (patch.json):
        {"patch":[{"op":"replace","path":".spec.storage","value":{"accessMode":"ReadWriteMany","className":"managed-premium","size":"10Gi"}}]}

Parámetros requeridos

--patch-file

Ruta de acceso a un archivo JSON de revisión basado en la biblioteca jsonpatch: http://jsonpatch.com/. Debe iniciar el archivo JSON de revisión con una clave denominada patch, cuyo valor es una matriz de operaciones de revisión que pretende realizar. Para la ruta de acceso de una operación de revisión, puede usar la notación de puntos, como key1.key2 para la mayoría de las operaciones. Si desea realizar una operación de reemplazo y va a reemplazar un valor en una matriz que requiera un condicional, use la notación jsonpath iniciando la ruta de acceso con $. Esto le permitirá realizar un condicional como $.key1.key2[?(@.key3=="someValue"].key4. Consulte los ejemplos siguientes. Para obtener ayuda adicional con los condicionales, consulte: https://jsonpath.com/.

--path -p

Ruta de acceso a la especificación de recursos personalizada, es decir, custom/spec.json.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
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 sql mi-arc config remove

Quite un valor de una ruta de acceso json en un archivo de configuración.

Quite el valor en la ruta de acceso json del archivo de configuración. Todos los ejemplos siguientes se proporcionan en Bash. Si usa otra línea de comandos, es posible que tenga que escapar las comillas correctamente. Como alternativa, puede usar la funcionalidad del archivo de revisión.

az sql mi-arc config remove --json-path
                            --path
                            [--acquire-policy-token]
                            [--change-reference]

Ejemplos

Ejemplo 1: Quitar almacenamiento.

az sql mi-arc config remove --path custom/spec.json --json-path '.spec.storage'

Parámetros requeridos

--json-path -j

Lista de rutas de acceso json basadas en la biblioteca jsonpatch que indica qué valores desea quitar, como: key1.subkey1,key2.subkey2. El comando remove no admite condicionales. Consulte http://jsonpatch.com/ para obtener ejemplos de cómo debería tener su ruta de acceso. Si desea acceder a una matriz, debe hacerlo indicando el índice, como key.0=value.

--path -p

Ruta de acceso a la especificación de recursos personalizada, es decir, custom/spec.json.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
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 sql mi-arc config replace

Reemplace un valor para una ruta de acceso json en un archivo de configuración.

Reemplace el valor en la ruta de acceso json del archivo de configuración. Todos los ejemplos siguientes se proporcionan en Bash. Si usa otra línea de comandos, es posible que tenga que escapar las comillas correctamente. Como alternativa, puede usar la funcionalidad del archivo de revisión.

az sql mi-arc config replace --json-values
                             --path
                             [--acquire-policy-token]
                             [--change-reference]

Ejemplos

Ejemplo 1: reemplace el puerto de un único punto de conexión.

az sql mi-arc config replace --path custom/spec.json --json-values '$.spec.endpoints[?(@.name=="Controller")].port=30080'

Por ejemplo, 2: reemplazar el almacenamiento.

az sql mi-arc config replace --path custom/spec.json --json-values 'spec.storage={"accessMode":"ReadWriteOnce","className":"managed-premium","size":"10Gi"}'

Parámetros requeridos

--json-values -j

Lista de pares clave-valor de rutas de acceso json a valores: key1.subkey1=value1,key2.subkey2=value2. Puede proporcionar valores JSON insertados como: key={"kind":"cluster","name":"test-cluster"} o proporcionar una ruta de acceso de archivo, como key=./values.json. El comando replace admite condicionales a través de la biblioteca jsonpath. Para usarlo, inicie la ruta de acceso con $. Esto le permitirá realizar un condicional como -j $.key1.key2[?(@.key3=="someValue"].key4=value. Si el valor insertado que va a proporcionar es un par clave-valor con = y , escape esos caracteres. Por ejemplo: key1=\"key2\=val2\,key3\=val3\". Puede ver ejemplos a continuación. Para obtener ayuda adicional, consulte: https://jsonpath.com/.

--path -p

Ruta de acceso a la especificación de recursos personalizada, es decir, custom/spec.json.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
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