MID 서버 스크립트 포함의 CAPI 클래스

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기10분

    • 클라우드 프로비저닝 및 거버넌스는 클라우드 제공자에 대해 REST 호출을 수행하는 여러 JavaScript 클래스를 제공합니다. 이러한 클래스는 MID 서버 스크립트 포함(기본적으로 Azure의 경우) 또는 시스템의 Java 호출(기본적으로 AWS의 경우)에서 호출됩니다. 모든 클라우드 제공자에 대해 사용자 지정 제공자, 인터페이스 또는 CAPI API를 만드는 경우 MID 서버 스크립트 포함을 사용하여 클래스를 호출할 수 있습니다.

    주:
    CAPI API에는 AWS 클래스를 사용자 지정하여 호출할 수 있는 MID 서버 스크립트 포함(메서드 매퍼에 있음)이 없습니다. 기본적으로 AWS에 대한 CAPI API는 Java 호출을 수행한 다음 AWS 클래스를 호출합니다. 그러나 CAPI API를 만드는 경우에는 사용자 지정 스크립트 포함을 만들어 클래스를 호출할 수도 있습니다.

    다음으로 이동하여 CAPI 클래스 보기 MID 서버 > 스크립트 포함 기본 시스템 인스턴스 인터페이스에서( 아님 클라우드 관리자 포털). 이름 열을 사용하여 이동 검색 상자에서 클래스 이름을 검색합니다.

    MID 서버 스크립트 포함 검색

    기본 클래스

    기본적으로 이러한 기본 클래스를 사용할 수 있습니다. 이러한 기본 클래스는 실제 REST 호출을 수행하는 Azure 및 AWS 클래스의 기초를 형성합니다.

    CloudAPIbase

    CloudAPIBase는 제공자와 상관없이 모든 유형의 클라우드 API와 통신하는 API입니다. 기본 디버깅 및 로깅을 위한 기능과 MID 서버에 대한 프록시 정보를 수집하는 기능을 제공합니다. 또한 헤더, 매개변수, 엔드포인트 및 this.parameter를 정의합니다.

    AWSCloudAPIBase
    이 클래스는 CloudAPIBase에서 확장되며 호출자를 호출하여 GET, PUT, POST 및 DELETE 요청을 수행하는 기능을 제공합니다. 이 클래스는 GET의 AWS 구현인 executeAction 메서드 또는 REST API 호출을 제공하는 호출 메서드 옵션을 제공합니다.
    AzureCloudAPIBase

    이 클래스는 CloudAPIBase에서 확장되며 다음 작업을 수행하는 기능을 제공합니다.

    • 자원 ID를 가져옵니다.
    • 엔드포인트 속성을 가져옵니다.
    • 자원을 나열합니다.
    • 호출자에게 GET, PUT, POST 및 DELETE 요청을 수행하도록 요청합니다.

    AzureCloudAPIBase에서는 _invokeRequest 메서드를 활용하여 표준 REST API 호출을 사용하여 Azure에 대한 REST API 호출을 수행합니다.

    그림 1. 기본 API
    CloudAPIbase

    호출자 클래스

    호출자 클래스는 클라우드 제공자에 대한 실제 REST 호출을 수행합니다. 사용자 지정 CAPI 인터페이스와 API를 만드는 경우 CloudRestAPIInvoker를 확장하여 REST 호출을 만들어야 합니다.

    CloudRestAPIInvoker

    이 클래스는 REST API 호출을 수행하기 위해 추상화된 클래스입니다. 요청과 함께 보낼 헤더 및/또는 매개변수가 있는 경우 호출자를 구현 하는 클래스가 이 객체를 확장해야 합니다. 또한 대상 엔드포인트를 반환할 getEndpointUrl과 getHeaders 및 getParameters를 재정의해야 합니다. 예를 들어, Azure REST API의 경우 인증하려면 토큰을 헤더로 전달해야 합니다. 이를 구현하는 확장에서는 토큰 생성 또는 검색을 수행하는 getHeaders의 응답을 제공하고 설정합니다. 이 기본 객체는 getHeaders를 호출하여 요청과 함께 되돌아오는 것을 모두 보냅니다. 또한 이 클래스는 클라우드 제공자의 응답을 처리하는 getResponse 메서드를 제공합니다.

    사용자 지정 CAPI API를 만드는 경우 CloudRestAPIInvoker를 확장하여 클라우드 제공자에 대해 REST 호출을 수행해야 합니다.

    AmazonWebServicesAPIInvoker
    이 클래스는 CloudRestAPIInvoker에서 확장되며 클라우드 제공자에 대해 REST API 호출을 수행하는 메서드를 제공합니다.
    AzureAPIInvoker
    이 클래스는 CloudRestAPIInvoker에서 확장되며 Azure 자원 관리자에 대해 이러한 REST API 호출을 수행하는 기능을 제공합니다.
    • REST 호출에 대한 서비스 원칙, 헤더 및 매개변수를 설정합니다.
    • 엔드포인트 URL, 토큰(클라이언트 ID, 테넌트 ID 및 비밀 키) 및 헤더/매개변수를 가져옵니다.
    • 클라우드 제공자의 JSON 응답 본문을 검색하고 디코딩합니다.
    AzureEAAPIInvoker
    이 클래스는 Azure Enterprise Agreement(EA) REST API에 접근할 수 있는 토큰을 반환합니다.
    AzureStorageAPIInvoker
    이 클래스는 Azure 저장소에 대한 REST 호출을 수행합니다. 이 클래스의 함수는 토큰, 응답, 헤더 및 매개변수를 가져올 수 있습니다.

    이 그래픽은 AWS 특정 클래스와 Azure 특정 클래스를 확장하기 위해 이러한 기본 클래스를 사용하는 방법을 보여줍니다.

    그림 2. REST 호출 호출
    CloudRestAPIInvoker

    예외

    RESTAPIException
    이 기본 클래스는 REST 호출 중에 발생할 수 있는 예외를 처리합니다. 클라우드 제공자의 응답 코드를 반환합니다.
    AWSAPIException
    이 클래스는 REST 호출 중에 발생할 수 있는 예외를 처리합니다.
    AzureAPIException
    이 클래스는 Azure API 호출 중에 필요한 경우 런타임 예외를 발생시킵니다.
    그림 3. 예외 처리
    RESTAPIException

    자격 증명에 대한 클래스

    CloudRESTRequestSigningUtil

    이 클래스는 CAPI API Config 재정의에 지정된 재정의를 사용합니다. AmazonWebServicesRequestSigner 클래스가 이 클래스를 확장합니다. Azure의 경우 Azure CAPI API의 메서드 매퍼에 대한 MID 서버 스크립트 포함에 여러 서명자가 빌드되어 있습니다.

    AmazonWebServicesRequestSigner
    이 클래스는 요청 정보를 가져오고 요청에 대해 서명 v4가 서명된 문자열을 만들어 REST API 호출에 대한 보안 세션을 설정합니다. 이 클래스는 CloudRESTRequestSigningUtil에서 확장됩니다.

    기타 Azure 클래스

    표 1. AzureCloudAPIBase를 확장하는 클래스
    클래스 설명
    AzureAlertRule Azure 경보 규칙을 만들고 삭제하는 클래스입니다.
    AzureAuthorizationPolicy 태그 정책을 할당하는 클래스입니다.
    AzureComputeAvailabilitySet Azure 가용성 세트를 가져오는 클래스입니다. 참조: https://docs.microsoft.com/en-us/rest/api/compute/availabilitysets
    AzureComputeHardware Azure 크기를 가져오는 클래스입니다. 참조: https://docs.microsoft.com/en-us/rest/api/compute/virtualmachinesizes
    AzureComputeImage 이미지에 대한 Azure API 호출을 처리하는 클래스입니다. 참조: https://docs.microsoft.com/en-us/rest/api/manageddisks/images/images-rest-api
    AzureComputeVirtualMachine 가상 머신에 대한 Azure API 호출을 처리하는 클래스입니다. 참조: https://docs.microsoft.com/en-us/rest/api/compute/virtualmachines VM Size and Capacities: 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 supported Versions: https://docs.microsoft.com/en-us/azure/virtual-machines/linux/using-cloud-init
    AzureDeployment Azure ARM 템플릿 배포를 처리하는 클래스입니다.
    AzureDeploymentOperation Azure ARM 템플릿 배포 작업을 처리하는 클래스입니다.
    AzureImages Azure 이미지를 처리하는 클래스입니다.
    AzureLoadBalancer 부하 분산 장치에 대한 Azure API 호출을 처리하는 클래스입니다. 참조: https://msdn.microsoft.com/en-us/library/azure/mt163651.aspx
    AzureLocalNetworkGateways 로컬 네트워크 게이트웨이를 만들고 검색하는 클래스입니다.
    AzureNetworkNIC 네트워크 인터페이스 카드에 대한 Azure API 호출을 처리하는 클래스입니다. 참조: https://msdn.microsoft.com/en-us/library/azure/mt163579.aspx
    AzureNetworkPublicIP 공용 IP 주소에 대한 Azure API 호출을 처리하는 클래스입니다. 참조: https://msdn.microsoft.com/en-us/library/azure/mt163638.aspx
    AzureNetworkRouter 경로 테이블에 대한 Azure API 호출을 처리하는 클래스입니다. 참조: https://docs.microsoft.com/en-us/rest/api/network/route-tables
    AzureNetworkSecurityGroup 네트워크 인터페이스 카드에 대한 Azure API 호출을 처리하는 클래스입니다. 참조: https://msdn.microsoft.com/en-us/library/azure/mt163579.aspx
    AzureNetworkVirtualNetwork 가상 네트워크에 대한 Azure API 호출을 처리하는 클래스입니다.
    AzureProvider 제공자 URL 및 버전과 같은 Azure 제공자 상세 정보를 가져오는 클래스입니다.
    AzureRegion Azure 지역을 가져오는 클래스입니다.
    AzureResource 매개변수에서 ObjectID에 의해 참조되는 객체를 처리합니다. 또한 API 버전을 가져옵니다. 이 클래스는 주로 지원되지 않는 유형을 가져오거나 자원을 삭제하기 위한 것입니다.
    AzureResourceGroupManager Azure ARM 자원 그룹을 처리하는 클래스입니다.
    AzureResponseUtil Azure API 응답을 DTO 객체로 번역하는 클래스입니다.
    AzureStorageAccount 저장소 계정에 대한 Azure API 호출을 처리하는 클래스입니다. 참조: //https://msdn.microsoft.com/en-us/library/azure/mt163638.aspx
    AzureStorageBlob 저장소 컨테이너 및 blob을 만들고 조작하는 클래스입니다.
    AzureStorageManagedDisk 관리되는 디스크에 대한 Azure API 호출을 처리하는 클래스입니다. 참조: https://docs.microsoft.com/en-us/rest/api/manageddisks/disks/disks-create-or-update
    AzureSubscription Azure 구독을 가져오는 클래스입니다.
    AzureVirtualNetworkGateways 가상 네트워크 게이트웨이를 만들고 조작하는 클래스입니다.
    AzureCloudEAAPIBase Azure EA API 핸들러에 대한 기본 객체입니다. Azure EA API에는 https://consumption.azure.com의 기본 URL이 있으며 경로에 등록 번호가 필요합니다. 이 클래스는 EnrollmentNumber 및 EnrollmentToken 매개변수의 마샬링을 처리합니다.

    기타 AWS 클래스

    클래스 설명
    AmazonImages

    Amazon 머신 이미지를 처리하는 클래스입니다.

    http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AMIs.html
    AmazonResponseProcessorUtil AWS REST API 응답을 처리하는 클래스입니다.
    AWSAutoScalingGroups

    AWS API 호출을 처리하여 자동 크기 조정 그룹을 만들고 조작하는 클래스입니다.
    AWSCloudFormation AWS CloudFormation API 호출에 대한 핸들러입니다.
    AWSEC2 AWS EC2 API 호출에 대한 핸들러입니다.
    AWSKeyValuePair 키 쌍을 임포트하고 조작하는 클래스입니다.
    AWSLaunchConfigurations 도우미 클래스입니다.
    AWSS3 AWS S3 API 호출에 대한 핸들러입니다.
    AWSTopics AWS 항목이 포함된 클래스입니다.