Explorar as APIs REST OpenStack for PowerVC

Faça uma interface com as APIs REST OpenStack do IBM PowerVC Express Edition e simplifique o gerenciamento de recurso virtual

IBM® Power® Virtualization Center Express Edition (PowerVC) é uma solução de nuvem de Infraestrutura como Serviço (IaaS) concebida para facilitar o desenvolvimento e o gerenciamento de recursos virtuais em um Ambiente Definido por Software Power Systems ou uma infraestrutura em nuvem. Baseia-se principalmente em OpenStack® e inclui interfaces de programação de aplicativo OpenStack padrão de mercado. Saiba mais sobre as APIs para cada componente do OpenStack e as tarefas que as APIs podem ajudá-lo a concluir.

Cholleti Ramyasree, Software Engineer, IBM

Cholleti Ramyasree é engenheiro de software na IBM India Pvt. Ltd., atualmente trabalha com PowerVC, tendo quatro anos de experiência na tecnologia, e possui bacharelado em ciência da computação pela Universidade JNTU em Hyderabad, Índia.



22/Jan/2016

O IBM Power Virtualization Center Express Edition (PowerVC) é uma solução de nuvem de Infraestrutura como Serviço baseada em OpenStack para a plataforma IBM Power concebida para simplificar o gerenciamento de recursos virtuais em um ambiente Power Systems. O PowerVC consiste em serviços de GUI e HTTP RESTful (na forma de APIs) que executam tarefas de gerenciamento virtual para seu Power System. Este artigo destaca as APIs REST for PowerVC Express Edition e fornece uma breve descrição de cada uma, o que deve proporcionar um entendimento de como gerenciar os recursos virtuais do Power por meio de serviços da web.

Visão geral do PowerVC

O PowerVC é uma solução de nuvem de IaaS desenvolvida com tecnologia de projeto OpenStack e concebida para simplificar o gerenciamento de recursos virtuais em um ambiente Power Systems. Usa as interfaces de comunidade de software livre padrão de mercado do OpenStack.

O PowerVC reside entre ferramentas de interface estilo console e a oferta de infraestrutura como serviço (IaaS) IBM SmartCloud; ferramentas como: 

  • IBM Hardware Management Console (HMC), um kernel Linux® usando BusyBox que fornece uma interface padrão para configurar e operar sistemas particionados (também conhecidos como sistema LPAR ou virtualizado) e SMP (como o Power).
  • O IBM Integrated Virtualization Manager (IVM), uma ferramenta baseada em navegador que literalmente permite que os clientes apontem, cliquem e consolidem diferentes cargas de trabalho virtuais em um Power System sem necessitar de um dispositivo como o HMC para gerenciar LPARs em um único sistema.
  • A Kernel-based Virtual Machine (KVM), um hypervisor de software livre que fornece desempenho e escalabilidade de classe corporativa, além de segurança para executar cargas de trabalho de Windows® e Linux. O KVM transforma o kernel Linux em um hypervisor bare-metal que pode acessar o suporte à virtualização de hardware integrado no hardware do processador.

O PowerVC traz os recursos das APIs OpenStack para o gerenciamento de recurso em nuvem do Power. Foi concebido para ajudar os usuários a desenvolver dinamicamente uma infraestrutura com suporte para um Ambiente Definido por Software (SDE) ou infraestrutura em nuvem. A interface do PowerVC fornece suporte para o gerenciamento de sistemas operacionais RHEL, SLES e AIX® em hardware Power ao permitir o registro de hosts físicos, provedores de armazenamento e recursos de rede com os quais é possível implementar e capturar máquinas virtuais. Algumas das tarefas com as quais o PowerVC ajuda incluem:

  • Implementar imagens para criar novas máquinas virtuais
  • Redimensionar e anexar volumes a essas novas imagens
  • Capturar as máquinas virtuais existentes
  • Importar máquinas virtuais e volumes existentes para que possam ser gerenciados pelo IBM PowerVC
  • Iniciar operações de iniciar/parar/reinicializar/excluir em máquinas virtuais criadas ou máquinas virtuais gerenciadas
  • Monitorar a utilização dos recursos que estão no seu ambiente
  • Fornecer suporte à migração de máquinas virtuais durante a execução (ou "migração a quente")

O PowerVC captura automaticamente as informações de gerenciamento a seguir:

  • Configuração de host/hypervisor existente, incluindo informações sobre a partição VIOS
  • Configurações de CPU, memória e E/S para as definições da máquina virtual existente em um host Power
  • Definições de volume existentes nos controladores de armazenamento suportados
  • Informações de zoneamento existentes nos comutadores SAN suportados

