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à.

# HttpApi
<a name="sam-property-function-httpapi"></a>

L'oggetto che descrive un'origine di eventi con tipo HttpApi.

Se nell'API esiste una OpenApi definizione per il percorso e il metodo specificati, SAM aggiungerà automaticamente la sezione sull'integrazione e la sicurezza Lambda (se applicabile).

Se nell'API non esiste alcuna OpenApi definizione per il percorso e il metodo specificati, SAM la creerà automaticamente.

## Sintassi
<a name="sam-property-function-httpapi-syntax"></a>

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

### YAML
<a name="sam-property-function-httpapi-syntax.yaml"></a>

```
  [ApiId](#sam-function-httpapi-apiid): String
  [Auth](#sam-function-httpapi-auth): HttpApiFunctionAuth
  [Method](#sam-function-httpapi-method): String
  [Path](#sam-function-httpapi-path): String
  [PayloadFormatVersion](#sam-function-httpapi-payloadformatversion): String
  [RouteSettings](#sam-function-httpapi-routesettings): [RouteSettings](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-routesettings)
  [TimeoutInMillis](#sam-function-httpapi-timeoutinmillis): Integer
```

## Properties
<a name="sam-property-function-httpapi-properties"></a>

 `ApiId`   <a name="sam-function-httpapi-apiid"></a>
