Compartir a través de

az cosmosdb postgres cluster

  • Referencia

Administración de clústeres de Azure Cosmos DB para PostgreSQL.

Comandos

Nombre Description Tipo Estado
az cosmosdb postgres cluster create

Cree un clúster con nodos.

 Principal GA
az cosmosdb postgres cluster delete

Elimine un clúster junto con nodos en él.

 Principal GA
az cosmosdb postgres cluster list

Enumere todos los clústeres de una suscripción o un grupo de recursos.

 Principal GA
az cosmosdb postgres cluster promote

Promueve el clúster de réplica de lectura a un clúster independiente de lectura y escritura.

 Principal GA
az cosmosdb postgres cluster restart

Reinicia todos los nodos del clúster.

 Principal GA
az cosmosdb postgres cluster server

Administración de servidores de clústeres de Azure Cosmos DB para PostgreSQL.

 Principal GA
az cosmosdb postgres cluster server list

Enumera los nodos de un clúster.

 Principal GA
az cosmosdb postgres cluster server show

Obtenga información sobre un nodo del clúster.

 Principal GA
az cosmosdb postgres cluster show

Obtenga información sobre un clúster, como la configuración de proceso y almacenamiento y los metadatos del ciclo de vida del clúster, como la fecha y hora de creación del clúster.

 Principal GA
az cosmosdb postgres cluster start

Inicia el proceso detenido en todos los nodos del clúster.

 Principal GA
az cosmosdb postgres cluster stop

Detiene el proceso en todos los nodos del clúster.

 Principal GA
az cosmosdb postgres cluster update

Actualice un clúster existente. El cuerpo de la solicitud puede contener una o varias propiedades de la definición del clúster.

 Principal GA
az cosmosdb postgres cluster wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Principal GA

az cosmosdb postgres cluster create

Editar

Cree un clúster con nodos.

Use la siguiente referencia para determinar los valores admitidos para varios parámetros para los comandos de la CLI de clústeres y nodos de Azure Cosmos DB para PostgreSQL: https://learn.microsoft.com/rest/api/postgresqlhsc/#values.