O PowerVC permite capturar e gerenciar uma biblioteca de imagens de VM, facilitando a implementação rápida de um ambiente de VM ao ativar uma imagem armazenada desse ambiente em vez de precisar recriar um ambiente específico manualmente. Ao salvar e centralizar imagens virtuais, é possível migrar as imagens e implementar aplicativos nelas rapidamente.

Também é possível criar grupos de recursos necessários para dar suporte às cargas de trabalho.

O IBM PowerVC está disponível em duas edições:

  • IBM PowerVC Express Edition: Para ambientes de entrada em que os hosts de máquina virtual são sistemas Power 7, Power 7+ e Power 8 gerenciados pelo IVM
  • IBM PowerVC Standard Edition: Para ambientes de virtualização de classe corporativa em que os hosts de máquina virtual são servidores Power 6, Power 7, Power 7+ e Power 8 gerenciados pela KKVM de Power e HMC

A seção a seguir apresenta as APIs do OpenStack Express Edition e uma API do validador específica do PowerVC, assim como seus propósitos. Embora existam algumas APIs REST adicionais que são específicas de Power Systems gerenciados por ferramentas HMC e KVM, não falarei sobre elas neste artigo.


APIs REST OpenStack e APIs do validador do PowerVC

Os itens a seguir são APIs de componentes do OpenStack e a API do validador do PowerVC que é possível usar para gerenciamento de recurso virtual via PowerVC em um Power System (neste exemplo, no PowerVC Express Edition). Cada API é categorizada pelo componente do OpenStack e vem com uma definição do componente e do subcomponente que a API aborda, o propósito da API, o comando operacional utilizado para ativar a API e a solicitação e o corpo de resposta de cada API.

Componente: Keystone

Keystone é um projeto do OpenStack que fornece serviços de Identidade, Token, Catálogo e Política para uso especificamente por projetos na família OpenStack. Implementa a API de Identidade do OpenStack.

Obtenha os arquivos de solicitação de amostra e corpo de resposta do Keystone.

Keystone v3: Tokens

Um token é um pedaço de texto arbitrário utilizado para acessar recursos. Cada token possui um escopo que descreve quais recursos são acessíveis com ele. Um token poderá ser revogado a qualquer momento e é válido por uma duração finita.

  • https://<powervc-ip>/powervc/openstack/identity/v3/auth/tokens
    Propósito: Produz um token de autenticação e um catálogo de serviços quando credenciais são fornecidas e o token de autenticação é gerado por meio do cabeçalho de retorno X-Subject-Token.
    Operação: POST
    Códigos de resposta normal: 201, 200(OK)
    Códigos de resposta de erro: identityFault (400, 500, …), 401, 404, 409, badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)
  • https://<powervc-ip>/powervc/openstack/identity/v3/auth/tokens
    Propósito: Valida o token de autenticação especificado pelo cabeçalho X-Subject-Token e também produz o catálogo de serviços. O token de autenticação atual precisa ser especificado por meio do cabeçalho da solicitação X-Auth-Token.
    Operação: GET
    Códigos de resposta normal: 200(OK), 203
    Códigos de resposta de erro: identityFault (400, 500, …), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)
  • https://<powervc-ip>/powervc/openstack/identity/v3/auth/tokens
    Propósito: Validação rápida do token de autenticação. Nenhum catálogo de serviços. 204 informa que o token é válido.
    Operação: HEAD
    Códigos de resposta normal: 204
    Códigos de resposta de erro: identityFault (400, 500, …), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)
    Corpo de resposta de amostra: Esta operação não produz um corpo de resposta.
  • https://<powervc-ip>/powervc/openstack/identity/v3/auth/tokens
    Propósito: Invalida imediatamente o token de acesso.
    Operação: DELETE
    Códigos de resposta normal: 204
    Códigos de resposta de erro: identityFault (400, 500, …), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)
    Corpo de resposta de amostra: Esta operação não produz um corpo de resposta.

Keystone v3: Usuários

É possível obter a lista de usuários do Keystone e seu usuários associados usando estas APIs:

  • https://<powervc-ip>/powervc/openstack/identity/v3/users
    Propósito: Recupera a lista de usuários.
    Operação: GET
    Códigos de resposta normal: 200
    Códigos de resposta de erro: identityFault (400, 500, …), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)
  • https://<powervc-ip>/powervc/openstack/identity/v3/users/user_id
    Propósito: Recupera um usuário específico.
    Operação: GET
    Códigos de resposta normal: 200
    Códigos de resposta de erro: identityFault (400, 500, …), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)
  • https://<powervc-ip>/powervc/openstack/identity/v3/users/user_id/groups
    Propósito: Lista os grupos dos quais o usuário é membro.
    Operação: GET
    Códigos de resposta normal: 200
    Códigos de resposta de erro: identityFault (400, 500, …), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)

