실행

어셈블리의 execute 필드의 구조는 다음과 같습니다.

execute:
 - Policy_1
 - Policy_2
참고: 일부 기본 제공 정책은 DataPower® Gateway (v5 compatible)DataPower API Gateway모두에서 사용할 수 있지만 일부 정책은 특정 게이트웨이로 제한됩니다. 다음 아이콘은 각 정책에서 사용할 수 있는 게이트웨이를 나타냅니다.
  • DataPower 게이트웨이 아이콘 DataPower Gateway (v5 compatible) 에서 정책을 실행할 수 있음을 나타냅니다.
  • DataPower 게이트웨이 아이콘이 정책은. DataPower API Gateway에서 실행될 수 있음을 나타냅니다.

두 가지 게이트웨이 유형에 대한 자세한 내용은 게이트웨이 API Connect 유형을 참조하십시오.

다음 표에는 execute 필드에 포함될 수 있는 가능한 정책 및 논리 구성이 설명되어 있습니다.

표 1. execute 속성

다음 표에는 execute 필드에 포함될 수 있는 가능한 정책 및 논리 구성이 설명되어 있습니다.

특성 필수 설명 데이터 유형 DataPower 게이트웨이 아이콘 DataPower 게이트웨이 아이콘
activity-log 아니오 activity-log 정책을 사용하여 API 오퍼레이션 호출에 관련된 정보를 로그합니다. 객체 ( 활동 로그 ) 예 예

활동 기록 확장 기능이 제공하는 기능

client-security 아니오 API에 대한 클라이언트 액세스를 인증하기 위해 광범위한 옵션을 제공하여 OpenAPI 스펙의 기능을 확장합니다. 객체 ( 클라이언트 보안 ) 아니오 예
gatewayscript 아니오 GatewayScript 프로그램을 포함합니다.GatewayScript 정책은. Premium subscription와 함께만 사용할 수 있습니다. 객체 ( gatewayscript ) 예 예
graphql-cost-analysis 아니오 graphql-cost-analysis 정책을 사용하여 대상 쿼리에 대한 비용 분석을 반환합니다. 객체 ( graphql-cost-analysis ) 아니오 예
graphql-execute 아니오 graphql-execute 정책을 사용하여 하위 쿼리를 통해 GraphQL 쿼리를 실행합니다. 객체 ( graphql-execute ) 아니오 예
graphql-introspect 아니오 graphql-introspect 정책을 사용하여 GraphQL 스키마를 자체 검사합니다. 객체 ( graphql-introspect ) 아니오 예
if 아니오 if 정책을 사용하여 조건이 충족되는 경우에만 어셈블리의 섹션을 실행합니다. 객체 ( if ) 예 예

위치가 제공하는 기능

invoke 아니오 호출 정책을 사용하여 API를 호출합니다.

성능을 개선하기 위해 정책의 마지막 호출이 자동으로 프록시로 대체될 수 있습니다. 이 기능을 비활성화하려면 다음을 참조하세요: API 속성.

객체 ( 호출 ) 예 예
json-to-xml 아니오 페이로드를 JSON에서 XML로 변환합니다. 객체 ( JSON-to-XML ) 예 예
jwt-generate 아니오 JWT(JSON Web Token)를 생성합니다. 객체 ( jwt-generate ) 예 예
jwt-validate 아니오 JWT(JSON Web Token)를 유효성 검증합니다. 객체 ( jwt-validate ) 예 예
map 아니오 맵 정책을 사용하여 변수를 변환합니다. 객체 ( ) 예 예
message-template 아니오 메시지 템플릿 정책을 사용하여. DataPower API Gateway에 대한 모의 API 응답을 생성합니다. 객체 ( 메시지 템플릿 ) 아니오 예
operation-switch 아니오 호출될 오퍼레이션에 따라 대체 정책 어셈블리를 실행하려고 할 경우 operation-switch 정책을 사용합니다. 객체 ( 작동 스위치 ) 예 예
oauth 아니오 oauth 정책을 사용하여 정의된 ‘ OAuth ’ 공급자 설정에 따라 ‘ OAuth ’ 처리를 수행합니다. 객체 ( OAuth ) 아니오 예
parse 아니오 parse 정책을 사용하여 입력 문서의 구문 분석을 제어할 수 있습니다. 입력 문서가 JSON 문자열이면 문자열이 복사되는 대신 구문 분석됩니다. 객체 ( 구문 분석 ) 아니오 예
proxy 아니오 서비스를 프록시 설정합니다. 객체 ( 프록시 ) 예 예

invoke 가 제공하는 기능

ratelimit 아니오 ratelimit 정책을 사용하여 API 어셈블리 플로우의 임의의 지점에서 하나 이상의 비율 또는 버스트 한계를 적용하십시오. 비율 및 버스트 한계는 지정된 기간에 API에 대해 애플리케이션이 수행할 수 있는 호출 수를 제한합니다. 객체 ( ratelimit ) 아니오 예
redact 아니오 redact 정책을 사용하여 요청 본문, 응답 본문 및 활동 로그에서 지정된 필드를 완전히 제거하거나 수정합니다. 법적, 보안상 또는 기타 이유로 민감한 데이터(예: 신용카드 세부사항)를 제거하거나 차단하는 데 이 정책이 유용합니다. 객체 ( 편집 - DataPower API Gateway 편집 - DataPower Gateway ( v5 호환) ) 예 예
set-variable 아니오 변수 설정 정책을 사용하여 런타임 변수를 문자열 값으로 설정하거나 런타임 변수를 추가하거나 제거하십시오. 객체 ( 변수 설정 ) 예 예
switch 아니오 switch 정책을 사용하여 이행되는 지정된 조건에 기반하여 어셈블리의 여러 섹션 중 하나를 실행합니다. 객체 ( 스위치 ) 예 예
throw 아니오 throw 정책을 사용하여 오류를 처리해야 하는 지점을 지정합니다. 객체 ( 던지기 ) 예 예
user-security 아니오 사용자의 신임 정보를 추출하고 해당 신임 정보를 인증하며 사용자로부터 권한을 얻습니다. 객체 ( 사용자 보안 ) 아니오 예
validate 아니오 유효성 검증 정책을 사용하여 어셈블리 플로우의 페이로드를 JSON 또는 XML 스키마에 대해 유효성 검증하십시오. 객체 ( validate - DataPower API Gateway, validate - DataPower Gateway ( v5 와 호환됨) ) 예 예
validate-usernametoken 아니오 WS-Security UsernameToken을 유효성 검증합니다. 객체 ( validate-usernametoken ) 예 아니오
xml-to-json 아니오 페이로드를 XML에서 JSON으로 변환합니다. 객체 ( XML-to-JSON ) 예 예
xslt 아니오 XSLT 변환을 페이로드에 적용합니다.XSLT 정책은. Premium subscription에서만 사용할 수 있습니다. 객체 ( XSLT ) 예 예

다음 예에서는 URL을 호출한 후 요청 또는 응답으로부터 필드를 수정하는 어셈블리에 대한 execute 필드를 보여줍니다.

execute:
 - invoke:
  title: Example Invoke
  target-url: 'https://example.com/api'
  description: Example description
 - redact:
  actions:
   - action: redact
     from: 
      - request
      - response
    path: //*[@name='secondaryAddress']/*[@name='streetAddress']