> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-3a82795f.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Actualizar los detalles básicos del servicio > Actualiza los datos básicos del servicio, como el nombre del servicio o la lista de acceso IP. ## OpenAPI ````yaml /es/products/cloud/api-reference/cloud-openapi.json patch /v1/organizations/{organizationId}/services/{serviceId} 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/{serviceId}: patch: tags: - Service summary: Actualizar los detalles básicos del servicio description: >- Actualiza los datos básicos del servicio, como el nombre del servicio o la lista de acceso IP. parameters: - description: ID de la organización propietaria del servicio. in: path name: organizationId required: true schema: format: uuid type: string - description: ID del servicio que se va a actualizar. in: path name: serviceId required: true schema: format: uuid type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ServicePatchRequest' responses: '200': content: application/json: schema: properties: requestId: description: ID único asignado a cada solicitud. UUIDv4 format: uuid type: string result: $ref: '#/components/schemas/Service' 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: ServicePatchRequest: properties: endpoints: description: Lista de endpoints del servicio que se van a cambiar items: $ref: '#/components/schemas/ServiceEndpointChange' type: array ipAccessList: $ref: '#/components/schemas/IpAccessListPatch' name: description: >- Nombre del servicio. Cadena alfanumérica con espacios de hasta 50 caracteres. type: string privateEndpointIds: $ref: '#/components/schemas/InstancePrivateEndpointsPatch' releaseChannel: description: >- Seleccione fast si desea recibir las nuevas versiones de ClickHouse en cuanto estén disponibles. Tendrá acceso a nuevas funciones más rápido, pero con un mayor riesgo de errores. Seleccione slow si desea aplazar las versiones para disponer de más tiempo para probarlas. Esta funcionalidad solo está disponible para servicios de producción. default es el canal de versiones regular. enum: - slow - default - fast type: string transparentDataEncryptionKeyId: description: El ID de la clave que se debe rotar 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 ServiceEndpointChange: properties: enabled: description: Habilitar o deshabilitar el endpoint type: boolean protocol: description: Protocolo del endpoint enum: - mysql example: mysql type: string IpAccessListPatch: properties: add: description: >- Elementos que se deben agregar. Se ejecutan después de que se procese la parte "remove". items: $ref: '#/components/schemas/IpAccessListEntry' type: array remove: description: >- Elementos que se deben eliminar. Se ejecutan antes de que se procese la parte "add". items: $ref: '#/components/schemas/IpAccessListEntry' type: array InstancePrivateEndpointsPatch: properties: add: description: >- Elementos que se deben agregar. Se ejecutan después de que se procese la parte "remove". items: type: string type: array remove: description: >- Elementos que se deben eliminar. Se ejecutan antes de que se procese la parte "add". items: type: string type: array 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 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 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 ````