

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 구성 AWS SDK for SAP ABAP
<a name="configuring"></a>

사용하기 전에 SDK 작업에 필요한 기술 및 기능 설정으로 SDK를 구성해야 AWS SDK for SAP ABAP합니다. 일부 설정은 전송 가능하고 일부는 런타임 설정입니다. 대부분의 설정은 다른 SDK용 `.INI` 파일에 정의된 설정과 직접적으로 유사합니다.

런타임 설정을 제외한 SDK 구성은 개발 환경에서 완료해야 합니다. 일반적인 전송 및 변경 제어 규칙에 따라 구성을 QA 및 프로덕션으로 전송할 수 있습니다. 프로덕션 환경에는 전송 가능한 구성이 권장되지 않습니다.

 AWS SDK를 구성할 권한이 없는 경우 [SAP 권한 부여를 참조하세요](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/authorizations.html).

**구성 AWS SDK for SAP ABAP**

구성 트랜잭션을 실행하려면 SAPGUI 명령 모음에 `/n/AWS1/IMG`을(를) 입력합니다.

** AWS SDK for SAP ABAP 구성 - BTP 에디션**

다음 단계에 따라 SDK for SAP ABAP - BTP 에디션을 구성합니다.

1. 웹 브라우저에서 ABAP 환경을 엽니다.

1. 사용자 지정 비즈니스 구성 애플리케이션으로 이동합니다.

