> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Crear un nuevo servicio > Crea un nuevo servicio en la organización y devuelve el estado actual del servicio junto con una contraseña para acceder a él. El servicio se inicia de forma asíncrona. ## OpenAPI ````yaml /es/products/cloud/api-reference/cloud-openapi.json post /v1/organizations/{organizationId}/services openapi: 3.0.1 info: contact: email: support@clickhouse.com name: ClickHouse Support url: >- https://clickhouse.com/docs/en/cloud/manage/openapi?referrer=openapi-299828 title: OpenAPI spec for ClickHouse Cloud version: '1.0' servers: - url: https://api.clickhouse.cloud security: - basicAuth: [] tags: - name: Organization - name: User management - name: Billing - name: Service - name: Backup - name: OpenAPI - name: Prometheus - name: ClickPipes paths: /v1/organizations/{organizationId}/services: post: tags: - Service summary: Crear un nuevo servicio description: >- Crea un nuevo servicio en la organización y devuelve el estado actual del servicio junto con una contraseña para acceder a él. El servicio se inicia de forma asíncrona. parameters: - description: ID de la organización propietaria del servicio. in: path name: organizationId required: true schema: format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ServicePostRequest' responses: '200': content: application/json: schema: properties: requestId: description: ID único asignado a cada solicitud. UUIDv4 format: uuid type: string result: $ref: '#/components/schemas/ServicePostResponse' status: description: Código de estado HTTP. example: 200 type: number type: object description: Respuesta satisfactoria '400': content: application/json: schema: properties: error: description: Descripción detallada del error. type: string status: description: Código de estado HTTP. example: 400 type: number type: object description: >- El servidor no puede o no quiere procesar la solicitud porque considera que contiene un error del cliente. components: schemas: ServicePostRequest: properties: backupId: description: >- ID de Backup opcional usado como estado inicial para el nuevo servicio. Cuando se usa, la región y el tier de la nueva instancia deben ser iguales a los valores de la instancia original. format: uuid type: string byocId: description: >- Este es el ID que se devuelve después de configurar una región para Bring Your Own Cloud (BYOC). Cuando se especifica el parámetro byocId, también son obligatorios los parámetros minReplicaMemoryGb y maxReplicaGb, con valores incluidos entre los siguientes tamaños: 48, 116, 172, 232. type: string complianceType: description: Tipo de cumplimiento normativo del servicio. enum: - hipaa - pci type: string dataWarehouseId: description: Data warehouse que contiene este servicio type: string encryptionAssumedRoleIdentifier: description: Role opcional que se usará para el cifrado de disco type: string encryptionKey: description: Clave de cifrado de disco opcional proporcionada por el cliente type: string endpoints: description: Lista de endpoints del servicio para habilitar o deshabilitar items: $ref: '#/components/schemas/ServiceEndpointChange' type: array hasTransparentDataEncryption: description: >- True si el servicio debe tener habilitado Transparent Data Encryption (TDE). TDE solo está disponible para los tiers de organización ENTERPRISE y solo se puede habilitar al crear el servicio. type: boolean idleScaling: description: >- Cuando se establece en true, el servicio puede escalar hasta cero cuando está inactivo. True de forma predeterminada. type: boolean idleTimeoutMinutes: description: >- Establezca el timeout mínimo de inactividad (en minutos). Debe ser >= 5 minutos. type: number ipAccessList: description: Lista de direcciones IP permitidas para acceder al servicio items: $ref: '#/components/schemas/IpAccessListEntry' type: array isReadonly: description: >- True si este servicio es de solo lectura. Solo puede ser de solo lectura si se proporciona un dataWarehouseId. type: boolean maxReplicaMemoryGb: description: >- Memoria total máxima de cada réplica durante el autoescalado en Gb. Debe ser un múltiplo de 4 y menor o igual que 120* para servicios no de pago o 356* para servicios de pago.* - el tamaño máximo de la réplica está sujeto a la disponibilidad de hardware del proveedor de Cloud en la región seleccionada. example: 120 maximum: 356 minimum: 8 multipleOf: 4 type: number maxTotalMemoryGb: deprecated: true description: >- DEPRECATED: impreciso para servicios con un número de réplicas distinto del predeterminado. Memoria máxima de tres workers durante el autoescalado en Gb. Disponible solo para servicios 'production'. Debe ser un múltiplo de 12 y menor o igual que 360 para servicios no de pago o 1068 para servicios de pago. example: 360 maximum: 1068 minimum: 24 multipleOf: 12 type: number minReplicaMemoryGb: description: >- Memoria total mínima de cada réplica durante el autoescalado en Gb. Debe ser un múltiplo de 4 y mayor o igual que 8. example: 16 maximum: 356 minimum: 8 multipleOf: 4 type: number minTotalMemoryGb: deprecated: true description: >- DEPRECATED: impreciso para servicios con un número de réplicas distinto del predeterminado. Memoria mínima de tres workers durante el autoescalado en Gb. Disponible solo para servicios 'production'. Debe ser un múltiplo de 12 y mayor o igual que 24. example: 48 maximum: 1068 minimum: 24 multipleOf: 12 type: number name: description: >- Nombre del servicio. Cadena alfanumérica con espacios de hasta 50 caracteres. type: string numReplicas: description: >- Número de réplicas del servicio. El número de réplicas debe estar entre 2 y 20 para el primer servicio de un warehouse. Los servicios que se crean en un warehouse existente pueden tener tan solo 1 réplica. Pueden aplicarse restricciones adicionales según el tier de su organización. El valor predeterminado es 1 para el tier BASIC y 3 para los tiers SCALE y ENTERPRISE. example: 3 maximum: 20 minimum: 1 type: number privateEndpointIds: deprecated: true description: >- Para asociar el servicio con private endpoints, primero cree el servicio y luego use el endpoint `Update Service Basic Details` para modificar los private endpoints. items: type: string type: array privatePreviewTermsChecked: description: >- Acepte los terms and conditions de la private preview. Solo es necesario al crear el primer servicio de la organización en caso de private preview type: boolean profile: description: >- Perfil de instancia personalizado. Solo disponible para los tiers de organización ENTERPRISE. enum: - v1-default - v1-highmem-xs - v1-highmem-s - v1-highmem-m - v1-highmem-l - v1-highmem-xl - v1-highcpu-s - v1-highcpu-m - v1-highcpu-l - v1-highcpu-xl type: string provider: description: Proveedor de Cloud enum: - aws - gcp - azure type: string region: description: Región del servicio. enum: - ap-northeast-1 - ap-south-1 - ap-southeast-1 - ap-southeast-2 - eu-central-1 - eu-west-1 - eu-west-2 - me-central-1 - us-east-1 - us-east-2 - us-west-2 - us-east1 - us-central1 - europe-west4 - asia-southeast1 - eastus - eastus2 - westus3 - germanywestcentral type: string releaseChannel: description: >- Seleccione fast si quiere recibir las nuevas ClickHouse releases en cuanto estén disponibles. Recibirá nuevas funciones más rápido, pero con un mayor riesgo de errores. Seleccione slow si desea posponer las releases para disponer de más tiempo para probarlas. Esta función solo está disponible para servicios 'production'. El valor predeterminado es el regular release channel. enum: - slow - default - fast type: string tier: deprecated: true description: >- DEPRECATED para los tiers de organización BASIC, SCALE y ENTERPRISE. Tier del servicio: 'development', 'production', 'dedicated_high_mem', 'dedicated_high_cpu', 'dedicated_standard', 'dedicated_standard_n2d_standard_4', 'dedicated_standard_n2d_standard_8', 'dedicated_standard_n2d_standard_32', 'dedicated_standard_n2d_standard_128', 'dedicated_standard_n2d_standard_32_16SSD', 'dedicated_standard_n2d_standard_64_24SSD'. Los servicios Production escalan; los Development tienen un tamaño fijo. Los servicios de Azure no admiten el tier Development enum: - development - production - dedicated_high_mem - dedicated_high_cpu - dedicated_standard - dedicated_standard_n2d_standard_4 - dedicated_standard_n2d_standard_8 - dedicated_standard_n2d_standard_32 - dedicated_standard_n2d_standard_128 - dedicated_standard_n2d_standard_32_16SSD - dedicated_standard_n2d_standard_64_24SSD type: string ServicePostResponse: properties: password: description: Contraseña del servicio recién creado. type: string service: $ref: '#/components/schemas/Service' ServiceEndpointChange: properties: enabled: description: Habilitar o deshabilitar el endpoint type: boolean protocol: description: Protocolo del endpoint enum: - mysql example: mysql type: string IpAccessListEntry: properties: description: description: >- Descripción opcional de la dirección IPv4 o del CIDR IPv4 desde los que se permitirá el acceso type: string source: description: IP o CIDR type: string Service: properties: availablePrivateEndpointIds: description: >- Lista de IDs de private endpoints disponibles que pueden adjuntarse al servicio items: type: string type: array byocId: description: >- Este es el ID devuelto después de configurar una región para Bring Your Own Cloud (BYOC). Cuando se especifica el parámetro byocId, también son obligatorios los parámetros minReplicaMemoryGb y maxReplicaGb, con valores incluidos entre los siguientes tamaños: 48, 116, 172, 232. type: string clickhouseVersion: description: Versión de ClickHouse del servicio. type: string complianceType: description: Tipo de cumplimiento normativo del servicio. enum: - hipaa - pci type: string createdAt: description: Timestamp de creación del servicio. ISO-8601. format: date-time type: string dataWarehouseId: description: Warehouse de datos que contiene este servicio type: string encryptionAssumedRoleIdentifier: description: Role opcional que se usará para el cifrado de disco type: string encryptionKey: description: Clave de cifrado de disco opcional proporcionada por el cliente type: string encryptionRoleId: description: >- El ID del IAM role usado para el cifrado. Esto solo está disponible si hasTransparentDataEncryption es true. type: string endpoints: description: Lista de todos los endpoints del servicio. items: $ref: '#/components/schemas/ServiceEndpoint' type: array hasTransparentDataEncryption: description: >- True si el servicio debe tener habilitado Transparent Data Encryption (TDE). TDE solo está disponible para los tiers de organización ENTERPRISE y solo puede habilitarse al crear el servicio. type: boolean iamRole: description: IAM role usado para acceder a objetos en S3 type: string id: description: ID único del servicio. format: uuid type: string idleScaling: description: >- Si se establece en true, el servicio puede escalar hasta cero cuando está inactivo. True de forma predeterminada. type: boolean idleTimeoutMinutes: description: >- Establezca el timeout mínimo de inactividad (en minutos). Debe ser >= 5 minutos. type: number ipAccessList: description: Lista de direcciones IP permitidas para acceder al servicio items: $ref: '#/components/schemas/IpAccessListEntry' type: array isPrimary: description: >- True si este servicio es el servicio principal en el warehouse de datos type: boolean isReadonly: description: >- True si este servicio es de solo lectura. Solo puede ser de solo lectura si se proporciona un dataWarehouseId. type: boolean maxReplicaMemoryGb: description: >- Memoria total máxima de cada réplica durante el autoescalado, en Gb. Debe ser un múltiplo de 4 y menor o igual que 120* para servicios no pagos o 356* para servicios pagos.* - el tamaño máximo de la réplica está sujeto a la disponibilidad de hardware del proveedor de Cloud en la región seleccionada. example: 120 maximum: 356 minimum: 8 multipleOf: 4 type: number maxTotalMemoryGb: deprecated: true description: >- OBSOLETO: inexacto para servicios con un número de réplicas distinto del predeterminado. Memoria máxima de tres workers durante el autoescalado, en Gb. Disponible solo para servicios 'production'. Debe ser un múltiplo de 12 y menor o igual que 360 para servicios no pagos o 1068 para servicios pagos. example: 360 maximum: 1068 minimum: 24 multipleOf: 12 type: number minReplicaMemoryGb: description: >- Memoria total mínima de cada réplica durante el autoescalado, en Gb. Debe ser un múltiplo de 4 y mayor o igual que 8. example: 16 maximum: 356 minimum: 8 multipleOf: 4 type: number minTotalMemoryGb: deprecated: true description: >- OBSOLETO: inexacto para servicios con un número de réplicas distinto del predeterminado. Memoria mínima de tres workers durante el autoescalado, en Gb. Disponible solo para servicios 'production'. Debe ser un múltiplo de 12 y mayor o igual que 24. example: 48 maximum: 1068 minimum: 24 multipleOf: 12 type: number name: description: >- Nombre del servicio. Cadena alfanumérica con espacios de hasta 50 caracteres. type: string numReplicas: description: >- Número de réplicas del servicio. El número de réplicas debe estar entre 2 y 20 para el primer servicio de un warehouse. Los servicios creados en un warehouse existente pueden tener tan solo 1 réplica. Pueden aplicarse restricciones adicionales según el tier de su organización. El valor predeterminado es 1 para el tier BASIC y 3 para los tiers SCALE y ENTERPRISE. example: 3 maximum: 20 minimum: 1 type: number privateEndpointIds: description: Lista de private endpoints items: type: string type: array profile: description: >- Profile de instancia personalizado. Disponible solo para los tiers de organización ENTERPRISE. enum: - v1-default - v1-highmem-xs - v1-highmem-s - v1-highmem-m - v1-highmem-l - v1-highmem-xl - v1-highcpu-s - v1-highcpu-m - v1-highcpu-l - v1-highcpu-xl type: string provider: description: Proveedor de Cloud enum: - aws - gcp - azure type: string region: description: Región del servicio. enum: - ap-northeast-1 - ap-south-1 - ap-southeast-1 - ap-southeast-2 - eu-central-1 - eu-west-1 - eu-west-2 - me-central-1 - us-east-1 - us-east-2 - us-west-2 - us-east1 - us-central1 - europe-west4 - asia-southeast1 - eastus - eastus2 - westus3 - germanywestcentral type: string releaseChannel: description: >- Seleccione fast si desea obtener las nuevas versiones de ClickHouse en cuanto estén disponibles. Obtendrá nuevas funciones más rápido, pero con un mayor riesgo de errores. Seleccione slow si desea posponer las versiones para disponer de más tiempo para probarlas. Esta función solo está disponible para servicios 'production'. default es el canal de versiones regular. enum: - slow - default - fast type: string state: description: Estado actual del servicio. enum: - starting - stopping - terminating - awaking - partially_running - provisioning - running - stopped - terminated - degraded - failed - idle type: string tier: deprecated: true description: >- OBSOLETO para los tiers de organización BASIC, SCALE y ENTERPRISE. Tier del servicio: 'development', 'production', 'dedicated_high_mem', 'dedicated_high_cpu', 'dedicated_standard', 'dedicated_standard_n2d_standard_4', 'dedicated_standard_n2d_standard_8', 'dedicated_standard_n2d_standard_32', 'dedicated_standard_n2d_standard_128', 'dedicated_standard_n2d_standard_32_16SSD', 'dedicated_standard_n2d_standard_64_24SSD'. Los servicios Development son de tamaño fijo; los Production escalan. Los servicios de Azure no admiten el tier Development enum: - development - production - dedicated_high_mem - dedicated_high_cpu - dedicated_standard - dedicated_standard_n2d_standard_4 - dedicated_standard_n2d_standard_8 - dedicated_standard_n2d_standard_32 - dedicated_standard_n2d_standard_128 - dedicated_standard_n2d_standard_32_16SSD - dedicated_standard_n2d_standard_64_24SSD type: string transparentDataEncryptionKeyId: description: >- El ID de la clave de Transparent Data Encryption usada para el servicio. Esto solo está disponible si hasTransparentDataEncryption es true. type: string ServiceEndpoint: properties: host: description: Nombre de host del servicio type: string port: description: Puerto numérico type: number protocol: description: 'Protocolo del endpoint: ''https'', ''nativesecure'', ''mysql''.' enum: - https - nativesecure - mysql example: mysql type: string username: description: Nombre de usuario opcional para el endpoint nullable: true type: string securitySchemes: basicAuth: description: >- Usa el ID y el secreto de la clave obtenidos en la consola de ClickHouse Cloud: https://clickhouse.com/docs/cloud/manage/openapi scheme: basic type: http ````