az postgres server-arc

Versão Prévia

Note

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

Esse grupo de comandos está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerencie servidores PostgreSQL habilitados para Azure Arc.

Comandos

Nome	Description	Tipo	Status
az postgres server-arc create	Crie um servidor PostgreSQL habilitado para Azure Arc.	Extension	Preview
az postgres server-arc delete	Exclua um servidor PostgreSQL habilitado para Azure Arc.	Extension	Preview
az postgres server-arc endpoint	Gerencie pontos de extremidade do servidor PostgreSQL habilitados para Azure Arc.	Extension	Preview
az postgres server-arc endpoint list	Liste os pontos de extremidade do servidor PostgreSQL habilitados para Azure Arc.	Extension	Preview
az postgres server-arc list	Liste o servidor PostgreSQL habilitado para Azure Arc.	Extension	Preview
az postgres server-arc restore	Restaure um servidor PostgreSQL habilitado para Azure Arc do backup de outro servidor.	Extension	Preview
az postgres server-arc show	Mostre os detalhes de um servidor PostgreSQL habilitado para Azure Arc.	Extension	Preview
az postgres server-arc update	Atualize a configuração de um servidor PostgreSQL habilitado para Azure Arc.	Extension	Preview

az postgres server-arc create

Versão Prévia

O grupo de comandos 'postgres server-arc' está em versão prévia 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--ad-account-name

O nome da conta do Active Directory para este servidor PostgreSQL habilitado para 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 implantar com suporte do AD.

--admin-login-secret

Nome do segredo do Kubernetes para gerar esses hosts ou hospedará a credencial da conta de logon do administrador do usuário.

--cert-private-key-file

Caminho para o arquivo que contém uma chave privada de certificado formatado 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 formatado PEM a ser usada para conexões SSL do 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 conectar a esse servidor PostgreSQL habilitado para Azure Arc (por exemplo, pginstancename.contoso.com).

--extensions

Lista semiatada de vírgulas de extensões a serem habilitadas. Depois de habilitada, a extensão pode ser instalada por meio do comando 'CREATE EXTENSION'.

--k8s-namespace -k

O namespace do Kubernetes em que o servidor PostgreSQL habilitado para Azure Arc é 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 de 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 servidor PostgreSQL habilitado para Azure Arc como um número seguido por Ki (quilobytes), Mi (megabytes) ou Gi (gigabytes).

--memory-request

A solicitação de memória do servidor PostgreSQL habilitado para Azure Arc 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 aguarde até que a implantação esteja pronta antes de retornar.

Propriedade	Valor
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 no qual o serviço primário é 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 do 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 para gerar 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 do serviço primário.

--storage-class-backups

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

--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 volumes persistentes de logs.

--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 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 logs como um número positivo seguido por Ki (quilobytes), Mi (megabytes) ou Gi (gigabytes).

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az postgres server-arc delete

Versão Prévia

O grupo de comandos 'postgres server-arc' está em versão prévia 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--force -f

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

Propriedade	Valor
Valor padrão:	False

--k8s-namespace -k

O namespace do Kubernetes em que o servidor PostgreSQL habilitado para Azure Arc é 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az postgres server-arc list

Versão Prévia

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--k8s-namespace -k

O namespace do Kubernetes em que os servidores PostgreSQL habilitados para 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az postgres server-arc restore

Versão Prévia

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

Restaure um servidor PostgreSQL habilitado para Azure Arc 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 Azure Arc. Se nenhum namespace for especificado, será usado aquele definido no kubeconfig.

--name -n

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

--source-server

O nome do servidor PostgreSQL habilitado para Azure Arc do qual restaurar.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

Propriedade	Valor
Valor padrão:	False

--no-wait

Não aguarde até que a implantação esteja pronta antes de retornar.

Propriedade	Valor
Valor padrão:	False

--storage-class-backups

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

--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 volumes persistentes de logs.

--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 estar no seguinte formato: 'YYYY-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 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 logs como um número positivo seguido por Ki (quilobytes), Mi (megabytes) ou Gi (gigabytes).

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az postgres server-arc show

Versão Prévia

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

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

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

Exemplos

Mostre 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--k8s-namespace -k

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

--path

Um caminho em que a especificação completa do 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az postgres server-arc update

Versão Prévia

O grupo de comandos 'postgres server-arc' está em versão prévia 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 no qual sua instância é implantada não pode ser alterado.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--cert-private-key-file

Caminho para o arquivo que contém uma chave privada de certificado formatado 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 formatado PEM a ser usada para conexões SSL do 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 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 semiatada de vírgulas de extensões a serem habilitadas. Para adicionar ou remover uma nova extensão, atualize a lista existente de extensões. Depois de habilitada, a extensão pode ser instalada por meio do comando 'CREATE EXTENSION'.

--k8s-namespace -k

O namespace do Kubernetes em que o servidor PostgreSQL habilitado para Azure Arc é 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 de 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 servidor PostgreSQL habilitado para Azure Arc como um número seguido por Ki (quilobytes), 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 servidor PostgreSQL habilitado para Azure Arc como um número seguido por Ki (quilobytes), Mi (megabytes) ou Gi (gigabytes). Para remover o memory_request, especifique seu valor como cadeia de caracteres vazia.

--no-external-endpoint

--no-wait

Não aguarde até que a implantação esteja pronta antes de retornar.

Propriedade	Valor
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 no qual o serviço primário é exposto aos usuários finais.

--retention-days

--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 para gerar 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 do serviço primário.

--use-k8s

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

Parâmetros Globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

Comentários

Esta página foi útil?

Compartilhar via

az postgres server-arc

Comandos

az postgres server-arc create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az postgres server-arc delete

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az postgres server-arc list

Exemplos

Parâmetros Opcionais

az postgres server-arc restore

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az postgres server-arc show

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az postgres server-arc update

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Comentários