버전

버전 가져오기

사용 가능한 API 버전 목록 보기

입력

정보
이 엔드포인트는 입력을 허용하지 않습니다.

코드 샘플

GET

/v1/versions

인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/versions

curl -X GET \
  'https://quantum.cloud.ibm.com/api/v1/versions' \
  -H 'Accept: application/json'

인스턴스가 eu-de 리전에 있는 경우, 대신 URL 를 사용하세요: https://eu-de.quantum.cloud.ibm.com/api/v1/versions

import requests

response = requests.request(
    "GET",
    "https://quantum.cloud.ibm.com/api/v1/versions",
    headers={
      "Accept": "application/json"
    },
)
print(response.json())

출력

HTTP 응답 상태 코드
상태 코드	설명
200

응답

상태 코드

{
  "versions": [
    {
      "version": "2024-01-01",
      "sunset_date": "2027-01-01",
      "status": "deprecated"
    },
    {
      "version": "2025-01-01",
      "sunset_date": "2027-01-01",
      "status": "deprecated"
    },
    {
      "version": "2025-05-01",
      "sunset_date": "2027-01-01",
      "status": "deprecated"
    },
    {
      "version": "2026-02-01",
      "sunset_date": "2027-02-01",
      "status": "deprecated"
    },
    {
      "version": "2026-02-15",
      "sunset_date": "2027-02-15",
      "status": "deprecated"
    },
    {
      "version": "2026-03-15",
      "sunset_date": "2027-03-15",
      "status": "deprecated"
    },
    {
      "version": "2026-04-15",
      "status": "live"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "versions": {
      "example": [
        {
          "version": "2024-01-01",
          "sunset_date": "2027-01-01",
          "status": "deprecated"
        },
        {
          "version": "2025-01-01",
          "sunset_date": "2027-01-01",
          "status": "deprecated"
        },
        {
          "version": "2025-05-01",
          "sunset_date": "2027-01-01",
          "status": "deprecated"
        },
        {
          "version": "2026-02-01",
          "sunset_date": "2027-02-01",
          "status": "deprecated"
        },
        {
          "version": "2026-02-15",
          "sunset_date": "2027-02-15",
          "status": "deprecated"
        },
        {
          "version": "2026-03-15",
          "sunset_date": "2027-03-15",
          "status": "deprecated"
        },
        {
          "version": "2026-04-15",
          "status": "live"
        }
      ],
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "version": {
            "type": "string",
            "description": "다음 `YYYY-MM-DD` 형식의 API 버전.",
            "format": "date",
            "minLength": 10,
            "maxLength": 10,
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "sunset_date": {
            "type": "string",
            "description": "API 버전의 만료일 ( `YYYY-MM-DD` 형식). 이 날짜부터 언제든지 지원이 중단될 수 있습니다.",
            "format": "date",
            "minLength": 10,
            "maxLength": 10,
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "status": {
            "description": "API 버전의 지원 상태.",
            "allOf": [
              {
                "type": "string",
                "enum": [
                  "live",
                  "deprecated"
                ],
                "description": "API 버전의 지원 상태."
              }
            ]
          }
        },
        "required": [
          "version",
          "status"
        ]
      }
    }
  },
  "required": [
    "versions"
  ]
}