Keystone v3: Grupos

É possível obter a lista de grupos do Keystone e seu usuários associados usando estas APIs:

  • https://<powervc-ip>/powervc/openstack/identity/v3/groups
    Propósito: Recupera a lista de grupos do Keystone.
    Operação: GET
    Códigos de resposta normal: 200
    Códigos de resposta de erro: identityFault (400, 500, …), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)
  • https://<powervc-ip>/powervc/openstack/identity/v3/groups/group_id
    Propósito: Recupera um grupo específico.
    Operação: GET
    Códigos de resposta normal: 200
    Códigos de resposta de erro: identityFault (400, 500, …), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)
  • https://<powervc-ip>/powervc/openstack/identity/v3/groups/group_id/users
    Propósito: Lista os usuários que são membros do grupo especificado.
    Operação: GET
    Códigos de resposta normal: 200
    Códigos de resposta de erro: identityFault (400, 500, …), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)

Keystone v3: Funções IBM

Uma função é uma personalidade que um usuário assume ao executar um conjunto específico de operações. Uma função inclui um conjunto de direitos e privilégios. Um usuário que assume a função herda tais direitos e privilégios.

  • https://<powervc-ip>/powervc/openstack/identity/v3/ibm-roles/users
    Propósito: Recupera a lista de usuários com concessões de função do PowerVC.
    Operação: GET
    Códigos de resposta normal: 200
    Códigos de resposta de erro: identityFault (400, 500, …), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)
  • https://<powervc-ip>/powervc/openstack/identity/v3/ibm-roles/groups
    Propósito: Recupera a lista de grupos com concessões de função do PowerVC.
    Operação: GET
    Códigos de resposta normal: 200
    Códigos de resposta de erro: identityFault (400, 500, …), badRequest (400), unauthorized (401), forbidden (403), badMethod (405), overLimit (413), serviceUnavailable (503), itemNotFound (404)

Componente: Nova

Nova é o nome do projeto para o OpenStack Compute, um controlador de malha de computação em nuvem, a parte principal de um sistema de IaaS. Gerencia o ciclo de vida e as operações dos recursos de cálculo.

Obtenha os arquivos de solicitação de amostra e corpo de resposta do Nova.

Servidores Nova

É possível gerenciar servidores virtuais utilizando estas APIs:

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/servers
    Propósito: Cria um novo servidor virtual ou máquina virtual.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/servers
    Propósito: Obtém uma lista de servidores virtuais.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/servers/detail
    Propósito: Obtém detalhes sobre todos os servidores virtuais.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/servers/server_id
    Propósito: Obtém detalhes sobre um servidor virtual especificado.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/servers/server_id
    Propósito: Exclui um servidor virtual especificado.
    Operação: DELETE
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
    Nenhuma solicitação ou corpo de resposta
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/servers/server_id/action
    Propósito: Redimensiona o servidor especificado. Especifique a ação resize no corpo solicitado.
    Propósito: Confirma uma ação de redimensionamento pendente. Especifique a ação confirmResize no corpo solicitado.
    Propósito: Migração ativa de um servidor para um novo host sem reinicializar. Especifique a ação os-migrateLive no corpo da solicitação.
    Propósito: Interrompe um servidor em execução e muda seu status para STOPPED. Especifique a ação os-stop no corpo da solicitação.
    Propósito: Inicia um servidor interrompido e muda seu status para ACTIVE. Especifique a ação os-start no corpo da solicitação.
    Propósito: Reinicializa o servidor especificado. Especifique a ação reboot no corpo solicitado.
    Propósito: Criar uma nova imagem ao capturar a máquina virtual.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)

Anexos de volume do Nova

É possível anexar e remover os volumes de armazenamento de e para um servidor virtual utilizando estas APIs:

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/servers/server_id/os-volume_attachments
    Propósito: Anexa um volume ao servidor especificado.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/servers/server_id/os-volume_attachments
    Propósito: Lista os anexos de volume para o servidor especificado.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/servers/server_id/os-volume_attachments/attachment_id
    Propósito: Lista os detalhes de volume para o ID do anexo de volume especificado.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/servers/server_id/os-volume_attachments/attachment_id
    Propósito: Remove o anexo de volume especificado do anexo do servidor especificado.
    Operação: DELETE
    Código de resposta normal: No Content (204), 202(Accepted)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
    Nenhuma solicitação ou corpo de resposta

