Beispiele für VPC Lattice mit AWS CLI - AWS Command Line Interface
Aktionen

Beispiele für VPC Lattice mit AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit VPC Lattice verwenden.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie create-listener verwendet wird.

AWS CLI

So erstellen Sie einen Listener

Im folgenden Beispiel für create-listener wird ein HTTPS-Listener mit einer Standardregel erstellt, die den Datenverkehr an die angegebene VPC Lattice-Zielgruppe weiterleitet.

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

Inhalt von listener-config.json:

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

Ausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Listeners im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter CreateListener in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-resource-configuration verwendet wird.

AWS CLI

So erstellen Sie eine Synchronisierungskonfiguartion

Im folgenden Beispiel für create-resource-configuration wird eine Ressourcenkonfiguration erstellt, die eine einzelne IPv4-Adresse angibt.

aws vpc-lattice create-resource-configuration \
    --name my-resource-config \
    --type SINGLE \
    --resource-gateway-identifier rgw-0bba03f3d56060135 \
    --resource-configuration-definition 'ipResource={ipAddress=10.0.14.85}'

Ausgabe:

{
    "allowAssociationToShareableServiceNetwork": true,
    "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-07129f3acded87625",
    "id": "rcfg-07129f3acded87625",
    "name": "my-resource-config",
    "portRanges": [
        "1-65535"
    ],
    "protocol": "TCP",
    "resourceConfigurationDefinition": {
        "ipResource": {
            "ipAddress": "10.0.14.85"
        }
    },
    "resourceGatewayId": "rgw-0bba03f3d56060135",
    "status": "ACTIVE",
    "type": "SINGLE"
}

Weitere Informationen finden Sie unter Ressourcenkonfigurationen für VPC-Ressourcen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie create-resource-gateway verwendet wird.

AWS CLI

So erstellen Sie ein Ressourcen-Gateway

Im folgenden Beispiel für create-resource-gateway wird ein Ressourcen-Gateway für das angegebene Subnetz erstellt.

aws vpc-lattice create-resource-gateway \
    --name my-resource-gateway \
    --vpc-identifier vpc-0bf4c2739bc05a69 \
    --subnet-ids subnet-08e8943905b63a683

Ausgabe:

{
    "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourcegateway/rgw-0bba03f3d56060135",
    "id": "rgw-0bba03f3d56060135",
    "ipAddressType": "IPV4",
    "name": "my-resource-gateway",
    "securityGroupIds": [
        "sg-087ffd596c5fe962c"
    ],
    "status": "ACTIVE",
    "subnetIds": [
        "subnet-08e8943905b63a683"
    ],
    "vpcIdentifier": "vpc-0bf4c2739bc05a694"
}

Weitere Informationen finden Sie unter Ressourcen-Gateways in VPC Lattice im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie create-service-network-service-association verwendet wird.

AWS CLI

So erstellen Sie eine Servicezuordnung

Im folgenden Beispiel für create-service-network-service-association wird der angegebene Service dem angegebenen Servicenetzwerk zugeordnet.

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

Ausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Verwalten von Servicezuordnungen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie create-service-network-vpc-association verwendet wird.

AWS CLI

So erstellen Sie eine VPC-Zuordnung

Im folgenden Beispiel für create-service-network-vpc-association wird die angegebene VPC dem angegebenen Servicenetzwerk zugeordnet. Die angegebene Sicherheitsgruppe steuert, welche Ressourcen in der VPC auf das Servicenetzwerk und seine Services zugreifen können.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Verwalten von VPC-Zuordnungen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie create-service-network verwendet wird.

AWS CLI

So erstellen Sie ein Servicenetzwerk

Im folgenden Beispiel für create-service-network wird ein Servicenetzwerk mit dem angegebenen Namen erstellt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Servicenetzwerke im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie create-service verwendet wird.

AWS CLI

So erstellen Sie einen Service

Im folgenden Beispiel für create-service wird ein Service mit dem angegebenen Namen erstellt.

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

Ausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Services in VPC Lattice im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter CreateService in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-target-group verwendet wird.

AWS CLI

Beispiel 1: So erstellen Sie eine Zielgruppe vom Typ INSTANCE