Identificatore di una [AWS::Serverless::HttpApi](sam-resource-httpapi.md) risorsa definita in questo modello.  
Se non è definita, viene creata una [AWS::Serverless::HttpApi](sam-resource-httpapi.md) risorsa predefinita chiamata `ServerlessHttpApi` utilizzando un OpenApi documento generato contenente un'unione di tutti i percorsi e i metodi definiti dagli eventi Api definiti in questo modello che non specificano un`ApiId`.  
Questo non può fare riferimento a una [AWS::Serverless::HttpApi](sam-resource-httpapi.md) risorsa definita in un altro modello.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Auth`   <a name="sam-function-httpapi-auth"></a>
Configurazione di autenticazione per questo specifico metodo Api\$1Path\$1.  
Utile per sovrascrivere le API `DefaultAuthorizer` o impostare la configurazione di autenticazione su un percorso individuale quando non è specificato. `DefaultAuthorizer`  
*Tipo:* [HttpApiFunctionAuth](sam-property-function-httpapifunctionauth.md)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `Method`   <a name="sam-function-httpapi-method"></a>
Metodo HTTP per il quale viene richiamata questa funzione.  
Se non `Method` viene specificato alcun `Path` e, SAM creerà un percorso API predefinito che indirizza qualsiasi richiesta che non sia mappata a un endpoint diverso per questa funzione Lambda. Può esistere solo uno di questi percorsi predefiniti per API.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `Path`   <a name="sam-function-httpapi-path"></a>
Percorso Uri per il quale viene richiamata questa funzione. Deve iniziare con`/`.  
Se non `Method` viene specificato alcun `Path` e, SAM creerà un percorso API predefinito che indirizza qualsiasi richiesta che non sia mappata a un endpoint diverso per questa funzione Lambda. Può esistere solo uno di questi percorsi predefiniti per API.  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `PayloadFormatVersion`   <a name="sam-function-httpapi-payloadformatversion"></a>
Specifica il formato del payload inviato a un'integrazione.  
NOTA: PayloadFormatVersion richiede che SAM modifichi la definizione di OpenAPI, quindi funziona solo con inline OpenApi definito nella proprietà. `DefinitionBody`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*Predefinito*: 2.0  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

 `RouteSettings`   <a name="sam-function-httpapi-routesettings"></a>
Le impostazioni del percorso per percorso per questa API HTTP. Per ulteriori informazioni sulle impostazioni del percorso, consulta [AWS::ApiGatewayV2::Stage RouteSettings](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-apigatewayv2-stage-routesettings.html)la *Guida per gli sviluppatori di API Gateway*.  
Nota: se RouteSettings sono specificate sia nella HttpApi risorsa che nell'origine dell'evento, le AWS SAM unisce alle proprietà dell'origine dell'evento che hanno la precedenza.  
*Tipo:* [RouteSettings](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-routesettings)  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà viene passata direttamente alla `[RouteSettings](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-stage.html#cfn-apigatewayv2-stage-routesettings)` proprietà di una `AWS::ApiGatewayV2::Stage` risorsa.

 `TimeoutInMillis`   <a name="sam-function-httpapi-timeoutinmillis"></a>
Timeout personalizzato tra 50 e 29.000 millisecondi.  
NOTA: TimeoutInMillis richiede che SAM modifichi la definizione di OpenAPI, quindi funziona solo con inline OpenApi definito nella proprietà. `DefinitionBody`  
*Tipo*: integer  
*Obbligatorio:* no  
Valore *predefinito*: 5000  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

## Esempi
<a name="sam-property-function-httpapi--examples"></a>

### HttpApi Evento predefinito
<a name="sam-property-function-httpapi--examples--default-httpapi-event"></a>

HttpApi Evento che utilizza il percorso predefinito. Tutti i percorsi e i metodi non mappati su questa API verranno indirizzati a questo endpoint.

#### YAML
<a name="sam-property-function-httpapi--examples--default-httpapi-event--yaml"></a>

```
Events:
  HttpApiEvent:
    Type: HttpApi
```

### HttpApi
<a name="sam-property-function-httpapi--examples--httpapi"></a>

HttpApi Evento che utilizza un percorso e un metodo specifici.

#### YAML
<a name="sam-property-function-httpapi--examples--httpapi--yaml"></a>

```
Events:
  HttpApiEvent:
    Type: HttpApi
    Properties:
      Path: /
      Method: GET
```

### HttpApi Autorizzazione
<a name="sam-property-function-httpapi--examples--httpapi-authorization"></a>

HttpApi Evento che utilizza un Authorizer.

#### YAML
<a name="sam-property-function-httpapi--examples--httpapi-authorization--yaml"></a>

```
Events:
  HttpApiEvent:
    Type: HttpApi
    Properties:
      Path: /authenticated
      Method: GET
      Auth:
        Authorizer: OpenIdAuth
        AuthorizationScopes:
          - scope1
          - scope2
```

# HttpApiFunctionAuth
<a name="sam-property-function-httpapifunctionauth"></a>

Configura l'autorizzazione a livello di evento.

Configura l'autenticazione per un metodo API \$1 Path \$1 specifico

## Sintassi
<a name="sam-property-function-httpapifunctionauth-syntax"></a>

Per dichiarare questa entità nel tuo modello AWS Serverless Application Model (AWS SAM), usa la seguente sintassi.

### YAML
<a name="sam-property-function-httpapifunctionauth-syntax.yaml"></a>

```
  [AuthorizationScopes](#sam-function-httpapifunctionauth-authorizationscopes): List
  [Authorizer](#sam-function-httpapifunctionauth-authorizer): String
```

## Properties
<a name="sam-property-function-httpapifunctionauth-properties"></a>

 `AuthorizationScopes`   <a name="sam-function-httpapifunctionauth-authorizationscopes"></a>
Gli ambiti di autorizzazione da applicare a questa API, percorso e metodo.  
Gli ambiti elencati qui sostituiranno tutti gli ambiti applicati da, se ne esiste uno. `DefaultAuthorizer`  
Tipo: elenco  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un equivalente. CloudFormation 

 `Authorizer`   <a name="sam-function-httpapifunctionauth-authorizer"></a>
Il `Authorizer` per una funzione specifica. Per utilizzare l'autorizzazione IAM, specifica `AWS_IAM` e specifica `true` for `EnableIamAuthorizer` nella `Globals` sezione del modello.  
Se hai specificato un Global Authorizer sull'API e desideri rendere pubblica una funzione specifica, esegui l'override `Authorizer` impostando su. `NONE`  
▬*Tipo:* stringa  
*Obbligatorio:* no  
*CloudFormation compatibilità*: questa proprietà è unica AWS SAM e non ha un CloudFormation equivalente.

## Esempi
<a name="sam-property-function-httpapifunctionauth--examples"></a>

### Autenticazione della funzione
<a name="sam-property-function-httpapifunctionauth--examples--function-auth"></a>

Specificazione dell'autorizzazione a livello di funzione

#### YAML
<a name="sam-property-function-httpapifunctionauth--examples--function-auth--yaml"></a>

```
Auth:
  Authorizer: OpenIdAuth
  AuthorizationScopes:
    - scope1
    - scope2
```

### Autorizzazione IAM
<a name="sam-property-function-httpapifunctionauth--examples--iam-authorization"></a>

Specifica l'autorizzazione IAM a livello di evento. Per utilizzare `AWS_IAM` l'autorizzazione a livello di evento, è inoltre necessario specificare `true` for `EnableIamAuthorizer` nella `Globals` sezione del modello. Per ulteriori informazioni, consulta [Sezione Globals del modello AWS SAM](sam-specification-template-anatomy-globals.md).

#### YAML
<a name="sam-property-function-httpapifunctionauth--examples--iam-authorization--yaml"></a>

```
Globals:
  HttpApi:
    Auth:
      EnableIamAuthorizer: true

Resources:
  HttpApiFunctionWithIamAuth:
    Type: AWS::Serverless::Function
    Properties:
      Events:
        ApiEvent:
          Type: HttpApi
          Properties:
            Path: /iam-auth
            Method: GET
            Auth:
              Authorizer: AWS_IAM
      Handler: index.handler
      InlineCode: |
        def handler(event, context):
          return {'body': 'HttpApiFunctionWithIamAuth', 'statusCode': 200}
      Runtime: python3.9
```