Extensões do Nova

É possível obter a lista e detalhes de todas as extensões disponíveis nos servidores:

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/extensions
    Propósito: Lista todas as extensões disponíveis.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/extensions/{alias}
    Propósito: Obtém detalhes sobre uma extensão específica. As extensões permitem a introdução de novos recursos na API sem exigir uma mudança de versão; também permitem a introdução de uma funcionalidade específica do fornecedor.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)

Tipos do Nova

É possível gerenciar os tipos de servidor virtual (modelos de hardware virtual definindo tamanhos para RAM, disco, número de núcleos, etc.) usando estas APIs:

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/flavors
    Propósito: Cria um novo tipo.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/flavors
    Propósito: Obtém uma lista de tipos.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/flavors/detail
    Propósito: Obtém uma lista de tipos com detalhes.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/flavors/detail/flavor_id
    Propósito: Obtém detalhes de um tipo especificado.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/flavors/detail/flavor_id
    Propósito: Exclui o ID do tipo especificado.
    Operação: DELETE
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
    Nenhuma solicitação ou corpo de resposta

Especificações de tipo adicional do Nova

Permite gerenciar especificações adicionais de tipos de servidor virtual existentes (como configurar o mínimo e o máximo do processador virtual ou da memória e configurar um processador compartilhado ou dedicado).

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/flavors/flavor_id/os-extra_specs
    Propósito: Lista especificações adicionais ou as chaves para o tipo especificado.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/flavors/flavor_id/os-extra_specs
    Propósito: Cria especificações adicionais ou as chaves para o tipo especificado.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/flavors/flavor_id/os-extra_specs/key_id
    Propósito: Obtém o valor da chave especificada.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/flavors/flavor_id/os-extra_specs/key_id
    Propósito: Exclui uma especificação adicional especificada por chave.
    Operação: DELETE
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
    Nenhuma solicitação ou corpo de resposta

Hosts do Nova

Registra e cancela o registro de hosts do Power no PowerVC.

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-hosts
    Propósito: Lista todos os hosts.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-hosts/host_name
    Propósito: Descreve um host especificado.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-hosts
    Propósito: Registra um novo host de cálculo.
    Operação: POST
    Código de resposta normal: OK (200)
    Código de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-hosts/host_name
    Propósito: Cancela o registro de um host de cálculo.
    Operação: DELETE
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
    Nenhuma solicitação ou corpo de resposta
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-hosts/host_name/update-registration
    Propósito: Registra novamente um host de cálculo.
    Operação: PUT
    Código de resposta normal: OK (200)
    Código de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)

Hypervisors do Nova

É possível obter as informações de hypervisor dos servidores gerenciados por PowerVC usando estas APIs:

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-hypervisors
    Propósito: Lista as informações de hypervisor por servidor.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-hypervisors/detail
    Propósito: Lista os detalhes dos hypervisors gerenciados pela instalação do OpenStack.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-hypervisors/hypervisor_id
    Propósito: Fornece informações detalhadas sobre um hypervisor específico.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-hypervisors/hypervisor_id/servers
    Propósito: Lista servidores de hypervisor ou máquinas virtuais.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)

Imagens do Nova

É possível gerenciar imagens do servidor virtual usando estas APIs:

  • https://<powervc-ip>/powervc/openstack/image/v2/tenant_id/images
    Propósito: Lista todas as imagens.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/image/v2/tenant_id/images/detail
    Propósito: Lista todas as imagens com detalhes.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/image/v2/tenant_id/images/image_id
    Propósito: Lista os detalhes da imagem especificada.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/image/v2/tenant_id/images/image_id
    Propósito: Exclui a imagem especificada.
    Operação: DELETE
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
    Nenhuma solicitação ou corpo de resposta

Limites do Nova

É possível obter os detalhes de limites configurados para contas de usuário usando esta API:

  • https://<powervc-ip>/powervc/openstack/image/v2/tenant_id/limits
    Propósito: Produz os limites atuais para a conta.
    Operação: GET
    Código de resposta normal: OK (200), 203
    Códigos de resposta de erro: Not Found (404), Server Error (500)

Políticas de localização do Nova

