az postgres server-arc

Nota:

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

Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administración de servidores PostgreSQL habilitados para Azure Arc.

Comandos

Nombre Description Tipo Estado
az postgres server-arc create

Cree un servidor PostgreSQL habilitado para Azure Arc.

Extensión Vista previa
az postgres server-arc delete

Elimine un servidor PostgreSQL habilitado para Azure Arc.

Extensión Vista previa
az postgres server-arc endpoint

Administre los puntos de conexión de servidor de PostgreSQL habilitados para Azure Arc.

Extensión Vista previa
az postgres server-arc endpoint list

Enumere los puntos de conexión de servidor de PostgreSQL habilitados para Azure Arc.

Extensión Vista previa
az postgres server-arc list

Enumeración del servidor PostgreSQL habilitado para Azure Arc.

Extensión Vista previa
az postgres server-arc restore

Restaure un servidor PostgreSQL habilitado para Azure Arc desde la copia de seguridad desde otro servidor.

Extensión Vista previa
az postgres server-arc show

Muestre los detalles de un servidor PostgreSQL habilitado para Azure Arc.

Extensión Vista previa
az postgres server-arc update

Actualice la configuración de un servidor PostgreSQL habilitado para Azure Arc.

Extensión Vista previa

az postgres server-arc create

Vista previa

El grupo de comandos "postgres server-arc" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree un servidor PostgreSQL habilitado para Azure Arc.

Para establecer la contraseña del servidor, establezca la variable de entorno AZDATA_PASSWORD.

az postgres server-arc create --name
                              [--ad-account-name]
                              [--ad-connector-name]
                              [--admin-login-secret]
                              [--cert-private-key-file]
                              [--cert-public-key-file]
                              [--cores-limit]
                              [--cores-request]
                              [--dev]
                              [--dns-name]
                              [--extensions]
                              [--k8s-namespace]
                              [--keytab-secret]
                              [--log-level]
                              [--memory-limit]
                              [--memory-request]
                              [--no-external-endpoint]
                              [--no-wait]
                              [--path]
                              [--port]
                              [--retention-days]
                              [--service-annotations]
                              [--service-cert-secret]
                              [--service-labels]
                              [--service-type]
                              [--storage-class-backups]
                              [--storage-class-data]
                              [--storage-class-logs]
                              [--use-k8s]
                              [--volume-size-backups]
                              [--volume-size-data]
                              [--volume-size-logs]

Ejemplos

Cree un servidor PostgreSQL habilitado para Azure Arc.

az postgres server-arc create -n pg1 --k8s-namespace namespace --use-k8s

Parámetros requeridos

--name -n

Nombre del servidor PostgreSQL habilitado para Azure Arc.

Parámetros opcionales

--ad-account-name

Nombre de la cuenta de Active Directory para este servidor postgreSQL habilitado para Azure Arc. Esta cuenta debe crearse antes de la implementación de esta instancia.

--ad-connector-name

Nombre del Conectar or de Active Directory. Este parámetro indica una intención de implementar con compatibilidad con AD.

--admin-login-secret

Nombre del secreto de Kubernetes que se va a generar y que hospeda u hospedará la credencial de la cuenta de inicio de sesión del administrador de usuarios.

--cert-private-key-file

Ruta de acceso al archivo que contiene una clave privada de certificado con formato PEM que se usará para las conexiones SSL de cliente.

--cert-public-key-file

Ruta de acceso al archivo que contiene una clave pública de certificado con formato PEM que se usará para las conexiones SSL de cliente.

--cores-limit

Número máximo de núcleos de CPU que se pueden usar para el servidor PostgreSQL habilitado para Azure Arc.

--cores-request

Número mínimo de núcleos de CPU que debe haber disponibles por nodo para programar el servicio.

--dev

Si se especifica, se considera una instancia de desarrollo y no se factura.

--dns-name

Nombre DNS del servicio expuesto a los usuarios finales para conectarse a este servidor PostgreSQL habilitado para Azure Arc (por ejemplo, pginstancename.contoso.com).

--extensions

Lista separada por comas de extensiones que se van a habilitar. Una vez habilitada, la extensión se puede instalar mediante el comando "CREATE EXTENSION".