az cosmosdb postgres cluster create --cluster-name
                                    --resource-group
                                    [--administrator-login-password]
                                    [--citus-version]
                                    [--coord-public-ip-access {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--coord-server-edition]
                                    [--coordinator-storage]
                                    [--coordinator-v-cores]
                                    [--enable-ha {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--enable-shards-on-coord {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--location]
                                    [--maintenance-window]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--node-count]
                                    [--node-enable-public-ip-access {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--node-server-edition]
                                    [--node-storage]
                                    [--node-v-cores]
                                    [--point-in-time-utc]
                                    [--postgresql-version]
                                    [--preferred-primary-zone]
                                    [--source-location]
                                    [--source-resource-id]
                                    [--tags]

Ejemplos

Creación de un clúster de un solo nodo

az cosmosdb postgres cluster create -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --enable-ha false --coordinator-v-cores 8 --coordinator-server-edition "GeneralPurpose" --coordinator-storage 131072 --enable-shards-on-coord true --node-count 0 --preferred-primary-zone "1" --administrator-login-password "password"

Creación de un clúster como restauración a un momento dado

az cosmosdb postgres cluster create -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --point-in-time-utc "2017-12-14T00:00:37.467Z" --source-location "eastus" --source-resource-id "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testGroup/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/source-cluster"

Creación de un clúster como réplica de lectura

az cosmosdb postgres cluster create -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --source-location "eastus" --source-resource-id "/subscriptions/ffffffff-ffff-ffff-ffff-ffffffffffff/resourceGroups/testGroup/providers/Microsoft.DBforPostgreSQL/serverGroupsv2/source-cluster"

Creación de un nuevo clúster de varios nodos

az cosmosdb postgres cluster create -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --enable-ha false --coordinator-v-cores 8 --coordinator-server-edition "GeneralPurpose" --coordinator-storage 131072 --enable-shards-on-coord false --node-count 3 --node-server-edition "MemoryOptimized" --node-v-cores 8 --node-storage 131072 --postgresql-version "15" --preferred-primary-zone "1" --administrator-login-password "password"

Creación de un clúster de 1 núcleo virtual ampliable de nodo único

az cosmosdb postgres cluster create -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --enable-ha false --coordinator-v-cores 1 --coordinator-server-edition "BurstableMemoryOptimized" --coord-public-ip-access true --coordinator-storage 131072 --enable-shards-on-coord true --node-count 0 --preferred-primary-zone "1" --administrator-login-password "password"

Creación de un nuevo clúster de 2 núcleos virtuales ampliables de nodo único

az cosmosdb postgres cluster create -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --enable-ha false --coordinator-v-cores 2 --coordinator-server-edition "BurstableGeneralPurpose" --coord-public-ip-access true --coordinator-storage 131072 --enable-shards-on-coord true --node-count 0 --preferred-primary-zone "1" --administrator-login-password "password"

Parámetros requeridos

--cluster-name --name -n

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--administrator-login-password --login-password

Contraseña del inicio de sesión del administrador. Necesario para la creación. Si el valor está en blanco, se le pregunta desde tty.

--citus-version

La versión de la extensión Citus en todos los servidores de clúster.

--coord-public-ip-access --coordinator-enable-public-ip-access

Si el acceso público está habilitado en el coordinador.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--coord-server-edition --coordinator-server-edition

Edición de un servidor de coordinación (valor predeterminado: GeneralPurpose). Necesario para la creación.

--coordinator-storage --coordinator-storage-quota-in-mb

Almacenamiento de un servidor en MB. Necesario para la creación. Consulte https://learn.microsoft.com/rest/api/postgresqlhsc/#values para obtener más información.

--coordinator-v-cores

Recuento de núcleos virtuales de un servidor (máximo: 96). Necesario para la creación. Consulte https://learn.microsoft.com/rest/api/postgresqlhsc/#values para obtener más información.

--enable-ha

Si la alta disponibilidad (HA) está habilitada o no para el clúster.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--enable-shards-on-coord --enable-shards-on-coordinator

Si las particiones en el coordinador están habilitadas o no para el clúster.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--location -l

Ubicación geográfica donde reside el recurso Cuando no se especifica, se usará la ubicación del grupo de recursos.

--maintenance-window

Ventana de mantenimiento de un clúster. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--node-count

Recuento de nodos de trabajo del clúster. Cuando el número de nodos es 0, representa una configuración de nodo único con la capacidad de crear tablas distribuidas en ese nodo. 2 o más nodos de trabajo representan la configuración de varios nodos. El valor de recuento de nodos no puede ser 1. Necesario para la creación.

--node-enable-public-ip-access --node-public-ip-access

Si el acceso público está habilitado en los nodos de trabajo.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--node-server-edition

Edición de un servidor de nodo (valor predeterminado: MemoryOptimized).

--node-storage --node-storage-quota-in-mb

Almacenamiento en MB en cada nodo de trabajo. Consulte https://learn.microsoft.com/rest/api/postgresqlhsc/#values para obtener más información.

--node-v-cores

Proceso en núcleos virtuales en cada nodo de trabajo (máximo: 104). Consulte https://learn.microsoft.com/rest/api/postgresqlhsc/#values para obtener más información.

--point-in-time-utc

Fecha y hora en formato UTC (ISO8601) para la restauración del clúster.

--postgresql-version

La versión principal de PostgreSQL en todos los servidores de clúster.

--preferred-primary-zone

Zona de disponibilidad principal preferida (AZ) para todos los servidores de clúster.

--source-location

Región de Azure del clúster de origen para clústeres de réplica de lectura.

--source-resource-id

Identificador de recurso del clúster de origen para clústeres de réplica de lectura.

--tags

Etiquetas del recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb postgres cluster delete

Editar

Elimine un clúster junto con nodos en él.

az cosmosdb postgres cluster delete [--cluster-name]
                                    [--ids]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--resource-group]
                                    [--subscription]
                                    [--yes]

Ejemplos

Eliminación del clúster

az cosmosdb postgres cluster delete -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"

Parámetros opcionales

--cluster-name --name -n

Nombre del clúster.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb postgres cluster list

Editar

Enumere todos los clústeres de una suscripción o un grupo de recursos.

az cosmosdb postgres cluster list [--resource-group]

Ejemplos

Lista de clústeres de un grupo de recursos

az cosmosdb postgres cluster list -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"

Enumeración de clústeres en una suscripción

az cosmosdb postgres cluster list --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"

Parámetros opcionales

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb postgres cluster promote

Editar

Promueve el clúster de réplica de lectura a un clúster independiente de lectura y escritura.

az cosmosdb postgres cluster promote [--cluster-name]
                                     [--ids]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--resource-group]
                                     [--subscription]

Ejemplos

Promoción del clúster de réplica de lectura a un clúster independiente de lectura y escritura

az cosmosdb postgres cluster promote -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"

Parámetros opcionales

--cluster-name

Nombre del clúster.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb postgres cluster restart

Editar

Reinicia todos los nodos del clúster.

az cosmosdb postgres cluster restart [--cluster-name]
                                     [--ids]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--resource-group]
                                     [--subscription]