É possível obter a lista e modificar os atributos das políticas de localização utilizando estas APIs:

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/ego/policy/placement
    Propósito: Lista todas as políticas.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/ego/policy/placement/policy_id
    Propósito: Lista uma política específica.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/ego/policy/placement/policy_id
    Propósito: Modifica os atributos editáveis da política específica.
    Operação: PUT
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)

Pares de chaves do Nova

É possível gerenciar os pares de chaves associados com contas de usuário do servidor virtual usando estas APIs:

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-keypairs
    Propósito: Lista pares de chaves associados com a conta.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-keypairs
    Propósito: Gera ou importa um par de chaves.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-keypairs/keypair_name
    Propósito: Exclui um par de chaves especificado.
    Operação: DELETE
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
    Nenhuma solicitação ou corpo de resposta
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-keypairs/keypair_name
    Propósito: Mostra o par de chaves associado com a conta.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)

Onboarding do servidor virtual do Nova

Para um maior alcance do gerenciamento, é possível importar servidores virtuais para o PowerVC que são criados fora dele.

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-hosts/hostname/all-servers
    Propósito: Recupera uma lista de todas as máquinas virtuais que estão em um host específico (gerenciado e não).
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-hosts/hostname/onboard
    Propósito: Importa uma ou mais máquinas virtuais para um host específico para serem gerenciadas pelo PowerVC.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-hosts/hostname/unmanage
    Propósito: Remove uma ou mais máquinas virtuais para um host para não serem mais gerenciadas pelo PowerVC.
    Operação: DELETE
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)

Adaptadores Ethernet compartilhados de host do Nova

É possível listar os adaptadores Ethernet compartilhados designados a um único host, todos os hosts ou aqueles que têm o mesmo UUID e ID VLAN utilizando estas APIs:

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-seas
    Propósito: Lista todos os SEAs do host.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-seas/host_id
    Propósito: Lista os SEAs do host específicos em determinado host.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-seas/host_id?vlanid=<VLANID>
    Propósito: Lista SEAs do host específicos passando um ID VLAN.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-seas?vlanid=<VLANID>
    Propósito: Lista todos os SEAs do host passando um ID VLAN que corresponde ao PVID de um SEA.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-seas?network_id=<network_id>
    Propósito: Lista todos os SEAs do host passando um UUID de rede.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-seas?network_id=<network_id>&vlanid=<VLAN ID>
    Propósito: Lista todos os SEAs do host passando um UUID de rede e um ID VLAN.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)

Mapeamento de rede de host do Nova

É possível obter a lista de mapeamentos de rede existentes e também criar e atualizar o mapeamento de rede no host utilizando estes APIs:

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-network-mapping
    Propósito: Lista mapeamentos de rede.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-network-mapping?network_id=<network_id>
    Propósito: Lista mapeamentos de rede por ID de rede.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-network-mapping/host_id
    Propósito: Lista mapeamentos de rede para um host específico.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-network-mapping/host_id?network_id=<network_id>
    Propósito: Lista mapeamentos de rede para um host e um ID de rede específicos.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-network-mapping
    Propósito: Cria um mapeamento de rede.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
    Amostra de resposta: 200(OK)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-network-mapping
    Propósito: Modifica o mapeamento de rede.
    Operação: PUT
    Código de resposta normal: No Content (204), 200(OK)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
    Amostra de resposta: 200(OK)

Localização da rede de host do Nova

É possível obter a lista de localizações de rede possíveis para hosts especificados, assim como obter a lista de hosts, que podem fornecer suporte à localização da VLAN especificada.

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-network-placement
    Propósito: Lista possíveis localizações de rede para todos os hosts.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-network-placement?network_id=<network_id>
    Propósito: Lista hosts que podem fornecer suporte à rede especificada.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/host-network-placement/host_name
    Propósito: Lista possíveis localizações de rede para o host especificado.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)

Uso do Nova

É possível obter estatísticas de uso (como uso de CPU, memória e rede) por host e por conta do usuário usando estas APIs:

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-simple-tenant-usage
    Propósito: Visualizar o uso para todos os proprietários.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-simple-tenant-usage/tenant_id
    Propósito: Recuperar o uso para um proprietário.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)

Cotas do Nova

É possível obter informações sobre cotas alocadas e atualizá-las para as contas de usuário.

  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-quota-sets/tenant_id
    Propósito: Mostra cotas para um proprietário.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-quota-sets/tenant_id
    Propósito: Atualiza cotas para um proprietário.
    Operação: PUT
    Código de resposta normal: No Content (204), OK(200)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/compute/v2/tenant_id/os-quota-sets/tenant_id/defaults
    Propósito: Recupera cotas padrão.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)

