Sono disponibili altri esempi di AWS SDK nel repository [AWS Doc SDK Examples. ](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# AWS IoT esempi di utilizzo dell'SDK per SAP ABAP
<a name="sap-abap_1_iot_code_examples"></a>

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando l' AWS SDK per SAP ABAP con. AWS IoT

Le *azioni* sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

**Topics**
+ [Azioni](#actions)

## Azioni
<a name="actions"></a>

### `AttachThingPrincipal`
<a name="iot_AttachThingPrincipal_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `AttachThingPrincipal`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    TRY.
        lo_iot->attachthingprincipal(
          iv_thingname = iv_thing_name
          iv_principal = iv_principal ).
        MESSAGE |Principal attached to IoT thing '{ iv_thing_name }'.| TYPE 'I'.
      CATCH /aws1/cx_iotresourcenotfoundex INTO DATA(lo_ex).
        MESSAGE |Resource not found when attaching principal to '{ iv_thing_name }'.| TYPE 'I'.
        RAISE EXCEPTION lo_ex.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_svc_ex).
        MESSAGE lo_svc_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_svc_ex.
    ENDTRY.
```
+  Per i dettagli sulle API, consulta [ AttachThingPrincipal ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) la sezione *AWS SDK for SAP ABAP API Reference. * 

### `CreateKeysAndCertificate`
<a name="iot_CreateKeysAndCertificate_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `CreateKeysAndCertificate`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    TRY.
        oo_result = lo_iot->createkeysandcertificate( iv_setasactive = abap_true ).
        MESSAGE |Certificate created: { oo_result->get_certificateid( ) }| TYPE 'I'.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_ex).
        MESSAGE lo_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_ex.
    ENDTRY.
```
+  Per i dettagli sull'API, consulta il riferimento [ CreateKeysAndCertificate ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) all'API ABAP *AWS SDK for SAP. * 

### `CreateThing`
<a name="iot_CreateThing_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `CreateThing`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    TRY.
        oo_result = lo_iot->creatething(
          iv_thingname = iv_thing_name ).
        MESSAGE |IoT thing created: { oo_result->get_thingname( ) } ARN: { oo_result->get_thingarn( ) }| TYPE 'I'.
      CATCH /aws1/cx_iotresrcalrdyexistsex.
        MESSAGE |IoT thing '{ iv_thing_name }' already exists.| TYPE 'I'.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_ex).
        MESSAGE lo_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_ex.
    ENDTRY.
```
+  Per i dettagli sulle API, consulta [ CreateThing ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) la sezione *AWS SDK for SAP ABAP API Reference. * 

### `CreateTopicRule`
<a name="iot_CreateTopicRule_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `CreateTopicRule`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    TRY.
        " Build the SNS action that will receive messages matching the rule.
        DATA lo_sns_action TYPE REF TO /aws1/cl_iotsnsaction.
        CREATE OBJECT lo_sns_action
          EXPORTING
            iv_targetarn = iv_sns_action_arn
            iv_rolearn   = iv_role_arn.

        DATA lo_action TYPE REF TO /aws1/cl_iotaction.
        CREATE OBJECT lo_action
          EXPORTING
            io_sns = lo_sns_action.

        DATA lt_actions TYPE /aws1/cl_iotaction=>tt_actionlist.
        APPEND lo_action TO lt_actions.

        " iv_topic = 'my/iot/topic' - The MQTT topic pattern to match
        DATA lo_payload TYPE REF TO /aws1/cl_iottopicrulepayload.
        CREATE OBJECT lo_payload
          EXPORTING
            iv_sql     = |SELECT * FROM '{ iv_topic }'|
            it_actions = lt_actions.

        lo_iot->createtopicrule(
          iv_rulename         = iv_rule_name
          io_topicrulepayload = lo_payload ).
        MESSAGE |IoT topic rule created: { iv_rule_name }| TYPE 'I'.
      CATCH /aws1/cx_iotresrcalrdyexistsex.
        MESSAGE |Topic rule '{ iv_rule_name }' already exists.| TYPE 'I'.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_ex).
        MESSAGE lo_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_ex.
    ENDTRY.
```
+  Per i dettagli sulle API, consulta [ CreateTopicRule ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) la sezione *AWS SDK for SAP ABAP API Reference. * 

