Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

适用于 SAP ABAP 的 Amazon SDK 入门

本节介绍如何使用 适用于 SAP ABAP 的 Amazon SDK。其中包括有关安装 SDK、执行基本配置和创建使用不同语言翻译短语的 Hello World 代码示例的信息。初次使用 Amazon SDK 时，建议您在沙盒环境中执行上述步骤。

步骤 1：准备 Amazon 账户

必须准备一个活动 Amazon Web Services 账户，才能开始使用适用于 SAP ABAP 的 SDK。即使在本地或由其他云提供商托管 SAP 系统，您也要准备 Amazon Web Services 账户。

如果 SAP 系统运行在 Amazon 云上，则您将在 Amazon Web Services 账户 中调用 Amazon 服务。

适用于 SAP 用户的 IAM 角色

有关更多信息，请参阅 IAM 安全最佳实践。

身份验证

身份验证取决于 SAP 系统的托管位置。

在 Amazon 云上

确保运行 SAP 系统的 EC2 实例的实例配置文件具有以下权限。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "sts:AssumeRole",
            "Resource": "arn:aws:iam::111122223333:role/SapDemoTranslate"
        }
    ]
}

添加之前步骤中记录的 ARN。

此权限能让 SAP 系统代表 ABAP 用户代入 SapDemoTranslate 角色。

本地或其他云

如果 SAP 系统位于本地或其他云上，请按照以下步骤建立连接。

记录 access_key 和 secret_access_key。必须向 SAP 管理员提供上述凭证，才能在 SAP 系统中执行加密操作。

步骤 2：传输设置

您可以在这一部分导入并配置传输内容。

导入

向 SAP 系统传输适用于 SAP ABAP 的 SDK。此传输内容可导入任意客户端。

配置

完成导入后，运行 /AWS1/IMG 事务以打开适用于 SAP ABAP 的 SDK 实施指南。如需运行此事务，请在 SAP 系统的命令栏中输入 /n/AWS1/IMG ，然后点击 Enter。

本地系统的先决条件

如果 SAP 系统运行在本地或其他云中，则必须将凭证存储在 SAP 数据库中。这些凭证使用 SAP SSF 进行加密，并且需要经过配置的加密库，如 SAP 的 CommonCryptoLib。

/AWS1/IMG 事务描述了为适用于 SAP ABAP 的 SDK 配置 SSF 的步骤。

步骤 3：功能设置

运行 /AWS1/IMG 事务（在命令栏中输入 /n/AWS1/IMG 并点击 Enter），打开 Amazon SDK 实施指南。

步骤 4：授权 SAP 用户

SAP 用户默认无权使用 Amazon 功能。必须使用 SAP 权限对用户进行明确授权。

创建 PFCG 角色

向 SAP 用户分配 PFCG 角色

分配到 ZAWS_SDK_DEMO_TESTUSER 角色的任意用户将有权使用 DEMO SDK 配置文件中配置的设置来运行 Amazon SDK 功能。授权用户还将代入 IAM 角色，其映射在配置文件的 TESTUSER IAM 逻辑角色中。

步骤 5：编写代码

添加以下代码。

*&---------------------------------------------------------------------*
*& Report  ZAWS1_DEMO_XL8_SIMPLE
*&
*&---------------------------------------------------------------------*
*& A simple demo of language translation with AWS Translate
*&
*&---------------------------------------------------------------------*
REPORT zaws1_demo_xl8_simple.

START-OF-SELECTION.
  PARAMETERS pv_text TYPE /aws1/xl8boundedlengthstring DEFAULT 'Hello, World' OBLIGATORY.

  PARAMETERS pv_lang1 TYPE languageiso DEFAULT 'EN' OBLIGATORY.
  PARAMETERS pv_lang2 TYPE languageiso DEFAULT 'ES' OBLIGATORY.

  TRY.
      DATA(go_session) = /aws1/cl_rt_session_aws=>create( 'DEMO' ).
      DATA(go_xl8)     = /aws1/cl_xl8_factory=>create( go_session ).
      DATA(lo_output) = go_xl8->translatetext(
           iv_text               = pv_text
           iv_sourcelanguagecode = CONV /aws1/xl8languagecodestring( pv_lang1 )
           iv_targetlanguagecode = CONV /aws1/xl8languagecodestring( pv_lang2 )
      ).

      WRITE: / 'Source Phrase: ', pv_text.
      WRITE: / 'Target Phrase: ', lo_output->get_translatedtext( ).
    CATCH /aws1/cx_xl8unsuppedlanguage00 INTO DATA(lo_lang).
      WRITE: / 'ERROR' COLOR COL_NEGATIVE,
               'Cannot translate from',
               lo_lang->sourcelanguagecode,
               'to',
               lo_lang->targetlanguagecode.
    CATCH cx_root INTO DATA(lo_root).
      WRITE: / 'ERROR' COLOR COL_NEGATIVE, lo_root->get_text( ).
  ENDTRY.

步骤 6：运行应用程序

在 SE38 中运行应用程序。成功运行后将输出以下内容。

Source Phrase: Hello, World
Target Phrase: Hola, mundo

如果缺失授权、配置或基础先决条件，您会收到一条错误消息。请参阅以下示例。

ERROR Could not find configuration under profile DEMO with 
scenario DEFAULT for SBX:001

如果您尚未向 SAP 系统配置可代入 IAM 角色的 IAM 权限，就已获得 SAP 角色授予的 SDK 配置文件使用权限，并能够将其映射到 IAM 逻辑角色，则您会收到以下输出内容。

ERROR Could not assume role arn:aws:iam::111122223333:role/SapDemoTranslate

此时，请查看 步骤 1：准备 Amazon 账户 中定义的 IAM 角色和/或用户上的 IAM 权限和信任配置。