Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# aws-apigateway-sagemakerendpunkt
<a name="aws-apigateway-sagemakerendpoint"></a>

![](http://docs.aws.amazon.com/de_de/solutions/latest/constructs/images/experimental.png)


 Alle Klassen befinden sich in aktiver Entwicklung und unterliegen nicht abwärtskompatiblen Änderungen oder Entfernen in jeder zukünftigen Version. Diese unterliegen nicht der[Semantic Versioning](https://semver.org/)Modell. Dies bedeutet, dass Sie möglicherweise Ihren Quellcode aktualisieren müssen, wenn Sie ein Upgrade auf eine neuere Version dieses Pakets durchführen. 

**Hinweis:** Um eine ordnungsgemäße Funktionalität sicherzustellen, müssen die AWS Solutions Constructs Pakete und AWS CDK-Pakete in Ihrem Projekt dieselbe Version aufweisen. 


|  **Sprache**  |  **Paket**  | 
| --- | --- | 
|  ![](http://docs.aws.amazon.com/de_de/solutions/latest/constructs/images/python.png) Python  |  aws\_solutions\_constructs.aws\_apigateway\_sagemakerendpoint  | 
|  ![](http://docs.aws.amazon.com/de_de/solutions/latest/constructs/images/typescript.png) Typoskript  |  @aws-solutions-constructs/aws-apigateway-sagemakerendpoint  | 
|  ![](http://docs.aws.amazon.com/de_de/solutions/latest/constructs/images/java.png) Java  |  software.amazon.awsconstructs.services.apigatewaysagemakerendpoint  | 

## Overview
<a name="overview-33"></a>

 Dieses AWS Solutions Construct implementiert eine Amazon API Gateway REST-API, die mit einem Amazon SageMaker Endpunkt verbunden ist.

 Hier ist eine minimale bereitstellbare Musterdefinition in TypeScript: 

```
import { ApiGatewayToSageMakerEndpoint, ApiGatewayToSageMakerEndpointProps } from '@aws-solutions-constructs/aws-apigateway-sagemakerendpoint';

// Below is an example VTL (Velocity Template Language) mapping template for mapping the Api GET request to the Sagemaker POST request
const requestTemplate =
`{
    "instances": [
#set( $user_id = $input.params("user_id") )
#set( $items = $input.params("items") )
#foreach( $item in $items.split(",") )
    {"in0": [$user_id], "in1": [$item]}#if( $foreach.hasNext ),#end
    $esc.newline
#end
    ]
}`;

// Replace 'my-endpoint' with your Sagemaker Inference Endpoint
new ApiGatewayToSageMakerEndpoint(this, 'test-apigw-sagemakerendpoint', {
    endpointName: 'my-endpoint',
    resourcePath: '{user_id}',
    requestMappingTemplate: requestTemplate
});
```

## Initializer
<a name="initializer-33"></a>

```
new ApiGatewayToSageMakerEndpoint(scope: Construct, id: string, props: ApiGatewayToSageMakerEndpointProps);
```

 *Parameter* 
+  Bereich[https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html) 
+  id`string` 
+  props[`ApiGatewayToSageMakerEndpointProps`](#pattern-construct-props-33) 

## Muster-Konstrukt Requisiten
<a name="pattern-construct-props-33"></a>


|  **Name**  |  **Typ**  |  **Beschreibung**  | 
| --- | --- | --- | 
|  ApigatewayProps?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.RestApiProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.RestApiProps.html)  |  Optionale, vom Benutzer bereitgestellte Requisiten zum Überschreiben der Standard-Requisiten für die API Gateway REST-API  | 
|  ApigatewayExecutionRole?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html)  |  IAM-Rolle, die vom API Gateway zum Aufrufen des SageMaker Endpoints verwendet wird. Wenn nicht angegeben, wird eine Standardrolle mit Zugriff aufendpointName.  | 
|  EndpointName  |  string  |  Name des bereitgestellten SageMaker Inferenz-Endpunkts.  | 
|  ResourceName?  |  string  |  Optionaler Ressourcenname, bei dem die GET-Methode verfügbar ist.  | 
|  resourcePath  |  string  |  Ressourcenpfad für die GET-Methode. Die hier definierte Variable kann inrequestMappingTemplate.  | 
|  RequestMappingTemplate  |  string  |  Mapping-Vorlage zum Konvertieren von GET-Anforderungen, die über die REST-API empfangen wurden, in POST-Anfragen, die vom SageMaker End  | 
|  ResponseMappingTemplate?  |  string  |  Optionale Mapping-Vorlage zum Konvertieren von Antworten, die vom SageMaker Endpunkt empfangen wurden.  | 
|  LogGroupProps?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroupProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroupProps.html)  |  Optionale, vom Benutzer bereitgestellte Requisiten zum Überschreiben der Standardprops für die CloudWatch Logs s-Protokollgruppe.  | 

## Muster-Eigenschaften
<a name="pattern-properties-33"></a>


|  **Name**  |  **Typ**  |  **Beschreibung**  | 
| --- | --- | --- | 
|  ApiGateway  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.LambdaRestApi.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-apigateway.LambdaRestApi.html)  |  Gibt eine Instanz der API Gateway REST-API zurück, die durch das Muster erstellt wurde.  | 
|  ApigatewayRole  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html)  |  Gibt eine Instanz der IAM-Rolle zurück, die durch das Muster für die API Gateway REST-API erstellt wurde.  | 
|  ApigatewayCloudWatchRole  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html)  |  Gibt eine Instanz der IAM-Rolle zurück, die durch das Muster erstellt wurde, das die Zugriffsprotokollierung von der API Gateway REST-API zu CloudWatch ermöglicht.  | 
|  ApigatewayLogGroup  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroup.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-logs.LogGroup.html)  |  Gibt eine Instanz der Protokollgruppe zurück, die durch das Muster erstellt wurde, an das API Gateway REST-API-Zugriffsprotokolle gesendet werden.  | 