Im folgenden Beispiel für create-target-group wird eine Zielgruppe mit dem angegebenen Namen, Typ und der angegebenen Konfiguration erstellt.

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

Inhalt von tg-config.json:

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

Ausgabe:

{
    "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"
}

Beispiel 2: So erstellen Sie eine Zielgruppe vom Typ IP

Im folgenden Beispiel für create-target-group wird eine Zielgruppe mit dem angegebenen Namen, Typ und der angegebenen Konfiguration erstellt.

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

Inhalt von tg-config.json:

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

Ausgabe:

{
    "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"
}

Beispiel 3: So erstellen Sie eine Zielgruppe vom Typ LAMBDA

Im folgenden Beispiel für create-target-group wird eine Zielgruppe mit dem angegebenen Namen, Typ und der angegebenen Konfiguration erstellt.

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

Ausgabe:

{
    "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"
}

Beispiel 4: So erstellen Sie eine Zielgruppe vom Typ ALB

Im folgenden Beispiel für create-target-group wird eine Zielgruppe mit dem angegebenen Namen, Typ und der angegebenen Konfiguration erstellt.

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

Inhalt von tg-config.json:

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

Ausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Zielgruppen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie delete-auth-policy verwendet wird.

AWS CLI

So löschen Sie eine Authentifizierungsrichtlinie

Im folgenden Beispiel für delete-auth-policy wird die Authentifizierungsrichtlinie für den angegebene Service gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Authentifizierungsrichtlinien im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie delete-listener verwendet wird.

AWS CLI

So löschen Sie einen Listener

Im folgenden Beispiel für delete-listener wird der angegebene Listener gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Listeners im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter DeleteListener in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-resource-configuration verwendet wird.

AWS CLI

So löschen Sie eine Synchronisierungskonfiguration

Im folgenden Beispiel für delete-resource-configuration wird die angegebene Ressourcenkonfiguration gelöscht.

aws vpc-lattice delete-resource-configuration \
    --resource-configuration-identifier rcfg-07129f3acded87625

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Ressourcen-Gateways in VPC Lattice im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie delete-resource-gateway verwendet wird.

AWS CLI

So löschen Sie ein Ressourcen-Gateway

Im folgenden Beispiel für delete-resource-gateway wird das angegebene Ressourcen-Gateway gelöscht.

aws vpc-lattice delete-resource-gateway \
    --resource-gateway-identifier rgw-0bba03f3d56060135

Ausgabe:

{
    "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourcegateway/rgw-0bba03f3d56060135",
    "id": "rgw-0bba03f3d56060135",
    "name": "my-resource-gateway",
    "status": "DELETE_IN_PROGRESS"
}

Weitere Informationen finden Sie unter Ressourcen-Gateways in VPC Lattice im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie delete-service-network-service-association verwendet wird.

AWS CLI

So entfernen Sie eine Servicezuordnung

Im folgenden Beispiel für delete-service-network-service-association wird die Zuordnung der angegebenen Servicezuordnung entfernt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Verwalten von Servicezuordnungen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie delete-service-network-vpc-association verwendet wird.

AWS CLI

So löschen Sie eine VPC-Zuordnung

Im folgenden Beispiel für delete-service-network-vpc-association wird die Zuordnung der angegebenen VPC-Zuordnung entfernt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Verwalten von VPC-Zuordnungen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie delete-service-network verwendet wird.

AWS CLI

So löschen Sie ein Servicenetzwerk

Im folgenden Beispiel für delete-service-network wird das angegebene Servicenetzwerk gelöscht.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Servicenetzwerke im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie delete-service verwendet wird.

AWS CLI

So löschen Sie einen Service

Im folgenden Beispiel für delete-service wird der angegebene Service gelöscht.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Services in VPC Lattice im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter DeleteService in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-target-group verwendet wird.

AWS CLI

So löschen Sie einer Zielgruppe

Im folgenden Beispiel für delete-target-group wird die angegebene Zielgruppe gelöscht.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Zielgruppen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie deregister-targets verwendet wird.

AWS CLI

So melden Sie ein Ziel ab