--k8s-namespace -k

Espacio de nombres de Kubernetes donde se implementa el servidor PostgreSQL habilitado para Azure Arc. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--keytab-secret

Nombre del secreto de Kubernetes que contiene el archivo keytab para este servidor postgreSQL habilitado para Azure Arc.

--log-level

Establece la configuración de log_min_messages para el motor de PostgreSQL. Los valores válidos son: DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC.

--memory-limit

El límite de memoria del servidor PostgreSQL habilitado para Azure Arc como un número seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

--memory-request

Solicitud de memoria del servidor PostgreSQL habilitado para Azure Arc como un número seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

--no-external-endpoint

Si se especifica, no se crea ningún servicio externo. De lo contrario, se creará un servicio externo con el tipo especificado con el argumento --service-type o el mismo tipo de servicio que el controlador de datos.

--no-wait

No espere a que la implementación esté lista antes de volver.

valor predeterminado: False
--path

Ruta de acceso al archivo JSON de origen para el servidor PostgreSQL habilitado para Azure Arc. Esto es opcional.

--port

Número de puerto en el que se expone el servicio principal a los usuarios finales.

--retention-days

Período de retención de copia de seguridad, especificado en días. Los valores permitidos son de 0 a 35. El valor predeterminado es 7. Al establecer el período de retención en 0, se desactivarán las copias de seguridad automáticas para PostgreSql habilitado para Azure Arc.

--service-annotations

Lista separada por comas de anotaciones que se van a aplicar a todos los servicios externos.

--service-cert-secret

Nombre del secreto de Kubernetes para generar que hospeda el certificado SSL.

--service-labels

Lista separada por comas de etiquetas que se van a aplicar a todos los servicios externos.

--service-type

Tipo del servicio principal.

--storage-class-backups

Clase de almacenamiento que se va a usar en los volúmenes persistentes de copia de seguridad.

--storage-class-data

Clase de almacenamiento que se va a usar en los volúmenes persistentes de datos.

--storage-class-logs

Clase de almacenamiento que se va a usar en los volúmenes persistentes de registro.

--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

--volume-size-backups

Tamaño del volumen de almacenamiento que se va a usar en las copias de seguridad como un número positivo seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

--volume-size-data

Tamaño del volumen de almacenamiento que se va a usar en los datos como un número positivo seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

--volume-size-logs

Tamaño del volumen de almacenamiento que se va a usar para los registros como un número positivo seguido de K (kilobytes), MB (megabytes) o GB (gigabytes).

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 postgres server-arc delete

Vista previa

El grupo de comandos "postgres server-arc" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine un servidor PostgreSQL habilitado para Azure Arc.

az postgres server-arc delete --name
                              [--force]
                              [--k8s-namespace]
                              [--use-k8s]

Ejemplos

Elimine un servidor PostgreSQL habilitado para Azure Arc.

az postgres server-arc delete -n pg1 --k8s-namespace namespace --use-k8s

Parámetros requeridos

--name -n

Nombre del servidor PostgreSQL habilitado para Azure Arc.

Parámetros opcionales

--force -f

Elimine el servidor PostgreSQL habilitado para Azure Arc sin confirmación.

valor predeterminado: False
--k8s-namespace -k

Espacio de nombres de Kubernetes donde se implementa el servidor PostgreSQL habilitado para Azure Arc. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

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 postgres server-arc list

Vista previa

El grupo de comandos "postgres server-arc" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumeración del servidor PostgreSQL habilitado para Azure Arc.

az postgres server-arc list [--k8s-namespace]
                            [--use-k8s]

Ejemplos

Enumeración del servidor PostgreSQL habilitado para Azure Arc.

az postgres server-arc list --k8s-namespace namespace --use-k8s

Parámetros opcionales

--k8s-namespace -k

Espacio de nombres de Kubernetes donde se implementan los servidores postgreSQL habilitados para Azure Arc. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

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 postgres server-arc restore

Vista previa

El grupo de comandos "postgres server-arc" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Restaure un servidor PostgreSQL habilitado para Azure Arc desde la copia de seguridad desde otro servidor.

