{
  "cells": [
    {
      "cell_type": "markdown",
      "id": "810fe365-8557-46b0-97e7-324b08a1c6e2",
      "metadata": {},
      "source": [
        "---\n",
        "title: \"Monitorar ou cancelar um trabalho\"\n",
        "description: \"Como monitorar ou cancelar um trabalho enviado para IBM Quantum Platform\"\n",
        "---\n",
        "\n",
        "<span id=\"monitor-or-cancel-a-job\" />\n",
        "\n",
        "# Monitorar ou cancelar um trabalho\n",
        "\n",
        "Veja uma lista de suas cargas de trabalho na [página Cargas de trabalho](/workloads).\n",
        "\n",
        "<span id=\"view-job-status\" />\n",
        "\n",
        "## Visualizar Status da Tarefa\n",
        "\n",
        "Vá para a [tabela de cargas de trabalho](/workloads) e verifique na coluna Status se um trabalho foi concluído ou falhou.\n",
        "\n",
        "<span id=\"view-remaining-usage\" />\n",
        "\n",
        "## Ver uso restante\n",
        "\n",
        "Vá para a [tabela Instâncias](/instances) e selecione a guia associada ao plano para o qual você deseja visualizar o uso restante. O tempo total usado e o tempo total restante em seu plano são exibidos.\n",
        "\n",
        "<span id=\"view-metrics-on-number-of-jobs-and-workloads-submitted\" />\n",
        "\n",
        "## Visualizar métricas sobre o número de tarefas e cargas de trabalho enviadas\n",
        "\n",
        "Vá para a [página Analytics](/analytics) para ver o número total de trabalhos enviados, bem como uma contagem de cargas de trabalho em lote e cargas de trabalho de sessão. Observe que você só pode ver a página do Analytics para contas que você possui ou gerencia.\n",
        "\n",
        "<span id=\"monitor-a-job\" />\n",
        "\n",
        "## Monitorar uma tarefa\n",
        "\n",
        "Use a instância do trabalho para verificar o status do trabalho ou recuperar os resultados chamando o comando apropriado:\n",
        "\n",
        "|                                  |                                                                                                                                                                                                                                                              |\n",
        "| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n",
        "| job.result()                     | Revise os resultados do trabalho imediatamente após a conclusão do trabalho. Os resultados do trabalho estão disponíveis após a conclusão do trabalho. Portanto, job.result () é uma chamada de bloqueio até que o trabalho seja concluído.                  |\n",
        "| job.job\\_id()                    | Retorna a ID que identifica exclusivamente esse trabalho. A recuperação dos resultados do trabalho em um momento posterior requer a ID do trabalho. Portanto, é recomendável que você salve as IDs dos trabalhos que talvez queira recuperar posteriormente. |\n",
        "| job.status()                     | Verifique o status da tarefa.                                                                                                                                                                                                                                |\n",
        "| job = service.job ( \\<job\\_id> ) | Recuperar um trabalho que você enviou anteriormente. Essa chamada requer o ID do trabalho.                                                                                                                                                                   |\n",
        "\n",
        "<span id=\"retrieve-later\" />\n",
        "\n",
        "<span id=\"retrieve-job-results-at-a-later-time\" />\n",
        "\n",
        "## Recuperar os resultados do trabalho posteriormente\n",
        "\n",
        "Ligue para `service.job(\\<job\\_id>)` para recuperar um trabalho que você enviou anteriormente. Se você não tiver o ID do trabalho ou se quiser recuperar vários trabalhos de uma só vez, inclusive trabalhos de QPUs (unidades de processamento quântico) desativadas, chame `service.jobs()` com filtros opcionais. Consulte [QiskitRuntimeService.jobs](../api/qiskit-ibm-runtime/qiskit-runtime-service#jobs).\n",
        "\n",
        "<Admonition type=\"note\" title=\"Pacotes de provedores obsoletos\">\n",
        "  `service.jobs()` também retorna trabalhos executados a partir do pacote obsoleto `qiskit-ibm-provider` . Os trabalhos enviados pelo pacote `qiskit-ibmq-provider` mais antigo (também obsoleto) não estão mais disponíveis.\n",
        "</Admonition>\n",
        "\n",
        "<span id=\"example\" />\n",
        "\n",
        "### Exemplo\n",
        "\n",
        "Este exemplo retorna os 10 trabalhos de tempo de execução mais recentes que foram executados em `my_backend`:\n",
        "\n"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "c67f78c5-a199-456a-a9e3-35c518b28f50",
      "metadata": {
        "tags": [
          "version-info"
        ]
      },
      "source": [
        "\n"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 2,
      "id": "03946d0d-aeac-45d7-9e8e-6af38e40e758",
      "metadata": {},
      "outputs": [
        {
          "name": "stdout",
          "output_type": "stream",
          "text": [
            "ExecutionSpans([DoubleSliceSpan(<start='2025-09-09 16:31:16', stop='2025-09-09 16:31:16', size=24>)])\n"
          ]
        }
      ],
      "source": [
        "result = job.result()\n",
        "\n",
        "\n",
        "spans = job.result().metadata[\"execution\"][\"execution_spans\"]\n",
        "print(spans)"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 3,
      "id": "897d35cb-140a-4587-a687-97982a01d846",
      "metadata": {},
      "outputs": [
        {
          "data": {
            "text/plain": [
              "array([[0.2260416 , 0.8747859 , 0.44361995],\n",
              "       [0.94700856, 0.96826017, 0.98426562]])"
            ]
          },
          "execution_count": 3,
          "metadata": {},
          "output_type": "execute_result"
        }
      ],
      "source": [
        "params = np.random.uniform(size=(2, 3))\n",
        "params"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": 4,
      "id": "38176ecc-64fe-4dbb-a9fa-bd0ca2942920",
      "metadata": {},
      "outputs": [
        {
          "data": {
            "text/plain": [
              "array([[[ True,  True,  True,  True],\n",
              "        [ True,  True,  True,  True]],\n",
              "\n",
              "       [[ True,  True,  True,  True],\n",
              "        [ True,  True,  True,  True]],\n",
              "\n",
              "       [[ True,  True,  True,  True],\n",
              "        [ True,  True,  True,  True]]])"
            ]
          },
          "execution_count": 4,
          "metadata": {},
          "output_type": "execute_result"
        }
      ],
      "source": [
        "mask = spans[0].mask(0)\n",
        "mask"
      ]
    },