From 62c48f3c32681264867765e3bf37fc6c8d8c98f5 Mon Sep 17 00:00:00 2001 From: AWS SDK for Ruby Date: Wed, 18 May 2022 18:04:46 +0000 Subject: [PATCH] Updated API models and rebuilt service gems. --- apis/appmesh/2019-01-25/api-2.json | 32 +- apis/appmesh/2019-01-25/docs-2.json | 122 +++-- apis/batch/2016-08-10/docs-2.json | 6 +- apis/greengrassv2/2020-11-30/api-2.json | 89 ++-- apis/greengrassv2/2020-11-30/docs-2.json | 40 +- apis/iotevents-data/2018-10-23/api-2.json | 58 +++ apis/iotevents-data/2018-10-23/docs-2.json | 41 ++ apis/quicksight/2018-04-01/api-2.json | 42 +- apis/quicksight/2018-04-01/docs-2.json | 22 +- apis/transfer/2018-11-05/api-2.json | 10 +- apis/transfer/2018-11-05/docs-2.json | 14 +- gems/aws-partitions/CHANGELOG.md | 5 + gems/aws-partitions/VERSION | 2 +- gems/aws-partitions/partitions.json | 24 + gems/aws-sdk-appmesh/CHANGELOG.md | 5 + gems/aws-sdk-appmesh/VERSION | 2 +- gems/aws-sdk-appmesh/lib/aws-sdk-appmesh.rb | 2 +- .../lib/aws-sdk-appmesh/client.rb | 286 ++++++----- .../lib/aws-sdk-appmesh/client_api.rb | 8 + .../lib/aws-sdk-appmesh/types.rb | 460 ++++++++++-------- gems/aws-sdk-batch/CHANGELOG.md | 5 + gems/aws-sdk-batch/VERSION | 2 +- gems/aws-sdk-batch/lib/aws-sdk-batch.rb | 2 +- .../aws-sdk-batch/lib/aws-sdk-batch/client.rb | 62 ++- gems/aws-sdk-batch/lib/aws-sdk-batch/types.rb | 19 +- gems/aws-sdk-greengrassv2/CHANGELOG.md | 5 + gems/aws-sdk-greengrassv2/VERSION | 2 +- .../lib/aws-sdk-greengrassv2.rb | 2 +- .../lib/aws-sdk-greengrassv2/client.rb | 151 +++++- .../lib/aws-sdk-greengrassv2/client_api.rb | 31 +- .../lib/aws-sdk-greengrassv2/types.rb | 107 +++- gems/aws-sdk-ioteventsdata/CHANGELOG.md | 5 + gems/aws-sdk-ioteventsdata/VERSION | 2 +- .../lib/aws-sdk-ioteventsdata.rb | 2 +- .../lib/aws-sdk-ioteventsdata/client.rb | 44 +- .../lib/aws-sdk-ioteventsdata/client_api.rb | 38 ++ .../lib/aws-sdk-ioteventsdata/types.rb | 100 ++++ gems/aws-sdk-quicksight/CHANGELOG.md | 5 + gems/aws-sdk-quicksight/VERSION | 2 +- .../lib/aws-sdk-quicksight.rb | 2 +- .../lib/aws-sdk-quicksight/client.rb | 63 ++- .../lib/aws-sdk-quicksight/client_api.rb | 25 + .../lib/aws-sdk-quicksight/types.rb | 60 ++- gems/aws-sdk-transfer/CHANGELOG.md | 5 + gems/aws-sdk-transfer/VERSION | 2 +- gems/aws-sdk-transfer/lib/aws-sdk-transfer.rb | 2 +- .../lib/aws-sdk-transfer/client.rb | 95 ++-- .../lib/aws-sdk-transfer/client_api.rb | 2 + .../lib/aws-sdk-transfer/types.rb | 129 ++--- 49 files changed, 1610 insertions(+), 631 deletions(-) diff --git a/apis/appmesh/2019-01-25/api-2.json b/apis/appmesh/2019-01-25/api-2.json index 828fd8e9afc..6b7d7855547 100644 --- a/apis/appmesh/2019-01-25/api-2.json +++ b/apis/appmesh/2019-01-25/api-2.json @@ -809,6 +809,7 @@ ], "members":{ "attributes":{"shape":"AwsCloudMapInstanceAttributes"}, + "ipPreference":{"shape":"IpPreference"}, "namespaceName":{"shape":"AwsCloudMapName"}, "serviceName":{"shape":"AwsCloudMapName"} } @@ -1602,6 +1603,7 @@ "required":["hostname"], "members":{ "hostname":{"shape":"Hostname"}, + "ipPreference":{"shape":"IpPreference"}, "responseType":{"shape":"DnsResponseType"} } }, @@ -2189,6 +2191,15 @@ "fault":true, "retryable":{"throttling":false} }, + "IpPreference":{ + "type":"string", + "enum":[ + "IPv6_PREFERRED", + "IPv4_PREFERRED", + "IPv4_ONLY", + "IPv6_ONLY" + ] + }, "LimitExceededException":{ "type":"structure", "members":{ @@ -2608,9 +2619,7 @@ }, "Listeners":{ "type":"list", - "member":{"shape":"Listener"}, - "max":1, - "min":0 + "member":{"shape":"Listener"} }, "Logging":{ "type":"structure", @@ -2690,10 +2699,17 @@ "version":{"shape":"Long"} } }, + "MeshServiceDiscovery":{ + "type":"structure", + "members":{ + "ipPreference":{"shape":"IpPreference"} + } + }, "MeshSpec":{ "type":"structure", "members":{ - "egressFilter":{"shape":"EgressFilter"} + "egressFilter":{"shape":"EgressFilter"}, + "serviceDiscovery":{"shape":"MeshServiceDiscovery"} } }, "MeshStatus":{ @@ -3620,9 +3636,7 @@ }, "VirtualGatewayListeners":{ "type":"list", - "member":{"shape":"VirtualGatewayListener"}, - "max":1, - "min":0 + "member":{"shape":"VirtualGatewayListener"} }, "VirtualGatewayLogging":{ "type":"structure", @@ -3883,9 +3897,7 @@ }, "VirtualRouterListeners":{ "type":"list", - "member":{"shape":"VirtualRouterListener"}, - "max":1, - "min":1 + "member":{"shape":"VirtualRouterListener"} }, "VirtualRouterRef":{ "type":"structure", diff --git a/apis/appmesh/2019-01-25/docs-2.json b/apis/appmesh/2019-01-25/docs-2.json index a088f042427..60456c0162f 100644 --- a/apis/appmesh/2019-01-25/docs-2.json +++ b/apis/appmesh/2019-01-25/docs-2.json @@ -6,7 +6,7 @@ "CreateMesh": "

Creates a service mesh.

A service mesh is a logical boundary for network traffic between services that are represented by resources within the mesh. After you create your service mesh, you can create virtual services, virtual nodes, virtual routers, and routes to distribute traffic between the applications in your mesh.

For more information about service meshes, see Service meshes.

", "CreateRoute": "

Creates a route that is associated with a virtual router.

You can route several different protocols and define a retry policy for a route. Traffic can be routed to one or more virtual nodes.

For more information about routes, see Routes.

", "CreateVirtualGateway": "

Creates a virtual gateway.

A virtual gateway allows resources outside your mesh to communicate to resources that are inside your mesh. The virtual gateway represents an Envoy proxy running in an Amazon ECS task, in a Kubernetes service, or on an Amazon EC2 instance. Unlike a virtual node, which represents an Envoy running with an application, a virtual gateway represents Envoy deployed by itself.

For more information about virtual gateways, see Virtual gateways.

", - "CreateVirtualNode": "

Creates a virtual node within a service mesh.

A virtual node acts as a logical pointer to a particular task group, such as an Amazon ECS service or a Kubernetes deployment. When you create a virtual node, you can specify the service discovery information for your task group, and whether the proxy running in a task group will communicate with other proxies using Transport Layer Security (TLS).

You define a listener for any inbound traffic that your virtual node expects. Any virtual service that your virtual node expects to communicate to is specified as a backend.

The response metadata for your new virtual node contains the arn that is associated with the virtual node. Set this value to the full ARN; for example, arn:aws:appmesh:us-west-2:123456789012:myMesh/default/virtualNode/myApp) as the APPMESH_RESOURCE_ARN environment variable for your task group's Envoy proxy container in your task definition or pod spec. This is then mapped to the node.id and node.cluster Envoy parameters.

By default, App Mesh uses the name of the resource you specified in APPMESH_RESOURCE_ARN when Envoy is referring to itself in metrics and traces. You can override this behavior by setting the APPMESH_RESOURCE_CLUSTER environment variable with your own name.

For more information about virtual nodes, see Virtual nodes. You must be using 1.15.0 or later of the Envoy image when setting these variables. For more information aboutApp Mesh Envoy variables, see Envoy image in the AWS App Mesh User Guide.

", + "CreateVirtualNode": "

Creates a virtual node within a service mesh.

A virtual node acts as a logical pointer to a particular task group, such as an Amazon ECS service or a Kubernetes deployment. When you create a virtual node, you can specify the service discovery information for your task group, and whether the proxy running in a task group will communicate with other proxies using Transport Layer Security (TLS).

You define a listener for any inbound traffic that your virtual node expects. Any virtual service that your virtual node expects to communicate to is specified as a backend.

The response metadata for your new virtual node contains the arn that is associated with the virtual node. Set this value to the full ARN; for example, arn:aws:appmesh:us-west-2:123456789012:myMesh/default/virtualNode/myApp) as the APPMESH_RESOURCE_ARN environment variable for your task group's Envoy proxy container in your task definition or pod spec. This is then mapped to the node.id and node.cluster Envoy parameters.

By default, App Mesh uses the name of the resource you specified in APPMESH_RESOURCE_ARN when Envoy is referring to itself in metrics and traces. You can override this behavior by setting the APPMESH_RESOURCE_CLUSTER environment variable with your own name.

For more information about virtual nodes, see Virtual nodes. You must be using 1.15.0 or later of the Envoy image when setting these variables. For more information aboutApp Mesh Envoy variables, see Envoy image in the App Mesh User Guide.

", "CreateVirtualRouter": "

Creates a virtual router within a service mesh.

Specify a listener for any inbound traffic that your virtual router receives. Create a virtual router for each protocol and port that you need to route. Virtual routers handle traffic for one or more virtual services within your mesh. After you create your virtual router, create and associate routes for your virtual router that direct incoming requests to different virtual nodes.

For more information about virtual routers, see Virtual routers.

", "CreateVirtualService": "

Creates a virtual service within a service mesh.

A virtual service is an abstraction of a real service that is provided by a virtual node directly or indirectly by means of a virtual router. Dependent services call your virtual service by its virtualServiceName, and those requests are routed to the virtual node or virtual router that is specified as the provider for the virtual service.

For more information about virtual services, see Virtual services.

", "DeleteGatewayRoute": "

Deletes an existing gateway route.

", @@ -51,53 +51,53 @@ "AccountId": { "base": null, "refs": { - "CreateGatewayRouteInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes.

", - "CreateRouteInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes.

", - "CreateVirtualGatewayInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes.

", - "CreateVirtualNodeInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes.

", - "CreateVirtualRouterInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes.

", - "CreateVirtualServiceInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes.

", - "DeleteGatewayRouteInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "DeleteRouteInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "DeleteVirtualGatewayInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "DeleteVirtualNodeInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "DeleteVirtualRouterInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "DeleteVirtualServiceInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "DescribeGatewayRouteInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "DescribeMeshInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "DescribeRouteInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "DescribeVirtualGatewayInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "DescribeVirtualNodeInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "DescribeVirtualRouterInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "DescribeVirtualServiceInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "GatewayRouteRef$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "GatewayRouteRef$resourceOwner": "

The AWS IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", - "ListGatewayRoutesInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "ListRoutesInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "ListVirtualGatewaysInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "ListVirtualNodesInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "ListVirtualRoutersInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "ListVirtualServicesInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "MeshRef$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "MeshRef$resourceOwner": "

The AWS IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", - "ResourceMetadata$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "ResourceMetadata$resourceOwner": "

The AWS IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", - "RouteRef$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "RouteRef$resourceOwner": "

The AWS IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", - "UpdateGatewayRouteInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "UpdateRouteInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "UpdateVirtualGatewayInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "UpdateVirtualNodeInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "UpdateVirtualRouterInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "UpdateVirtualServiceInput$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "VirtualGatewayRef$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "VirtualGatewayRef$resourceOwner": "

The AWS IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", - "VirtualNodeRef$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "VirtualNodeRef$resourceOwner": "

The AWS IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", - "VirtualRouterRef$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "VirtualRouterRef$resourceOwner": "

The AWS IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", - "VirtualServiceRef$meshOwner": "

The AWS IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", - "VirtualServiceRef$resourceOwner": "

The AWS IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

" + "CreateGatewayRouteInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes.

", + "CreateRouteInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes.

", + "CreateVirtualGatewayInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes.

", + "CreateVirtualNodeInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes.

", + "CreateVirtualRouterInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes.

", + "CreateVirtualServiceInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then the account that you specify must share the mesh with your account before you can create the resource in the service mesh. For more information about mesh sharing, see Working with shared meshes.

", + "DeleteGatewayRouteInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "DeleteRouteInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "DeleteVirtualGatewayInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "DeleteVirtualNodeInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "DeleteVirtualRouterInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "DeleteVirtualServiceInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "DescribeGatewayRouteInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "DescribeMeshInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "DescribeRouteInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "DescribeVirtualGatewayInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "DescribeVirtualNodeInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "DescribeVirtualRouterInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "DescribeVirtualServiceInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "GatewayRouteRef$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "GatewayRouteRef$resourceOwner": "

The Amazon Web Services IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", + "ListGatewayRoutesInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "ListRoutesInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "ListVirtualGatewaysInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "ListVirtualNodesInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "ListVirtualRoutersInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "ListVirtualServicesInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "MeshRef$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "MeshRef$resourceOwner": "

The Amazon Web Services IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", + "ResourceMetadata$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "ResourceMetadata$resourceOwner": "

The Amazon Web Services IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", + "RouteRef$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "RouteRef$resourceOwner": "

The Amazon Web Services IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", + "UpdateGatewayRouteInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "UpdateRouteInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "UpdateVirtualGatewayInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "UpdateVirtualNodeInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "UpdateVirtualRouterInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "UpdateVirtualServiceInput$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "VirtualGatewayRef$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "VirtualGatewayRef$resourceOwner": "

The Amazon Web Services IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", + "VirtualNodeRef$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "VirtualNodeRef$resourceOwner": "

The Amazon Web Services IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", + "VirtualRouterRef$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "VirtualRouterRef$resourceOwner": "

The Amazon Web Services IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

", + "VirtualServiceRef$meshOwner": "

The Amazon Web Services IAM account ID of the service mesh owner. If the account ID is not your own, then it's the ID of the account that shared the mesh with your account. For more information about mesh sharing, see Working with shared meshes.

", + "VirtualServiceRef$resourceOwner": "

The Amazon Web Services IAM account ID of the resource owner. If the account ID is not your own, then it's the ID of the mesh owner or of another account that the mesh is shared with. For more information about mesh sharing, see Working with shared meshes.

" } }, "Arn": { @@ -121,7 +121,7 @@ } }, "AwsCloudMapInstanceAttribute": { - "base": "

An object that represents the Cloud Map attribute information for your virtual node.

AWS Cloud Map is not available in the eu-south-1 Region.

", + "base": "

An object that represents the Cloud Map attribute information for your virtual node.

Cloud Map is not available in the eu-south-1 Region.

", "refs": { "AwsCloudMapInstanceAttributes$member": null } @@ -503,7 +503,7 @@ "FilePath": { "base": null, "refs": { - "FileAccessLog$path": "

The file path to write access logs to. You can use /dev/stdout to send access logs to standard out and configure your Envoy container to use a log driver, such as awslogs, to export the access logs to a log storage service such as Amazon CloudWatch Logs. You can also specify a path in the Envoy container's file system to write the files to disk.

The Envoy process must have write permissions to the path that you specify here. Otherwise, Envoy fails to bootstrap properly.

", + "FileAccessLog$path": "

The file path to write access logs to. You can use /dev/stdout to send access logs to standard out and configure your Envoy container to use a log driver, such as awslogs, to export the access logs to a log storage service such as Amazon CloudWatch Logs. You can also specify a path in the Envoy container's file system to write the files to disk.

 <note> <p>The Envoy process must have write permissions to the path that you specify here. Otherwise, Envoy fails to bootstrap properly.</p> </note>
", "ListenerTlsFileCertificate$certificateChain": "

The certificate chain for the certificate.

", "ListenerTlsFileCertificate$privateKey": "

The private key for a certificate stored on the file system of the virtual node that the proxy is running on.

", "TlsValidationContextFileTrust$certificateChain": "

The certificate trust chain for a certificate stored on the file system of the virtual node that the proxy is running on.

", @@ -715,7 +715,7 @@ "HeaderMatchMethod": { "base": "

An object that represents the method and value to match with the header value sent in a request. Specify one match method.

", "refs": { - "HttpGatewayRouteHeader$match": null, + "HttpGatewayRouteHeader$match": "

An object that represents the method and value to match with the header value sent in a request. Specify one match method.

", "HttpRouteHeader$match": "

The HeaderMatchMethod object.

" } }, @@ -923,8 +923,16 @@ "refs": { } }, + "IpPreference": { + "base": null, + "refs": { + "AwsCloudMapServiceDiscovery$ipPreference": "

The IP version to use to control traffic within the mesh.

", + "DnsServiceDiscovery$ipPreference": "

The IP version to use to control traffic within the mesh.

", + "MeshServiceDiscovery$ipPreference": "

The IP version to use to control traffic within the mesh.

" + } + }, "LimitExceededException": { - "base": "

You have exceeded a service limit for your account. For more information, see Service Limits in the AWS App Mesh User Guide.

", + "base": "

You have exceeded a service limit for your account. For more information, see Service Limits in the App Mesh User Guide.

", "refs": { } }, @@ -1069,9 +1077,9 @@ } }, "ListenerTlsAcmCertificate": { - "base": "

An object that represents an AWS Certicate Manager (ACM) certificate.

", + "base": "

An object that represents an Certificate Manager certificate.

", "refs": { - "ListenerTlsCertificate$acm": "

A reference to an object that represents an AWS Certicate Manager (ACM) certificate.

" + "ListenerTlsCertificate$acm": "

A reference to an object that represents an Certificate Manager certificate.

" } }, "ListenerTlsCertificate": { @@ -1199,6 +1207,12 @@ "MeshList$member": null } }, + "MeshServiceDiscovery": { + "base": "

An object that represents the service discovery information for a service mesh.

", + "refs": { + "MeshSpec$serviceDiscovery": null + } + }, "MeshSpec": { "base": "

An object that represents the specification of a service mesh.

", "refs": { diff --git a/apis/batch/2016-08-10/docs-2.json b/apis/batch/2016-08-10/docs-2.json index d27e5f09ea8..f05ee8bf3d4 100644 --- a/apis/batch/2016-08-10/docs-2.json +++ b/apis/batch/2016-08-10/docs-2.json @@ -3,7 +3,7 @@ "service": "Batch

Using Batch, you can run batch computing workloads on the Amazon Web Services Cloud. Batch computing is a common means for developers, scientists, and engineers to access large amounts of compute resources. Batch uses the advantages of this computing workload to remove the undifferentiated heavy lifting of configuring and managing required infrastructure. At the same time, it also adopts a familiar batch computing software approach. Given these advantages, Batch can help you to efficiently provision resources in response to jobs submitted, thus effectively helping you to eliminate capacity constraints, reduce compute costs, and deliver your results more quickly.

As a fully managed service, Batch can run batch computing workloads of any scale. Batch automatically provisions compute resources and optimizes workload distribution based on the quantity and scale of your specific workloads. With Batch, there's no need to install or manage batch computing software. This means that you can focus your time and energy on analyzing results and solving your specific problems.

", "operations": { "CancelJob": "

Cancels a job in an Batch job queue. Jobs that are in the SUBMITTED, PENDING, or RUNNABLE state are canceled. Jobs that have progressed to STARTING or RUNNING aren't canceled, but the API operation still succeeds, even if no job is canceled. These jobs must be terminated with the TerminateJob operation.

", - "CreateComputeEnvironment": "

Creates an Batch compute environment. You can create MANAGED or UNMANAGED compute environments. MANAGED compute environments can use Amazon EC2 or Fargate resources. UNMANAGED compute environments can only use EC2 resources.

In a managed compute environment, Batch manages the capacity and instance types of the compute resources within the environment. This is based on the compute resource specification that you define or the launch template that you specify when you create the compute environment. Either, you can choose to use EC2 On-Demand Instances and EC2 Spot Instances. Or, you can use Fargate and Fargate Spot capacity in your managed compute environment. You can optionally set a maximum price so that Spot Instances only launch when the Spot Instance price is less than a specified percentage of the On-Demand price.

Multi-node parallel jobs aren't supported on Spot Instances.

In an unmanaged compute environment, you can manage your own EC2 compute resources and have a lot of flexibility with how you configure your compute resources. For example, you can use custom AMIs. However, you must verify that each of your AMIs meet the Amazon ECS container instance AMI specification. For more information, see container instance AMIs in the Amazon Elastic Container Service Developer Guide. After you created your unmanaged compute environment, you can use the DescribeComputeEnvironments operation to find the Amazon ECS cluster that's associated with it. Then, launch your container instances into that Amazon ECS cluster. For more information, see Launching an Amazon ECS container instance in the Amazon Elastic Container Service Developer Guide.

Batch doesn't upgrade the AMIs in a compute environment after the environment is created. For example, it doesn't update the AMIs when a newer version of the Amazon ECS optimized AMI is available. Therefore, you're responsible for managing the guest operating system (including its updates and security patches) and any additional application software or utilities that you install on the compute resources. To use a new AMI for your Batch jobs, complete these steps:

  1. Create a new compute environment with the new AMI.

  2. Add the compute environment to an existing job queue.

  3. Remove the earlier compute environment from your job queue.

  4. Delete the earlier compute environment.

", + "CreateComputeEnvironment": "

Creates an Batch compute environment. You can create MANAGED or UNMANAGED compute environments. MANAGED compute environments can use Amazon EC2 or Fargate resources. UNMANAGED compute environments can only use EC2 resources.

In a managed compute environment, Batch manages the capacity and instance types of the compute resources within the environment. This is based on the compute resource specification that you define or the launch template that you specify when you create the compute environment. Either, you can choose to use EC2 On-Demand Instances and EC2 Spot Instances. Or, you can use Fargate and Fargate Spot capacity in your managed compute environment. You can optionally set a maximum price so that Spot Instances only launch when the Spot Instance price is less than a specified percentage of the On-Demand price.

Multi-node parallel jobs aren't supported on Spot Instances.

In an unmanaged compute environment, you can manage your own EC2 compute resources and have a lot of flexibility with how you configure your compute resources. For example, you can use custom AMIs. However, you must verify that each of your AMIs meet the Amazon ECS container instance AMI specification. For more information, see container instance AMIs in the Amazon Elastic Container Service Developer Guide. After you created your unmanaged compute environment, you can use the DescribeComputeEnvironments operation to find the Amazon ECS cluster that's associated with it. Then, launch your container instances into that Amazon ECS cluster. For more information, see Launching an Amazon ECS container instance in the Amazon Elastic Container Service Developer Guide.