Im folgenden Beispiel für deregister-targets wird die Registrierung des angegebenen Ziels von der angegebenen Zielgruppe aufgehoben.

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

Ausgabe:

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

Weitere Informationen finden Sie unter So registrieren Sie Ziele im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie get-auth-policy verwendet wird.

AWS CLI

So rufen Sie Informationen zu einer Authentifizierungsrichtlinie ab

Im folgenden Beispiel für get-auth-policy werden Informationen zur Authentifizierungsrichtlinie für den angegebenen Service abgerufen.

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

Ausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Authentifizierungsrichtlinien im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter GetAuthPolicy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-listener verwendet wird.

AWS CLI

So rufen Sie Informationen zu einem Service-Listener ab

Im folgenden Beispiel für get-listener werden Informationen über den angegebenen Listener für den angegebenen Service abgerufen.

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

Ausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Weiterleitung definieren im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter GetListener in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-resource-configuration verwendet wird.

AWS CLI

So rufen Sie Informationen zu einer Ressourcenkonfiguration ab

Im folgenden Beispiel für get-resource-configuration werden Informationen zur angegebenen Ressourcenkonfiguration abgerufen.

aws vpc-lattice get-resource-configuration \
    --resource-configuration-identifier rcfg-07129f3acded87625

Ausgabe:

{
    "allowAssociationToShareableServiceNetwork": true,
    "amazonManaged": false,
    "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-07129f3acded87625",
    "createdAt": "2025-02-01T00:57:35.871000+00:00",
    "id": "rcfg-07129f3acded87625",
    "lastUpdatedAt": "2025-02-01T00:57:46.874000+00:00",
    "name": "my-resource-config",
    "portRanges": [
        "1-65535"
    ],
    "protocol": "TCP",
    "resourceConfigurationDefinition": {
        "ipResource": {
            "ipAddress": "10.0.14.85"
        }
    },
    "resourceGatewayId": "rgw-0bba03f3d56060135",
    "status": "ACTIVE",
    "type": "SINGLE"
}

Weitere Informationen finden Sie unter Ressourcen-Gateways in VPC Lattice im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie get-resource-gateway verwendet wird.

AWS CLI

So rufen Sie Informationen zu einem Ressourcen-Gateway ab

Im folgenden Beispiel für get-resource-gateway werden Informationen zum angegebenen Ressourcen-Gateway abgerufen.

aws vpc-lattice get-resource-gateway \
    --resource-gateway-identifier rgw-0bba03f3d56060135

Ausgabe:

{
    "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourcegateway/rgw-0bba03f3d56060135",
    "createdAt": "2025-02-01T00:57:33.241000+00:00",
    "id": "rgw-0bba03f3d56060135",
    "ipAddressType": "IPV4",
    "lastUpdatedAt": "2025-02-01T00:57:44.351000+00:00",
    "name": "my-resource-gateway",
    "securityGroupIds": [
        "sg-087ffd596c5fe962c"
    ],
    "status": "ACTIVE",
    "subnetIds": [
        "subnet-08e8943905b63a683"
    ],
    "vpcId": "vpc-0bf4c2739bc05a694"
}

Weitere Informationen finden Sie unter Ressourcen-Gateways in VPC Lattice im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie get-service-network-service-association verwendet wird.

AWS CLI

So rufen Sie Informationen über eine Servicezuordnung ab

Im folgenden Beispiel für get-service-network-service-association werden Informationen über die angegebene Servicezuordnung abgerufen.

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

Ausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Verwalten von Servicezuordnungen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie get-service-network-vpc-association verwendet wird.

AWS CLI

So rufen Sie Informationen über eine VPC-Zuordnung ab

Im folgenden Beispiel für get-service-network-vpc-association werden Informationen über die angegebene VPC-Zuordnung abgerufen.

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

Ausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Verwalten von VPC-Zuordnungen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie get-service-network verwendet wird.

AWS CLI

So rufen Sie Informationen zu einem Servicenetzwerk ab

Im folgenden Beispiel für get-service-network werden Informationen über das angegebene Servicenetzwerk abgerufen.

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

Ausgabe:

{
   "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
}

