Share via


az postgres server-arc

Nota

Essa referência faz parte da extensão arcdata para a CLI do Azure (versão 2.3.1 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az postgres server-arc . Saiba mais sobre extensões.

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie servidores PostgreSQL habilitados para Azure Arc.

Comandos

Name Description Tipo Estado
az postgres server-arc create

Crie um servidor PostgreSQL habilitado para Azure Arc.

Extensão Pré-visualizar
az postgres server-arc delete

Exclua um servidor PostgreSQL habilitado para Azure Arc.

Extensão Pré-visualizar
az postgres server-arc endpoint

Gerencie os pontos de extremidade do servidor PostgreSQL habilitados para Azure Arc.

Extensão Pré-visualizar
az postgres server-arc endpoint list

Liste os pontos de extremidade do servidor PostgreSQL habilitados para Azure Arc.

Extensão Pré-visualizar
az postgres server-arc list

Liste o servidor PostgreSQL habilitado para Azure Arc.

Extensão Pré-visualizar
az postgres server-arc restore

Restaure um servidor PostgreSQL habilitado para Azure Arc a partir do backup de outro servidor.

Extensão Pré-visualizar
az postgres server-arc show

Mostrar os detalhes de um servidor PostgreSQL habilitado para Azure Arc.

Extensão Pré-visualizar
az postgres server-arc update

Atualize a configuração de um servidor PostgreSQL habilitado para Azure Arc.

Extensão Pré-visualizar

az postgres server-arc create

Pré-visualizar

O grupo de comandos 'postgres server-arc' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie um servidor PostgreSQL habilitado para Azure Arc.

Para definir a senha do servidor, defina a variável de ambiente 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]

Exemplos

Crie um servidor PostgreSQL habilitado para Azure Arc.

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

Parâmetros Obrigatórios

--name -n

Nome do servidor PostgreSQL habilitado para Azure Arc.

Parâmetros Opcionais

--ad-account-name

O nome da conta do Ative Directory para este servidor PostgreSQL habilitado para Azure Arc. Essa conta precisa ser criada antes da implantação desta instância.

--ad-connector-name

O nome do Conector do Ative Directory. Este parâmetro indica a intenção de implantar com suporte ao AD.

--admin-login-secret

Nome do segredo do Kubernetes para gerar que hospeda ou hospedará a credencial da conta de login do administrador do usuário.

--cert-private-key-file

Caminho para o arquivo que contém uma chave privada de certificado formatada PEM a ser usada para conexões SSL do cliente.

--cert-public-key-file

Caminho para o arquivo que contém uma chave pública de certificado formatada PEM a ser usada para conexões SSL de cliente.

--cores-limit

O número máximo de núcleos de CPU que podem ser usados para o servidor PostgreSQL habilitado para Azure Arc.

--cores-request

O número mínimo de núcleos de CPU que devem estar disponíveis por nó para agendar o serviço.

--dev

Se isso for especificado, ele será considerado uma instância de desenvolvimento e não será cobrado.

--dns-name

O nome DNS do serviço exposto aos usuários finais para se conectarem a este servidor PostgreSQL habilitado para Azure Arc (por exemplo, pginstancename.contoso.com).

--extensions

Lista separada por vírgulas das extensões a serem habilitadas. Uma vez ativada, a extensão pode ser instalada através do comando 'CREATE EXTENSION'.

--k8s-namespace -k

O namespace Kubernetes onde o servidor PostgreSQL habilitado para Azure Arc é implantado. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

--keytab-secret

O nome do segredo do Kubernetes que contém o arquivo keytab para este servidor PostgreSQL habilitado para Azure Arc.

--log-level

Define a configuração de log_min_messages para o mecanismo PostgreSQL. Os valores válidos são: DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC.

--memory-limit

O limite de memória do Azure Arc habilitou o servidor PostgreSQL como um número seguido por Ki (kilobytes), Mi (megabytes) ou Gi (gigabytes).

--memory-request

A solicitação de memória do Azure Arc habilitava o servidor PostgreSQL como um número seguido por Ki (kilobytes), Mi (megabytes) ou Gi (gigabytes).

--no-external-endpoint

Se especificado, nenhum serviço externo será criado. Caso contrário, um serviço externo será criado usando o tipo fornecido com o argumento --service-type ou o mesmo tipo de serviço que o controlador de dados.

--no-wait

Não espere que a implantação esteja pronta para retornar.

valor predefinido: False
--path

O caminho para o arquivo json de origem para o servidor PostgreSQL habilitado para Azure Arc. Isto é opcional.

--port

O número da porta na qual o serviço principal é exposto aos usuários finais.

--retention-days