Batch doesn't automatically upgrade the AMIs in a compute environment after it's created. For example, it also doesn't update the AMIs in your compute environment when a newer version of the Amazon ECS optimized AMI is available. You're responsible for the management of the guest operating system. This includes any updates and security patches. You're also responsible for any additional application software or utilities that you install on the compute resources. There are two ways to use a new AMI for your Batch jobs. The original method is to complete these steps:

  1. Create a new compute environment with the new AMI.

  2. Add the compute environment to an existing job queue.

  3. Remove the earlier compute environment from your job queue.

  4. Delete the earlier compute environment.

In April 2022, Batch added enhanced support for updating compute environments. For more information, see Updating compute environments. To use the enhanced updating of compute environments to update AMIs, follow these rules:

If these rules are followed, any update that triggers an infrastructure update will cause the AMI ID to be re-selected. If the version setting in the launch template (launchTemplate) is set to $Latest or $Default, the latest or default version of the launch template will be evaluated up at the time of the infrastructure update, even if the launchTemplate was not updated.

", "CreateJobQueue": "

Creates an Batch job queue. When you create a job queue, you associate one or more compute environments to the queue and assign an order of preference for the compute environments.

You also set a priority to the job queue that determines the order that the Batch scheduler places jobs onto its associated compute environments. For example, if a compute environment is associated with more than one job queue, the job queue with a higher priority is given preference for scheduling jobs to that compute environment.

", "CreateSchedulingPolicy": "

Creates an Batch scheduling policy.

", "DeleteComputeEnvironment": "

Deletes an Batch compute environment.

Before you can delete a compute environment, you must set its state to DISABLED with the UpdateComputeEnvironment API operation and disassociate it from any job queues with the UpdateJobQueue API operation. Compute environments that use Fargate resources must terminate all active jobs on that compute environment before deleting the compute environment. If this isn't done, the compute environment enters an invalid state.

", @@ -1065,7 +1065,7 @@ "StringList$member": null, "SubmitJobRequest$jobName": "

The name of the job. It can be up to 128 letters long. The first character must be alphanumeric, can contain uppercase and lowercase letters, numbers, hyphens (-), and underscores (_).

", "SubmitJobRequest$jobQueue": "

The job queue where the job is submitted. You can specify either the name or the Amazon Resource Name (ARN) of the queue.

", - "SubmitJobRequest$shareIdentifier": "

The share identifier for the job.

", + "SubmitJobRequest$shareIdentifier": "

The share identifier for the job. If the job queue does not have a scheduling policy, then this parameter must not be specified. If the job queue has a scheduling policy, then this parameter must be specified.

", "SubmitJobRequest$jobDefinition": "

The job definition used by this job. This value can be one of name, name:revision, or the Amazon Resource Name (ARN) for the job definition. If name is specified without a revision then the latest active revision is used.

", "SubmitJobResponse$jobArn": "

The Amazon Resource Name (ARN) for the job.

", "SubmitJobResponse$jobName": "

The name of the job.

", @@ -1170,7 +1170,7 @@ "TagsMap": { "base": null, "refs": { - "ComputeResource$tags": "

Key-value pair tags to be applied to EC2 resources that are launched in the compute environment. For Batch, these take the form of \"String1\": \"String2\", where String1 is the tag key and String2 is the tag value−for example, { \"Name\": \"Batch Instance - C4OnDemand\" }. This is helpful for recognizing your Batch instances in the Amazon EC2 console. These tags can't be updated or removed after the compute environment is created. Any changes to these tags require that you create a new compute environment and remove the old compute environment. These tags aren't seen when using the Batch ListTagsForResource API operation.

This parameter isn't applicable to jobs that are running on Fargate resources, and shouldn't be specified.

", + "ComputeResource$tags": "

Key-value pair tags to be applied to EC2 resources that are launched in the compute environment. For Batch, these take the form of \"String1\": \"String2\", where String1 is the tag key and String2 is the tag value−for example, { \"Name\": \"Batch Instance - C4OnDemand\" }. This is helpful for recognizing your Batch instances in the Amazon EC2 console. Updating these tags requires an infrastructure update to the compute environment. For more information, see Updating compute environments in the Batch User Guide. These tags aren't seen when using the Batch ListTagsForResource API operation.

This parameter isn't applicable to jobs that are running on Fargate resources, and shouldn't be specified.

", "ComputeResourceUpdate$tags": "

Key-value pair tags to be applied to EC2 resources that are launched in the compute environment. For Batch, these take the form of \"String1\": \"String2\", where String1 is the tag key and String2 is the tag value−for example, { \"Name\": \"Batch Instance - C4OnDemand\" }. This is helpful for recognizing your Batch instances in the Amazon EC2 console. These tags aren't seen when using the Batch ListTagsForResource API operation.

When updating a compute environment, changing this setting requires an infrastructure update of the compute environment. For more information, see Updating compute environments in the Batch User Guide.

This parameter isn't applicable to jobs that are running on Fargate resources, and shouldn't be specified.

