Contas
Obter configuração de conta
Obtenha as informações da conta corrente. Se nenhuma informação de conta for encontrada, retorna a configuração padrão.
Autorização
Para chamar esse método, deve-se ter sido designado a uma ou mais funções de acesso do IAM que incluam as ações a seguir. É possível verificar seu acesso indo para Users > User > Access
quantum-computing.account-configuration.read
Auditoria
A chamada desse método gera os seguintes eventos de auditoria.
quantum-computing.account-configuration.read
Entrada
Nome, Tipo | Descrição |
|---|---|
id Necessário string | ID da conta (sem o prefixo |
Nome, Tipo | Descrição |
|---|---|
plan_id string | Obter a configuração da conta somente para o plano especificado |
Amostras de código
GET
/v1/accounts/{id} Se sua instância estiver na região eu-de, use este link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/accounts/{id}
curl -X GET \
'https://quantum.cloud.ibm.com/api/v1/accounts/{id}' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR-TOKEN' \
-H 'Service-CRN: YOUR-SERVICE-CRN' \
-H 'IBM-API-Version: 2026-04-15' Se sua instância estiver na região eu-de, use este link: URL: https://eu-de.quantum.cloud.ibm.com/api/v1/accounts/{id}
import requests
response = requests.request(
"GET",
"https://quantum.cloud.ibm.com/api/v1/accounts/{id}",
headers={
"Accept": "application/json",
"IBM-API-Version": "2026-04-15",
"Authorization": "Bearer YOUR-TOKEN",
"Service-CRN": "YOUR-SERVICE-CRN"
},
)
print(response.json())Saída
Código de status | Descrição |
|---|---|
| 200 | Configuração da conta recuperada com sucesso |
| 400 | Solicitação inválida |
| 401 | Desautorizado |
| 404 | Não encontrado |
| 500 | Erro interno |
Respostas
{
"plans": [
{
"plan_id": "flex-plan-id-1",
"subscription_id": "53bde9d3-cdbb-46f5-a98f-60ebcadf7260",
"subscription_name": "flex",
"usage_allocation_seconds": 200,
"usage_limit_seconds": 200,
"unallocated_usage_seconds": 200,
"backends": [
"ibm_backend"
],
"max_ttl": 28800,
"active_ttl": 28800,
"interactive_ttl": 60,
"start_time": "2025-05-17T00:00:00Z",
"end_time": "2026-05-17T00:00:00Z"
},
{
"plan_id": "plan-id-2",
"subscription_id": "52fde9d3-cdbb-46f5-a98f-60ebchdf7260",
"subscription_name": "open",
"usage_allocation_seconds": 150,
"usage_limit_seconds": 300,
"unallocated_usage_seconds": 10,
"backends": [
"backend1",
"backend2"
]
},
{
"plan_id": "plan-id-3",
"subscription_id": "91b2c828-2952-4f05-aed8-bedf92c6c480",
"subscription_name": "internal",
"backends": [
"backend1",
"backend2"
]
}
]
}{
"type": "object",
"description": "Configuração de uma conta gerenciada pelo serviço IBM Qiskit Runtime.",
"properties": {
"plans": {
"description": "A lista de configurações da conta por plano",
"type": "array",
"items": {
"allOf": [
{
"type": "object",
"properties": {
"plan_id": {
"type": "string",
"description": "O ID do plano, conforme definido no Catálogo Global",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"subscription_id": {
"type": "string",
"description": "O ID da assinatura para identificar cada contrato de plano em uma conta",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 36
},
"subscription_name": {
"type": "string",
"description": "O nome legível pelo usuário da assinatura",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"usage_allocation_seconds": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "A soma máxima da alocação de uso permitida em todas as instâncias da conta. Obrigatório quando plan_id se refere a um plano flexível."
},
"usage_limit_seconds": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "O tempo máximo durante o qual as cargas de trabalho podem ser executadas em todas as instâncias da conta para o plano especificado. Obrigatório quando plan_id se refere a um plano flexível."
},
"backends": {
"type": "array",
"description": "Lista de back-ends para permitir que a conta atribua para instâncias.",
"items": {
"type": "string",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 128
},
"minItems": 0,
"maxItems": 100
},
"max_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "O tempo máximo (em segundos) para a execução da sessão, sujeito aos limites do plano."
},
"active_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "O tempo restante (em segundos) para a sessão estar no estado ativo enquanto os trabalhos estão em execução. Deve ser menor ou igual ao ttl máximo."
},
"interactive_ttl": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "O tempo máximo (em segundos) entre os trabalhos para manter a sessão ativa. Deve ser menor ou igual ao ttl ativo."
},
"start_time": {
"type": "string",
"format": "date-time",
"description": "Data de início dos planos com contrato. Obrigatório quando plan_id se refere a um plano flexível."
},
"end_time": {
"type": "string",
"format": "date-time",
"description": "Data de término dos planos com contrato. Obrigatório quando plan_id se refere a um plano flexível."
},
"functions": {
"type": "array",
"description": "Funcionalidades disponíveis para este plano de conta. Cada entrada especifica um ID de função, um modelo de cobrança e o conjunto de ações permitidas. Ao contrário da configuração no nível da instância, `[\"ANY\"]` não é um valor válido — as funções devem ser listadas explicitamente.",
"items": {
"type": "object",
"description": "Uma função disponível para um plano de contas.",
"properties": {
"provider": {
"type": "string",
"description": "O nome do provedor da função.",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256,
"example": "ibm"
},
"name": {
"type": "string",
"description": "O nome da função, exclusivo dentro de um provedor.",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256,
"example": "circuit-function"
},
"business_model": {
"type": "string",
"description": "O modelo de negócios no âmbito do qual a função é oferecida.",
"enum": [
"trial",
"subsidized",
"consumption"
]
},
"permissions": {
"type": "array",
"description": "Ações no estilo IAM concedidas para esta função.",
"items": {
"type": "string",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256
},
"minItems": 1,
"maxItems": 2147483647,
"example": [
"function.run"
]
}
},
"required": [
"provider",
"name",
"business_model",
"permissions"
]
},
"minItems": 0,
"maxItems": 2147483647
},
"custom_functions": {
"type": "object",
"description": "Direito a funções personalizadas configurado em um plano de conta.",
"properties": {
"permissions": {
"type": "array",
"description": "Ações disponíveis para funções personalizadas.",
"items": {
"type": "string",
"pattern": "^.+$",
"minLength": 1,
"maxLength": 256
},
"minItems": 1,
"maxItems": 2147483647,
"example": [
"function-custom.run"
]
}
},
"required": [
"permissions"
]
}
},
"required": [
"backends",
"plan_id",
"subscription_id",
"subscription_name"
]
},
{
"type": "object",
"properties": {
"unallocated_usage_seconds": {
"type": "integer",
"format": "int32",
"minimum": 0,
"maximum": 2147483647,
"description": "A alocação de uso restante que ainda pode ser alocada para instâncias."
}
}
}
]
},
"minItems": 0,
"maxItems": 20
}
},
"required": [
"plans"
]
}Esta página foi útil?
Relate um bug, erro de digitação ou solicite conteúdo no GitHub.