
    {
      "cell_type": "code",
      "execution_count": null,
      "id": "4415838a-04da-4a8e-8fed-4c062d186ec7",
      "metadata": {},
      "outputs": [],
      "source": [
        "from qiskit_ibm_runtime import QiskitRuntimeService\n",
        "\n",
        "# Initialize the account first.\n",
        "service = QiskitRuntimeService()\n",
        "# Use `limit` to retrieve a specific number of jobs. The default `limit` is 10.\n",
        "service.jobs(backend_name=my_backend)"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "59195a9f-8df8-46f7-9ea0-c3a9b8eb3cac",
      "metadata": {},
      "source": [
        "<span id=\"cancel-a-job\" />\n",
        "\n",
        "## Cancelar uma Tarefa\n",
        "\n",
        "Você pode cancelar um trabalho no painel do IBM Quantum Platform na página Workloads (Cargas de trabalho) ou na página de detalhes de uma carga de trabalho específica. Na página Cargas de trabalho, clique no menu de estouro no final da linha dessa carga de trabalho e selecione Cancelar. Se você estiver na página de detalhes de uma carga de trabalho específica, use o menu suspenso Ações na parte superior da página e selecione Cancelar.\n",
        "\n",
        "No Qiskit, use `job.cancel()` para cancelar um trabalho.\n",
        "\n"
      ]
    },
    {
      "cell_type": "markdown",
      "id": "c2abeb3d-4e4a-4c90-be59-16ec0e1be783",
      "metadata": {},
      "source": [
        "<span id=\"next-steps\" />\n",
        "\n",
        "## Próximas etapas\n",
        "\n",
        "<Admonition type=\"tip\" title=\"Recomendações\">\n",
        "  * Experimente o tutorial [do algoritmo de Grover](/docs/tutorials/grovers-algorithm).\n",
        "  * Saiba mais sobre [os intervalos de execução do Sampler](/docs/guides/sampler-input-output#execution-spans)\n",
        "</Admonition>\n",
        "\n"
      ]
    },
    {
      "cell_type": "markdown",
      "metadata": {},
      "id": "a1b8767d",
      "source": "© IBM Corp., 2017-2026"
    }
  ],
  "metadata": {
    "kernelspec": {
      "display_name": "Python 3",
      "language": "python",
      "name": "python3"
    },
    "language_info": {
      "codemirror_mode": {
        "name": "ipython",
        "version": 3
      },
      "file_extension": ".py",
      "mimetype": "text/x-python",
      "name": "python",
      "nbconvert_exporter": "python",
      "pygments_lexer": "ipython3",
      "version": "3"
    }
  },
  "nbformat": 4,
  "nbformat_minor": 4
}