Compartir a través de


az cosmosdb postgres cluster

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.

Core GA
az cosmosdb postgres cluster delete

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

Core GA
az cosmosdb postgres cluster list

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

Core GA
az cosmosdb postgres cluster promote

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

Core GA
az cosmosdb postgres cluster restart

Reinicia todos los nodos del clúster.

Core GA
az cosmosdb postgres cluster server

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

Core GA
az cosmosdb postgres cluster server list

Enumera los nodos de un clúster.

Core GA
az cosmosdb postgres cluster server show

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

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

Core GA
az cosmosdb postgres cluster start

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

Core GA
az cosmosdb postgres cluster stop

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

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

Core GA
az cosmosdb postgres cluster wait

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

Core GA

az cosmosdb postgres cluster create

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 --name
                                    --resource-group
                                    [--administrator-login-password --login-password]
                                    [--citus-version]
                                    [--coord-public-ip-access --coordinator-enable-public-ip-access {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--coord-server-edition --coordinator-server-edition]
                                    [--coordinator-storage --coordinator-storage-quota-in-mb]
                                    [--coordinator-v-cores]
                                    [--enable-ha {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--enable-shards-on-coord --enable-shards-on-coordinator {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 --node-public-ip-access {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--node-server-edition]
                                    [--node-storage --node-storage-quota-in-mb]
                                    [--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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--citus-version

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--coord-public-ip-access --coordinator-enable-public-ip-access

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
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.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--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.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--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.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--enable-ha

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
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.

Propiedad Valor
Grupo de parámetros: Properties Arguments
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.

Propiedad Valor
Grupo de parámetros: Parameters Arguments
--maintenance-window

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--no-wait

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

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--node-enable-public-ip-access --node-public-ip-access

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
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).

Propiedad Valor
Grupo de parámetros: Properties Arguments
--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.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--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.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--point-in-time-utc

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--postgresql-version

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--preferred-primary-zone

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--source-location

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--source-resource-id

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--tags

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

Propiedad Valor
Grupo de parámetros: Parameters Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb postgres cluster delete

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

az cosmosdb postgres cluster delete [--cluster-name --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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--cluster-name --name -n

Nombre del clúster.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). 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".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--no-wait

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

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb postgres cluster list

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

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

Ejemplos

Enumeración de clústeres en 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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb postgres cluster promote

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--cluster-name

Nombre del clúster.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). 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".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--no-wait

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

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb postgres cluster restart

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--cluster-name

Nombre del clúster.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). 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".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--no-wait

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

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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.

az cosmosdb postgres cluster show [--cluster-name --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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--cluster-name --name -n

Nombre del clúster.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). 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".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--resource-group -g

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb postgres cluster start

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--cluster-name

Nombre del clúster.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). 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".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--no-wait

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

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb postgres cluster stop

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--cluster-name

Nombre del clúster.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--ids

Uno o varios identificadores de recursos (delimitados por espacio). 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".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--no-wait

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

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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.

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 --login-password]
                                    [--citus-version]
                                    [--cluster-name --name]
                                    [--coord-public-ip-access --coordinator-enable-public-ip-access {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--coord-server-edition --coordinator-server-edition]
                                    [--coordinator-storage --coordinator-storage-quota-in-mb]
                                    [--coordinator-v-cores]
                                    [--enable-ha {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--enable-shards-on-coord --enable-shards-on-coordinator {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-storage-quota-in-mb]
                                    [--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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--citus-version

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--cluster-name --name -n

Nombre del clúster.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--coord-public-ip-access --coordinator-enable-public-ip-access

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
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.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--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.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--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.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--enable-ha

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
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.

Propiedad Valor
Grupo de parámetros: Properties Arguments
Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o varios identificadores de recursos (delimitados por espacio). 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".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--maintenance-window

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--no-wait

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

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--node-server-edition

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--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.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--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.

Propiedad Valor
Grupo de parámetros: Properties Arguments
--postgresql-version

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--preferred-primary-zone

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

Propiedad Valor
Grupo de parámetros: Properties Arguments
--resource-group -g

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--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.

Propiedad Valor
Grupo de parámetros: Parameters Arguments
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az cosmosdb postgres cluster wait

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

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--cluster-name --name -n

Nombre del clúster.

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--created

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--custom

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
--deleted

Espere hasta que se elimine.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacio). 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".

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--interval

Intervalo de sondeo en segundos.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 30
--resource-group -g

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--subscription

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

Propiedad Valor
Grupo de parámetros: Resource Id Arguments
--timeout

Espera máxima en segundos.

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: 3600
--updated

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

Propiedad Valor
Grupo de parámetros: Wait Condition Arguments
Valor predeterminado: False
Parámetros globales
--debug

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

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

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

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False