### `DeleteCertificate`
<a name="iot_DeleteCertificate_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `DeleteCertificate`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    TRY.
        " Certificates must be deactivated before they can be deleted.
        lo_iot->updatecertificate(
          iv_certificateid = iv_certificate_id
          iv_newstatus     = 'INACTIVE' ).
        lo_iot->deletecertificate( iv_certificateid = iv_certificate_id ).
        MESSAGE |Certificate deleted: { iv_certificate_id }| TYPE 'I'.
      CATCH /aws1/cx_iotresourcenotfoundex INTO DATA(lo_ex).
        MESSAGE |Certificate '{ iv_certificate_id }' not found.| TYPE 'I'.
        RAISE EXCEPTION lo_ex.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_svc_ex).
        MESSAGE lo_svc_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_svc_ex.
    ENDTRY.
```
+  Per i dettagli sulle API, consulta [ DeleteCertificate ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) la sezione *AWS SDK for SAP ABAP API Reference. * 

### `DeleteThing`
<a name="iot_DeleteThing_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `DeleteThing`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    TRY.
        lo_iot->deletething( iv_thingname = iv_thing_name ).
        MESSAGE |IoT thing deleted: { iv_thing_name }| TYPE 'I'.
      CATCH /aws1/cx_iotresourcenotfoundex INTO DATA(lo_ex).
        MESSAGE |IoT thing '{ iv_thing_name }' not found.| TYPE 'I'.
        RAISE EXCEPTION lo_ex.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_svc_ex).
        MESSAGE lo_svc_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_svc_ex.
    ENDTRY.
```
+  Per i dettagli sulle API, consulta [ DeleteThing ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) la sezione *AWS SDK for SAP ABAP API Reference. * 

### `DeleteTopicRule`
<a name="iot_DeleteTopicRule_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `DeleteTopicRule`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    TRY.
        lo_iot->deletetopicrule( iv_rulename = iv_rule_name ).
        MESSAGE |IoT topic rule deleted: { iv_rule_name }| TYPE 'I'.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_ex).
        MESSAGE lo_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_ex.
    ENDTRY.
```
+  Per i dettagli sulle API, consulta [ DeleteTopicRule ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) la sezione *AWS SDK for SAP ABAP API Reference. * 

### `DescribeEndpoint`
<a name="iot_DescribeEndpoint_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `DescribeEndpoint`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    " iv_endpoint_type = 'iot:Data-ATS' - Endpoint type for data operations
    TRY.
        DATA(lo_result) = lo_iot->describeendpoint( iv_endpointtype = iv_endpoint_type ).
        ov_endpoint_address = lo_result->get_endpointaddress( ).
        MESSAGE |Endpoint address: { ov_endpoint_address }| TYPE 'I'.
      CATCH /aws1/cx_iotthrottlingex INTO DATA(lo_throttle_ex).
        MESSAGE 'Request throttled. Please try again later.' TYPE 'I'.
        RAISE EXCEPTION lo_throttle_ex.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_ex).
        MESSAGE lo_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_ex.
    ENDTRY.
```
+  Per i dettagli sulle API, consulta [ DescribeEndpoint ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) la sezione *AWS SDK for SAP ABAP API Reference. * 

### `DetachThingPrincipal`
<a name="iot_DetachThingPrincipal_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `DetachThingPrincipal`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    TRY.
        lo_iot->detachthingprincipal(
          iv_thingname = iv_thing_name
          iv_principal = iv_principal ).
        MESSAGE |Principal detached from IoT thing '{ iv_thing_name }'.| TYPE 'I'.
      CATCH /aws1/cx_iotresourcenotfoundex INTO DATA(lo_ex).
        MESSAGE |Resource not found when detaching principal from '{ iv_thing_name }'.| TYPE 'I'.
        RAISE EXCEPTION lo_ex.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_svc_ex).
        MESSAGE lo_svc_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_svc_ex.
    ENDTRY.
```
+  Per i dettagli sulle API, consulta [ DetachThingPrincipal ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) la sezione *AWS SDK for SAP ABAP API Reference. * 

### `ListCertificates`
<a name="iot_ListCertificates_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `ListCertificates`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    TRY.
        " Collect all certificates by following the pagination marker.
        DATA lv_marker TYPE /aws1/iotmarker.
        DATA lv_count  TYPE i.

        DO.
          oo_result = lo_iot->listcertificates( iv_marker = lv_marker ).
          lv_count  = lv_count + lines( oo_result->get_certificates( ) ).
          lv_marker = oo_result->get_nextmarker( ).
          IF lv_marker IS INITIAL.
            EXIT.
          ENDIF.
        ENDDO.

        MESSAGE |Retrieved { lv_count } IoT certificates.| TYPE 'I'.
      CATCH /aws1/cx_iotthrottlingex INTO DATA(lo_throttle_ex).
        MESSAGE 'Request throttled. Please try again later.' TYPE 'I'.
        RAISE EXCEPTION lo_throttle_ex.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_ex).
        MESSAGE lo_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_ex.
    ENDTRY.
```
+  Per i dettagli sulle API, consulta [ ListCertificates ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) la sezione *AWS SDK for SAP ABAP API Reference. * 

