VPC 使用的 Lattice 範例 AWS CLI

下列程式碼範例示範如何搭配 AWS Command Line Interface VPC Lattice 使用來執行動作和實作常見案例。

Actions 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會示範如何呼叫個別服務函數，但您可以在相關案例中查看內容中的動作。

每個範例都包含完整原始程式碼的連結，您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

動作

下列程式碼範例示範如何使用 create-listener。

AWS CLI

若要建立接聽程式

下列create-listener範例會建立具有預設規則的HTTPS接聽程式，將流量轉送至指定的 VPC Lattice 目標群組。


aws vpc-lattice create-listener \
    --name my-service-listener \
    --protocol HTTPS \
    --port 443 \
    --service-identifier svc-0285b53b2eEXAMPLE \
    --default-action file://listener-config.json

listener-config.json 的內容：


{
    "forward": {
        "targetGroups": [
            {
                "targetGroupIdentifier": "tg-0eaa4b9ab4EXAMPLE"
            }
        ]
    }
}

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE/listener/listener-07cc7fb0abEXAMPLE",
    "defaultAction": {
        "forward": {
            "targetGroups": [
                {
                    "targetGroupIdentifier": "tg-0eaa4b9ab4EXAMPLE",
                    "weight": 100
                }
            ]
        }
    },
    "id": "listener-07cc7fb0abEXAMPLE",
    "name": "my-service-listener",
    "port": 443,
    "protocol": "HTTPS",
    "serviceArn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "serviceId": "svc-0285b53b2eEXAMPLE"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的接聽程式。

如需API詳細資訊，請參閱命令參考 CreateListener中的。 AWS CLI

下列程式碼範例示範如何使用 create-service-network-service-association。

AWS CLI

若要建立服務關聯

下列create-service-network-service-association範例會將指定的服務與指定的服務網路建立關聯。


aws vpc-lattice create-service-network-service-association \
    --service-identifier svc-0285b53b2eEXAMPLE \
    --service-network-identifier sn-080ec7dc93EXAMPLE

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkserviceassociation/snsa-0e16955a8cEXAMPLE",
    "createdBy": "123456789012",
    "dnsEntry": {
        "domainName": "my-lattice-service-0285b53b2eEXAMPLE.7d67968.vpc-lattice-svcs.us-east-2.on.aws",
        "hostedZoneId": "Z09127221KTH2CEXAMPLE"
    },
    "id": "snsa-0e16955a8cEXAMPLE",
    "status": "CREATE_IN_PROGRESS"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的管理服務關聯。

如需API詳細資訊，請參閱命令參考 CreateServiceNetworkServiceAssociation中的。 AWS CLI

下列程式碼範例示範如何使用 create-service-network-vpc-association。

AWS CLI

建立VPC關聯

下列create-service-network-vpc-association範例會將指定的 vpc 與指定的服務網路建立關聯。指定的安全群組會控制中的哪些資源VPC可以存取服務網路及其服務。


aws vpc-lattice create-service-network-vpc-association \
    --vpc-identifier vpc-0a1b2c3d4eEXAMPLE \
    --service-network-identifier sn-080ec7dc93EXAMPLE \
    --security-group-ids sg-0aee16bc6cEXAMPLE

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkvpcassociation/snva-0821fc8631EXAMPLE",
    "createdBy": "123456789012",
    "id": "snva-0821fc8631EXAMPLE",
    "securityGroupIds": [
        "sg-0aee16bc6cEXAMPLE"
    ],
    "status": "CREATE_IN_PROGRESS"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的管理VPC關聯。

如需API詳細資訊，請參閱命令參考 CreateServiceNetworkVpcAssociation中的。 AWS CLI

下列程式碼範例示範如何使用 create-service-network。

AWS CLI

建立服務網路

下列create-service-network範例會建立具有指定名稱的服務網路。


aws vpc-lattice create-service-network \
    --name my-service-network

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetwork/sn-080ec7dc93EXAMPLE",
    "authType": "NONE",
    "id": "sn-080ec7dc93EXAMPLE",
    "name": "my-service-network"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的服務網路。