Ejemplos

Reinicio de todos los servidores del clúster

az cosmosdb postgres cluster restart -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"

Parámetros opcionales

--cluster-name

Nombre del clúster.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb postgres cluster show

Editar

Obtenga información sobre un clúster, como la configuración de proceso y almacenamiento y los metadatos del ciclo de vida del clúster, como la fecha y hora de creación del clúster.

az cosmosdb postgres cluster show [--cluster-name]
                                  [--ids]
                                  [--resource-group]
                                  [--subscription]

Ejemplos

Mostrar detalles del clúster

az cosmosdb postgres cluster show -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"

Parámetros opcionales

--cluster-name --name -n

Nombre del clúster.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb postgres cluster start

Editar

Inicia el proceso detenido en todos los nodos del clúster.

az cosmosdb postgres cluster start [--cluster-name]
                                   [--ids]
                                   [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--resource-group]
                                   [--subscription]

Ejemplos

Iniciar todos los servidores del clúster

az cosmosdb postgres cluster start -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"

Parámetros opcionales

--cluster-name

Nombre del clúster.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb postgres cluster stop

Editar

Detiene el proceso en todos los nodos del clúster.

az cosmosdb postgres cluster stop [--cluster-name]
                                  [--ids]
                                  [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                  [--resource-group]
                                  [--subscription]

Ejemplos

Detener todos los servidores del clúster

az cosmosdb postgres cluster stop -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff"

Parámetros opcionales

--cluster-name

Nombre del clúster.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb postgres cluster update

Editar

Actualice un clúster existente. El cuerpo de la solicitud puede contener una o varias propiedades de la definición del clúster.

Use la siguiente referencia para determinar los valores admitidos para varios parámetros para los comandos de la CLI de clústeres y nodos de Azure Cosmos DB para PostgreSQL: https://learn.microsoft.com/rest/api/postgresqlhsc/#values.

az cosmosdb postgres cluster update [--administrator-login-password]
                                    [--citus-version]
                                    [--cluster-name]
                                    [--coord-public-ip-access {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--coord-server-edition]
                                    [--coordinator-storage]
                                    [--coordinator-v-cores]
                                    [--enable-ha {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--enable-shards-on-coord {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--ids]
                                    [--maintenance-window]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--node-count]
                                    [--node-server-edition]
                                    [--node-storage]
                                    [--node-v-cores]
                                    [--postgresql-version]
                                    [--preferred-primary-zone]
                                    [--resource-group]
                                    [--subscription]
                                    [--tags]

Ejemplos

Escalado o reducción vertical del proceso del nodo de trabajo

az cosmosdb postgres cluster update -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --node-v-cores 16

Escalado horizontal: adición de nuevos nodos de trabajo

az cosmosdb postgres cluster update -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --node-count 2

Escalado vertical del almacenamiento de nodos de trabajo

az cosmosdb postgres cluster update -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --node-storage 2097152

Actualización de varias opciones de configuración del clúster

az cosmosdb postgres cluster update -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --node-v-cores 16 --node-count 4 coordinator-v-cores 16 --administrator-login-password "newPassword"

Actualizar o definir la ventana de mantenimiento

az cosmosdb postgres cluster update -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --maintenance-window day-of-week=1 start-hour=2 --start-minute=0 custom-window="Enabled"

Actualización de la versión principal de PostgreSQL

az cosmosdb postgres cluster update -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --postgresql-version "15"

Escalado vertical del almacenamiento del coordinador

az cosmosdb postgres cluster update -n "test-cluster" -g "testGroup" --subscription "ffffffff-ffff-ffff-ffff-ffffffffffff" --coordinator-storage 2097152

Parámetros opcionales

--administrator-login-password --login-password

Contraseña del inicio de sesión del administrador. Necesario para la creación. Si el valor está en blanco, se le pregunta desde tty.

--citus-version

La versión de la extensión Citus en todos los servidores de clúster.

--cluster-name --name -n

Nombre del clúster.

--coord-public-ip-access --coordinator-enable-public-ip-access

Si el acceso público está habilitado en el coordinador.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--coord-server-edition --coordinator-server-edition

Edición de un servidor de coordinación (valor predeterminado: GeneralPurpose). Necesario para la creación.

--coordinator-storage --coordinator-storage-quota-in-mb

Almacenamiento de un servidor en MB. Necesario para la creación. Consulte https://learn.microsoft.com/rest/api/postgresqlhsc/#values para obtener más información.

--coordinator-v-cores

Recuento de núcleos virtuales de un servidor (máximo: 96). Necesario para la creación. Consulte https://learn.microsoft.com/rest/api/postgresqlhsc/#values para obtener más información.

--enable-ha

Si la alta disponibilidad (HA) está habilitada o no para el clúster.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--enable-shards-on-coord --enable-shards-on-coordinator

Si las particiones en el coordinador están habilitadas o no para el clúster.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--maintenance-window

Ventana de mantenimiento de un clúster. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--node-count

Recuento de nodos de trabajo del clúster. Cuando el número de nodos es 0, representa una configuración de nodo único con la capacidad de crear tablas distribuidas en ese nodo. 2 o más nodos de trabajo representan la configuración de varios nodos. El valor de recuento de nodos no puede ser 1.

--node-server-edition

Edición de un servidor de nodo (valor predeterminado: MemoryOptimized).

--node-storage --node-storage-quota-in-mb

Almacenamiento en MB en cada nodo de trabajo. Consulte https://learn.microsoft.com/rest/api/postgresqlhsc/#values para obtener más información.

--node-v-cores

Proceso en núcleos virtuales en cada nodo de trabajo (máximo: 104). Consulte https://learn.microsoft.com/rest/api/postgresqlhsc/#values para obtener más información.

--postgresql-version

La versión principal de PostgreSQL en todos los servidores de clúster.

--preferred-primary-zone

Zona de disponibilidad principal preferida (AZ) para todos los servidores de clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--tags

Metadatos específicos de la aplicación en forma de pares clave-valor. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az cosmosdb postgres cluster wait

Editar

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

az cosmosdb postgres cluster wait [--cluster-name]
                                  [--created]
                                  [--custom]
                                  [--deleted]
                                  [--exists]
                                  [--ids]
                                  [--interval]
                                  [--resource-group]
                                  [--subscription]
                                  [--timeout]
                                  [--updated]

Parámetros opcionales

--cluster-name --name -n

Nombre del clúster.

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.