Componente: Cinder

Cinder é o projeto do OpenStack para gerenciar o armazenamento de bloco.

Obtenha os arquivos de solicitação de amostra e corpo de resposta do Cinder.

Volumes Cinder

É possível gerenciar volumes de armazenamento usando estas APIs:

  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/volumes
    Propósito: Para criar um volume.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/volumes
    Propósito: Para visualizar uma lista de volumes.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/volumes/detail
    Propósito: Para visualizar uma lista de volumes com seus detalhes.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/volumes?data_volumes
    Propósito: Para visualizar uma lista de volumes de dados.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/volumes/detail?data_volumes
    Propósito: Para visualizar uma lista de volumes de dados com seus detalhes.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/volumes/volume_id
    Propósito: Para visualizar todas as informações de um único volume.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/volumes/volume_id
    Propósito: Para atualizar um volume específico.
    Operação: PUT
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/volumes/volume_id
    Propósito: Para excluir um único volume.
    Operação: DELETE
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500) Nenhuma solicitação ou corpo de resposta
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/volumes/volume_id/restricted_metadata
    Propósito: Para visualizar metadados restritos de volume.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/volumes/volume_id/restricted_metadata
    Propósito: Para modificar metadados restritos de volume.
    Operação: PUT
    Código de resposta normal: 200(OK)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/volumes/volume-id/restricted_metadata/{key}
    Propósito: Para excluir um volume de metadados restritos de volume.
    Operação: DELETE
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500) Nenhuma solicitação ou corpo de resposta

Hosts Cinder

É possível configurar provedores de armazenamento no PowerVC usando estas APIs:

  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/os-hosts/host_name/connect
    Propósito: Produz uma lista de conjuntos de armazenamento.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/os-hosts
    Propósito: Registra um novo host Cinder.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/os-hosts
    Propósito: Lista todos os hosts Cinder.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/os-hosts/host_name
    Propósito: Descreve um host específico.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/os-hosts/host_name
    Propósito: Cancela o registro de um host Cinder.
    Operação: DELETE
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
    Nenhuma solicitação ou corpo de resposta
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/os-hosts/host_name/update-registration
    Propósito: Registra novamente um host Cinder.
    Operação: PUT
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)

Onboarding de volume Cinder

É possível importar volumes de armazenamento que não são gerenciados pelo PowerVC utilizando estas APIs:

  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/os-hosts/host_name/all-volumes
    Propósito: Fornece uma lista de todos os volumes que estão em um provedor de armazenamento específico.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/os-hosts/host_name/onboard
    Propósito: Gerencia volumes existentes de um provedor de armazenamento.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/os-hosts/host_name/unmanage
    Propósito: Volumes não gerenciados que são gerenciados atualmente pelo PowerVC.
    Operação: POST
    Código de resposta normal: No Content (204)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)

Provedores de armazenamento Cinder

É possível obter as métricas e o status de provedores de armazenamento existentes no PowerVC.

  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/storage-providers
    Propósito: Fornece uma lista do status/métricas do provedor de armazenamento.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/storage-providers/detail
    Propósito: Fornece detalhes de status/métricas para todos os provedores de armazenamento.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/storage-providers/provider_id
    Propósito: Fornece detalhes de status/métricas para um provedor de armazenamento específico.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)

Expansão de volume Cinder

É possível redimensionar os volumes de armazenamento usando esta API:

  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/volumes/volume_id
    Propósito: Amplia/redimensiona um volume quando o volume anexado tem o status In-Use.
    Operação: POST
    Código de resposta normal: OK (200)
    Código de resposta de erro: Bad Request (400), Server Error (500)

Extensões Cinder

É possível obter a lista e os detalhes de todas as extensões disponíveis em um volume de armazenamento:

  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/extensions
    Propósito: Lista as extensões disponíveis.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/{alias}
    Propósito: Obtém detalhes sobre a extensão especificada.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)

Tipos de Cinder

É possível gerenciar os tipos de volume de armazenamento usando estas APIs:

  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/types
    Propósito: Cria um tipo de volume.
    Operação: POST
    Código de resposta normal: OK (200)
    Código de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/types
    Propósito: Lista o tipo de volume.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/types/volume_type_id
    Propósito: Mostra as informações de um tipo de volume especificado.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/types/volume_type_id
    Propósito: Atualiza um tipo de volume.
    Operação: PUT
    Código de resposta normal: 200, 202, 204
    Códigos de resposta de erro: 403
  • https://<powervc-ip>/powervc/openstack/volume/v1/tenant_id/types/volume_type_id
    Propósito: Exclui um tipo de volume.
    Operação: DELETE
    Código de resposta normal: 202, 204
    Códigos de resposta de erro: 403
    Esta operação não produz um corpo de resposta.