如需API詳細資訊，請參閱命令參考 CreateServiceNetwork中的。 AWS CLI

下列程式碼範例示範如何使用 create-service。

AWS CLI

建立服務

下列create-service範例會建立具有指定名稱的服務。


aws vpc-lattice create-service \
    --name my-lattice-service

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "authType": "NONE",
    "dnsEntry": {
        "domainName": "my-lattice-service-0285b53b2eEXAMPLE.1a2b3c4.vpc-lattice-svcs.us-east-2.on.aws",
        "hostedZoneId": "Z09127221KTH2CEXAMPLE"
    },
    "id": "svc-0285b53b2eEXAMPLE",
    "name": "my-lattice-service",
    "status": "CREATE_IN_PROGRESS"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南中的 Lattice 中的服務。 VPC

如需API詳細資訊，請參閱命令參考 CreateService中的。 AWS CLI

下列程式碼範例示範如何使用 create-target-group。

AWS CLI

範例 1：建立類型的目標群組 INSTANCE

下列create-target-group範例會建立具有指定名稱、類型和組態的目標群組。


aws vpc-lattice create-target-group \
    --name my-lattice-target-group-instance \
    --type INSTANCE \
    --config file://tg-config.json

tg-config.json 的內容：


{
    "port": 443,
    "protocol": "HTTPS",
    "protocolVersion": "HTTP1",
    "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
}

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE",
    "config": {
        "healthCheck": {
            "enabled": true,
            "healthCheckIntervalSeconds": 30,
            "healthCheckTimeoutSeconds": 5,
            "healthyThresholdCount": 5,
            "matcher": {
                "httpCode": "200"
            },
            "path": "/",
            "protocol": "HTTPS",
            "protocolVersion": "HTTP1",
            "unhealthyThresholdCount": 2
        },
        "port": 443,
        "protocol": "HTTPS",
        "protocolVersion": "HTTP1",
        "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
    },
    "id": "tg-0eaa4b9ab4EXAMPLE",
    "name": "my-lattice-target-group-instance",
    "status": "CREATE_IN_PROGRESS",
    "type": "INSTANCE"
}

範例 2：建立類型 IP 的目標群組

下列create-target-group範例會建立具有指定名稱、類型和組態的目標群組。


aws vpc-lattice create-target-group \
    --name my-lattice-target-group-ip \
    --type IP \
    --config file://tg-config.json

tg-config.json 的內容：


{
    "ipAddressType": "IPV4",
    "port": 443,
    "protocol": "HTTPS",
    "protocolVersion": "HTTP1",
    "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
}

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE",
    "config": {
        "healthCheck": {
            "enabled": true,
            "healthCheckIntervalSeconds": 30,
            "healthCheckTimeoutSeconds": 5,
            "healthyThresholdCount": 5,
            "matcher": {
                "httpCode": "200"
            },
            "path": "/",
            "protocol": "HTTPS",
            "protocolVersion": "HTTP1",
            "unhealthyThresholdCount": 2
        },
        "ipAddressType": "IPV4",
        "port": 443,
        "protocol": "HTTPS",
        "protocolVersion": "HTTP1",
        "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
    },
    "id": "tg-0eaa4b9ab4EXAMPLE",
    "name": "my-lattice-target-group-ip",
    "status": "CREATE_IN_PROGRESS",
    "type": "IP"
}

範例 3：建立類型的目標群組 LAMBDA

下列create-target-group範例會建立具有指定名稱、類型和組態的目標群組。


aws vpc-lattice create-target-group \
    --name my-lattice-target-group-lambda \
    --type LAMBDA

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE",
    "id": "tg-0eaa4b9ab4EXAMPLE",
    "name": "my-lattice-target-group-lambda",
    "status": "CREATE_IN_PROGRESS",
    "type": "LAMBDA"
}

範例 4：建立類型的目標群組 ALB

下列create-target-group範例會建立具有指定名稱、類型和組態的目標群組。


