Classes de CAPI em MID Server inclusões de script

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 6 min. de leitura
  • 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:
    Em 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.

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

    Pesquisando MID Server inclusões de script

    Classes de base

    Essas classes de base estão disponíveis por padrão. Eles formam uma base para as classes Azure e 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 básica e registro em log e para coletar informações de proxy no MID Server. Ele também define Cabeçalhos, Parâmetros, endpoints e parâmetro.this .

    AWSSCloudAPIBbase
    Esta classe é estendida do 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 ExecutoAction Método, que é uma implementação da AWS do GET, ou o método Invoke, que fornece chamadas de REST API.
    AzureCloudAPIBase

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

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

    AzureCloudAPIBBase utiliza o. _InvokeRequest Método para fazer chamadas de REST API para o Azure usando as chamadas de REST API padrão.

    Figura 1. APIs de base
    CloudAPIBase

    Classes do Invoker

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

    CloudRestAPIInvoker

    Esta classe é uma classe abstraída 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 getEndpointUrlpara retornar o endpoint de destino, e para getHeaderse. getParameters. Por exemplo, com REST APIs do Azure, a autenticação requer a aprovação de um token como cabeçalho. A extensão que está implementando deve fornecer uma resposta de getHeadersque executa a criação ou recuperação do token e o define. Este objeto base invoca getHeaderse envia o que receber de volta com a solicitação. Esta classe também fornece um getResponsemétodo para lidar com a resposta do provedor de nuvem.

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

    AmazonWebServicesAPIInvoker
    Esta classe é estendida de CloudRestAPIInvokerE fornece métodos para fazer chamadas de REST API para o provedor de nuvem.
    AzureAPIInvoker
    Esta classe é estendida de CloudRestAPIInvokerE fornece funções que fazem estas 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 a chave secreta) e os cabeçalhos/parâmetros.
    • Recupera e decodifica o corpo de resposta JSON do provedor de nuvem.
    AzureEAAPIInvoker
    Esta classe retorna o token de 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 de base são usadas para estender classes específicas da AWS e do Azure:

    Figura 2. Invocando chamadas REST
    CloudRestAPIInvoker

    Exceções

    RESTAPIException
    Esta classe de base lida com exceções que podem ocorrer durante a chamada REST. 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 gera uma exceção de tempo de execução quando necessário durante a invocação da API do Azure.
    Figura 3. Tratamento de exceções
    RESTAPIException

    Classes para credenciais

    CloudRESTRequestSigningUtil

    Esta classe usa substituições especificadas em Substituições de configuração da API de CAPI. . AmazonWebServicesRequestSignera classe estende esta classe. Para o Azure, muitos signatários são integrados ao MID Server Inclusões de script para mapeadores de método nas APIs de CAPI do Azure.

    AmazonWebServicesRequestSigner
    Esta classe configura uma sessão segura para a chamada da REST API obtendo informações sobre uma solicitação e criando um assinatura v4 cadeia de caracteres assinada para a solicitação. Esta classe é estendida de CloudRESTRequestSigningUtil.

    Outras classes do Azure

    Tabela 1. Classes que estendem AzureCloudAPIBCase
    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 máquinas virtuais. 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 Cloud-Init Versões compatíveis: https://docs.microsoft.com/en-us/azure/virtual-machines/linux/using-cloud-init
    AzureDeployment Classe para lidar com a implantação do modelo do Azure ARM.
    AzureDeploymentOperation Classe para lidar com a operação de implantação do modelo do Azure ARM.
    AzureImages Classe para manipular imagens do Azure.
    AzureLoadBalancer Classe para lidar com chamadas de API do Azure em balanceadores de carga. Consulte: https://msdn.microsoft.com/en-us/library/azure/mt163651.aspx
    AzureLocalNetworkways Classe para criar e recuperar gateways de rede local.
    AzureNetworkNIC Classe para lidar com chamadas de API do Azure em 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 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 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 redes virtuais.
    AzureProvider Classe para obter detalhes do provedor do Azure, como URL e versão do provedor.
    AzureRegion 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 incompatíveis ou excluir recursos.
    AzureResourceGroupManager Classe para lidar com grupos de recursos do Azure ARM.
    AzureResponseUtil Classe para traduzir 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
    AzureSubscription Classe para buscar assinaturas do Azure.
    AzureVirtualNetworkways Classe para criar e manipular gateways de rede virtual.
    AzureCloudEAAPIBase Objeto base para manipuladores de API do EA do Azure. Azure EA APIs têm um 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
    AmazonImages

    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 manipular chamadas de API da AWS para criar e manipular Grupos de escalonamento automático .

    AWSSCloudFormation Manipulador para chamadas de API do AWS CloudFormation.
    AWSEC2 Manipulador para chamadas de API do AWS EC2.
    AWSKeyValuePair Classe para importar e manipular pares de chaves.
    AWSLaunchConfigurations Classe auxiliar.
    AWSS3 Manipulador para chamadas de API do AWS S3.
    AWSOpics Classe com Tópicos da AWS .