## Beispiele zu -API-Verwendung
<a name="sample-api-usage"></a>

**Hinweis:** Jeder SageMaker Endpunkt ist eindeutig, und die Antwort der API hängt vom bereitgestellten Modell ab. Das folgende Beispiel geht davon aus, dass die Probe von[Blogbeitrag](https://aws.amazon.com/blogs/machine-learning/creating-a-machine-learning-powered-rest-api-with-amazon-api-gateway-mapping-templates-and-amazon-sagemaker/). Eine Referenz dazu, wie das implementiert wird, finden Sie unter[integ.apigateway-sagemakerendpoint-overwrite.ts](https://github.com/awslabs/aws-solutions-constructs/blob/f02997ea4fa6515fc4429771d21821d2c26a8584/source/patterns/%40aws-solutions-constructs/aws-apigateway-sagemakerendpoint/test/integ.apigateway-sagemakerendpoint-overwrite.ts).


|  **Art**  |  **Anfrage-Pfad**  |  **Abfragezeichenfolge**  |  **SageMaker Aktion**  |  **Beschreibung**  | 
| --- | --- | --- | --- | --- | 
|  GET  |  /321  |  items=101,131,162  |  sagemaker:InvokeEndpoint  |  Ruft die Vorhersagen für einen bestimmten Benutzer und Elemente ab.  | 

## Standardeinstellungen
<a name="default-settings-33"></a>

 Die vorgefertigte Implementierung dieses Musters ohne Überschreibungen setzt die folgenden Standardwerte:

### Amazon API Gateway
<a name="amazon-api-gateway-33"></a>
+  Bereitstellen eines Edge-optimierten API-Endpunkts 
+  Aktivieren der CloudWatch Protokollierung für API Gateway 
+  Konfigurieren der IAM-Rolle für den Zugriff auf die geringste Berechtigung für API Gateway 
+  Legen Sie den standardmäßigen AuthorizationType für alle API-Methoden auf IAM fest 
+  X-Ray blaufverfolgung 
+  Überprüfen Sie Anforderungsparameter, bevor Sie Daten an SageMaker 

## Architecture
<a name="architecture-33"></a>

![](http://docs.aws.amazon.com/de_de/solutions/latest/constructs/images/aws-apigateway-sagemakerendpoint.png)


## GitHub
<a name="github-33"></a>


<table>
<thead>
  <tr><th colspan="2"> Um den Code für dieses Muster anzuzeigen, erstellen/anzeigen Probleme und Pull-Anforderungen usw.: </th></tr>
</thead>
<tbody>
  <tr><td> ![](http://docs.aws.amazon.com/de_de/solutions/latest/constructs/images/GitHub-Mark-32px.png) </td><td> [@aws -solutions-konstrukte/aws-apigateway-sagemakerendpoint](https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-apigateway-sagemakerendpoint) </td></tr>
</tbody>
</table>