aws vpc-lattice create-target-group \
    --name my-lattice-target-group-alb \
    --type ALB \
    --config file://tg-config.json

tg-config.json 的內容：


{
    "port": 443,
    "protocol": "HTTPS",
    "protocolVersion": "HTTP1",
    "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
}

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE",
    "config": {
        "port": 443,
        "protocol": "HTTPS",
        "protocolVersion": "HTTP1",
        "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
    },
    "id": "tg-0eaa4b9ab4EXAMPLE",
    "name": "my-lattice-target-group-alb",
    "status": "CREATE_IN_PROGRESS",
    "type": "ALB"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的目標群組。

如需API詳細資訊，請參閱命令參考 CreateTargetGroup中的。 AWS CLI

下列程式碼範例示範如何使用 delete-auth-policy。

AWS CLI

若要刪除身分驗證政策

下列delete-auth-policy範例會刪除指定服務的驗證政策。


aws vpc-lattice delete-auth-policy \
    --resource-identifier svc-0285b53b2eEXAMPLE

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的身分驗證政策。

如需API詳細資訊，請參閱命令參考 DeleteAuthPolicy中的。 AWS CLI

下列程式碼範例示範如何使用 delete-listener。

AWS CLI

若要刪除接聽程式

下列delete-listener範例會刪除指定的接聽程式。


aws vpc-lattice delete-listener \
    --listener-identifier listener-07cc7fb0abEXAMPLE \
    --service-identifier svc-0285b53b2eEXAMPLE

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的接聽程式。

如需API詳細資訊，請參閱命令參考 DeleteListener中的。 AWS CLI

下列程式碼範例示範如何使用 delete-service-network-service-association。

AWS CLI

刪除服務關聯

下列delete-service-network-service-association範例會取消指定服務關聯的關聯。


aws vpc-lattice delete-service-network-service-association \
    --service-network-service-association-identifier snsa-031fabb4d8EXAMPLE

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkserviceassociation/snsa-031fabb4d8EXAMPLE",
    "id": "snsa-031fabb4d8EXAMPLE",
    "status": "DELETE_IN_PROGRESS"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的管理服務關聯。

如需API詳細資訊，請參閱命令參考 DeleteServiceNetworkServiceAssociation中的。 AWS CLI

下列程式碼範例示範如何使用 delete-service-network-vpc-association。

AWS CLI

若要刪除VPC關聯

下列delete-service-network-vpc-association範例會取消指定的VPC關聯。


aws vpc-lattice delete-service-network-vpc-association \
    --service-network-vpc-association-identifier snva-0821fc8631EXAMPLE

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkvpcassociation/snva-0821fc8631EXAMPLE",
    "id": "snva-0821fc8631EXAMPLE",
    "status": "DELETE_IN_PROGRESS"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的管理VPC關聯。

如需API詳細資訊，請參閱命令參考 DeleteServiceNetworkVpcAssociation中的。 AWS CLI

下列程式碼範例示範如何使用 delete-service-network。

AWS CLI

刪除服務網路

下列delete-service-network範例會刪除指定的服務網路。


aws vpc-lattice delete-service-network \
    --service-network-identifier sn-080ec7dc93EXAMPLE

此命令不會產生輸出。

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的服務網路。

如需API詳細資訊，請參閱命令參考 DeleteServiceNetwork中的。 AWS CLI

下列程式碼範例示範如何使用 delete-service。

AWS CLI

若要刪除服務

下列delete-service範例會刪除指定的服務。


aws vpc-lattice delete-service \
    --service-identifier svc-0285b53b2eEXAMPLE

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-west-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "id": "svc-0285b53b2eEXAMPLE",
    "name": "my-lattice-service",
    "status": "DELETE_IN_PROGRESS"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南中的 Lattice 中的服務。 VPC

如需API詳細資訊，請參閱命令參考 DeleteService中的。 AWS CLI

下列程式碼範例示範如何使用 delete-target-group。

AWS CLI

