az postgres server-arc

Vista previa
Referencia

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. 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	Versión preliminar
az postgres server-arc delete	Elimine un servidor PostgreSQL habilitado para Azure Arc.	Extensión	Versión preliminar
az postgres server-arc endpoint	Administre los puntos de conexión de servidor de PostgreSQL habilitados para Azure Arc.	Extensión	Versión preliminar
az postgres server-arc endpoint list	Enumere los puntos de conexión de servidor de PostgreSQL habilitados para Azure Arc.	Extensión	Versión preliminar
az postgres server-arc list	Enumeración del servidor PostgreSQL habilitado para Azure Arc.	Extensión	Versión preliminar
az postgres server-arc restore	Restaure un servidor PostgreSQL habilitado para Azure Arc desde la copia de seguridad desde otro servidor.	Extensión	Versión preliminar
az postgres server-arc show	Muestre los detalles de un servidor PostgreSQL habilitado para Azure Arc.	Extensión	Versión preliminar
az postgres server-arc update	Actualice la configuración de un servidor PostgreSQL habilitado para Azure Arc.	Extensión	Versión preliminar

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 conector de Active Directory. Este parámetro indica una intención de implementar con compatibilidad con AD.

--admin-login-secret

Nombre del secreto de Kubernetes para generar los hosts o hospedará las credenciales de la cuenta de inicio de sesión de administrador de usuario.

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

El número mínimo de núcleos de CPU que deben estar disponibles por nodo para programar el servicio.

--dev

Si se especifica esto, se considera una instancia de desarrollo y no se facturará.

--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 creará 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 aplicarán 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 aplicarán a todos los servicios externos.

--service-type

Tipo del servicio principal.

--storage-class-backups

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

--storage-class-data

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

--storage-class-logs

La clase de almacenamiento que se va a usar para los volúmenes persistentes de registros.

--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 para 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 para 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 Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

Parámetros globales

--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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

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

--use-k8s

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

Parámetros globales

--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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

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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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

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 para los volúmenes persistentes de copia de seguridad.

--storage-class-data

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

--storage-class-logs

La clase de almacenamiento que se va a usar para los volúmenes persistentes de registros.

--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 para 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 para 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 Ki (kilobytes), Mi (megabytes) o Gi (gigabytes).

Parámetros globales

--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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

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

--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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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

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. No se puede cambiar el nombre con el que se implementa la instancia.

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 el cores_limit, especifique su valor como cadena vacía.

--cores-request

El número mínimo de núcleos de CPU que deben estar disponibles por nodo para programar el servicio. Para quitar el cores_request, especifique su valor como cadena vacía.

--dev

Si se especifica esto, se considera una instancia de desarrollo y no se facturará.

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

--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 el memory_limit, especifique su valor como 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 el memory_request, especifique su valor como cadena vacía.

--no-external-endpoint

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

--service-annotations

Lista separada por comas de anotaciones que se aplicarán 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 aplicarán 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 del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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

Comparteix a través de

az postgres server-arc

Comandos

az postgres server-arc create

Ejemplos

Parámetros requeridos

Parámetros opcionales

az postgres server-arc delete

Ejemplos

Parámetros requeridos

Parámetros opcionales

az postgres server-arc list

Ejemplos

Parámetros opcionales

az postgres server-arc restore

Ejemplos

Parámetros requeridos

Parámetros opcionales

az postgres server-arc show

Ejemplos

Parámetros requeridos

Parámetros opcionales

az postgres server-arc update

Ejemplos

Parámetros requeridos

Parámetros opcionales

Recursos addicionals