Weitere Informationen finden Sie unter Servicenetzwerke im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie get-service verwendet wird.

AWS CLI

So rufen Sie Informationen zu einem Service ab

Im folgenden Beispiel für get-service werden Informationen über den angegebenen Service abgerufen.

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

Ausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Services im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter GetService in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-target-group verwendet wird.

AWS CLI

So rufen Sie Informationen über eine Zielgruppe ab

Im folgenden Beispiel für get-target-group werden Informationen über die angegebene Zielgruppe mit dem Ziel-Typ INSTANCE abgerufen.

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

Ausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Zielgruppen im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter GetTargetGroup in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-listeners verwendet wird.

AWS CLI

So listen Sie Service-Listener auf

Im folgenden Beispiel für list-listeners werden die Listener für den angegebenen Service aufgelistet.

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

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie unter Weiterleitung definieren im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter ListListeners in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-resource-configurations verwendet wird.

AWS CLI

So listen Sie Ihre Ressourcenkonfigurationen auf

Im folgenden Beispiel für list-resource-configurations werden Ihre Ressourcenkonfigurationen aufgelistet.

aws vpc-lattice list-resource-configurations

Ausgabe:

{
    "items": [
        {
            "amazonManaged": false,
            "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-07129f3acded87625",
            "createdAt": "2025-02-01T00:57:35.871000+00:00",
            "id": "rcfg-07129f3acded87625",
            "lastUpdatedAt": "2025-02-01T00:57:46.874000+00:00",
            "name": "my-resource-config",
            "resourceGatewayId": "rgw-0bba03f3d56060135",
            "status": "ACTIVE",
            "type": "SINGLE"
        }
    ]
}

Weitere Informationen finden Sie unter Ressourcenkonfigurationen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie list-resource-endpoint-associations verwendet wird.

AWS CLI

So listen Sie die VPC-Endpunktzuordnungen auf

Im folgenden Beispiel für list-resource-endpoint-associations werden die der angegebenen Ressourcenkonfiguration zugeordneten VPC-Endpunkte aufgelistet.

aws vpc-lattice list-resource-endpoint-associations \
    --resource-configuration-identifier rcfg-07129f3acded87625

Ausgabe:

{
    "items": [
        {
            "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceendpointassociation/rea-0956a7435baf89326",
            "createdAt": "2025-02-01T00:57:38.998000+00:00",
            "id": "rea-0956a7435baf89326",
            "resourceConfigurationArn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-07129f3acded87625",
            "resourceConfigurationId": "rcfg-07129f3acded87625",
            "vpcEndpointId": "vpce-019b90d6f16d4f958",
            "vpcEndpointOwner": "123456789012"
        }
    ]
}

Weitere Informationen finden Sie unter Verwalten von Zuordnungen für eine VPC Lattice-Ressourcenkonfiguration im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie list-resource-gateways verwendet wird.

AWS CLI

So listen Sie Ihre Ressourcen-Gateways auf

Im folgenden Beispiel für list-resource-gateways werden Ihre Ressourcen-Gateways aufgelistet.

aws vpc-lattice list-resource-gateways

Ausgabe:

{
    "items": [
        {
            "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourcegateway/rgw-0bba03f3d56060135",
            "createdAt": "2025-02-01T00:57:33.241000+00:00",
            "id": "rgw-0bba03f3d56060135",
            "ipAddressType": "IPV4",
            "lastUpdatedAt": "2025-02-01T00:57:44.351000+00:00",
            "name": "my-resource-gateway",
            "seurityGroupIds": [
                "sg-087ffd596c5fe962c"
            ],
            "status": "ACTIVE",
            "subnetIds": [
                "subnet-08e8943905b63a683"
            ],
            "vpcIdentifier": "vpc-0bf4c2739bc05a694"
        }
    ]
}

Weitere Informationen finden Sie unter Ressourcen-Gateways in VPC Lattice im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie list-service-network-service-associations verwendet wird.

AWS CLI

So listen Sie Servicezuordnungen auf

Im folgenden Beispiel für list-service-network-service-associations werden die Servicezuordnungen für das angegebene Servicenetzwerk aufgelistet. Die Option --query beschränkt die Ausgabe auf die IDs der Servicezuordnungen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Verwalten von Servicezuordnungen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie list-service-network-vpc-associations verwendet wird.

