Поделиться через

az postgres server-arc

  • Предварительный просмотр

Note

Эта ссылка является частью расширения arcdata для Azure CLI (версия 2.3.1 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az postgres server-arc . Подробнее о расширениях.

Эта группа команд находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Управление серверами PostgreSQL с поддержкой Azure Arc.

Команды

Имя Описание Тип Состояние
az postgres server-arc create

Создайте сервер PostgreSQL с поддержкой Azure Arc.

 Extension Preview
az postgres server-arc delete

Удалите сервер PostgreSQL с поддержкой Azure Arc.

 Extension Preview
az postgres server-arc endpoint

Управление конечными точками сервера PostgreSQL с поддержкой Azure Arc.

 Extension Preview
az postgres server-arc endpoint list

Вывод списка конечных точек сервера PostgreSQL с поддержкой Azure Arc.

 Extension Preview
az postgres server-arc list

Вывод списка сервера PostgreSQL с поддержкой Azure Arc.

 Extension Preview
az postgres server-arc restore

Восстановите сервер PostgreSQL с поддержкой Azure Arc из резервного копирования с другого сервера.

 Extension Preview
az postgres server-arc show

Отображение сведений о сервере PostgreSQL с поддержкой Azure Arc.

 Extension Preview
az postgres server-arc update

Обновите конфигурацию сервера PostgreSQL с поддержкой Azure Arc.

 Extension Preview

az postgres server-arc create

Предварительный просмотр

Группа команд Postgres server-arc находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Создайте сервер PostgreSQL с поддержкой Azure Arc.

Чтобы задать пароль сервера, задайте переменную среды 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]

Примеры

Создайте сервер PostgreSQL с поддержкой Azure Arc.

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

Обязательные параметры

--name -n

Имя сервера PostgreSQL с поддержкой Azure Arc.

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ad-account-name

Имя учетной записи Active Directory для этого сервера PostgreSQL с поддержкой Azure Arc. Эта учетная запись должна быть создана до развертывания этого экземпляра.

--ad-connector-name

Имя соединителя Active Directory. Этот параметр указывает намерение развернуть с поддержкой AD.

--admin-login-secret

Имя секрета Kubernetes для создания узлов или размещения учетных данных учетной записи входа администратора пользователя.

--cert-private-key-file

Путь к файлу, содержаму закрытый ключ сертификата в формате PEM, который будет использоваться для ssl-подключений клиента.

--cert-public-key-file

Путь к файлу с открытым ключом с форматированным сертификатом PEM, который будет использоваться для SSL-подключений клиента.

--cores-limit

Максимальное количество ядер ЦП, которые можно использовать для сервера PostgreSQL с поддержкой Azure Arc.

--cores-request

Минимальное количество ядер ЦП, которые должны быть доступны для каждого узла для планирования службы.

--dev

Если это указано, то он считается экземпляром разработки и не будет выставлен счет за него.

--dns-name

DNS-имя службы, предоставляемое конечным пользователям для подключения к этому серверу PostgreSQL с поддержкой Azure Arc (например, pginstancename.contoso.com).

--extensions

Разделенный запятыми список расширений, которые необходимо включить. После включения расширение можно установить с помощью команды CREATE EXTENSION.

--k8s-namespace -k

Пространство имен Kubernetes, в котором развернут сервер PostgreSQL с поддержкой Azure Arc. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

--keytab-secret

Имя секрета Kubernetes, содержащего файл keytab для этого сервера PostgreSQL с поддержкой Azure Arc.

--log-level

Задает параметр log_min_messages для подсистемы PostgreSQL. Допустимые значения: DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC.

--memory-limit

Ограничение памяти сервера PostgreSQL с поддержкой Azure Arc в виде числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (gigabytes).

--memory-request

Запрос памяти сервера PostgreSQL с поддержкой Azure Arc в виде числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (gigabytes).

--no-external-endpoint

Если задано, внешняя служба не будет создана. В противном случае внешняя служба будет создана с помощью типа, заданного с аргументом типа --service или тем же типом службы, что и контроллер данных.

--no-wait

Не подождите, пока развертывание будет готово, прежде чем вернуться.

Свойство Значение
Default value: False
--path

Путь к исходному json-файлу для сервера PostgreSQL с поддержкой Azure Arc. Это необязательно.

--port

Номер порта, на котором предоставляется основная служба конечным пользователям.

--retention-days

