diff --git a/pages/index.md b/pages/index.md index fa9cd95c1c3..ec373e06c75 100644 --- a/pages/index.md +++ b/pages/index.md @@ -1274,7 +1274,10 @@ + [Troubleshooting](public_cloud/quantum_computing/troubleshooting) + [Emulators](products/public-cloud-quantum-computing-emulator) + [Guides](public-cloud-quantum-computing-emulators-guides) - + [Quantum emulators - Getting started](public_cloud/quantum_computing/getting-started-emulators) + + [Quantum emulators - Getting started](public_cloud/quantum_computing/emulators/getting-started) + + [QPUs](products/public-cloud-quantum-computing-qpu) + + [Guides](public-cloud-quantum-computing-qpu-guides) + + [QPUs - Getting started](public_cloud/quantum_computing/qpus/getting-started) + [Analytics](products/public-cloud-data-analytics) + [General information](products/public-cloud-data-analytics-general-information) + [Analytics - Security overview](public_cloud/public_cloud_databases/information_01_security_overview) diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.de-de.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.de-de.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.de-de.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.de-de.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-asia.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-asia.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-asia.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-asia.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-au.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-au.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-au.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-au.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-ca.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-ca.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-ca.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-ca.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-gb.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-gb.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-gb.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-gb.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-ie.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-ie.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-ie.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-ie.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-sg.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-sg.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-sg.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-sg.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-us.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-us.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-us.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.en-us.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.es-es.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.es-es.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.es-es.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.es-es.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.es-us.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.es-us.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.es-us.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.es-us.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.fr-ca.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.fr-ca.md index baf93ebbdb4..a78a647d2c1 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.fr-ca.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.fr-ca.md @@ -1,7 +1,7 @@ --- title: "CLI - Se servir des tokens d'accès (EN)" excerpt: "Découvrez comment créer des tokens d'accès avec la CLI ovhai" -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.fr-fr.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.fr-fr.md index baf93ebbdb4..a78a647d2c1 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.fr-fr.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.fr-fr.md @@ -1,7 +1,7 @@ --- title: "CLI - Se servir des tokens d'accès (EN)" excerpt: "Découvrez comment créer des tokens d'accès avec la CLI ovhai" -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.it-it.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.it-it.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.it-it.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.it-it.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.pl-pl.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.pl-pl.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.pl-pl.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.pl-pl.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.pt-pt.md b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.pt-pt.md index c31d72e50e8..ef768fa7532 100644 --- a/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.pt-pt.md +++ b/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli/guide.pt-pt.md @@ -1,7 +1,7 @@ --- title: CLI - Manage access tokens excerpt: Learn how to create Application tokens with the ovhai CLI -updated: 2023-05-11 +updated: 2025-11-06 --- ## Objective @@ -21,11 +21,13 @@ If you need any help while creating a new token, run `ovhai token create --help` ``` {.console} Usage: ovhai token create [OPTIONS] --role +Create an application token + Arguments: Token's name Options: - -r, --role Operator role gives all access, read role only allow to access job's APIs [possible values: read, operator] + -r, --role Operator role gives all access, read role only allow to access job's APIs. DEPRECATED VALUES: "read", "operator" => replaced by "ai_training_read", "ai_training_operator" [possible values: read, operator, ai_training_read, ai_training_operator, quantum_operator, quantum_reader] --token Authentication using Token rather than OAuth -l, --label-selector Only jobs with this label's name and value will be accessible using this token -o, --output Command output format [possible values: json, yaml, description] diff --git a/pages/public_cloud/quantum_computing/billing/guide.en-gb.md b/pages/public_cloud/quantum_computing/billing/guide.en-gb.md index 0157dfcf4a8..5158149b54c 100644 --- a/pages/public_cloud/quantum_computing/billing/guide.en-gb.md +++ b/pages/public_cloud/quantum_computing/billing/guide.en-gb.md @@ -1,7 +1,7 @@ --- title: Quantum computing - Billing and lifecycle excerpt: Learn how we bill Quantum Notebooks -updated: 2025-06-17 +updated: 2025-11-06 --- > [!warning] @@ -10,7 +10,7 @@ updated: 2025-06-17 ## Objective -**OVHcloud Quantum Notebooks** are managed Jupyter and VSCode notebooks with assigned CPU or GPU resources, eliminating the need for installation and maintenance. This documentation will detail the notebook **lifecycle and billing**. +**OVHcloud Quantum Notebooks** are managed Jupyter and VS Code notebooks with assigned CPU or GPU resources, eliminating the need for installation and maintenance. This documentation will detail the notebook **lifecycle and billing**. ## Introduction @@ -37,10 +37,11 @@ Quantum Notebooks is a **pay-per-use solution**. You only pay for the **resource **Included** in Quantum Notebooks resources: -- Dedicated CPU/GPU compute resources (based on the selected amount during notebook creation) +- Dedicated CPU/GPU compute resources (based on the selected amount during notebook creation). +- For **Quantum QPU**, an additional remote Quantum Processing Unit compute resource is available on your notebook. - Ephemeral local notebook storage (the size depends on the selected compute resources). The first 10GB are free. -- Workspace remote storage (Optional) -- Ingress/Egress network traffic (Optional) +- Workspace remote storage (Optional). +- Ingress/Egress network traffic (Optional). Here is a detailed graph that illustrates every step that is billed or not during the Quantum Notebooks workflow: @@ -50,6 +51,8 @@ Here is a detailed graph that illustrates every step that is billed or not durin During the notebook creation, you can select **compute resources**, known as CPUs or GPUs. Their official pricing is available in the [OVHcloud Control Panel](/links/manager) or on the [OVHcloud Public Cloud website](/links/public-cloud/prices). +When your program needs to access to the remote QPU, QPU time is charged by the second. You will only be charged for your QPU usage time. + Rates for compute are mentioned per hour to facilitate reading of the prices, but the billing granularity remains **per minute**. As stated above and shown in the image above, you pay for these resources as long as you consume them. This happens when the image of your notebook is pulled, during the `STARTING` phase, but also during `RUNNING` and `STOPPING` phases, until you reach the `STOPPED` phase. @@ -62,7 +65,7 @@ There are three types of storage within Quantum Notebooks: - Workspace storage - Ephemeral local storage -The pricing of these different storages is different. +The pricing of these storages is different. #### Remote Object storage @@ -90,53 +93,73 @@ This storage is not billed as it is directly linked to the compute resource(s) y ### Pricing examples -#### Example 1: one GPU notebook for 10 hours then deleted - -We start one Quantum Notebook, with two GPUs and we keep it running for 10 hours then we **delete it**. - -- compute resources: 2 x GPU NVIDIA V100s (1,93€ / hour) -- remote storage: nothing -- duration: 10 hours then deleted - -Price calculation for compute: 10 (hours) x 2 (GPU) x 1,93€ (price / GPU) = **38,6 euros**, billed at the end of the month. - -#### Example 2: one GPU notebook for 10 hours but stopped, not deleted - -We start one Quantum Notebook, with two GPUs and we keep it running for 10 hours then we stop it and finally we **delete it after 10 days**. - -- compute resources: 2 x GPU NVIDIA V100s (1,93 / hour) -- remote storage: nothing -- workspace storage: 100GB used. The first 10GB are free. -- duration: 10 hours then stopped for 10 days - -Price calculation for compute : 10 (hours) x 2 (GPU) x 1,93 (price / GPU) = **38,6 euros**, billed at the end of the month. -Price calculation for workspace : 90 (GB) x 0,01€ (price for object storage / GB) = **0,9 euros**, billed at the end of the month. - -#### Example 3: one GPU notebook for 10 hours with 1TB remote storage - -We start one Quantum Notebook, with two GPUs and 1TB remote storage. We keep it running for 10 hours then we delete it. - -- compute resources: 2 x GPU NVIDIA V100s (1,93 / hour) -- remote storage: 1TB in OVHcloud Object Storage -- workspace storage: 100GB used. The first 10GB are free. -- duration: 10 hours then we delete it. - -Price calculation for compute: 10 (hours) x 2 (GPU) x 1,93 (price / GPU) = **38,6 euros**, billed at the end of the month. -Price calculation for workspace: 90 (GB) x 0,01€ (price for object storage / GB) = **0,9 euros**, billed at the end of the month. - -Also, price calculation for remote Object Storage : 1000 (GB) x 0,01€ (price for object storage / GB) = **10 euros**, billed at the end of the month. - -#### Example 4: 15 CPU notebooks for 5 hours then deleted - -We start 15 Quantum Notebooks, each of them with one vCPU - -- compute resources: 1 x vCPU (0,03€ /hour /cpu) -- remote storage: nothing -- duration: 5 hours then we delete it. - -Price calculation for compute: 15 (notebooks) x 5 (hours) x 1 (CPU) x 0,03€ (price / CPU) = **2,25 euros**, billed at the end of the month. - -## Going further +> [!tabs] +> **For Quantum Emulators** +>> +>> **Example 1: One GPU notebook for 10 hours then deleted** +>> +>> We start one Quantum Notebook with two GPUs and we keep it running for 10 hours then we **delete it**. +>> +>> - Compute resources: 2 x GPU NVIDIA V100s (1,93€ / hour) +>> - Remote storage: Nothing +>> - Duration: 10 hours then deleted +>> +>> Price calculation for compute: 10 (hours) x 2 (GPU) x 1,93€ (price / GPU) = **38,6 euros**, billed at the end of the month. +>> +>> **Example 2: One GPU notebook for 10 hours but stopped, not deleted** +>> +>> We start one Quantum Notebook, with two GPUs and we keep it running for 10 hours then we stop it and finally we **delete it after 10 days**. +>> +>> - Compute resources: 2 x GPU NVIDIA V100s (1,93 / hour) +>> - Remote storage: Nothing +>> - Workspace storage: 100GB used. The first 10GB are free. +>> - Duration: 10 hours then stopped for 10 days +>> +>> Price calculation for compute : 10 (hours) x 2 (GPU) x 1,93 (price / GPU) = **38,6 euros**, billed at the end of the month. +>> Price calculation for workspace : 90 (GB) x 0,01€ (price for object storage / GB) = **0,9 euros**, billed at the end of the month. +>> +>> **Example 3: One GPU notebook for 10 hours with 1TB remote storage** +>> +>> We start one Quantum Notebook, with two GPUs and 1TB remote storage. We keep it running for 10 hours then we delete it. +>> +>> - Compute resources: 2 x GPU NVIDIA V100s (1,93 / hour) +>> - Remote storage: 1TB in OVHcloud Object Storage +>> - Workspace storage: 100GB used. The first 10GB are free. +>> - Duration: 10 hours then we delete it. +>> +>> Price calculation for compute: 10 (hours) x 2 (GPU) x 1,93 (price / GPU) = **38,6 euros**, billed at the end of the month. +>> Price calculation for workspace: 90 (GB) x 0,01€ (price for object storage / GB) = **0,9 euros**, billed at the end of the month. +>> +>> Also, price calculation for remote Object Storage : 1000 (GB) x 0,01€ (price for object storage / GB) = **10 euros**, billed at the end of the month. +>> +>> **#### **Example 4: 15 CPU notebooks for 5 hours then deleted** +>> +>> We start 15 Quantum Notebooks, each of them with one vCPU +>> +>> - Compute resources: 1 x vCPU (0,03€ /hour /cpu) +>> - Remote storage: Nothing +>> - Duration: 5 hours then we delete it. +>> +>> Price calculation for compute: 15 (notebooks) x 5 (hours) x 1 (CPU) x 0,03€ (price / CPU) = **2,25 euros**, billed at the end of the month. +>> +> **For Quantum QPUs** +>> +>> Pricing of Quantum QPUs notebooks are the same than Quantum Emulators but you will pay only for the time you use a QPU. +>> +>> **Example 1: One CPU used during 10 hours + one Pasqal QPU Orion Beta used during 1 hour** +>> +>> We start one Quantum QPU Notebook, with one CPU and we keep it running for 10 hours then we **delete it**. +>> We use one hour of the Orion Pasqal QPU which costs 3000€ / hour. +>> +>> - Compute resources: 1 x Intel CPU VCore (0,03€ / hour) +>> - Remote storage: Nothing +>> - Duration: 10 hours then deleted +>> - QPU usage: 1 x Pasqal QPU Orion Beta (3000€ / hour) +>> +>> Price calculation for compute: 10 (hours) x 1 (CPU) x 0,03€ (price / CPU) + 1 (hour) x 3000€ (price / QPU) = **3000,3 euros**, billed at the end of the month. +>> + +## Go further For training or technical assistance, contact your sales representative or click on [this link](/links/professional-services) to get a quote and ask our Professional Services experts for a custom analysis. diff --git a/pages/public_cloud/quantum_computing/billing/images/billing.png b/pages/public_cloud/quantum_computing/billing/images/billing.png index e7e6335521f..e426cc2c9c3 100644 Binary files a/pages/public_cloud/quantum_computing/billing/images/billing.png and b/pages/public_cloud/quantum_computing/billing/images/billing.png differ diff --git a/pages/public_cloud/quantum_computing/billing/images/lifecycle.png b/pages/public_cloud/quantum_computing/billing/images/lifecycle.png index 958a57810ac..4eb4a2b979c 100644 Binary files a/pages/public_cloud/quantum_computing/billing/images/lifecycle.png and b/pages/public_cloud/quantum_computing/billing/images/lifecycle.png differ diff --git a/pages/public_cloud/quantum_computing/capabilities/guide.en-gb.md b/pages/public_cloud/quantum_computing/capabilities/guide.en-gb.md index 393957065ca..e69bd9dde8b 100644 --- a/pages/public_cloud/quantum_computing/capabilities/guide.en-gb.md +++ b/pages/public_cloud/quantum_computing/capabilities/guide.en-gb.md @@ -148,12 +148,14 @@ OVHcloud Quantum Notebooks comes with pre-installed Quantum environments. List of available Quantum Environments: - Alice & Bob Felis -- C12 - Atos myQLM -- Pasqal Pulser -- Quandela Perceval +- C12 - IBM Qiskit +- IQM SQK +- Pasqal Pulser +- Pasqal Pulser for QPU - QPerfect MIMIQ +- Quandela Perceval - Quobly #### Environment customization diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/guide.en-gb.md b/pages/public_cloud/quantum_computing/emulators/getting-started/guide.en-gb.md similarity index 83% rename from pages/public_cloud/quantum_computing/getting-started-emulators/guide.en-gb.md rename to pages/public_cloud/quantum_computing/emulators/getting-started/guide.en-gb.md index e7ea1dd7841..dfef6e631bc 100644 --- a/pages/public_cloud/quantum_computing/getting-started-emulators/guide.en-gb.md +++ b/pages/public_cloud/quantum_computing/emulators/getting-started/guide.en-gb.md @@ -1,32 +1,23 @@ --- -title: Quantum computing - Getting started with emulators -excerpt: Learn how to bootstrap a Quantum Notebook emulator -updated: 2025-06-17 +title: Quantum computing - Getting started with Emulators Notebooks +excerpt: Learn how to set up a Quantum Emulators Notebook +updated: 2025-11-06 --- > [!warning] > > Some links on this documentation refer to the AI and Machine Learning solution. Quantum computing shares the same infrastructure as a service so you might be redirected to another section of this documentation. +> ## Introduction A **Notebook** is a document that integrates code, rich text elements, and multimedia, making it a convenient tool for quantum analysis and visualization. -**OVHcloud Quantum Emulators** is our managed solution for Jupyter and VSCode Notebooks. You can easily launch Notebooks with the required CPU and GPU resources while enjoying benefits like pre-installed dependencies and Quantum frameworks, secure user access, and simplified data management. +**OVHcloud Quantum Emulators** is our managed solution for Jupyter and VS Code Notebooks. You can easily launch Notebooks with the required CPU and GPU resources while enjoying benefits like pre-installed dependencies and Quantum frameworks, secure user access, and simplified data management. ## Objective -This guide demonstrates how to create, configure, access, stop, restart, and delete a Quantum Notebook emulator. - -## Requirements - -- A [Public Cloud project](/links/public-cloud/public-cloud) in your OVHcloud account -- Access to the [OVHcloud Control Panel](/links/manager) -- A Public Cloud user with the **Administrator** or **Quantum Operator & Objectstore Operator** roles - -## Instructions - -To create your first Quantum Notebook, we recommend using the **OVHcloud Control Panel (UI)**. This method is user-friendly and ideal for beginners. +This guide demonstrates how to create, configure, access, stop, restart, and delete a Quantum Emulators Notebook from the **OVHcloud Control Panel (UI)**. This method is user-friendly and ideal for beginners. Alternatively, you can use one of the following methods: @@ -36,12 +27,20 @@ Alternatively, you can use one of the following methods: Each method offers its distinct advantages, depending on your expertise and preferred workflow. -### OVHcloud Quantum Solutions Authorization Process +## Requirements + +- A [Public Cloud project](/links/public-cloud/public-cloud) in your OVHcloud account. +- Access to the [OVHcloud Control Panel](/links/manager). +- A Public Cloud user with the **Administrator** or **Quantum Operator & Objectstore Operator** roles. + +## Instructions -If you're using the CLI, API, or SDK, you will need to complete an authorization process before creating a Quantum Notebook. To do so, follow these steps: +### OVHcloud Quantum Solutions authorization process + +If you're using the CLI, API, or SDK, you will need to complete an authorization process before creating a Quantum Emulators Notebook. To do so, follow these steps: 1. Log in to the [OVHcloud Control Panel](/links/manager) and navigate to the `Public Cloud`{.action} section. -2. Select the Public Cloud project you want to use and click on the `Quantum computing`{.action} category. +2. Select the Public Cloud project you want to use and click the `Quantum QPUs`{.action} category. 3. Click the `Create a Notebook`{.action} button. The authorization process will take place silently in the background. ![Create a Notebook Control Panel manager 01](images/creating-a-notebook-using-UI-01.png){.thumbnail} @@ -52,69 +51,70 @@ To create a Quantum Notebook, follow these steps: > [!tabs] > **Using the Control Panel (UI)** ->> ->> Navigate to the `Public Cloud`{.action} section of the [OVHcloud Control Panel](/links/manager) and click on the `Quantum computing`{.action} category. +>> +>> Navigate to the `Public Cloud`{.action} section of the [OVHcloud Control Panel](/links/manager) and click the `Quantum computing`{.action} category. >> Click the `Create a Notebook`{.action} button and follow the prompts to specify the configuration of your Quantum Notebook. >> ->> **1\. Notebook Name** ->> +>> ![Create a Notebook Control Panel manager 01](images/creating-a-notebook-using-UI-01.png){.thumbnail} +>> +>> **1\. Notebook name** +>> >> Give a name to your notebook. This will make it easier to manage when you have multiple Quantum Notebooks created. >> >> **2\. Notebook location** ->> +>> >> Next, select a location. ->> +>> >> ![Create a Notebook Control Panel manager 02](images/creating-a-notebook-using-UI-02.png){.thumbnail} ->> ->> **3\. Compute Resources** ->> +>> +>> **3\. Compute resources** +>> >> Specify and adjust the type and amount of computing resources (CPU / GPU) for your Quantum Notebook. Use the `+`{.action} and `-`{.action} buttons to increase or decrease the number of CPUs and GPUs, depending on your needs. >> ->> Click the `Next`{.action} button. ->> +>> Click `Next`{.action}. +>> >> ![Create a Notebook Control Panel manager 03](images/creating-a-notebook-using-UI-03.png){.thumbnail} ->> ->> **4\. Pre-configured Frameworks** ->> ->> Choose the Quantum python framework you want to use, which will be pre-installed and ready to use when your notebook is launched. A wide range of Quantum frameworks are available in different versions. Select the version that suits your needs. Then, click the `Next`{.action} button to continue. ->> +>> +>> **4\. Pre-configured frameworks** +>> +>> Choose the Quantum Python framework you want to use, which will be pre-installed and ready to use when your notebook is launched. A wide range of Quantum frameworks are available in different versions. Select the version that suits your needs. Then, click `Next`{.action} to continue. +>> >> ![Create a Notebook Control Panel manager 04](images/creating-a-notebook-using-UI-04.png){.thumbnail} ->> +>> >> **5\. Live-code editor** ->> +>> >> Choose the code editor you want. ->> +>> >> ![Create a Notebook Control Panel manager 05](images/creating-a-notebook-using-UI-05.png){.thumbnail} ->> ->> **6\. Privacy Settings** ->> ->> Next, select your privacy settings and click the `Next`{.action} button. ->> +>> +>> **6\. Privacy settings** +>> +>> Then, select your privacy settings and click `Next`{.action}. +>> >> > [!warning] >> > ->> > *Public access* will expose your data and code to anyone getting the Quantum Notebook link. Be careful and don't use it with sensitive data. On the other hand, *Restricted access* will ask a user and password combination or a Quantum token to access the Notebook content, ensuring a secure environment. ->> ->> +>> > *Public access* will expose your data and code to anyone getting the Quantum Notebook link. Be careful not to use it with sensitive data. On the other hand, *Restricted access* will require a user and password combination or a Quantum token to access the Notebook content to ensure a secure environment. +>> >> ![Create a Notebook Control Panel manager 06](images/creating-a-notebook-using-UI-06.png){.thumbnail} ->> +>> >> **7\. Advanced configuration** ->> ->> By default, your Quantum Notebook comes with **ephemeral storage** (local storage). But in this step, you can also link Object Storage containers and Git repositories to your notebook, to easily access your remote data. ->> +>> +>> By default, your Quantum Notebook comes with **ephemeral storage** (local storage). But in this step, you can also link Object Storage containers and Git repositories to your notebook to easily access your remote data. +>> >> If you want to learn more about configuring containers and Git repositories in the Notebook, you can refer to this [AI & Machine learning documentation](/pages/public_cloud/ai_machine_learning/notebook_guide_data_ui). For now, we will launch a classic Notebook without any external volumes added to it. ->> ->> Click the `Next`{.action} button. +>> +>> Click `Next`{.action}. >> >> ![Create a Notebook Control Panel manager 07](images/creating-a-notebook-using-UI-07.png){.thumbnail} ->> ->> **SSH public keys** allow you to access your Notebook remotely. This section is optional, click the `Next`{.action} button. ->> +>> +>> **SSH public keys** allow you to access your Notebook remotely. This section is optional, click `Next`{.action}. +>> >> **9\. Launch the Quantum Notebook** ->> ->> At the end of the process, review your settings and click the `Order now`{.action} button to confirm and launch the creation of your Notebook. You will be redirected to you notebook dashboard: +>> +>> At the end of the process, review your settings and click the `Order now`{.action} button to confirm and launch the creation of your Notebook. You will be redirected to your notebook dashboard: >> >> ![Create a Notebook Control Panel manager 10](images/creating-a-notebook-using-UI-08b.png){.thumbnail} ->> +>> >> > [!primary] >> > >> > Note at the bottom of the screen the equivalent *ovhai* CLI command. This command allows you to run the exact same Notebook using the CLI. @@ -152,7 +152,7 @@ To create a Quantum Notebook, follow these steps: >> >> > [!warning] >> > ->> > **Alpha Warning**: This package is currently in the **alpha phase** of development. The APIs and functionalities of the package may not be fully tested. +>> > **Alpha version warning**: This package is currently in the **alpha phase** of development. The APIs and functionalities of the package may not be fully tested. >> >> 1. Create a bearer token from the *ovhai* CLI. For more detailed instructions on creating a token, check the [manage access tokens](/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli) documentation. >> 2. Install the `ovhai` Python SDK and follow the instructions in the [ovhai PyPI](https://pypi.org/project/ovhai/) page to create a Quantum Notebook. @@ -211,21 +211,21 @@ To create a Quantum Notebook, follow these steps: ### Accessing your Quantum Notebook -Once your Quantum Notebook is created and running, you can access it using the `JupyterLab` link in the Quantum Emulators board or through the `ovhai` CLI, Quantum API, or Python SDK. +Once your Quantum Notebook is created and running, you can access it using the `JupyterLab` link in the Quantum Notebooks board or through the `ovhai` CLI, Quantum API, or Python SDK. > [!tabs] > **Using the Control Panel (UI)** ->> +>> >> Click the `JupyterLab`{.action} link in the `Access` column: ->> +>> >> ![Accessing a Notebook Control Panel manager 1](images/accessing-a-notebook-using-UI-1.png){.thumbnail} ->> +>> >> You can also access the Notebook from its dedicated page: ->> +>> >> ![Accessing a Notebook Control Panel manager 2](images/accessing-a-notebook-using-UI-2.png){.thumbnail} ->> +>> >> On the Notebook page, you will find information about the Notebook, including specifications, billing, and attached data, as well as a monitoring URL for real-time metrics. ->> +>> > **Using ovhai CLI** >> >> The `URL` of your Notebook should be displayed in your terminal and you can display it by running `ovhai notebook list` to retrieve the `URL`. @@ -236,7 +236,7 @@ Once your Quantum Notebook is created and running, you can access it using the ` >> > **Using the Quantum API** >> ->> The `URL` of your Notebook should be displayed in the 'Response' panel: +>> The `URL` of your Notebook should appear in the `Response` panel: >> >> ![Access a Notebook API](images/accessing-a-notebook-using-API.png){.thumbnail} >> @@ -295,24 +295,23 @@ Once your Quantum Notebook is created and running, you can access it using the ` >> >> print(json.loads(response.content.decode())) >> ``` +>> ### Connecting to your Quantum Notebook To connect to your Quantum Notebook, you'll need to authenticate using a username and password combination or an access token. -> [!tabs] -> **Using a Username and Password** ->> ->> Enter your Public Cloud project user's username and password to log in to your Quantum Notebook. ->> ->> ![Notebook Authentication Credentials](images/notebook-authentication-creds.png){.thumbnail} ->> -> **Using an Access Token** ->> ->> Click the `Login with token` button and enter your access token to log in to your Quantum Notebook. ->> ->> ![Notebook Authentication Token](images//notebook-authentication-token.png){.thumbnail} ->> +**Using a Username and Password** + +Enter your Public Cloud project user's credentials to log in to your Quantum Notebook. + +![Notebook Authentication Credentials](images/notebook-authentication-creds.png){.thumbnail} + +**Using an Access Token** + +Click the `Login with token` button and enter your access token to log in to your Quantum Notebook. + +![Notebook Authentication Token](images/notebook-authentication-token.png){.thumbnail} ### Stopping a Quantum Notebook @@ -320,12 +319,12 @@ You can stop your Quantum Notebook at any time to release its compute resources. > [!tabs] > **Using the Control Panel (UI)** ->> +>> >> Go to the Quantum Notebooks board and click on the `...`{.action} button next to the Notebook you want to stop. ->> Click the `Stop`{.action} button to stop the Notebook. Or, on the notebook board, you can click on the `red button`{.action} at the top of the page. ->> +Click the `Stop`{.action} button to stop the Notebook. Or, on the notebook board, you can click on the `red button`{.action} at the top of the page. +>> >> ![Stop a Notebook Control Panel manager](images/stopping-a-notebook-using-UI.png){.thumbnail} ->> +>> > **Using ovhai CLI** >> >> Run the command `ovhai notebook stop ` to stop the Notebook. @@ -354,6 +353,7 @@ You can stop your Quantum Notebook at any time to release its compute resources. >> with client as client: >> response = notebook_stop.sync_detailed(client=client, id=id) >> ``` +>> ### Restarting a stopped Notebook @@ -361,12 +361,12 @@ To restart a stopped Notebook, follow these steps: > [!tabs] > **Using the Control Panel (UI)** ->> +>> >> Go to the Quantum Notebooks board and click on the `...`{.action} button next to the Notebook you want to restart. ->> Click the `Start` button to restart the Notebook. Or, on the notebook board, you can click on the `blue button`{.action} at the top of the page. ->> +Click the `Start` button to restart the Notebook. Or, on the notebook board, you can click on the `blue button`{.action} at the top of the page. +>> >> ![Restart a Notebook Control Panel manager](images/restarting-a-notebook-using-UI.png){.thumbnail} ->> +>> > **Using ovhai CLI** >> >> Run the command `ovhai notebook start ` to restart the Notebook. @@ -403,12 +403,12 @@ The notebook must be stopped before deleting it. To delete a Notebook, follow th > [!tabs] > **Using the Control Panel (UI)** ->> +>> >> Go to the Quantum Notebooks board and click on the `...`{.action} button next to the Notebook you want to delete. >> Click the `Delete`{.action} button to stop the Notebook. Or, on the notebook board, you can click on the `Delete notebook`{.action} button at the bottom of the page. ->> +>> >> ![Delete a Notebook Control Panel manager](images/deleting-a-notebook-using-UI.png){.thumbnail} ->> +>> > **Using ovhai CLI** >> >> Run the command `ovhai notebook delete ` to delete the Notebook. @@ -441,10 +441,10 @@ The notebook must be stopped before deleting it. To delete a Notebook, follow th >> ``` >> -## Going further +## Go further - Discover how to access your Object Storage data and Git repositories from your Notebooks using the UI [here](/pages/public_cloud/ai_machine_learning/notebook_guide_data_ui). -- Learn about the technical features, capabilities, and limitations of the Public Cloud Quantum Notebooks offer [here](/pages/public_cloud/quantum_computing/capabilities). +- Learn about the technical features, capabilities, and limitations of the Public Cloud Quantum Notebooks offering [here](/pages/public_cloud/quantum_computing/capabilities). - Get some hints on how to debug your Notebooks if things go wrong [here](/pages/public_cloud/quantum_computing/troubleshooting). If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](/links/professional-services) to get a quote and ask our Professional Services experts for a custom analysis of your project. @@ -455,4 +455,4 @@ We would love to help answer questions and appreciate any feedback you may have. Please send us your questions, feedback, and suggestions regarding Quantum Notebooks: -- In the #quantum-computing channel of the OVHcloud [Discord server](https://discord.gg/ovhcloud). +- In the #quantum-computing channel of the OVHcloud [Discord server](https://discord.gg/ovhcloud). \ No newline at end of file diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/accessing-a-notebook-using-API.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-API copy.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/accessing-a-notebook-using-API.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-API copy.png diff --git a/pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-API.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-API.png new file mode 100644 index 00000000000..ac292b727c5 Binary files /dev/null and b/pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-API.png differ diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/accessing-a-notebook-using-UI-1.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-UI-1.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/accessing-a-notebook-using-UI-1.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-UI-1.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/accessing-a-notebook-using-UI-2.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-UI-2.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/accessing-a-notebook-using-UI-2.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-UI-2.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/accessing-a-notebook-using-ovhai-CLI.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-ovhai-CLI copy.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/accessing-a-notebook-using-ovhai-CLI.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-ovhai-CLI copy.png diff --git a/pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-ovhai-CLI.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-ovhai-CLI.png new file mode 100644 index 00000000000..804d0fa026d Binary files /dev/null and b/pages/public_cloud/quantum_computing/emulators/getting-started/images/accessing-a-notebook-using-ovhai-CLI.png differ diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-API-01.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-API-01 copy.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-API-01.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-API-01 copy.png diff --git a/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-API-01.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-API-01.png new file mode 100644 index 00000000000..ec2008dc7cc Binary files /dev/null and b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-API-01.png differ diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-01.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-01 copy.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-01.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-01 copy.png diff --git a/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-01.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-01.png new file mode 100644 index 00000000000..4ee3447349c Binary files /dev/null and b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-01.png differ diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-02.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-02.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-02.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-02.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-03.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-03.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-03.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-03.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-04.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-04.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-04.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-04.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-05.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-05.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-05.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-05.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-06.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-06.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-06.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-06.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-07.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-07.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-07.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-07.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-08b.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-08b.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-08b.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-08b.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-09.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-09.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-UI-09.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-UI-09.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-ovhai-CLI.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-ovhai-CLI copy.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/creating-a-notebook-using-ovhai-CLI.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-ovhai-CLI copy.png diff --git a/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-ovhai-CLI.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-ovhai-CLI.png new file mode 100644 index 00000000000..fa4abe5bebd Binary files /dev/null and b/pages/public_cloud/quantum_computing/emulators/getting-started/images/creating-a-notebook-using-ovhai-CLI.png differ diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/deleting-a-notebook-using-API.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/deleting-a-notebook-using-API copy.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/deleting-a-notebook-using-API.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/deleting-a-notebook-using-API copy.png diff --git a/pages/public_cloud/quantum_computing/emulators/getting-started/images/deleting-a-notebook-using-API.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/deleting-a-notebook-using-API.png new file mode 100644 index 00000000000..f89b37e8678 Binary files /dev/null and b/pages/public_cloud/quantum_computing/emulators/getting-started/images/deleting-a-notebook-using-API.png differ diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/deleting-a-notebook-using-UI.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/deleting-a-notebook-using-UI.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/deleting-a-notebook-using-UI.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/deleting-a-notebook-using-UI.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/notebook-authentication-creds.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/notebook-authentication-creds copy.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/notebook-authentication-creds.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/notebook-authentication-creds copy.png diff --git a/pages/public_cloud/quantum_computing/emulators/getting-started/images/notebook-authentication-creds.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/notebook-authentication-creds.png new file mode 100644 index 00000000000..444a85c581f Binary files /dev/null and b/pages/public_cloud/quantum_computing/emulators/getting-started/images/notebook-authentication-creds.png differ diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/notebook-authentication-token.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/notebook-authentication-token copy.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/notebook-authentication-token.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/notebook-authentication-token copy.png diff --git a/pages/public_cloud/quantum_computing/emulators/getting-started/images/notebook-authentication-token.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/notebook-authentication-token.png new file mode 100644 index 00000000000..a18445fdc9c Binary files /dev/null and b/pages/public_cloud/quantum_computing/emulators/getting-started/images/notebook-authentication-token.png differ diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/restarting-a-notebook-using-API.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/restarting-a-notebook-using-API copy.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/restarting-a-notebook-using-API.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/restarting-a-notebook-using-API copy.png diff --git a/pages/public_cloud/quantum_computing/emulators/getting-started/images/restarting-a-notebook-using-API.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/restarting-a-notebook-using-API.png new file mode 100644 index 00000000000..2b142d9244d Binary files /dev/null and b/pages/public_cloud/quantum_computing/emulators/getting-started/images/restarting-a-notebook-using-API.png differ diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/restarting-a-notebook-using-UI.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/restarting-a-notebook-using-UI.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/restarting-a-notebook-using-UI.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/restarting-a-notebook-using-UI.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/stopping-a-notebook-using-API.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/stopping-a-notebook-using-API copy.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/stopping-a-notebook-using-API.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/stopping-a-notebook-using-API copy.png diff --git a/pages/public_cloud/quantum_computing/emulators/getting-started/images/stopping-a-notebook-using-API.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/stopping-a-notebook-using-API.png new file mode 100644 index 00000000000..5974071da32 Binary files /dev/null and b/pages/public_cloud/quantum_computing/emulators/getting-started/images/stopping-a-notebook-using-API.png differ diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/images/stopping-a-notebook-using-UI.png b/pages/public_cloud/quantum_computing/emulators/getting-started/images/stopping-a-notebook-using-UI.png similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/images/stopping-a-notebook-using-UI.png rename to pages/public_cloud/quantum_computing/emulators/getting-started/images/stopping-a-notebook-using-UI.png diff --git a/pages/public_cloud/quantum_computing/getting-started-emulators/meta.yaml b/pages/public_cloud/quantum_computing/emulators/getting-started/meta.yaml similarity index 100% rename from pages/public_cloud/quantum_computing/getting-started-emulators/meta.yaml rename to pages/public_cloud/quantum_computing/emulators/getting-started/meta.yaml diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/guide.en-gb.md b/pages/public_cloud/quantum_computing/qpus/getting-started/guide.en-gb.md new file mode 100644 index 00000000000..ed6dec2b609 --- /dev/null +++ b/pages/public_cloud/quantum_computing/qpus/getting-started/guide.en-gb.md @@ -0,0 +1,461 @@ +--- +title: Quantum computing - Getting started with QPUs Notebooks +excerpt: Learn how to set up a Quantum QPUs Notebook +updated: 2025-11-06 +--- + +> [!warning] +> +> Some links on this documentation refer to the AI and Machine Learning solution. Quantum computing shares the same infrastructure as a service so you might be redirected to another section of this documentation. +> + +## Introduction + +A **Notebook** is a document that integrates code, rich text elements, and multimedia, making it a convenient tool for quantum analysis and visualization. + +**OVHcloud Quantum QPUs** is our managed solution for Jupyter and VS Code Notebooks designed to run jobs on a real Quantum Processing Unit. The notebook still works similarly to an OVHcloud Quantum Emulators notebook, but with a managed token to access a remote QPU. Additional fees will be calculated for the use of this QPU. + +## Objective + +This guide demonstrates how to create, configure, access, stop, restart, and delete a Quantum QPUs Notebook from the **OVHcloud Control Panel (UI)**. This method is user-friendly and ideal for beginners. + +Alternatively, you can use one of the following methods: + +- The **ovhai** command-line interface (CLI) +- The **Quantum API** +- The **ovhai** Python SDK + +Each method offers its distinct advantages, depending on your expertise and preferred workflow. + +## Requirements + +- A [Public Cloud project](/links/public-cloud/public-cloud) in your OVHcloud account. +- Access to the [OVHcloud Control Panel](/links/manager). +- A Public Cloud user with the **Administrator** or **Quantum Operator & Objectstore Operator** roles. + +## Instructions + +### OVHcloud Quantum Solutions authorization process + +If you're using the CLI, API, or SDK, you will need to complete an authorization process before creating a Quantum QPUs Notebook. To do so, follow these steps: + +1. Log in to the [OVHcloud Control Panel](/links/manager) and navigate to the `Public Cloud`{.action} section. +2. Select the Public Cloud project you want to use and click the `Quantum QPUs`{.action} category. +3. Click the `Create a Notebook`{.action} button. The authorization process will take place silently in the background. + +![Create a Notebook Control Panel manager 01](images/creating-a-notebook-using-UI-01.png){.thumbnail} + +### Launch your first Quantum Notebook + +To create a Quantum Notebook, follow these steps: + +> [!tabs] +> **Using the Control Panel (UI)** +>> +>> Navigate to the `Public Cloud`{.action} section of the [OVHcloud Control Panel](/links/manager) and click the `Quantum computing`{.action} category. +>> Click the `Create a Notebook`{.action} button and follow the prompts to specify the configuration of your Quantum Notebook. +>> +>> ![Create a Notebook Control Panel manager 01](images/creating-a-notebook-using-UI-01.png){.thumbnail} +>> +>> **1\. Notebook name** +>> +>> Give a name to your notebook. This will make it easier to manage when you have multiple Quantum Notebooks created. +>> +>> **2\. Notebook location** +>> +>> Next, select a location. +>> +>> ![Create a Notebook Control Panel manager 02](images/creating-a-notebook-using-UI-02.png){.thumbnail} +>> +>> **3\. Compute resources** +>> +>> Specify and adjust the type and amount of computing resources (CPU / GPU) for your Quantum Notebook. Use the `+`{.action} and `-`{.action} buttons to increase or decrease the number of CPUs and GPUs, depending on your needs. +>> +>> Click `Next`{.action}. +>> +>> ![Create a Notebook Control Panel manager 03](images/creating-a-notebook-using-UI-03.png){.thumbnail} +>> +>> **4\. Pre-configured frameworks** +>> +>> Choose the Quantum Python framework you want to use, which will be pre-installed and ready to use when your notebook is launched. Select the version that suits your needs. Then, click `Next`{.action} to continue. +>> +>> ![Create a Notebook Control Panel manager 04](images/creating-a-notebook-using-UI-04.png){.thumbnail} +>> +>> **5\. Live-code editor** +>> +>> Choose the code editor you want. +>> +>> ![Create a Notebook Control Panel manager 05](images/creating-a-notebook-using-UI-05.png){.thumbnail} +>> +>> **6\. Privacy settings** +>> +>> Then, select your privacy settings and click `Next`{.action}. +>> +>> > [!warning] +>> > +>> > *Public access* will expose your data and code to anyone getting the Quantum Notebook link. Be careful not to use it with sensitive data. On the other hand, *Restricted access* will require a user and password combination or a Quantum token to access the Notebook content to ensure a secure environment. +>> +>> ![Create a Notebook Control Panel manager 06](images/creating-a-notebook-using-UI-06.png){.thumbnail} +>> +>> **7\. Advanced configuration** +>> +>> By default, your Quantum Notebook comes with **ephemeral storage** (local storage). But in this step, you can also link Object Storage containers and Git repositories to your notebook to easily access your remote data. +>> +>> If you want to learn more about configuring containers and Git repositories in the Notebook, you can refer to this [AI & Machine learning documentation](/pages/public_cloud/ai_machine_learning/notebook_guide_data_ui). For now, we will launch a classic Notebook without any external volumes added to it. +>> +>> Click `Next`{.action}. +>> +>> ![Create a Notebook Control Panel manager 07](images/creating-a-notebook-using-UI-07.png){.thumbnail} +>> +>> **SSH public keys** allow you to access your Notebook remotely. This section is optional, click `Next`{.action}. +>> +>> **9\. Launch the Quantum Notebook** +>> +>> At the end of the process, review your settings and click the `Order now`{.action} button to confirm and launch the creation of your Notebook. You will be redirected to your notebook dashboard: +>> +>> ![Create a Notebook Control Panel manager 10](images/creating-a-notebook-using-UI-08b.png){.thumbnail} +>> +>> > [!primary] +>> > +>> > Note at the bottom of the screen the equivalent *ovhai* CLI command. This command allows you to run the exact same Notebook using the CLI. +>> > +>> +>> When your Notebook is created, it will appear on your Quantum QPUs tab: +>> +>> ![Create a Notebook Control Panel manager 11](images/creating-a-notebook-using-UI-09.png){.thumbnail} +>> +> **Using ovhai CLI** +>> +>> If you prefer to use the command line interface to launch your Quantum Notebook, please follow these steps: +>> +>> 1. Follow this [AI & Machine learning](/pages/public_cloud/ai_machine_learning/cli_10_howto_install_cli) documentation to install the `ovhai` CLI and log in. +>> 2. Visit this second documentation to learn [how to create your Quantum Notebook using commands](/pages/public_cloud/ai_machine_learning/cli_11_howto_run_notebook_cli). +>> +>> ![Create a Notebook ovhai CLI](images/creating-a-notebook-using-ovhai-CLI.png){.thumbnail} +>> +> **Using the AI Solution API** +>> +>> 1. Create a bearer token from the *ovhai* CLI. For more detailed instructions on creating a token, check the [manage access tokens](/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli) documentation. +>> 2. Navigate to the desired region and follow the instructions to create a Quantum Notebook. +>> - [GRA AI Solution API](https://gra.ai.cloud.ovh.net/#/), for Gravelines, France. +>> - [BHS AI Solution API](https://bhs.ai.cloud.ovh.net/#/), for Beauharnois, Canada. +>> 3. `Submit a new notebook`{.action} POST method +>> +>> > [!warning] +>> > +>> > Make sure to select `Bearer Auth` instead of `OAuth 2.0`, which is selected by default. +>> > +>> +>> ![Create a Notebook API token authentication](images/creating-a-notebook-using-API-01.png){.thumbnail} +>> +> **Using the Python SDK** +>> +>> > [!warning] +>> > +>> > **Alpha version warning**: This package is currently in the **alpha phase** of development. The APIs and functionalities of the package may not be fully tested. +>> +>> 1. Create a bearer token from the *ovhai* CLI. For more detailed instructions on creating a token, check the [manage access tokens](/pages/public_cloud/ai_machine_learning/cli_13_howto_app_token_cli) documentation. +>> 2. Install the `ovhai` Python SDK and follow the instructions in the [ovhai PyPI](https://pypi.org/project/ovhai/) page to create a Quantum Notebook. +>> 3. Finally, open your terminal and run `pip install ovhai`. +>> +>> Here is a basic example of how to do it, making it easy for you to get started: +>> +>> ```python +>> from ovhai import AuthenticatedClient +>> from ovhai.api.notebook import notebook_new +>> from ovhai.models import NotebookSpec, Notebook +>> from ovhai.ovhai_types import Response +>> +>> client = AuthenticatedClient( +>> base_url="https://bhs.ai.cloud.ovh.net", +>> token="YOUR_QUANTUM_TOKEN", +>> ) +>> +>> # Define notebook parameters +>> editor_id = "jupyterlab" +>> framework_id = "pasqal-qpu" +>> framework_version = "1.6.2-py312-cpu" +>> framework_qpu_flavor_id = "orion-beta" +>> nb_cpu = 1 +>> +>> # Create the notebook creation request +>> notebook_specs = { +>> "env": {"editorId": editor_id, "frameworkId": framework_id, "frameworkVersion": framework_version}, +>> "quantumResources": {"qpuFlavorId": framework_qpu_flavor_id}, +>> "resources": {"cpu": nb_cpu}, +>> } +>> +>> with client as client: +>> response: Response[Notebook] = notebook_new.sync_detailed( +>> client=client, body=NotebookSpec.from_dict(notebook_specs) +>> ) +>> +>> import json +>> response_content = response.content.decode('utf-8') # Decode bytes to a string +>> response_dict = json.loads(response_content) +>> +>> status_code = response.status_code +>> id_ = response_dict['id'] +>> spec = response_dict['spec'] +>> status = response_dict['status'] +>> state = status['state'] +>> info = status['info'] +>> url = response_dict['status']['url'] +>> +>> print(f"Status code: {status_code}") +>> print(f"ID: {id_}") +>> print(f"Spec: {spec}") +>> print(f"State: {state}") +>> print(f"Info: {info}") +>> print(f"URL: {url}") +>> ``` +>> + +### Accessing your Quantum Notebook + +Once your Quantum Notebook is created and running, you can access it using the `JupyterLab` link in the Quantum Notebooks board or through the `ovhai` CLI, Quantum API, or Python SDK. + +> [!tabs] +> **Using the Control Panel (UI)** +>> +>> Click the `JupyterLab`{.action} link in the `Access` column: +>> +>> ![Accessing a Notebook Control Panel manager 1](images/accessing-a-notebook-using-UI-1.png){.thumbnail} +>> +>> You can also access the Notebook from its dedicated page: +>> +>> ![Accessing a Notebook Control Panel manager 2](images/accessing-a-notebook-using-UI-2.png){.thumbnail} +>> +>> On the Notebook page, you will find information about the Notebook, including specifications, billing, and attached data, as well as a monitoring URL for real-time metrics. +>> +> **Using ovhai CLI** +>> +>> The `URL` of your Notebook should be displayed in your terminal and you can display it by running `ovhai notebook list` to retrieve the `URL`. +>> +>> ![Access a Notebook ovhai CLI](images/accessing-a-notebook-using-ovhai-CLI.png){.thumbnail} +>> +>> You can also get Notebook information using `ovhai notebook get `. +>> +> **Using the Quantum API** +>> +>> The `URL` of your Notebook should appear in the `Response` panel: +>> +>> ![Access a Notebook API](images/accessing-a-notebook-using-API.png){.thumbnail} +>> +>> If not, use the `Paginated list of notebooks`{.action} GET endpoint method: +>> +>> You can also get Notebook information using the `Get notebook information`{.action} GET endpoint method. +>> +> **Using the Python SDK** +>> +>> Run the following code to list all Quantum Notebooks: +>> +>> ```python +>> from ovhai import AuthenticatedClient +>> from ovhai.api.notebook import notebook_get_all +>> from ovhai.models import NotebookList +>> from ovhai.ovhai_types import Response +>> +>> from ovhai import AuthenticatedClient +>> +>> client = AuthenticatedClient( +>> base_url="https://bhs.ai.cloud.ovh.net", +>> token="YOUR_QUANTUM_TOKEN", +>> ) +>> +>> with client as client: +>> response: Response[NotebookList] = notebook_get_all.sync_detailed(client=client) +>> import json +>> response = json.loads(response.content.decode()) +>> for notebook_info in response["items"]: +>> print(f"ID: {notebook_info['id']}") +>> print(f"Name: {notebook_info['spec']['name']}") +>> print(f"Status: {notebook_info['status']['state']}") +>> print(f"Framework: {notebook_info['spec']['env']['frameworkId']}") +>> print(f"Framework version: {notebook_info['spec']['env']['frameworkVersion']}") +>> print(f"Editor: {notebook_info['spec']['env']['editorId']}") +>> print(f"Access link: {notebook_info['status']['url']}") +>> print("---------------") +>> ``` +>> +>> You can also get Notebook information with this code sample: +>> +>> ```python +>> from ovhai.api.notebook import notebook_get +>> from ovhai import AuthenticatedClient +>> import json +>> +>> client = AuthenticatedClient( +>> base_url="https://bhs.ai.cloud.ovh.net", +>> token="YOUR_QUANTUM_TOKEN", +>> ) +>> id = "YOUR_NOTEBOOK_UUID" +>> +>> with client as client: +>> response = notebook_get.sync_detailed( +>> id=id, client=client +>> ) +>> +>> print(json.loads(response.content.decode())) +>> ``` +>> + +### Connecting to your Quantum Notebook + +To connect to your Quantum Notebook, you'll need to authenticate using a username and password combination or an access token. + +**Using a Username and Password** + +Enter your Public Cloud project user's credentials to log in to your Quantum Notebook. + +![Notebook Authentication Credentials](images/notebook-authentication-creds.png){.thumbnail} + +**Using an Access Token** + +Click the `Login with token` button and enter your access token to log in to your Quantum Notebook. + +![Notebook Authentication Token](images/notebook-authentication-token.png){.thumbnail} + +### Stopping a Quantum Notebook + +You can stop your Quantum Notebook at any time to release its compute resources. This will release its compute resources but will keep your Notebook data and installed libraries. Therefore, you will not incur any further charges for compute unless you restart the Notebook. However, attached storage will be billed at the price of OVHcloud Object Storage (consult the [Quantum Notebooks Billing documentation](/pages/public_cloud/quantum_computing/billing) for more information). To do so, follow these steps: + +> [!tabs] +> **Using the Control Panel (UI)** +>> +>> Go to the Quantum Notebooks board and click on the `...`{.action} button next to the Notebook you want to stop. +Click the `Stop`{.action} button to stop the Notebook. Or, on the notebook board, you can click on the `red button`{.action} at the top of the page. +>> +>> ![Stop a Notebook Control Panel manager](images/stopping-a-notebook-using-UI.png){.thumbnail} +>> +> **Using ovhai CLI** +>> +>> Run the command `ovhai notebook stop ` to stop the Notebook. +>> +>> If you do not know its UUID, remember that you can easily list all your existing Quantum Notebooks by running `ovhai notebook list`. +>> +> **Using the Quantum API** +>> +>> Select the `Stop a running notebook` endpoint and provide the UUID of the Notebook you want to stop. +>> +>> ![Stop a Notebook API](images/stopping-a-notebook-using-API.png){.thumbnail} +>> +> **Using the Python SDK** +>> +>> Use the `notebook_stop` method to stop the Notebook. +>> +>> ```python +>> from ovhai.api.notebook import notebook_stop +>> from ovhai import AuthenticatedClient +>> client = AuthenticatedClient( +>> base_url="https://bhs.ai.cloud.ovh.net", +>> token="YOUR_QUANTUM_TOKEN", +>> ) +>> id = "YOUR_NOTEBOOK_UUID" +>> +>> with client as client: +>> response = notebook_stop.sync_detailed(client=client, id=id) +>> ``` +>> + +### Restarting a stopped Notebook + +To restart a stopped Notebook, follow these steps: + +> [!tabs] +> **Using the Control Panel (UI)** +>> +>> Go to the Quantum Notebooks board and click on the `...`{.action} button next to the Notebook you want to restart. +Click the `Start` button to restart the Notebook. Or, on the notebook board, you can click on the `blue button`{.action} at the top of the page. +>> +>> ![Restart a Notebook Control Panel manager](images/restarting-a-notebook-using-UI.png){.thumbnail} +>> +> **Using ovhai CLI** +>> +>> Run the command `ovhai notebook start ` to restart the Notebook. +>> +> **Using the Quantum API** +>> +>> Select the `Start a stopped notebook` endpoint and provide the UUID of the Notebook you want to restart. +>> +>> ![Restart a Notebook API](images/restarting-a-notebook-using-API.png){.thumbnail} +>> +> **Using the Python SDK** +>> +>> Use the `notebook_start` method to restart the Notebook. +>> +>> ```python +>> from ovhai.api.notebook import notebook_start +>> from ovhai import AuthenticatedClient +>> client = AuthenticatedClient( +>> base_url="https://gra.ai.cloud.ovh.net", +>> token="YOUR_QUANTUM_TOKEN", +>> ) +>> id = "YOUR_NOTEBOOK_UUID" +>> +>> with client as client: +>> response = notebook_start.sync_detailed( +>> id=id, client=client +>> ) +>> ``` +>> + +### Deleting a Notebook + +The notebook must be stopped before deleting it. To delete a Notebook, follow these steps: + +> [!tabs] +> **Using the Control Panel (UI)** +>> +>> Go to the Quantum Notebooks board and click on the `...`{.action} button next to the Notebook you want to delete. +>> Click the `Delete`{.action} button to stop the Notebook. Or, on the notebook board, you can click on the `Delete notebook`{.action} button at the bottom of the page. +>> +>> ![Delete a Notebook Control Panel manager](images/deleting-a-notebook-using-UI.png){.thumbnail} +>> +> **Using ovhai CLI** +>> +>> Run the command `ovhai notebook delete ` to delete the Notebook. +>> +> **Using the Quantum API** +>> +>> Select the `Delete permanently a notebook` endpoint and provide the UUID of the Notebook you want to delete. +>> +>> ![Delete a Notebook API](images/deleting-a-notebook-using-API.png){.thumbnail} +>> +> **Using the Python SDK** +>> +>> Use the `notebook_delete` method to delete the Notebook. +>> ```python +>> from ovhai.api.notebook import notebook_delete +>> from ovhai import AuthenticatedClient +>> +>> client = AuthenticatedClient( +>> base_url="https://gra.ai.cloud.ovh.net", +>> token="YOUR_QUANTUM_TOKEN", +>> ) +>> id = "YOUR_NOTEBOOK_UUID" +>> +>> with client as client: +>> response = notebook_delete.sync_detailed( +>> id=id, client=client, force=False +>> ) +>> +>> print(response.content.decode()) +>> ``` +>> + +## Go further + +- Discover how to access your Object Storage data and Git repositories from your Notebooks using the UI [here](/pages/public_cloud/ai_machine_learning/notebook_guide_data_ui). +- Learn about the technical features, capabilities, and limitations of the Public Cloud Quantum Notebooks offering [here](/pages/public_cloud/quantum_computing/capabilities). +- Get some hints on how to debug your Notebooks if things go wrong [here](/pages/public_cloud/quantum_computing/troubleshooting). + +If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](/links/professional-services) to get a quote and ask our Professional Services experts for a custom analysis of your project. + +## Feedback + +We would love to help answer questions and appreciate any feedback you may have. + +Please send us your questions, feedback, and suggestions regarding Quantum Notebooks: + +- In the #quantum-computing channel of the OVHcloud [Discord server](https://discord.gg/ovhcloud). \ No newline at end of file diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/accessing-a-notebook-using-API.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/accessing-a-notebook-using-API.png new file mode 100644 index 00000000000..7fb4d6a5f60 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/accessing-a-notebook-using-API.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/accessing-a-notebook-using-UI-1.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/accessing-a-notebook-using-UI-1.png new file mode 100644 index 00000000000..022f75d14df Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/accessing-a-notebook-using-UI-1.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/accessing-a-notebook-using-UI-2.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/accessing-a-notebook-using-UI-2.png new file mode 100644 index 00000000000..d5a2400826b Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/accessing-a-notebook-using-UI-2.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/accessing-a-notebook-using-ovhai-CLI.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/accessing-a-notebook-using-ovhai-CLI.png new file mode 100644 index 00000000000..8a964468d20 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/accessing-a-notebook-using-ovhai-CLI.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-API-01.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-API-01.png new file mode 100644 index 00000000000..a3def52a665 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-API-01.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-01 copy.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-01 copy.png new file mode 100644 index 00000000000..c06eba61a67 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-01 copy.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-01.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-01.png new file mode 100644 index 00000000000..c06eba61a67 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-01.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-02.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-02.png new file mode 100644 index 00000000000..0db2843358b Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-02.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-03.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-03.png new file mode 100644 index 00000000000..f516f2a0a84 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-03.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-04.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-04.png new file mode 100644 index 00000000000..f7c0878b6d5 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-04.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-05.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-05.png new file mode 100644 index 00000000000..69f1c544721 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-05.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-06.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-06.png new file mode 100644 index 00000000000..97578660661 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-06.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-07.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-07.png new file mode 100644 index 00000000000..7be561f49b1 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-07.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-08b.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-08b.png new file mode 100644 index 00000000000..34a27f04519 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-08b.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-09.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-09.png new file mode 100644 index 00000000000..03f1607a88d Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-UI-09.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-ovhai-CLI.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-ovhai-CLI.png new file mode 100644 index 00000000000..49d878e33c9 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/creating-a-notebook-using-ovhai-CLI.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/deleting-a-notebook-using-API.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/deleting-a-notebook-using-API.png new file mode 100644 index 00000000000..ad8fb1e3fd8 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/deleting-a-notebook-using-API.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/deleting-a-notebook-using-UI.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/deleting-a-notebook-using-UI.png new file mode 100644 index 00000000000..fb3ed9494fe Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/deleting-a-notebook-using-UI.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/notebook-authentication-creds copy.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/notebook-authentication-creds copy.png new file mode 100644 index 00000000000..444a85c581f Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/notebook-authentication-creds copy.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/notebook-authentication-creds.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/notebook-authentication-creds.png new file mode 100644 index 00000000000..444a85c581f Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/notebook-authentication-creds.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/notebook-authentication-token copy.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/notebook-authentication-token copy.png new file mode 100644 index 00000000000..a18445fdc9c Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/notebook-authentication-token copy.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/notebook-authentication-token.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/notebook-authentication-token.png new file mode 100644 index 00000000000..a18445fdc9c Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/notebook-authentication-token.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/restarting-a-notebook-using-API.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/restarting-a-notebook-using-API.png new file mode 100644 index 00000000000..4bf8f2ed2df Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/restarting-a-notebook-using-API.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/restarting-a-notebook-using-UI.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/restarting-a-notebook-using-UI.png new file mode 100644 index 00000000000..68b72895ab2 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/restarting-a-notebook-using-UI.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/stopping-a-notebook-using-API.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/stopping-a-notebook-using-API.png new file mode 100644 index 00000000000..89d70d8a7af Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/stopping-a-notebook-using-API.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/images/stopping-a-notebook-using-UI.png b/pages/public_cloud/quantum_computing/qpus/getting-started/images/stopping-a-notebook-using-UI.png new file mode 100644 index 00000000000..0d4a61abb07 Binary files /dev/null and b/pages/public_cloud/quantum_computing/qpus/getting-started/images/stopping-a-notebook-using-UI.png differ diff --git a/pages/public_cloud/quantum_computing/qpus/getting-started/meta.yaml b/pages/public_cloud/quantum_computing/qpus/getting-started/meta.yaml new file mode 100755 index 00000000000..f862ec176db --- /dev/null +++ b/pages/public_cloud/quantum_computing/qpus/getting-started/meta.yaml @@ -0,0 +1,2 @@ +id: 652470cf-23b5-46b0-a22d-23036ab087cd +full_slug: public-cloud-quantum-computing-emulator-getting-started \ No newline at end of file