Período de retenção de backup, especificado em dias. Os valores permitidos são de 0 a 35. O padrão é 7. Definir o período de retenção como 0 desativará os backups automáticos para o Azure Arc habilitado para PostgreSql.

--service-annotations

Lista de anotações separadas por vírgulas a aplicar a todos os serviços externos.

--service-cert-secret

Nome do segredo do Kubernetes a ser gerado que hospeda o certificado SSL.

--service-labels

Lista de etiquetas separadas por vírgulas a aplicar a todos os serviços externos.

--service-type

O tipo para o serviço principal.

--storage-class-backups

A classe de armazenamento a ser usada para backup de volumes persistentes.

--storage-class-data

A classe de armazenamento a ser usada para volumes persistentes de dados.

--storage-class-logs

A classe de armazenamento a ser usada para logs de volumes persistentes.

--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

--volume-size-backups

O tamanho do volume de armazenamento a ser usado para backups como um número positivo seguido por Ki (kilobytes), Mi (megabytes) ou Gi (gigabytes).

--volume-size-data

O tamanho do volume de armazenamento a ser usado para dados como um número positivo seguido por Ki (kilobytes), Mi (megabytes) ou Gi (gigabytes).

--volume-size-logs

O tamanho do volume de armazenamento a ser usado para logs como um número positivo seguido por Ki (kilobytes), Mi (megabytes) ou Gi (gigabytes).

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az postgres server-arc delete

Pré-visualizar

O grupo de comandos 'postgres server-arc' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Exclua um servidor PostgreSQL habilitado para Azure Arc.

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

Exemplos

Exclua um servidor PostgreSQL habilitado para Azure Arc.

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

Parâmetros Obrigatórios

--name -n

Nome do servidor PostgreSQL habilitado para Azure Arc.

Parâmetros Opcionais

--force -f

Exclua o servidor PostgreSQL habilitado para Azure Arc sem confirmação.

valor predefinido: False
--k8s-namespace -k

O namespace Kubernetes onde o servidor PostgreSQL habilitado para Azure Arc é implantado. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az postgres server-arc list

Pré-visualizar

O grupo de comandos 'postgres server-arc' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Liste o servidor PostgreSQL habilitado para Azure Arc.

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

Exemplos

Liste o servidor PostgreSQL habilitado para Azure Arc.

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

Parâmetros Opcionais

--k8s-namespace -k

O namespace Kubernetes onde os servidores PostgreSQL habilitados para Azure Arc são implantados. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az postgres server-arc restore

Pré-visualizar

O grupo de comandos 'postgres server-arc' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Restaure um servidor PostgreSQL habilitado para Azure Arc a partir do backup de outro servidor.

Para definir a senha do servidor, defina a variável de ambiente 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]

Exemplos

Restaure um 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 Obrigatórios

--k8s-namespace -k

O namespace Kubernetes que contém o Azure Arc habilitado PostgreSql. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

--name -n

Nome do Azure Arc habilitado para servidor PostgreSQL a ser criado.

--source-server

O nome do Azure Arc permitiu que o servidor PostgreSQL fosse restaurado.

Parâmetros Opcionais

--dry-run

Se definido, valida os recursos de origem e destino e o tempo, sem executar a restauração. Os tempos de restauração mais antigos e mais recentes possíveis são retornados no status da tarefa de restauração.

valor predefinido: False
--no-wait

Não espere que a implantação esteja pronta para retornar.

valor predefinido: False
--storage-class-backups

A classe de armazenamento a ser usada para backup de volumes persistentes.

--storage-class-data

A classe de armazenamento a ser usada para volumes persistentes de dados.

--storage-class-logs

A classe de armazenamento a ser usada para logs de volumes persistentes.

--time -t

O ponto no tempo do servidor de origem que será restaurado para criar o novo servidor PostgreSQL habilitado para Azure Arc. Deve ser maior ou igual ao valor de data/hora de restauração mais antigo do banco de dados de origem. A hora deve ter o seguinte formato: «AAAA-MM-DDTHH:MM:SSZ». Se não houver tempo, o backup mais recente será restaurado.

--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

--volume-size-backups

O tamanho do volume de armazenamento a ser usado para backups como um número positivo seguido por Ki (kilobytes), Mi (megabytes) ou Gi (gigabytes).

--volume-size-data

O tamanho do volume de armazenamento a ser usado para dados como um número positivo seguido por Ki (kilobytes), Mi (megabytes) ou Gi (gigabytes).

--volume-size-logs

O tamanho do volume de armazenamento a ser usado para logs como um número positivo seguido por Ki (kilobytes), Mi (megabytes) ou Gi (gigabytes).

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az postgres server-arc show