Para establecer la contraseña del servidor, establezca la variable de entorno AZDATA_PASSWORD.

az postgres server-arc restore --k8s-namespace
                               --name
                               --source-server
                               [--dry-run]
                               [--no-wait]
                               [--storage-class-backups]
                               [--storage-class-data]
                               [--storage-class-logs]
                               [--time]
                               [--use-k8s]
                               [--volume-size-backups]
                               [--volume-size-data]
                               [--volume-size-logs]

Ejemplos

Restaure un servidor postgreSQL habilitado para Azure Arc.

az postgres server-arc restore -n <to-pg> --source-server <from-pg> --k8s-namespace namespace --use-k8s

Parámetros requeridos

--k8s-namespace -k

Espacio de nombres de Kubernetes que contiene PostgreSql habilitado para Azure Arc. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--name -n

Nombre del servidor postgreSQL habilitado para Azure Arc que se va a crear.

--source-server

Nombre del servidor PostgreSQL habilitado para Azure Arc desde el que se va a restaurar.

Parámetros opcionales

--dry-run

Si se establece, valida los recursos de origen y destino y el tiempo, sin realizar la restauración. Los tiempos de restauración más antiguos y más recientes posibles se devuelven en el estado de la tarea de restauración.

valor predeterminado: False
--no-wait

No espere a que la implementación esté lista antes de volver.

valor predeterminado: False
--storage-class-backups

Clase de almacenamiento que se va a usar en los volúmenes persistentes de copia de seguridad.

--storage-class-data

Clase de almacenamiento que se va a usar en los volúmenes persistentes de datos.

--storage-class-logs

Clase de almacenamiento que se va a usar en los volúmenes persistentes de registro.

--time -t

El momento dado del servidor de origen que se restaurará para crear el nuevo servidor PostgreSQL habilitado para Azure Arc. Debe ser mayor o igual que el valor de fecha y hora de restauración más antiguo de la base de datos de origen. La hora debe tener el siguiente formato: "AAAA-MM-DDTHH:MM:SSZ". Si no se proporciona ningún tiempo, se restaurará la copia de seguridad más reciente.

--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

--volume-size-backups

Tamaño del volumen de almacenamiento que se va a usar en las copias de seguridad como un número positivo seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

--volume-size-data

Tamaño del volumen de almacenamiento que se va a usar en los datos como un número positivo seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

--volume-size-logs

Tamaño del volumen de almacenamiento que se va a usar para los registros como un número positivo seguido de K (kilobytes), MB (megabytes) o GB (gigabytes).

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 postgres server-arc show

Vista previa

El grupo de comandos "postgres server-arc" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Muestre los detalles de un servidor PostgreSQL habilitado para Azure Arc.

az postgres server-arc show --name
                            [--k8s-namespace]
                            [--path]
                            [--use-k8s]

Ejemplos

Muestre los detalles de un servidor PostgreSQL habilitado para Azure Arc.

az postgres server-arc show -n pg1 --k8s-namespace namespace --use-k8s

Parámetros requeridos

--name -n

Nombre del servidor PostgreSQL habilitado para Azure Arc.

Parámetros opcionales

--k8s-namespace -k

Espacio de nombres de Kubernetes donde se implementa el servidor PostgreSQL habilitado para Azure Arc. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--path

Ruta de acceso en la que se debe escribir la especificación completa del servidor PostgreSQL habilitado para Azure Arc. Si se omite, la especificación se escribirá en la salida estándar.

--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

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 postgres server-arc update

Vista previa

El grupo de comandos "postgres server-arc" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Actualice la configuración de un servidor PostgreSQL habilitado para Azure Arc.

az postgres server-arc update --name
                              [--cert-private-key-file]
                              [--cert-public-key-file]
                              [--cores-limit]
                              [--cores-request]
                              [--dev]
                              [--extensions]
                              [--k8s-namespace]
                              [--keytab-secret]
                              [--log-level]
                              [--memory-limit]
                              [--memory-request]
                              [--no-external-endpoint]
                              [--no-wait]
                              [--path]
                              [--port]
                              [--retention-days]
                              [--service-annotations]
                              [--service-cert-secret]
                              [--service-labels]
                              [--service-type]
                              [--use-k8s]