Componente: Glance

Glance é um serviço de imagem que fornece serviços de descoberta, registro e entrega para imagens do disco virtual.

Obtenha os arquivos de solicitação de amostra e corpo de resposta do Glance.

Imagens Glance

É possível gerenciar imagens (criar/excluir/atualizar/listar/obter detalhes/download) usando estes serviços RESTful:

  • https://<powervc-ip>/powervc/openstack/image/v2/images
    Propósito: Cria uma imagem.
    Operação: POST
    Código de resposta normal: OK (200)
    Código de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/image/v2/images
    Propósito: Obtém uma lista de imagens às quais o proprietário tem acesso.
    Operação: GET
    Código de resposta normal: OK (200), Accepted (202)
    Códigos de resposta de erro: Not Found (404), Server Error (500), Forbidden (403)
  • https://<powervc-ip>/powervc/openstack/image/v2/images/image_id
    Propósito: Obtém detalhes da imagem especificada.
    Operação: GET
    Código de resposta normal: OK (200), Accepted (202)
    Códigos de resposta de erro: Not Found (404), Server Error (500), Forbidden (403)
  • https://<powervc-ip>/powervc/openstack/image/v2/images/image_id
    Propósito: Atualiza uma imagem especificada.
    Operação: PATCH
    Códigos de resposta normal: 200
  • https://<powervc-ip>/powervc/openstack/image/v2/images/image_id
    Propósito: Exclui uma imagem especificada.
    Operação: DELETE
    Código de resposta normal: 204
    Códigos de resposta de erro: 403
    Esta operação não produz um corpo de resposta.
  • https://<powervc-ip>/powervc/openstack/image/v2/images/image_id/file
    Propósito: Faz o download de dados de imagem binários.
    Operação: GET
    Códigos de resposta normal: 200, 204
    Esta operação não produz um corpo de resposta.
  • https://<powervc-ip>/powervc/openstack/image/v2/images/image_id/file
    Propósito: Faz o upload de dados de imagem binários.
    Operação: PUT
    Códigos de resposta normal: 204
    Esta operação não produz um corpo de resposta.

Componente: Neutron

Neutron é o serviço de gerenciamento de rede para o OpenStack.

Obtenha os arquivos de solicitação de amostra e corpo de resposta do Neutron.

Redes Neutron

É possível gerenciar a rede (criar/excluir/modificar/listar) usando estes serviços RESTful:

  • https://<powervc-ip>/powervc/openstack/network/v2/networks
    Propósito: Cria uma nova rede Neutron.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/network/v2/networks/network_id
    Propósito: Atualiza a rede especificada.
    Operação: PUT
    Código de resposta normal: 200(OK)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/network/v2/networks/network_id
    Propósito: Exclui a rede especificada.
    Operação: DELETE
    Código de resposta normal: 204
    Códigos de resposta de erro: 403
    Esta operação não produz um corpo de resposta .
  • https://<powervc-ip>/powervc/openstack/network/v2/networks
    Propósito: Fornece um resumo de todas as redes definidas no Neutron.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/network/v2/networks/network_id
    Propósito: Lista informações detalhadas para a rede especificada.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)

Sub-redes Neutron

É possível gerenciar sub-redes utilizando estes serviços RESTful:

  • https://<powervc-ip>/powervc/openstack/network/v2/subnets
    Propósito: Cria uma sub-rede na rede especificada.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/network/v2/subnets/subnet_id
    Propósito: Atualiza a sub-rede especificada.
    Operação: PUT
    Código de resposta normal: 200(OK)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/network/v2/subnets/subnet_id
    Propósito: Remove a sub-rede especificada.
    Operação: DELETE Código de resposta normal: 204
    Códigos de resposta de erro: 403
    Esta operação não produz um corpo de resposta .
  • https://<powervc-ip>/powervc/openstack/network/v2/subnets
    Propósito: Lista todas as sub-redes que são acessíveis para o proprietário que envia a solicitação.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/network/v2/subnets/subnet_id
    Propósito: Fornece informações detalhadas para uma sub-rede especificada.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)

Portas Neutron