### `ListThings`
<a name="iot_ListThings_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `ListThings`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    TRY.
        " Collect all things by following the pagination token.
        DATA lv_nexttoken TYPE /aws1/iotnexttoken.
        DATA lv_count     TYPE i.

        DO.
          oo_result    = lo_iot->listthings( iv_nexttoken = lv_nexttoken ).
          lv_count     = lv_count + lines( oo_result->get_things( ) ).
          lv_nexttoken = oo_result->get_nexttoken( ).
          IF lv_nexttoken IS INITIAL.
            EXIT.
          ENDIF.
        ENDDO.

        MESSAGE |Retrieved { lv_count } IoT things.| TYPE 'I'.
      CATCH /aws1/cx_iotthrottlingex INTO DATA(lo_throttle_ex).
        MESSAGE 'Request throttled. Please try again later.' TYPE 'I'.
        RAISE EXCEPTION lo_throttle_ex.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_ex).
        MESSAGE lo_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_ex.
    ENDTRY.
```
+  Per i dettagli sulle API, consulta [ ListThings ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) la sezione *AWS SDK for SAP ABAP API Reference. * 

### `SearchIndex`
<a name="iot_SearchIndex_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `SearchIndex`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    " iv_query_string = 'thingName:MyThing*' - Fleet indexing query string
    TRY.
        oo_result = lo_iot->searchindex( iv_querystring = iv_query_string ).
        MESSAGE |Found { lines( oo_result->get_things( ) ) } IoT things matching query.| TYPE 'I'.
      CATCH /aws1/cx_iotindexnotreadyex INTO DATA(lo_idx_ex).
        MESSAGE 'Fleet indexing is not ready. Enable indexing with UpdateIndexingConfiguration first.' TYPE 'I'.
        RAISE EXCEPTION lo_idx_ex.
      CATCH /aws1/cx_iotthrottlingex INTO DATA(lo_throttle_ex).
        MESSAGE 'Request throttled. Please try again later.' TYPE 'I'.
        RAISE EXCEPTION lo_throttle_ex.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_ex).
        MESSAGE lo_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_ex.
    ENDTRY.
```
+  Per i dettagli sulle API, consulta [ SearchIndex ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) la sezione *AWS SDK for SAP ABAP API Reference. * 

### `UpdateIndexingConfiguration`
<a name="iot_UpdateIndexingConfiguration_sap-abap_1_topic"></a>

L’esempio di codice seguente mostra come utilizzare `UpdateIndexingConfiguration`.

**SDK per SAP ABAP**  
 C'è altro su. GitHub Trova l’esempio completo e scopri di più sulla configurazione e l’esecuzione nel [repository di esempi di codice AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/iot#code-examples). 

```
    CONSTANTS cv_pfl TYPE /aws1/rt_profile_id VALUE 'ZCODE_DEMO'.
    DATA(lo_session) = /aws1/cl_rt_session_aws=>create( cv_pfl ).
    DATA(lo_iot) = /aws1/cl_iot_factory=>create( lo_session ).
    TRY.
        DATA lo_idx_conf TYPE REF TO /aws1/cl_iotthingindexingconf.
        CREATE OBJECT lo_idx_conf
          EXPORTING
            iv_thingindexingmode = 'REGISTRY'.
        lo_iot->updateindexingconfiguration(
          io_thingindexingconf = lo_idx_conf ).
        MESSAGE 'IoT thing indexing configuration updated to REGISTRY mode.' TYPE 'I'.
      CATCH /aws1/cx_rt_service_generic INTO DATA(lo_ex).
        MESSAGE lo_ex->get_text( ) TYPE 'I'.
        RAISE EXCEPTION lo_ex.
    ENDTRY.
```
+  Per i dettagli sulle API, consulta [ UpdateIndexingConfiguration ](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) la sezione *AWS SDK for SAP ABAP API Reference. *