本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# AWS::Serverless::NetworkConnector
<a name="sam-resource-networkconnector"></a>

 建立 AWS Lambda Network Connector，定義 Lambda 運算資源的網路連線能力。網路連接器指定運算資源如何連線至網路，例如，使用服務在指定的子網路和安全群組中佈建的彈性網路界面 (ENIs)，透過客戶 VPC 路由輸出流量。

**注意**  
當您部署到 時 AWS CloudFormation， 會將您的 AWS SAM 資源 AWS SAM CloudFormation 轉換為 資源。如需詳細資訊，請參閱[為 產生 CloudFormation 資源 AWS SAM](sam-specification-generated-resources.md)。

## 語法
<a name="sam-resource-networkconnector-syntax"></a>

若要在 AWS Serverless Application Model (AWS SAM) 範本中宣告此實體，請使用下列語法。

### YAML
<a name="sam-resource-networkconnector-syntax.yaml"></a>

```
Type: AWS::Serverless::NetworkConnector
Properties:
  [Name](#sam-networkconnector-name): {{String}}
  [OperatorRole](#sam-networkconnector-operatorrole): {{String}}
  [PropagateTags](#sam-networkconnector-propagatetags): {{Boolean}}
  [Tags](#sam-networkconnector-tags): {{Map}}
  [VpcConfig](#sam-networkconnector-vpcconfig): {{VpcConfig}}
```

## Properties
<a name="sam-resource-networkconnector-properties"></a>

 `Name`   <a name="sam-networkconnector-name"></a>
網路連接器的名稱。名稱在您的帳戶和區域中必須是唯一的。  
*類型：*字串  
*必要*：否  
*CloudFormation 相容性*：此屬性會直接傳遞至 `AWS::Lambda::NetworkConnector` 資源的 `[Name](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-name)` 屬性。

 `OperatorRole`   <a name="sam-networkconnector-operatorrole"></a>
網路連接器服務用來建立和管理彈性網路介面 (ENIs) 的 IAM 角色 ARN。  
*類型：*字串  
*必要*：否  
*CloudFormation 相容性*：此屬性類似於 `AWS::Lambda::NetworkConnector` 資源的 `[OperatorRole](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-operatorrole)` 屬性。這是在 中 CloudFormation 的必要項目，但不是在 中 AWS SAM。如果您未指定角色， 會 AWS SAM 建立邏輯 ID 為 的角色`{{<resource-logical-id>}}OperatorRole`。

 `PropagateTags`   <a name="sam-networkconnector-propagatetags"></a>
指定是否要將標籤從 `Tags` 屬性傳遞至產生的資源，例如自動產生的運算子角色。  
*類型*：布林值  
*必要*：否  
*預設*：`False`  
*CloudFormation 相容性*：此屬性對 是唯一的 AWS SAM ，並且沒有 CloudFormation 同等屬性。

 `Tags`   <a name="sam-networkconnector-tags"></a>
索引鍵/值對的映射，指定新增至此網路連接器的標籤。  
*類型*：映射  
*必要*：否  
*CloudFormation 相容性*：此屬性類似於 `AWS::Lambda::NetworkConnector` 資源的 `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html#cfn-lambda-networkconnector-tags)` 屬性。中的 `Tags` 屬性 AWS SAM 包含鍵值對 （而 CloudFormation 此屬性包含`Tag`物件清單）。此外， AWS SAM 會自動將`lambda:createdBy:SAM`標籤新增至此網路連接器，以及為其產生的預設角色。

 `VpcConfig`   <a name="sam-networkconnector-vpcconfig"></a>
網路連接器的 VPC 輸出組態。指定透過 VPC 路由傳出流量的子網路、安全群組和網路通訊協定。  
*類型*：[VpcConfig](sam-property-networkconnector-vpcconfig.md)  
*必要*：是  
*CloudFormation 相容性*：此屬性會轉換為 `AWS::Lambda::NetworkConnector` 資源的 `[Configuration.VpcEgressConfiguration](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-lambda-networkconnector-vpcegressconfiguration.html)` 屬性。 AWS SAM 也會`AssociatedComputeResourceTypes: [MicroVm]`自動注入。

## 傳回值
<a name="sam-resource-networkconnector-return-values"></a>

### Ref
<a name="sam-resource-networkconnector-return-values-ref"></a>

當將此資源的邏輯 ID 提供給`Ref`內部 函數時，它會傳回網路連接器的 ARN。

如需使用 `Ref`函數的詳細資訊，請參閱*AWS CloudFormation 《 使用者指南*[https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html)》中的 。

### Fn::GetAtt
<a name="sam-resource-networkconnector-return-values-fn--getatt"></a>

`Fn::GetAtt` 會傳回此類型之指定屬性的值。以下為可用屬性及傳回值的範例。

如需使用 的詳細資訊`Fn::GetAtt`，請參閱*AWS CloudFormation 《 使用者指南*[https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html)》中的 。

`Arn`  <a name="sam-networkconnector-getatt-arn"></a>
網路連接器的 Amazon Resource Name (ARN)。

`State`  <a name="sam-networkconnector-getatt-state"></a>
網路連接器的目前狀態。有效值為 `PENDING`、`ACTIVE`、`INACTIVE`、`DELETING`、 `FAILED`和 `DELETE_FAILED`。

## 範例
<a name="sam-resource-networkconnector-examples"></a>

### 具有自動產生角色的基本網路連接器
<a name="sam-resource-networkconnector-example-basic"></a>

下列範例會建立 VPC 輸出網路連接器。 AWS SAM 會自動產生運算子角色。

```
AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31

Resources:
  MyVpcConnector:
    Type: AWS::Serverless::NetworkConnector
    Properties:
      Name: my-vpc-connector
      VpcConfig:
        SubnetIds:
          - subnet-0abc123def4567890
          - subnet-0def456abc7890123
        SecurityGroupIds:
          - sg-0abc1234abcde0001
        NetworkProtocol: IPv4
      Tags:
        Environment: Production
```