É possível gerenciar portas de rede utilizando estes serviços RESTful:

  • https://<powervc-ip>/powervc/openstack/network/v2/tenant_id/ports
    Propósito: Cria uma porta na rede especificada.
    Operação: POST
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/network/v2/tenant_id/ports
    Propósito: Lista as portas às quais o proprietário tem acesso.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/network/v2/tenant_id/ports/port_id
    Propósito: Mostra informações para uma porta especificada.
    Operação: GET
    Código de resposta normal: OK (200)
    Códigos de resposta de erro: Bad Request (400), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/network/v2/tenant_id/ports/port_id
    Propósito: Atualiza uma porta especificada.
    Operação: PUT
    Código de resposta normal: 200(OK)
    Códigos de resposta de erro: Bad Request (400), Not Found (404), Server Error (500)
  • https://<powervc-ip>/powervc/openstack/network/v2/tenant_id/ports/port_id
    Propósito: Exclui uma porta especificada.
    Operação: DELETE
    Código de resposta normal: 204
    Códigos de resposta de erro: 403
    Esta operação não produz um corpo de resposta .

O componente de serviço do PowerVC: Validador

Este serviço valida o ambiente PowerVC existente e exibe resultados que podem ser úteis para corrigir o ambiente PowerVC configurado.

Obtenha os arquivos de solicitação de amostra e corpo de resposta do Validator.

  • https://<powervc-ip>/powervc/openstack/validation/v1/validation
    Propósito: Inicia a execução da validação.
    Operação: GET
    Código de resposta normal: OK (200), Accepted (202) (quando a validação inicia no backend)
    Códigos de resposta de erro: Not Found (404), Server Error (500), Forbidden (403) (quando uma validação já está em execução em segundo plano)
  • https://<powervc-ip>/powervc/openstack/validation/v1/validation/result
    Propósito: Exibe os resultados da execução de validação anterior concluída.
    Operação: GET
    Código de resposta normal : OK (200), Accepted (202) (quando a validação inicia no backend)
    Códigos de resposta de erro: Not Found (404), Server Error (500), Forbidden (403) (quando uma validação já está em execução em segundo plano)

Conclusão

Espero que este guia de consulta rápida para o uso das APIs de gerenciamento de recurso virtual do OpenStack via PowerVC Express Edition ajude a tornar suas tarefas de gerenciamento de nuvem mais fáceis e mais rápidas.


Downloads

DescriçãoNomeTamanho
Cinder API sample request and response filesCinder.zip341KB
Glance API sample request and response filesGlance.zip51KB
Keystone API sample request and response filesKeystone.zip137KB
Neutron API sample request and response filesNeutron.zip158KB
Nova API sample request and response filesNova.zip792KB
Validator API sample request and response filesValidator.zip28KB

Recursos

Aprender

Obter produtos e tecnologias

Discutir

  • Participe da comunidade do PowerVC e faça parte das discussões sobre métodos avançados para o gerenciamento de recursos na nuvem.
  • Participe da comunidade do developerWorks. Conecte-se com outros usuários do developerWorks enquanto explora os blogs, fóruns, grupos e wikis orientados pelo desenvolvedor.

Comentários

developerWorks: Conecte-se

Los campos obligatorios están marcados con un asterisco (*).


Precisa de um ID IBM?
Esqueceu seu ID IBM?


Esqueceu sua senha?
Alterar sua senha

Ao clicar em Enviar, você concorda com os termos e condições do developerWorks.

 


A primeira vez que você entrar no developerWorks, um perfil é criado para você. Informações no seu perfil (seu nome, país / região, e nome da empresa) é apresentado ao público e vai acompanhar qualquer conteúdo que você postar, a menos que você opte por esconder o nome da empresa. Você pode atualizar sua conta IBM a qualquer momento.

Todas as informações enviadas são seguras.

Elija su nombre para mostrar



Ao se conectar ao developerWorks pela primeira vez, é criado um perfil para você e é necessário selecionar um nome de exibição. O nome de exibição acompanhará o conteúdo que você postar no developerWorks.

Escolha um nome de exibição de 3 - 31 caracteres. Seu nome de exibição deve ser exclusivo na comunidade do developerWorks e não deve ser o seu endereço de email por motivo de privacidade.

Los campos obligatorios están marcados con un asterisco (*).

(Escolha um nome de exibição de 3 - 31 caracteres.)

Ao clicar em Enviar, você concorda com os termos e condições do developerWorks.

 


Todas as informações enviadas são seguras.


static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=80
Zone=Cloud computing, Software livre, Linux
ArticleID=977960
ArticleTitle=Explorar as APIs REST OpenStack for PowerVC
publish-date=01222016