Export Customizing Transports 애플리케이션을 사용하여 사용자 지정 요청을 생성하려면 [Export Customizing Transports 앱 - 요청 생성을 참조하세요](https://help.sap.com/docs/btp/sap-business-technology-platform/working-in-export-customizing-transports-app#create-request).

사용자 지정 비즈니스 구성 애플리케이션에서 SDK 설정 유형에 따라 구성을 그룹화할 수 있습니다. 다음 단계에 따라 구성을 그룹화합니다.

1. 웹 브라우저에서 ABAP 환경을 열고 사용자 지정 비즈니스 구성 애플리케이션으로 이동합니다.

1. **설정** > **그룹을** 선택하고 드롭다운 목록에서 **구성 그룹을** 선택합니다. **확인**을 선택합니다.

1. 이제 이미지에 표시된 대로 계층 구조로 구성을 사용할 수 있습니다. 뷰를 저장하려면 [뷰(변형 관리) - 구성 요소를 참조하세요](https://www.sap.com/design-system/fiori-design-web/ui-elements/variant-management/).  
![\[그룹화된 구성의 예입니다.\]](http://docs.aws.amazon.com/ko_kr/sdk-for-sapabap/latest/developer-guide/images/custom-business-configurations.png)

이 섹션은 다음 주제를 포함합니다.

**Topics**
+ [글로벌 설정](global-settings.md)
+ [애플리케이션 구성](application-configuration.md)
+ [런타임 설정](runtime-settings.md)
+ [고급 연결 시나리오](connectivity-scenarios.md)
+ [서비스 공급자 설정](service-provider-settings.md)
+ [에 대한 새로 고침, 추적 및 원격 측정 주제 AWS SDK for SAP ABAP](additional-setup.md)

# 글로벌 설정
<a name="global-settings"></a>

 AWS SDK for SAP ABAP용 `/n/AWS1/IMG` IMG Transacation과 AWS SDK for SAP ABAP - BTP 에디션용 Custom Business Configuration 애플리케이션을 사용하여 글로벌 설정을 구성합니다. 이 주제에서는 IMG와 사용자 지정 비즈니스 구성을 상호 교환적으로 사용합니다.

이 섹션은 다음 주제를 포함합니다.

**Topics**
+ [기술 설정](#technical-settings)
+ [시나리오 구성](#configure-scenarios)

## 기술 설정
<a name="technical-settings"></a>

`/AWS1/IMG` 트랜잭션의 글로벌 설정은 전체 SDK의 동작에 영향을 줍니다. 이러한 설정은 일반적으로 기본 관리자가 구성합니다. 이 값을 다음과 같은 권장 설정으로 설정할 수 있습니다.
+ **새 항목**을 선택합니다.
  + **S3 지역화**: [s3.amazonaws.com](http://s3.amazonaws.com)을 사용하여 us-east-1 버킷에 액세스합니다.
  + **STS 지역화**: 글로벌 엔드포인트를 사용하여 STS에 액세스합니다.
  + **EC2 메타데이터 비활성화**: 이 필드를 비워 둡니다. 이 필드는 BTP 에디션에서 읽기 전용이며 기본적으로 '예'로 설정됩니다.
  + **메타데이터 엔드포인트 모드**: IPv4 메타데이터 엔드포인트를 사용합니다. 이 필드는 BTP 에디션에서 읽기 전용이며 자동 업데이트됩니다.
  + **메타데이터 엔드포인트 URL:** 이 필드를 비워 둡니다. 이 필드는 BTP 에디션에서 읽기 전용입니다.
+ **저장**을 선택합니다.

## 시나리오 구성
<a name="configure-scenarios"></a>

시나리오를 사용하면 AWS SDK가 다중 리전 재해 테스트 또는 재해 복구 테스트 시나리오 중에 설정을 보다 효율적으로 전환할 수 있습니다. 이 기능이 필요하지 않을 수도 있으며, 대신 다음과 같은 DEFAULT 시나리오를 구성하기만 하면 됩니다.
+ **새 항목**을 선택합니다.
  + 시나리오 ID: `DEFAULT` 
  + 시나리오 설명: 기본 시나리오
+ **저장**을 선택합니다.

다중 리전 재해 복구 설정 또는 빠른 설정 변경이 필요한 기타 고유한 경우가 있는 경우 여러 시나리오를 구성할 수 있습니다.
+  `DEFAULT`- 표준 작업.
+  `DR`- 재해로 인해 전체 시스템을 다른 리전으로 이동해야 하는 경우를 대비한 특별 구성.
+  `DR_TEST`- 임시 프로덕션 복제본과 같이 재해 시뮬레이션을 위한 특수 구성

# 애플리케이션 구성
<a name="application-configuration"></a>

SDK for SAP ABAP 구성은 다른 ABAP 기반 애플리케이션 구성과 유사합니다. 다양한 시나리오의 설정을 그룹화할 수 있도록 다양한 *프로필*로 구성되어 있습니다. ABAP SDK 프로필은 특정 애플리케이션 시나리오에 필요한 설정을 정의합니다. 예를 들어 트랜잭션 `ZVA01`, `ZVA02`및 `ZVA03`가 Amazon S3 AWS Lambda, 및 AWS 서비스와 같은 인보이스 관련 트랜잭션이 향상되고 실행되는 경우 Amazon SageMaker AI라는 SDK 프로파일을 만들 `ZINVOICE` 수 있습니다. 이 프로필은 인보이스 관련 기능에 대한 기술 설정, SAP 인증 및 IAM 역할 매핑을 그룹화할 수 있습니다.

 AWS SDK for SAP ABAP의 `/n/AWS1/IMG` Transacation과 AWS SDK for SAP ABAP - BTP 에디션의 Custom Business Configuration 애플리케이션을 사용하여 전역 설정을 구성합니다. 이 주제에서는 IMG와 사용자 지정 비즈니스 구성을 상호 교환적으로 사용합니다.

**Topics**
+ [SDK 프로필](#sdk-profile)
+ [논리적 리소스 해석기](#logical-resource)
+ [예제](#example)

## SDK 프로필
<a name="sdk-profile"></a>

ABAP SDK 프로필은 각 SID 및 클라이언트에 대해 다음을 정의합니다.

**참고**  
SAP BTP, ABAP 환경에서 클라이언트는 항상 100입니다.
+ 모든 API 호출의 기본 AWS 리전입니다. 예를 들어 SAP 시스템이 `us-east-1` 리전에서 실행 중인 경우 다른 AWS 리소스도 동일한 리전에 있을 수 있으며 이는 기본 리전이어야 합니다. ABAP 코드는 기본 리전을 재정의할 수 있습니다.
+ 인증 방법
  + Amazon EC2에서 실행되는 SAP 시스템의 경우, 단기 자동 순환 보안 인증을 활용하려면 인스턴스 역할 메타데이터를 선택하는 것이 좋습니다.
  + 온프레미스 또는 다른 클라우드에서 실행되는 SAP 시스템의 경우 SSF 스토리지에서 보안 인증을 선택해야 합니다.
  + SAP BTP에서 실행되는 ABAP 시스템의 경우 SAP 자격 증명 스토어에서 자격 증명을 선택해야 합니다. 자세한 내용은 [인증에 SAP 자격 증명 스토어 사용을 참조하세요](https://docs.aws.amazon.com/).
  + 교차 계정 역할 체인 시나리오의 경우 소스 프로필을 선택하고 소스 프로필 ID를 지정합니다. 이를 통해 역할 가정 체인의 자동 확인 및 실행이 가능합니다. 자세한 내용은 [교차 계정 액세스를 위한 소스 프로파일 사용을](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/source-profile.html) 참조하세요.
+ 논리적 IAM 역할을 IAM 역할에 매핑합니다.
  + 해당 매핑은 우선 순위 내림차순으로 정렬됩니다.
  + PFCG 역할에서 사용자에게 권한이 부여된 우선 순위가 가장 높은 IAM 역할이 자동으로 선택됩니다.
+ 서비스를 사용자 지정 엔드포인트에 선택적으로 매핑합니다. 이 구성은 [고급 연결 시나리오](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/connectivity-scenarios.html#advanced-routing)에서 설명합니다.

**참고**  
PFGC 역할은 SAP BTP, ABAP 환경에서 비즈니스 역할이라고 합니다.

ABAP 프로그램이에 연결하려는 경우 필요한 설정을 가져오는 ABAP SDK 프로파일을 AWS 서비스지정합니다. 사용자가 SDK 프로필에 액세스할 권한이 있는지 확인하기 위해 `AUTHORIZATION-CHECK`이(가) 수행됩니다. SAP 보안 관리자는 적절한 사용자에게 액세스 권한을 부여하는 PFCG 역할을 정의할 수 있습니다.

## 논리적 리소스 해석기
<a name="logical-resource"></a>

논리적 리소스 해석기를 사용하면 표준 위치에 리소스 이름을 저장할 수 있습니다. SDK for SAP ABAP와 함께 제공됩니다. 이 동작은 `FILE` 트랜잭션이 논리적 파일 이름을 물리적 파일 이름에 매핑하는 방식과 유사합니다.

논리적 리소스는 인보이스가 들어 있는 Amazon S3 버킷과 같은 AWS 리소스의 개념을 정의합니다. 예를 들어, 이 논리적 리소스의 이름은 `ZINVOICES_OUTBOUND`일 수 있으며 SAP 시스템이 개발, QA 또는 프로덕션 단계인지에 따라 다른 물리적 버킷 이름에 매핑할 수 있습니다.

SDK for SAP ABAP는 프로덕션에서 시스템을 새로 고친 후에도 QA 시스템이 논리적 리소스를 QA 물리적 리소스로 해결하도록 설정됩니다. ALL 시스템의 리소스 매핑은 개발 SAP 시스템에서 정의되고 전달됩니다. 이 접근 방식은 매핑이 마스터 데이터로 처리되고 각 시스템에서 설정되는 SAP 시스템의 일반적인 설정과는 다릅니다. SDK for SAP ABAP에서 제공하는 논리적 리소스 해석기의 장점은 시스템을 새로 고친 후 잘못된 전송이 발생할 가능성이 거의 없다는 것입니다.

## 예제
<a name="example"></a>

Amazon S3 버킷은 총 네 개로 각각 개발, 프로덕션 및 QA용으로 하나씩 존재하며 두 번째 QA 버킷은 회귀 테스트용입니다.

SDK는 `ZINVOICE_OUTBOUND`과(와) 같은 논리적 리소스를 물리적 리소스로 해결하면 `SY-SYSID` 및 `SY-MANDT`을(를) 확인하여 *실행 중인 SID와 클라이언트*를 묻고 올바른 물리적 리소스를 자동으로 선택합니다.

프로덕션에서 리소스의 매핑을 변경해야 하는 경우 개발 시스템의 `IMG`에서 매핑을 변경하여 전달해야 합니다. 이렇게 하면 SAP 시스템에 AWS 리소스를 재할당할 때 다른 전송과 마찬가지로 변경 제어가 적용됩니다.

**참고**  
SDK 구성은 클라이언트에 따라 달라지므로 리소스 재할당은 사용자 지정 요청으로 전송되며 전송을 각 클라이언트로 가져와야 합니다.

# 런타임 설정
<a name="runtime-settings"></a>

이 섹션은 다음 주제를 포함합니다.

**참고**  
이러한 설정은 전송할 수 없으며 각 SAP 시스템에서 로컬로 설정됩니다.

**Topics**
+ [로그 및 추적](#log-trace)
+ [옵트인: 향상된 원격 측정](#enhanced-telemetry)
+ [활성 시나리오](#active-scenario)

## 로그 및 추적
<a name="log-trace"></a>

디버깅 용도로 추적을 활성화할 수 있습니다. 기술적인 문제를 진단하지 않는 한 추적 수준을 **추적 없음**으로 유지하는 것이 좋습니다. 자세한 정보는 보안 작업을 참조하세요.

이러한 설정은 SDK for SAP ABAP - BTP 에디션에는 적용되지 않습니다.

## 옵트인: 향상된 원격 측정
<a name="enhanced-telemetry"></a>

모든 SDKs 지원을 위해 AWS 에 원격 측정 정보를 전송합니다. 향상된 원격 측정을 옵트인할 수 있습니다. 이는 특정 API 호출의 소스를 식별하기 지원 위해에 문의할 때 특히 유용합니다. 자세한 내용은 [추적](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/additional-topics.html#trace) 및 [원격 측정](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/additional-topics.html#telemetry)을 참조하세요.

이러한 설정은 SDK for SAP ABAP - BTP 에디션에는 적용되지 않습니다.

## 활성 시나리오
<a name="active-scenario"></a>

이 트랜잭션에서 `DEFAULT` 시나리오를 활성화하세요. 이 활성화는 각 시스템에 한 번만 필요하며 시스템에 다중 리전 재해 복구가 진행 중인 경우가 아니면 변경해서는 안 됩니다. 다중 리전 설정에서 이 설정을 사용하여 SAP 시스템을 재해 복구 환경 또는 재해 복구 테스트 시나리오로 전환할 수 있습니다.

# 고급 연결 시나리오
<a name="connectivity-scenarios"></a>

AWS SDK for SAP ABAP 는 AWS 엔드포인트 AWS 서비스 에 HTTPS 호출을 수행하여를 사용합니다. 일반적으로 AWS 엔드포인트는 인터넷을 통해 액세스할 수 있습니다. SAP 시스템은 인터넷에 접속하여 이러한 아웃바운드 연결을 설정할 수 있어야 합니다. SDK for SAP ABAP는 인터넷에서 SAP 시스템으로의 인바운드 연결을 필요로 하지 않습니다.

다음 시나리오는 아웃바운드 연결을 설정하는 다양한 방법을 제공합니다.

**Topics**
+ [프록시 서버를 통한 연결](#proxy-server)
+ [패킷 검사 방화벽을 통한 연결](#packet-firewall)
+ [게이트웨이 엔드포인트](#gateway-endpoints)
+ [사용자 지정 인터페이스 엔드포인트](#interface-endpoints)
+ [고급 라우팅](#advanced-routing)
+ [다중 리전 엔드포인트에 액세스](#multiple-regions)

## 프록시 서버를 통한 연결
<a name="proxy-server"></a>

프록시 서버를 통해 연결을 설정하려면 다음 단계를 수행합니다.

1. SDK에서 **`SICF`** 트랜잭션으로 이동합니다.

1. **실행**을 선택합니다.

1. 메뉴에서 **클라이언트** > **프록시 서버**를 선택합니다.

1. **프록시 설정**을 **활성**으로 설정합니다.

1. **다음 주소의 프록시 없음** 필드에 모든 예외를 세미콜론으로 구분하여 나열합니다.

1. **HTTP 프로토콜** 및 **HTTPS 프로토콜** 필드에 프록시 서버의 연결 세부 정보를 지정합니다.

SDK는 프록시 서버를 인식하지 않으므로 SAP 시스템의 프록시 서버 구성을 사용하기 위한 설정이 필요하지 않습니다.

**참고**  
[Amazon EC2 인스턴스 메타데이터 인증을](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/system-authentication.html#metadata-authentication) 사용하는 경우 SAP 시스템은 프록시 서버를 사용하여 `http://169.254.169.254`의 로컬 인스턴스 메타데이터에 액세스할 수 없습니다. *다음 주소의 프록시 없음* 필드에 `169.254.169.254`을(를) 포함해야 합니다.

## 패킷 검사 방화벽을 통한 연결
<a name="packet-firewall"></a>

아웃바운드 연결을 위한 패킷 검사 방화벽을 구성할 수 있습니다. 이러한 방화벽은 SSL 트래픽을 해독한 다음 엔드포인트로 전달하기 전에 다시 암호화합니다. 이 구성에서는 일반적으로 방화벽이 AWS 서비스을(를) 사용하는 SAP 시스템에 자체 인증서를 발급해야 합니다. `STRUST`에 방화벽의 CA 인증서를 설치해야 합니다. 자세한 내용은 [HTTPS 연결](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/prerequisites.html#https-connectivity)을 참조하세요.

## 게이트웨이 엔드포인트
<a name="gateway-endpoints"></a>

일부는 인터넷 없이 VPC에 고성능 액세스를 제공하기 위해 게이트웨이 엔드포인트를 AWS 서비스 제공합니다. 이러한 엔드포인트는 SDK for SAP ABAP에 투명하며 구성이 필요하지 않습니다.

자세한 내용은 [게이트웨이 엔드포인트](https://docs.aws.amazon.com/vpc/latest/privatelink/gateway-endpoints.html)를 참조하세요.

## 사용자 지정 인터페이스 엔드포인트
<a name="interface-endpoints"></a>

기본 엔드포인트 확인을 사용자 지정 엔드포인트로 재정의해야 하는 경우 인터페이스 엔드포인트를 사용하여 인터넷 없이 VPC에 고성능 액세스를 제공할 수 있습니다. 자세한 내용은 [인터페이스 엔드포인트 구성](https://docs.aws.amazon.com/vpc/latest/privatelink/interface-endpoints.html)을 참조하세요.

프라이빗 DNS를 사용하지 않는 경우 이러한 엔드포인트는 자체 DNS 주소를 가지므로 ABAP 프로그램은 일반적인 엔드포인트 확인 로직을 명시적으로 재정의해야 합니다. 자세한 내용은 AWS re:Post - [인터페이스 VPC 엔드포인트의 서비스 도메인 이름을 확인할 수 없는 이유는 무엇입니까?를](https://repost.aws/knowledge-center/vpc-interface-configure-dns) 참조하세요.

다음 예제에서는 AWS STS 및에 대한 인터페이스 엔드포인트가 생성됩니다 Amazon Translate. SAP 시스템은 프라이빗 DNS를 사용하지 않으며 사용자 지정 엔드포인트로 서비스를 호출합니다. `/AWS1/IMG`에 정의된 논리적 리소스는 `vpce-0123456789abcdef-hd52vxz.translate.us-west-2.vpce.amazonaws.com`와 같은 물리적 인터페이스 엔드포인트 주소를 나타냅니다. 이렇게 하면 코드에 DNS를 하드 코딩하지 않아도 됩니다.

다음 코드에서는 `/AWS1/IMG`의 논리적 리소스가 먼저 물리적 엔드포인트 이름으로 확인됩니다. 그런 다음 AWS 세션 클래스(를 사용하여 IAM 역할을 수임)의 팩토리 메서드 AWS STS 에 제공되고 API 클래스를 번역합니다.

```
" This example assumes we have defined our logical endpoints in /AWS1/IMG
" as logical resources so that we don't hardcode our endpoints in code.
" The endpoints may be different in Dev, QA and Prod environments.
DATA(lo_config) = /aws1/cl_rt_config=>create( 'DEMO' ).
DATA(lo_resolver) = /aws1/cl_rt_lresource_resolver=>create( lo_config ).

" logical resource STS_ENDPOINT should resolve to the interface endpoint
" for example vpce-0123456789-abcdefg.sts.us-west-2.vpce.amazonaws.com
DATA(lv_sts_endpoint) = lo_resolver->resolve_lresource( 'STS_ENDPOINT' ).

" logical resource XL8_ENDPOINT should resolve to the interface endpoint
" e.g. vpce-0123456789abcdefg-12345567.translate.us-west-2.vpce.amazonaws.com
DATA(lv_xl8_endpoint) = lo_resolver->resolve_lresource( 'XL8_ENDPOINT' ).

" the session itself uses the sts service to assume a role, so the
" session creation process requires a custom endpoint, specified here
DATA(lo_session) = /aws1/cl_rt_session_aws=>create(
  iv_profile_id = 'DEMO'
  iv_custom_sts_endpoint = |https://{ lv_sts_endpoint }|
).

" now we create an API object, and override the default endpoint with 
" the custom endpoint
DATA(lo_xl8)     = /aws1/cl_xl8_factory=>create(
  io_session = lo_session
  iv_custom_endpoint = |https://{ lv_xl8_endpoint }| " provide custom endpoint
).
" now calls to lo_xl8 go to custom endpoint...
```

예제에서 볼 수 있듯이`go_xl8`에 대한 모든 메서드 호출은 엔드포인트 `https://vpce-0123456789abcdefg-12345567.translate.us-west-2.vpce.amazonaws.com`로 이동합니다. 다음 섹션에 표시된 대로 코드 대신 IMG 구성에서 라우팅 사용자 지정 엔드포인트를 정의할 수도 있습니다.

## 고급 라우팅
<a name="advanced-routing"></a>

 이전 섹션에서는 SDK 모듈의 팩토리 메서드 `iv_custom_endpoint` 인수에 사용자 지정 엔드포인트를 지정하는 방법을 보여드렸습니다. SDK를 사용하는 ABAP 프로그램 수가 증가하면 관리하기 어려울 수 있습니다. SDK 프로파일에서에서 사용자 지정 엔드포인트 AWS 서비스 로의 매핑을 구성할 수 있습니다. 각 SID, 클라이언트 및 시나리오에 대해 서비스 TLA(3자 약어)를 엔드포인트 URL에 매핑할 수 있습니다.


|  TLA  |  사용자 지정 엔드포인트 URL  | 
| --- | --- | 
| BDR | https://vpce-23456789abcdef012-3c4d5e6f.bedrock-runtime.us-east-1.vpce.amazonaws.com | 
| LMD | https://vpce-123456789abcdef01-2b3c4d5e.lambda.us-east-1.vpce.amazonaws.com | 
| S3 | https://vpce-0123456789abcdef0-1a2b3c4d.s3.us-east-1.vpce.amazonaws.com | 

 이 구성을 사용하면 공장 메서드 호출`iv_custom_endpoint`에서를 지정할 필요가 없습니다. 사용자 지정 엔드포인트는 구성 테이블에서 자동으로 선택됩니다. 구성은 SDK 프로파일에 고유하므로 필요에 따라 서로 다른 라우팅으로 여러 프로파일을 생성할 수 있습니다. 다른 SDK 프로파일 구성과 마찬가지로 라우팅은 SID 및 클라이언트별로 다르므로 다른 시스템에 대해 별도의 라우팅을 정의할 수 있습니다.

## 다중 리전 엔드포인트에 액세스
<a name="multiple-regions"></a>

AWS 엔드포인트는 SDK 프로파일에 AWS 리전 정의된 기본값에서 자동으로 결정됩니다. 프로그래밍 방식으로 지역을 지정하여 기본 리전을 재정의할 수도 있습니다. 이는 팩토리 `CREATE()` 메서드에서 재정의하거나 나중에 SDK의 구성 객체로 재정의할 수 있습니다. 자세한 내용은 [프로그래밍 방식 구성](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/features.html#programmatic-configuration)을 참조하세요.

다음 예시에서는 팩토리 `CREATE()` 메서드를 사용하여 리전을 설정하고 `us-east-1` 및`us-west-2` 리전 모두에서 Amazon SQS 대기열을 나열합니다.

```
REPORT zdemo_sqs_queue_list.
parameters: profile type /AWS1/RT_PROFILE_ID OBLIGATORY.

START-OF-SELECTION.
DATA(go_session) = /aws1/cl_rt_session_aws=>create( profile ).
data(lt_region) = VALUE stringtab(
  ( |us-east-1| )
  ( |us-west-2| )
).

LOOP AT lt_region INTO DATA(lv_region).
  DATA(go_sqs)  = /aws1/cl_sqs_factory=>create(
    io_session = go_session
    iv_region = conv /AWS1/RT_REGION_ID( lv_region )
  ).
  WRITE: / lv_region COLOR COL_HEADING.
  LOOP AT go_sqs->listqueues( )->get_queueurls( ) INTO DATA(lo_url).
    WRITE: / lo_url->get_value( ).
  ENDLOOP.
ENDLOOP.
```

# 서비스 공급자 설정
<a name="service-provider-settings"></a>

기본 관리자는 클라이언트에서 전체 시스템 전반에서 SDK의 특정 기능을 제어해야 하는 경우가 있습니다`000`. 이는 고객을 대신하여 자신의 AWS 계정에서 시스템을 운영하는 호스팅 및 서비스 공급자를 위한 일반적인 시나리오입니다. AWS SDK for SAP ABAP는 서비스 공급자 설정을 지원합니다. 이러한 설정은 클라이언트에서 구성`000`되며 모든 클라이언트의 SDK에 영향을 미칩니다. 서비스 공급자 설정은 SDK for SAP ABAP - BTP 에디션에서 지원되지 않습니다.

서비스 공급자 설정은 트랜잭션에서 구성`/AWS1/IMG`되며 클라이언트에서 구성되어야 합니다`000`. 다른 클라이언트의 서비스 공급자 설정은 무시됩니다. 클라이언트의 설정은 모든 클라이언트에 `000` 적용되며 충돌 시 다른 `IMG` 설정을 대체합니다.

다음 단계에 따라 클라이언트에서 서비스 공급자 설정을 구성합니다`000`.

1. 트랜잭션에서 **서비스 공급자 설정** 브랜치를 확장합니다`/AWS1/IMG`.

1. **서비스 공급자 가드레일** 선택

1. **새 항목을** 선택하고 비즈니스 요구 사항에 따라 설정을 조정합니다.

   1. *EC2 메타데이터 비활성화* - SDK 프로파일이 EC2 인스턴스 메타데이터를 사용하여 인증하도록 구성된 경우에도 SDK가 모든 클라이언트의 EC2 인스턴스 메타데이터에 액세스하지 못하도록 합니다. ABAP 프로그램이 SDK를 사용하여 인스턴스 메타데이터에 액세스하려고 하면 SDK에서 예외가 발생합니다.

1. **저장**을 선택합니다.

# 에 대한 새로 고침, 추적 및 원격 측정 주제 AWS SDK for SAP ABAP
<a name="additional-setup"></a>

이 섹션은 다음 주제를 포함합니다.

**Topics**
+ [SAP 시스템 새로 고침](#refresh)
+ [추적](#trace)
+ [원격 측정](#telemetry)

## SAP 시스템 새로 고침
<a name="refresh"></a>

시스템을 새로 고친 후 기본 관리자의 주요 과제는 개별 시스템이 서로의 리소스에 액세스하지 못하도록 하는 것입니다. 예를 들어 QA SAP 시스템이 프로덕션 환경의 S3 버킷과 같은 리소스에 액세스하지 못하도록 할 수 있습니다.

SDK for SAP ABAP는 이러한 문제에 대한 *논리적 리소스*의 안전을 고려한 접근 방식을 제공합니다. 비즈니스 분석가는 다음 단계를 수행할 수 있습니다.

1. `ZINVOICE_OUTBOUND`과(와) 같은 논리적 리소스를 정의합니다.

1. 개발 시스템의 모든 시스템과 클라이언트를 매핑합니다.

1. 모든 시스템의 구성을 프로덕션 환경까지 전달합니다.

**새로 고침 후의 기본 단계**

1. 인증 확인
+ 시스템에서 비밀 액세스 키 인증을 사용하는 경우 SSF로 암호화된 보안 인증은 마스터 데이터에 저장되므로 유효하지 않습니다. 보안 인증을 다시 입력해야 하며, 이 경우 [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)에서 새 비밀 액세스 키를 다시 생성해야 할 수 있습니다.
+ 시스템이 EC2 인스턴스 메타데이터로 인증하는 경우 별도의 조치가 필요하지 않습니다.

추적 설정 확인
+ `/AWS1/IMG`에서 추적 설정이 원하는 설정인지 확인합니다. 이러한 설정은 전송할 수 없습니다.

## 추적
<a name="trace"></a>

추적 출력은 **IMG 런타임 설정**에서 제어됩니다.

 사용할 수 있는 추적 수준은 다음과 같습니다.
+ **추적 없음**
+ **API 호출 추적**
+ **API 호출 및 페이로드 추적**

  *이 옵션에는 암호화되지 않은 페이로드 정보가 포함되어 있습니다.*
+ **API 호출, 페이로드, 내부 XML 변환 추적**

  이 옵션에는 암호화되지 않은 페이로드 정보가 포함되어 있습니다.**

API 추적이 활성화되면 추적이 `aws1_trace-YYYY-MM-DD.log` 파일의 `DIR_WORK`에 기록됩니다.

페이로드 추적이 추가로 활성화되면 각 호출 및 페이로드 구성 요소에 대해 `aws1_payload_*`라는 제목의 추가 파일이 생성됩니다. 각 개별 페이로드 추적 실패에 적용되는 길이 제한으로 페이로드 추적 길이를 제한할 수 있습니다.

페이로드 추적은 주로 직렬화 오류가 발생할 지원 경우에 제공할 정보를 수집하기 위한 것입니다. SDK 오류를 진단하려는 경우가 아니라면 **추적 없음**을 선택하는 것이 좋습니다.

**참고**  
페이로드 추적에는 암호화되지 않은 비즈니스 정보가 포함될 수 있습니다. 문제 해결에 도움이 되도록 AWS Support의 요청에 대해서만 이러한 추적을 켜는 것이 좋습니다. 문제가 해결된 후에는 이러한 추적을 끌 수 있습니다. 추적은 자동으로 삭제되지 않으므로 더 이상 필요하지 않을 경우 시스템 관리자가 추적을 제거해야 합니다.

이러한 설정은 SDK for SAP ABAP - BTP 에디션에는 적용되지 않습니다.

## 원격 측정
<a name="telemetry"></a>

SDKs 원격 측정 정보를 로 전송합니다 지원. SDK for SAP ABAP는 다음과 같은 정보를 수집합니다.
+ OS 릴리스 및 패치 수준
+ `SAP_BASIS` 릴리스 및 패치 수준
+ SAP 커널 릴리스 및 패치 수준

다음 정보를 지원(으)로 전송하도록 옵트인할 수 있습니다.
+ SAP SID 및 인스턴스 이름(`host_sid_nn`)
+ SAP 클라이언트(`SY-MANDT`)
+ 트랜잭션 코드(`SY-TCODE`) 및 보고서(`SY-REPID`)

추가 정보를 통해 지원 가 더 나은 도움을 줄 수 있습니다. 지원 는 특정 API 호출이 이루어진 이유를 감지하고 SAP 시스템에서 관련 트랜잭션을 추가로 찾을 수 있습니다.

원격 측정은 SDK for SAP ABAP - BTP 에디션용 SDK 및 API 버전으로 제한됩니다.