Период хранения резервных копий, указанный в днях. Допустимые значения — от 0 до 35. Значение по умолчанию — 7. Установка периода хранения на 0 отключит автоматические резервные копии для PostgreSql с поддержкой Azure Arc.

--service-annotations

Разделенный запятыми список заметок для применения ко всем внешним службам.

--service-cert-secret

Имя секрета Kubernetes для создания ssl-сертификата.

--service-labels

Разделенный запятыми список меток для применения ко всем внешним службам.

--service-type

Тип основной службы.

--storage-class-backups

Класс хранилища, используемый для постоянных томов резервного копирования.

--storage-class-data

Класс хранилища, используемый для постоянных томов данных.

--storage-class-logs

Класс хранилища, используемый для постоянных томов журналов.

--use-k8s

Для выполнения этого действия используйте локальные API Kubernetes.

--volume-size-backups

Размер тома хранилища, используемого для резервного копирования, в качестве положительного числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (гигабайты).

--volume-size-data

Размер тома хранилища, который будет использоваться для данных в качестве положительного числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (гигабайты).

--volume-size-logs

Размер тома хранилища, который будет использоваться для журналов в качестве положительного числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (gigabytes).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az postgres server-arc delete

Предварительный просмотр

Группа команд Postgres server-arc находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Удалите сервер PostgreSQL с поддержкой Azure Arc.

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

Примеры

Удалите сервер PostgreSQL с поддержкой Azure Arc.

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

Обязательные параметры

--name -n

Имя сервера PostgreSQL с поддержкой Azure Arc.

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--force -f

Удалите сервер PostgreSQL с поддержкой Azure Arc без подтверждения.

Свойство Значение
Default value: False
--k8s-namespace -k

Пространство имен Kubernetes, в котором развернут сервер PostgreSQL с поддержкой Azure Arc. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

--use-k8s

Для выполнения этого действия используйте локальные API Kubernetes.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az postgres server-arc list

Предварительный просмотр

Группа команд Postgres server-arc находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Вывод списка сервера PostgreSQL с поддержкой Azure Arc.

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

Примеры

Вывод списка сервера PostgreSQL с поддержкой Azure Arc.

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

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--k8s-namespace -k

Пространство имен Kubernetes, в котором развертываются серверы PostgreSQL с поддержкой Azure Arc. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

--use-k8s

Для выполнения этого действия используйте локальные API Kubernetes.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az postgres server-arc restore

Предварительный просмотр

Группа команд Postgres server-arc находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Восстановите сервер PostgreSQL с поддержкой Azure Arc из резервного копирования с другого сервера.

Чтобы задать пароль сервера, задайте переменную среды 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]

Примеры

Восстановление сервера PostgreSQL с поддержкой Azure Arc.

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

Обязательные параметры

--k8s-namespace -k

Пространство имен Kubernetes, содержащее PostgreSql с поддержкой Azure Arc. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

--name -n

Имя создаваемого сервера PostgreSQL с поддержкой Azure Arc.

--source-server

Имя сервера PostgreSQL с поддержкой Azure Arc для восстановления.

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--dry-run

Если задано, проверяет исходные и целевые ресурсы и время, не выполняя восстановление. Самые ранние и последние возможные периоды восстановления возвращаются в состоянии задачи восстановления.

Свойство Значение
Default value: False
--no-wait

Не подождите, пока развертывание будет готово, прежде чем вернуться.

Свойство Значение
Default value: False
--storage-class-backups

Класс хранилища, используемый для постоянных томов резервного копирования.

--storage-class-data

Класс хранилища, используемый для постоянных томов данных.

--storage-class-logs

Класс хранилища, используемый для постоянных томов журналов.

--time -t

Точка во времени исходного сервера, который будет восстановлен для создания нового сервера PostgreSQL с поддержкой Azure Arc. Должно быть больше или равно самому раннему значению даты и времени восстановления исходной базы данных. Время должно быть в следующем формате: "ГГГГ-ММ-ДДTHH:ММ:SSZ". Если не указано время, будет восстановлена последняя резервная копия.

--use-k8s

Для выполнения этого действия используйте локальные API Kubernetes.

--volume-size-backups

Размер тома хранилища, используемого для резервного копирования, в качестве положительного числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (гигабайты).

--volume-size-data

Размер тома хранилища, который будет использоваться для данных в качестве положительного числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (гигабайты).

--volume-size-logs

Размер тома хранилища, который будет использоваться для журналов в качестве положительного числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (gigabytes).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az postgres server-arc show

