awscli 1.38.12__py3-none-any.whl → 1.38.13__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of awscli might be problematic. Click here for more details.

Files changed (37) hide show
  1. awscli/__init__.py +1 -1
  2. awscli/customizations/globalargs.py +5 -13
  3. awscli/examples/cognito-idp/tag-resource.rst +11 -0
  4. awscli/examples/cognito-idp/untag-resource.rst +11 -0
  5. awscli/examples/cognito-idp/update-identity-provider.rst +71 -0
  6. awscli/examples/cognito-idp/update-managed-login-branding.rst +949 -0
  7. awscli/examples/cognito-idp/update-user-pool-client.rst +121 -24
  8. awscli/examples/cognito-idp/update-user-pool-domain.rst +18 -0
  9. awscli/examples/cognito-idp/verify-software-token.rst +15 -0
  10. awscli/examples/cognito-idp/verify-user-attribute.rst +10 -0
  11. awscli/examples/ec2/associate-security-group-vpc.rst +15 -0
  12. awscli/examples/ec2/create-vpc-endpoint.rst +196 -118
  13. awscli/examples/ec2/describe-security-group-vpc-associations.rst +21 -0
  14. awscli/examples/ec2/describe-vpc-endpoint-associations.rst +24 -0
  15. awscli/examples/ec2/disable-image-deregistration-protection.rst +14 -0
  16. awscli/examples/ec2/disassociate-security-group-vpc.rst +15 -0
  17. awscli/examples/ec2/enable-image-deregistration-protection.rst +14 -0
  18. awscli/examples/vpc-lattice/create-resource-configuration.rst +32 -0
  19. awscli/examples/vpc-lattice/create-resource-gateway.rst +27 -0
  20. awscli/examples/vpc-lattice/delete-resource-configuration.rst +10 -0
  21. awscli/examples/vpc-lattice/delete-resource-gateway.rst +17 -0
  22. awscli/examples/vpc-lattice/get-resource-configuration.rst +32 -0
  23. awscli/examples/vpc-lattice/get-resource-gateway.rst +27 -0
  24. awscli/examples/vpc-lattice/list-resource-configurations.rst +25 -0
  25. awscli/examples/vpc-lattice/list-resource-endpoint-associations.rst +24 -0
  26. awscli/examples/vpc-lattice/list-resource-gateways.rst +30 -0
  27. awscli/examples/vpc-lattice/list-service-network-vpc-endpoint-associations.rst +22 -0
  28. {awscli-1.38.12.dist-info → awscli-1.38.13.dist-info}/METADATA +2 -2
  29. {awscli-1.38.12.dist-info → awscli-1.38.13.dist-info}/RECORD +37 -14
  30. {awscli-1.38.12.data → awscli-1.38.13.data}/scripts/aws +0 -0
  31. {awscli-1.38.12.data → awscli-1.38.13.data}/scripts/aws.cmd +0 -0
  32. {awscli-1.38.12.data → awscli-1.38.13.data}/scripts/aws_bash_completer +0 -0
  33. {awscli-1.38.12.data → awscli-1.38.13.data}/scripts/aws_completer +0 -0
  34. {awscli-1.38.12.data → awscli-1.38.13.data}/scripts/aws_zsh_completer.sh +0 -0
  35. {awscli-1.38.12.dist-info → awscli-1.38.13.dist-info}/LICENSE.txt +0 -0
  36. {awscli-1.38.12.dist-info → awscli-1.38.13.dist-info}/WHEEL +0 -0
  37. {awscli-1.38.12.dist-info → awscli-1.38.13.dist-info}/top_level.txt +0 -0