" } }, diff --git a/apis/greengrassv2/2020-11-30/api-2.json b/apis/greengrassv2/2020-11-30/api-2.json index 882abbc8db1..f42fc301c98 100644 --- a/apis/greengrassv2/2020-11-30/api-2.json +++ b/apis/greengrassv2/2020-11-30/api-2.json @@ -110,6 +110,7 @@ {"shape":"AccessDeniedException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"}, + {"shape":"ConflictException"}, {"shape":"RequestAlreadyInProgressException"} ] }, @@ -147,6 +148,23 @@ {"shape":"ConflictException"} ] }, + "DeleteDeployment":{ + "name":"DeleteDeployment", + "http":{ + "method":"DELETE", + "requestUri":"/greengrass/v2/deployments/{deploymentId}", + "responseCode":204 + }, + "input":{"shape":"DeleteDeploymentRequest"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"ValidationException"}, + {"shape":"AccessDeniedException"}, + {"shape":"InternalServerException"}, + {"shape":"ConflictException"}, + {"shape":"ThrottlingException"} + ] + }, "DescribeComponent":{ "name":"DescribeComponent", "http":{ @@ -311,6 +329,7 @@ "errors":[ {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, + {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"} ] @@ -403,9 +422,9 @@ {"shape":"ValidationException"}, {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"}, + {"shape":"ConflictException"}, {"shape":"ThrottlingException"}, - {"shape":"InternalServerException"}, - {"shape":"ConflictException"} + {"shape":"InternalServerException"} ] }, "TagResource":{ @@ -485,8 +504,7 @@ "AssociateClientDeviceWithCoreDeviceErrorList":{ "type":"list", "member":{"shape":"AssociateClientDeviceWithCoreDeviceErrorEntry"}, - "max":100, - "min":1 + "max":100 }, "AssociateServiceRoleToAccountRequest":{ "type":"structure", @@ -598,7 +616,9 @@ "members":{ "componentState":{"shape":"CloudComponentState"}, "message":{"shape":"NonEmptyString"}, - "errors":{"shape":"StringMap"} + "errors":{"shape":"StringMap"}, + "vendorGuidance":{"shape":"VendorGuidance"}, + "vendorGuidanceMessage":{"shape":"NonEmptyString"} } }, "Component":{ @@ -611,7 +631,7 @@ }, "ComponentARN":{ "type":"string", - "pattern":"arn:aws(-cn|-us-gov)?:greengrass:[^:]+:(aws|[0-9]+):components:[^:]+" + "pattern":"arn:[^:]*:greengrass:[^:]*:(aws|[0-9]+):components:[^:]+" }, "ComponentCandidate":{ "type":"structure", @@ -636,7 +656,7 @@ }, "ComponentConfigurationString":{ "type":"string", - "max":65536, + "max":10485760, "min":1 }, "ComponentConfigurationUpdate":{ @@ -696,8 +716,7 @@ "ComponentNameString":{ "type":"string", "max":128, - "min":1, - "pattern":"[a-zA-Z0-9-_.]+" + "min":1 }, "ComponentPlatform":{ "type":"structure", @@ -720,7 +739,7 @@ }, "ComponentVersionARN":{ "type":"string", - "pattern":"arn:aws(-cn|-us-gov)?:greengrass:[^:]+:(aws|[0-9]+):components:[^:]+:versions:[^:]+" + "pattern":"arn:[^:]*:greengrass:[^:]*:(aws|[0-9]+):components:[^:]+:versions:[^:]+" }, "ComponentVersionList":{ "type":"list", @@ -742,8 +761,7 @@ "ComponentVersionString":{ "type":"string", "max":64, - "min":1, - "pattern":"[0-9a-zA-Z-.+]+" + "min":1 }, "ComponentVisibilityScope":{ "type":"string", @@ -901,6 +919,17 @@ } } }, + "DeleteDeploymentRequest":{ + "type":"structure", + "required":["deploymentId"], + "members":{ + "deploymentId":{ + "shape":"NonEmptyString", + "location":"uri", + "locationName":"deploymentId" + } + } + }, "Deployment":{ "type":"structure", "members":{ @@ -1040,8 +1069,7 @@ "DisassociateClientDeviceFromCoreDeviceErrorList":{ "type":"list", "member":{"shape":"DisassociateClientDeviceFromCoreDeviceErrorEntry"}, - "max":100, - "min":1 + "max":100 }, "DisassociateServiceRoleFromAccountRequest":{ "type":"structure", @@ -1104,7 +1132,7 @@ }, "GenericV2ARN":{ "type":"string", - "pattern":"arn:aws(-cn|-us-gov)?:greengrass:[^:]+:(aws|[0-9]+):(components|deployments|coreDevices):.+" + "pattern":"arn:[^:]*:greengrass:[^:]*:(aws|[0-9]+):(components|deployments|coreDevices):.*" }, "GetComponentRequest":{ "type":"structure", @@ -1298,7 +1326,7 @@ }, "IoTJobARN":{ "type":"string", - "pattern":"arn:aws(-cn|-us-gov)?:iot:[^:]+:[0-9]+:job/.+" + "pattern":"arn:[^:]*:iot:[^:]+:[0-9]+:job/.+" }, "IoTJobAbortAction":{ "type":"string", @@ -1531,7 +1559,7 @@ }, "LambdaFunctionARNWithVersionNumber":{ "type":"string", - "pattern":"arn:aws(-cn|-us-gov)?:lambda:[^:]+:[0-9]+:function:[a-zA-Z0-9-_]+:[0-9]+" + "pattern":"arn:[^:]*:lambda:[^:]+:[0-9]+:function:[a-zA-Z0-9-_]+:[0-9]+" }, "LambdaFunctionRecipeSource":{ "type":"structure", @@ -1872,10 +1900,6 @@ }, "ResolveComponentCandidatesRequest":{ "type":"structure", - "required":[ - "platform", - "componentCandidates" - ], "members":{ "platform":{"shape":"ComponentPlatform"}, "componentCandidates":{"shape":"ComponentCandidateList"} @@ -1893,7 +1917,9 @@ "arn":{"shape":"ComponentVersionARN"}, "componentName":{"shape":"ComponentNameString"}, "componentVersion":{"shape":"ComponentVersionString"}, - "recipe":{"shape":"RecipeBlob"} + "recipe":{"shape":"RecipeBlob"}, + "vendorGuidance":{"shape":"VendorGuidance"}, + "message":{"shape":"NonEmptyString"} } }, "ResolvedComponentVersionsList":{ @@ -1949,20 +1975,19 @@ "TagKey":{ "type":"string", "max":128, - "min":1, - "pattern":"^(?!aws:)[a-zA-Z+-=._:/]+$" + "min":1 }, "TagKeyList":{ "type":"list", "member":{"shape":"TagKey"}, - "max":50, + "max":200, "min":1 }, "TagMap":{ "type":"map", "key":{"shape":"TagKey"}, "value":{"shape":"TagValue"}, - "max":50, + "max":200, "min":1 }, "TagResourceRequest":{ @@ -1991,11 +2016,11 @@ }, "TargetARN":{ "type":"string", - "pattern":"arn:aws(-cn|-us-gov)?:iot:[^:]+:[0-9]+:(thing|thinggroup)/.+" + "pattern":"arn:[^:]*:iot:[^:]*:[0-9]+:(thing|thinggroup)/.+" }, "ThingGroupARN":{ "type":"string", - "pattern":"arn:aws(-cn|-us-gov)?:iot:[^:]+:[0-9]+:thinggroup/.+" + "pattern":"arn:[^:]*:iot:[^:]*:[0-9]+:thinggroup/.+" }, "ThrottlingException":{ "type":"structure", @@ -2105,6 +2130,14 @@ "OTHER" ] }, + "VendorGuidance":{ + "type":"string", + "enum":[ + "ACTIVE", + "DISCONTINUED", + "DELETED" + ] + }, "connectivityInfoList":{ "type":"list", "member":{"shape":"ConnectivityInfo"} diff --git a/apis/greengrassv2/2020-11-30/docs-2.json b/apis/greengrassv2/2020-11-30/docs-2.json index b436d3451dd..ed11dd1d7fe 100644 --- a/apis/greengrassv2/2020-11-30/docs-2.json +++ b/apis/greengrassv2/2020-11-30/docs-2.json @@ -6,25 +6,26 @@ "BatchAssociateClientDeviceWithCoreDevice": "

Associates a list of client devices with a core device. Use this API operation to specify which client devices can discover a core device through cloud discovery. With cloud discovery, client devices connect to IoT Greengrass to retrieve associated core devices' connectivity information and certificates. For more information, see Configure cloud discovery in the IoT Greengrass V2 Developer Guide.

Client devices are local IoT devices that connect to and communicate with an IoT Greengrass core device over MQTT. You can connect client devices to a core device to sync MQTT messages and data to Amazon Web Services IoT Core and interact with client devices in Greengrass components. For more information, see Interact with local IoT devices in the IoT Greengrass V2 Developer Guide.

", "BatchDisassociateClientDeviceFromCoreDevice": "

Disassociates a list of client devices from a core device. After you disassociate a client device from a core device, the client device won't be able to use cloud discovery to retrieve the core device's connectivity information and certificates.

", "CancelDeployment": "

Cancels a deployment. This operation cancels the deployment for devices that haven't yet received it. If a device already received the deployment, this operation doesn't change anything for that device.

", - "CreateComponentVersion": "

Creates a component. Components are software that run on Greengrass core devices. After you develop and test a component on your core device, you can use this operation to upload your component to IoT Greengrass. Then, you can deploy the component to other core devices.

You can use this operation to do the following:

", + "CreateComponentVersion": "

Creates a component. Components are software that run on Greengrass core devices. After you develop and test a component on your core device, you can use this operation to upload your component to IoT Greengrass. Then, you can deploy the component to other core devices.

You can use this operation to do the following:

", "CreateDeployment": "

Creates a continuous deployment for a target, which is a Greengrass core device or group of core devices. When you add a new core device to a group of core devices that has a deployment, IoT Greengrass deploys that group's deployment to the new device.

You can define one deployment for each target. When you create a new deployment for a target that has an existing deployment, you replace the previous deployment. IoT Greengrass applies the new deployment to the target devices.

Every deployment has a revision number that indicates how many deployment revisions you define for a target. Use this operation to create a new revision of an existing deployment.

For more information, see the Create deployments in the IoT Greengrass V2 Developer Guide.

", "DeleteComponent": "

Deletes a version of a component from IoT Greengrass.

This operation deletes the component's recipe and artifacts. As a result, deployments that refer to this component version will fail. If you have deployments that use this component version, you can remove the component from the deployment or update the deployment to use a valid version.

", "DeleteCoreDevice": "

Deletes a Greengrass core device, which is an IoT thing. This operation removes the core device from the list of core devices. This operation doesn't delete the IoT thing. For more information about how to delete the IoT thing, see DeleteThing in the IoT API Reference.

", + "DeleteDeployment": "

Deletes a deployment. To delete an active deployment, you must first cancel it. For more information, see CancelDeployment.

Deleting a deployment doesn't affect core devices that run that deployment, because core devices store the deployment's configuration on the device. Additionally, core devices can roll back to a previous deployment that has been deleted.

", "DescribeComponent": "

Retrieves metadata for a version of a component.

", "DisassociateServiceRoleFromAccount": "

Disassociates the Greengrass service role from IoT Greengrass for your Amazon Web Services account in this Amazon Web Services Region. Without a service role, IoT Greengrass can't verify the identity of client devices or manage core device connectivity information. For more information, see Greengrass service role in the IoT Greengrass Version 2 Developer Guide.

", "GetComponent": "

Gets the recipe for a version of a component. Core devices can call this operation to identify the artifacts and requirements to install a component.

", - "GetComponentVersionArtifact": "

Gets the pre-signed URL to download a public component artifact. Core devices call this operation to identify the URL that they can use to download an artifact to install.

", + "GetComponentVersionArtifact": "

Gets the pre-signed URL to download a public or a Lambda component artifact. Core devices call this operation to identify the URL that they can use to download an artifact to install.

", "GetConnectivityInfo": "

Retrieves connectivity information for a Greengrass core device.

Connectivity information includes endpoints and ports where client devices can connect to an MQTT broker on the core device. When a client device calls the IoT Greengrass discovery API, IoT Greengrass returns connectivity information for all of the core devices where the client device can connect. For more information, see Connect client devices to core devices in the IoT Greengrass Version 2 Developer Guide.

", - "GetCoreDevice": "

Retrieves metadata for a Greengrass core device.

", + "GetCoreDevice": "

Retrieves metadata for a Greengrass core device.

IoT Greengrass relies on individual devices to send status updates to the Amazon Web Services Cloud. If the IoT Greengrass Core software isn't running on the device, or if device isn't connected to the Amazon Web Services Cloud, then the reported status of that device might not reflect its current status. The status timestamp indicates when the device status was last updated.

Core devices send status updates at the following times:

", "GetDeployment": "

Gets a deployment. Deployments define the components that run on Greengrass core devices.

", "GetServiceRoleForAccount": "

Gets the service role associated with IoT Greengrass for your Amazon Web Services account in this Amazon Web Services Region. IoT Greengrass uses this role to verify the identity of client devices and manage core device connectivity information. For more information, see Greengrass service role in the IoT Greengrass Version 2 Developer Guide.

", "ListClientDevicesAssociatedWithCoreDevice": "

Retrieves a paginated list of client devices that are associated with a core device.

", "ListComponentVersions": "

Retrieves a paginated list of all versions for a component. Greater versions are listed first.

", "ListComponents": "

Retrieves a paginated list of component summaries. This list includes components that you have permission to view.

", - "ListCoreDevices": "

Retrieves a paginated list of Greengrass core devices.

", + "ListCoreDevices": "

Retrieves a paginated list of Greengrass core devices.

IoT Greengrass relies on individual devices to send status updates to the Amazon Web Services Cloud. If the IoT Greengrass Core software isn't running on the device, or if device isn't connected to the Amazon Web Services Cloud, then the reported status of that device might not reflect its current status. The status timestamp indicates when the device status was last updated.

Core devices send status updates at the following times:

", "ListDeployments": "

Retrieves a paginated list of deployments.

", "ListEffectiveDeployments": "

Retrieves a paginated list of deployment jobs that IoT Greengrass sends to Greengrass core devices.

", - "ListInstalledComponents": "

Retrieves a paginated list of the components that a Greengrass core device runs.

", + "ListInstalledComponents": "

Retrieves a paginated list of the components that a Greengrass core device runs. This list doesn't include components that are deployed from local deployments or components that are deployed as dependencies of other components.

IoT Greengrass relies on individual devices to send status updates to the Amazon Web Services Cloud. If the IoT Greengrass Core software isn't running on the device, or if device isn't connected to the Amazon Web Services Cloud, then the reported status of that device might not reflect its current status. The status timestamp indicates when the device status was last updated.

Core devices send status updates at the following times:

", "ListTagsForResource": "

Retrieves the list of tags for an IoT Greengrass resource.

", "ResolveComponentCandidates": "

Retrieves a list of components that meet the component, version, and platform requirements of a deployment. Greengrass core devices call this operation when they receive a deployment to identify the components to install.

This operation identifies components that meet all dependency requirements for a deployment. If the requirements conflict, then this operation returns an error and the deployment fails. For example, this occurs if component A requires version >2.0.0 and component B requires version <2.0.0 of a component dependency.

When you specify the component candidates to resolve, IoT Greengrass compares each component's digest from the core device with the component's digest in the Amazon Web Services Cloud. If the digests don't match, then IoT Greengrass specifies to use the version from the Amazon Web Services Cloud.

To use this operation, you must use the data plane API endpoint and authenticate with an IoT device certificate. For more information, see IoT Greengrass endpoints and quotas.

", "TagResource": "

Adds tags to an IoT Greengrass resource. If a tag already exists for the resource, this operation updates the tag's value.

", @@ -129,11 +130,11 @@ "CloudComponentState": { "base": null, "refs": { - "CloudComponentStatus$componentState": "

The state of the component.

" + "CloudComponentStatus$componentState": "

The state of the component version.

" } }, "CloudComponentStatus": { - "base": "

Contains the status of a component in the IoT Greengrass service.

", + "base": "

Contains the status of a component version in the IoT Greengrass service.

", "refs": { "CreateComponentVersionResponse$status": "

The status of the component version in IoT Greengrass V2. This status is different from the status of the component on a core device.

", "DescribeComponentResponse$status": "

The status of the component version in IoT Greengrass V2. This status is different from the status of the component on a core device.

" @@ -149,7 +150,7 @@ "base": null, "refs": { "Component$arn": "

The ARN of the component version.

", - "ListComponentVersionsRequest$arn": "

The ARN of the component version.

" + "ListComponentVersionsRequest$arn": "

The ARN of the component.

" } }, "ComponentCandidate": { @@ -274,7 +275,7 @@ "DescribeComponentRequest$arn": "

The ARN of the component version.

", "DescribeComponentResponse$arn": "

The ARN of the component version.

", "GetComponentRequest$arn": "

The ARN of the component version.

", - "GetComponentVersionArtifactRequest$arn": "

The ARN of the component version. Specify the ARN of a public component version.

", + "GetComponentVersionArtifactRequest$arn": "

The ARN of the component version. Specify the ARN of a public or a Lambda component version.

", "ResolvedComponentVersion$arn": "

The ARN of the component version.

" } }, @@ -414,6 +415,11 @@ "refs": { } }, + "DeleteDeploymentRequest": { + "base": null, + "refs": { + } + }, "Deployment": { "base": "

Contains information about a deployment.

", "refs": { @@ -1032,7 +1038,8 @@ "AssociateClientDeviceWithCoreDeviceErrorEntry$message": "

A message that provides additional information about the error.

", "CancelDeploymentRequest$deploymentId": "

The ID of the deployment.

", "CancelDeploymentResponse$message": "

A message that communicates if the cancel was successful.

", - "CloudComponentStatus$message": "

A message that communicates details, such as errors, about the status of the component.

", + "CloudComponentStatus$message": "

A message that communicates details, such as errors, about the status of the component version.

", + "CloudComponentStatus$vendorGuidanceMessage": "

A message that communicates details about the vendor guidance state of the component version. This message communicates why a component version is discontinued or deleted.

", "ComponentDependencyMap$key": null, "ComponentDependencyRequirement$versionRequirement": "

The component version requirement for the component dependency.

IoT Greengrass V2 uses semantic version constraints. For more information, see Semantic Versioning.

", "ComponentDeploymentSpecifications$key": null, @@ -1047,6 +1054,7 @@ "CreateDeploymentRequest$deploymentName": "

The name of the deployment.

", "CreateDeploymentResponse$deploymentId": "

The ID of the deployment.

", "CreateDeploymentResponse$iotJobId": "

The ID of the IoT job that applies the deployment to target devices.

", + "DeleteDeploymentRequest$deploymentId": "

The ID of the deployment.

", "Deployment$revisionId": "

The revision number of the deployment.

", "Deployment$deploymentId": "

The ID of the deployment.

", "Deployment$deploymentName": "

The name of the deployment.

", @@ -1060,6 +1068,7 @@ "LambdaEnvironmentVariables$key": null, "PlatformAttributesMap$key": null, "PlatformAttributesMap$value": null, + "ResolvedComponentVersion$message": "

A message that communicates details about the vendor guidance state of the component version. This message communicates why a component version is discontinued or deleted.

", "StringMap$key": null, "StringMap$value": null } @@ -1216,7 +1225,7 @@ "StringMap": { "base": null, "refs": { - "CloudComponentStatus$errors": "

A dictionary of errors that communicate why the component is in an error state. For example, if IoT Greengrass can't access an artifact for the component, then errors contains the artifact's URI as a key, and the error message as the value for that key.

" + "CloudComponentStatus$errors": "

A dictionary of errors that communicate why the component version is in an error state. For example, if IoT Greengrass can't access an artifact for the component version, then errors contains the artifact's URI as a key, and the error message as the value for that key.

" } }, "SystemResourceLimits": { @@ -1280,7 +1289,7 @@ "ThingGroupARN": { "base": null, "refs": { - "ListCoreDevicesRequest$thingGroupArn": "

The ARN of the IoT thing group by which to filter. If you specify this parameter, the list includes only core devices that are members of this thing group.

" + "ListCoreDevicesRequest$thingGroupArn": "

The ARN of the IoT thing group by which to filter. If you specify this parameter, the list includes only core devices that have successfully deployed a deployment that targets the thing group. When you remove a core device from a thing group, the list continues to include that core device.

" } }, "ThrottlingException": { @@ -1352,6 +1361,13 @@ "ValidationException$reason": "

The reason for the validation exception.

" } }, + "VendorGuidance": { + "base": null, + "refs": { + "CloudComponentStatus$vendorGuidance": "

The vendor guidance state for the component version. This state indicates whether the component version has any issues that you should consider before you deploy it. The vendor guidance state can be:

", + "ResolvedComponentVersion$vendorGuidance": "

The vendor guidance state for the component version. This state indicates whether the component version has any issues that you should consider before you deploy it. The vendor guidance state can be:

" + } + }, "connectivityInfoList": { "base": null, "refs": { diff --git a/apis/iotevents-data/2018-10-23/api-2.json b/apis/iotevents-data/2018-10-23/api-2.json index 04885db84b5..ccdfc5569b7 100644 --- a/apis/iotevents-data/2018-10-23/api-2.json +++ b/apis/iotevents-data/2018-10-23/api-2.json @@ -27,6 +27,22 @@ {"shape":"ThrottlingException"} ] }, + "BatchDeleteDetector":{ + "name":"BatchDeleteDetector", + "http":{ + "method":"POST", + "requestUri":"/detectors/delete", + "responseCode":200 + }, + "input":{"shape":"BatchDeleteDetectorRequest"}, + "output":{"shape":"BatchDeleteDetectorResponse"}, + "errors":[ + {"shape":"InvalidRequestException"}, + {"shape":"InternalFailureException"}, + {"shape":"ServiceUnavailableException"}, + {"shape":"ThrottlingException"} + ] + }, "BatchDisableAlarm":{ "name":"BatchDisableAlarm", "http":{ @@ -296,6 +312,31 @@ "errorMessage":{"shape":"ErrorMessage"} } }, + "BatchDeleteDetectorErrorEntries":{ + "type":"list", + "member":{"shape":"BatchDeleteDetectorErrorEntry"} + }, + "BatchDeleteDetectorErrorEntry":{ + "type":"structure", + "members":{ + "messageId":{"shape":"MessageId"}, + "errorCode":{"shape":"ErrorCode"}, + "errorMessage":{"shape":"ErrorMessage"} + } + }, + "BatchDeleteDetectorRequest":{ + "type":"structure", + "required":["detectors"], + "members":{ + "detectors":{"shape":"DeleteDetectorRequests"} + } + }, + "BatchDeleteDetectorResponse":{ + "type":"structure", + "members":{ + "batchDeleteDetectorErrorEntries":{"shape":"BatchDeleteDetectorErrorEntries"} + } + }, "BatchDisableAlarmRequest":{ "type":"structure", "required":["disableActionRequests"], @@ -430,6 +471,23 @@ "RESET" ] }, + "DeleteDetectorRequest":{ + "type":"structure", + "required":[ + "messageId", + "detectorModelName" + ], + "members":{ + "messageId":{"shape":"MessageId"}, + "detectorModelName":{"shape":"DetectorModelName"}, + "keyValue":{"shape":"KeyValue"} + } + }, + "DeleteDetectorRequests":{ + "type":"list", + "member":{"shape":"DeleteDetectorRequest"}, + "min":1 + }, "DescribeAlarmRequest":{ "type":"structure", "required":["alarmModelName"], diff --git a/apis/iotevents-data/2018-10-23/docs-2.json b/apis/iotevents-data/2018-10-23/docs-2.json index 0ab57819606..c1b1a649166 100644 --- a/apis/iotevents-data/2018-10-23/docs-2.json +++ b/apis/iotevents-data/2018-10-23/docs-2.json @@ -3,6 +3,7 @@ "service": "

IoT Events monitors your equipment or device fleets for failures or changes in operation, and triggers actions when such events occur. You can use IoT Events Data API commands to send inputs to detectors, list detectors, and view or update a detector's status.

For more information, see What is IoT Events? in the IoT Events Developer Guide.

", "operations": { "BatchAcknowledgeAlarm": "

Acknowledges one or more alarms. The alarms change to the ACKNOWLEDGED state after you acknowledge them.

", + "BatchDeleteDetector": "

Deletes one or more detectors that were created. When a detector is deleted, its state will be cleared and the detector will be removed from the list of detectors. The deleted detector will no longer appear if referenced in the ListDetectors API call.

", "BatchDisableAlarm": "

Disables one or more alarms. The alarms change to the DISABLED state after you disable them.

", "BatchEnableAlarm": "

Enables one or more alarms. The alarms change to the NORMAL state after you enable them.

", "BatchPutMessage": "

Sends a set of messages to the IoT Events system. Each message payload is transformed into the input you specify (\"inputName\") and ingested into any detectors that monitor that input. If multiple messages are sent, the order in which the messages are processed isn't guaranteed. To guarantee ordering, you must send messages one at a time and wait for a successful response.

", @@ -111,6 +112,28 @@ "BatchAlarmActionErrorEntries$member": null } }, + "BatchDeleteDetectorErrorEntries": { + "base": null, + "refs": { + "BatchDeleteDetectorResponse$batchDeleteDetectorErrorEntries": "

A list of errors associated with the request, or an empty array ([]) if there are no errors. Each error entry contains a messageId that helps you identify the entry that failed.

" + } + }, + "BatchDeleteDetectorErrorEntry": { + "base": "

Contains error messages associated with the deletion request.

", + "refs": { + "BatchDeleteDetectorErrorEntries$member": null + } + }, + "BatchDeleteDetectorRequest": { + "base": null, + "refs": { + } + }, + "BatchDeleteDetectorResponse": { + "base": null, + "refs": { + } + }, "BatchDisableAlarmRequest": { "base": null, "refs": { @@ -213,6 +236,18 @@ "CustomerAction$actionName": "

The name of the action. The action name can be one of the following values:

For more information, see the AlarmState API.

" } }, + "DeleteDetectorRequest": { + "base": "

Information used to delete the detector model.

", + "refs": { + "DeleteDetectorRequests$member": null + } + }, + "DeleteDetectorRequests": { + "base": null, + "refs": { + "BatchDeleteDetectorRequest$detectors": "

The list of one or more detectors to be deleted.

" + } + }, "DescribeAlarmRequest": { "base": null, "refs": { @@ -242,6 +277,7 @@ "DetectorModelName": { "base": null, "refs": { + "DeleteDetectorRequest$detectorModelName": "

The name of the detector model that was used to create the detector instance.

", "DescribeDetectorRequest$detectorModelName": "

The name of the detector model whose detectors (instances) you want information about.

", "Detector$detectorModelName": "

The name of the detector model that created this detector (instance).

", "DetectorSummary$detectorModelName": "

The name of the detector model that created this detector (instance).

", @@ -338,6 +374,7 @@ "base": null, "refs": { "BatchAlarmActionErrorEntry$errorCode": "

The error code.

", + "BatchDeleteDetectorErrorEntry$errorCode": "

The error code.

", "BatchPutMessageErrorEntry$errorCode": "

The error code.

", "BatchUpdateDetectorErrorEntry$errorCode": "

The error code.

" } @@ -346,6 +383,7 @@ "base": null, "refs": { "BatchAlarmActionErrorEntry$errorMessage": "

A message that describes the error.

", + "BatchDeleteDetectorErrorEntry$errorMessage": "

A message that describes the error.

", "BatchPutMessageErrorEntry$errorMessage": "

A message that describes the error.

", "BatchUpdateDetectorErrorEntry$errorMessage": "

A message that describes the error.

" } @@ -378,6 +416,7 @@ "AcknowledgeAlarmActionRequest$keyValue": "

The value of the key used as a filter to select only the alarms associated with the key.

", "Alarm$keyValue": "

The value of the key used as a filter to select only the alarms associated with the key.

", "AlarmSummary$keyValue": "

The value of the key used as a filter to select only the alarms associated with the key.

", + "DeleteDetectorRequest$keyValue": "

The value of the key used to identify the detector.

", "DescribeAlarmRequest$keyValue": "

The value of the key used as a filter to select only the alarms associated with the key.

", "DescribeDetectorRequest$keyValue": "

A filter used to limit results to detectors (instances) created because of the given key ID.

", "Detector$keyValue": "

The value of the key (identifying the device or system) that caused the creation of this detector (instance).

", @@ -425,8 +464,10 @@ "MessageId": { "base": null, "refs": { + "BatchDeleteDetectorErrorEntry$messageId": "

The ID of the message that caused the error. (See the value of the \"messageId\" in the detectors object of the DeleteDetectorRequest.)

", "BatchPutMessageErrorEntry$messageId": "

The ID of the message that caused the error. (See the value corresponding to the \"messageId\" key in the \"message\" object.)

", "BatchUpdateDetectorErrorEntry$messageId": "

The \"messageId\" of the update request that caused the error. (The value of the \"messageId\" in the update request \"Detector\" object.)

", + "DeleteDetectorRequest$messageId": "

The ID to assign to the DeleteDetectorRequest. Each \"messageId\" must be unique within each batch sent.

", "Message$messageId": "

The ID to assign to the message. Within each batch sent, each \"messageId\" must be unique.

", "UpdateDetectorRequest$messageId": "

The ID to assign to the detector update \"message\". Each \"messageId\" must be unique within each batch sent.

" } diff --git a/apis/quicksight/2018-04-01/api-2.json b/apis/quicksight/2018-04-01/api-2.json index 33e563a1a09..62fb936e1c3 100644 --- a/apis/quicksight/2018-04-01/api-2.json +++ b/apis/quicksight/2018-04-01/api-2.json @@ -1956,6 +1956,23 @@ {"shape":"InternalFailureException"} ] }, + "UpdatePublicSharingSettings":{ + "name":"UpdatePublicSharingSettings", + "http":{ + "method":"PUT", + "requestUri":"/accounts/{AwsAccountId}/public-sharing-settings" + }, + "input":{"shape":"UpdatePublicSharingSettingsRequest"}, + "output":{"shape":"UpdatePublicSharingSettingsResponse"}, + "errors":[ + {"shape":"AccessDeniedException"}, + {"shape":"InvalidParameterValueException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"ThrottlingException"}, + {"shape":"UnsupportedPricingPlanException"}, + {"shape":"InternalFailureException"} + ] + }, "UpdateTemplate":{ "name":"UpdateTemplate", "http":{ @@ -2105,7 +2122,8 @@ "AccountName":{"shape":"String"}, "Edition":{"shape":"Edition"}, "DefaultNamespace":{"shape":"Namespace"}, - "NotificationEmail":{"shape":"String"} + "NotificationEmail":{"shape":"String"}, + "PublicSharingEnabled":{"shape":"Boolean"} } }, "ActionList":{ @@ -8798,6 +8816,28 @@ "member":{"shape":"ResourcePermission"}, "max":2 }, + "UpdatePublicSharingSettingsRequest":{ + "type":"structure", + "required":["AwsAccountId"], + "members":{ + "AwsAccountId":{ + "shape":"AwsAccountId", + "location":"uri", + "locationName":"AwsAccountId" + }, + "PublicSharingEnabled":{"shape":"Boolean"} + } + }, + "UpdatePublicSharingSettingsResponse":{ + "type":"structure", + "members":{ + "RequestId":{"shape":"String"}, + "Status":{ + "shape":"StatusCode", + "location":"statusCode" + } + } + }, "UpdateResourcePermissionList":{ "type":"list", "member":{"shape":"ResourcePermission"}, diff --git a/apis/quicksight/2018-04-01/docs-2.json b/apis/quicksight/2018-04-01/docs-2.json index 411986fa95e..8cb0caef0b6 100644 --- a/apis/quicksight/2018-04-01/docs-2.json +++ b/apis/quicksight/2018-04-01/docs-2.json @@ -62,8 +62,8 @@ "DescribeThemeAlias": "

Describes the alias for a theme.

", "DescribeThemePermissions": "

Describes the read and write permissions for a theme.

", "DescribeUser": "

Returns information about a user, given the user name.

", - "GenerateEmbedUrlForAnonymousUser": "

Generates an embed URL that you can use to embed an Amazon QuickSight dashboard in your website, without having to register any reader users. Before you use this action, make sure that you have configured the dashboards and permissions.

The following rules apply to the generated URL:

For more information, see Embedded Analytics in the Amazon QuickSight User Guide.

For more information about the high-level steps for embedding and for an interactive demo of the ways you can customize embedding, visit the Amazon QuickSight Developer Portal.

", - "GenerateEmbedUrlForRegisteredUser": "

Generates an embed URL that you can use to embed an Amazon QuickSight experience in your website. This action can be used for any type of user registered in an Amazon QuickSight account. Before you use this action, make sure that you have configured the relevant Amazon QuickSight resource and permissions.

The following rules apply to the generated URL:

For more information, see Embedded Analytics in the Amazon QuickSight User Guide.

For more information about the high-level steps for embedding and for an interactive demo of the ways you can customize embedding, visit the Amazon QuickSight Developer Portal.

", + "GenerateEmbedUrlForAnonymousUser": "

Generates an embed URL that you can use to embed an Amazon QuickSight dashboard in your website, without having to register any reader users. Before you use this action, make sure that you have configured the dashboards and permissions.

The following rules apply to the generated URL:

For more information, see Embedded Analytics in the Amazon QuickSight User Guide.

For more information about the high-level steps for embedding and for an interactive demo of the ways you can customize embedding, visit the Amazon QuickSight Developer Portal.

", + "GenerateEmbedUrlForRegisteredUser": "

Generates an embed URL that you can use to embed an Amazon QuickSight experience in your website. This action can be used for any type of user registered in an Amazon QuickSight account. Before you use this action, make sure that you have configured the relevant Amazon QuickSight resource and permissions.

The following rules apply to the generated URL:

For more information, see Embedded Analytics in the Amazon QuickSight User Guide.

For more information about the high-level steps for embedding and for an interactive demo of the ways you can customize embedding, visit the Amazon QuickSight Developer Portal.

", "GetDashboardEmbedUrl": "

Generates a session URL and authorization code that you can use to embed an Amazon Amazon QuickSight read-only dashboard in your web server code. Before you use this command, make sure that you have configured the dashboards and permissions.

Currently, you can use GetDashboardEmbedURL only from the server, not from the user's browser. The following rules apply to the combination of URL and authorization code:

For more information, see Embedding Analytics Using GetDashboardEmbedUrl in the Amazon QuickSight User Guide.

For more information about the high-level steps for embedding and for an interactive demo of the ways you can customize embedding, visit the Amazon QuickSight Developer Portal.

", "GetSessionEmbedUrl": "

Generates a session URL and authorization code that you can use to embed the Amazon Amazon QuickSight console in your web server code. Use GetSessionEmbedUrl where you want to provide an authoring portal that allows users to create data sources, datasets, analyses, and dashboards. The users who access an embedded Amazon QuickSight console need belong to the author or admin security cohort. If you want to restrict permissions to some of these features, add a custom permissions profile to the user with the UpdateUser API operation. Use RegisterUser API operation to add a new user with a custom permission profile attached. For more information, see the following sections in the Amazon QuickSight User Guide:

", "ListAnalyses": "

Lists Amazon QuickSight analyses that exist in the specified Amazon Web Services account.

", @@ -112,6 +112,7 @@ "UpdateGroup": "

Changes a group description.

", "UpdateIAMPolicyAssignment": "

Updates an existing IAM policy assignment. This operation updates only the optional parameter or parameters that are specified in the request. This overwrites all of the users included in Identities.

", "UpdateIpRestriction": "

Updates the content and status of IP rules. To use this operation, you need to provide the entire map of rules. You can use the DescribeIpRestriction operation to get the current rule map.

", + "UpdatePublicSharingSettings": "

Use the UpdatePublicSharingSettings operation to enable or disable the public sharing settings of an Amazon QuickSight dashboard.

To use this operation, enable session capacity pricing on your Amazon QuickSight account.

Before you can enable public sharing on your account, you need to allow public sharing permissions to an administrative user in the IAM console. For more information on using IAM with Amazon QuickSight, see Using Amazon QuickSight with IAM.

", "UpdateTemplate": "

Updates a template from an existing Amazon QuickSight analysis or another template.

", "UpdateTemplateAlias": "

Updates the template alias of a template.

", "UpdateTemplatePermissions": "

Updates the resource permissions for a template.

", @@ -420,7 +421,7 @@ "ArnList": { "base": null, "refs": { - "GenerateEmbedUrlForAnonymousUserRequest$AuthorizedResourceArns": "

The Amazon Resource Names for the Amazon QuickSight resources that the user is authorized to access during the lifetime of the session. If you choose Dashboard embedding experience, pass the list of dashboard ARNs in the account that you want the user to be able to view.

" + "GenerateEmbedUrlForAnonymousUserRequest$AuthorizedResourceArns": "

The Amazon Resource Names for the Amazon QuickSight resources that the user is authorized to access during the lifetime of the session. If you choose Dashboard embedding experience, pass the list of dashboard ARNs in the account that you want the user to be able to view. Currently, you can pass up to 25 dashboard ARNs in each API call.

" } }, "AssignmentStatus": { @@ -568,6 +569,7 @@ "UpdateIAMPolicyAssignmentRequest$AwsAccountId": "

The ID of the Amazon Web Services account that contains the IAM policy assignment.

", "UpdateIpRestrictionRequest$AwsAccountId": "

The ID of the Amazon Web Services account that contains the IP rules.

", "UpdateIpRestrictionResponse$AwsAccountId": "

The ID of the Amazon Web Services account that contains the IP rules.

", + "UpdatePublicSharingSettingsRequest$AwsAccountId": "

The Amazon Web Services account ID associated with your Amazon QuickSight subscription.

", "UpdateTemplateAliasRequest$AwsAccountId": "

The ID of the Amazon Web Services account that contains the template alias that you're updating.

", "UpdateTemplatePermissionsRequest$AwsAccountId": "

The ID of the Amazon Web Services account that contains the template.

", "UpdateTemplateRequest$AwsAccountId": "

The ID of the Amazon Web Services account that contains the template that you're updating.

", @@ -592,6 +594,7 @@ "Boolean": { "base": null, "refs": { + "AccountSettings$PublicSharingEnabled": "

A boolean that indicates whether or not public sharing is enabled on an Amazon QuickSight account. For more information about enabling public sharing, see UpdatePublicSharingSettings.

", "DataSetSummary$RowLevelPermissionTagConfigurationApplied": "

Whether or not the row level permission tags are applied.

", "DataSetSummary$ColumnLevelPermissionRulesApplied": "

A value that indicates if the dataset has column level permission configured.

", "DataSetUsageConfiguration$DisableUseAsDirectQuerySource": "

An option that controls whether a child dataset of a direct query can use this dataset as a source.

", @@ -601,6 +604,7 @@ "GetDashboardEmbedUrlRequest$StatePersistenceEnabled": "

Adds persistence of state for the user session in an embedded dashboard. Persistence applies to the sheet and the parameter settings. These are control settings that the dashboard subscriber (Amazon QuickSight reader) chooses while viewing the dashboard. If this is set to TRUE, the settings are the same when the subscriber reopens the same dashboard URL. The state is stored in Amazon QuickSight, not in a browser cookie. If this is set to FALSE, the state of the user session is not persisted. The default is FALSE.

", "JoinKeyProperties$UniqueKey": "

A value that indicates that a row in a table is uniquely identified by the columns in a join key. This is used by Amazon QuickSight to optimize query performance.

", "SslProperties$DisableSsl": "

A Boolean option to control whether SSL should be disabled.

", + "UpdatePublicSharingSettingsRequest$PublicSharingEnabled": "

A boolean that indicates whether or not public sharing is enabled on a Amazon QuickSight account.

", "UpdateUserRequest$UnapplyCustomPermissions": "

A flag that you use to indicate that you want to remove all custom permissions from this user. Using this parameter resets the user to the state it was in before a custom permissions profile was applied. This parameter defaults to NULL and it doesn't accept any other value.

", "UploadSettings$ContainsHeader": "

Whether the file has a header row, or the files each have a header row.

", "User$Active": "

The active status of user. When you create an Amazon QuickSight user that’s not an IAM user or an Active Directory user, that user is inactive until they sign in and provide a password.

" @@ -3657,6 +3661,7 @@ "UpdateGroupResponse$Status": "

The HTTP status of the request.

", "UpdateIAMPolicyAssignmentResponse$Status": "

The HTTP status of the request.

", "UpdateIpRestrictionResponse$Status": "

The HTTP status of the request.

", + "UpdatePublicSharingSettingsResponse$Status": "

The HTTP status of the request.

", "UpdateTemplateAliasResponse$Status": "

The HTTP status of the request.

", "UpdateTemplatePermissionsResponse$Status": "

The HTTP status of the request.

", "UpdateTemplateResponse$Status": "

The HTTP status of the request.

", @@ -3908,6 +3913,7 @@ "UpdateIAMPolicyAssignmentResponse$AssignmentId": "

The ID of the assignment.

", "UpdateIAMPolicyAssignmentResponse$RequestId": "

The Amazon Web Services request ID for this operation.

", "UpdateIpRestrictionResponse$RequestId": "

The Amazon Web Services request ID for this operation.

", + "UpdatePublicSharingSettingsResponse$RequestId": "

The Amazon Web Services request ID for this operation.

", "UpdateTemplateAliasResponse$RequestId": "

The Amazon Web Services request ID for this operation.

", "UpdateTemplatePermissionsResponse$RequestId": "

The Amazon Web Services request ID for this operation.

", "UpdateTemplateResponse$RequestId": "

The Amazon Web Services request ID for this operation.

", @@ -4491,6 +4497,16 @@ "UpdateDashboardPermissionsRequest$RevokeLinkPermissions": "

Revokes link permissions from all users in a defined namespace.

" } }, + "UpdatePublicSharingSettingsRequest": { + "base": null, + "refs": { + } + }, + "UpdatePublicSharingSettingsResponse": { + "base": null, + "refs": { + } + }, "UpdateResourcePermissionList": { "base": null, "refs": { diff --git a/apis/transfer/2018-11-05/api-2.json b/apis/transfer/2018-11-05/api-2.json index 4d04791e149..eec219ead93 100644 --- a/apis/transfer/2018-11-05/api-2.json +++ b/apis/transfer/2018-11-05/api-2.json @@ -1479,7 +1479,8 @@ "type":"structure", "members":{ "PassiveIp":{"shape":"PassiveIp"}, - "TlsSessionResumptionMode":{"shape":"TlsSessionResumptionMode"} + "TlsSessionResumptionMode":{"shape":"TlsSessionResumptionMode"}, + "SetStatOption":{"shape":"SetStatOption"} } }, "Protocols":{ @@ -1675,6 +1676,13 @@ "min":3, "pattern":"^[\\w-]*$" }, + "SetStatOption":{ + "type":"string", + "enum":[ + "DEFAULT", + "ENABLE_NO_OP" + ] + }, "SourceFileLocation":{ "type":"string", "max":256, diff --git a/apis/transfer/2018-11-05/docs-2.json b/apis/transfer/2018-11-05/docs-2.json index f485c7908a8..20fe13f97ef 100644 --- a/apis/transfer/2018-11-05/docs-2.json +++ b/apis/transfer/2018-11-05/docs-2.json @@ -471,8 +471,8 @@ "HostKey": { "base": null, "refs": { - "CreateServerRequest$HostKey": "

The RSA or ECDSA private key to use for your server.

Use the following command to generate an RSA 2048 bit key with no passphrase:

ssh-keygen -t rsa -b 2048 -N \"\" -m PEM -f my-new-server-key.

Use a minimum value of 2048 for the -b option: you can create a stronger key using 3072 or 4096.

Use the following command to generate an ECDSA 256 bit key with no passphrase:

ssh-keygen -t ecdsa -b 256 -N \"\" -m PEM -f my-new-server-key.

Valid values for the -b option for ECDSA are 256, 384, and 521.

For both of these commands, you can replace my-new-server-key with a string of your choice.

If you aren't planning to migrate existing users from an existing SFTP-enabled server to a new server, don't update the host key. Accidentally changing a server's host key can be disruptive.

For more information, see Change the host key for your SFTP-enabled server in the Amazon Web Services Transfer Family User Guide.

", - "UpdateServerRequest$HostKey": "

The RSA or ECDSA private key to use for your server.

Use the following command to generate an RSA 2048 bit key with no passphrase:

ssh-keygen -t rsa -b 2048 -N \"\" -m PEM -f my-new-server-key.

Use a minimum value of 2048 for the -b option: you can create a stronger key using 3072 or 4096.

Use the following command to generate an ECDSA 256 bit key with no passphrase:

ssh-keygen -t ecdsa -b 256 -N \"\" -m PEM -f my-new-server-key.

Valid values for the -b option for ECDSA are 256, 384, and 521.

For both of these commands, you can replace my-new-server-key with a string of your choice.

If you aren't planning to migrate existing users from an existing SFTP-enabled server to a new server, don't update the host key. Accidentally changing a server's host key can be disruptive.

For more information, see Change the host key for your SFTP-enabled server in the Amazon Web Services Transfer Family User Guide.

" + "CreateServerRequest$HostKey": "

The RSA private key as generated by the ssh-keygen -N \"\" -m PEM -f my-new-server-key command.

If you aren't planning to migrate existing users from an existing SFTP-enabled server to a new server, don't update the host key. Accidentally changing a server's host key can be disruptive.

For more information, see Change the host key for your SFTP-enabled server in the Amazon Web Services Transfer Family User Guide.

", + "UpdateServerRequest$HostKey": "

The RSA private key as generated by ssh-keygen -N \"\" -m PEM -f my-new-server-key.

If you aren't planning to migrate existing users from an existing server to a new server, don't update the host key. Accidentally changing a server's host key can be disruptive.

For more information, see Change the host key for your SFTP-enabled server in the Amazon Web ServicesTransfer Family User Guide.

" } }, "HostKeyFingerprint": { @@ -806,9 +806,9 @@ "ProtocolDetails": { "base": "

The protocol settings that are configured for your server.

", "refs": { - "CreateServerRequest$ProtocolDetails": "

The protocol settings that are configured for your server.

Use the PassiveIp parameter to indicate passive mode (for FTP and FTPS protocols). Enter a single dotted-quad IPv4 address, such as the external IP address of a firewall, router, or load balancer.

Use the TlsSessionResumptionMode parameter to determine whether or not your Transfer server resumes recent, negotiated sessions through a unique session ID.

", + "CreateServerRequest$ProtocolDetails": "

The protocol settings that are configured for your server.

", "DescribedServer$ProtocolDetails": "

The protocol settings that are configured for your server.

Use the PassiveIp parameter to indicate passive mode. Enter a single dotted-quad IPv4 address, such as the external IP address of a firewall, router, or load balancer.

", - "UpdateServerRequest$ProtocolDetails": "

The protocol settings that are configured for your server.

Use the PassiveIp parameter to indicate passive mode (for FTP and FTPS protocols). Enter a single dotted-quad IPv4 address, such as the external IP address of a firewall, router, or load balancer.

Use the TlsSessionResumptionMode parameter to determine whether or not your Transfer server resumes recent, negotiated sessions through a unique session ID.

" + "UpdateServerRequest$ProtocolDetails": "

The protocol settings that are configured for your server.

" } }, "Protocols": { @@ -1059,6 +1059,12 @@ "UserDetails$SessionId": "

The system-assigned unique identifier for a session that corresponds to the workflow.

" } }, + "SetStatOption": { + "base": null, + "refs": { + "ProtocolDetails$SetStatOption": "

Use the SetStatOption to ignore the error that is generated when the client attempts to use SETSTAT on a file you are uploading to an S3 bucket.

Some SFTP file transfer clients can attempt to change the attributes of remote files, including timestamp and permissions, using commands, such as SETSTAT when uploading the file. However, these commands are not compatible with object storage systems, such as Amazon S3. Due to this incompatibility, file uploads from these clients can result in errors even when the file is otherwise successfully uploaded.

Set the value to ENABLE_NO_OP to have the Transfer Family server ignore the SETSTAT command, and upload files without needing to make any changes to your SFTP client. While the SetStatOption ENABLE_NO_OP setting ignores the error, it does generate a log entry in CloudWatch Logs, so you can determine when the client is making a SETSTAT call.

If you want to preserve the original timestamp for your file, and modify other file attributes using SETSTAT, you can use Amazon EFS as backend storage with Transfer Family.

" + } + }, "SourceFileLocation": { "base": null, "refs": { diff --git a/gems/aws-partitions/CHANGELOG.md b/gems/aws-partitions/CHANGELOG.md index 4e56a569232..10515621626 100644 --- a/gems/aws-partitions/CHANGELOG.md +++ b/gems/aws-partitions/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.588.0 (2022-05-18) +------------------ + +* Feature - Updated the partitions source data the determines the AWS service regions and endpoints. + 1.587.0 (2022-05-09) ------------------ diff --git a/gems/aws-partitions/VERSION b/gems/aws-partitions/VERSION index f3d6fe62feb..31f17667eed 100644 --- a/gems/aws-partitions/VERSION +++ b/gems/aws-partitions/VERSION @@ -1 +1 @@ -1.587.0 +1.588.0 diff --git a/gems/aws-partitions/partitions.json b/gems/aws-partitions/partitions.json index d527ee75463..45076e55c1b 100644 --- a/gems/aws-partitions/partitions.json +++ b/gems/aws-partitions/partitions.json @@ -9756,6 +9756,30 @@ } } }, + "resiliencehub" : { + "endpoints" : { + "af-south-1" : { }, + "ap-east-1" : { }, + "ap-northeast-1" : { }, + "ap-northeast-2" : { }, + "ap-south-1" : { }, + "ap-southeast-1" : { }, + "ap-southeast-2" : { }, + "ca-central-1" : { }, + "eu-central-1" : { }, + "eu-north-1" : { }, + "eu-south-1" : { }, + "eu-west-1" : { }, + "eu-west-2" : { }, + "eu-west-3" : { }, + "me-south-1" : { }, + "sa-east-1" : { }, + "us-east-1" : { }, + "us-east-2" : { }, + "us-west-1" : { }, + "us-west-2" : { } + } + }, "resource-groups" : { "endpoints" : { "af-south-1" : { }, diff --git a/gems/aws-sdk-appmesh/CHANGELOG.md b/gems/aws-sdk-appmesh/CHANGELOG.md index d0fcd78bb44..71c7b5dfae0 100644 --- a/gems/aws-sdk-appmesh/CHANGELOG.md +++ b/gems/aws-sdk-appmesh/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.46.0 (2022-05-18) +------------------ + +* Feature - This release updates the existing Create and Update APIs for meshes and virtual nodes by adding a new IP preference field. This new IP preference field can be used to control the IP versions being used with the mesh and allows for IPv6 support within App Mesh. + 1.45.0 (2022-02-24) ------------------ diff --git a/gems/aws-sdk-appmesh/VERSION b/gems/aws-sdk-appmesh/VERSION index 50aceaa7b71..0a3db35b241 100644 --- a/gems/aws-sdk-appmesh/VERSION +++ b/gems/aws-sdk-appmesh/VERSION @@ -1 +1 @@ -1.45.0 +1.46.0 diff --git a/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh.rb b/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh.rb index 939b5d62fdb..906cbd6a5a6 100644 --- a/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh.rb +++ b/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh.rb @@ -48,6 +48,6 @@ # @!group service module Aws::AppMesh - GEM_VERSION = '1.45.0' + GEM_VERSION = '1.46.0' end diff --git a/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh/client.rb b/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh/client.rb index 64ac34d0e51..e5344748b3a 100644 --- a/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh/client.rb +++ b/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh/client.rb @@ -378,11 +378,11 @@ def initialize(*args) # The name of the service mesh to create the gateway route in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then the account that you specify must share the mesh - # with your account before you can create the resource in the service - # mesh. For more information about mesh sharing, see [Working with - # shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then the account that you specify must + # share the mesh with your account before you can create the resource in + # the service mesh. For more information about mesh sharing, see + # [Working with shared meshes][1]. # # # @@ -709,6 +709,9 @@ def create_gateway_route(params = {}, options = {}) # egress_filter: { # type: "ALLOW_ALL", # required, accepts ALLOW_ALL, DROP_ALL # }, + # service_discovery: { + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY + # }, # }, # tags: [ # { @@ -729,6 +732,7 @@ def create_gateway_route(params = {}, options = {}) # resp.mesh.metadata.uid #=> String # resp.mesh.metadata.version #=> Integer # resp.mesh.spec.egress_filter.type #=> String, one of "ALLOW_ALL", "DROP_ALL" + # resp.mesh.spec.service_discovery.ip_preference #=> String, one of "IPv6_PREFERRED", "IPv4_PREFERRED", "IPv4_ONLY", "IPv6_ONLY" # resp.mesh.status.status #=> String, one of "ACTIVE", "INACTIVE", "DELETED" # # @see http://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/CreateMesh AWS API Documentation @@ -763,11 +767,11 @@ def create_mesh(params = {}, options = {}) # The name of the service mesh to create the route in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then the account that you specify must share the mesh - # with your account before you can create the resource in the service - # mesh. For more information about mesh sharing, see [Working with - # shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then the account that you specify must + # share the mesh with your account before you can create the resource in + # the service mesh. For more information about mesh sharing, see + # [Working with shared meshes][1]. # # # @@ -1150,11 +1154,11 @@ def create_route(params = {}, options = {}) # The name of the service mesh to create the virtual gateway in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then the account that you specify must share the mesh - # with your account before you can create the resource in the service - # mesh. For more information about mesh sharing, see [Working with - # shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then the account that you specify must + # share the mesh with your account before you can create the resource in + # the service mesh. For more information about mesh sharing, see + # [Working with shared meshes][1]. # # # @@ -1385,7 +1389,7 @@ def create_virtual_gateway(params = {}, options = {}) # For more information about virtual nodes, see [Virtual nodes][1]. You # must be using `1.15.0` or later of the Envoy image when setting these # variables. For more information aboutApp Mesh Envoy variables, see - # [Envoy image][2] in the AWS App Mesh User Guide. + # [Envoy image][2] in the App Mesh User Guide. # # # @@ -1404,11 +1408,11 @@ def create_virtual_gateway(params = {}, options = {}) # The name of the service mesh to create the virtual node in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then the account that you specify must share the mesh - # with your account before you can create the resource in the service - # mesh. For more information about mesh sharing, see [Working with - # shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then the account that you specify must + # share the mesh with your account before you can create the resource in + # the service mesh. For more information about mesh sharing, see + # [Working with shared meshes][1]. # # # @@ -1640,11 +1644,13 @@ def create_virtual_gateway(params = {}, options = {}) # value: "AwsCloudMapInstanceAttributeValue", # required # }, # ], + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY # namespace_name: "AwsCloudMapName", # required # service_name: "AwsCloudMapName", # required # }, # dns: { # hostname: "Hostname", # required + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY # response_type: "LOADBALANCER", # accepts LOADBALANCER, ENDPOINTS # }, # }, @@ -1742,9 +1748,11 @@ def create_virtual_gateway(params = {}, options = {}) # resp.virtual_node.spec.service_discovery.aws_cloud_map.attributes #=> Array # resp.virtual_node.spec.service_discovery.aws_cloud_map.attributes[0].key #=> String # resp.virtual_node.spec.service_discovery.aws_cloud_map.attributes[0].value #=> String + # resp.virtual_node.spec.service_discovery.aws_cloud_map.ip_preference #=> String, one of "IPv6_PREFERRED", "IPv4_PREFERRED", "IPv4_ONLY", "IPv6_ONLY" # resp.virtual_node.spec.service_discovery.aws_cloud_map.namespace_name #=> String # resp.virtual_node.spec.service_discovery.aws_cloud_map.service_name #=> String # resp.virtual_node.spec.service_discovery.dns.hostname #=> String + # resp.virtual_node.spec.service_discovery.dns.ip_preference #=> String, one of "IPv6_PREFERRED", "IPv4_PREFERRED", "IPv4_ONLY", "IPv6_ONLY" # resp.virtual_node.spec.service_discovery.dns.response_type #=> String, one of "LOADBALANCER", "ENDPOINTS" # resp.virtual_node.status.status #=> String, one of "ACTIVE", "INACTIVE", "DELETED" # resp.virtual_node.virtual_node_name #=> String @@ -1785,11 +1793,11 @@ def create_virtual_node(params = {}, options = {}) # The name of the service mesh to create the virtual router in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then the account that you specify must share the mesh - # with your account before you can create the resource in the service - # mesh. For more information about mesh sharing, see [Working with - # shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then the account that you specify must + # share the mesh with your account before you can create the resource in + # the service mesh. For more information about mesh sharing, see + # [Working with shared meshes][1]. # # # @@ -1890,11 +1898,11 @@ def create_virtual_router(params = {}, options = {}) # The name of the service mesh to create the virtual service in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then the account that you specify must share the mesh - # with your account before you can create the resource in the service - # mesh. For more information about mesh sharing, see [Working with - # shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then the account that you specify must + # share the mesh with your account before you can create the resource in + # the service mesh. For more information about mesh sharing, see + # [Working with shared meshes][1]. # # # @@ -1975,10 +1983,10 @@ def create_virtual_service(params = {}, options = {}) # The name of the service mesh to delete the gateway route from. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -2114,6 +2122,7 @@ def delete_gateway_route(params = {}, options = {}) # resp.mesh.metadata.uid #=> String # resp.mesh.metadata.version #=> Integer # resp.mesh.spec.egress_filter.type #=> String, one of "ALLOW_ALL", "DROP_ALL" + # resp.mesh.spec.service_discovery.ip_preference #=> String, one of "IPv6_PREFERRED", "IPv4_PREFERRED", "IPv4_ONLY", "IPv6_ONLY" # resp.mesh.status.status #=> String, one of "ACTIVE", "INACTIVE", "DELETED" # # @see http://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DeleteMesh AWS API Documentation @@ -2131,10 +2140,10 @@ def delete_mesh(params = {}, options = {}) # The name of the service mesh to delete the route in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -2284,10 +2293,10 @@ def delete_route(params = {}, options = {}) # The name of the service mesh to delete the virtual gateway from. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -2375,10 +2384,10 @@ def delete_virtual_gateway(params = {}, options = {}) # The name of the service mesh to delete the virtual node in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -2483,9 +2492,11 @@ def delete_virtual_gateway(params = {}, options = {}) # resp.virtual_node.spec.service_discovery.aws_cloud_map.attributes #=> Array # resp.virtual_node.spec.service_discovery.aws_cloud_map.attributes[0].key #=> String # resp.virtual_node.spec.service_discovery.aws_cloud_map.attributes[0].value #=> String + # resp.virtual_node.spec.service_discovery.aws_cloud_map.ip_preference #=> String, one of "IPv6_PREFERRED", "IPv4_PREFERRED", "IPv4_ONLY", "IPv6_ONLY" # resp.virtual_node.spec.service_discovery.aws_cloud_map.namespace_name #=> String # resp.virtual_node.spec.service_discovery.aws_cloud_map.service_name #=> String # resp.virtual_node.spec.service_discovery.dns.hostname #=> String + # resp.virtual_node.spec.service_discovery.dns.ip_preference #=> String, one of "IPv6_PREFERRED", "IPv4_PREFERRED", "IPv4_ONLY", "IPv6_ONLY" # resp.virtual_node.spec.service_discovery.dns.response_type #=> String, one of "LOADBALANCER", "ENDPOINTS" # resp.virtual_node.status.status #=> String, one of "ACTIVE", "INACTIVE", "DELETED" # resp.virtual_node.virtual_node_name #=> String @@ -2508,10 +2519,10 @@ def delete_virtual_node(params = {}, options = {}) # The name of the service mesh to delete the virtual router in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -2563,10 +2574,10 @@ def delete_virtual_router(params = {}, options = {}) # The name of the service mesh to delete the virtual service in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -2620,10 +2631,10 @@ def delete_virtual_service(params = {}, options = {}) # The name of the service mesh that the gateway route resides in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -2736,10 +2747,10 @@ def describe_gateway_route(params = {}, options = {}) # The name of the service mesh to describe. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -2767,6 +2778,7 @@ def describe_gateway_route(params = {}, options = {}) # resp.mesh.metadata.uid #=> String # resp.mesh.metadata.version #=> Integer # resp.mesh.spec.egress_filter.type #=> String, one of "ALLOW_ALL", "DROP_ALL" + # resp.mesh.spec.service_discovery.ip_preference #=> String, one of "IPv6_PREFERRED", "IPv4_PREFERRED", "IPv4_ONLY", "IPv6_ONLY" # resp.mesh.status.status #=> String, one of "ACTIVE", "INACTIVE", "DELETED" # # @see http://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/DescribeMesh AWS API Documentation @@ -2784,10 +2796,10 @@ def describe_mesh(params = {}, options = {}) # The name of the service mesh that the route resides in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -2936,10 +2948,10 @@ def describe_route(params = {}, options = {}) # The name of the service mesh that the gateway route resides in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -3024,10 +3036,10 @@ def describe_virtual_gateway(params = {}, options = {}) # The name of the service mesh that the virtual node resides in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -3132,9 +3144,11 @@ def describe_virtual_gateway(params = {}, options = {}) # resp.virtual_node.spec.service_discovery.aws_cloud_map.attributes #=> Array # resp.virtual_node.spec.service_discovery.aws_cloud_map.attributes[0].key #=> String # resp.virtual_node.spec.service_discovery.aws_cloud_map.attributes[0].value #=> String + # resp.virtual_node.spec.service_discovery.aws_cloud_map.ip_preference #=> String, one of "IPv6_PREFERRED", "IPv4_PREFERRED", "IPv4_ONLY", "IPv6_ONLY" # resp.virtual_node.spec.service_discovery.aws_cloud_map.namespace_name #=> String # resp.virtual_node.spec.service_discovery.aws_cloud_map.service_name #=> String # resp.virtual_node.spec.service_discovery.dns.hostname #=> String + # resp.virtual_node.spec.service_discovery.dns.ip_preference #=> String, one of "IPv6_PREFERRED", "IPv4_PREFERRED", "IPv4_ONLY", "IPv6_ONLY" # resp.virtual_node.spec.service_discovery.dns.response_type #=> String, one of "LOADBALANCER", "ENDPOINTS" # resp.virtual_node.status.status #=> String, one of "ACTIVE", "INACTIVE", "DELETED" # resp.virtual_node.virtual_node_name #=> String @@ -3154,10 +3168,10 @@ def describe_virtual_node(params = {}, options = {}) # The name of the service mesh that the virtual router resides in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -3209,10 +3223,10 @@ def describe_virtual_router(params = {}, options = {}) # The name of the service mesh that the virtual service resides in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -3274,10 +3288,10 @@ def describe_virtual_service(params = {}, options = {}) # The name of the service mesh to list gateway routes in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -3407,10 +3421,10 @@ def list_meshes(params = {}, options = {}) # The name of the service mesh to list routes in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -3534,10 +3548,10 @@ def list_tags_for_resource(params = {}, options = {}) # The name of the service mesh to list virtual gateways in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -3603,10 +3617,10 @@ def list_virtual_gateways(params = {}, options = {}) # The name of the service mesh to list virtual nodes in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -3672,10 +3686,10 @@ def list_virtual_nodes(params = {}, options = {}) # The name of the service mesh to list virtual routers in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -3741,10 +3755,10 @@ def list_virtual_routers(params = {}, options = {}) # The name of the service mesh to list virtual services in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -3874,10 +3888,10 @@ def untag_resource(params = {}, options = {}) # The name of the service mesh that the gateway route resides in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -4172,6 +4186,9 @@ def update_gateway_route(params = {}, options = {}) # egress_filter: { # type: "ALLOW_ALL", # required, accepts ALLOW_ALL, DROP_ALL # }, + # service_discovery: { + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY + # }, # }, # }) # @@ -4186,6 +4203,7 @@ def update_gateway_route(params = {}, options = {}) # resp.mesh.metadata.uid #=> String # resp.mesh.metadata.version #=> Integer # resp.mesh.spec.egress_filter.type #=> String, one of "ALLOW_ALL", "DROP_ALL" + # resp.mesh.spec.service_discovery.ip_preference #=> String, one of "IPv6_PREFERRED", "IPv4_PREFERRED", "IPv4_ONLY", "IPv6_ONLY" # resp.mesh.status.status #=> String, one of "ACTIVE", "INACTIVE", "DELETED" # # @see http://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/UpdateMesh AWS API Documentation @@ -4212,10 +4230,10 @@ def update_mesh(params = {}, options = {}) # The name of the service mesh that the route resides in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -4570,10 +4588,10 @@ def update_route(params = {}, options = {}) # The name of the service mesh that the virtual gateway resides in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -4774,10 +4792,10 @@ def update_virtual_gateway(params = {}, options = {}) # The name of the service mesh that the virtual node resides in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -5003,11 +5021,13 @@ def update_virtual_gateway(params = {}, options = {}) # value: "AwsCloudMapInstanceAttributeValue", # required # }, # ], + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY # namespace_name: "AwsCloudMapName", # required # service_name: "AwsCloudMapName", # required # }, # dns: { # hostname: "Hostname", # required + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY # response_type: "LOADBALANCER", # accepts LOADBALANCER, ENDPOINTS # }, # }, @@ -5099,9 +5119,11 @@ def update_virtual_gateway(params = {}, options = {}) # resp.virtual_node.spec.service_discovery.aws_cloud_map.attributes #=> Array # resp.virtual_node.spec.service_discovery.aws_cloud_map.attributes[0].key #=> String # resp.virtual_node.spec.service_discovery.aws_cloud_map.attributes[0].value #=> String + # resp.virtual_node.spec.service_discovery.aws_cloud_map.ip_preference #=> String, one of "IPv6_PREFERRED", "IPv4_PREFERRED", "IPv4_ONLY", "IPv6_ONLY" # resp.virtual_node.spec.service_discovery.aws_cloud_map.namespace_name #=> String # resp.virtual_node.spec.service_discovery.aws_cloud_map.service_name #=> String # resp.virtual_node.spec.service_discovery.dns.hostname #=> String + # resp.virtual_node.spec.service_discovery.dns.ip_preference #=> String, one of "IPv6_PREFERRED", "IPv4_PREFERRED", "IPv4_ONLY", "IPv6_ONLY" # resp.virtual_node.spec.service_discovery.dns.response_type #=> String, one of "LOADBALANCER", "ENDPOINTS" # resp.virtual_node.status.status #=> String, one of "ACTIVE", "INACTIVE", "DELETED" # resp.virtual_node.virtual_node_name #=> String @@ -5129,10 +5151,10 @@ def update_virtual_node(params = {}, options = {}) # The name of the service mesh that the virtual router resides in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -5207,10 +5229,10 @@ def update_virtual_router(params = {}, options = {}) # The name of the service mesh that the virtual service resides in. # # @option params [String] :mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID is - # not your own, then it's the ID of the account that shared the mesh - # with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account that + # shared the mesh with your account. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -5283,7 +5305,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-appmesh' - context[:gem_version] = '1.45.0' + context[:gem_version] = '1.46.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh/client_api.rb b/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh/client_api.rb index 14aa4bdbda7..2b8fa573453 100644 --- a/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh/client_api.rb +++ b/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh/client_api.rb @@ -148,6 +148,7 @@ module ClientApi HttpScheme = Shapes::StringShape.new(name: 'HttpScheme') HttpTimeout = Shapes::StructureShape.new(name: 'HttpTimeout') InternalServerErrorException = Shapes::StructureShape.new(name: 'InternalServerErrorException') + IpPreference = Shapes::StringShape.new(name: 'IpPreference') LimitExceededException = Shapes::StructureShape.new(name: 'LimitExceededException') ListGatewayRoutesInput = Shapes::StructureShape.new(name: 'ListGatewayRoutesInput') ListGatewayRoutesLimit = Shapes::IntegerShape.new(name: 'ListGatewayRoutesLimit') @@ -193,6 +194,7 @@ module ClientApi MeshData = Shapes::StructureShape.new(name: 'MeshData') MeshList = Shapes::ListShape.new(name: 'MeshList') MeshRef = Shapes::StructureShape.new(name: 'MeshRef') + MeshServiceDiscovery = Shapes::StructureShape.new(name: 'MeshServiceDiscovery') MeshSpec = Shapes::StructureShape.new(name: 'MeshSpec') MeshStatus = Shapes::StructureShape.new(name: 'MeshStatus') MeshStatusCode = Shapes::StringShape.new(name: 'MeshStatusCode') @@ -350,6 +352,7 @@ module ClientApi AwsCloudMapInstanceAttributes.member = Shapes::ShapeRef.new(shape: AwsCloudMapInstanceAttribute) AwsCloudMapServiceDiscovery.add_member(:attributes, Shapes::ShapeRef.new(shape: AwsCloudMapInstanceAttributes, location_name: "attributes")) + AwsCloudMapServiceDiscovery.add_member(:ip_preference, Shapes::ShapeRef.new(shape: IpPreference, location_name: "ipPreference")) AwsCloudMapServiceDiscovery.add_member(:namespace_name, Shapes::ShapeRef.new(shape: AwsCloudMapName, required: true, location_name: "namespaceName")) AwsCloudMapServiceDiscovery.add_member(:service_name, Shapes::ShapeRef.new(shape: AwsCloudMapName, required: true, location_name: "serviceName")) AwsCloudMapServiceDiscovery.struct_class = Types::AwsCloudMapServiceDiscovery @@ -623,6 +626,7 @@ module ClientApi DescribeVirtualServiceOutput[:payload_member] = DescribeVirtualServiceOutput.member(:virtual_service) DnsServiceDiscovery.add_member(:hostname, Shapes::ShapeRef.new(shape: Hostname, required: true, location_name: "hostname")) + DnsServiceDiscovery.add_member(:ip_preference, Shapes::ShapeRef.new(shape: IpPreference, location_name: "ipPreference")) DnsServiceDiscovery.add_member(:response_type, Shapes::ShapeRef.new(shape: DnsResponseType, location_name: "responseType")) DnsServiceDiscovery.struct_class = Types::DnsServiceDiscovery @@ -1039,7 +1043,11 @@ module ClientApi MeshRef.add_member(:version, Shapes::ShapeRef.new(shape: Long, required: true, location_name: "version")) MeshRef.struct_class = Types::MeshRef + MeshServiceDiscovery.add_member(:ip_preference, Shapes::ShapeRef.new(shape: IpPreference, location_name: "ipPreference")) + MeshServiceDiscovery.struct_class = Types::MeshServiceDiscovery + MeshSpec.add_member(:egress_filter, Shapes::ShapeRef.new(shape: EgressFilter, location_name: "egressFilter")) + MeshSpec.add_member(:service_discovery, Shapes::ShapeRef.new(shape: MeshServiceDiscovery, location_name: "serviceDiscovery")) MeshSpec.struct_class = Types::MeshSpec MeshStatus.add_member(:status, Shapes::ShapeRef.new(shape: MeshStatusCode, location_name: "status")) diff --git a/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh/types.rb b/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh/types.rb index 03f35f2a536..b7c94f5f983 100644 --- a/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh/types.rb +++ b/gems/aws-sdk-appmesh/lib/aws-sdk-appmesh/types.rb @@ -37,7 +37,7 @@ class Unknown < AccessLog; end # An object that represents the Cloud Map attribute information for your # virtual node. # - # AWS Cloud Map is not available in the eu-south-1 Region. + # Cloud Map is not available in the eu-south-1 Region. # # # @@ -87,6 +87,7 @@ class AwsCloudMapInstanceAttribute < Struct.new( # value: "AwsCloudMapInstanceAttributeValue", # required # }, # ], + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY # namespace_name: "AwsCloudMapName", # required # service_name: "AwsCloudMapName", # required # } @@ -98,6 +99,10 @@ class AwsCloudMapInstanceAttribute < Struct.new( # specified key/value pairs will be returned. # @return [Array] # + # @!attribute [rw] ip_preference + # The IP version to use to control traffic within the mesh. + # @return [String] + # # @!attribute [rw] namespace_name # The name of the Cloud Map namespace to use. # @return [String] @@ -110,6 +115,7 @@ class AwsCloudMapInstanceAttribute < Struct.new( # class AwsCloudMapServiceDiscovery < Struct.new( :attributes, + :ip_preference, :namespace_name, :service_name) SENSITIVE = [] @@ -567,11 +573,11 @@ class ConflictException < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then the account that you specify must share the - # mesh with your account before you can create the resource in the - # service mesh. For more information about mesh sharing, see [Working - # with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then the account that you specify + # must share the mesh with your account before you can create the + # resource in the service mesh. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -637,6 +643,9 @@ class CreateGatewayRouteOutput < Struct.new( # egress_filter: { # type: "ALLOW_ALL", # required, accepts ALLOW_ALL, DROP_ALL # }, + # service_discovery: { + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY + # }, # }, # tags: [ # { @@ -926,11 +935,11 @@ class CreateMeshOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then the account that you specify must share the - # mesh with your account before you can create the resource in the - # service mesh. For more information about mesh sharing, see [Working - # with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then the account that you specify + # must share the mesh with your account before you can create the + # resource in the service mesh. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -1122,11 +1131,11 @@ class CreateRouteOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then the account that you specify must share the - # mesh with your account before you can create the resource in the - # service mesh. For more information about mesh sharing, see [Working - # with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then the account that you specify + # must share the mesh with your account before you can create the + # resource in the service mesh. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -1389,11 +1398,13 @@ class CreateVirtualGatewayOutput < Struct.new( # value: "AwsCloudMapInstanceAttributeValue", # required # }, # ], + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY # namespace_name: "AwsCloudMapName", # required # service_name: "AwsCloudMapName", # required # }, # dns: { # hostname: "Hostname", # required + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY # response_type: "LOADBALANCER", # accepts LOADBALANCER, ENDPOINTS # }, # }, @@ -1421,11 +1432,11 @@ class CreateVirtualGatewayOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then the account that you specify must share the - # mesh with your account before you can create the resource in the - # service mesh. For more information about mesh sharing, see [Working - # with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then the account that you specify + # must share the mesh with your account before you can create the + # resource in the service mesh. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -1521,11 +1532,11 @@ class CreateVirtualNodeOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then the account that you specify must share the - # mesh with your account before you can create the resource in the - # service mesh. For more information about mesh sharing, see [Working - # with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then the account that you specify + # must share the mesh with your account before you can create the + # resource in the service mesh. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -1622,11 +1633,11 @@ class CreateVirtualRouterOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then the account that you specify must share the - # mesh with your account before you can create the resource in the - # service mesh. For more information about mesh sharing, see [Working - # with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then the account that you specify + # must share the mesh with your account before you can create the + # resource in the service mesh. For more information about mesh + # sharing, see [Working with shared meshes][1]. # # # @@ -1698,10 +1709,10 @@ class CreateVirtualServiceOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -1793,10 +1804,10 @@ class DeleteMeshOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -1852,10 +1863,10 @@ class DeleteRouteOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -1904,10 +1915,10 @@ class DeleteVirtualGatewayOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -1962,10 +1973,10 @@ class DeleteVirtualNodeOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -2020,10 +2031,10 @@ class DeleteVirtualRouterOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -2079,10 +2090,10 @@ class DeleteVirtualServiceOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -2134,10 +2145,10 @@ class DescribeGatewayRouteOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -2188,10 +2199,10 @@ class DescribeMeshOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -2247,10 +2258,10 @@ class DescribeRouteOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -2301,10 +2312,10 @@ class DescribeVirtualGatewayOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -2359,10 +2370,10 @@ class DescribeVirtualNodeOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -2417,10 +2428,10 @@ class DescribeVirtualRouterOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -2465,6 +2476,7 @@ class DescribeVirtualServiceOutput < Struct.new( # # { # hostname: "Hostname", # required + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY # response_type: "LOADBALANCER", # accepts LOADBALANCER, ENDPOINTS # } # @@ -2472,6 +2484,10 @@ class DescribeVirtualServiceOutput < Struct.new( # Specifies the DNS service discovery hostname for the virtual node. # @return [String] # + # @!attribute [rw] ip_preference + # The IP version to use to control traffic within the mesh. + # @return [String] + # # @!attribute [rw] response_type # Specifies the DNS response type for the virtual node. # @return [String] @@ -2480,6 +2496,7 @@ class DescribeVirtualServiceOutput < Struct.new( # class DnsServiceDiscovery < Struct.new( :hostname, + :ip_preference, :response_type) SENSITIVE = [] include Aws::Structure @@ -2555,10 +2572,7 @@ class EgressFilter < Struct.new( # specify a path in the Envoy container's file system to write the # files to disk. # - # The Envoy process must have write permissions to the path that you - # specify here. Otherwise, Envoy fails to bootstrap properly. - # - # + #

The Envoy process must have write permissions to the path that you specify here. Otherwise, Envoy fails to bootstrap properly.

 # @return [String] # # @see http://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/FileAccessLog AWS API Documentation @@ -2696,10 +2710,10 @@ class GatewayRouteHostnameRewrite < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -2707,10 +2721,10 @@ class GatewayRouteHostnameRewrite < Struct.new( # @return [String] # # @!attribute [rw] resource_owner - # The AWS IAM account ID of the resource owner. If the account ID is - # not your own, then it's the ID of the mesh owner or of another - # account that the mesh is shared with. For more information about - # mesh sharing, see [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the resource owner. If the + # account ID is not your own, then it's the ID of the mesh owner or + # of another account that the mesh is shared with. For more + # information about mesh sharing, see [Working with shared meshes][1]. # # # @@ -4512,7 +4526,7 @@ class InternalServerErrorException < Struct.new( end # You have exceeded a service limit for your account. For more - # information, see [Service Limits][1] in the *AWS App Mesh User Guide*. + # information, see [Service Limits][1] in the *App Mesh User Guide*. # # # @@ -4556,10 +4570,10 @@ class LimitExceededException < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -4711,10 +4725,10 @@ class ListMeshesOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -4867,10 +4881,10 @@ class ListTagsForResourceOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -4947,10 +4961,10 @@ class ListVirtualGatewaysOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -5030,10 +5044,10 @@ class ListVirtualNodesOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -5113,10 +5127,10 @@ class ListVirtualRoutersOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -5430,7 +5444,7 @@ class ListenerTls < Struct.new( include Aws::Structure end - # An object that represents an AWS Certicate Manager (ACM) certificate. + # An object that represents an Certificate Manager certificate. # # @note When making an API call, you may pass ListenerTlsAcmCertificate # data as a hash: @@ -5466,8 +5480,8 @@ class ListenerTlsAcmCertificate < Struct.new( # @note ListenerTlsCertificate is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of ListenerTlsCertificate corresponding to the set member. # # @!attribute [rw] acm - # A reference to an object that represents an AWS Certicate Manager - # (ACM) certificate. + # A reference to an object that represents an Certificate Manager + # certificate. # @return [Types::ListenerTlsAcmCertificate] # # @!attribute [rw] file @@ -5742,10 +5756,10 @@ class MeshData < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -5753,10 +5767,10 @@ class MeshData < Struct.new( # @return [String] # # @!attribute [rw] resource_owner - # The AWS IAM account ID of the resource owner. If the account ID is - # not your own, then it's the ID of the mesh owner or of another - # account that the mesh is shared with. For more information about - # mesh sharing, see [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the resource owner. If the + # account ID is not your own, then it's the ID of the mesh owner or + # of another account that the mesh is shared with. For more + # information about mesh sharing, see [Working with shared meshes][1]. # # # @@ -5782,6 +5796,28 @@ class MeshRef < Struct.new( include Aws::Structure end + # An object that represents the service discovery information for a + # service mesh. + # + # @note When making an API call, you may pass MeshServiceDiscovery + # data as a hash: + # + # { + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY + # } + # + # @!attribute [rw] ip_preference + # The IP version to use to control traffic within the mesh. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/MeshServiceDiscovery AWS API Documentation + # + class MeshServiceDiscovery < Struct.new( + :ip_preference) + SENSITIVE = [] + include Aws::Structure + end + # An object that represents the specification of a service mesh. # # @note When making an API call, you may pass MeshSpec @@ -5791,16 +5827,25 @@ class MeshRef < Struct.new( # egress_filter: { # type: "ALLOW_ALL", # required, accepts ALLOW_ALL, DROP_ALL # }, + # service_discovery: { + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY + # }, # } # # @!attribute [rw] egress_filter # The egress filter rules for the service mesh. # @return [Types::EgressFilter] # + # @!attribute [rw] service_discovery + # An object that represents the service discovery information for a + # service mesh. + # @return [Types::MeshServiceDiscovery] + # # @see http://docs.aws.amazon.com/goto/WebAPI/appmesh-2019-01-25/MeshSpec AWS API Documentation # class MeshSpec < Struct.new( - :egress_filter) + :egress_filter, + :service_discovery) SENSITIVE = [] include Aws::Structure end @@ -5960,10 +6005,10 @@ class ResourceInUseException < Struct.new( # @return [Time] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -5971,10 +6016,10 @@ class ResourceInUseException < Struct.new( # @return [String] # # @!attribute [rw] resource_owner - # The AWS IAM account ID of the resource owner. If the account ID is - # not your own, then it's the ID of the mesh owner or of another - # account that the mesh is shared with. For more information about - # mesh sharing, see [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the resource owner. If the + # account ID is not your own, then it's the ID of the mesh owner or + # of another account that the mesh is shared with. For more + # information about mesh sharing, see [Working with shared meshes][1]. # # # @@ -6064,10 +6109,10 @@ class RouteData < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -6075,10 +6120,10 @@ class RouteData < Struct.new( # @return [String] # # @!attribute [rw] resource_owner - # The AWS IAM account ID of the resource owner. If the account ID is - # not your own, then it's the ID of the mesh owner or of another - # account that the mesh is shared with. For more information about - # mesh sharing, see [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the resource owner. If the + # account ID is not your own, then it's the ID of the mesh owner or + # of another account that the mesh is shared with. For more + # information about mesh sharing, see [Working with shared meshes][1]. # # # @@ -7032,10 +7077,10 @@ class UntagResourceOutput < Aws::EmptyStructure; end # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -7091,6 +7136,9 @@ class UpdateGatewayRouteOutput < Struct.new( # egress_filter: { # type: "ALLOW_ALL", # required, accepts ALLOW_ALL, DROP_ALL # }, + # service_discovery: { + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY + # }, # }, # } # @@ -7360,10 +7408,10 @@ class UpdateMeshOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -7539,10 +7587,10 @@ class UpdateRouteOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -7796,11 +7844,13 @@ class UpdateVirtualGatewayOutput < Struct.new( # value: "AwsCloudMapInstanceAttributeValue", # required # }, # ], + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY # namespace_name: "AwsCloudMapName", # required # service_name: "AwsCloudMapName", # required # }, # dns: { # hostname: "Hostname", # required + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY # response_type: "LOADBALANCER", # accepts LOADBALANCER, ENDPOINTS # }, # }, @@ -7822,10 +7872,10 @@ class UpdateVirtualGatewayOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -7907,10 +7957,10 @@ class UpdateVirtualNodeOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -7992,10 +8042,10 @@ class UpdateVirtualRouterOutput < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -8958,10 +9008,10 @@ class VirtualGatewayPortMapping < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -8969,10 +9019,10 @@ class VirtualGatewayPortMapping < Struct.new( # @return [String] # # @!attribute [rw] resource_owner - # The AWS IAM account ID of the resource owner. If the account ID is - # not your own, then it's the ID of the mesh owner or of another - # account that the mesh is shared with. For more information about - # mesh sharing, see [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the resource owner. If the + # account ID is not your own, then it's the ID of the mesh owner or + # of another account that the mesh is shared with. For more + # information about mesh sharing, see [Working with shared meshes][1]. # # # @@ -9487,10 +9537,10 @@ class VirtualNodeHttpConnectionPool < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -9498,10 +9548,10 @@ class VirtualNodeHttpConnectionPool < Struct.new( # @return [String] # # @!attribute [rw] resource_owner - # The AWS IAM account ID of the resource owner. If the account ID is - # not your own, then it's the ID of the mesh owner or of another - # account that the mesh is shared with. For more information about - # mesh sharing, see [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the resource owner. If the + # account ID is not your own, then it's the ID of the mesh owner or + # of another account that the mesh is shared with. For more + # information about mesh sharing, see [Working with shared meshes][1]. # # # @@ -9761,11 +9811,13 @@ class VirtualNodeServiceProvider < Struct.new( # value: "AwsCloudMapInstanceAttributeValue", # required # }, # ], + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY # namespace_name: "AwsCloudMapName", # required # service_name: "AwsCloudMapName", # required # }, # dns: { # hostname: "Hostname", # required + # ip_preference: "IPv6_PREFERRED", # accepts IPv6_PREFERRED, IPv4_PREFERRED, IPv4_ONLY, IPv6_ONLY # response_type: "LOADBALANCER", # accepts LOADBALANCER, ENDPOINTS # }, # }, @@ -9926,10 +9978,10 @@ class VirtualRouterListener < Struct.new( # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -9937,10 +9989,10 @@ class VirtualRouterListener < Struct.new( # @return [String] # # @!attribute [rw] resource_owner - # The AWS IAM account ID of the resource owner. If the account ID is - # not your own, then it's the ID of the mesh owner or of another - # account that the mesh is shared with. For more information about - # mesh sharing, see [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the resource owner. If the + # account ID is not your own, then it's the ID of the mesh owner or + # of another account that the mesh is shared with. For more + # information about mesh sharing, see [Working with shared meshes][1]. # # # @@ -10183,10 +10235,10 @@ class Unknown < VirtualServiceProvider; end # @return [String] # # @!attribute [rw] mesh_owner - # The AWS IAM account ID of the service mesh owner. If the account ID - # is not your own, then it's the ID of the account that shared the - # mesh with your account. For more information about mesh sharing, see - # [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the service mesh owner. If + # the account ID is not your own, then it's the ID of the account + # that shared the mesh with your account. For more information about + # mesh sharing, see [Working with shared meshes][1]. # # # @@ -10194,10 +10246,10 @@ class Unknown < VirtualServiceProvider; end # @return [String] # # @!attribute [rw] resource_owner - # The AWS IAM account ID of the resource owner. If the account ID is - # not your own, then it's the ID of the mesh owner or of another - # account that the mesh is shared with. For more information about - # mesh sharing, see [Working with shared meshes][1]. + # The Amazon Web Services IAM account ID of the resource owner. If the + # account ID is not your own, then it's the ID of the mesh owner or + # of another account that the mesh is shared with. For more + # information about mesh sharing, see [Working with shared meshes][1]. # # # diff --git a/gems/aws-sdk-batch/CHANGELOG.md b/gems/aws-sdk-batch/CHANGELOG.md index 45a635568d4..18f8243db09 100644 --- a/gems/aws-sdk-batch/CHANGELOG.md +++ b/gems/aws-sdk-batch/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.62.0 (2022-05-18) +------------------ + +* Feature - Documentation updates for AWS Batch. + 1.61.0 (2022-04-14) ------------------ diff --git a/gems/aws-sdk-batch/VERSION b/gems/aws-sdk-batch/VERSION index 91951fd8ad7..76d05362056 100644 --- a/gems/aws-sdk-batch/VERSION +++ b/gems/aws-sdk-batch/VERSION @@ -1 +1 @@ -1.61.0 +1.62.0 diff --git a/gems/aws-sdk-batch/lib/aws-sdk-batch.rb b/gems/aws-sdk-batch/lib/aws-sdk-batch.rb index 1b9e4ec5981..7787f552bbb 100644 --- a/gems/aws-sdk-batch/lib/aws-sdk-batch.rb +++ b/gems/aws-sdk-batch/lib/aws-sdk-batch.rb @@ -48,6 +48,6 @@ # @!group service module Aws::Batch - GEM_VERSION = '1.61.0' + GEM_VERSION = '1.62.0' end diff --git a/gems/aws-sdk-batch/lib/aws-sdk-batch/client.rb b/gems/aws-sdk-batch/lib/aws-sdk-batch/client.rb index c4eccc70ec5..ecf2cedfbfb 100644 --- a/gems/aws-sdk-batch/lib/aws-sdk-batch/client.rb +++ b/gems/aws-sdk-batch/lib/aws-sdk-batch/client.rb @@ -429,13 +429,15 @@ def cancel_job(params = {}, options = {}) # [Launching an Amazon ECS container instance][3] in the *Amazon Elastic # Container Service Developer Guide*. # - # Batch doesn't upgrade the AMIs in a compute environment after the - # environment is created. For example, it doesn't update the AMIs when - # a newer version of the Amazon ECS optimized AMI is available. - # Therefore, you're responsible for managing the guest operating system - # (including its updates and security patches) and any additional - # application software or utilities that you install on the compute - # resources. To use a new AMI for your Batch jobs, complete these steps: + # Batch doesn't automatically upgrade the AMIs in a compute environment + # after it's created. For example, it also doesn't update the AMIs in + # your compute environment when a newer version of the Amazon ECS + # optimized AMI is available. You're responsible for the management of + # the guest operating system. This includes any updates and security + # patches. You're also responsible for any additional application + # software or utilities that you install on the compute resources. There + # are two ways to use a new AMI for your Batch jobs. The original method + # is to complete these steps: # # 1. Create a new compute environment with the new AMI. # @@ -445,6 +447,43 @@ def cancel_job(params = {}, options = {}) # # 4. Delete the earlier compute environment. # + # In April 2022, Batch added enhanced support for updating compute + # environments. For more information, see [Updating compute + # environments][4]. To use the enhanced updating of compute environments + # to update AMIs, follow these rules: + # + # * Either do not set the service role (`serviceRole`) parameter or set + # it to the **AWSBatchServiceRole** service-linked role. + # + # * Set the allocation strategy (`allocationStrategy`) parameter to + # `BEST_FIT_PROGRESSIVE` or `SPOT_CAPACITY_OPTIMIZED`. + # + # * Set the update to latest image version + # (`updateToLatestImageVersion`) parameter to `true`. + # + # * Do not specify an AMI ID in `imageId`, `imageIdOverride` (in [ + # `ec2Configuration` ][5]), or in the launch template + # (`launchTemplate`). In that case Batch will select the latest Amazon + # ECS optimized AMI supported by Batch at the time the infrastructure + # update is initiated. Alternatively you can specify the AMI ID in the + # `imageId` or `imageIdOverride` parameters, or the launch template + # identified by the `LaunchTemplate` properties. Changing any of these + # properties will trigger an infrastructure update. If the AMI ID is + # specified in the launch template, it can not be replaced by + # specifying an AMI ID in either the `imageId` or `imageIdOverride` + # parameters. It can only be replaced by specifying a different launch + # template, or if the launch template version is set to `$Default` or + # `$Latest`, by setting either a new default version for the launch + # template (if `$Default`)or by adding a new version to the launch + # template (if `$Latest`). + # + # If these rules are followed, any update that triggers an + # infrastructure update will cause the AMI ID to be re-selected. If the + # `version` setting in the launch template (`launchTemplate`) is set to + # `$Latest` or `$Default`, the latest or default version of the launch + # template will be evaluated up at the time of the infrastructure + # update, even if the `launchTemplate` was not updated. + # # # # @@ -452,6 +491,8 @@ def cancel_job(params = {}, options = {}) # [1]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-launch-templates.html # [2]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/container_instance_AMIs.html # [3]: https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_container_instance.html + # [4]: https://docs.aws.amazon.com/batch/latest/userguide/updating-compute-environments.html + # [5]: https://docs.aws.amazon.com/batch/latest/APIReference/API_Ec2Configuration.html # # @option params [required, String] :compute_environment_name # The name for your compute environment. It can be up to 128 letters @@ -2647,7 +2688,10 @@ def register_job_definition(params = {}, options = {}) # name or the Amazon Resource Name (ARN) of the queue. # # @option params [String] :share_identifier - # The share identifier for the job. + # The share identifier for the job. If the job queue does not have a + # scheduling policy, then this parameter must not be specified. If the + # job queue has a scheduling policy, then this parameter must be + # specified. # # @option params [Integer] :scheduling_priority_override # The scheduling priority for the job. This will only affect jobs in job @@ -3325,7 +3369,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-batch' - context[:gem_version] = '1.61.0' + context[:gem_version] = '1.62.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-batch/lib/aws-sdk-batch/types.rb b/gems/aws-sdk-batch/lib/aws-sdk-batch/types.rb index 3120bb747cb..a8cdf04204b 100644 --- a/gems/aws-sdk-batch/lib/aws-sdk-batch/types.rb +++ b/gems/aws-sdk-batch/lib/aws-sdk-batch/types.rb @@ -627,16 +627,20 @@ class ComputeEnvironmentOrder < Struct.new( # "String1": "String2", where String1 is the tag key and String2 # is the tag value−for example, `\{ "Name": "Batch Instance - # C4OnDemand" \}`. This is helpful for recognizing your Batch - # instances in the Amazon EC2 console. These tags can't be updated or - # removed after the compute environment is created. Any changes to - # these tags require that you create a new compute environment and - # remove the old compute environment. These tags aren't seen when - # using the Batch `ListTagsForResource` API operation. + # instances in the Amazon EC2 console. Updating these tags requires an + # infrastructure update to the compute environment. For more + # information, see [Updating compute environments][1] in the *Batch + # User Guide*. These tags aren't seen when using the Batch + # `ListTagsForResource` API operation. # # This parameter isn't applicable to jobs that are running on Fargate # resources, and shouldn't be specified. # # + # + # + # + # [1]: https://docs.aws.amazon.com/batch/latest/userguide/updating-compute-environments.html # @return [Hash] # # @!attribute [rw] placement_group @@ -5879,7 +5883,10 @@ class ShareAttributes < Struct.new( # @return [String] # # @!attribute [rw] share_identifier - # The share identifier for the job. + # The share identifier for the job. If the job queue does not have a + # scheduling policy, then this parameter must not be specified. If the + # job queue has a scheduling policy, then this parameter must be + # specified. # @return [String] # # @!attribute [rw] scheduling_priority_override diff --git a/gems/aws-sdk-greengrassv2/CHANGELOG.md b/gems/aws-sdk-greengrassv2/CHANGELOG.md index f646e77d3a6..4254669b178 100644 --- a/gems/aws-sdk-greengrassv2/CHANGELOG.md +++ b/gems/aws-sdk-greengrassv2/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.18.0 (2022-05-18) +------------------ + +* Feature - This release adds the new DeleteDeployment API operation that you can use to delete deployment resources. This release also adds support for discontinued AWS-provided components, so AWS can communicate when a component has any issues that you should consider before you deploy it. + 1.17.0 (2022-03-03) ------------------ diff --git a/gems/aws-sdk-greengrassv2/VERSION b/gems/aws-sdk-greengrassv2/VERSION index 092afa15df4..84cc529467b 100644 --- a/gems/aws-sdk-greengrassv2/VERSION +++ b/gems/aws-sdk-greengrassv2/VERSION @@ -1 +1 @@ -1.17.0 +1.18.0 diff --git a/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2.rb b/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2.rb index 7bba556f2ee..41b2c710304 100644 --- a/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2.rb +++ b/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2.rb @@ -48,6 +48,6 @@ # @!group service module Aws::GreengrassV2 - GEM_VERSION = '1.17.0' + GEM_VERSION = '1.18.0' end diff --git a/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2/client.rb b/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2/client.rb index ced64babbba..56af7135f92 100644 --- a/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2/client.rb +++ b/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2/client.rb @@ -559,12 +559,18 @@ def cancel_deployment(params = {}, options = {}) # # * Python 3.8 – `python3.8` # + # * Python 3.9 – `python3.9` + # # * Java 8 – `java8` # + # * Java 11 – `java11` + # # * Node.js 10 – `nodejs10.x` # # * Node.js 12 – `nodejs12.x` # + # * Node.js 14 – `nodejs14.x` + # # To create a component from a Lambda function, specify # `lambdaFunction` when you call this operation. # @@ -699,6 +705,8 @@ def cancel_deployment(params = {}, options = {}) # resp.status.message #=> String # resp.status.errors #=> Hash # resp.status.errors["NonEmptyString"] #=> String + # resp.status.vendor_guidance #=> String, one of "ACTIVE", "DISCONTINUED", "DELETED" + # resp.status.vendor_guidance_message #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/CreateComponentVersion AWS API Documentation # @@ -925,6 +933,38 @@ def delete_core_device(params = {}, options = {}) req.send_request(options) end + # Deletes a deployment. To delete an active deployment, you must first + # cancel it. For more information, see [CancelDeployment][1]. + # + # Deleting a deployment doesn't affect core devices that run that + # deployment, because core devices store the deployment's configuration + # on the device. Additionally, core devices can roll back to a previous + # deployment that has been deleted. + # + # + # + # [1]: https://docs.aws.amazon.com/iot/latest/apireference/API_CancelDeployment.html + # + # @option params [required, String] :deployment_id + # The ID of the deployment. + # + # @return [Struct] Returns an empty {Seahorse::Client::Response response}. + # + # @example Request syntax with placeholder values + # + # resp = client.delete_deployment({ + # deployment_id: "NonEmptyString", # required + # }) + # + # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/DeleteDeployment AWS API Documentation + # + # @overload delete_deployment(params = {}) + # @param [Hash] params ({}) + def delete_deployment(params = {}, options = {}) + req = build_request(:delete_deployment, params) + req.send_request(options) + end + # Retrieves metadata for a version of a component. # # @option params [required, String] :arn @@ -964,6 +1004,8 @@ def delete_core_device(params = {}, options = {}) # resp.status.message #=> String # resp.status.errors #=> Hash # resp.status.errors["NonEmptyString"] #=> String + # resp.status.vendor_guidance #=> String, one of "ACTIVE", "DISCONTINUED", "DELETED" + # resp.status.vendor_guidance_message #=> String # resp.platforms #=> Array # resp.platforms[0].name #=> String # resp.platforms[0].attributes #=> Hash @@ -1051,13 +1093,13 @@ def get_component(params = {}, options = {}) req.send_request(options) end - # Gets the pre-signed URL to download a public component artifact. Core - # devices call this operation to identify the URL that they can use to - # download an artifact to install. + # Gets the pre-signed URL to download a public or a Lambda component + # artifact. Core devices call this operation to identify the URL that + # they can use to download an artifact to install. # # @option params [required, String] :arn - # The [ARN][1] of the component version. Specify the ARN of a public - # component version. + # The [ARN][1] of the component version. Specify the ARN of a public or + # a Lambda component version. # # # @@ -1149,6 +1191,31 @@ def get_connectivity_info(params = {}, options = {}) # Retrieves metadata for a Greengrass core device. # + # IoT Greengrass relies on individual devices to send status updates to + # the Amazon Web Services Cloud. If the IoT Greengrass Core software + # isn't running on the device, or if device isn't connected to the + # Amazon Web Services Cloud, then the reported status of that device + # might not reflect its current status. The status timestamp indicates + # when the device status was last updated. + # + # Core devices send status updates at the following times: + # + # * When the IoT Greengrass Core software starts + # + # * When the core device receives a deployment from the Amazon Web + # Services Cloud + # + # * When the status of any component on the core device becomes `BROKEN` + # + # * At a [regular interval that you can configure][1], which defaults to + # 24 hours + # + # + # + # + # + # [1]: https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration-fss + # # @option params [required, String] :core_device_thing_name # The name of the core device. This is also the name of the IoT thing. # @@ -1340,7 +1407,7 @@ def list_client_devices_associated_with_core_device(params = {}, options = {}) # versions are listed first. # # @option params [required, String] :arn - # The [ARN][1] of the component version. + # The [ARN][1] of the component. # # # @@ -1440,10 +1507,37 @@ def list_components(params = {}, options = {}) # Retrieves a paginated list of Greengrass core devices. # + # IoT Greengrass relies on individual devices to send status updates to + # the Amazon Web Services Cloud. If the IoT Greengrass Core software + # isn't running on the device, or if device isn't connected to the + # Amazon Web Services Cloud, then the reported status of that device + # might not reflect its current status. The status timestamp indicates + # when the device status was last updated. + # + # Core devices send status updates at the following times: + # + # * When the IoT Greengrass Core software starts + # + # * When the core device receives a deployment from the Amazon Web + # Services Cloud + # + # * When the status of any component on the core device becomes `BROKEN` + # + # * At a [regular interval that you can configure][1], which defaults to + # 24 hours + # + # + # + # + # + # [1]: https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration-fss + # # @option params [String] :thing_group_arn # The [ARN][1] of the IoT thing group by which to filter. If you specify - # this parameter, the list includes only core devices that are members - # of this thing group. + # this parameter, the list includes only core devices that have + # successfully deployed a deployment that targets the thing group. When + # you remove a core device from a thing group, the list continues to + # include that core device. # # # @@ -1614,7 +1708,34 @@ def list_effective_deployments(params = {}, options = {}) end # Retrieves a paginated list of the components that a Greengrass core - # device runs. + # device runs. This list doesn't include components that are deployed + # from local deployments or components that are deployed as dependencies + # of other components. + # + # IoT Greengrass relies on individual devices to send status updates to + # the Amazon Web Services Cloud. If the IoT Greengrass Core software + # isn't running on the device, or if device isn't connected to the + # Amazon Web Services Cloud, then the reported status of that device + # might not reflect its current status. The status timestamp indicates + # when the device status was last updated. + # + # Core devices send status updates at the following times: + # + # * When the IoT Greengrass Core software starts + # + # * When the core device receives a deployment from the Amazon Web + # Services Cloud + # + # * When the status of any component on the core device becomes `BROKEN` + # + # * At a [regular interval that you can configure][1], which defaults to + # 24 hours + # + # + # + # + # + # [1]: https://docs.aws.amazon.com/greengrass/v2/developerguide/greengrass-nucleus-component.html#greengrass-nucleus-component-configuration-fss # # @option params [required, String] :core_device_thing_name # The name of the core device. This is also the name of the IoT thing. @@ -1717,10 +1838,10 @@ def list_tags_for_resource(params = {}, options = {}) # # [1]: https://docs.aws.amazon.com/general/latest/gr/greengrass.html # - # @option params [required, Types::ComponentPlatform] :platform + # @option params [Types::ComponentPlatform] :platform # The platform to use to resolve compatible components. # - # @option params [required, Array] :component_candidates + # @option params [Array] :component_candidates # The list of components to resolve. # # @return [Types::ResolveComponentCandidatesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: @@ -1730,13 +1851,13 @@ def list_tags_for_resource(params = {}, options = {}) # @example Request syntax with placeholder values # # resp = client.resolve_component_candidates({ - # platform: { # required + # platform: { # name: "NonEmptyString", # attributes: { # "NonEmptyString" => "NonEmptyString", # }, # }, - # component_candidates: [ # required + # component_candidates: [ # { # component_name: "ComponentNameString", # component_version: "ComponentVersionString", @@ -1754,6 +1875,8 @@ def list_tags_for_resource(params = {}, options = {}) # resp.resolved_component_versions[0].component_name #=> String # resp.resolved_component_versions[0].component_version #=> String # resp.resolved_component_versions[0].recipe #=> String + # resp.resolved_component_versions[0].vendor_guidance #=> String, one of "ACTIVE", "DISCONTINUED", "DELETED" + # resp.resolved_component_versions[0].message #=> String # # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/ResolveComponentCandidates AWS API Documentation # @@ -1900,7 +2023,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-greengrassv2' - context[:gem_version] = '1.17.0' + context[:gem_version] = '1.18.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2/client_api.rb b/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2/client_api.rb index a170f9f1fba..ecc1705f1c3 100644 --- a/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2/client_api.rb +++ b/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2/client_api.rb @@ -72,6 +72,7 @@ module ClientApi DefaultMaxResults = Shapes::IntegerShape.new(name: 'DefaultMaxResults') DeleteComponentRequest = Shapes::StructureShape.new(name: 'DeleteComponentRequest') DeleteCoreDeviceRequest = Shapes::StructureShape.new(name: 'DeleteCoreDeviceRequest') + DeleteDeploymentRequest = Shapes::StructureShape.new(name: 'DeleteDeploymentRequest') Deployment = Shapes::StructureShape.new(name: 'Deployment') DeploymentComponentUpdatePolicy = Shapes::StructureShape.new(name: 'DeploymentComponentUpdatePolicy') DeploymentComponentUpdatePolicyAction = Shapes::StringShape.new(name: 'DeploymentComponentUpdatePolicyAction') @@ -214,6 +215,7 @@ module ClientApi ValidationExceptionField = Shapes::StructureShape.new(name: 'ValidationExceptionField') ValidationExceptionFieldList = Shapes::ListShape.new(name: 'ValidationExceptionFieldList') ValidationExceptionReason = Shapes::StringShape.new(name: 'ValidationExceptionReason') + VendorGuidance = Shapes::StringShape.new(name: 'VendorGuidance') connectivityInfoList = Shapes::ListShape.new(name: 'connectivityInfoList') AccessDeniedException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message")) @@ -266,6 +268,8 @@ module ClientApi CloudComponentStatus.add_member(:component_state, Shapes::ShapeRef.new(shape: CloudComponentState, location_name: "componentState")) CloudComponentStatus.add_member(:message, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "message")) CloudComponentStatus.add_member(:errors, Shapes::ShapeRef.new(shape: StringMap, location_name: "errors")) + CloudComponentStatus.add_member(:vendor_guidance, Shapes::ShapeRef.new(shape: VendorGuidance, location_name: "vendorGuidance")) + CloudComponentStatus.add_member(:vendor_guidance_message, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "vendorGuidanceMessage")) CloudComponentStatus.struct_class = Types::CloudComponentStatus Component.add_member(:arn, Shapes::ShapeRef.new(shape: ComponentARN, location_name: "arn")) @@ -383,6 +387,9 @@ module ClientApi DeleteCoreDeviceRequest.add_member(:core_device_thing_name, Shapes::ShapeRef.new(shape: CoreDeviceThingName, required: true, location: "uri", location_name: "coreDeviceThingName")) DeleteCoreDeviceRequest.struct_class = Types::DeleteCoreDeviceRequest + DeleteDeploymentRequest.add_member(:deployment_id, Shapes::ShapeRef.new(shape: NonEmptyString, required: true, location: "uri", location_name: "deploymentId")) + DeleteDeploymentRequest.struct_class = Types::DeleteDeploymentRequest + Deployment.add_member(:target_arn, Shapes::ShapeRef.new(shape: TargetARN, location_name: "targetArn")) Deployment.add_member(:revision_id, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "revisionId")) Deployment.add_member(:deployment_id, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "deploymentId")) @@ -689,8 +696,8 @@ module ClientApi RequestAlreadyInProgressException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "message")) RequestAlreadyInProgressException.struct_class = Types::RequestAlreadyInProgressException - ResolveComponentCandidatesRequest.add_member(:platform, Shapes::ShapeRef.new(shape: ComponentPlatform, required: true, location_name: "platform")) - ResolveComponentCandidatesRequest.add_member(:component_candidates, Shapes::ShapeRef.new(shape: ComponentCandidateList, required: true, location_name: "componentCandidates")) + ResolveComponentCandidatesRequest.add_member(:platform, Shapes::ShapeRef.new(shape: ComponentPlatform, location_name: "platform")) + ResolveComponentCandidatesRequest.add_member(:component_candidates, Shapes::ShapeRef.new(shape: ComponentCandidateList, location_name: "componentCandidates")) ResolveComponentCandidatesRequest.struct_class = Types::ResolveComponentCandidatesRequest ResolveComponentCandidatesResponse.add_member(:resolved_component_versions, Shapes::ShapeRef.new(shape: ResolvedComponentVersionsList, location_name: "resolvedComponentVersions")) @@ -700,6 +707,8 @@ module ClientApi ResolvedComponentVersion.add_member(:component_name, Shapes::ShapeRef.new(shape: ComponentNameString, location_name: "componentName")) ResolvedComponentVersion.add_member(:component_version, Shapes::ShapeRef.new(shape: ComponentVersionString, location_name: "componentVersion")) ResolvedComponentVersion.add_member(:recipe, Shapes::ShapeRef.new(shape: RecipeBlob, location_name: "recipe")) + ResolvedComponentVersion.add_member(:vendor_guidance, Shapes::ShapeRef.new(shape: VendorGuidance, location_name: "vendorGuidance")) + ResolvedComponentVersion.add_member(:message, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "message")) ResolvedComponentVersion.struct_class = Types::ResolvedComponentVersion ResolvedComponentVersionsList.member = Shapes::ShapeRef.new(shape: ResolvedComponentVersion) @@ -860,6 +869,7 @@ module ClientApi o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) o.errors << Shapes::ShapeRef.new(shape: RequestAlreadyInProgressException) end) @@ -891,6 +901,20 @@ module ClientApi o.errors << Shapes::ShapeRef.new(shape: ConflictException) end) + api.add_operation(:delete_deployment, Seahorse::Model::Operation.new.tap do |o| + o.name = "DeleteDeployment" + o.http_method = "DELETE" + o.http_request_uri = "/greengrass/v2/deployments/{deploymentId}" + o.input = Shapes::ShapeRef.new(shape: DeleteDeploymentRequest) + o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure)) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + o.errors << Shapes::ShapeRef.new(shape: ValidationException) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: InternalServerException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + end) + api.add_operation(:describe_component, Seahorse::Model::Operation.new.tap do |o| o.name = "DescribeComponent" o.http_method = "GET" @@ -1030,6 +1054,7 @@ module ClientApi o.output = Shapes::ShapeRef.new(shape: ListComponentsResponse) o.errors << Shapes::ShapeRef.new(shape: ValidationException) o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) o.errors << Shapes::ShapeRef.new(shape: InternalServerException) o[:pager] = Aws::Pager.new( @@ -1134,9 +1159,9 @@ module ClientApi o.errors << Shapes::ShapeRef.new(shape: ValidationException) o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + o.errors << Shapes::ShapeRef.new(shape: ConflictException) o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) o.errors << Shapes::ShapeRef.new(shape: InternalServerException) - o.errors << Shapes::ShapeRef.new(shape: ConflictException) end) api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o| diff --git a/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2/types.rb b/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2/types.rb index 5fdbf59152a..fa041a750e0 100644 --- a/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2/types.rb +++ b/gems/aws-sdk-greengrassv2/lib/aws-sdk-greengrassv2/types.rb @@ -255,30 +255,59 @@ class CancelDeploymentResponse < Struct.new( include Aws::Structure end - # Contains the status of a component in the IoT Greengrass service. + # Contains the status of a component version in the IoT Greengrass + # service. # # @!attribute [rw] component_state - # The state of the component. + # The state of the component version. # @return [String] # # @!attribute [rw] message # A message that communicates details, such as errors, about the - # status of the component. + # status of the component version. # @return [String] # # @!attribute [rw] errors - # A dictionary of errors that communicate why the component is in an - # error state. For example, if IoT Greengrass can't access an - # artifact for the component, then `errors` contains the artifact's - # URI as a key, and the error message as the value for that key. + # A dictionary of errors that communicate why the component version is + # in an error state. For example, if IoT Greengrass can't access an + # artifact for the component version, then `errors` contains the + # artifact's URI as a key, and the error message as the value for + # that key. # @return [Hash] # + # @!attribute [rw] vendor_guidance + # The vendor guidance state for the component version. This state + # indicates whether the component version has any issues that you + # should consider before you deploy it. The vendor guidance state can + # be: + # + # * `ACTIVE` – This component version is available and recommended for + # use. + # + # * `DISCONTINUED` – This component version has been discontinued by + # its publisher. You can deploy this component version, but we + # recommend that you use a different version of this component. + # + # * `DELETED` – This component version has been deleted by its + # publisher, so you can't deploy it. If you have any existing + # deployments that specify this component version, those deployments + # will fail. + # @return [String] + # + # @!attribute [rw] vendor_guidance_message + # A message that communicates details about the vendor guidance state + # of the component version. This message communicates why a component + # version is discontinued or deleted. + # @return [String] + # # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/CloudComponentStatus AWS API Documentation # class CloudComponentStatus < Struct.new( :component_state, :message, - :errors) + :errors, + :vendor_guidance, + :vendor_guidance_message) SENSITIVE = [] include Aws::Structure end @@ -1173,6 +1202,25 @@ class DeleteCoreDeviceRequest < Struct.new( include Aws::Structure end + # @note When making an API call, you may pass DeleteDeploymentRequest + # data as a hash: + # + # { + # deployment_id: "NonEmptyString", # required + # } + # + # @!attribute [rw] deployment_id + # The ID of the deployment. + # @return [String] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/DeleteDeploymentRequest AWS API Documentation + # + class DeleteDeploymentRequest < Struct.new( + :deployment_id) + SENSITIVE = [] + include Aws::Structure + end + # Contains information about a deployment. # # @!attribute [rw] target_arn @@ -1727,7 +1775,7 @@ class GetComponentResponse < Struct.new( # # @!attribute [rw] arn # The [ARN][1] of the component version. Specify the ARN of a public - # component version. + # or a Lambda component version. # # # @@ -2845,7 +2893,7 @@ class ListClientDevicesAssociatedWithCoreDeviceResponse < Struct.new( # } # # @!attribute [rw] arn - # The [ARN][1] of the component version. + # The [ARN][1] of the component. # # # @@ -2951,8 +2999,10 @@ class ListComponentsResponse < Struct.new( # # @!attribute [rw] thing_group_arn # The [ARN][1] of the IoT thing group by which to filter. If you - # specify this parameter, the list includes only core devices that are - # members of this thing group. + # specify this parameter, the list includes only core devices that + # have successfully deployed a deployment that targets the thing + # group. When you remove a core device from a thing group, the list + # continues to include that core device. # # # @@ -3233,13 +3283,13 @@ class RequestAlreadyInProgressException < Struct.new( # data as a hash: # # { - # platform: { # required + # platform: { # name: "NonEmptyString", # attributes: { # "NonEmptyString" => "NonEmptyString", # }, # }, - # component_candidates: [ # required + # component_candidates: [ # { # component_name: "ComponentNameString", # component_version: "ComponentVersionString", @@ -3304,13 +3354,40 @@ class ResolveComponentCandidatesResponse < Struct.new( # The recipe of the component version. # @return [String] # + # @!attribute [rw] vendor_guidance + # The vendor guidance state for the component version. This state + # indicates whether the component version has any issues that you + # should consider before you deploy it. The vendor guidance state can + # be: + # + # * `ACTIVE` – This component version is available and recommended for + # use. + # + # * `DISCONTINUED` – This component version has been discontinued by + # its publisher. You can deploy this component version, but we + # recommend that you use a different version of this component. + # + # * `DELETED` – This component version has been deleted by its + # publisher, so you can't deploy it. If you have any existing + # deployments that specify this component version, those deployments + # will fail. + # @return [String] + # + # @!attribute [rw] message + # A message that communicates details about the vendor guidance state + # of the component version. This message communicates why a component + # version is discontinued or deleted. + # @return [String] + # # @see http://docs.aws.amazon.com/goto/WebAPI/greengrassv2-2020-11-30/ResolvedComponentVersion AWS API Documentation # class ResolvedComponentVersion < Struct.new( :arn, :component_name, :component_version, - :recipe) + :recipe, + :vendor_guidance, + :message) SENSITIVE = [] include Aws::Structure end diff --git a/gems/aws-sdk-ioteventsdata/CHANGELOG.md b/gems/aws-sdk-ioteventsdata/CHANGELOG.md index 82a5bd07874..44ad7c9e92f 100644 --- a/gems/aws-sdk-ioteventsdata/CHANGELOG.md +++ b/gems/aws-sdk-ioteventsdata/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.27.0 (2022-05-18) +------------------ + +* Feature - Introducing new API for deleting detectors: BatchDeleteDetector. + 1.26.0 (2022-02-24) ------------------ diff --git a/gems/aws-sdk-ioteventsdata/VERSION b/gems/aws-sdk-ioteventsdata/VERSION index 5ff8c4f5d2a..5db08bf2dc5 100644 --- a/gems/aws-sdk-ioteventsdata/VERSION +++ b/gems/aws-sdk-ioteventsdata/VERSION @@ -1 +1 @@ -1.26.0 +1.27.0 diff --git a/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata.rb b/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata.rb index 50ee45b1759..52b08b6beff 100644 --- a/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata.rb +++ b/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata.rb @@ -48,6 +48,6 @@ # @!group service module Aws::IoTEventsData - GEM_VERSION = '1.26.0' + GEM_VERSION = '1.27.0' end diff --git a/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata/client.rb b/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata/client.rb index 12890fd289c..5d76fdf26d9 100644 --- a/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata/client.rb +++ b/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata/client.rb @@ -389,6 +389,48 @@ def batch_acknowledge_alarm(params = {}, options = {}) req.send_request(options) end + # Deletes one or more detectors that were created. When a detector is + # deleted, its state will be cleared and the detector will be removed + # from the list of detectors. The deleted detector will no longer appear + # if referenced in the [ListDetectors][1] API call. + # + # + # + # [1]: https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_ListDetectors.html + # + # @option params [required, Array] :detectors + # The list of one or more detectors to be deleted. + # + # @return [Types::BatchDeleteDetectorResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::BatchDeleteDetectorResponse#batch_delete_detector_error_entries #batch_delete_detector_error_entries} => Array<Types::BatchDeleteDetectorErrorEntry> + # + # @example Request syntax with placeholder values + # + # resp = client.batch_delete_detector({ + # detectors: [ # required + # { + # message_id: "MessageId", # required + # detector_model_name: "DetectorModelName", # required + # key_value: "KeyValue", + # }, + # ], + # }) + # + # @example Response structure + # + # resp.batch_delete_detector_error_entries #=> Array + # resp.batch_delete_detector_error_entries[0].message_id #=> String + # resp.batch_delete_detector_error_entries[0].error_code #=> String, one of "ResourceNotFoundException", "InvalidRequestException", "InternalFailureException", "ServiceUnavailableException", "ThrottlingException" + # resp.batch_delete_detector_error_entries[0].error_message #=> String + # + # @overload batch_delete_detector(params = {}) + # @param [Hash] params ({}) + def batch_delete_detector(params = {}, options = {}) + req = build_request(:batch_delete_detector, params) + req.send_request(options) + end + # Disables one or more alarms. The alarms change to the `DISABLED` state # after you disable them. # @@ -838,7 +880,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-ioteventsdata' - context[:gem_version] = '1.26.0' + context[:gem_version] = '1.27.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata/client_api.rb b/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata/client_api.rb index 0b8b774497d..0ae13c7dbc1 100644 --- a/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata/client_api.rb +++ b/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata/client_api.rb @@ -27,6 +27,10 @@ module ClientApi BatchAcknowledgeAlarmResponse = Shapes::StructureShape.new(name: 'BatchAcknowledgeAlarmResponse') BatchAlarmActionErrorEntries = Shapes::ListShape.new(name: 'BatchAlarmActionErrorEntries') BatchAlarmActionErrorEntry = Shapes::StructureShape.new(name: 'BatchAlarmActionErrorEntry') + BatchDeleteDetectorErrorEntries = Shapes::ListShape.new(name: 'BatchDeleteDetectorErrorEntries') + BatchDeleteDetectorErrorEntry = Shapes::StructureShape.new(name: 'BatchDeleteDetectorErrorEntry') + BatchDeleteDetectorRequest = Shapes::StructureShape.new(name: 'BatchDeleteDetectorRequest') + BatchDeleteDetectorResponse = Shapes::StructureShape.new(name: 'BatchDeleteDetectorResponse') BatchDisableAlarmRequest = Shapes::StructureShape.new(name: 'BatchDisableAlarmRequest') BatchDisableAlarmResponse = Shapes::StructureShape.new(name: 'BatchDisableAlarmResponse') BatchEnableAlarmRequest = Shapes::StructureShape.new(name: 'BatchEnableAlarmRequest') @@ -46,6 +50,8 @@ module ClientApi ComparisonOperator = Shapes::StringShape.new(name: 'ComparisonOperator') CustomerAction = Shapes::StructureShape.new(name: 'CustomerAction') CustomerActionName = Shapes::StringShape.new(name: 'CustomerActionName') + DeleteDetectorRequest = Shapes::StructureShape.new(name: 'DeleteDetectorRequest') + DeleteDetectorRequests = Shapes::ListShape.new(name: 'DeleteDetectorRequests') DescribeAlarmRequest = Shapes::StructureShape.new(name: 'DescribeAlarmRequest') DescribeAlarmResponse = Shapes::StructureShape.new(name: 'DescribeAlarmResponse') DescribeDetectorRequest = Shapes::StructureShape.new(name: 'DescribeDetectorRequest') @@ -170,6 +176,19 @@ module ClientApi BatchAlarmActionErrorEntry.add_member(:error_message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "errorMessage")) BatchAlarmActionErrorEntry.struct_class = Types::BatchAlarmActionErrorEntry + BatchDeleteDetectorErrorEntries.member = Shapes::ShapeRef.new(shape: BatchDeleteDetectorErrorEntry) + + BatchDeleteDetectorErrorEntry.add_member(:message_id, Shapes::ShapeRef.new(shape: MessageId, location_name: "messageId")) + BatchDeleteDetectorErrorEntry.add_member(:error_code, Shapes::ShapeRef.new(shape: ErrorCode, location_name: "errorCode")) + BatchDeleteDetectorErrorEntry.add_member(:error_message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "errorMessage")) + BatchDeleteDetectorErrorEntry.struct_class = Types::BatchDeleteDetectorErrorEntry + + BatchDeleteDetectorRequest.add_member(:detectors, Shapes::ShapeRef.new(shape: DeleteDetectorRequests, required: true, location_name: "detectors")) + BatchDeleteDetectorRequest.struct_class = Types::BatchDeleteDetectorRequest + + BatchDeleteDetectorResponse.add_member(:batch_delete_detector_error_entries, Shapes::ShapeRef.new(shape: BatchDeleteDetectorErrorEntries, location_name: "batchDeleteDetectorErrorEntries")) + BatchDeleteDetectorResponse.struct_class = Types::BatchDeleteDetectorResponse + BatchDisableAlarmRequest.add_member(:disable_action_requests, Shapes::ShapeRef.new(shape: DisableAlarmActionRequests, required: true, location_name: "disableActionRequests")) BatchDisableAlarmRequest.struct_class = Types::BatchDisableAlarmRequest @@ -228,6 +247,13 @@ module ClientApi CustomerAction.add_member(:reset_action_configuration, Shapes::ShapeRef.new(shape: ResetActionConfiguration, location_name: "resetActionConfiguration")) CustomerAction.struct_class = Types::CustomerAction + DeleteDetectorRequest.add_member(:message_id, Shapes::ShapeRef.new(shape: MessageId, required: true, location_name: "messageId")) + DeleteDetectorRequest.add_member(:detector_model_name, Shapes::ShapeRef.new(shape: DetectorModelName, required: true, location_name: "detectorModelName")) + DeleteDetectorRequest.add_member(:key_value, Shapes::ShapeRef.new(shape: KeyValue, location_name: "keyValue")) + DeleteDetectorRequest.struct_class = Types::DeleteDetectorRequest + + DeleteDetectorRequests.member = Shapes::ShapeRef.new(shape: DeleteDetectorRequest) + DescribeAlarmRequest.add_member(:alarm_model_name, Shapes::ShapeRef.new(shape: AlarmModelName, required: true, location: "uri", location_name: "alarmModelName")) DescribeAlarmRequest.add_member(:key_value, Shapes::ShapeRef.new(shape: KeyValue, location: "querystring", location_name: "keyValue")) DescribeAlarmRequest.struct_class = Types::DescribeAlarmRequest @@ -440,6 +466,18 @@ module ClientApi o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) end) + api.add_operation(:batch_delete_detector, Seahorse::Model::Operation.new.tap do |o| + o.name = "BatchDeleteDetector" + o.http_method = "POST" + o.http_request_uri = "/detectors/delete" + o.input = Shapes::ShapeRef.new(shape: BatchDeleteDetectorRequest) + o.output = Shapes::ShapeRef.new(shape: BatchDeleteDetectorResponse) + o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException) + o.errors << Shapes::ShapeRef.new(shape: InternalFailureException) + o.errors << Shapes::ShapeRef.new(shape: ServiceUnavailableException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + end) + api.add_operation(:batch_disable_alarm, Seahorse::Model::Operation.new.tap do |o| o.name = "BatchDisableAlarm" o.http_method = "POST" diff --git a/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata/types.rb b/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata/types.rb index fcc5f3302b1..6d09e681fe0 100644 --- a/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata/types.rb +++ b/gems/aws-sdk-ioteventsdata/lib/aws-sdk-ioteventsdata/types.rb @@ -307,6 +307,69 @@ class BatchAlarmActionErrorEntry < Struct.new( include Aws::Structure end + # Contains error messages associated with the deletion request. + # + # @!attribute [rw] message_id + # The ID of the message that caused the error. (See the value of the + # `"messageId"` in the [detectors][1] object of the + # `DeleteDetectorRequest`.) + # + # + # + # [1]: https://docs.aws.amazon.com/iotevents/latest/apireference/API_iotevents-data_BatchDeleteDetector.html#iotevents-iotevents-data_BatchDeleteDetector-request-detectors + # @return [String] + # + # @!attribute [rw] error_code + # The error code. + # @return [String] + # + # @!attribute [rw] error_message + # A message that describes the error. + # @return [String] + # + class BatchDeleteDetectorErrorEntry < Struct.new( + :message_id, + :error_code, + :error_message) + SENSITIVE = [] + include Aws::Structure + end + + # @note When making an API call, you may pass BatchDeleteDetectorRequest + # data as a hash: + # + # { + # detectors: [ # required + # { + # message_id: "MessageId", # required + # detector_model_name: "DetectorModelName", # required + # key_value: "KeyValue", + # }, + # ], + # } + # + # @!attribute [rw] detectors + # The list of one or more detectors to be deleted. + # @return [Array] + # + class BatchDeleteDetectorRequest < Struct.new( + :detectors) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] batch_delete_detector_error_entries + # A list of errors associated with the request, or an empty array + # (`[]`) if there are no errors. Each error entry contains a + # `messageId` that helps you identify the entry that failed. + # @return [Array] + # + class BatchDeleteDetectorResponse < Struct.new( + :batch_delete_detector_error_entries) + SENSITIVE = [] + include Aws::Structure + end + # @note When making an API call, you may pass BatchDisableAlarmRequest # data as a hash: # @@ -652,6 +715,43 @@ class CustomerAction < Struct.new( include Aws::Structure end + # Information used to delete the detector model. + # + # @note When making an API call, you may pass DeleteDetectorRequest + # data as a hash: + # + # { + # message_id: "MessageId", # required + # detector_model_name: "DetectorModelName", # required + # key_value: "KeyValue", + # } + # + # @!attribute [rw] message_id + # The ID to assign to the `DeleteDetectorRequest`. Each `"messageId"` + # must be unique within each batch sent. + # @return [String] + # + # @!attribute [rw] detector_model_name + # The name of the detector model that was used to create the detector + # instance. + # @return [String] + # + # @!attribute [rw] key_value + # The value of the [key][1] used to identify the detector. + # + # + # + # [1]: https://docs.aws.amazon.com/iotevents/latest/apireference/API_CreateDetectorModel.html#iotevents-CreateDetectorModel-request-key + # @return [String] + # + class DeleteDetectorRequest < Struct.new( + :message_id, + :detector_model_name, + :key_value) + SENSITIVE = [] + include Aws::Structure + end + # @note When making an API call, you may pass DescribeAlarmRequest # data as a hash: # diff --git a/gems/aws-sdk-quicksight/CHANGELOG.md b/gems/aws-sdk-quicksight/CHANGELOG.md index fdf254213c8..9b53244249f 100644 --- a/gems/aws-sdk-quicksight/CHANGELOG.md +++ b/gems/aws-sdk-quicksight/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.65.0 (2022-05-18) +------------------ + +* Feature - API UpdatePublicSharingSettings enables IAM admins to enable/disable account level setting for public access of dashboards. When enabled, owners/co-owners for dashboards can enable public access on their dashboards. These dashboards can only be accessed through share link or embedding. + 1.64.0 (2022-03-21) ------------------ diff --git a/gems/aws-sdk-quicksight/VERSION b/gems/aws-sdk-quicksight/VERSION index 9405730420f..902c74186fb 100644 --- a/gems/aws-sdk-quicksight/VERSION +++ b/gems/aws-sdk-quicksight/VERSION @@ -1 +1 @@ -1.64.0 +1.65.0 diff --git a/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight.rb b/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight.rb index f47a7643bdc..3f49cfbbd4b 100644 --- a/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight.rb +++ b/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight.rb @@ -48,6 +48,6 @@ # @!group service module Aws::QuickSight - GEM_VERSION = '1.64.0' + GEM_VERSION = '1.65.0' end diff --git a/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight/client.rb b/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight/client.rb index 8ba2f894542..5b7f67dbc4b 100644 --- a/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight/client.rb +++ b/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight/client.rb @@ -3015,6 +3015,7 @@ def describe_account_customization(params = {}, options = {}) # resp.account_settings.edition #=> String, one of "STANDARD", "ENTERPRISE" # resp.account_settings.default_namespace #=> String # resp.account_settings.notification_email #=> String + # resp.account_settings.public_sharing_enabled #=> Boolean # resp.request_id #=> String # resp.status #=> Integer # @@ -4428,8 +4429,8 @@ def describe_user(params = {}, options = {}) # session lifetime that can be customized using the ` # SessionLifetimeInMinutes ` parameter. # - # The resulting user session is valid for 15 minutes (default) to 10 - # hours (maximum). + # The resulting user session is valid for 15 minutes (minimum) to 10 + # hours (maximum). The default session duration is 10 hours. # # * You are charged only when the URL is used or there is interaction # with Amazon QuickSight. @@ -4478,7 +4479,8 @@ def describe_user(params = {}, options = {}) # user is authorized to access during the lifetime of the session. If # you choose `Dashboard` embedding experience, pass the list of # dashboard ARNs in the account that you want the user to be able to - # view. + # view. Currently, you can pass up to 25 dashboard ARNs in each API + # call. # # @option params [required, Types::AnonymousUserEmbeddingExperienceConfiguration] :experience_configuration # The configuration of the experience you are embedding. @@ -4540,8 +4542,8 @@ def generate_embed_url_for_anonymous_user(params = {}, options = {}) # session lifetime that can be customized using the ` # SessionLifetimeInMinutes ` parameter. # - # The resulting user session is valid for 15 minutes (default) to 10 - # hours (maximum). + # The resulting user session is valid for 15 minutes (minimum) to 10 + # hours (maximum). The default session duration is 10 hours. # # * You are charged only when the URL is used or there is interaction # with Amazon QuickSight. @@ -8159,6 +8161,55 @@ def update_ip_restriction(params = {}, options = {}) req.send_request(options) end + # Use the UpdatePublicSharingSettings operation to enable or disable the + # public sharing settings of an Amazon QuickSight dashboard. + # + # To use this operation, enable session capacity pricing on your Amazon + # QuickSight account. + # + # Before you can enable public sharing on your account, you need to + # allow public sharing permissions to an administrative user in the IAM + # console. For more information on using IAM with Amazon QuickSight, see + # [Using Amazon QuickSight with IAM][1]. + # + # + # + # [1]: https://docs.aws.amazon.com/quicksight/latest/user/security_iam_service-with-iam.html + # + # @option params [required, String] :aws_account_id + # The Amazon Web Services account ID associated with your Amazon + # QuickSight subscription. + # + # @option params [Boolean] :public_sharing_enabled + # A boolean that indicates whether or not public sharing is enabled on a + # Amazon QuickSight account. + # + # @return [Types::UpdatePublicSharingSettingsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods: + # + # * {Types::UpdatePublicSharingSettingsResponse#request_id #request_id} => String + # * {Types::UpdatePublicSharingSettingsResponse#status #status} => Integer + # + # @example Request syntax with placeholder values + # + # resp = client.update_public_sharing_settings({ + # aws_account_id: "AwsAccountId", # required + # public_sharing_enabled: false, + # }) + # + # @example Response structure + # + # resp.request_id #=> String + # resp.status #=> Integer + # + # @see http://docs.aws.amazon.com/goto/WebAPI/quicksight-2018-04-01/UpdatePublicSharingSettings AWS API Documentation + # + # @overload update_public_sharing_settings(params = {}) + # @param [Hash] params ({}) + def update_public_sharing_settings(params = {}, options = {}) + req = build_request(:update_public_sharing_settings, params) + req.send_request(options) + end + # Updates a template from an existing Amazon QuickSight analysis or # another template. # @@ -8762,7 +8813,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-quicksight' - context[:gem_version] = '1.64.0' + context[:gem_version] = '1.65.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight/client_api.rb b/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight/client_api.rb index 14793957a3c..1066f230b04 100644 --- a/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight/client_api.rb +++ b/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight/client_api.rb @@ -589,6 +589,8 @@ module ClientApi UpdateIpRestrictionRequest = Shapes::StructureShape.new(name: 'UpdateIpRestrictionRequest') UpdateIpRestrictionResponse = Shapes::StructureShape.new(name: 'UpdateIpRestrictionResponse') UpdateLinkPermissionList = Shapes::ListShape.new(name: 'UpdateLinkPermissionList') + UpdatePublicSharingSettingsRequest = Shapes::StructureShape.new(name: 'UpdatePublicSharingSettingsRequest') + UpdatePublicSharingSettingsResponse = Shapes::StructureShape.new(name: 'UpdatePublicSharingSettingsResponse') UpdateResourcePermissionList = Shapes::ListShape.new(name: 'UpdateResourcePermissionList') UpdateTemplateAliasRequest = Shapes::StructureShape.new(name: 'UpdateTemplateAliasRequest') UpdateTemplateAliasResponse = Shapes::StructureShape.new(name: 'UpdateTemplateAliasResponse') @@ -629,6 +631,7 @@ module ClientApi AccountSettings.add_member(:edition, Shapes::ShapeRef.new(shape: Edition, location_name: "Edition")) AccountSettings.add_member(:default_namespace, Shapes::ShapeRef.new(shape: Namespace, location_name: "DefaultNamespace")) AccountSettings.add_member(:notification_email, Shapes::ShapeRef.new(shape: String, location_name: "NotificationEmail")) + AccountSettings.add_member(:public_sharing_enabled, Shapes::ShapeRef.new(shape: Boolean, location_name: "PublicSharingEnabled")) AccountSettings.struct_class = Types::AccountSettings ActionList.member = Shapes::ShapeRef.new(shape: String) @@ -2924,6 +2927,14 @@ module ClientApi UpdateLinkPermissionList.member = Shapes::ShapeRef.new(shape: ResourcePermission) + UpdatePublicSharingSettingsRequest.add_member(:aws_account_id, Shapes::ShapeRef.new(shape: AwsAccountId, required: true, location: "uri", location_name: "AwsAccountId")) + UpdatePublicSharingSettingsRequest.add_member(:public_sharing_enabled, Shapes::ShapeRef.new(shape: Boolean, location_name: "PublicSharingEnabled")) + UpdatePublicSharingSettingsRequest.struct_class = Types::UpdatePublicSharingSettingsRequest + + UpdatePublicSharingSettingsResponse.add_member(:request_id, Shapes::ShapeRef.new(shape: String, location_name: "RequestId")) + UpdatePublicSharingSettingsResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusCode, location: "statusCode", location_name: "Status")) + UpdatePublicSharingSettingsResponse.struct_class = Types::UpdatePublicSharingSettingsResponse + UpdateResourcePermissionList.member = Shapes::ShapeRef.new(shape: ResourcePermission) UpdateTemplateAliasRequest.add_member(:aws_account_id, Shapes::ShapeRef.new(shape: AwsAccountId, required: true, location: "uri", location_name: "AwsAccountId")) @@ -4763,6 +4774,20 @@ module ClientApi o.errors << Shapes::ShapeRef.new(shape: InternalFailureException) end) + api.add_operation(:update_public_sharing_settings, Seahorse::Model::Operation.new.tap do |o| + o.name = "UpdatePublicSharingSettings" + o.http_method = "PUT" + o.http_request_uri = "/accounts/{AwsAccountId}/public-sharing-settings" + o.input = Shapes::ShapeRef.new(shape: UpdatePublicSharingSettingsRequest) + o.output = Shapes::ShapeRef.new(shape: UpdatePublicSharingSettingsResponse) + o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException) + o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException) + o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException) + o.errors << Shapes::ShapeRef.new(shape: ThrottlingException) + o.errors << Shapes::ShapeRef.new(shape: UnsupportedPricingPlanException) + o.errors << Shapes::ShapeRef.new(shape: InternalFailureException) + end) + api.add_operation(:update_template, Seahorse::Model::Operation.new.tap do |o| o.name = "UpdateTemplate" o.http_method = "PUT" diff --git a/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight/types.rb b/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight/types.rb index a0f20e60f7e..fd754389704 100644 --- a/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight/types.rb +++ b/gems/aws-sdk-quicksight/lib/aws-sdk-quicksight/types.rb @@ -85,13 +85,24 @@ class AccountCustomization < Struct.new( # The main notification email for your Amazon QuickSight subscription. # @return [String] # + # @!attribute [rw] public_sharing_enabled + # A boolean that indicates whether or not public sharing is enabled on + # an Amazon QuickSight account. For more information about enabling + # public sharing, see [UpdatePublicSharingSettings][1]. + # + # + # + # [1]: https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdatePublicSharingSettings.html + # @return [Boolean] + # # @see http://docs.aws.amazon.com/goto/WebAPI/quicksight-2018-04-01/AccountSettings AWS API Documentation # class AccountSettings < Struct.new( :account_name, :edition, :default_namespace, - :notification_email) + :notification_email, + :public_sharing_enabled) SENSITIVE = [] include Aws::Structure end @@ -7128,7 +7139,8 @@ class FolderSummary < Struct.new( # the user is authorized to access during the lifetime of the session. # If you choose `Dashboard` embedding experience, pass the list of # dashboard ARNs in the account that you want the user to be able to - # view. + # view. Currently, you can pass up to 25 dashboard ARNs in each API + # call. # @return [Array] # # @!attribute [rw] experience_configuration @@ -14626,6 +14638,50 @@ class UpdateIpRestrictionResponse < Struct.new( include Aws::Structure end + # @note When making an API call, you may pass UpdatePublicSharingSettingsRequest + # data as a hash: + # + # { + # aws_account_id: "AwsAccountId", # required + # public_sharing_enabled: false, + # } + # + # @!attribute [rw] aws_account_id + # The Amazon Web Services account ID associated with your Amazon + # QuickSight subscription. + # @return [String] + # + # @!attribute [rw] public_sharing_enabled + # A boolean that indicates whether or not public sharing is enabled on + # a Amazon QuickSight account. + # @return [Boolean] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/quicksight-2018-04-01/UpdatePublicSharingSettingsRequest AWS API Documentation + # + class UpdatePublicSharingSettingsRequest < Struct.new( + :aws_account_id, + :public_sharing_enabled) + SENSITIVE = [] + include Aws::Structure + end + + # @!attribute [rw] request_id + # The Amazon Web Services request ID for this operation. + # @return [String] + # + # @!attribute [rw] status + # The HTTP status of the request. + # @return [Integer] + # + # @see http://docs.aws.amazon.com/goto/WebAPI/quicksight-2018-04-01/UpdatePublicSharingSettingsResponse AWS API Documentation + # + class UpdatePublicSharingSettingsResponse < Struct.new( + :request_id, + :status) + SENSITIVE = [] + include Aws::Structure + end + # @note When making an API call, you may pass UpdateTemplateAliasRequest # data as a hash: # diff --git a/gems/aws-sdk-transfer/CHANGELOG.md b/gems/aws-sdk-transfer/CHANGELOG.md index 37bea3ab6e1..d5e2fbc2206 100644 --- a/gems/aws-sdk-transfer/CHANGELOG.md +++ b/gems/aws-sdk-transfer/CHANGELOG.md @@ -1,6 +1,11 @@ Unreleased Changes ------------------ +1.55.0 (2022-05-18) +------------------ + +* Feature - AWS Transfer Family now supports SetStat server configuration option, which provides the ability to ignore SetStat command issued by file transfer clients, enabling customers to upload files without any errors. + 1.54.0 (2022-05-12) ------------------ diff --git a/gems/aws-sdk-transfer/VERSION b/gems/aws-sdk-transfer/VERSION index b7921ae87bc..094d6ad00ce 100644 --- a/gems/aws-sdk-transfer/VERSION +++ b/gems/aws-sdk-transfer/VERSION @@ -1 +1 @@ -1.54.0 +1.55.0 diff --git a/gems/aws-sdk-transfer/lib/aws-sdk-transfer.rb b/gems/aws-sdk-transfer/lib/aws-sdk-transfer.rb index 0347f23d903..cb318f899ec 100644 --- a/gems/aws-sdk-transfer/lib/aws-sdk-transfer.rb +++ b/gems/aws-sdk-transfer/lib/aws-sdk-transfer.rb @@ -49,6 +49,6 @@ # @!group service module Aws::Transfer - GEM_VERSION = '1.54.0' + GEM_VERSION = '1.55.0' end diff --git a/gems/aws-sdk-transfer/lib/aws-sdk-transfer/client.rb b/gems/aws-sdk-transfer/lib/aws-sdk-transfer/client.rb index 4f7b0785f9c..24410b24018 100644 --- a/gems/aws-sdk-transfer/lib/aws-sdk-transfer/client.rb +++ b/gems/aws-sdk-transfer/lib/aws-sdk-transfer/client.rb @@ -608,25 +608,8 @@ def create_access(params = {}, options = {}) # # # @option params [String] :host_key - # The RSA or ECDSA private key to use for your server. - # - # Use the following command to generate an RSA 2048 bit key with no - # passphrase: - # - # `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`. - # - # Use a minimum value of 2048 for the `-b` option: you can create a - # stronger key using 3072 or 4096. - # - # Use the following command to generate an ECDSA 256 bit key with no - # passphrase: - # - # `ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key`. - # - # Valid values for the `-b` option for ECDSA are 256, 384, and 521. - # - # For both of these commands, you can replace *my-new-server-key* with a - # string of your choice. + # The RSA private key as generated by the `ssh-keygen -N "" -m PEM -f + # my-new-server-key` command. # # If you aren't planning to migrate existing users from an existing # SFTP-enabled server to a new server, don't update the host key. @@ -725,13 +708,22 @@ def create_access(params = {}, options = {}) # @option params [Types::ProtocolDetails] :protocol_details # The protocol settings that are configured for your server. # - # Use the `PassiveIp` parameter to indicate passive mode (for FTP and - # FTPS protocols). Enter a single dotted-quad IPv4 address, such as the - # external IP address of a firewall, router, or load balancer. + # * Use the `PassiveIp` parameter to indicate passive mode (for FTP and + # FTPS protocols). Enter a single dotted-quad IPv4 address, such as + # the external IP address of a firewall, router, or load balancer. + # + # * Use the `SetStatOption` to ignore the error that is generated when + # the client attempts to use SETSTAT on a file you are uploading to an + # S3 bucket. Set the value to `ENABLE_NO_OP` to have the Transfer + # Family server ignore the SETSTAT command, and upload files without + # needing to make any changes to your SFTP client. Note that with + # `SetStatOption` set to `ENABLE_NO_OP`, Transfer generates a log + # entry to CloudWatch Logs, so you can determine when the client is + # making a SETSTAT call. # - # Use the `TlsSessionResumptionMode` parameter to determine whether or - # not your Transfer server resumes recent, negotiated sessions through a - # unique session ID. + # * Use the `TlsSessionResumptionMode` parameter to determine whether or + # not your Transfer server resumes recent, negotiated sessions through + # a unique session ID. # # @option params [String] :security_policy_name # Specifies the name of the security policy that is attached to the @@ -776,6 +768,7 @@ def create_access(params = {}, options = {}) # protocol_details: { # passive_ip: "PassiveIp", # tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED + # set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP # }, # security_policy_name: "SecurityPolicyName", # tags: [ @@ -1483,6 +1476,7 @@ def describe_security_policy(params = {}, options = {}) # resp.server.certificate #=> String # resp.server.protocol_details.passive_ip #=> String # resp.server.protocol_details.tls_session_resumption_mode #=> String, one of "DISABLED", "ENABLED", "ENFORCED" + # resp.server.protocol_details.set_stat_option #=> String, one of "DEFAULT", "ENABLE_NO_OP" # resp.server.domain #=> String, one of "S3", "EFS" # resp.server.endpoint_details.address_allocation_ids #=> Array # resp.server.endpoint_details.address_allocation_ids[0] #=> String @@ -2535,13 +2529,22 @@ def update_access(params = {}, options = {}) # @option params [Types::ProtocolDetails] :protocol_details # The protocol settings that are configured for your server. # - # Use the `PassiveIp` parameter to indicate passive mode (for FTP and - # FTPS protocols). Enter a single dotted-quad IPv4 address, such as the - # external IP address of a firewall, router, or load balancer. + # * Use the `PassiveIp` parameter to indicate passive mode (for FTP and + # FTPS protocols). Enter a single dotted-quad IPv4 address, such as + # the external IP address of a firewall, router, or load balancer. # - # Use the `TlsSessionResumptionMode` parameter to determine whether or - # not your Transfer server resumes recent, negotiated sessions through a - # unique session ID. + # * Use the `SetStatOption` to ignore the error that is generated when + # the client attempts to use SETSTAT on a file you are uploading to an + # S3 bucket. Set the value to `ENABLE_NO_OP` to have the Transfer + # Family server ignore the SETSTAT command, and upload files without + # needing to make any changes to your SFTP client. Note that with + # `SetStatOption` set to `ENABLE_NO_OP`, Transfer generates a log + # entry to CloudWatch Logs, so you can determine when the client is + # making a SETSTAT call. + # + # * Use the `TlsSessionResumptionMode` parameter to determine whether or + # not your Transfer server resumes recent, negotiated sessions through + # a unique session ID. # # @option params [Types::EndpointDetails] :endpoint_details # The virtual private cloud (VPC) endpoint settings that are configured @@ -2579,32 +2582,15 @@ def update_access(params = {}, options = {}) # # # @option params [String] :host_key - # The RSA or ECDSA private key to use for your server. - # - # Use the following command to generate an RSA 2048 bit key with no - # passphrase: - # - # `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`. - # - # Use a minimum value of 2048 for the `-b` option: you can create a - # stronger key using 3072 or 4096. - # - # Use the following command to generate an ECDSA 256 bit key with no - # passphrase: - # - # `ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key`. - # - # Valid values for the `-b` option for ECDSA are 256, 384, and 521. - # - # For both of these commands, you can replace *my-new-server-key* with a - # string of your choice. + # The RSA private key as generated by `ssh-keygen -N "" -m PEM -f + # my-new-server-key`. # # If you aren't planning to migrate existing users from an existing - # SFTP-enabled server to a new server, don't update the host key. - # Accidentally changing a server's host key can be disruptive. + # server to a new server, don't update the host key. Accidentally + # changing a server's host key can be disruptive. # # For more information, see [Change the host key for your SFTP-enabled - # server][1] in the *Amazon Web Services Transfer Family User Guide*. + # server][1] in the *Amazon Web ServicesTransfer Family User Guide*. # # # @@ -2698,6 +2684,7 @@ def update_access(params = {}, options = {}) # protocol_details: { # passive_ip: "PassiveIp", # tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED + # set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP # }, # endpoint_details: { # address_allocation_ids: ["AddressAllocationId"], @@ -2900,7 +2887,7 @@ def build_request(operation_name, params = {}) params: params, config: config) context[:gem_name] = 'aws-sdk-transfer' - context[:gem_version] = '1.54.0' + context[:gem_version] = '1.55.0' Seahorse::Client::Request.new(handlers, context) end diff --git a/gems/aws-sdk-transfer/lib/aws-sdk-transfer/client_api.rb b/gems/aws-sdk-transfer/lib/aws-sdk-transfer/client_api.rb index 4f0dac42708..bbe13a46850 100644 --- a/gems/aws-sdk-transfer/lib/aws-sdk-transfer/client_api.rb +++ b/gems/aws-sdk-transfer/lib/aws-sdk-transfer/client_api.rb @@ -165,6 +165,7 @@ module ClientApi ServiceMetadata = Shapes::StructureShape.new(name: 'ServiceMetadata') ServiceUnavailableException = Shapes::StructureShape.new(name: 'ServiceUnavailableException') SessionId = Shapes::StringShape.new(name: 'SessionId') + SetStatOption = Shapes::StringShape.new(name: 'SetStatOption') SourceFileLocation = Shapes::StringShape.new(name: 'SourceFileLocation') SourceIp = Shapes::StringShape.new(name: 'SourceIp') SshPublicKey = Shapes::StructureShape.new(name: 'SshPublicKey') @@ -612,6 +613,7 @@ module ClientApi ProtocolDetails.add_member(:passive_ip, Shapes::ShapeRef.new(shape: PassiveIp, location_name: "PassiveIp")) ProtocolDetails.add_member(:tls_session_resumption_mode, Shapes::ShapeRef.new(shape: TlsSessionResumptionMode, location_name: "TlsSessionResumptionMode")) + ProtocolDetails.add_member(:set_stat_option, Shapes::ShapeRef.new(shape: SetStatOption, location_name: "SetStatOption")) ProtocolDetails.struct_class = Types::ProtocolDetails Protocols.member = Shapes::ShapeRef.new(shape: Protocol) diff --git a/gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb b/gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb index 0df6bae500d..368275c02d5 100644 --- a/gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb +++ b/gems/aws-sdk-transfer/lib/aws-sdk-transfer/types.rb @@ -300,6 +300,7 @@ class CreateAccessResponse < Struct.new( # protocol_details: { # passive_ip: "PassiveIp", # tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED + # set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP # }, # security_policy_name: "SecurityPolicyName", # tags: [ @@ -409,25 +410,8 @@ class CreateAccessResponse < Struct.new( # @return [String] # # @!attribute [rw] host_key - # The RSA or ECDSA private key to use for your server. - # - # Use the following command to generate an RSA 2048 bit key with no - # passphrase: - # - # `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`. - # - # Use a minimum value of 2048 for the `-b` option: you can create a - # stronger key using 3072 or 4096. - # - # Use the following command to generate an ECDSA 256 bit key with no - # passphrase: - # - # `ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key`. - # - # Valid values for the `-b` option for ECDSA are 256, 384, and 521. - # - # For both of these commands, you can replace *my-new-server-key* with - # a string of your choice. + # The RSA private key as generated by the `ssh-keygen -N "" -m PEM -f + # my-new-server-key` command. # # If you aren't planning to migrate existing users from an existing # SFTP-enabled server to a new server, don't update the host key. @@ -536,13 +520,23 @@ class CreateAccessResponse < Struct.new( # @!attribute [rw] protocol_details # The protocol settings that are configured for your server. # - # Use the `PassiveIp` parameter to indicate passive mode (for FTP and - # FTPS protocols). Enter a single dotted-quad IPv4 address, such as - # the external IP address of a firewall, router, or load balancer. - # - # Use the `TlsSessionResumptionMode` parameter to determine whether or - # not your Transfer server resumes recent, negotiated sessions through - # a unique session ID. + # * Use the `PassiveIp` parameter to indicate passive mode (for FTP + # and FTPS protocols). Enter a single dotted-quad IPv4 address, such + # as the external IP address of a firewall, router, or load + # balancer. + # + # * Use the `SetStatOption` to ignore the error that is generated when + # the client attempts to use SETSTAT on a file you are uploading to + # an S3 bucket. Set the value to `ENABLE_NO_OP` to have the Transfer + # Family server ignore the SETSTAT command, and upload files without + # needing to make any changes to your SFTP client. Note that with + # `SetStatOption` set to `ENABLE_NO_OP`, Transfer generates a log + # entry to CloudWatch Logs, so you can determine when the client is + # making a SETSTAT call. + # + # * Use the `TlsSessionResumptionMode` parameter to determine whether + # or not your Transfer server resumes recent, negotiated sessions + # through a unique session ID. # @return [Types::ProtocolDetails] # # @!attribute [rw] security_policy_name @@ -3173,6 +3167,7 @@ class PosixProfile < Struct.new( # { # passive_ip: "PassiveIp", # tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED + # set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP # } # # @!attribute [rw] passive_ip @@ -3231,11 +3226,39 @@ class PosixProfile < Struct.new( # # @return [String] # + # @!attribute [rw] set_stat_option + # Use the `SetStatOption` to ignore the error that is generated when + # the client attempts to use SETSTAT on a file you are uploading to an + # S3 bucket. + # + # Some SFTP file transfer clients can attempt to change the attributes + # of remote files, including timestamp and permissions, using + # commands, such as SETSTAT when uploading the file. However, these + # commands are not compatible with object storage systems, such as + # Amazon S3. Due to this incompatibility, file uploads from these + # clients can result in errors even when the file is otherwise + # successfully uploaded. + # + # Set the value to `ENABLE_NO_OP` to have the Transfer Family server + # ignore the SETSTAT command, and upload files without needing to make + # any changes to your SFTP client. While the `SetStatOption` + # `ENABLE_NO_OP` setting ignores the error, it does generate a log + # entry in CloudWatch Logs, so you can determine when the client is + # making a SETSTAT call. + # + # If you want to preserve the original timestamp for your file, and + # modify other file attributes using SETSTAT, you can use Amazon EFS + # as backend storage with Transfer Family. + # + # + # @return [String] + # # @see http://docs.aws.amazon.com/goto/WebAPI/transfer-2018-11-05/ProtocolDetails AWS API Documentation # class ProtocolDetails < Struct.new( :passive_ip, - :tls_session_resumption_mode) + :tls_session_resumption_mode, + :set_stat_option) SENSITIVE = [] include Aws::Structure end @@ -3953,6 +3976,7 @@ class UpdateAccessResponse < Struct.new( # protocol_details: { # passive_ip: "PassiveIp", # tls_session_resumption_mode: "DISABLED", # accepts DISABLED, ENABLED, ENFORCED + # set_stat_option: "DEFAULT", # accepts DEFAULT, ENABLE_NO_OP # }, # endpoint_details: { # address_allocation_ids: ["AddressAllocationId"], @@ -4030,13 +4054,23 @@ class UpdateAccessResponse < Struct.new( # @!attribute [rw] protocol_details # The protocol settings that are configured for your server. # - # Use the `PassiveIp` parameter to indicate passive mode (for FTP and - # FTPS protocols). Enter a single dotted-quad IPv4 address, such as - # the external IP address of a firewall, router, or load balancer. - # - # Use the `TlsSessionResumptionMode` parameter to determine whether or - # not your Transfer server resumes recent, negotiated sessions through - # a unique session ID. + # * Use the `PassiveIp` parameter to indicate passive mode (for FTP + # and FTPS protocols). Enter a single dotted-quad IPv4 address, such + # as the external IP address of a firewall, router, or load + # balancer. + # + # * Use the `SetStatOption` to ignore the error that is generated when + # the client attempts to use SETSTAT on a file you are uploading to + # an S3 bucket. Set the value to `ENABLE_NO_OP` to have the Transfer + # Family server ignore the SETSTAT command, and upload files without + # needing to make any changes to your SFTP client. Note that with + # `SetStatOption` set to `ENABLE_NO_OP`, Transfer generates a log + # entry to CloudWatch Logs, so you can determine when the client is + # making a SETSTAT call. + # + # * Use the `TlsSessionResumptionMode` parameter to determine whether + # or not your Transfer server resumes recent, negotiated sessions + # through a unique session ID. # @return [Types::ProtocolDetails] # # @!attribute [rw] endpoint_details @@ -4077,32 +4111,15 @@ class UpdateAccessResponse < Struct.new( # @return [String] # # @!attribute [rw] host_key - # The RSA or ECDSA private key to use for your server. - # - # Use the following command to generate an RSA 2048 bit key with no - # passphrase: - # - # `ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key`. - # - # Use a minimum value of 2048 for the `-b` option: you can create a - # stronger key using 3072 or 4096. - # - # Use the following command to generate an ECDSA 256 bit key with no - # passphrase: - # - # `ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key`. - # - # Valid values for the `-b` option for ECDSA are 256, 384, and 521. - # - # For both of these commands, you can replace *my-new-server-key* with - # a string of your choice. + # The RSA private key as generated by `ssh-keygen -N "" -m PEM -f + # my-new-server-key`. # # If you aren't planning to migrate existing users from an existing - # SFTP-enabled server to a new server, don't update the host key. - # Accidentally changing a server's host key can be disruptive. + # server to a new server, don't update the host key. Accidentally + # changing a server's host key can be disruptive. # # For more information, see [Change the host key for your SFTP-enabled - # server][1] in the *Amazon Web Services Transfer Family User Guide*. + # server][1] in the *Amazon Web ServicesTransfer Family User Guide*. # # #