az postgres server-arc

Observação

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 suporte: https://aka.ms/CLI_refstatus

Gerenciar servidores PostgreSQL habilitados para Azure Arc.

Comandos

Nome Description Tipo Status
az postgres server-arc create

Crie um servidor PostgreSQL habilitado para Azure Arc.

Extensão Versão Prévia
az postgres server-arc delete

Exclua um servidor PostgreSQL habilitado para Azure Arc.

Extensão Versão Prévia
az postgres server-arc endpoint

Gerenciar pontos de extremidade de servidor PostgreSQL habilitados para Azure Arc.

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

Listar pontos de extremidade do servidor PostgreSQL habilitados para o Azure Arc.

Extensão Versão Prévia
az postgres server-arc list

Listar o servidor PostgreSQL habilitado para o Azure Arc.

Extensão Versão Prévia
az postgres server-arc restore

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

Extensão Versão Prévia
az postgres server-arc show

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

Extensão Versão Prévia
az postgres server-arc update

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

Extensão Versão Prévia

az postgres server-arc create

Versão Prévia

O grupo de comandos 'postgres server-arc' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--name -n

Nome do servidor PostgreSQL habilitado para Azure Arc.

Parâmetros Opcionais

--ad-account-name

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

--ad-connector-name

O nome do conector do Active Directory. Esse parâmetro indica uma intenção de implantação com suporte do AD.

--admin-login-secret

O nome do segredo do Kubernetes a ser gerado, que hospeda ou hospedará a credencial da conta de logon do administrador de usuários.

--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 de 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 precisam estar disponíveis por nó para agendar o serviço.

--dev

Se isso for especificado, 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 conectar a esse servidor PostgreSQL habilitado para o Azure Arc (por exemplo, pginstancename.contoso.com).

--extensions

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

--k8s-namespace -k

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

--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 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 servidor PostgreSQL habilitado do Azure Arc como um número seguido por Ki (quilobytes), Mi (megabytes) ou Gi (gigabytes).

--memory-request

A solicitação de memória do Azure Arc habilitou o servidor PostgreSQL como um número seguido por Ki (quilobytes), 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 antes de retornar.

valor padrão: False
--path

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

--port

O número da porta na qual o serviço primário está 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 PostgreSQL habilitado para Azure Arc.

--service-annotations

Lista separada por vírgulas de anotações a serem aplicadas 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 separada por vírgulas de rótulos a serem aplicadas 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 volumes de backup persistentes.

--storage-class-data

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

--storage-class-logs

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

--use-k8s

Use as 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 (quilobytes), Mi (megabytes) ou Gi (gigabytes).

--volume-size-data

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

--volume-size-logs

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az postgres server-arc delete

Versão Prévia

O grupo de comandos 'postgres server-arc' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--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 padrão: False
--k8s-namespace -k

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

--use-k8s

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az postgres server-arc list

Versão Prévia

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

Listar o servidor PostgreSQL habilitado para o Azure Arc.

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

Exemplos

Listar o servidor PostgreSQL habilitado para o Azure Arc.

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

Parâmetros Opcionais

--k8s-namespace -k

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

--use-k8s

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az postgres server-arc restore

Versão Prévia

O grupo de comandos 'postgres server-arc' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--k8s-namespace -k

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

--name -n

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

--source-server

O nome do Azure Arc habilitou o servidor PostgreSQL para restauração.

Parâmetros Opcionais

--dry-run

Se definido, valida os recursos de origem e destino e a hora, 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 padrão: False
--no-wait

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

valor padrão: False
--storage-class-backups

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

--storage-class-data

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

--storage-class-logs

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

--time -t

O point-in-time do servidor de origem que será restaurado para criar o novo servidor PostgreSQL habilitado para o Azure Arc. Deve ser maior ou igual ao valor de data/hora de restauração mais antiga do banco de dados de origem. O tempo deve estar no seguinte formato: 'AAAA-MM-DDTHH:MM:SSZ'. Se nenhum tempo for fornecido, o backup mais recente será restaurado.

--use-k8s

Use as 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 (quilobytes), Mi (megabytes) ou Gi (gigabytes).

--volume-size-data

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

--volume-size-logs

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az postgres server-arc show

Versão Prévia

O grupo de comandos 'postgres server-arc' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--name -n

Nome do servidor PostgreSQL habilitado para Azure Arc.

Parâmetros Opcionais

--k8s-namespace -k

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

--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 as APIs locais do Kubernetes para executar essa ação.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az postgres server-arc update

Versão Prévia

O grupo de comandos 'postgres server-arc' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--name -n

Nome do servidor PostgreSQL habilitado para Azure Arc que está sendo atualizado. O nome sob o qual sua instância está 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 de 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ó. Para remover cores_limit, especifique o valor dele como uma cadeia de caracteres vazia.

--cores-request

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

--dev

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

--extensions

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

--k8s-namespace -k

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

--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 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 (quilobytes), Mi (megabytes) ou Gi (gigabytes). Para remover memory_limit, especifique o valor dele como uma 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 (quilobytes), Mi (megabytes) ou Gi (gigabytes). Para remover memory_request, especifique o valor dele como uma 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 antes de retornar.

valor padrão: False
--path

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

--port

O número da porta na qual o serviço primário está 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 PostgreSQL habilitado para Azure Arc.

--service-annotations

Lista separada por vírgulas de anotações a serem aplicadas 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 separada por vírgulas de rótulos a serem aplicadas a todos os serviços externos.

--service-type

O tipo para o serviço principal.

--use-k8s

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.