若要刪除目標群組

下列delete-target-group範例會刪除指定的目標群組。


aws vpc-lattice delete-target-group \
    --target-group-identifier tg-0eaa4b9ab4EXAMPLE

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE",
    "id": "tg-0eaa4b9ab4EXAMPLE",
    "status": "DELETE_IN_PROGRESS"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的目標群組。

如需API詳細資訊，請參閱命令參考 DeleteTargetGroup中的。 AWS CLI

下列程式碼範例示範如何使用 deregister-targets。

AWS CLI

若要取消註冊目標

下列deregister-targets範例會從指定的目標群組取消註冊指定的目標。


aws vpc-lattice deregister-targets \
    --targets i-07dd579bc5EXAMPLE \
    --target-group-identifier tg-0eaa4b9ab4EXAMPLE

輸出：


{
    "successful": [
        {
            "id": "i-07dd579bc5EXAMPLE",
            "port": 443
        }
    ],
    "unsuccessful": []
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的註冊目標。

如需API詳細資訊，請參閱命令參考 DeregisterTargets中的。 AWS CLI

下列程式碼範例示範如何使用 get-auth-policy。

AWS CLI

取得身分驗證政策的相關資訊

下列get-auth-policy範例取得指定服務之驗證政策的相關資訊。


aws vpc-lattice get-auth-policy \
    --resource-identifier svc-0285b53b2eEXAMPLE

輸出：


{
    "createdAt": "2023-06-07T03:51:20.266Z",
    "lastUpdatedAt": "2023-06-07T04:39:27.082Z",
    "policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:role/my-clients\"},\"Action\":\"vpc-lattice-svcs:Invoke\",\"Resource\":\"arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE\"}]}",
    "state": "Active"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的身分驗證政策。

如需API詳細資訊，請參閱命令參考 GetAuthPolicy中的。 AWS CLI

下列程式碼範例示範如何使用 get-listener。

AWS CLI

取得服務接聽程式的相關資訊

下列get-listener範例取得指定服務之指定接聽程式的相關資訊。


aws vpc-lattice get-listener \
    --listener-identifier listener-0ccf55918cEXAMPLE \
    --service-identifier svc-0285b53b2eEXAMPLE

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE/listener/listener-0ccf55918cEXAMPLE",
    "createdAt": "2023-05-07T05:08:45.192Z",
    "defaultAction": {
        "forward": {
            "targetGroups": [
                {
                    "targetGroupIdentifier": "tg-0ff213abb6EXAMPLE",
                    "weight": 1
                }
            ]
        }
    },
    "id": "listener-0ccf55918cEXAMPLE",
    "lastUpdatedAt": "2023-05-07T05:08:45.192Z",
    "name": "http-80",
    "port": 80,
    "protocol": "HTTP",
    "serviceArn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "serviceId": "svc-0285b53b2eEXAMPLE"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的定義路由。

如需API詳細資訊，請參閱命令參考 GetListener中的。 AWS CLI

下列程式碼範例示範如何使用 get-service-network-service-association。

AWS CLI

取得服務關聯的相關資訊

下列get-service-network-service-association範例取得指定服務關聯的相關資訊。


aws vpc-lattice get-service-network-service-association \
    --service-network-service-association-identifier snsa-031fabb4d8EXAMPLE

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkserviceassociation/snsa-031fabb4d8EXAMPLE",
    "createdAt": "2023-05-05T21:48:16.076Z",
    "createdBy": "123456789012",
    "dnsEntry": {
        "domainName": "my-lattice-service-0285b53b2eEXAMPLE.7d67968.vpc-lattice-svcs.us-east-2.on.aws",
        "hostedZoneId": "Z09127221KTH2CEXAMPLE"
    },
    "id": "snsa-031fabb4d8EXAMPLE",
    "serviceArn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "serviceId": "svc-0285b53b2eEXAMPLE",
    "serviceName": "my-lattice-service",
    "serviceNetworkArn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetwork/sn-080ec7dc93EXAMPLE",
    "serviceNetworkId": "sn-080ec7dc93EXAMPLE",
    "serviceNetworkName": "my-service-network",
    "status": "ACTIVE"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的管理服務關聯。

如需API詳細資訊，請參閱命令參考 GetServiceNetworkServiceAssociation中的。 AWS CLI

下列程式碼範例示範如何使用 get-service-network-vpc-association。

AWS CLI

取得VPC關聯的相關資訊

下列get-service-network-vpc-association範例會取得指定VPC關聯的相關資訊。


aws vpc-lattice get-service-network-vpc-association \
    --service-network-vpc-association-identifier snva-0821fc8631EXAMPLE

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetworkvpcassociation/snva-0821fc8631EXAMPLE",
    "createdAt": "2023-06-06T23:41:08.421Z",
    "createdBy": "123456789012",
    "id": "snva-0c5dcb60d6EXAMPLE",
    "lastUpdatedAt": "2023-06-06T23:41:08.421Z",
    "securityGroupIds": [
        "sg-0aee16bc6cEXAMPLE"
    ],
    "serviceNetworkArn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetwork/sn-080ec7dc93EXAMPLE",
    "serviceNetworkId": "sn-080ec7dc93EXAMPLE",
    "serviceNetworkName": "my-service-network",
    "status": "ACTIVE",
    "vpcId": "vpc-0a1b2c3d4eEXAMPLE"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的管理VPC關聯。

如需API詳細資訊，請參閱命令參考 GetServiceNetworkVpcAssociation中的。 AWS CLI

下列程式碼範例示範如何使用 get-service-network。

AWS CLI

取得服務網路的相關資訊

下列get-service-network範例取得指定服務網路的相關資訊。


aws vpc-lattice get-service-network \
    --service-network-identifier sn-080ec7dc93EXAMPLE

輸出：


{
   "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetwork/sn-080ec7dc93EXAMPLE",
   "authType": "AWS_IAM",
   "createdAt": "2023-05-05T15:26:08.417Z",
   "id": "sn-080ec7dc93EXAMPLE",
   "lastUpdatedAt": "2023-05-05T15:26:08.417Z",
   "name": "my-service-network",
   "numberOfAssociatedServices": 2,
   "numberOfAssociatedVPCs": 3
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的服務網路。

如需API詳細資訊，請參閱命令參考 GetServiceNetwork中的。 AWS CLI

下列程式碼範例示範如何使用 get-service。

AWS CLI

取得服務的相關資訊

下列get-service範例會取得指定服務的相關資訊。


aws vpc-lattice get-service \
    --service-identifier svc-0285b53b2eEXAMPLE

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "authType": "AWS_IAM",
    "createdAt": "2023-05-05T21:35:29.339Z",
    "dnsEntry": {
        "domainName": "my-lattice-service-0285b53b2eEXAMPLE.7d67968.vpc-lattice-svcs.us-east-2.on.aws",
        "hostedZoneId": "Z09127221KTH2CFUOHIZH"
    },
    "id": "svc-0285b53b2eEXAMPLE",
    "lastUpdatedAt": "2023-05-05T21:35:29.339Z",
    "name": "my-lattice-service",
    "status": "ACTIVE"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的服務。

如需API詳細資訊，請參閱命令參考 GetService中的。 AWS CLI

下列程式碼範例示範如何使用 get-target-group。

AWS CLI

取得目標群組的相關資訊

下列get-target-group範例取得指定目標群組的相關資訊，其目標類型為 INSTANCE。


aws vpc-lattice get-target-group \
    --target-group-identifier tg-0eaa4b9ab4EXAMPLE

輸出：


{
    "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-0eaa4b9ab4EXAMPLE",
    "config": {
        "healthCheck": {
            "enabled": true,
            "healthCheckIntervalSeconds": 30,
            "healthCheckTimeoutSeconds": 5,
            "healthyThresholdCount": 5,
            "matcher": {
                "httpCode": "200"
            },
            "path": "/",
            "protocol": "HTTPS",
            "protocolVersion": "HTTP1",
            "unhealthyThresholdCount": 2
        },
        "port": 443,
        "protocol": "HTTPS",
        "protocolVersion": "HTTP1",
        "vpcIdentifier": "vpc-f1663d9868EXAMPLE"
    },
    "createdAt": "2023-05-06T04:41:04.122Z",
    "id": "tg-0eaa4b9ab4EXAMPLE",
    "lastUpdatedAt": "2023-05-06T04:41:04.122Z",
    "name": "my-target-group",
    "serviceArns": [
        "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE"
    ],
    "status": "ACTIVE",
    "type": "INSTANCE"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的目標群組。

如需API詳細資訊，請參閱命令參考 GetTargetGroup中的。 AWS CLI

下列程式碼範例示範如何使用 list-listeners。

AWS CLI

列出服務接聽程式

下列list-listeners範例列出指定服務的接聽程式。


aws vpc-lattice list-listeners \
    --service-identifier svc-0285b53b2eEXAMPLE

輸出：


{
    "items": [
        {
            "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE/listener/listener-0ccf55918cEXAMPLE",
            "createdAt": "2023-05-07T05:08:45.192Z",
            "id": "listener-0ccf55918cEXAMPLE",
            "lastUpdatedAt": "2023-05-07T05:08:45.192Z",
            "name": "http-80",
            "port": 80,
            "protocol": "HTTP"
        }
    ]
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的定義路由。

如需API詳細資訊，請參閱命令參考 ListListeners中的。 AWS CLI

下列程式碼範例示範如何使用 list-service-network-service-associations。

AWS CLI

列出服務關聯

下列list-service-network-service-associations範例列出指定服務網路的服務關聯。--query 選項會將輸出範圍設為IDs服務關聯的。


aws vpc-lattice list-service-network-service-associations \
    --service-network-identifier sn-080ec7dc93EXAMPLE \
    --query items[*].id

輸出：


[
    "snsa-031fabb4d8EXAMPLE",
    "snsa-0e16955a8cEXAMPLE"
]

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的管理服務關聯。

如需API詳細資訊，請參閱命令參考 ListServiceNetworkServiceAssociations中的。 AWS CLI

下列程式碼範例示範如何使用 list-service-network-vpc-associations。

AWS CLI

若要列出VPC關聯

下列list-service-network-vpc-associations範例列出指定服務網路的VPC關聯。--query 選項會將輸出範圍設為VPC關聯IDs中的。


aws vpc-lattice list-service-network-vpc-associations \
    --service-network-identifier sn-080ec7dc93EXAMPLE \
    --query items[*].id

輸出：


[
    "snva-0821fc8631EXAMPLE",
    "snva-0c5dcb60d6EXAMPLE"
]

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的管理VPC關聯。

如需API詳細資訊，請參閱命令參考 ListServiceNetworkVpcAssociations中的。 AWS CLI

下列程式碼範例示範如何使用 list-service-networks。

AWS CLI

列出您的服務網路

下列list-service-networks範例列出與呼叫帳戶擁有或共用的服務網路。--query 選項會將結果範圍設為服務網路的 Amazon Resource Names （ARN）。


aws vpc-lattice list-service-networks \
    --query items[*].arn

輸出：


[
    "arn:aws:vpc-lattice:us-east-2:123456789012:servicenetwork/sn-080ec7dc93EXAMPLE",
    "arn:aws:vpc-lattice:us-east-2:111122223333:servicenetwork/sn-0ec4d436cfEXAMPLE"
]

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的服務網路。

如需API詳細資訊，請參閱命令參考 ListServiceNetworks中的。 AWS CLI

下列程式碼範例示範如何使用 list-services。

AWS CLI

列出您的服務

下列list-services範例列出與呼叫帳戶擁有或共用的服務。--query 選項會將結果範圍設為服務的 Amazon Resource Names （ARN）。


aws vpc-lattice list-services \
    --query items[*].arn

輸出：


[
    "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE",
    "arn:aws:vpc-lattice:us-east-2:111122223333:service/svc-0b8ac96550EXAMPLE"
]

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的服務。

如需API詳細資訊，請參閱命令參考 ListServices中的。 AWS CLI

下列程式碼範例示範如何使用 list-target-groups。

AWS CLI

列出您的目標群組

下列list-target-groups範例列出目標類型為的目標群組LAMBDA。


aws vpc-lattice list-target-groups \
    --target-group-type LAMBDA

輸出：


{
    "items": [
        {
            "arn": "arn:aws:vpc-lattice:us-east-2:123456789012:targetgroup/tg-045c1b7d9dEXAMPLE",
            "createdAt": "2023-05-06T05:22:16.637Z",
            "id": "tg-045c1b7d9dEXAMPLE",
            "lastUpdatedAt": "2023-05-06T05:22:16.637Z",
            "name": "my-target-group-lam",
            "serviceArns": [
                "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE"
            ],
            "status": "ACTIVE",
            "type": "LAMBDA"
        }
    ]
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的目標群組。

如需API詳細資訊，請參閱命令參考 ListTargetGroups中的。 AWS CLI

下列程式碼範例示範如何使用 list-targets。

AWS CLI

列出目標群組的目標

下列list-targets範例列出指定目標群組的目標。


aws vpc-lattice list-targets \
    --target-group-identifier tg-0eaa4b9ab4EXAMPLE

輸出：


{
    "items": [
        {
            "id": "i-07dd579bc5EXAMPLE",
            "port": 443,
            "status": "HEALTHY"
        },
        {
            "id": "i-047b3c9078EXAMPLE",
            "port": 443,
            "reasonCode": "HealthCheckFailed",
            "status": "UNHEALTHY"
        }
    ]
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的目標群組。

如需API詳細資訊，請參閱命令參考 ListTargets中的。 AWS CLI

下列程式碼範例示範如何使用 put-auth-policy。

AWS CLI

建立服務的驗證政策

下列put-auth-policy範例會授予來自使用指定IAM角色之任何已驗證主體的請求存取權。資源是附加政策的服務ARN的。


aws vpc-lattice put-auth-policy \
    --resource-identifier svc-0285b53b2eEXAMPLE \
    --policy file://auth-policy.json

auth-policy.json 的內容：


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/my-clients"
            },
            "Action": "vpc-lattice-svcs:Invoke",
            "Resource": "arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE"
        }
    ]
}

輸出：


{
    "policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:role/my-clients\"},\"Action\":\"vpc-lattice-svcs:Invoke\",\"Resource\":\"arn:aws:vpc-lattice:us-east-2:123456789012:service/svc-0285b53b2eEXAMPLE\"}]}",
    "state": "Active"
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的身分驗證政策。

如需API詳細資訊，請參閱命令參考 PutAuthPolicy中的。 AWS CLI

下列程式碼範例示範如何使用 register-targets。

AWS CLI

註冊目標

下列register-targets範例會向指定的目標群組註冊指定的目標。


aws vpc-lattice register-targets \
    --targets id=i-047b3c9078EXAMPLE id=i-07dd579bc5EXAMPLE \
    --target-group-identifier tg-0eaa4b9ab4EXAMPLE

輸出：


{
    "successful": [
        {
            "id": "i-07dd579bc5EXAMPLE",
            "port": 443
        }
    ],
    "unsuccessful": [
        {
            "failureCode": "UnsupportedTarget",
            "failureMessage": "Instance targets must be in the same VPC as their target group",
            "id": "i-047b3c9078EXAMPLE",
            "port": 443
        }
    ]
}

如需詳細資訊，請參閱 Amazon VPC Lattice 使用者指南 中的註冊目標。

如需API詳細資訊，請參閱命令參考 RegisterTargets中的。 AWS CLI

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

Verified Permissions

AWS WAF Classic

VPC 使用 的 Lattice 範例 AWS CLI

主題

動作

VPC 使用的 Lattice 範例 AWS CLI