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
Nombre del clúster.
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.
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 |
La versión de la extensión Citus en todos los servidores de clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Properties Arguments |
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 |
Edición de un servidor de coordinación (valor predeterminado: GeneralPurpose). Necesario para la creación.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Properties Arguments |
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 |
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 |
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 |
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 |
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 |
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 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 |
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 |
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 |
Edición de un servidor de nodo (valor predeterminado: MemoryOptimized).
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Properties Arguments |
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 |
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 |
Fecha y hora en formato UTC (ISO8601) para la restauración del clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Properties Arguments |
La versión principal de PostgreSQL en todos los servidores de clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Properties Arguments |
Zona de disponibilidad principal preferida (AZ) para todos los servidores de clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Properties Arguments |
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 |
Identificador de recurso del clúster de origen para clústeres de réplica de lectura.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Properties Arguments |
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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.
Nombre del clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
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 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 |
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 |
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 |
No solicita confirmación.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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.
Nombre del clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
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 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 |
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 |
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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.
Nombre del clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
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 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 |
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 |
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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.
Nombre del clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
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 |
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 |
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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.
Nombre del clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
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 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 |
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 |
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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.
Nombre del clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
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 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 |
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 |
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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.
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 |
La versión de la extensión Citus en todos los servidores de clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Properties Arguments |
Nombre del clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
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 |
Edición de un servidor de coordinación (valor predeterminado: GeneralPurpose). Necesario para la creación.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Properties Arguments |
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 |
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 |
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 |
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 |
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 |
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 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 |
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 |
Edición de un servidor de nodo (valor predeterminado: MemoryOptimized).
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Properties Arguments |
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 |
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 |
La versión principal de PostgreSQL en todos los servidores de clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Properties Arguments |
Zona de disponibilidad principal preferida (AZ) para todos los servidores de clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Properties Arguments |
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 |
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 |
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
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.
Nombre del clúster.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Resource Id Arguments |
Espere hasta que se cree con "provisioningState" en "Succeeded".
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | False |
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 |
Espere hasta que se elimine.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | False |
Espere hasta que exista el recurso.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | False |
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 |
Intervalo de sondeo en segundos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | 30 |
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 |
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 |
Espera máxima en segundos.
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | 3600 |
Espere hasta que se actualice con provisioningState en "Succeeded".
| Propiedad | Valor |
|---|---|
| Grupo de parámetros: | Wait Condition Arguments |
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |