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.

# ResourceReference
<a name="sam-property-connector-resourcereference"></a>

Ein Verweis auf eine Ressource, die der [AWS::Serverless::Connector](sam-resource-connector.md) Ressourcentyp verwendet.

**Anmerkung**  
Geben Sie für Ressourcen in derselben Vorlage den an`Id`. Verwenden Sie für Ressourcen, die nicht in derselben Vorlage enthalten sind, eine Kombination anderer Eigenschaften. Weitere Informationen finden Sie unter [AWS SAM Steckverbinderreferenz](reference-sam-connector.md).

## Syntax
<a name="sam-property-connector-resourcereference-syntax"></a>

Verwenden Sie die folgende Syntax, um diese Entität in Ihrer Vorlage AWS Serverless Application Model (AWS SAM) zu deklarieren.

### YAML
<a name="sam-property-connector-resourcereference-syntax.yaml"></a>

```
  [Arn](#sam-connector-resourcereference-arn): String
  [Id](#sam-connector-resourcereference-id): String
  [Name](#sam-connector-resourcereference-name): String
  [Qualifier](#sam-connector-resourcereference-qualifier): String
  [QueueUrl](#sam-connector-resourcereference-queueurl): String
  [ResourceId](#sam-connector-resourcereference-resourceid): String
  [RoleName](#sam-connector-resourcereference-rolename): String
  [Type](#sam-connector-resourcereference-type): String
```

## Eigenschaften
<a name="sam-property-connector-resourcereference-properties"></a>

 `Arn`   <a name="sam-connector-resourcereference-arn"></a>