@@ -1,24 +1,121 @@
1
- **To update a user pool client**
2
-
3
- This example updates the name of a user pool client. It also adds a writeable attribute "nickname".
4
-
5
- Command::
6
-
7
- aws cognito-idp update-user-pool-client --user-pool-id us-west-2_aaaaaaaaa --client-id 3n4b5urk1ft4fl3mg5e62d9ado --client-name "NewClientName" --write-attributes "nickname"
8
-
9
- Output::
10
-
11
- {
12
- "UserPoolClient": {
13
- "UserPoolId": "us-west-2_aaaaaaaaa",
14
- "ClientName": "NewClientName",
15
- "ClientId": "3n4b5urk1ft4fl3mg5e62d9ado",
16
- "LastModifiedDate": 1548802761.334,
17
- "CreationDate": 1548178931.258,
18
- "RefreshTokenValidity": 30,
19
- "WriteAttributes": [
20
- "nickname"
21
- ],
22
- "AllowedOAuthFlowsUserPoolClient": false
23
- }
24
- }
1
+ **To update an app client**
2
+
3
+ The following ``update-user-pool-client`` example updates the configuration of the requested app client. ::
4
+
5
+ aws cognito-idp update-user-pool-client \
6
+ --user-pool-id us-west-2_EXAMPLE \
7
+ --client-id 1example23456789 \
8
+ --client-name my-test-app \
9
+ --refresh-token-validity 30 \
10
+ --access-token-validity 60 \
11
+ --id-token-validity 60 \
12
+ --token-validity-units AccessToken=minutes,IdToken=minutes,RefreshToken=days \
13
+ --read-attributes "address" "birthdate" "email" "email_verified" "family_name" "gender" "locale" "middle_name" "name" "nickname" "phone_number" "phone_number_verified" "picture" "preferred_username" "profile" "updated_at" "website" "zoneinfo" \
14
+ --write-attributes "address" "birthdate" "email" "family_name" "gender" "locale" "middle_name" "name" "nickname" "phone_number" "picture" "preferred_username" "profile" "updated_at" "website" "zoneinfo" \
15
+ --explicit-auth-flows "ALLOW_ADMIN_USER_PASSWORD_AUTH" "ALLOW_CUSTOM_AUTH" "ALLOW_REFRESH_TOKEN_AUTH" "ALLOW_USER_PASSWORD_AUTH" "ALLOW_USER_SRP_AUTH" \
16
+ --supported-identity-providers "MySAML" "COGNITO" "Google" \
17
+ --callback-urls "https://www.example.com" "https://app2.example.com" \
18
+ --logout-urls "https://auth.example.com/login?client_id=1example23456789&response_type=code&redirect_uri=https%3A%2F%2Fwww.example.com" "https://example.com/logout" \
19
+ --default-redirect-uri "https://www.example.com" \
20
+ --allowed-o-auth-flows "code" "implicit" \
21
+ --allowed-o-auth-scopes "openid" "profile" "aws.cognito.signin.user.admin" \
22
+ --allowed-o-auth-flows-user-pool-client \
23
+ --prevent-user-existence-errors ENABLED \
24
+ --enable-token-revocation \
25
+ --no-enable-propagate-additional-user-context-data \
26
+ --auth-session-validity 3
27
+
28
+ Output::
29
+
30
+ {
31
+ "UserPoolClient": {
32
+ "UserPoolId": "us-west-2_EXAMPLE",
33
+ "ClientName": "my-test-app",
34
+ "ClientId": "1example23456789",
35
+ "LastModifiedDate": "2025-01-31T14:40:12.498000-08:00",
36
+ "CreationDate": "2023-09-13T16:26:34.408000-07:00",
37
+ "RefreshTokenValidity": 30,
38
+ "AccessTokenValidity": 60,
39
+ "IdTokenValidity": 60,
40
+ "TokenValidityUnits": {
41
+ "AccessToken": "minutes",
42
+ "IdToken": "minutes",
43
+ "RefreshToken": "days"
44
+ },
45
+ "ReadAttributes": [
46
+ "website",
47
+ "zoneinfo",
48
+ "address",
49
+ "birthdate",
50
+ "email_verified",
51
+ "gender",
52
+ "profile",
53
+ "phone_number_verified",
54
+ "preferred_username",
55
+ "locale",
56
+ "middle_name",
57
+ "picture",
58
+ "updated_at",
59
+ "name",
60
+ "nickname",
61
+ "phone_number",
62
+ "family_name",
63
+ "email"
64
+ ],
65
+ "WriteAttributes": [
66
+ "website",
67
+ "zoneinfo",
68
+ "address",
69
+ "birthdate",
70
+ "gender",
71
+ "profile",
72
+ "preferred_username",
73
+ "locale",
74
+ "middle_name",
75
+ "picture",
76
+ "updated_at",
77
+ "name",
78
+ "nickname",
79
+ "phone_number",
80
+ "family_name",
81
+ "email"
82
+ ],
83
+ "ExplicitAuthFlows": [
84
+ "ALLOW_CUSTOM_AUTH",
85
+ "ALLOW_USER_PASSWORD_AUTH",
86
+ "ALLOW_ADMIN_USER_PASSWORD_AUTH",
87
+ "ALLOW_USER_SRP_AUTH",
88
+ "ALLOW_REFRESH_TOKEN_AUTH"
89
+ ],
90
+ "SupportedIdentityProviders": [
91
+ "Google",
92
+ "COGNITO",
93
+ "MySAML"
94
+ ],
95
+ "CallbackURLs": [
96
+ "https://www.example.com",
97
+ "https://app2.example.com"
98
+ ],
99
+ "LogoutURLs": [
100
+ "https://example.com/logout",
101
+ "https://auth.example.com/login?client_id=1example23456789&response_type=code&redirect_uri=https%3A%2F%2Fwww.example.com"
102
+ ],
103
+ "DefaultRedirectURI": "https://www.example.com",
104
+ "AllowedOAuthFlows": [
105
+ "implicit",
106
+ "code"
107
+ ],
108
+ "AllowedOAuthScopes": [
109
+ "aws.cognito.signin.user.admin",
110
+ "openid",
111
+ "profile"
112
+ ],
113
+ "AllowedOAuthFlowsUserPoolClient": true,
114
+ "PreventUserExistenceErrors": "ENABLED",
115
+ "EnableTokenRevocation": true,
116
+ "EnablePropagateAdditionalUserContextData": false,
117
+ "AuthSessionValidity": 3
118
+ }
119
+ }
120
+
121
+ For more information, see `Application-specific settings with app clients <https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-client-apps.html>`__ in the *Amazon Cognito Developer Guide*.
@@ -0,0 +1,18 @@
1
+ **To update a custom domain**
2
+
3
+ The following ``update-user-pool-domain`` example configures the branding version and certificate for the custom domain the requested user pool. ::
4
+
5
+ aws cognito-idp update-user-pool-domain \
6
+ --user-pool-id ca-central-1_EXAMPLE \
7
+ --domain auth.example.com \
8
+ --managed-login-version 2 \
9
+ --custom-domain-config CertificateArn=arn:aws:acm:us-east-1:123456789012:certificate/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
10
+
11
+ Output::
12
+
13
+ {
14
+ "CloudFrontDomain": "example.cloudfront.net",
15
+ "ManagedLoginVersion": 2
16
+ }
17
+
18
+ For more information, see `Managed login <https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-managed-login.html>`__ and `Configuring a domain <https://docs.aws.amazon.com/cognito/latest/developerguide/cognito-user-pools-assign-domain.html>`__ in the *Amazon Cognito Developer Guide*.
@@ -0,0 +1,15 @@
1
+ **To confirm registration of a TOTP authenticator**
2
+
3
+ The following ``verify-software-token`` example completes TOTP registration for the current user. ::
4
+
5
+ aws cognito-idp verify-software-token \
6
+ --access-token eyJra456defEXAMPLE \
7
+ --user-code 123456
8
+
9
+ Output::
10
+
11
+ {
12
+ "Status": "SUCCESS"
13
+ }
14
+
15
+ For more information, see `Adding MFA to a user pool <https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-mfa.html>`__ in the *Amazon Cognito Developer Guide*.
@@ -0,0 +1,10 @@
1
+ **To verify an attribute change**
2
+
3
+ The following ``verify-user-attribute`` example verifies a change to the current user's email attribute. ::
4
+
5
+ aws cognito-idp verify-user-attribute \
6
+ --access-token eyJra456defEXAMPLE \
7
+ --attribute-name email \
8
+ --code 123456
9
+
10
+ For more information, see `Configuring email or phone verification <https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-email-phone-verification.html>`__ in the *Amazon Cognito Developer Guide*.
@@ -0,0 +1,15 @@
1
+ **To associate a security group with another VPC**
2
+
3
+ The following ``associate-security-group-vpc`` example associates the specified security group with the specified VPC. ::
4
+
5
+ aws ec2 associate-security-group-vpc \
6
+ --group-id sg-04dbb43907d3f8a78 \
7
+ --vpc-id vpc-0bf4c2739bc05a694
8
+
9
+ Output::
10
+
11
+ {
12
+ "State": "associating"
13
+ }
14
+
15
+ For more information, see `Associate security groups with multiple VPCs <https://docs.aws.amazon.com/vpc/latest/userguide/security-group-assoc.html>`__ in the *Amazon VPC User Guide*.
@@ -1,118 +1,196 @@
1
- **Example 1: To create a gateway endpoint**
2
-
3
- The following ``create-vpc-endpoint`` example creates a gateway VPC endpoint between VPC ``vpc-1a2b3c4d`` and Amazon S3 in the ``us-east-1`` region, and associates route table ``rtb-11aa22bb`` with the endpoint. ::
4
-
5
- aws ec2 create-vpc-endpoint \
6
- --vpc-id vpc-1a2b3c4d \
7
- --service-name com.amazonaws.us-east-1.s3 \
8
- --route-table-ids rtb-11aa22bb
9
-
10
- Output::
11
-
12
- {
13
- "VpcEndpoint": {
14
- "PolicyDocument": "{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"\",\"Effect\":\"Allow\",\"Principal\":\"\*\",\"Action\":\"\*\",\"Resource\":\"\*\"}]}",
15
- "VpcId": "vpc-1a2b3c4d",
16
- "State": "available",
17
- "ServiceName": "com.amazonaws.us-east-1.s3",
18
- "RouteTableIds": [
19
- "rtb-11aa22bb"
20
- ],
21
- "VpcEndpointId": "vpc-1a2b3c4d",
22
- "CreationTimestamp": "2015-05-15T09:40:50Z"
23
- }
24
- }
25
-
26
- For more information, see `Create a gateway endpoint <https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-s3.html#create-gateway-endpoint-s3>`__ in the *AWS PrivateLink User Guide*.
27
-
28
- **Example 2: To create an interface endpoint**
29
-
30
- The following ``create-vpc-endpoint`` example creates an interface VPC endpoint between VPC ``vpc-1a2b3c4d`` and Amazon S3 in the ``us-east-1`` region. The command creates the endpoint in subnet ``subnet-1a2b3c4d``, associates it with security group ``sg-1a2b3c4d``, and adds a tag with a key of "Service" and a Value of "S3". ::
31
-
32
- aws ec2 create-vpc-endpoint \
33
- --vpc-id vpc-1a2b3c4d \
34
- --vpc-endpoint-type Interface \
35
- --service-name com.amazonaws.us-east-1.s3 \
36
- --subnet-ids subnet-7b16de0c \
37
- --security-group-id sg-1a2b3c4d \
38
- --tag-specifications ResourceType=vpc-endpoint,Tags=[{Key=service,Value=S3}]
39
-
40
- Output::
41
-
42
- {
43
- "VpcEndpoint": {
44
- "VpcEndpointId": "vpce-1a2b3c4d5e6f1a2b3",
45
- "VpcEndpointType": "Interface",
46
- "VpcId": "vpc-1a2b3c4d",
47
- "ServiceName": "com.amazonaws.us-east-1.s3",
48
- "State": "pending",
49
- "RouteTableIds": [],
50
- "SubnetIds": [
51
- "subnet-1a2b3c4d"
52
- ],
53
- "Groups": [
54
- {
55
- "GroupId": "sg-1a2b3c4d",
56
- "GroupName": "default"
57
- }
58
- ],
59
- "PrivateDnsEnabled": false,
60
- "RequesterManaged": false,
61
- "NetworkInterfaceIds": [
62
- "eni-0b16f0581c8ac6877"
63
- ],
64
- "DnsEntries": [
65
- {
66
- "DnsName": "*.vpce-1a2b3c4d5e6f1a2b3-9hnenorg.s3.us-east-1.vpce.amazonaws.com",
67
- "HostedZoneId": "Z7HUB22UULQXV"
68
- },
69
- {
70
- "DnsName": "*.vpce-1a2b3c4d5e6f1a2b3-9hnenorg-us-east-1c.s3.us-east-1.vpce.amazonaws.com",
71
- "HostedZoneId": "Z7HUB22UULQXV"
72
- }
73
- ],
74
- "CreationTimestamp": "2021-03-05T14:46:16.030000+00:00",
75
- "Tags": [
76
- {
77
- "Key": "service",
78
- "Value": "S3"
79
- }
80
- ],
81
- "OwnerId": "123456789012"
82
- }
83
- }
84
-
85
- For more information, see `Create an interface VPC endpoint <https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html>`__ in the *AWS PrivateLink User Guide*.
86
-
87
- **Example 3: To create a Gateway Load Balancer endpoint**
88
-
89
- The following ``create-vpc-endpoint`` example creates a Gateway Load Balancer endpoint between VPC ``vpc-111122223333aabbc`` and and a service that is configured using a Gateway Load Balancer. ::
90
-
91
- aws ec2 create-vpc-endpoint \
92
- --service-name com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123 \
93
- --vpc-endpoint-type GatewayLoadBalancer \
94
- --vpc-id vpc-111122223333aabbc \
95
- --subnet-ids subnet-0011aabbcc2233445
96
-
97
- Output::
98
-
99
- {
100
- "VpcEndpoint": {
101
- "VpcEndpointId": "vpce-aabbaabbaabbaabba",
102
- "VpcEndpointType": "GatewayLoadBalancer",
103
- "VpcId": "vpc-111122223333aabbc",
104
- "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123",
105
- "State": "pending",
106
- "SubnetIds": [
107
- "subnet-0011aabbcc2233445"
108
- ],
109
- "RequesterManaged": false,
110
- "NetworkInterfaceIds": [
111
- "eni-01010120203030405"
112
- ],
113
- "CreationTimestamp": "2020-11-11T08:06:03.522Z",
114
- "OwnerId": "123456789012"
115
- }
116
- }
117
-
118
- For more information, see `Gateway Load Balancer endpoints <https://docs.aws.amazon.com/vpc/latest/privatelink/gateway-load-balancer-endpoints.html>`__ in the *AWS PrivateLink User Guide*.
1
+ **Example 1: To create a gateway endpoint**
2
+
3
+ The following ``create-vpc-endpoint`` example creates a gateway VPC endpoint between VPC ``vpc-1a2b3c4d`` and Amazon S3 in the ``us-east-1`` region, and associates route table ``rtb-11aa22bb`` with the endpoint. ::
4
+
5
+ aws ec2 create-vpc-endpoint \
6
+ --vpc-id vpc-1a2b3c4d \
7
+ --service-name com.amazonaws.us-east-1.s3 \
8
+ --route-table-ids rtb-11aa22bb
9
+
10
+ Output::
11
+
12
+ {
13
+ "VpcEndpoint": {
14
+ "PolicyDocument": "{\"Version\":\"2008-10-17\",\"Statement\":[{\"Sid\":\"\",\"Effect\":\"Allow\",\"Principal\":\"\*\",\"Action\":\"\*\",\"Resource\":\"\*\"}]}",
15
+ "VpcId": "vpc-1a2b3c4d",
16
+ "State": "available",
17
+ "ServiceName": "com.amazonaws.us-east-1.s3",
18
+ "RouteTableIds": [
19
+ "rtb-11aa22bb"
20
+ ],
21
+ "VpcEndpointId": "vpc-1a2b3c4d",
22
+ "CreationTimestamp": "2015-05-15T09:40:50Z"
23
+ }
24
+ }
25
+
26
+ For more information, see `Create a gateway endpoint <https://docs.aws.amazon.com/vpc/latest/privatelink/vpc-endpoints-s3.html#create-gateway-endpoint-s3>`__ in the *AWS PrivateLink User Guide*.
27
+
28
+ **Example 2: To create an interface endpoint**
29
+
30
+ The following ``create-vpc-endpoint`` example creates an interface VPC endpoint between VPC ``vpc-1a2b3c4d`` and Amazon S3 in the ``us-east-1`` region. The command creates the endpoint in subnet ``subnet-1a2b3c4d``, associates it with security group ``sg-1a2b3c4d``, and adds a tag with a key of "Service" and a Value of "S3". ::
31
+
32
+ aws ec2 create-vpc-endpoint \
33
+ --vpc-id vpc-1a2b3c4d \
34
+ --vpc-endpoint-type Interface \
35
+ --service-name com.amazonaws.us-east-1.s3 \
36
+ --subnet-ids subnet-7b16de0c \
37
+ --security-group-id sg-1a2b3c4d \
38
+ --tag-specifications ResourceType=vpc-endpoint,Tags=[{Key=service,Value=S3}]
39
+
40
+ Output::
41
+
42
+ {
43
+ "VpcEndpoint": {
44
+ "VpcEndpointId": "vpce-1a2b3c4d5e6f1a2b3",
45
+ "VpcEndpointType": "Interface",
46
+ "VpcId": "vpc-1a2b3c4d",
47
+ "ServiceName": "com.amazonaws.us-east-1.s3",
48
+ "State": "pending",
49
+ "RouteTableIds": [],
50
+ "SubnetIds": [
51
+ "subnet-1a2b3c4d"
52
+ ],
53
+ "Groups": [
54
+ {
55
+ "GroupId": "sg-1a2b3c4d",
56
+ "GroupName": "default"
57
+ }
58
+ ],
59
+ "PrivateDnsEnabled": false,
60
+ "RequesterManaged": false,
61
+ "NetworkInterfaceIds": [
62
+ "eni-0b16f0581c8ac6877"
63
+ ],
64
+ "DnsEntries": [
65
+ {
66
+ "DnsName": "*.vpce-1a2b3c4d5e6f1a2b3-9hnenorg.s3.us-east-1.vpce.amazonaws.com",
67
+ "HostedZoneId": "Z7HUB22UULQXV"
68
+ },
69
+ {
70
+ "DnsName": "*.vpce-1a2b3c4d5e6f1a2b3-9hnenorg-us-east-1c.s3.us-east-1.vpce.amazonaws.com",
71
+ "HostedZoneId": "Z7HUB22UULQXV"
72
+ }
73
+ ],
74
+ "CreationTimestamp": "2021-03-05T14:46:16.030000+00:00",
75
+ "Tags": [
76
+ {
77
+ "Key": "service",
78
+ "Value": "S3"
79
+ }
80
+ ],
81
+ "OwnerId": "123456789012"
82
+ }
83
+ }
84
+
85
+ For more information, see `Create an interface VPC endpoint <https://docs.aws.amazon.com/vpc/latest/privatelink/create-interface-endpoint.html>`__ in the *AWS PrivateLink User Guide*.
86
+
87
+ **Example 3: To create a Gateway Load Balancer endpoint**
88
+
89
+ The following ``create-vpc-endpoint`` example creates a Gateway Load Balancer endpoint between VPC ``vpc-111122223333aabbc`` and and a service that is configured using a Gateway Load Balancer. ::
90
+
91
+ aws ec2 create-vpc-endpoint \
92
+ --service-name com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123 \
93
+ --vpc-endpoint-type GatewayLoadBalancer \
94
+ --vpc-id vpc-111122223333aabbc \
95
+ --subnet-ids subnet-0011aabbcc2233445
96
+
97
+ Output::
98
+
99
+ {
100
+ "VpcEndpoint": {
101
+ "VpcEndpointId": "vpce-aabbaabbaabbaabba",
102
+ "VpcEndpointType": "GatewayLoadBalancer",
103
+ "VpcId": "vpc-111122223333aabbc",
104
+ "ServiceName": "com.amazonaws.vpce.us-east-1.vpce-svc-123123a1c43abc123",
105
+ "State": "pending",
106
+ "SubnetIds": [
107
+ "subnet-0011aabbcc2233445"
108
+ ],
109
+ "RequesterManaged": false,
110
+ "NetworkInterfaceIds": [
111
+ "eni-01010120203030405"
112
+ ],
113
+ "CreationTimestamp": "2020-11-11T08:06:03.522Z",
114
+ "OwnerId": "123456789012"
115
+ }
116
+ }
117
+
118
+ For more information, see `Gateway Load Balancer endpoints <https://docs.aws.amazon.com/vpc/latest/privatelink/gateway-load-balancer-endpoints.html>`__ in the *AWS PrivateLink User Guide*.
119
+
120
+ **Example 4: To create a resource endpoint**
121
+
122
+ The following ``create-vpc-endpoint`` example creates a resource endpoint. ::
123
+
124
+ aws ec2 create-vpc-endpoint \
125
+ --vpc-endpoint-type Resource \
126
+ --vpc-id vpc-111122223333aabbc \
127
+ --subnet-ids subnet-0011aabbcc2233445 \
128
+ --resource-configuration-arn arn:aws:vpc-lattice-us-east-1:123456789012:resourceconfiguration/rcfg-0123abcde98765432
129
+
130
+ Output::
131
+
132
+ {
133
+ "VpcEndpoint": {
134
+ "VpcEndpointId": "vpce-00939a7ed9EXAMPLE",
135
+ "VpcEndpointType": "Resource",
136
+ "VpcId": "vpc-111122223333aabbc",
137
+ "State": "Pending",
138
+ "SubnetIds": [
139
+ "subnet-0011aabbcc2233445"
140
+ ],
141
+ "Groups": [
142
+ {
143
+ "GroupId": "sg-03e2f15fbfc09b000",
144
+ "GroupName": "default"
145
+ }
146
+ ],
147
+ "IpAddressType": "IPV4",
148
+ "PrivateDnsEnabled": false,
149
+ "CreationTimestamp": "2025-02-06T23:38:49.525000+00:00",
150
+ "Tags": [],
151
+ "OwnerId": "123456789012",
152
+ "ResourceConfigurationArn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-0123abcde98765432"
153
+ }
154
+ }
155
+
156
+ For more information, see `Resource endpoints <https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-access-resources.html>`__ in the *AWS PrivateLink User Guide*.
157
+
158
+ **Example 5: To create a service network endpoint**
159
+
160
+ The following ``create-vpc-endpoint`` example creates a service network endpoint. ::
161
+
162
+ aws ec2 create-vpc-endpoint \
163
+ --vpc-endpoint-type ServiceNetwork \
164
+ --vpc-id vpc-111122223333aabbc \
165
+ --subnet-ids subnet-0011aabbcc2233445 \
166
+ --service-network-arn arn:aws:vpc-lattice:us-east-1:123456789012:servicenetwork/sn-0101abcd5432abcd0 \
167
+ --security-group-ids sg-0123456789012abcd
168
+
169
+ Output::
170
+
171
+ {
172
+ "VpcEndpoint": {
173
+ "VpcEndpointId": "vpce-0f00567fa8EXAMPLE",
174
+ "VpcEndpointType": "ServiceNetwork",
175
+ "VpcId": "vpc-111122223333aabbc",
176
+ "State": "Pending",
177
+ "SubnetIds": [
178
+ "subnet-0011aabbcc2233445"
179
+ ],
180
+ "Groups": [
181
+ {
182
+ "GroupId": "sg-0123456789012abcd",
183
+ "GroupName": "my-security-group"
184
+ }
185
+ ],
186
+ "IpAddressType": "IPV4",
187
+ "PrivateDnsEnabled": false,
188
+ "CreationTimestamp": "2025-02-06T23:44:20.449000+00:00",
189
+ "Tags": [],
190
+ "OwnerId": "123456789012",
191
+ "ServiceNetworkArn": "arn:aws:vpc-lattice:us-east-1:123456789012:servicenetwork/sn-0101abcd5432abcd0"
192
+ }
193
+ }
194
+
195
+ For more information, see `Service network endpoints <https://docs.aws.amazon.com/vpc/latest/privatelink/privatelink-access-service-networks.html>`__ in the *AWS PrivateLink User Guide*.
196
+
@@ -0,0 +1,21 @@
1
+ **To describe VPC associations**
2
+
3
+ The following ``describe-security-group-vpc-associations`` example describes the VPC associations for the specified security group. ::
4
+
5
+ aws ec2 describe-security-group-vpc-associations \
6
+ --filters Name=group-id,Values=sg-04dbb43907d3f8a78
7
+
8
+ Output::
9
+
10
+ {
11
+ "SecurityGroupVpcAssociations": [
12
+ {
13
+ "GroupId": "sg-04dbb43907d3f8a78",
14
+ "VpcId": "vpc-0bf4c2739bc05a694",
15
+ "VpcOwnerId": "123456789012",
16
+ "State": "associated"
17
+ }
18
+ ]
19
+ }
20
+
21
+ For more information, see `Associate security groups with multiple VPCs <https://docs.aws.amazon.com/vpc/latest/userguide/security-group-assoc.html>`__ in the *Amazon VPC User Guide*.
@@ -0,0 +1,24 @@
1
+ **To describe VPC endpoint associations**
2
+
3
+ The following ``describe-vpc-endpoint-associations`` example describes your VPC endpoint associations. ::
4
+
5
+ aws ec2 describe-vpc-endpoint-associations
6
+
7
+ Output::
8
+
9
+ {
10
+ "VpcEndpointAssociations": [
11
+ {
12
+ "Id": "vpce-rsc-asc-0a810ca6ac8866bf9",
13
+ "VpcEndpointId": "vpce-019b90d6f16d4f958",
14
+ "AssociatedResourceAccessibility": "Accessible",
15
+ "DnsEntry": {
16
+ "DnsName": "vpce-019b90d6f16d4f958.rcfg-07129f3acded87625.4232ccc.vpc-lattice-rsc.us-east-2.on.aws",
17
+ "HostedZoneId": "Z03265862FOUNWMZOKUF4"
18
+ },
19
+ "AssociatedResourceArn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-07129f3acded87625"
20
+ }
21
+ ]
22
+ }
23
+
24
+ For more information, see `Manage VPC endpoint associations <https://docs.aws.amazon.com/vpc/latest/privatelink/resource-configuration-associations.html#resource-config-manage-ep-association>`__ in the *AWS PrivateLink User Guide*.
@@ -0,0 +1,14 @@
1
+ **To disable deregistration protection**
2
+
3
+ The following ``disable-image-deregistration-protection`` example disables deregistration protection for the specified image. ::
4
+
5
+ aws ec2 disable-image-deregistration-protection \
6
+ --image-id ami-0b1a928a144a74ec9
7
+
8
+ Output::
9
+
10
+ {
11
+ "Return": "disabled"
12
+ }
13
+
14
+ For more information, see `Protect an AMI from deregistration <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deregistration-protection.html>`__ in the *Amazon EC2 User Guide*.
@@ -0,0 +1,15 @@
1
+ **To disassociate a security group from a VPC**
2
+
3
+ The following ``disassociate-security-group-vpc`` example disassociates the specified security group from the specified VPC. ::
4
+
5
+ aws ec2 disassociate-security-group-vpc \
6
+ --group-id sg-04dbb43907d3f8a78 \
7
+ --vpc-id vpc-0bf4c2739bc05a694
8
+
9
+ Output::
10
+
11
+ {
12
+ "State": "disassociating"
13
+ }
14
+
15
+ For more information, see `Associate security groups with multiple VPCs <https://docs.aws.amazon.com/vpc/latest/userguide/security-group-assoc.html>`__ in the *Amazon VPC User Guide*.
@@ -0,0 +1,14 @@
1
+ **To enable deregistration protection**
2
+
3
+ The following ``enable-image-deregistration-protection`` example enables deregistration protection for the specified image. ::
4
+
5
+ aws ec2 enable-image-deregistration-protection \
6
+ --image-id ami-0b1a928a144a74ec9
7
+
8
+ Output::
9
+
10
+ {
11
+ "Return": "enabled-without-cooldown"
12
+ }
13
+
14
+ For more information, see `Protect an EC2 AMI from deregistration <https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-deregistration-protection.html>`__ in the *Amazon EC2 User Guide*.
@@ -0,0 +1,32 @@
1
+ **To create a resource configuration**
2
+
3
+ The following ``create-resource-configuration`` example creates a resource configuration that specifies a single IPv4 address. ::
4
+
5
+ aws vpc-lattice create-resource-configuration \
6
+ --name my-resource-config \
7
+ --type SINGLE \
8
+ --resource-gateway-identifier rgw-0bba03f3d56060135 \
9
+ --resource-configuration-definition 'ipResource={ipAddress=10.0.14.85}'
10
+
11
+ Output::
12
+
13
+ {
14
+ "allowAssociationToShareableServiceNetwork": true,
15
+ "arn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-07129f3acded87625",
16
+ "id": "rcfg-07129f3acded87625",
17
+ "name": "my-resource-config",
18
+ "portRanges": [
19
+ "1-65535"
20
+ ],
21
+ "protocol": "TCP",
22
+ "resourceConfigurationDefinition": {
23
+ "ipResource": {
24
+ "ipAddress": "10.0.14.85"
25
+ }
26
+ },
27
+ "resourceGatewayId": "rgw-0bba03f3d56060135",
28
+ "status": "ACTIVE",
29
+ "type": "SINGLE"
30
+ }
31
+
32
+ For more information, see `Resource configurations for VPC resources <https://docs.aws.amazon.com/vpc-lattice/latest/ug/resource-configuration.html>`__ in the *Amazon VPC Lattice User Guide*.