Classes de CAPI em MID Server inclusões de script

Cloud Provisioning and Governance fornece várias classes JavaScript que fazem chamadas REST para provedores de nuvem. Essas classes são chamadas de MID Server inclusões de script (para Azure por padrão) ou de chamadas Java no sistema (para AWS por padrão). Se você criar provedores personalizados, interfaces ou APIs de CAPI (para qualquer provedor de nuvem), poderá usar MID Server inclusões de script para chamar as classes.

Nota:

Nas APIs de CAPI, não há MID Server inclusões de script (em mapeadores de método) que você pode personalizar para chamar as classes da AWS. Por padrão, as APIs de CAPI para AWS fazem chamadas Java para, em seguida, chamar as classes da AWS. No entanto, se você criar APIs de CAPI, também poderá criar inclusões de script personalizadas para chamar as classes.

Exibir classes de CAPI navegando até MID Servers > Inclusões de script na interface de instância sistema base (não o Portal de Administração de Nuvem). Você pesquisa o nome de uma classe na caixa de pesquisa Ir para usando a coluna Nome :

Classes base

Essas classes base estão disponíveis por padrão. Eles formam uma base para as classes do Azure e da AWS que fazem as chamadas REST reais.

CloudAPIBase

CloudAPIBase é uma API independente de provedor que se comunica com todos os tipos de APIs de nuvem. Ele fornece funções para depuração e registro em log básicos e para coletar informações de proxy no MID Server. Ele também define Cabeçalhos, Parâmetros, Endpoints e this.parameter.

AWSCloudAPIBase

Esta classe é estendida de CloudAPIBase e fornece funções que chamam o invocador para fazer solicitações GET, PUT, POST e DELETE. A classe fornece a opção de um método executeAction, que é uma implementação de GET da AWS, ou o método de invocação, que fornece chamadas de REST API.

AzureCloudAPIBase

Esta classe é estendida de CloudAPIBase e fornece funções que executam estas ações:

• Buscar IDs de recurso.
• Buscar propriedades do endpoint.
• Listar recursos.
• Chame o invocador para fazer solicitações GET, PUT, POST e DELETE.

AzureCloudAPIBase utiliza o método _invokeRequest para fazer chamadas de REST API para o Azure usando as chamadas de REST API padrão.

Figura 1. APIs de base

Classes do invocador

As classes de invocador executam as chamadas REST reais para o provedor de nuvem. Se você criar uma interface e API de CAPI personalizadas, deverá estender CloudRestAPIInvoker para criar suas chamadas REST.

CloudRestAPIInvoker

Esta classe é uma classe abstrata para fazer chamadas de REST API. Se houver cabeçalhos e/ou parâmetros a serem enviados com uma solicitação, as classes que implementam o invocador deverão estender este objeto. Eles também devem fornecer substituições para getEndpointUrl retornar o endpoint de destino e para getHeaders e getParameters. Por exemplo, com as REST APIs do Azure, a autenticação requer a passagem de um token como um cabeçalho. A extensão que a implementa deve fornecer uma resposta de getHeaders que executa a criação ou a recuperação do token e o define. Este objeto base invoca getHeaders e envia tudo o que recebe de volta com a solicitação. Esta classe também fornece um método getResponse para lidar com a resposta do provedor de nuvem.

Se você criar uma API CAPI personalizada, deverá estender CloudRestAPIInvoker para fazer chamadas REST para o provedor de nuvem.

AmazonWebServicesAPIInvoker

Esta classe é estendida de CloudRestAPIInvoker e fornece métodos para fazer chamadas de REST API para o provedor de nuvem.

AzureAPIInvoker

Esta classe é estendida de CloudRestAPIInvoker e fornece funções que fazem essas chamadas de REST API para o Azure Resource Manager:

• Define a entidade de serviço, os cabeçalhos e os parâmetros para chamadas REST.
• Obtém a URL do endpoint, o token (ID do cliente, ID do locatário e chave secreta) e cabeçalhos/parâmetros.
• Recupera e decodifica o corpo da resposta JSON do provedor de nuvem.

AzureEAAPIInvoker

Esta classe retorna o token para acesso à REST API do Azure Enterprise Agreement (EA).

AzureStorageAPIInvoker

Esta classe faz chamadas REST para armazenamento do Azure. As funções nesta classe podem obter o token, a resposta, os cabeçalhos e os parâmetros.

Este gráfico ilustra como essas classes base são usadas para estender classes específicas da AWS e do Azure:

Figura 2. Invocar chamadas REST

Exceções

RESTAPIExceção

Esta classe base lida com exceções que podem ocorrer durante a chamada REST. Ele retorna o código de resposta do provedor de nuvem.

AWSAPIException

Esta classe lida com exceções que podem ocorrer durante a chamada REST.

AzureAPIException

Esta classe lança uma exceção de tempo de execução quando necessário durante a invocação da API do Azure.

Figura 3. Manipulação de exceções

Classes para credenciais

CloudRESTRequestSigningUtil

Esta classe usa substituições especificadas em Substituições de configuração de API de CAPI. A classe AmazonWebServicesRequestSigner estende esta classe. Para o Azure, muitos signatários são incorporados às inclusões de script MID Server para mapeadores de método nas APIs de CAPI do Azure.

AmazonWebServicesRequestSigner