Der ARN einer Ressource.  
*Typ:* Zeichenfolge  
*Required*: Conditional  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `Id`   <a name="sam-connector-resourcereference-id"></a>
Die [logische ID](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html) einer Ressource in derselben Vorlage.  
Wenn angegeben, `Id` wird, wenn der Connector AWS Identity and Access Management (IAM-) Richtlinien generiert, die diesen Richtlinien zugeordnete IAM-Rolle aus der Ressource abgeleitet. `Id` Wenn nicht angegeben, `Id` wird die Ressource für `RoleName` Connectors bereitgestellt, um generierte IAM-Richtlinien an eine IAM-Rolle anzuhängen.
*Typ:* Zeichenfolge  
*Required*: Conditional  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `Name`   <a name="sam-connector-resourcereference-name"></a>
Der Name einer -Ressource.  
*Typ:* Zeichenfolge  
*Required*: Conditional  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `Qualifier`   <a name="sam-connector-resourcereference-qualifier"></a>
Ein Qualifikator für eine Ressource, der ihren Umfang einschränkt. `Qualifier`ersetzt den `*` Wert am Ende einer Ressourcenbeschränkung ARN. Ein Beispiel finden Sie unter [API Gateway, das eine Lambda-Funktion aufruft](#sam-property-connector-resourcereference--examples--api-gateway-invoking-a-lambda-function).  
Die Definition des Qualifikators variiert je nach Ressourcentyp. Eine Liste der unterstützten Quell- und Zielressourcentypen finden Sie unter[AWS SAM Steckverbinderreferenz](reference-sam-connector.md).
*Typ:* Zeichenfolge  
*Required*: Conditional  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `QueueUrl`   <a name="sam-connector-resourcereference-queueurl"></a>
Die URL der Amazon SQS SQS-Warteschlange. Diese Eigenschaft gilt nur für Amazon SQS SQS-Ressourcen.  
*Typ:* Zeichenfolge  
*Required*: Conditional  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `ResourceId`   <a name="sam-connector-resourcereference-resourceid"></a>
Die ID einer Ressource. Zum Beispiel die API-Gateway-API-ID.  
*Typ:* Zeichenfolge  
*Required*: Conditional  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `RoleName`   <a name="sam-connector-resourcereference-rolename"></a>
Der Rollenname, der einer Ressource zugeordnet ist.  
Wenn angegeben, `Id` wird, wenn der Connector IAM-Richtlinien generiert, die diesen Richtlinien zugeordnete IAM-Rolle aus der Ressource abgeleitet. `Id` Wenn nicht angegeben, `Id` wird die Ressource für Connectoren bereitgestellt`RoleName`, um generierte IAM-Richtlinien an eine IAM-Rolle anzuhängen.
*Typ:* Zeichenfolge  
*Required*: Conditional  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

 `Type`   <a name="sam-connector-resourcereference-type"></a>
Der CloudFormation Typ einer Ressource. Weitere Informationen finden Sie in der [Referenz zu AWS Ressourcen- und Eigenschaftstypen](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-template-resource-type-ref.html).  
*Typ:* Zeichenfolge  
*Required*: Conditional  
*CloudFormation Kompatibilität*: Diese Eigenschaft ist einzigartig für AWS SAM und hat kein CloudFormation Äquivalent.

## Beispiele
<a name="sam-property-connector-resourcereference--examples"></a>

### API Gateway, das eine Lambda-Funktion aufruft
<a name="sam-property-connector-resourcereference--examples--api-gateway-invoking-a-lambda-function"></a>

Das folgende Beispiel verwendet die [AWS::Serverless::Connector](sam-resource-connector.md) Ressource, um Amazon API Gateway das Aufrufen einer AWS Lambda Funktion zu ermöglichen.

#### YAML
<a name="sam-property-connector-resourcereference--examples--api-gateway-invoking-a-lambda-function--yaml"></a>

```
Transform: AWS::Serverless-2016-10-31
Resources:
  MyRole:
    Type: AWS::IAM::Role
    Properties:
      AssumeRolePolicyDocument:
        Statement:
          - Effect: Allow
            Action: sts:AssumeRole
            Principal:
              Service: lambda.amazonaws.com
      ManagedPolicyArns:
        - !Sub arn:${AWS::Partition}:iam::aws:policy/service-role/AWSLambdaBasicExecutionRole

  MyFunction:
    Type: AWS::Lambda::Function
    Properties:
      Role: !GetAtt MyRole.Arn
      Runtime: nodejs16.x
      Handler: index.handler
      Code:
        ZipFile: |
          exports.handler = async (event) => {
            return {
              statusCode: 200,
              body: JSON.stringify({
                "message": "It works!"
              }),
            };
          };

  MyApi:
    Type: AWS::ApiGatewayV2::Api
    Properties:
      Name: MyApi
      ProtocolType: HTTP

  MyStage:
    Type: AWS::ApiGatewayV2::Stage
    Properties:
      ApiId: !Ref MyApi
      StageName: prod
      AutoDeploy: True

  MyIntegration:
    Type: AWS::ApiGatewayV2::Integration
    Properties:
      ApiId: !Ref MyApi
      IntegrationType: AWS_PROXY
      IntegrationUri: !Sub arn:aws:apigateway:${AWS::Region}:lambda:path/2015-03-31/functions/${MyFunction.Arn}/invocations
      IntegrationMethod: POST
      PayloadFormatVersion: "2.0"

  MyRoute:
    Type: AWS::ApiGatewayV2::Route
    Properties:
      ApiId: !Ref MyApi
      RouteKey: GET /hello
      Target: !Sub integrations/${MyIntegration}

  MyConnector:
    Type: AWS::Serverless::Connector
    Properties:
      Source: # Use 'Id' when resource is in the same template
        Type: AWS::ApiGatewayV2::Api
        ResourceId: !Ref MyApi
        Qualifier: prod/GET/hello # Or "*" to allow all routes
      Destination: # Use 'Id' when resource is in the same template
        Type: AWS::Lambda::Function
        Arn: !GetAtt MyFunction.Arn
      Permissions:
        - Write

Outputs:
  Endpoint:
    Value: !Sub https://${MyApi}.execute-api.${AWS::Region}.${AWS::URLSuffix}/prod/hello
```