> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener una región

> Devuelve una región publicada por su código inmutable. Las regiones desconocidas y no publicadas devuelven 404. Este punto final público tiene una velocidad limitada por IP de cliente; las respuestas correctas pueden almacenarse en caché de forma privada durante 60 segundos.


<Info>
  Requiere **sin acción de IAM**. El acceso se decide por las propias reglas del punto final en lugar de por una política. Consulte la descripción anterior.
</Info>


## OpenAPI

````yaml /es/api-reference/specs/catalog.yaml get /v1/regions/{code}
openapi: 3.0.3
info:
  title: API de catálogo de Basaltic
  version: 1.0.0
  description: >-
    Descubrimiento de plataforma global pública. El ciclo de vida es
    independiente del estado de funcionamiento, la capacidad, la autorización
    del inquilino y la ubicación del producto.
  contact:
    name: Basaltic Support
    email: ping@basaltic.sh
  license:
    name: Proprietary
    url: https://basaltic.sh/terms
servers:
  - url: https://catalog.basaltic.sh
    description: Punto final del catálogo global
security: []
paths:
  /v1/regions/{code}:
    get:
      tags:
        - Regions
      summary: Obtener una región
      description: >
        Devuelve una región publicada por su código inmutable. Las regiones
        desconocidas y no publicadas devuelven 404. Este punto final público
        tiene una velocidad limitada por IP de cliente; las respuestas correctas
        pueden almacenarse en caché de forma privada durante 60 segundos.
      operationId: getRegion
      parameters:
        - name: code
          in: path
          required: true
          description: Código de región inmutable.
          schema:
            type: string
            pattern: ^[a-z][a-z0-9-]{0,31}$
            example: sa-saopaulo-1
      responses:
        '200':
          description: Región publicada
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Region'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security: []
components:
  schemas:
    Region:
      type: object
      required:
        - crn
        - code
        - name
        - location
        - country_code
        - state
        - accepting_new_resources
        - available
        - coming_soon
      properties:
        state:
          type: string
          enum:
            - planned
            - active
            - restricted
            - retiring
            - retired
          description: >-
            Ciclo de vida del catálogo, independiente de la salud y la
            capacidad. Los códigos retirados nunca se reutilizan.
          example: active
        accepting_new_resources:
          type: boolean
          description: >-
            Es válido solo para regiones activas. Los servicios de producto
            siguen aplicando la elegibilidad, las cuotas, la colocación y la
            capacidad.
          example: true
        crn:
          type: string
          description: >-
            Identidad de región global de propiedad de la plataforma, utilizando
            el código de región inmutable.
          example: crn:catalog::platform:region/sa-saopaulo-1
        code:
          type: string
          description: Código de región único utilizado en llamadas a API y CRN
          example: sa-saopaulo-1
        name:
          type: string
          description: Nombre de región legible por humanos
          example: São Paulo 1
        location:
          type: string
          description: Ubicación geográfica de la región
          example: São Paulo, Brazil
        country_code:
          type: string
          description: >-
            Código de país ISO 3166-1 alfa-2 (utilizado para mostrar la bandera
            en la interfaz de usuario)
          example: BR
          minLength: 2
          maxLength: 2
        available:
          type: boolean
          description: >-
            Alias de compatibilidad para accepting_new_resources; no es una
            señal de estado en vivo
          example: true
        coming_soon:
          type: boolean
          description: >-
            Indicador de compatibilidad que es verdadero solo cuando se
            planifica el estado
          example: false
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - request_id
          properties:
            code:
              type: string
              description: Código de error que identifica el tipo de error
              example: INVALID_INPUT
            message:
              type: string
              description: Mensaje de error legible por el ser humano
              example: Invalid request parameters
            params:
              type: object
              additionalProperties: true
              description: >-
                Valores no sensibles opcionales para la interpolación de errores
                localizados, codificados por código de error. Nunca presente por
                errores del servidor.
              example:
                instances: 2
                pools: 0
            request_id:
              type: string
              format: uuid
              description: Solicitar ID para depuración
              example: 550e8400-e29b-41d4-a716-446655440000
  responses:
    BadRequest:
      description: Parámetros de solicitud no válidos
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: INVALID_INPUT
              message: Invalid request parameters
              request_id: 550e8400-e29b-41d4-a716-446655440000
    NotFound:
      description: No se encontró el recurso
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: NOT_FOUND
              message: Resource not found
              request_id: 550e8400-e29b-41d4-a716-446655440000
    TooManyRequests:
      description: >
        Límite de velocidad excedido. El presupuesto es una ventana fija contada
        por punto final y por llamador (el principal autenticado cuando la
        solicitud lleva credenciales, la IP del cliente de lo contrario), de
        modo que un punto final con restricción nunca gasta el presupuesto de
        otro, y un inquilino nunca gasta el de otro.


        Espere `Retry-After` segundos, luego vuelva a intentarlo. Los
        encabezados `X-RateLimit-*` también se basan en las respuestas exitosas
        de un punto final con límite de velocidad, por lo que un cliente puede
        acelerarse en lugar de descubrir el límite al alcanzarlo.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: RATE_LIMITED
              message: Too many requests, please try again later
              request_id: 550e8400-e29b-41d4-a716-446655440000
      headers:
        Retry-After:
          description: Segundos para esperar antes de volver a intentarlo. Nunca a cero.
          required: true
          schema:
            type: integer
            minimum: 1
          example: 42
        X-RateLimit-Limit:
          description: Solicitudes permitidas por ventana en este punto final.
          required: true
          schema:
            type: integer
            minimum: 1
          example: 5
        X-RateLimit-Remaining:
          description: Solicitudes que quedan en la ventana actual. Siempre 0 en un 429.
          required: true
          schema:
            type: integer
            minimum: 0
          example: 0
        X-RateLimit-Reset:
          description: >-
            Segundos hasta que la ventana se reinicia: una duración, no una
            marca de tiempo, por lo que no necesita ningún acuerdo de reloj
            entre el cliente y el servidor.
          required: true
          schema:
            type: integer
            minimum: 1
          example: 42
    InternalServerError:
      description: Error interno del servidor
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: INTERNAL_ERROR
              message: An internal error occurred
              request_id: 550e8400-e29b-41d4-a716-446655440000

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.