Esta classe configura uma sessão segura para a chamada de REST API, coletando informações sobre uma solicitação e criando uma cadeia de caracteres de assinatura v4-signed para a solicitação. Esta classe é estendida de CloudRESTRequestSigningUtil.

Outras classes do Azure

Tabela 1. Classes que estendem AzureCloudAPIBase

Classe	Descrição
AzureAlertRule	Classe para criar e excluir regras de alerta do Azure.
AzureAuthorizationPolicy	Classe para atribuir políticas de marcador.
AzureComputeAvailabilitySet	Classe para buscar conjuntos de disponibilidade do Azure. Consulte: https://docs.microsoft.com/en-us/rest/api/compute/availabilitysets
AzureComputeHardware	Classe para buscar tamanhos do Azure. Consulte: https://docs.microsoft.com/en-us/rest/api/compute/virtualmachinesizes
AzureComputeImage	Classe para lidar com chamadas de API do Azure em relação à imagem. Consulte: https://docs.microsoft.com/en-us/rest/api/manageddisks/images/images-rest-api
AzureComputeVirtualMachine	Classe para lidar com chamadas de API do Azure em relação a máquinas virtuais. Consulte: https://docs.microsoft.com/en-us/rest/api/compute/virtualmachines Tamanho e capacidades da VM: https://docs.microsoft.com/en-us/azure/virtual-machines/virtual -machines-windows-sizes https://docs.microsoft.com/en-us/azure/virtual-machines/virtual-machines-linux-sizes Versões compatíveis com Cloud-Init: https://docs.microsoft.com/en -us/azure/virtual-machines/linux/using-cloud-init
Azureimplantação	Classe para lidar com a implantação do modelo ARM do Azure.
AzureDeploymentOperation	Classe para lidar com a operação de implantação do modelo ARM do Azure.
AzureImages	Classe para lidar com imagens do Azure.
AzureLoadBalancer	Classe para lidar com chamadas de API do Azure em relação a balanceadores de carga. Consulte: https://msdn.microsoft.com/en-us/library/azure/mt163651.aspx
AzureLocalNetworkGateways	Classe para criar e recuperar gateways de rede local.
AzureNetworkNIC	Classe para lidar com chamadas de API do Azure em relação aos cartões de interface de rede. Consulte: https://msdn.microsoft.com/en-us/library/azure/mt163579.aspx
AzureNetworkPublicIP	Classe para lidar com chamadas de API do Azure em relação a endereços IP públicos. Consulte: https://msdn.microsoft.com/en-us/library/azure/mt163638.aspx
AzureNetworkRouter	Classe para lidar com chamadas de API do Azure em relação à tabela de rotas. Consulte: https://docs.microsoft.com/en-us/rest/api/network/route-tables
AzureNetworkSecurityGroup	Classe para lidar com chamadas de API do Azure em relação aos cartões de interface de rede. Consulte: https://msdn.microsoft.com/en-us/library/azure/mt163579.aspx
AzureNetworkVirtualNetwork	Classe para lidar com chamadas de API do Azure em relação a redes virtuais.
AzureProvider	Classe para obter detalhes do provedor do Azure, como a URL e a versão do provedor.
Região do Azure	Classe para buscar regiões do Azure.
AzureResource	Lida com o objeto referenciado por ObjectID nos parâmetros. Ele também busca a versão da API. Esta classe destina-se principalmente a obter tipos sem suporte ou excluir recursos.
AzureResourceGroupManager	Classe para lidar com grupos de recursos do ARM do Azure.
AzureResponseUtil	Classe para converter a resposta da API do Azure em objeto DTO.
AzureStorageAccount	Classe para lidar com chamadas de API do Azure em relação à conta de armazenamento. Consulte: //https://msdn.microsoft.com/en-us/library/azure/mt163638.aspx
AzureStorageBlob	Classe para criar e manipular contêineres de armazenamento e blobs.
AzureStorageManagedDisk	Classe para lidar com chamadas de API do Azure em relação ao disco gerenciado. Consulte: https://docs.microsoft.com/en-us/rest/api/manageddisks/disks/disks-create-or-update
Assinatura do Azure	Classe para buscar assinaturas do Azure.
AzureVirtualNetworkGateways	Classe para criar e manipular gateways de rede virtual.
AzureCloudEAAPIBase	Objeto base para manipuladores de API do EA do Azure. As APIs do EA do Azure têm uma URL base de https://consumption.azure.com e exigem o número de inscrição no caminho. Esta classe lida com o empacotamento dos parâmetros EnrollmentNumber e EnrollmentToken.

Outras classes da AWS

Classe	Descrição
Imagens da Amazon	Classe para lidar com imagens de máquina da Amazon. http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html
AmazonResponseProcessorUtil	Classe para lidar com a resposta da REST API da AWS.
AWSAutoScalingGroups	Classe para lidar com chamadas de API da AWS para criar e manipular grupos de escalonamento automático.
AWSCloudFormation	Manipulador para chamadas de API do AWS CloudFormation.
AWSEC2	Manipulador para chamadas de API do EC2 da AWS.
AWSKeyValuePair	Classe para importar e manipular pares de chaves.
AWSLaunchConfigurations	Classe auxiliar.
AWSS3	Manipulador para chamadas de API do AWS S3.
Tópicos da AWS	Classe com tópicos da AWS.