API Gateway에서 생성한 REST API용 Ruby SDK 사용 - Amazon API Gateway

API Gateway에서 생성한 REST API용 Ruby SDK 사용

참고

이 지침에서는 API Gateway 콘솔을 사용하여 API용 SDK 생성의 지침을 이미 완료한 것으로 가정합니다.

API Gateway가 생성한 REST API용 Ruby SDK를 설치, 인스턴스화, 호출하려면

  1. 다운로드한 Ruby SDK 파일 압축을 풉니다. 생성된 SDK 원본은 다음과 같이 표시됩니다.

    
                    다운로드한 Ruby SDK 파일을 Ruby 모듈에 압축 해제
  2. 터미널 창에서 다음 셸 명령을 사용하여 생성된 SDK 원본에서 Ruby Gem을 구축합니다.

    # change to /simplecalc-sdk directory cd simplecalc-sdk # build the generated gem gem build simplecalc-sdk.gemspec

    이 작업 후 simplecalc-sdk-1.0.0.gem을 사용할 수 있게 됩니다.

  3. Gem 설치:

    gem install simplecalc-sdk-1.0.0.gem
  4. 클라이언트 애플리케이션을 생성합니다. 앱에서 Ruby SDK 클라이언트를 인스턴스화하고 초기화합니다.

    require 'simplecalc-sdk' client = SimpleCalc::Client.new( http_wire_trace: true, retry_limit: 5, http_read_timeout: 50 )

    API에 AWS_IAM 유형의 권한 부여가 구성되어 있는 경우, 초기화 도중 accessKeysecretKey를 제공하여 호출자의 AWS 자격 증명을 포함할 수 있습니다.

    require 'pet-sdk' client = Pet::Client.new( http_wire_trace: true, retry_limit: 5, http_read_timeout: 50, access_key: 'ACCESS_KEY', secret_key: 'SECRET_KEY' )
  5. 앱에서 SDK를 통해 API를 호출합니다.

    작은 정보

    SDK 메서드 호출 규칙에 익숙하지 않다면 생성된 SDK client.rb 폴더에 있는 lib 파일을 검토할 수 있습니다. 이 폴더에는 지원되는 각각의 API 메서드 호출 설명서가 포함되어 있습니다.

    지원되는 연산을 검색하려면

    # to show supported operations: puts client.operation_names

    이로 인해 각각 GET /?a={.}&b={.}&op={.}, GET /{a}/{b}/{op}POST / API 메서드와 {a:"…", b:"…", op:"…"} 형식의 페이로드에 해당하는 다음의 표시가 나타납니다.

    [:get_api_root, :get_ab_op, :post_api_root]

    GET /?a=1&b=2&op=+ API 메서드를 호출하려면 다음 Ruby SDK 메서드를 호출하십시오.

    resp = client.get_api_root({a:"1", b:"2", op:"+"})

    POST / 페이로드가 포함된 {a: "1", b: "2", "op": "+"} API 메서드를 호출하려면 다음 Ruby SDK 메서드를 호출하십시오.

    resp = client.post_api_root(input: {a:"1", b:"2", op:"+"})

    GET /1/2/+ API 메서드를 호출하려면 다음 Ruby SDK 메서드를 호출하십시오.

    resp = client.get_ab_op({a:"1", b:"2", op:"+"})

    SDK 메서드 호출이 성공하면 다음과 같은 응답을 반환합니다.

    resp : { result: { input: { a: 1, b: 2, op: "+" }, output: { c: 3 } } }