Ejemplos

Actualice la configuración de un servidor PostgreSQL habilitado para Azure Arc.

az postgres server-arc update --path ./spec.json -n pg1 --k8s-namespace namespace --use-k8s

Habilite las extensiones para un servidor PostgreSQL habilitado para Azure Arc existente.

az postgres server-arc update -n pg1 --extensions 'pgaudit,pg_partman' --k8s-namespace namespace --use-k8s

Quite extensiones de un servidor PostgreSQL habilitado para Azure Arc.

az postgres server-arc update -n pg1 --extensions "''" --k8s-namespace namespace --use-k8s

Parámetros requeridos

--name -n

Nombre del servidor postgreSQL habilitado para Azure Arc que se está actualizando. El nombre con el que se implementa la instancia no se puede cambiar.

Parámetros opcionales

--cert-private-key-file

Ruta de acceso al archivo que contiene una clave privada de certificado con formato PEM que se usará para las conexiones SSL de cliente.

--cert-public-key-file

Ruta de acceso al archivo que contiene una clave pública de certificado con formato PEM que se usará para las conexiones SSL de cliente.

--cores-limit

Número máximo de núcleos de CPU para el servidor PostgreSQL habilitado para Azure Arc que se puede usar por nodo. Para quitar los límites de núcleos, especifique su valor como una cadena vacía.

--cores-request

Número mínimo de núcleos de CPU que debe haber disponibles por nodo para programar el servicio. Para quitar las solicitudes de núcleos, especifique su valor como una cadena vacía.

--dev

Si se especifica, se considera una instancia de desarrollo y no se factura.

--extensions

Lista separada por comas de extensiones que se van a habilitar. Para agregar o quitar una nueva extensión, actualice la lista de extensiones existente. Una vez habilitada, la extensión se puede instalar mediante el comando "CREATE EXTENSION".

--k8s-namespace -k

Espacio de nombres de Kubernetes donde se implementa el servidor PostgreSQL habilitado para Azure Arc. Si no se especifica ningún espacio de nombres, se utilizará el espacio de nombres definido en kubeconfig.

--keytab-secret

Nombre del secreto de Kubernetes que contiene el archivo keytab para este servidor postgreSQL habilitado para Azure Arc.

--log-level

Establece la configuración de log_min_messages para el motor de PostgreSQL. Los valores válidos son: DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC.

--memory-limit

El límite de memoria para el servidor PostgreSQL habilitado para Azure Arc como un número seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes). Para quitar los límites de memoria, especifique su valor como una cadena vacía.

--memory-request

La solicitud de memoria para el servidor PostgreSQL habilitado para Azure Arc como un número seguido de Ki (kilobytes), Mi (megabytes) o Gi (gigabytes). Para quitar la solicitud de memoria, especifique su valor como una cadena vacía.

--no-external-endpoint

Si se especifica, no se crea ningún servicio externo. De lo contrario, se creará un servicio externo con el tipo especificado con el argumento --service-type o el mismo tipo de servicio que el controlador de datos.

--no-wait

No espere a que la implementación esté lista antes de volver.

valor predeterminado: False
--path

Ruta de acceso al archivo JSON de origen para el servidor PostgreSQL habilitado para Azure Arc. Esto es opcional.

--port

Número de puerto en el que se expone el servicio principal a los usuarios finales.

--retention-days

Período de retención de copia de seguridad, especificado en días. Los valores permitidos son de 0 a 35. El valor predeterminado es 7. Al establecer el período de retención en 0, se desactivarán las copias de seguridad automáticas para PostgreSql habilitado para Azure Arc.

--service-annotations

Lista separada por comas de anotaciones que se van a aplicar a todos los servicios externos.

--service-cert-secret

Nombre del secreto de Kubernetes para generar que hospeda el certificado SSL.

--service-labels

Lista separada por comas de etiquetas que se van a aplicar a todos los servicios externos.

--service-type

Tipo del servicio principal.

--use-k8s

Use las API de Kubernetes locales para realizar esta acción.

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.