Pré-visualizar

O grupo de comandos 'postgres server-arc' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Mostrar os detalhes de um servidor PostgreSQL habilitado para Azure Arc.

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

Exemplos

Mostrar os detalhes de um servidor PostgreSQL habilitado para Azure Arc.

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

Parâmetros Obrigatórios

--name -n

Nome do servidor PostgreSQL habilitado para Azure Arc.

Parâmetros Opcionais

--k8s-namespace -k

O namespace Kubernetes onde o servidor PostgreSQL habilitado para Azure Arc é implantado. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

--path

Um caminho onde a especificação completa para o servidor PostgreSQL habilitado para Azure Arc deve ser gravada. Se omitida, a especificação será gravada na saída padrão.

--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az postgres server-arc update

Pré-visualizar

O grupo de comandos 'postgres server-arc' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Atualize a configuração de um 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]

Exemplos

Atualize a configuração de um servidor PostgreSQL habilitado para Azure Arc.

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

Habilite extensões para um servidor PostgreSQL habilitado para Azure Arc existente.

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

Remova extensões de um servidor PostgreSQL habilitado para Azure Arc.

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

Parâmetros Obrigatórios

--name -n

Nome do servidor PostgreSQL habilitado para Azure Arc que está sendo atualizado. O nome sob o qual sua instância é implantada não pode ser alterado.

Parâmetros Opcionais

--cert-private-key-file

Caminho para o arquivo que contém uma chave privada de certificado formatada PEM a ser usada para conexões SSL do cliente.

--cert-public-key-file

Caminho para o arquivo que contém uma chave pública de certificado formatada PEM a ser usada para conexões SSL de cliente.

--cores-limit

O número máximo de núcleos de CPU para o servidor PostgreSQL habilitado para Azure Arc que pode ser usado por nós. Para remover o cores_limit, especifique seu valor como cadeia de caracteres vazia.

--cores-request

O número mínimo de núcleos de CPU que devem estar disponíveis por nó para agendar o serviço. Para remover o cores_request, especifique seu valor como cadeia de caracteres vazia.

--dev

Se isso for especificado, ele será considerado uma instância de desenvolvimento e não será cobrado.

--extensions

Lista separada por vírgulas das extensões a serem habilitadas. Para adicionar ou remover uma nova extensão, atualize a lista existente de extensões. Uma vez ativada, a extensão pode ser instalada através do comando 'CREATE EXTENSION'.

--k8s-namespace -k

O namespace Kubernetes onde o servidor PostgreSQL habilitado para Azure Arc é implantado. Se nenhum namespace for especificado, o namespace definido no kubeconfig será usado.

--keytab-secret

O nome do segredo do Kubernetes que contém o arquivo keytab para este servidor PostgreSQL habilitado para Azure Arc.

--log-level

Define a configuração de log_min_messages para o mecanismo PostgreSQL. Os valores válidos são: DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC.

--memory-limit

O limite de memória para o Azure Arc habilitou o servidor PostgreSQL como um número seguido por Ki (kilobytes), Mi (megabytes) ou Gi (gigabytes). Para remover o memory_limit, especifique seu valor como cadeia de caracteres vazia.

--memory-request

A solicitação de memória para o Azure Arc habilitou o servidor PostgreSQL como um número seguido por Ki (kilobytes), Mi (megabytes) ou Gi (gigabytes). Para remover o memory_request, especifique seu valor como cadeia de caracteres vazia.

--no-external-endpoint

Se especificado, nenhum serviço externo será criado. Caso contrário, um serviço externo será criado usando o tipo fornecido com o argumento --service-type ou o mesmo tipo de serviço que o controlador de dados.

--no-wait

Não espere que a implantação esteja pronta para retornar.

valor predefinido: False
--path

O caminho para o arquivo json de origem para o servidor PostgreSQL habilitado para Azure Arc. Isto é opcional.

--port

O número da porta na qual o serviço principal é exposto aos usuários finais.

--retention-days

Período de retenção de backup, especificado em dias. Os valores permitidos são de 0 a 35. O padrão é 7. Definir o período de retenção como 0 desativará os backups automáticos para o Azure Arc habilitado para PostgreSql.

--service-annotations

Lista de anotações separadas por vírgulas a aplicar a todos os serviços externos.

--service-cert-secret

Nome do segredo do Kubernetes a ser gerado que hospeda o certificado SSL.

--service-labels

Lista de etiquetas separadas por vírgulas a aplicar a todos os serviços externos.

--service-type

O tipo para o serviço principal.

--use-k8s

Use APIs locais do Kubernetes para executar essa ação.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.