AWS CLI

So listen Sie VPC-Zuordnungen auf

Im folgenden Beispiel für list-service-network-vpc-associations werden die VPC-Zuordnungen für das angegebene Servicenetzwerk aufgelistet. Die Option --query beschränkt die Ausgabe auf die IDs der VPC-Zuordnungen.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Verwalten von VPC-Zuordnungen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie list-service-network-vpc-endpoint-associations verwendet wird.

AWS CLI

So listen Sie die VPC-Endpunktzuordnungen auf

Im folgenden Beispiel für list-service-network-vpc-endpoint-associations werden die dem angegebenen Servicenetzwerk zugeordneten VPC-Endpunkte aufgelistet.

aws vpc-lattice list-service-network-vpc-endpoint-associations \
    --service-network-identifier sn-0808d1748faee0c1e

Ausgabe:

{
    "items": [
        {
            "createdAt": "2025-02-01T01:21:36.667000+00:00",
            "serviceNetworkArn": "arn:aws:vpc-lattice:us-east-1:123456789012:servicenetwork/sn-0808d1748faee0c1e",
            "state": "ACTIVE",
            "vpcEndpointId": "vpce-0cc199f605eaeace7",
            "vpcEndpointOwnerId": "123456789012"
        }
    ]
}

Weitere Informationen finden Sie unter Verwalten der Zuordnungen für ein VPC Lattice-Servicenetzwerk im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie list-service-networks verwendet wird.

AWS CLI

So listen Sie Ihre Servicenetzwerke auf

Im folgenden Beispiel für list-service-networks werden die Servicenetzwerke aufgelistet, die dem anrufenden Konto zugehören oder von diesem gemeinsam genutzt werden. Die Option --query beschränkt die Ergebnisse auf die Amazon-Ressourcennamen (ARN) der Servicenetzwerke.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Servicenetzwerke im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie list-services verwendet wird.

AWS CLI

So listen Sie Ihre Services auf

Im folgenden Beispiel für list-services werden die Services aufgelistet, die dem anrufenden Konto zugehören oder von diesem gemeinsam genutzt werden. Die Option --query beschränkt die Ergebnisse auf die Amazon-Ressourcennamen (ARN) der Services.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Services im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter ListServices in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-target-groups verwendet wird.

AWS CLI

So listen Sie Ihre Zielgruppen auf

Im folgenden Beispiel für list-target-groups werden die Zielgruppen mit dem Ziel-Typ LAMBDA aufgelistet.

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

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie unter Zielgruppen im Benutzerhandbuch zu Amazon VPC Lattice.

Das folgende Codebeispiel zeigt, wie list-targets verwendet wird.

AWS CLI

So listen Sie die Ziele für eine Zielgruppe auf

Im folgenden Beispiel für list-targets werden die Ziele für die angegebene Zielgruppe aufgelistet.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Zielgruppen im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter ListTargets in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie put-auth-policy verwendet wird.

AWS CLI

So erstellen Sie eine Authentifizierungsrichtlinie für einen Service

Im folgenden Beispiel für put-auth-policy wird Zugriff auf Anfragen von jedem authentifizierten Prinzipal gewährt, der die angegebene IAM-Rolle verwendet. Die Ressource ist der ARN des Services, dem die Richtlinie angefügt ist.

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

Inhalt von 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"
        }
    ]
}

Ausgabe:

{
    "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"
}

Weitere Informationen finden Sie unter Authentifizierungsrichtlinien im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter PutAuthPolicy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie register-targets verwendet wird.

AWS CLI

So registrieren Sie ein Ziel

Im folgenden Beispiel für register-targets werden die angegebenen Ziele bei der angegebenen Zielgruppe registriert.

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

Ausgabe:

{
    "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
        }
    ]
}

Weitere Informationen finden Sie unter So registrieren Sie Ziele im Benutzerhandbuch zu Amazon VPC Lattice.

  • API-Details finden Sie unter RegisterTargets in der AWS CLI-Befehlsreferenz.