Предварительный просмотр

Группа команд Postgres server-arc находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Отображение сведений о сервере PostgreSQL с поддержкой Azure Arc.

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

Примеры

Отображение сведений о сервере PostgreSQL с поддержкой Azure Arc.

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

Обязательные параметры

--name -n

Имя сервера PostgreSQL с поддержкой Azure Arc.

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--k8s-namespace -k

Пространство имен Kubernetes, в котором развернут сервер PostgreSQL с поддержкой Azure Arc. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

--path

Путь, в котором должна быть записана полная спецификация сервера PostgreSQL с поддержкой Azure Arc. Если опущено, спецификация будет записана в стандартные выходные данные.

--use-k8s

Для выполнения этого действия используйте локальные API Kubernetes.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az postgres server-arc update

Предварительный просмотр

Группа команд Postgres server-arc находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Обновите конфигурацию сервера PostgreSQL с поддержкой 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]

Примеры

Обновите конфигурацию сервера PostgreSQL с поддержкой Azure Arc.

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

Включите расширения для существующего сервера PostgreSQL с поддержкой Azure Arc.

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

Удалите расширения с сервера PostgreSQL с поддержкой Azure Arc.

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

Обязательные параметры

--name -n

Имя обновляемого сервера PostgreSQL с поддержкой Azure Arc. Имя, в котором развертывается экземпляр, нельзя изменить.

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--cert-private-key-file

Путь к файлу, содержаму закрытый ключ сертификата в формате PEM, который будет использоваться для ssl-подключений клиента.

--cert-public-key-file

Путь к файлу с открытым ключом с форматированным сертификатом PEM, который будет использоваться для SSL-подключений клиента.

--cores-limit

Максимальное количество ядер ЦП для сервера PostgreSQL с поддержкой Azure Arc, которое можно использовать на каждом узле. Чтобы удалить cores_limit, укажите его значение как пустую строку.

--cores-request

Минимальное количество ядер ЦП, которые должны быть доступны для каждого узла для планирования службы. Чтобы удалить cores_request, укажите его значение как пустую строку.

--dev

Если это указано, то он считается экземпляром разработки и не будет выставлен счет за него.

--extensions

Разделенный запятыми список расширений, которые необходимо включить. Чтобы добавить или удалить новое расширение, обновите существующий список расширений. После включения расширение можно установить с помощью команды CREATE EXTENSION.

--k8s-namespace -k

Пространство имен Kubernetes, в котором развернут сервер PostgreSQL с поддержкой Azure Arc. Если пространство имен не указано, будет использоваться пространство имен, определенное в kubeconfig.

--keytab-secret

Имя секрета Kubernetes, содержащего файл keytab для этого сервера PostgreSQL с поддержкой Azure Arc.

--log-level

Задает параметр log_min_messages для подсистемы PostgreSQL. Допустимые значения: DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC.

--memory-limit

Ограничение памяти для сервера PostgreSQL с поддержкой Azure Arc в виде числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (gigabytes). Чтобы удалить memory_limit, укажите его значение как пустую строку.

--memory-request

Запрос памяти для сервера PostgreSQL с поддержкой Azure Arc в виде числа, за которым следует Ki (килобайты), Mi (мегабайты) или Gi (gigabytes). Чтобы удалить memory_request, укажите его значение как пустую строку.

--no-external-endpoint

Если задано, внешняя служба не будет создана. В противном случае внешняя служба будет создана с помощью типа, заданного с аргументом типа --service или тем же типом службы, что и контроллер данных.

--no-wait

Не подождите, пока развертывание будет готово, прежде чем вернуться.

Свойство Значение
Default value: False
--path

Путь к исходному json-файлу для сервера PostgreSQL с поддержкой Azure Arc. Это необязательно.

--port

Номер порта, на котором предоставляется основная служба конечным пользователям.

--retention-days

Период хранения резервных копий, указанный в днях. Допустимые значения — от 0 до 35. Значение по умолчанию — 7. Установка периода хранения на 0 отключит автоматические резервные копии для PostgreSql с поддержкой Azure Arc.

--service-annotations

Разделенный запятыми список заметок для применения ко всем внешним службам.

--service-cert-secret

Имя секрета Kubernetes для создания ssl-сертификата.

--service-labels

Разделенный запятыми список меток для применения ко всем внешним службам.

--service-type

Тип основной службы.

--use-k8s

Для выполнения этого действия используйте локальные API Kubernetes.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False