Returns the map's glyphs.
" + }, + "GetSprites":{ + "name":"GetSprites", + "http":{ + "method":"GET", + "requestUri":"/styles/{Style}/{ColorScheme}/{Variant}/sprites/{FileName}", + "responseCode":200 + }, + "input":{"shape":"GetSpritesRequest"}, + "output":{"shape":"GetSpritesResponse"}, + "documentation":"Returns the map's sprites.
" + }, + "GetStaticMap":{ + "name":"GetStaticMap", + "http":{ + "method":"GET", + "requestUri":"/static/{FileName}", + "responseCode":200 + }, + "input":{"shape":"GetStaticMapRequest"}, + "output":{"shape":"GetStaticMapResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ValidationException"}, + {"shape":"ThrottlingException"} + ], + "documentation":"Provides high-quality static map images with customizable options. You can modify the map's appearance and overlay additional information. It's an ideal solution for applications requiring tailored static map snapshots.
" + }, + "GetStyleDescriptor":{ + "name":"GetStyleDescriptor", + "http":{ + "method":"GET", + "requestUri":"/styles/{Style}/descriptor", + "responseCode":200 + }, + "input":{"shape":"GetStyleDescriptorRequest"}, + "output":{"shape":"GetStyleDescriptorResponse"}, + "documentation":"Returns information about the style.
" + }, + "GetTile":{ + "name":"GetTile", + "http":{ + "method":"GET", + "requestUri":"/tiles/{Tileset}/{Z}/{X}/{Y}", + "responseCode":200 + }, + "input":{"shape":"GetTileRequest"}, + "output":{"shape":"GetTileResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ValidationException"}, + {"shape":"ThrottlingException"} + ], + "documentation":"Returns a tile. Map tiles are used by clients to render a map. they're addressed using a grid arrangement with an X coordinate, Y coordinate, and Z (zoom) level.
" + } + }, + "shapes":{ + "AccessDeniedException":{ + "type":"structure", + "required":["Message"], + "members":{ + "Message":{ + "shape":"String", + "locationName":"message" + } + }, + "documentation":"The request was denied because of insufficient access or permissions. Check with an administrator to verify your permissions.
", + "error":{ + "httpStatusCode":403, + "senderFault":true + }, + "exception":true + }, + "ApiKey":{ + "type":"string", + "max":1000, + "min":0, + "sensitive":true + }, + "Blob":{"type":"blob"}, + "ColorScheme":{ + "type":"string", + "enum":[ + "Light", + "Dark" + ] + }, + "CompactOverlay":{ + "type":"string", + "max":7000, + "min":1 + }, + "CountryCode":{ + "type":"string", + "max":3, + "min":2, + "pattern":"([A-Z]{2}|[A-Z]{3})" + }, + "DistanceMeters":{ + "type":"long", + "max":4294967295, + "min":0 + }, + "GeoJsonOverlay":{ + "type":"string", + "max":7000, + "min":1 + }, + "GetGlyphsRequest":{ + "type":"structure", + "required":[ + "FontStack", + "FontUnicodeRange" + ], + "members":{ + "FontStack":{ + "shape":"GetGlyphsRequestFontStackString", + "documentation":"Name of the FontStack to retrieve.
Example: Amazon Ember Bold,Noto Sans Bold.
The supported font stacks are as follows:
Amazon Ember Bold
Amazon Ember Bold Italic
Amazon Ember Bold,Noto Sans Bold
Amazon Ember Bold,Noto Sans Bold,Noto Sans Arabic Bold
Amazon Ember Condensed RC BdItalic
Amazon Ember Condensed RC Bold
Amazon Ember Condensed RC Bold Italic
Amazon Ember Condensed RC Bold,Noto Sans Bold
Amazon Ember Condensed RC Bold,Noto Sans Bold,Noto Sans Arabic Condensed Bold
Amazon Ember Condensed RC Light
Amazon Ember Condensed RC Light Italic
Amazon Ember Condensed RC LtItalic
Amazon Ember Condensed RC Regular
Amazon Ember Condensed RC Regular Italic
Amazon Ember Condensed RC Regular,Noto Sans Regular
Amazon Ember Condensed RC Regular,Noto Sans Regular,Noto Sans Arabic Condensed Regular
Amazon Ember Condensed RC RgItalic
Amazon Ember Condensed RC ThItalic
Amazon Ember Condensed RC Thin
Amazon Ember Condensed RC Thin Italic
Amazon Ember Heavy
Amazon Ember Heavy Italic
Amazon Ember Light
Amazon Ember Light Italic
Amazon Ember Medium
Amazon Ember Medium Italic
Amazon Ember Medium,Noto Sans Medium
Amazon Ember Medium,Noto Sans Medium,Noto Sans Arabic Medium
Amazon Ember Regular
Amazon Ember Regular Italic
Amazon Ember Regular Italic,Noto Sans Italic
Amazon Ember Regular Italic,Noto Sans Italic,Noto Sans Arabic Regular
Amazon Ember Regular,Noto Sans Regular
Amazon Ember Regular,Noto Sans Regular,Noto Sans Arabic Regular
Amazon Ember Thin
Amazon Ember Thin Italic
AmazonEmberCdRC_Bd
AmazonEmberCdRC_BdIt
AmazonEmberCdRC_Lt
AmazonEmberCdRC_LtIt
AmazonEmberCdRC_Rg
AmazonEmberCdRC_RgIt
AmazonEmberCdRC_Th
AmazonEmberCdRC_ThIt
AmazonEmber_Bd
AmazonEmber_BdIt
AmazonEmber_He
AmazonEmber_HeIt
AmazonEmber_Lt
AmazonEmber_LtIt
AmazonEmber_Md
AmazonEmber_MdIt
AmazonEmber_Rg
AmazonEmber_RgIt
AmazonEmber_Th
AmazonEmber_ThIt
Noto Sans Black
Noto Sans Black Italic
Noto Sans Bold
Noto Sans Bold Italic
Noto Sans Extra Bold
Noto Sans Extra Bold Italic
Noto Sans Extra Light
Noto Sans Extra Light Italic
Noto Sans Italic
Noto Sans Light
Noto Sans Light Italic
Noto Sans Medium
Noto Sans Medium Italic
Noto Sans Regular
Noto Sans Semi Bold
Noto Sans Semi Bold Italic
Noto Sans Thin
Noto Sans Thin Italic
NotoSans-Bold
NotoSans-Italic
NotoSans-Medium
NotoSans-Regular
Open Sans Regular,Arial Unicode MS Regular
A Unicode range of characters to download glyphs for. This must be aligned to multiples of 256.
Example: 0-255.pdf
The Glyph, as a binary blob.
" + }, + "ContentType":{ + "shape":"String", + "documentation":"Header that represents the format of the response. The response returns the following as the HTTP body.
", + "location":"header", + "locationName":"Content-Type" + }, + "CacheControl":{ + "shape":"String", + "documentation":"Header that instructs caching configuration for the client.
", + "location":"header", + "locationName":"Cache-Control" + }, + "ETag":{ + "shape":"String", + "documentation":"The glyph's Etag.
", + "location":"header", + "locationName":"ETag" + } + }, + "payload":"Blob" + }, + "GetSpritesRequest":{ + "type":"structure", + "required":[ + "FileName", + "Style", + "ColorScheme", + "Variant" + ], + "members":{ + "FileName":{ + "shape":"GetSpritesRequestFileNameString", + "documentation":" Sprites API: The name of the sprite file to retrieve, following pattern sprites(@2x)?\\.(png|json).
Example: sprites.png
Style specifies the desired map style for the Sprites APIs.
Sets color tone for map such as dark and light for specific map styles. It applies to only vector map styles such as Standard and Monochrome.
Example: Light
Default value: Light
Valid values for ColorScheme are case sensitive.
Optimizes map styles for specific use case or industry. You can choose allowed variant only with Standard map style.
Example: Default
Valid values for Variant are case sensitive.
The body of the sprite sheet or JSON offset file (image/png or application/json, depending on input).
" + }, + "ContentType":{ + "shape":"String", + "documentation":"Header that represents the format of the response. The response returns the following as the HTTP body.
", + "location":"header", + "locationName":"Content-Type" + }, + "CacheControl":{ + "shape":"String", + "documentation":"Header that instructs caching configuration for the client.
", + "location":"header", + "locationName":"Cache-Control" + }, + "ETag":{ + "shape":"String", + "documentation":"The sprite's Etag.
", + "location":"header", + "locationName":"ETag" + } + }, + "payload":"Blob" + }, + "GetStaticMapRequest":{ + "type":"structure", + "required":[ + "Height", + "FileName", + "Width" + ], + "members":{ + "BoundingBox":{ + "shape":"PositionListString", + "documentation":"Takes in two pairs of coordinates, [Lon, Lat], denoting south-westerly and north-easterly edges of the image. The underlying area becomes the view of the image.
Example: -123.17075,49.26959,-123.08125,49.31429
", + "location":"querystring", + "locationName":"bounding-box" + }, + "BoundedPositions":{ + "shape":"PositionListString", + "documentation":"Takes in two or more pair of coordinates, [Lon, Lat], with each coordinate separated by a comma. The API will generate an image to encompass all of the provided coordinates.
Cannot be used with Zoom and or Radius
Example: 97.170451,78.039098,99.045536,27.176178
", + "location":"querystring", + "locationName":"bounded-positions" + }, + "Center":{ + "shape":"PositionString", + "documentation":"Takes in a pair of coordinates, [Lon, Lat], which becomes the center point of the image. This parameter requires that either zoom or radius is set.
Cannot be used with Zoom and or Radius
Example: 49.295,-123.108
", + "location":"querystring", + "locationName":"center" + }, + "CompactOverlay":{ + "shape":"CompactOverlay", + "documentation":"Takes in a string to draw geometries on the image. The input is a comma separated format as follows format: [Lon, Lat]
Example: line:-122.407653,37.798557,-122.413291,37.802443;color=%23DD0000;width=7;outline-color=#00DD00;outline-width=5yd|point:-122.40572,37.80004;label=Fog Hill Market;size=large;text-color=%23DD0000;color=#EE4B2B
Currently it supports the following geometry types: point, line and polygon. It does not support multiPoint , multiLine and multiPolgyon.
Takes in a string to draw geometries on the image. The input is a valid GeoJSON collection object.
Example: {\"type\":\"FeatureCollection\",\"features\": [{\"type\":\"Feature\",\"geometry\":{\"type\":\"MultiPoint\",\"coordinates\": [[-90.076345,51.504107],[-0.074451,51.506892]]},\"properties\": {\"color\":\"#00DD00\"}}]}
Specifies the height of the map image.
", + "location":"querystring", + "locationName":"height" + }, + "Key":{ + "shape":"ApiKey", + "documentation":"Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + }, + "Padding":{ + "shape":"Integer", + "documentation":"Applies additional space (in pixels) around overlay feature to prevent them from being cut or obscured.
Value for max and min is determined by:
Min: 1
Max: min(height, width)/4
Example: 100
Used with center parameter, it specifies the zoom of the image where you can control it on a granular level. Takes in any value >= 1.
Example: 1500
Cannot be used with Zoom.
Unit: Meters
The map scaling parameter to size the image, icons, and labels. It follows the pattern of ^map(@2x)?$.
Example: map, map@2x
Displays a scale on the bottom right of the map image with the unit specified in the input.
Example: KilometersMiles, Miles, Kilometers, MilesKilometers
Style specifies the desired map style for the Style APIs.
Specifies the width of the map image.
", + "location":"querystring", + "locationName":"width" + }, + "Zoom":{ + "shape":"GetStaticMapRequestZoomFloat", + "documentation":"Specifies the zoom level of the map image.
Cannot be used with Radius.
The blob represents a map image as a jpeg for the GetStaticMap API.
Header that represents the format of the response. The response returns the following as the HTTP body.
", + "location":"header", + "locationName":"Content-Type" + }, + "CacheControl":{ + "shape":"String", + "documentation":"Header that instructs caching configuration for the client.
", + "location":"header", + "locationName":"Cache-Control" + }, + "ETag":{ + "shape":"String", + "documentation":"The static map's Etag.
", + "location":"header", + "locationName":"ETag" + }, + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the request is charged at.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + } + }, + "payload":"Blob" + }, + "GetStyleDescriptorRequest":{ + "type":"structure", + "required":["Style"], + "members":{ + "Style":{ + "shape":"MapStyle", + "documentation":"Style specifies the desired map style.
", + "location":"uri", + "locationName":"Style" + }, + "ColorScheme":{ + "shape":"ColorScheme", + "documentation":"Sets color tone for map such as dark and light for specific map styles. It applies to only vector map styles such as Standard and Monochrome.
Example: Light
Default value: Light
Valid values for ColorScheme are case sensitive.
Specifies the political view using ISO 3166-2 or ISO 3166-3 country code format.
The following political views are currently supported:
ARG: Argentina's view on the Southern Patagonian Ice Field and Tierra Del Fuego, including the Falkland Islands, South Georgia, and South Sandwich Islands
EGY: Egypt's view on Bir Tawil
IND: India's view on Gilgit-Baltistan
KEN: Kenya's view on the Ilemi Triangle
MAR: Morocco's view on Western Sahara
PAK: Pakistan's view on Jammu and Kashmir and the Junagadh Area
RUS: Russia's view on Crimea
SDN: Sudan's view on the Halaib Triangle
SRB: Serbia's view on Kosovo, Vukovar, and Sarengrad Islands
SUR: Suriname's view on the Courantyne Headwaters and Lawa Headwaters
SYR: Syria's view on the Golan Heights
TUR: Turkey's view on Cyprus and Northern Cyprus
TZA: Tanzania's view on Lake Malawi
URY: Uruguay's view on Rincon de Artigas
VNM: Vietnam's view on the Paracel Islands and Spratly Islands
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + } + } + }, + "GetStyleDescriptorResponse":{ + "type":"structure", + "members":{ + "Blob":{ + "shape":"Blob", + "documentation":"This Blob contains the body of the style descriptor which is in application/json format.
" + }, + "ContentType":{ + "shape":"String", + "documentation":"Header that represents the format of the response. The response returns the following as the HTTP body.
", + "location":"header", + "locationName":"Content-Type" + }, + "CacheControl":{ + "shape":"String", + "documentation":"Header that instructs caching configuration for the client.
", + "location":"header", + "locationName":"Cache-Control" + }, + "ETag":{ + "shape":"String", + "documentation":"The style descriptor's Etag.
", + "location":"header", + "locationName":"ETag" + } + }, + "payload":"Blob" + }, + "GetTileRequest":{ + "type":"structure", + "required":[ + "Tileset", + "Z", + "X", + "Y" + ], + "members":{ + "Tileset":{ + "shape":"Tileset", + "documentation":"Specifies the desired tile set.
Valid Values: raster.satellite | vector.basemap
The zoom value for the map tile.
", + "location":"uri", + "locationName":"Z" + }, + "X":{ + "shape":"GetTileRequestXString", + "documentation":"The X axis value for the map tile. Must be between 0 and 19.
", + "location":"uri", + "locationName":"X" + }, + "Y":{ + "shape":"GetTileRequestYString", + "documentation":"The Y axis value for the map tile.
", + "location":"uri", + "locationName":"Y" + }, + "Key":{ + "shape":"ApiKey", + "documentation":"Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + } + } + }, + "GetTileRequestXString":{ + "type":"string", + "pattern":".*\\d+.*" + }, + "GetTileRequestYString":{ + "type":"string", + "pattern":".*\\d+.*" + }, + "GetTileRequestZString":{ + "type":"string", + "pattern":".*\\d+.*" + }, + "GetTileResponse":{ + "type":"structure", + "required":["PricingBucket"], + "members":{ + "Blob":{ + "shape":"Blob", + "documentation":"The blob represents a vector tile in mvt format for the GetTile API.
Header that represents the format of the response. The response returns the following as the HTTP body.
", + "location":"header", + "locationName":"Content-Type" + }, + "CacheControl":{ + "shape":"String", + "documentation":"Header that instructs caching configuration for the client.
", + "location":"header", + "locationName":"Cache-Control" + }, + "ETag":{ + "shape":"String", + "documentation":"The pricing bucket for which the request is charged at.
", + "location":"header", + "locationName":"ETag" + }, + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the request is charged at.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + } + }, + "payload":"Blob" + }, + "Integer":{ + "type":"integer", + "box":true + }, + "InternalServerException":{ + "type":"structure", + "required":["Message"], + "members":{ + "Message":{ + "shape":"String", + "locationName":"message" + } + }, + "documentation":"The request processing has failed because of an unknown error, exception or failure.
", + "error":{"httpStatusCode":500}, + "exception":true, + "fault":true, + "retryable":{"throttling":false} + }, + "MapStyle":{ + "type":"string", + "enum":[ + "Standard", + "Monochrome", + "Hybrid", + "Satellite" + ] + }, + "PositionListString":{ + "type":"string", + "min":7, + "pattern":"(-?\\d{1,3}(\\.\\d{1,14})?,-?\\d{1,2}(\\.\\d{1,14})?)(,(-?\\d{1,3}(\\.\\d{1,14})?,-?\\d{1,2}(\\.\\d{1,14})?))*" + }, + "PositionString":{ + "type":"string", + "max":36, + "min":3, + "pattern":"-?\\d{1,3}(\\.\\d{1,14})?,-?\\d{1,2}(\\.\\d{1,14})?" + }, + "ScaleBarUnit":{ + "type":"string", + "enum":[ + "Kilometers", + "KilometersMiles", + "Miles", + "MilesKilometers" + ] + }, + "StaticMapStyle":{ + "type":"string", + "enum":["Satellite"] + }, + "String":{"type":"string"}, + "ThrottlingException":{ + "type":"structure", + "required":["Message"], + "members":{ + "Message":{ + "shape":"String", + "locationName":"message" + } + }, + "documentation":"The request was denied due to request throttling.
", + "error":{ + "httpStatusCode":429, + "senderFault":true + }, + "exception":true, + "retryable":{"throttling":false} + }, + "Tileset":{ + "type":"string", + "max":100, + "min":1, + "pattern":"[-.\\w]+" + }, + "ValidationException":{ + "type":"structure", + "required":[ + "Message", + "Reason", + "FieldList" + ], + "members":{ + "Message":{ + "shape":"String", + "locationName":"message" + }, + "Reason":{ + "shape":"ValidationExceptionReason", + "documentation":"The field where thebb invalid entry was detected.
", + "locationName":"reason" + }, + "FieldList":{ + "shape":"ValidationExceptionFieldList", + "documentation":"A message with the reason for the validation exception error.
", + "locationName":"fieldList" + } + }, + "documentation":"The input fails to satisfy the constraints specified by an AWS service.
", + "error":{ + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, + "ValidationExceptionField":{ + "type":"structure", + "required":[ + "Name", + "Message" + ], + "members":{ + "Name":{ + "shape":"String", + "documentation":"The name of the resource.
", + "locationName":"name" + }, + "Message":{ + "shape":"String", + "documentation":"The error message.
", + "locationName":"message" + } + }, + "documentation":"The input fails to satisfy the constraints specified by the Amazon Location service.
" + }, + "ValidationExceptionFieldList":{ + "type":"list", + "member":{"shape":"ValidationExceptionField"} + }, + "ValidationExceptionReason":{ + "type":"string", + "enum":[ + "UnknownOperation", + "Missing", + "CannotParse", + "FieldValidationFailed", + "Other", + "UnknownField" + ] + }, + "Variant":{ + "type":"string", + "enum":["Default"] + } + }, + "documentation":"Integrate high-quality base map data into your applications using MapLibre. Capabilities include:
Access to comprehensive base map data, allowing you to tailor the map display to your specific needs.
Multiple pre-designed map styles suited for various application types, such as navigation, logistics, or data visualization.
Generation of static map images for scenarios where interactive maps aren't suitable, such as:
Embedding in emails or documents
Displaying in low-bandwidth environments
Creating printable maps
Enhancing application performance by reducing client-side rendering
The CreateKeyspace operation adds a new keyspace to your account. In an Amazon Web Services account, keyspace names must be unique within each Region.
CreateKeyspace is an asynchronous operation. You can monitor the creation status of the new keyspace by using the GetKeyspace operation.
For more information, see Creating keyspaces in the Amazon Keyspaces Developer Guide.
" + "documentation":"The CreateKeyspace operation adds a new keyspace to your account. In an Amazon Web Services account, keyspace names must be unique within each Region.
CreateKeyspace is an asynchronous operation. You can monitor the creation status of the new keyspace by using the GetKeyspace operation.
For more information, see Create a keyspace in the Amazon Keyspaces Developer Guide.
" }, "CreateTable":{ "name":"CreateTable", @@ -46,7 +48,25 @@ {"shape":"AccessDeniedException"}, {"shape":"ResourceNotFoundException"} ], - "documentation":"The CreateTable operation adds a new table to the specified keyspace. Within a keyspace, table names must be unique.
CreateTable is an asynchronous operation. When the request is received, the status of the table is set to CREATING. You can monitor the creation status of the new table by using the GetTable operation, which returns the current status of the table. You can start using a table when the status is ACTIVE.
For more information, see Creating tables in the Amazon Keyspaces Developer Guide.
" + "documentation":"The CreateTable operation adds a new table to the specified keyspace. Within a keyspace, table names must be unique.
CreateTable is an asynchronous operation. When the request is received, the status of the table is set to CREATING. You can monitor the creation status of the new table by using the GetTable operation, which returns the current status of the table. You can start using a table when the status is ACTIVE.
For more information, see Create a table in the Amazon Keyspaces Developer Guide.
" + }, + "CreateType":{ + "name":"CreateType", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateTypeRequest"}, + "output":{"shape":"CreateTypeResponse"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"ServiceQuotaExceededException"}, + {"shape":"InternalServerException"}, + {"shape":"ConflictException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ResourceNotFoundException"} + ], + "documentation":" The CreateType operation creates a new user-defined type in the specified keyspace.
For more information, see User-defined types (UDTs) in the Amazon Keyspaces Developer Guide.
" }, "DeleteKeyspace":{ "name":"DeleteKeyspace", @@ -84,6 +104,24 @@ ], "documentation":"The DeleteTable operation deletes a table and all of its data. After a DeleteTable request is received, the specified table is in the DELETING state until Amazon Keyspaces completes the deletion. If the table is in the ACTIVE state, you can delete it. If a table is either in the CREATING or UPDATING states, then Amazon Keyspaces returns a ResourceInUseException. If the specified table does not exist, Amazon Keyspaces returns a ResourceNotFoundException. If the table is already in the DELETING state, no error is returned.
The DeleteType operation deletes a user-defined type (UDT). You can only delete a type that is not used in a table or another UDT.
Returns information about the table, including the table's name and current status, the keyspace name, configuration settings, and metadata.
To read table metadata using GetTable, Select action permissions for the table and system tables are required to complete the operation.
Returns information about the table, including the table's name and current status, the keyspace name, configuration settings, and metadata.
To read table metadata using GetTable, the IAM principal needs Select action permissions for the table and the system keyspace.
Returns auto scaling related settings of the specified table in JSON format. If the table is a multi-Region table, the Amazon Web Services Region specific auto scaling settings of the table are included.
Amazon Keyspaces auto scaling helps you provision throughput capacity for variable workloads efficiently by increasing and decreasing your table's read and write capacity automatically in response to application traffic. For more information, see Managing throughput capacity automatically with Amazon Keyspaces auto scaling in the Amazon Keyspaces Developer Guide.
GetTableAutoScalingSettings can't be used as an action in an IAM policy.
To define permissions for GetTableAutoScalingSettings, you must allow the following two actions in the IAM policy statement's Action element:
application-autoscaling:DescribeScalableTargets
application-autoscaling:DescribeScalingPolicies
The GetType operation returns information about the type, for example the field definitions, the timestamp when the type was last modified, the level of nesting, the status, and details about if the type is used in other types and tables.
To read keyspace metadata using GetType, the IAM principal needs Select action permissions for the system keyspace.
Returns a list of keyspaces.
" + "documentation":"The ListKeyspaces operation returns a list of keyspaces.
Returns a list of tables for a specified keyspace.
" + "documentation":"The ListTables operation returns a list of tables for a specified keyspace.
To read keyspace metadata using ListTables, the IAM principal needs Select action permissions for the system keyspace.
Returns a list of all tags associated with the specified Amazon Keyspaces resource.
" + "documentation":"Returns a list of all tags associated with the specified Amazon Keyspaces resource.
To read keyspace metadata using ListTagsForResource, the IAM principal needs Select action permissions for the specified resource and the system keyspace.
The ListTypes operation returns a list of types for a specified keyspace.
To read keyspace metadata using ListTypes, the IAM principal needs Select action permissions for the system keyspace.
The name of the keyspace.
" + }, + "typeName":{ + "shape":"TypeName", + "documentation":"The name of the user-defined type.
UDT names must contain 48 characters or less, must begin with an alphabetic character, and can only contain alpha-numeric characters and underscores. Amazon Keyspaces converts upper case characters automatically into lower case characters.
Alternatively, you can declare a UDT name in double quotes. When declaring a UDT name inside double quotes, Amazon Keyspaces preserves upper casing and allows special characters.
You can also use double quotes as part of the name when you create the UDT, but you must escape each double quote character with an additional double quote character.
" + }, + "fieldDefinitions":{ + "shape":"FieldList", + "documentation":"The field definitions, consisting of names and types, that define this type.
" + } + } + }, + "CreateTypeResponse":{ + "type":"structure", + "required":[ + "keyspaceArn", + "typeName" + ], + "members":{ + "keyspaceArn":{ + "shape":"ARN", + "documentation":"The unique identifier of the keyspace that contains the new type in the format of an Amazon Resource Name (ARN).
" + }, + "typeName":{ + "shape":"TypeName", + "documentation":" The formatted name of the user-defined type that was created. Note that Amazon Keyspaces requires the formatted name of the type for other operations, for example GetType.
The name of the keyspace of the to be deleted type.
" + }, + "typeName":{ + "shape":"TypeName", + "documentation":"The name of the type to be deleted.
" + } + } + }, + "DeleteTypeResponse":{ + "type":"structure", + "required":[ + "keyspaceArn", + "typeName" + ], + "members":{ + "keyspaceArn":{ + "shape":"ARN", + "documentation":"The unique identifier of the keyspace from which the type was deleted in the format of an Amazon Resource Name (ARN).
" + }, + "typeName":{ + "shape":"TypeName", + "documentation":"The name of the type that was deleted.
" + } + } + }, + "Depth":{"type":"integer"}, "DoubleObject":{"type":"double"}, "EncryptionSpecification":{ "type":"structure", @@ -618,6 +765,34 @@ "AWS_OWNED_KMS_KEY" ] }, + "FieldDefinition":{ + "type":"structure", + "required":[ + "name", + "type" + ], + "members":{ + "name":{ + "shape":"FieldDefinitionNameString", + "documentation":"The identifier.
" + }, + "type":{ + "shape":"GenericString", + "documentation":"Any supported Cassandra data type, including collections and other user-defined types that are contained in the same keyspace.
For more information, see Cassandra data type support in the Amazon Keyspaces Developer Guide.
" + } + }, + "documentation":"A field definition consists out of a name and a type.
" + }, + "FieldDefinitionNameString":{ + "type":"string", + "max":128, + "min":1 + }, + "FieldList":{ + "type":"list", + "member":{"shape":"FieldDefinition"}, + "min":1 + }, "GenericString":{"type":"string"}, "GetKeyspaceRequest":{ "type":"structure", @@ -785,6 +960,69 @@ } } }, + "GetTypeRequest":{ + "type":"structure", + "required":[ + "keyspaceName", + "typeName" + ], + "members":{ + "keyspaceName":{ + "shape":"KeyspaceName", + "documentation":"The name of the keyspace that contains this type.
" + }, + "typeName":{ + "shape":"TypeName", + "documentation":"The formatted name of the type. For example, if the name of the type was created without double quotes, Amazon Keyspaces saved the name in lower-case characters. If the name was created in double quotes, you must use double quotes to specify the type name.
" + } + } + }, + "GetTypeResponse":{ + "type":"structure", + "required":[ + "keyspaceName", + "typeName", + "keyspaceArn" + ], + "members":{ + "keyspaceName":{ + "shape":"KeyspaceName", + "documentation":"The name of the keyspace that contains this type.
" + }, + "typeName":{ + "shape":"TypeName", + "documentation":"The name of the type.
" + }, + "fieldDefinitions":{ + "shape":"FieldList", + "documentation":"The names and types that define this type.
" + }, + "lastModifiedTimestamp":{ + "shape":"Timestamp", + "documentation":"The timestamp that shows when this type was last modified.
" + }, + "status":{ + "shape":"TypeStatus", + "documentation":"The status of this type.
" + }, + "directReferringTables":{ + "shape":"TableNameList", + "documentation":"The tables that use this type.
" + }, + "directParentTypes":{ + "shape":"TypeNameList", + "documentation":"The types that use this type.
" + }, + "maxNestingDepth":{ + "shape":"Depth", + "documentation":"The level of nesting implemented for this type.
" + }, + "keyspaceArn":{ + "shape":"ARN", + "documentation":"The unique identifier of the keyspace that contains this type in the format of an Amazon Resource Name (ARN).
" + } + } + }, "IntegerObject":{"type":"integer"}, "InternalServerException":{ "type":"structure", @@ -924,6 +1162,38 @@ } } }, + "ListTypesRequest":{ + "type":"structure", + "required":["keyspaceName"], + "members":{ + "nextToken":{ + "shape":"NextToken", + "documentation":" The pagination token. To resume pagination, provide the NextToken value as an argument of a subsequent API invocation.
The total number of types to return in the output. If the total number of types available is more than the value specified, a NextToken is provided in the output. To resume pagination, provide the NextToken value as an argument of a subsequent API invocation.
The name of the keyspace that contains the listed types.
" + } + } + }, + "ListTypesResponse":{ + "type":"structure", + "required":["types"], + "members":{ + "nextToken":{ + "shape":"NextToken", + "documentation":" The pagination token. To resume pagination, provide the NextToken value as an argument of a subsequent API invocation.
The list of types contained in the specified keyspace.
" + } + } + }, "MaxResults":{ "type":"integer", "box":true, @@ -1077,10 +1347,10 @@ }, "resourceArn":{ "shape":"ARN", - "documentation":"The unique identifier in the format of Amazon Resource Name (ARN), for the resource not found.
" + "documentation":"The unique identifier in the format of Amazon Resource Name (ARN) for the resource could't be found.
" } }, - "documentation":"The operation tried to access a keyspace or table that doesn't exist. The resource might not be specified correctly, or its status might not be ACTIVE.
The operation tried to access a keyspace, table, or type that doesn't exist. The resource might not be specified correctly, or its status might not be ACTIVE.
Creates a new Amazon ECS cluster. By default, your account receives a default cluster when you launch your first container instance. However, you can create your own cluster with a unique name.
When you call the CreateCluster API operation, Amazon ECS attempts to create the Amazon ECS service-linked role for your account. This is so that it can manage required resources in other Amazon Web Services services on your behalf. However, if the user that makes the call doesn't have permissions to create the service-linked role, it isn't created. For more information, see Using service-linked roles for Amazon ECS in the Amazon Elastic Container Service Developer Guide.
Creates a new Amazon ECS cluster. By default, your account receives a default cluster when you launch your first container instance. However, you can create your own cluster with a unique name.
When you call the CreateCluster API operation, Amazon ECS attempts to create the Amazon ECS service-linked role for your account. This is so that it can manage required resources in other Amazon Web Services services on your behalf. However, if the user that makes the call doesn't have permissions to create the service-linked role, it isn't created. For more information, see Using service-linked roles for Amazon ECS in the Amazon Elastic Container Service Developer Guide.
Runs and maintains your desired number of tasks from a specified task definition. If the number of tasks running in a service drops below the desiredCount, Amazon ECS runs another copy of the task in the specified cluster. To update an existing service, use UpdateService.
On March 21, 2024, a change was made to resolve the task definition revision before authorization. When a task definition revision is not specified, authorization will occur using the latest revision of a task definition.
Amazon Elastic Inference (EI) is no longer available to customers.
In addition to maintaining the desired count of tasks in your service, you can optionally run your service behind one or more load balancers. The load balancers distribute traffic across the tasks that are associated with the service. For more information, see Service load balancing in the Amazon Elastic Container Service Developer Guide.
You can attach Amazon EBS volumes to Amazon ECS tasks by configuring the volume when creating or updating a service. volumeConfigurations is only supported for REPLICA service and not DAEMON service. For more infomation, see Amazon EBS volumes in the Amazon Elastic Container Service Developer Guide.
Tasks for services that don't use a load balancer are considered healthy if they're in the RUNNING state. Tasks for services that use a load balancer are considered healthy if they're in the RUNNING state and are reported as healthy by the load balancer.
There are two service scheduler strategies available:
REPLICA - The replica scheduling strategy places and maintains your desired number of tasks across your cluster. By default, the service scheduler spreads tasks across Availability Zones. You can use task placement strategies and constraints to customize task placement decisions. For more information, see Service scheduler concepts in the Amazon Elastic Container Service Developer Guide.
DAEMON - The daemon scheduling strategy deploys exactly one task on each active container instance that meets all of the task placement constraints that you specify in your cluster. The service scheduler also evaluates the task placement constraints for running tasks. It also stops tasks that don't meet the placement constraints. When using this strategy, you don't need to specify a desired number of tasks, a task placement strategy, or use Service Auto Scaling policies. For more information, see Service scheduler concepts in the Amazon Elastic Container Service Developer Guide.
You can optionally specify a deployment configuration for your service. The deployment is initiated by changing properties. For example, the deployment might be initiated by the task definition or by your desired count of a service. You can use UpdateService. The default value for a replica service for minimumHealthyPercent is 100%. The default value for a daemon service for minimumHealthyPercent is 0%.
If a service uses the ECS deployment controller, the minimum healthy percent represents a lower limit on the number of tasks in a service that must remain in the RUNNING state during a deployment. Specifically, it represents it as a percentage of your desired number of tasks (rounded up to the nearest integer). This happens when any of your container instances are in the DRAINING state if the service contains tasks using the EC2 launch type. Using this parameter, you can deploy without using additional cluster capacity. For example, if you set your service to have desired number of four tasks and a minimum healthy percent of 50%, the scheduler might stop two existing tasks to free up cluster capacity before starting two new tasks. If they're in the RUNNING state, tasks for services that don't use a load balancer are considered healthy . If they're in the RUNNING state and reported as healthy by the load balancer, tasks for services that do use a load balancer are considered healthy . The default value for minimum healthy percent is 100%.
If a service uses the ECS deployment controller, the maximum percent parameter represents an upper limit on the number of tasks in a service that are allowed in the RUNNING or PENDING state during a deployment. Specifically, it represents it as a percentage of the desired number of tasks (rounded down to the nearest integer). This happens when any of your container instances are in the DRAINING state if the service contains tasks using the EC2 launch type. Using this parameter, you can define the deployment batch size. For example, if your service has a desired number of four tasks and a maximum percent value of 200%, the scheduler may start four new tasks before stopping the four older tasks (provided that the cluster resources required to do this are available). The default value for maximum percent is 200%.
If a service uses either the CODE_DEPLOY or EXTERNAL deployment controller types and tasks that use the EC2 launch type, the minimum healthy percent and maximum percent values are used only to define the lower and upper limit on the number of the tasks in the service that remain in the RUNNING state. This is while the container instances are in the DRAINING state. If the tasks in the service use the Fargate launch type, the minimum healthy percent and maximum percent values aren't used. This is the case even if they're currently visible when describing your service.
When creating a service that uses the EXTERNAL deployment controller, you can specify only parameters that aren't controlled at the task set level. The only required parameter is the service name. You control your services using the CreateTaskSet. For more information, see Amazon ECS deployment types in the Amazon Elastic Container Service Developer Guide.
When the service scheduler launches new tasks, it determines task placement. For information about task placement and task placement strategies, see Amazon ECS task placement in the Amazon Elastic Container Service Developer Guide
" + "documentation":"Runs and maintains your desired number of tasks from a specified task definition. If the number of tasks running in a service drops below the desiredCount, Amazon ECS runs another copy of the task in the specified cluster. To update an existing service, see the UpdateService action.
On March 21, 2024, a change was made to resolve the task definition revision before authorization. When a task definition revision is not specified, authorization will occur using the latest revision of a task definition.
Amazon Elastic Inference (EI) is no longer available to customers.
In addition to maintaining the desired count of tasks in your service, you can optionally run your service behind one or more load balancers. The load balancers distribute traffic across the tasks that are associated with the service. For more information, see Service load balancing in the Amazon Elastic Container Service Developer Guide.
You can attach Amazon EBS volumes to Amazon ECS tasks by configuring the volume when creating or updating a service. volumeConfigurations is only supported for REPLICA service and not DAEMON service. For more infomation, see Amazon EBS volumes in the Amazon Elastic Container Service Developer Guide.
Tasks for services that don't use a load balancer are considered healthy if they're in the RUNNING state. Tasks for services that use a load balancer are considered healthy if they're in the RUNNING state and are reported as healthy by the load balancer.
There are two service scheduler strategies available:
REPLICA - The replica scheduling strategy places and maintains your desired number of tasks across your cluster. By default, the service scheduler spreads tasks across Availability Zones. You can use task placement strategies and constraints to customize task placement decisions. For more information, see Service scheduler concepts in the Amazon Elastic Container Service Developer Guide.
DAEMON - The daemon scheduling strategy deploys exactly one task on each active container instance that meets all of the task placement constraints that you specify in your cluster. The service scheduler also evaluates the task placement constraints for running tasks. It also stops tasks that don't meet the placement constraints. When using this strategy, you don't need to specify a desired number of tasks, a task placement strategy, or use Service Auto Scaling policies. For more information, see Service scheduler concepts in the Amazon Elastic Container Service Developer Guide.
You can optionally specify a deployment configuration for your service. The deployment is initiated by changing properties. For example, the deployment might be initiated by the task definition or by your desired count of a service. You can use UpdateService. The default value for a replica service for minimumHealthyPercent is 100%. The default value for a daemon service for minimumHealthyPercent is 0%.
If a service uses the ECS deployment controller, the minimum healthy percent represents a lower limit on the number of tasks in a service that must remain in the RUNNING state during a deployment. Specifically, it represents it as a percentage of your desired number of tasks (rounded up to the nearest integer). This happens when any of your container instances are in the DRAINING state if the service contains tasks using the EC2 launch type. Using this parameter, you can deploy without using additional cluster capacity. For example, if you set your service to have desired number of four tasks and a minimum healthy percent of 50%, the scheduler might stop two existing tasks to free up cluster capacity before starting two new tasks. If they're in the RUNNING state, tasks for services that don't use a load balancer are considered healthy . If they're in the RUNNING state and reported as healthy by the load balancer, tasks for services that do use a load balancer are considered healthy . The default value for minimum healthy percent is 100%.
If a service uses the ECS deployment controller, the maximum percent parameter represents an upper limit on the number of tasks in a service that are allowed in the RUNNING or PENDING state during a deployment. Specifically, it represents it as a percentage of the desired number of tasks (rounded down to the nearest integer). This happens when any of your container instances are in the DRAINING state if the service contains tasks using the EC2 launch type. Using this parameter, you can define the deployment batch size. For example, if your service has a desired number of four tasks and a maximum percent value of 200%, the scheduler may start four new tasks before stopping the four older tasks (provided that the cluster resources required to do this are available). The default value for maximum percent is 200%.
If a service uses either the CODE_DEPLOY or EXTERNAL deployment controller types and tasks that use the EC2 launch type, the minimum healthy percent and maximum percent values are used only to define the lower and upper limit on the number of the tasks in the service that remain in the RUNNING state. This is while the container instances are in the DRAINING state. If the tasks in the service use the Fargate launch type, the minimum healthy percent and maximum percent values aren't used. This is the case even if they're currently visible when describing your service.
When creating a service that uses the EXTERNAL deployment controller, you can specify only parameters that aren't controlled at the task set level. The only required parameter is the service name. You control your services using the CreateTaskSet. For more information, see Amazon ECS deployment types in the Amazon Elastic Container Service Developer Guide.
When the service scheduler launches new tasks, it determines task placement. For information about task placement and task placement strategies, see Amazon ECS task placement in the Amazon Elastic Container Service Developer Guide
" }, "CreateTaskSet":{ "name":"CreateTaskSet", @@ -288,6 +288,44 @@ ], "documentation":"Describes one or more container instances. Returns metadata about each container instance requested.
" }, + "DescribeServiceDeployments":{ + "name":"DescribeServiceDeployments", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeServiceDeploymentsRequest"}, + "output":{"shape":"DescribeServiceDeploymentsResponse"}, + "errors":[ + {"shape":"AccessDeniedException"}, + {"shape":"ClientException"}, + {"shape":"ClusterNotFoundException"}, + {"shape":"InvalidParameterException"}, + {"shape":"ServerException"}, + {"shape":"ServiceNotFoundException"}, + {"shape":"UnsupportedFeatureException"} + ], + "documentation":"Describes one or more of your service deployments.
A service deployment happens when you release a software update for the service. For more information, see Amazon ECS service deployments.
" + }, + "DescribeServiceRevisions":{ + "name":"DescribeServiceRevisions", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeServiceRevisionsRequest"}, + "output":{"shape":"DescribeServiceRevisionsResponse"}, + "errors":[ + {"shape":"AccessDeniedException"}, + {"shape":"ClientException"}, + {"shape":"ClusterNotFoundException"}, + {"shape":"InvalidParameterException"}, + {"shape":"ServerException"}, + {"shape":"ServiceNotFoundException"}, + {"shape":"UnsupportedFeatureException"} + ], + "documentation":"Describes one or more service revisions.
A service revision is a version of the service that includes the values for the Amazon ECS resources (for example, task definition) and the environment resources (for example, load balancers, subnets, and security groups). For more information, see Amazon ECS service revisions.
You can't describe a service revision that was created before October 25, 2024.
" + }, "DescribeServices":{ "name":"DescribeServices", "http":{ @@ -466,6 +504,24 @@ ], "documentation":"Returns a list of container instances in a specified cluster. You can filter the results of a ListContainerInstances operation with cluster query language statements inside the filter parameter. For more information, see Cluster Query Language in the Amazon Elastic Container Service Developer Guide.
This operation lists all the service deployments that meet the specified filter criteria.
A service deployment happens when you release a softwre update for the service. You route traffic from the running service revisions to the new service revison and control the number of running tasks.
This API returns the values that you use for the request parameters in DescribeServiceRevisions.
" + }, "ListServices":{ "name":"ListServices", "http":{ @@ -1752,6 +1808,28 @@ }, "documentation":"The dependencies defined for container startup and shutdown. A container can contain multiple dependencies. When a dependency is defined for container startup, for container shutdown it is reversed.
Your Amazon ECS container instances require at least version 1.26.0 of the container agent to use container dependencies. However, we recommend using the latest container agent version. For information about checking your agent version and updating to the latest version, see Updating the Amazon ECS Container Agent in the Amazon Elastic Container Service Developer Guide. If you're using an Amazon ECS-optimized Linux AMI, your instance needs at least version 1.26.0-1 of the ecs-init package. If your container instances are launched from version 20190301 or later, then they contain the required versions of the container agent and ecs-init. For more information, see Amazon ECS-optimized Linux AMI in the Amazon Elastic Container Service Developer Guide.
For tasks that use the Fargate launch type, the task or service requires the following platforms:
Linux platform version 1.3.0 or later.
Windows platform version 1.0.0 or later.
For more information about how to create a container dependency, see Container dependency in the Amazon Elastic Container Service Developer Guide.
" }, + "ContainerImage":{ + "type":"structure", + "members":{ + "containerName":{ + "shape":"String", + "documentation":"The name of the container.
" + }, + "imageDigest":{ + "shape":"String", + "documentation":"The container image digest.
" + }, + "image":{ + "shape":"String", + "documentation":"The container image.
" + } + }, + "documentation":"The details about the container image a service revision uses.
To ensure that all tasks in a service use the same container image, Amazon ECS resolves container image names and any image tags specified in the task definition to container image digests.
After the container image digest has been established, Amazon ECS uses the digest to start any other desired tasks, and for any future service and service revision updates. This leads to all tasks in a service always running identical container images, resulting in version consistency for your software. For more information, see Container image resolution in the Amazon ECS Developer Guide.
" + }, + "ContainerImages":{ + "type":"list", + "member":{"shape":"ContainerImage"} + }, "ContainerInstance":{ "type":"structure", "members":{ @@ -2094,7 +2172,7 @@ }, "deploymentConfiguration":{ "shape":"DeploymentConfiguration", - "documentation":"Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks.
" + "documentation":"Optional deployment parameters that control how many tasks run during the deployment and the failure detection methods.
" }, "placementConstraints":{ "shape":"PlacementConstraints", @@ -2226,6 +2304,20 @@ } } }, + "CreatedAt":{ + "type":"structure", + "members":{ + "before":{ + "shape":"Timestamp", + "documentation":"Include service deployments in the result that were created before this time. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
" + }, + "after":{ + "shape":"Timestamp", + "documentation":"Include service deployments in the result that were created after this time. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
" + } + }, + "documentation":"The optional filter to narrow the ListServiceDeployment results.
If you do not specify a value, service deployments that were created before the current time are included in the result.
" + }, "DeleteAccountSettingRequest":{ "type":"structure", "required":["name"], @@ -2485,21 +2577,21 @@ "type":"structure", "required":[ "alarmNames", - "enable", - "rollback" + "rollback", + "enable" ], "members":{ "alarmNames":{ "shape":"StringList", "documentation":"One or more CloudWatch alarm names. Use a \",\" to separate the alarms.
" }, - "enable":{ - "shape":"Boolean", - "documentation":"Determines whether to use the CloudWatch alarm option in the service deployment process.
" - }, "rollback":{ "shape":"Boolean", "documentation":"Determines whether to configure Amazon ECS to roll back the service if a service deployment fails. If rollback is used, when a service deployment fails, the service is rolled back to the last deployment that completed successfully.
" + }, + "enable":{ + "shape":"Boolean", + "documentation":"Determines whether to use the CloudWatch alarm option in the service deployment process.
" } }, "documentation":"One of the methods which provide a way for you to quickly identify when a deployment has failed, and then to optionally roll back the failure to the last working deployment.
When the alarms are generated, Amazon ECS sets the service deployment to failed. Set the rollback parameter to have Amazon ECS to roll back your service to the last completed deployment after a failure.
You can only use the DeploymentAlarms method to detect failures when the DeploymentController is set to ECS (rolling update).
For more information, see Rolling update in the Amazon Elastic Container Service Developer Guide .
" @@ -2542,7 +2634,7 @@ "documentation":"Information about the CloudWatch alarms.
" } }, - "documentation":"Optional deployment parameters that control how many tasks run during a deployment and the ordering of stopping and starting tasks.
" + "documentation":"Optional deployment parameters that control how many tasks run during the deployment and the failure detection methods.
" }, "DeploymentController":{ "type":"structure", @@ -2568,7 +2660,7 @@ "members":{ "kmsKeyId":{ "shape":"String", - "documentation":"Specify an Key Management Service key ID to encrypt the ephemeral storage for deployment.
" + "documentation":"Specify an Amazon Web Services Key Management Service key ID to encrypt the ephemeral storage for deployment.
" } }, "documentation":"The amount of ephemeral storage to allocate for the deployment.
" @@ -2726,6 +2818,52 @@ } } }, + "DescribeServiceDeploymentsRequest":{ + "type":"structure", + "required":["serviceDeploymentArns"], + "members":{ + "serviceDeploymentArns":{ + "shape":"StringList", + "documentation":"The ARN of the service deployment.
You can specify a maximum of 20 ARNs.
" + } + } + }, + "DescribeServiceDeploymentsResponse":{ + "type":"structure", + "members":{ + "serviceDeployments":{ + "shape":"ServiceDeployments", + "documentation":"The list of service deployments described.
" + }, + "failures":{ + "shape":"Failures", + "documentation":"Any failures associated with the call.
If you decsribe a deployment with a service revision created before October 25, 2024, the call fails. The failure includes the service revision ARN and the reason set to MISSING.
The ARN of the service revision.
You can specify a maximum of 20 ARNs.
You can call ListServiceDeployments to get the ARNs.
" + } + } + }, + "DescribeServiceRevisionsResponse":{ + "type":"structure", + "members":{ + "serviceRevisions":{ + "shape":"ServiceRevisions", + "documentation":"The list of service revisions described.
" + }, + "failures":{ + "shape":"Failures", + "documentation":"Any failures associated with the call.
" + } + } + }, "DescribeServicesRequest":{ "type":"structure", "required":["services"], @@ -3715,6 +3853,49 @@ } } }, + "ListServiceDeploymentsRequest":{ + "type":"structure", + "required":["service"], + "members":{ + "service":{ + "shape":"String", + "documentation":"The ARN or name of the service
" + }, + "cluster":{ + "shape":"String", + "documentation":"The cluster that hosts the service. This can either be the cluster name or ARN. Starting April 15, 2023, Amazon Web Services will not onboard new customers to Amazon Elastic Inference (EI), and will help current customers migrate their workloads to options that offer better price and performanceIf you don't specify a cluster, deault is used.
An optional filter you can use to narrow the results. If you do not specify a status, then all status values are included in the result.
" + }, + "createdAt":{ + "shape":"CreatedAt", + "documentation":"An optional filter you can use to narrow the results by the service creation date. If you do not specify a value, the result includes all services created before the current time. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
" + }, + "nextToken":{ + "shape":"String", + "documentation":"The nextToken value returned from a ListServiceDeployments request indicating that more results are available to fulfill the request and further calls are needed. If you provided maxResults, it's possible the number of results is fewer than maxResults.
The maximum number of service deployment results that ListServiceDeployments returned in paginated output. When this parameter is used, ListServiceDeployments only returns maxResults results in a single page along with a nextToken response element. The remaining results of the initial request can be seen by sending another ListServiceDeployments request with the returned nextToken value. This value can be between 1 and 100. If this parameter isn't used, then ListServiceDeployments returns up to 20 results and a nextToken value if applicable.
An overview of the service deployment, including the following properties:
The ARN of the service deployment.
The ARN of the service being deployed.
The ARN of the cluster that hosts the service in the service deployment.
The time that the service deployment started.
The time that the service deployment completed.
The service deployment status.
Information about why the service deployment is in the current state.
The ARN of the service revision that is being deployed.
The nextToken value to include in a future ListServiceDeployments request. When the results of a ListServiceDeployments request exceed maxResults, this value can be used to retrieve the next page of results. This value is null when there are no more results to return.
The name of the load balancer to associate with the Amazon ECS service or task set.
If you are using an Application Load Balancer or a Network Load Balancer the load balancer name parameter should be omitted.
" + "documentation":"The name of the load balancer to associate with the service or task set.
If you are using an Application Load Balancer or a Network Load Balancer the load balancer name parameter should be omitted.
" }, "containerName":{ "shape":"String", @@ -4074,7 +4255,7 @@ }, "minimumScalingStepSize":{ "shape":"ManagedScalingStepSize", - "documentation":"The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of 1 is used.
When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.
If you use a capacity provider with an Auto Scaling group configured with more than one Amazon EC2 instance type or Availability Zone, Amazon ECS will scale up by the exact minimum scaling step size value and will ignore both the maximum scaling step size as well as the capacity demand.
" + "documentation":"The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of 1 is used.
When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.
If you use a capacity provider with an Auto Scaling group configured with more than one Amazon EC2 instance type or Availability Zone, Amazon ECS will scale up by the exact minimum scaling step size value and will ignore both the maximum scaling step size as well as the capacity demand.
" }, "maximumScalingStepSize":{ "shape":"ManagedScalingStepSize", @@ -4114,7 +4295,7 @@ "members":{ "kmsKeyId":{ "shape":"String", - "documentation":"Specify a Key Management Service key ID to encrypt the managed storage.
" + "documentation":"Specify a Amazon Web Services Key Management Service key ID to encrypt the managed storage.
" }, "fargateEphemeralStorageKmsKeyId":{ "shape":"String", @@ -4364,7 +4545,7 @@ "members":{ "containerPort":{ "shape":"BoxedInteger", - "documentation":"The port number on the container that's bound to the user-specified or automatically assigned host port.
If you use containers in a task with the awsvpc or host network mode, specify the exposed ports using containerPort.
If you use containers in a task with the bridge network mode and you specify a container port and not a host port, your container automatically receives a host port in the ephemeral port range. For more information, see hostPort. Port mappings that are automatically assigned in this way do not count toward the 100 reserved ports limit of a container instance.
The port number on the container that's bound to the user-specified or automatically assigned host port.
For tasks that use the Fargate launch type or EC2 tasks that use the awsvpc network mode, you use containerPort to specify the exposed ports.
For Windows containers on Fargate, you can't use port 3150 for the containerPort. This is because it's reserved.
Suppose that you're using containers in a task with the EC2 launch type and you specify a container port and not a host port. Then, your container automatically receives a host port in the ephemeral port range. For more information, see hostPort. Port mappings that are automatically assigned in this way don't count toward the 100 reserved ports quota of a container instance.
The port number range on the container that's bound to the dynamically mapped host port range.
The following rules apply when you specify a containerPortRange:
You must use either the bridge network mode or the awsvpc network mode.
This parameter is available for both the EC2 and Fargate launch types.
This parameter is available for both the Linux and Windows operating systems.
The container instance must have at least version 1.67.0 of the container agent and at least version 1.67.0-1 of the ecs-init package
You can specify a maximum of 100 port ranges per container.
You do not specify a hostPortRange. The value of the hostPortRange is set as follows:
For containers in a task with the awsvpc network mode, the hostPortRange is set to the same value as the containerPortRange. This is a static mapping strategy.
For containers in a task with the bridge network mode, the Amazon ECS agent finds open host ports from the default ephemeral range and passes it to docker to bind them to the container ports.
The containerPortRange valid values are between 1 and 65535.
A port can only be included in one port mapping per container.
You cannot specify overlapping port ranges.
The first port in the range must be less than last port in the range.
Docker recommends that you turn off the docker-proxy in the Docker daemon config file when you have a large number of ports.
For more information, see Issue #11185 on the Github website.
For information about how to turn off the docker-proxy in the Docker daemon config file, see Docker daemon in the Amazon ECS Developer Guide.
You can call DescribeTasks to view the hostPortRange which are the host ports that are bound to the container ports.
Port mappings allow containers to access ports on the host container instance to send or receive traffic. Port mappings are specified as part of the container definition.
If you use containers in a task with the awsvpc or host network mode, specify the exposed ports using containerPort. The hostPort can be left blank or it must be the same value as the containerPort.
Most fields of this parameter (containerPort, hostPort, protocol) maps to PortBindings in the docker container create command and the --publish option to docker run. If the network mode of a task definition is set to host, host ports must either be undefined or match the container port in the port mapping.
You can't expose the same container port for multiple protocols. If you attempt this, an error is returned.
After a task reaches the RUNNING status, manual and automatic host and container port assignments are visible in the networkBindings section of DescribeTasks API responses.
Port mappings expose your container's network ports to the outside world. this allows clients to access your application. It's also used for inter-container communication within the same task.
For task definitions (both the Fargate and EC2 launch type) that use the awsvpc network mode, only specify the containerPort. The hostPort is always ignored, and the container port is automatically mapped to a random high-numbered port on the host.
Most fields of this parameter (containerPort, hostPort, protocol) maps to PortBindings in the docker container create command and the --publish option to docker run. If the network mode of a task definition is set to host, host ports must either be undefined or match the container port in the port mapping.
You can't expose the same container port for multiple protocols. If you attempt this, an error is returned.
After a task reaches the RUNNING status, manual and automatic host and container port assignments are visible in the networkBindings section of DescribeTasks API responses.
The Docker networking mode to use for the containers in the task. The valid values are none, bridge, awsvpc, and host. If no network mode is specified, the default is bridge.
For Amazon ECS tasks on Fargate, the awsvpc network mode is required. For Amazon ECS tasks on Amazon EC2 Linux instances, any network mode can be used. For Amazon ECS tasks on Amazon EC2 Windows instances, <default> or awsvpc can be used. If the network mode is set to none, you cannot specify port mappings in your container definitions, and the tasks containers do not have external connectivity. The host and awsvpc network modes offer the highest networking performance for containers because they use the EC2 network stack instead of the virtualized network stack provided by the bridge mode.
With the host and awsvpc network modes, exposed container ports are mapped directly to the corresponding host port (for the host network mode) or the attached elastic network interface port (for the awsvpc network mode), so you cannot take advantage of dynamic host port mappings.
When using the host network mode, you should not run containers using the root user (UID 0). It is considered best practice to use a non-root user.
If the network mode is awsvpc, the task is allocated an elastic network interface, and you must specify a NetworkConfiguration value when you create a service or run a task with the task definition. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.
If the network mode is host, you cannot run multiple instantiations of the same task on a single container instance when port mappings are used.
The Docker networking mode to use for the containers in the task. The valid values are none, bridge, awsvpc, and host. If no network mode is specified, the default is bridge.
For Amazon ECS tasks on Fargate, the awsvpc network mode is required. For Amazon ECS tasks on Amazon EC2 Linux instances, any network mode can be used. For Amazon ECS tasks on Amazon EC2 Windows instances, <default> or awsvpc can be used. If the network mode is set to none, you cannot specify port mappings in your container definitions, and the tasks containers do not have external connectivity. The host and awsvpc network modes offer the highest networking performance for containers because they use the EC2 network stack instead of the virtualized network stack provided by the bridge mode.
With the host and awsvpc network modes, exposed container ports are mapped directly to the corresponding host port (for the host network mode) or the attached elastic network interface port (for the awsvpc network mode), so you cannot take advantage of dynamic host port mappings.
When using the host network mode, you should not run containers using the root user (UID 0). It is considered best practice to use a non-root user.
If the network mode is awsvpc, the task is allocated an elastic network interface, and you must specify a NetworkConfiguration value when you create a service or run a task with the task definition. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.
If the network mode is host, you cannot run multiple instantiations of the same task on a single container instance when port mappings are used.
For more information, see Network settings in the Docker run reference.
" }, "containerDefinitions":{ "shape":"ContainerDefinitions", @@ -4669,11 +4850,11 @@ }, "pidMode":{ "shape":"PidMode", - "documentation":"The process namespace to use for the containers in the task. The valid values are host or task. On Fargate for Linux containers, the only valid value is task. For example, monitoring sidecars might need pidMode to access information about other containers running in the same task.
If host is specified, all containers within the tasks that specified the host PID mode on the same container instance share the same process namespace with the host Amazon EC2 instance.
If task is specified, all containers within the specified task share the same process namespace.
If no value is specified, the default is a private namespace for each container.
If the host PID mode is used, there's a heightened risk of undesired process namespace exposure.
This parameter is not supported for Windows containers.
This parameter is only supported for tasks that are hosted on Fargate if the tasks are using platform version 1.4.0 or later (Linux). This isn't supported for Windows containers on Fargate.
The process namespace to use for the containers in the task. The valid values are host or task. On Fargate for Linux containers, the only valid value is task. For example, monitoring sidecars might need pidMode to access information about other containers running in the same task.
If host is specified, all containers within the tasks that specified the host PID mode on the same container instance share the same process namespace with the host Amazon EC2 instance.
If task is specified, all containers within the specified task share the same process namespace.
If no value is specified, the default is a private namespace for each container. For more information, see PID settings in the Docker run reference.
If the host PID mode is used, there's a heightened risk of undesired process namespace exposure. For more information, see Docker security.
This parameter is not supported for Windows containers.
This parameter is only supported for tasks that are hosted on Fargate if the tasks are using platform version 1.4.0 or later (Linux). This isn't supported for Windows containers on Fargate.
The IPC resource namespace to use for the containers in the task. The valid values are host, task, or none. If host is specified, then all containers within the tasks that specified the host IPC mode on the same container instance share the same IPC resources with the host Amazon EC2 instance. If task is specified, all containers within the specified task share the same IPC resources. If none is specified, then IPC resources within the containers of a task are private and not shared with other containers in a task or on the container instance. If no value is specified, then the IPC resource namespace sharing depends on the Docker daemon setting on the container instance.
If the host IPC mode is used, be aware that there is a heightened risk of undesired IPC namespace expose.
If you are setting namespaced kernel parameters using systemControls for the containers in the task, the following will apply to your IPC resource namespace. For more information, see System Controls in the Amazon Elastic Container Service Developer Guide.
For tasks that use the host IPC mode, IPC namespace related systemControls are not supported.
For tasks that use the task IPC mode, IPC namespace related systemControls will apply to all containers within a task.
This parameter is not supported for Windows containers or tasks run on Fargate.
The IPC resource namespace to use for the containers in the task. The valid values are host, task, or none. If host is specified, then all containers within the tasks that specified the host IPC mode on the same container instance share the same IPC resources with the host Amazon EC2 instance. If task is specified, all containers within the specified task share the same IPC resources. If none is specified, then IPC resources within the containers of a task are private and not shared with other containers in a task or on the container instance. If no value is specified, then the IPC resource namespace sharing depends on the Docker daemon setting on the container instance. For more information, see IPC settings in the Docker run reference.
If the host IPC mode is used, be aware that there is a heightened risk of undesired IPC namespace expose. For more information, see Docker security.
If you are setting namespaced kernel parameters using systemControls for the containers in the task, the following will apply to your IPC resource namespace. For more information, see System Controls in the Amazon Elastic Container Service Developer Guide.
For tasks that use the host IPC mode, IPC namespace related systemControls are not supported.
For tasks that use the task IPC mode, IPC namespace related systemControls will apply to all containers within a task.
This parameter is not supported for Windows containers or tasks run on Fargate.
The reason the rollback happened. For example, the circuit breaker initiated the rollback operation.
" + }, + "startedAt":{ + "shape":"Timestamp", + "documentation":"Time time that the rollback started. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
" + }, + "serviceRevisionArn":{ + "shape":"String", + "documentation":"The ARN of the service revision deployed as part of the rollback.
When the type is GPU, the value is the number of physical GPUs the Amazon ECS container agent reserves for the container. The number of GPUs that's reserved for all containers in a task can't exceed the number of available GPUs on the container instance that the task is launched on.
When the type is InferenceAccelerator, the value matches the deviceName for an InferenceAccelerator specified in a task definition.
Information about the service deployment rollback.
" + }, "RunTaskRequest":{ "type":"structure", "required":["taskDefinition"], @@ -4903,11 +5102,11 @@ "members":{ "cpuArchitecture":{ "shape":"CPUArchitecture", - "documentation":"The CPU architecture.
You can run your Linux tasks on an ARM-based platform by setting the value to ARM64. This option is available for tasks that run on Linux Amazon EC2 instance or Linux containers on Fargate.
The CPU architecture.
You can run your Linux tasks on an ARM-based platform by setting the value to ARM64. This option is available for tasks that run on Linux Amazon EC2 instance or Linux containers on Fargate.
The default is X86_64.
The operating system.
" + "documentation":"The operating system.
The default is Linux.
Information about the platform for the Amazon ECS service or task.
For more information about RuntimePlatform, see RuntimePlatform in the Amazon Elastic Container Service Developer Guide.
The capacity provider strategy the service uses. When using the DescribeServices API, this field is omitted if the service was created using a launch type.
" + "documentation":"The capacity provider strategy the service uses. When using DescribeServices, this field is omitted if the service was created using a launch type.
The metadata that you apply to the service to help you categorize and organize them. Each tag consists of a key and an optional value. You define bot the key and value.
The following basic restrictions apply to tags:
Maximum number of tags per resource - 50
For each resource, each tag key must be unique, and each tag key can have only one value.
Maximum key length - 128 Unicode characters in UTF-8
Maximum value length - 256 Unicode characters in UTF-8
If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
Tag keys and values are case-sensitive.
Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for Amazon Web Services use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
The metadata that you apply to the service to help you categorize and organize them. Each tag consists of a key and an optional value. You define both the key and value.
The following basic restrictions apply to tags:
Maximum number of tags per resource - 50
For each resource, each tag key must be unique, and each tag key can have only one value.
Maximum key length - 128 Unicode characters in UTF-8
Maximum value length - 256 Unicode characters in UTF-8
If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
Tag keys and values are case-sensitive.
Do not use aws:, AWS:, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for Amazon Web Services use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
The key that encrypts and decrypts your resources for Service Connect TLS.
" }, + "ServiceDeployment":{ + "type":"structure", + "members":{ + "serviceDeploymentArn":{ + "shape":"String", + "documentation":"The ARN of the service deployment.
" + }, + "serviceArn":{ + "shape":"String", + "documentation":"The ARN of the service for this service deployment.
" + }, + "clusterArn":{ + "shape":"String", + "documentation":"The ARN of the cluster that hosts the service.
" + }, + "createdAt":{ + "shape":"Timestamp", + "documentation":"The time the service deployment was created. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
" + }, + "startedAt":{ + "shape":"Timestamp", + "documentation":"The time the service deployment statred. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
" + }, + "finishedAt":{ + "shape":"Timestamp", + "documentation":"The time the service deployment finished. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
" + }, + "stoppedAt":{ + "shape":"Timestamp", + "documentation":"The time the service deployment stopped. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
The service deployment stops when any of the following actions happen:
A user manually stops the deployment
The rollback option is not in use for the failure detection mechanism (the circuit breaker or alarm-based) and the service fails.
The time that the service deployment was last updated. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
" + }, + "sourceServiceRevisions":{ + "shape":"ServiceRevisionsSummaryList", + "documentation":"The currently deployed workload configuration.
" + }, + "targetServiceRevision":{ + "shape":"ServiceRevisionSummary", + "documentation":"The workload configuration being deployed.
" + }, + "status":{ + "shape":"ServiceDeploymentStatus", + "documentation":"The service deployment state.
" + }, + "statusReason":{ + "shape":"String", + "documentation":"Information about why the service deployment is in the current status. For example, the circuit breaker detected a failure.
" + }, + "deploymentConfiguration":{"shape":"DeploymentConfiguration"}, + "rollback":{ + "shape":"Rollback", + "documentation":"The rollback options the service deployment uses when the deployment fails.
" + }, + "deploymentCircuitBreaker":{ + "shape":"ServiceDeploymentCircuitBreaker", + "documentation":"The circuit breaker configuration that determines a service deployment failed.
" + }, + "alarms":{ + "shape":"ServiceDeploymentAlarms", + "documentation":"The CloudWatch alarms that determine when a service deployment fails.
" + } + }, + "documentation":"Information about the service deployment.
Service deployments provide a comprehensive view of your deployments. For information about service deployments, see View service history using Amazon ECS service deployments in the Amazon Elastic Container Service Developer Guide .
" + }, + "ServiceDeploymentAlarms":{ + "type":"structure", + "members":{ + "status":{ + "shape":"ServiceDeploymentRollbackMonitorsStatus", + "documentation":"The status of the alarms check. Amazon ECS is not using alarms for service deployment failures when the status is DISABLED.
The name of the CloudWatch alarms that determine when a service deployment failed. A \",\" separates the alarms.
" + }, + "triggeredAlarmNames":{ + "shape":"StringList", + "documentation":"One or more CloudWatch alarm names that have been triggered during the service deployment. A \",\" separates the alarm names.
" + } + }, + "documentation":"The CloudWatch alarms used to determine a service deployment failed.
Amazon ECS considers the service deployment as failed when any of the alarms move to the ALARM state. For more information, see How CloudWatch alarms detect Amazon ECS deployment failures in the Amazon ECS Developer Guide.
The ARN of the service deployment.
" + }, + "serviceArn":{ + "shape":"String", + "documentation":"The ARN of the service for this service deployment.
" + }, + "clusterArn":{ + "shape":"String", + "documentation":"The ARN of the cluster that hosts the service.
" + }, + "startedAt":{ + "shape":"Timestamp", + "documentation":"The time that the service deployment statred. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
" + }, + "createdAt":{ + "shape":"Timestamp", + "documentation":"The time that the service deployment was created. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
" + }, + "finishedAt":{ + "shape":"Timestamp", + "documentation":"The time that the service deployment completed. The format is yyyy-MM-dd HH:mm:ss.SSSSSS.
" + }, + "targetServiceRevisionArn":{ + "shape":"String", + "documentation":"The ARN of the service revision being deplyed.
" + }, + "status":{ + "shape":"ServiceDeploymentStatus", + "documentation":"The status of the service deployment
" + }, + "statusReason":{ + "shape":"String", + "documentation":"Information about why the service deployment is in the current status. For example, the circuit breaker detected a deployment failure.
" + } + }, + "documentation":"The service deployment properties that are retured when you call ListServiceDeployments.
This provides a high-level overview of the service deployment.
" + }, + "ServiceDeploymentCircuitBreaker":{ + "type":"structure", + "members":{ + "status":{ + "shape":"ServiceDeploymentRollbackMonitorsStatus", + "documentation":"The circuit breaker status. Amazon ECS is not using the circuit breaker for service deployment failures when the status is DISABLED.
The number of times the circuit breaker detected a service deploymeny failure.
" + }, + "threshold":{ + "shape":"Integer", + "documentation":"The threshhold which determines that the service deployment failed.
The deployment circuit breaker calculates the threshold value, and then uses the value to determine when to move the deployment to a FAILED state. The deployment circuit breaker has a minimum threshold of 3 and a maximum threshold of 200. and uses the values in the following formula to determine the deployment failure.
0.5 * desired task count
Information about the circuit breaker used to determine when a service deployment has failed.
The deployment circuit breaker is the rolling update mechanism that determines if the tasks reach a steady state. The deployment circuit breaker has an option that will automatically roll back a failed deployment to the last cpompleted service revision. For more information, see How the Amazon ECS deployment circuit breaker detects failures in the Amazon ECS Developer Guide.
" + }, + "ServiceDeploymentRollbackMonitorsStatus":{ + "type":"string", + "enum":[ + "TRIGGERED", + "MONITORING", + "MONITORING_COMPLETE", + "DISABLED" + ] + }, + "ServiceDeploymentStatus":{ + "type":"string", + "enum":[ + "PENDING", + "SUCCESSFUL", + "STOPPED", + "STOP_REQUESTED", + "IN_PROGRESS", + "ROLLBACK_IN_PROGRESS", + "ROLLBACK_SUCCESSFUL", + "ROLLBACK_FAILED" + ] + }, + "ServiceDeploymentStatusList":{ + "type":"list", + "member":{"shape":"ServiceDeploymentStatus"} + }, + "ServiceDeployments":{ + "type":"list", + "member":{"shape":"ServiceDeployment"} + }, + "ServiceDeploymentsBrief":{ + "type":"list", + "member":{"shape":"ServiceDeploymentBrief"} + }, "ServiceEvent":{ "type":"structure", "members":{ @@ -5350,6 +5728,101 @@ }, "documentation":"The details for the service registry.
Each service may be associated with one service registry. Multiple service registries for each service are not supported.
When you add, update, or remove the service registries configuration, Amazon ECS starts a new deployment. New tasks are registered and deregistered to the updated service registry configuration.
" }, + "ServiceRevision":{ + "type":"structure", + "members":{ + "serviceRevisionArn":{ + "shape":"String", + "documentation":"The ARN of the service revision.
" + }, + "serviceArn":{ + "shape":"String", + "documentation":"The ARN of the service for the service revision.
" + }, + "clusterArn":{ + "shape":"String", + "documentation":"The ARN of the cluster that hosts the service.
" + }, + "taskDefinition":{ + "shape":"String", + "documentation":"The task definition the service revision uses.
" + }, + "capacityProviderStrategy":{ + "shape":"CapacityProviderStrategy", + "documentation":"The capacity provider strategy the service revision uses.
" + }, + "launchType":{ + "shape":"LaunchType", + "documentation":"The launch type the service revision uses.
" + }, + "platformVersion":{ + "shape":"String", + "documentation":"For the Fargate launch type, the platform version the service revision uses.
" + }, + "platformFamily":{ + "shape":"String", + "documentation":"The platform family the service revision uses.
" + }, + "loadBalancers":{ + "shape":"LoadBalancers", + "documentation":"The load balancers the service revision uses.
" + }, + "serviceRegistries":{ + "shape":"ServiceRegistries", + "documentation":"The service registries (for Service Discovery) the service revision uses.
" + }, + "networkConfiguration":{"shape":"NetworkConfiguration"}, + "containerImages":{ + "shape":"ContainerImages", + "documentation":"The container images the service revision uses.
" + }, + "guardDutyEnabled":{ + "shape":"Boolean", + "documentation":"Indicates whether Runtime Monitoring is turned on.
" + }, + "serviceConnectConfiguration":{"shape":"ServiceConnectConfiguration"}, + "volumeConfigurations":{ + "shape":"ServiceVolumeConfigurations", + "documentation":"The volumes that are configured at deployment that the service revision uses.
" + }, + "fargateEphemeralStorage":{"shape":"DeploymentEphemeralStorage"}, + "createdAt":{ + "shape":"Timestamp", + "documentation":"The time that the service revision was created. The format is yyyy-mm-dd HH:mm:ss.SSSSS.
" + } + }, + "documentation":"Information about the service revision.
A service revision contains a record of the workload configuration Amazon ECS is attempting to deploy. Whenever you create or deploy a service, Amazon ECS automatically creates and captures the configuration that you're trying to deploy in the service revision. For information about service revisions, see Amazon ECS service revisions in the Amazon Elastic Container Service Developer Guide .
" + }, + "ServiceRevisionSummary":{ + "type":"structure", + "members":{ + "arn":{ + "shape":"String", + "documentation":"The ARN of the service revision.
" + }, + "requestedTaskCount":{ + "shape":"Integer", + "documentation":"The number of requested tasks for the service revision.
" + }, + "runningTaskCount":{ + "shape":"Integer", + "documentation":"The number of running tasks for the service revision.
" + }, + "pendingTaskCount":{ + "shape":"Integer", + "documentation":"The number of pending tasks for the service revision.
" + } + }, + "documentation":"The information about the number of requested, pending, and running tasks for a service revision.
" + }, + "ServiceRevisions":{ + "type":"list", + "member":{"shape":"ServiceRevision"} + }, + "ServiceRevisionsSummaryList":{ + "type":"list", + "member":{"shape":"ServiceRevisionSummary"} + }, "ServiceVolumeConfiguration":{ "type":"structure", "required":["name"], @@ -5963,7 +6436,7 @@ }, "networkMode":{ "shape":"NetworkMode", - "documentation":"The Docker networking mode to use for the containers in the task. The valid values are none, bridge, awsvpc, and host. If no network mode is specified, the default is bridge.
For Amazon ECS tasks on Fargate, the awsvpc network mode is required. For Amazon ECS tasks on Amazon EC2 Linux instances, any network mode can be used. For Amazon ECS tasks on Amazon EC2 Windows instances, <default> or awsvpc can be used. If the network mode is set to none, you cannot specify port mappings in your container definitions, and the tasks containers do not have external connectivity. The host and awsvpc network modes offer the highest networking performance for containers because they use the EC2 network stack instead of the virtualized network stack provided by the bridge mode.
With the host and awsvpc network modes, exposed container ports are mapped directly to the corresponding host port (for the host network mode) or the attached elastic network interface port (for the awsvpc network mode), so you cannot take advantage of dynamic host port mappings.
When using the host network mode, you should not run containers using the root user (UID 0). It is considered best practice to use a non-root user.
If the network mode is awsvpc, the task is allocated an elastic network interface, and you must specify a NetworkConfiguration value when you create a service or run a task with the task definition. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.
If the network mode is host, you cannot run multiple instantiations of the same task on a single container instance when port mappings are used.
The Docker networking mode to use for the containers in the task. The valid values are none, bridge, awsvpc, and host. If no network mode is specified, the default is bridge.
For Amazon ECS tasks on Fargate, the awsvpc network mode is required. For Amazon ECS tasks on Amazon EC2 Linux instances, any network mode can be used. For Amazon ECS tasks on Amazon EC2 Windows instances, <default> or awsvpc can be used. If the network mode is set to none, you cannot specify port mappings in your container definitions, and the tasks containers do not have external connectivity. The host and awsvpc network modes offer the highest networking performance for containers because they use the EC2 network stack instead of the virtualized network stack provided by the bridge mode.
With the host and awsvpc network modes, exposed container ports are mapped directly to the corresponding host port (for the host network mode) or the attached elastic network interface port (for the awsvpc network mode), so you cannot take advantage of dynamic host port mappings.
When using the host network mode, you should not run containers using the root user (UID 0). It is considered best practice to use a non-root user.
If the network mode is awsvpc, the task is allocated an elastic network interface, and you must specify a NetworkConfiguration value when you create a service or run a task with the task definition. For more information, see Task Networking in the Amazon Elastic Container Service Developer Guide.
If the network mode is host, you cannot run multiple instantiations of the same task on a single container instance when port mappings are used.
For more information, see Network settings in the Docker run reference.
" }, "revision":{ "shape":"Integer", @@ -6011,11 +6484,11 @@ }, "pidMode":{ "shape":"PidMode", - "documentation":"The process namespace to use for the containers in the task. The valid values are host or task. On Fargate for Linux containers, the only valid value is task. For example, monitoring sidecars might need pidMode to access information about other containers running in the same task.
If host is specified, all containers within the tasks that specified the host PID mode on the same container instance share the same process namespace with the host Amazon EC2 instance.
If task is specified, all containers within the specified task share the same process namespace.
If no value is specified, the default is a private namespace for each container.
If the host PID mode is used, there's a heightened risk of undesired process namespace exposure.
This parameter is not supported for Windows containers.
This parameter is only supported for tasks that are hosted on Fargate if the tasks are using platform version 1.4.0 or later (Linux). This isn't supported for Windows containers on Fargate.
The process namespace to use for the containers in the task. The valid values are host or task. On Fargate for Linux containers, the only valid value is task. For example, monitoring sidecars might need pidMode to access information about other containers running in the same task.
If host is specified, all containers within the tasks that specified the host PID mode on the same container instance share the same process namespace with the host Amazon EC2 instance.
If task is specified, all containers within the specified task share the same process namespace.
If no value is specified, the default is a private namespace for each container. For more information, see PID settings in the Docker run reference.
If the host PID mode is used, there's a heightened risk of undesired process namespace exposure. For more information, see Docker security.
This parameter is not supported for Windows containers.
This parameter is only supported for tasks that are hosted on Fargate if the tasks are using platform version 1.4.0 or later (Linux). This isn't supported for Windows containers on Fargate.
The IPC resource namespace to use for the containers in the task. The valid values are host, task, or none. If host is specified, then all containers within the tasks that specified the host IPC mode on the same container instance share the same IPC resources with the host Amazon EC2 instance. If task is specified, all containers within the specified task share the same IPC resources. If none is specified, then IPC resources within the containers of a task are private and not shared with other containers in a task or on the container instance. If no value is specified, then the IPC resource namespace sharing depends on the Docker daemon setting on the container instance.
If the host IPC mode is used, be aware that there is a heightened risk of undesired IPC namespace expose.
If you are setting namespaced kernel parameters using systemControls for the containers in the task, the following will apply to your IPC resource namespace. For more information, see System Controls in the Amazon Elastic Container Service Developer Guide.
For tasks that use the host IPC mode, IPC namespace related systemControls are not supported.
For tasks that use the task IPC mode, IPC namespace related systemControls will apply to all containers within a task.
This parameter is not supported for Windows containers or tasks run on Fargate.
The IPC resource namespace to use for the containers in the task. The valid values are host, task, or none. If host is specified, then all containers within the tasks that specified the host IPC mode on the same container instance share the same IPC resources with the host Amazon EC2 instance. If task is specified, all containers within the specified task share the same IPC resources. If none is specified, then IPC resources within the containers of a task are private and not shared with other containers in a task or on the container instance. If no value is specified, then the IPC resource namespace sharing depends on the Docker daemon setting on the container instance. For more information, see IPC settings in the Docker run reference.
If the host IPC mode is used, be aware that there is a heightened risk of undesired IPC namespace expose. For more information, see Docker security.
If you are setting namespaced kernel parameters using systemControls for the containers in the task, the following will apply to your IPC resource namespace. For more information, see System Controls in the Amazon Elastic Container Service Developer Guide.
For tasks that use the host IPC mode, IPC namespace related systemControls are not supported.
For tasks that use the task IPC mode, IPC namespace related systemControls will apply to all containers within a task.
This parameter is not supported for Windows containers or tasks run on Fargate.
Specify an Key Management Service key ID to encrypt the ephemeral storage for the task.
" + "documentation":"Specify an Amazon Web Services Key Management Service key ID to encrypt the ephemeral storage for the task.
" } }, "documentation":"The amount of ephemeral storage to allocate for the task.
" @@ -6704,7 +7177,7 @@ }, "deploymentConfiguration":{ "shape":"DeploymentConfiguration", - "documentation":"Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks.
" + "documentation":"Optional deployment parameters that control how many tasks run during the deployment and the failure detection methods.
" }, "networkConfiguration":{ "shape":"NetworkConfiguration", From 0b729c67dd19f13c0218cf48e9179110f83b46f4 Mon Sep 17 00:00:00 2001 From: AWS <> Date: Wed, 30 Oct 2024 18:12:49 +0000 Subject: [PATCH 06/21] Amazon WorkMail Update: This release adds support for Multi-Factor Authentication (MFA) and Personal Access Tokens through integration with AWS IAM Identity Center. --- .../feature-AmazonWorkMail-9d747a2.json | 6 + .../codegen-resources/endpoint-rule-set.json | 40 +- .../codegen-resources/paginators-1.json | 6 + .../codegen-resources/service-2.json | 565 +++++++++++++++++- 4 files changed, 591 insertions(+), 26 deletions(-) create mode 100644 .changes/next-release/feature-AmazonWorkMail-9d747a2.json diff --git a/.changes/next-release/feature-AmazonWorkMail-9d747a2.json b/.changes/next-release/feature-AmazonWorkMail-9d747a2.json new file mode 100644 index 000000000000..77b62988e239 --- /dev/null +++ b/.changes/next-release/feature-AmazonWorkMail-9d747a2.json @@ -0,0 +1,6 @@ +{ + "type": "feature", + "category": "Amazon WorkMail", + "contributor": "", + "description": "This release adds support for Multi-Factor Authentication (MFA) and Personal Access Tokens through integration with AWS IAM Identity Center." +} diff --git a/services/workmail/src/main/resources/codegen-resources/endpoint-rule-set.json b/services/workmail/src/main/resources/codegen-resources/endpoint-rule-set.json index a0b2c379c0d8..48b64c9a9ecd 100644 --- a/services/workmail/src/main/resources/codegen-resources/endpoint-rule-set.json +++ b/services/workmail/src/main/resources/codegen-resources/endpoint-rule-set.json @@ -40,7 +40,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -83,7 +82,8 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -96,7 +96,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -110,7 +109,6 @@ "assign": "PartitionResult" } ], - "type": "tree", "rules": [ { "conditions": [ @@ -133,7 +131,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -168,7 +165,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -179,14 +175,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS and DualStack are enabled, but this partition does not support one or both", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -200,14 +198,12 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ - true, { "fn": "getAttr", "argv": [ @@ -216,11 +212,11 @@ }, "supportsFIPS" ] - } + }, + true ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -231,14 +227,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [ @@ -252,7 +250,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [ @@ -272,7 +269,6 @@ ] } ], - "type": "tree", "rules": [ { "conditions": [], @@ -283,14 +279,16 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" }, { "conditions": [], "error": "DualStack is enabled but this partition does not support DualStack", "type": "error" } - ] + ], + "type": "tree" }, { "conditions": [], @@ -301,9 +299,11 @@ }, "type": "endpoint" } - ] + ], + "type": "tree" } - ] + ], + "type": "tree" }, { "conditions": [], diff --git a/services/workmail/src/main/resources/codegen-resources/paginators-1.json b/services/workmail/src/main/resources/codegen-resources/paginators-1.json index f4305ce7e13d..e56aff03f67e 100644 --- a/services/workmail/src/main/resources/codegen-resources/paginators-1.json +++ b/services/workmail/src/main/resources/codegen-resources/paginators-1.json @@ -56,6 +56,12 @@ "output_token": "NextToken", "limit_key": "MaxResults" }, + "ListPersonalAccessTokens": { + "input_token": "NextToken", + "output_token": "NextToken", + "limit_key": "MaxResults", + "result_key": "PersonalAccessTokenSummaries" + }, "ListResourceDelegates": { "input_token": "NextToken", "output_token": "NextToken", diff --git a/services/workmail/src/main/resources/codegen-resources/service-2.json b/services/workmail/src/main/resources/codegen-resources/service-2.json index 9df664353a8d..09ec013fd360 100644 --- a/services/workmail/src/main/resources/codegen-resources/service-2.json +++ b/services/workmail/src/main/resources/codegen-resources/service-2.json @@ -5,11 +5,13 @@ "endpointPrefix":"workmail", "jsonVersion":"1.1", "protocol":"json", + "protocols":["json"], "serviceFullName":"Amazon WorkMail", "serviceId":"WorkMail", "signatureVersion":"v4", "targetPrefix":"WorkMailService", - "uid":"workmail-2017-10-01" + "uid":"workmail-2017-10-01", + "auth":["aws.auth#sigv4"] }, "operations":{ "AssociateDelegateToResource":{ @@ -146,6 +148,20 @@ "documentation":"Creates a group that can be used in WorkMail by calling the RegisterToWorkMail operation.
", "idempotent":true }, + "CreateIdentityCenterApplication":{ + "name":"CreateIdentityCenterApplication", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateIdentityCenterApplicationRequest"}, + "output":{"shape":"CreateIdentityCenterApplicationResponse"}, + "errors":[ + {"shape":"InvalidParameterException"} + ], + "documentation":"Creates the WorkMail application in IAM Identity Center that can be used later in the WorkMail - IdC integration. For more information, see PutIdentityProviderConfiguration. This action does not affect the authentication settings for any WorkMail organizations.
", + "idempotent":true + }, "CreateImpersonationRole":{ "name":"CreateImpersonationRole", "http":{ @@ -324,6 +340,37 @@ "documentation":"Deletes a group from WorkMail.
", "idempotent":true }, + "DeleteIdentityCenterApplication":{ + "name":"DeleteIdentityCenterApplication", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteIdentityCenterApplicationRequest"}, + "output":{"shape":"DeleteIdentityCenterApplicationResponse"}, + "errors":[ + {"shape":"InvalidParameterException"}, + {"shape":"OrganizationStateException"} + ], + "documentation":"Deletes the IAM Identity Center application from WorkMail. This action does not affect the authentication settings for any WorkMail organizations.
", + "idempotent":true + }, + "DeleteIdentityProviderConfiguration":{ + "name":"DeleteIdentityProviderConfiguration", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeleteIdentityProviderConfigurationRequest"}, + "output":{"shape":"DeleteIdentityProviderConfigurationResponse"}, + "errors":[ + {"shape":"InvalidParameterException"}, + {"shape":"OrganizationNotFoundException"}, + {"shape":"OrganizationStateException"} + ], + "documentation":"Disables the integration between IdC and WorkMail. Authentication will continue with the directory as it was before the IdC integration. You might have to reset your directory passwords and reconfigure your desktop and mobile email clients.
", + "idempotent":true + }, "DeleteImpersonationRole":{ "name":"DeleteImpersonationRole", "http":{ @@ -404,6 +451,22 @@ "documentation":"Deletes an WorkMail organization and all underlying AWS resources managed by WorkMail as part of the organization. You can choose whether to delete the associated directory. For more information, see Removing an organization in the WorkMail Administrator Guide.
", "idempotent":true }, + "DeletePersonalAccessToken":{ + "name":"DeletePersonalAccessToken", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DeletePersonalAccessTokenRequest"}, + "output":{"shape":"DeletePersonalAccessTokenResponse"}, + "errors":[ + {"shape":"InvalidParameterException"}, + {"shape":"OrganizationNotFoundException"}, + {"shape":"OrganizationStateException"} + ], + "documentation":"Deletes the Personal Access Token from the provided WorkMail Organization.
", + "idempotent":true + }, "DeleteResource":{ "name":"DeleteResource", "http":{ @@ -545,6 +608,23 @@ "documentation":"Returns the data available for the group.
", "idempotent":true }, + "DescribeIdentityProviderConfiguration":{ + "name":"DescribeIdentityProviderConfiguration", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeIdentityProviderConfigurationRequest"}, + "output":{"shape":"DescribeIdentityProviderConfigurationResponse"}, + "errors":[ + {"shape":"InvalidParameterException"}, + {"shape":"OrganizationNotFoundException"}, + {"shape":"OrganizationStateException"}, + {"shape":"ResourceNotFoundException"} + ], + "documentation":"Returns detailed information on the current IdC setup for the WorkMail organization.
", + "idempotent":true + }, "DescribeInboundDmarcSettings":{ "name":"DescribeInboundDmarcSettings", "http":{ @@ -619,6 +699,8 @@ "input":{"shape":"DescribeUserRequest"}, "output":{"shape":"DescribeUserResponse"}, "errors":[ + {"shape":"DirectoryServiceAuthenticationFailedException"}, + {"shape":"DirectoryUnavailableException"}, {"shape":"EntityNotFoundException"}, {"shape":"InvalidParameterException"}, {"shape":"OrganizationNotFoundException"}, @@ -801,6 +883,23 @@ ], "documentation":"Gets the mobile device access override for the given WorkMail organization, user, and device.
" }, + "GetPersonalAccessTokenMetadata":{ + "name":"GetPersonalAccessTokenMetadata", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetPersonalAccessTokenMetadataRequest"}, + "output":{"shape":"GetPersonalAccessTokenMetadataResponse"}, + "errors":[ + {"shape":"ResourceNotFoundException"}, + {"shape":"InvalidParameterException"}, + {"shape":"OrganizationNotFoundException"}, + {"shape":"OrganizationStateException"} + ], + "documentation":"Requests details of a specific Personal Access Token within the WorkMail organization.
", + "idempotent":true + }, "ListAccessControlRules":{ "name":"ListAccessControlRules", "http":{ @@ -843,7 +942,8 @@ "output":{"shape":"ListAvailabilityConfigurationsResponse"}, "errors":[ {"shape":"OrganizationNotFoundException"}, - {"shape":"OrganizationStateException"} + {"shape":"OrganizationStateException"}, + {"shape":"InvalidParameterException"} ], "documentation":"List all the AvailabilityConfiguration's for the given WorkMail organization.
Returns summaries of the customer's organizations.
", "idempotent":true }, + "ListPersonalAccessTokens":{ + "name":"ListPersonalAccessTokens", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListPersonalAccessTokensRequest"}, + "output":{"shape":"ListPersonalAccessTokensResponse"}, + "errors":[ + {"shape":"InvalidParameterException"}, + {"shape":"EntityNotFoundException"}, + {"shape":"EntityStateException"}, + {"shape":"OrganizationNotFoundException"}, + {"shape":"OrganizationStateException"} + ], + "documentation":"Returns a summary of your Personal Access Tokens.
", + "idempotent":true + }, "ListResourceDelegates":{ "name":"ListResourceDelegates", "http":{ @@ -1109,6 +1227,23 @@ "documentation":"Creates or updates the email monitoring configuration for a specified organization.
", "idempotent":true }, + "PutIdentityProviderConfiguration":{ + "name":"PutIdentityProviderConfiguration", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"PutIdentityProviderConfigurationRequest"}, + "output":{"shape":"PutIdentityProviderConfigurationResponse"}, + "errors":[ + {"shape":"InvalidParameterException"}, + {"shape":"OrganizationNotFoundException"}, + {"shape":"OrganizationStateException"}, + {"shape":"ResourceNotFoundException"} + ], + "documentation":"Enables integration between IAM Identity Center (IdC) and WorkMail to proxy authentication requests for mailbox users. You can connect your IdC directory or your external directory to WorkMail through IdC and manage access to WorkMail mailboxes in a single place. For enhanced protection, you could enable Multifactor Authentication (MFA) and Personal Access Tokens.
", + "idempotent":true + }, "PutInboundDmarcSettings":{ "name":"PutInboundDmarcSettings", "http":{ @@ -1354,7 +1489,7 @@ {"shape":"UnsupportedOperationException"}, {"shape":"InvalidParameterException"} ], - "documentation":"Updates attibutes in a group.
", + "documentation":"Updates attributes in a group.
", "idempotent":true }, "UpdateImpersonationRole":{ @@ -1601,6 +1736,12 @@ "min":1, "pattern":"arn:aws:workmail:[a-z0-9-]*:[a-z0-9-]+:[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,1023}" }, + "ApplicationArn":{ + "type":"string", + "max":1224, + "min":10, + "pattern":"^arn:(aws|aws-us-gov|aws-cn|aws-iso|aws-iso-b):sso::\\d{12}:application/(sso)?ins-[a-zA-Z0-9-.]{16}/apl-[a-zA-Z0-9]{16}$" + }, "AssociateDelegateToResourceRequest":{ "type":"structure", "required":[ @@ -1866,6 +2007,37 @@ } } }, + "CreateIdentityCenterApplicationRequest":{ + "type":"structure", + "required":[ + "Name", + "InstanceArn" + ], + "members":{ + "Name":{ + "shape":"IdentityCenterApplicationName", + "documentation":"The name of the IAM Identity Center application.
" + }, + "InstanceArn":{ + "shape":"InstanceArn", + "documentation":"The Amazon Resource Name (ARN) of the instance.
" + }, + "ClientToken":{ + "shape":"IdempotencyClientToken", + "documentation":"The idempotency token associated with the request.
", + "idempotencyToken":true + } + } + }, + "CreateIdentityCenterApplicationResponse":{ + "type":"structure", + "members":{ + "ApplicationArn":{ + "shape":"ApplicationArn", + "documentation":"The Amazon Resource Name (ARN) of the application.
" + } + } + }, "CreateImpersonationRoleRequest":{ "type":"structure", "required":[ @@ -2101,6 +2273,10 @@ "HiddenFromGlobalAddressList":{ "shape":"Boolean", "documentation":"If this parameter is enabled, the user will be hidden from the address book.
" + }, + "IdentityProviderUserId":{ + "shape":"IdentityProviderUserId", + "documentation":"User ID from the IAM Identity Center. If this parameter is empty it will be updated automatically when the user logs in for the first time to the mailbox associated with WorkMail.
" } } }, @@ -2239,6 +2415,36 @@ "members":{ } }, + "DeleteIdentityCenterApplicationRequest":{ + "type":"structure", + "required":["ApplicationArn"], + "members":{ + "ApplicationArn":{ + "shape":"ApplicationArn", + "documentation":"The Amazon Resource Name (ARN) of the application.
" + } + } + }, + "DeleteIdentityCenterApplicationResponse":{ + "type":"structure", + "members":{ + } + }, + "DeleteIdentityProviderConfigurationRequest":{ + "type":"structure", + "required":["OrganizationId"], + "members":{ + "OrganizationId":{ + "shape":"OrganizationId", + "documentation":"The Organization ID.
" + } + } + }, + "DeleteIdentityProviderConfigurationResponse":{ + "type":"structure", + "members":{ + } + }, "DeleteImpersonationRoleRequest":{ "type":"structure", "required":[ @@ -2360,6 +2566,10 @@ "ForceDelete":{ "shape":"Boolean", "documentation":"Deletes a WorkMail organization even if the organization has enabled users.
" + }, + "DeleteIdentityCenterApplication":{ + "shape":"Boolean", + "documentation":"Deletes IAM Identity Center application for WorkMail. This action does not affect authentication settings for any organization.
" } } }, @@ -2376,6 +2586,28 @@ } } }, + "DeletePersonalAccessTokenRequest":{ + "type":"structure", + "required":[ + "OrganizationId", + "PersonalAccessTokenId" + ], + "members":{ + "OrganizationId":{ + "shape":"OrganizationId", + "documentation":"The Organization ID.
" + }, + "PersonalAccessTokenId":{ + "shape":"PersonalAccessTokenId", + "documentation":"The Personal Access Token ID.
" + } + } + }, + "DeletePersonalAccessTokenResponse":{ + "type":"structure", + "members":{ + } + }, "DeleteResourceRequest":{ "type":"structure", "required":[ @@ -2593,6 +2825,33 @@ } } }, + "DescribeIdentityProviderConfigurationRequest":{ + "type":"structure", + "required":["OrganizationId"], + "members":{ + "OrganizationId":{ + "shape":"OrganizationId", + "documentation":"The Organization ID.
" + } + } + }, + "DescribeIdentityProviderConfigurationResponse":{ + "type":"structure", + "members":{ + "AuthenticationMode":{ + "shape":"IdentityProviderAuthenticationMode", + "documentation":"The authentication mode used in WorkMail.
" + }, + "IdentityCenterConfiguration":{ + "shape":"IdentityCenterConfiguration", + "documentation":"The details of the IAM Identity Center configuration.
" + }, + "PersonalAccessTokenConfiguration":{ + "shape":"PersonalAccessTokenConfiguration", + "documentation":"The details of the Personal Access Token configuration.
" + } + } + }, "DescribeInboundDmarcSettingsRequest":{ "type":"structure", "required":["OrganizationId"], @@ -2914,6 +3173,14 @@ "Office":{ "shape":"UserAttribute", "documentation":"Office where the user is located.
" + }, + "IdentityProviderUserId":{ + "shape":"IdentityProviderUserId", + "documentation":"User ID from the IAM Identity Center. If this parameter is empty it will be updated automatically when the user logs in for the first time to the mailbox associated with WorkMail.
" + }, + "IdentityProviderIdentityStoreId":{ + "shape":"IdentityProviderIdentityStoreId", + "documentation":"Identity Store ID from the IAM Identity Center. If this parameter is empty it will be updated automatically when the user logs in for the first time to the mailbox associated with WorkMail.
" } } }, @@ -3571,6 +3838,56 @@ } } }, + "GetPersonalAccessTokenMetadataRequest":{ + "type":"structure", + "required":[ + "OrganizationId", + "PersonalAccessTokenId" + ], + "members":{ + "OrganizationId":{ + "shape":"OrganizationId", + "documentation":"The Organization ID.
" + }, + "PersonalAccessTokenId":{ + "shape":"PersonalAccessTokenId", + "documentation":"The Personal Access Token ID.
" + } + } + }, + "GetPersonalAccessTokenMetadataResponse":{ + "type":"structure", + "members":{ + "PersonalAccessTokenId":{ + "shape":"PersonalAccessTokenId", + "documentation":"The Personal Access Token ID.
" + }, + "UserId":{ + "shape":"WorkMailIdentifier", + "documentation":"The WorkMail User ID.
" + }, + "Name":{ + "shape":"PersonalAccessTokenName", + "documentation":"The Personal Access Token name.
" + }, + "DateCreated":{ + "shape":"Timestamp", + "documentation":"The date when the Personal Access Token ID was created.
" + }, + "DateLastUsed":{ + "shape":"Timestamp", + "documentation":"The date when the Personal Access Token ID was last used.
" + }, + "ExpiresTime":{ + "shape":"Timestamp", + "documentation":"The time when the Personal Access Token ID will expire.
" + }, + "Scopes":{ + "shape":"PersonalAccessTokenScopeList", + "documentation":"Lists all the Personal Access Token permissions for a mailbox.
" + } + } + }, "Group":{ "type":"structure", "members":{ @@ -3641,6 +3958,61 @@ "min":1, "pattern":"[\\x21-\\x7e]+" }, + "IdentityCenterApplicationName":{ + "type":"string", + "max":255, + "min":0, + "pattern":"^[\\w+=,.@-]+$" + }, + "IdentityCenterConfiguration":{ + "type":"structure", + "required":[ + "InstanceArn", + "ApplicationArn" + ], + "members":{ + "InstanceArn":{ + "shape":"InstanceArn", + "documentation":"The Amazon Resource Name (ARN) of the of IAM Identity Center instance. Must be in the same AWS account and region as WorkMail organization.
" + }, + "ApplicationArn":{ + "shape":"ApplicationArn", + "documentation":"The Amazon Resource Name (ARN) of IAMIdentity Center Application for WorkMail. Must be created by the WorkMail API, see CreateIdentityCenterApplication.
" + } + }, + "documentation":"The IAM Identity Center configuration.
" + }, + "IdentityProviderAuthenticationMode":{ + "type":"string", + "enum":[ + "IDENTITY_PROVIDER_ONLY", + "IDENTITY_PROVIDER_AND_DIRECTORY" + ] + }, + "IdentityProviderIdentityStoreId":{ + "type":"string", + "max":36, + "min":1, + "pattern":"^d-[0-9a-f]{10}$|^[0-9a-f]{8}\\\\b-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-\\\\b[0-9a-f]{12}$" + }, + "IdentityProviderUserId":{ + "type":"string", + "max":47, + "min":1, + "pattern":"^([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$" + }, + "IdentityProviderUserIdForUpdate":{ + "type":"string", + "max":47, + "min":0, + "pattern":"^$|^([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$" + }, + "IdentityProviderUserIdPrefix":{ + "type":"string", + "max":47, + "min":1, + "pattern":"^[A-Fa-f0-9-]+$" + }, "ImpersonationMatchedRule":{ "type":"structure", "members":{ @@ -3788,6 +4160,12 @@ "min":1, "pattern":"[\\x21-\\x7e]+" }, + "InstanceArn":{ + "type":"string", + "max":1124, + "min":10, + "pattern":"^arn:(aws|aws-us-gov|aws-cn|aws-iso|aws-iso-b):sso:::instance/(sso)?ins-[a-zA-Z0-9-.]{16}$" + }, "InvalidConfigurationException":{ "type":"structure", "members":{ @@ -4319,6 +4697,41 @@ } } }, + "ListPersonalAccessTokensRequest":{ + "type":"structure", + "required":["OrganizationId"], + "members":{ + "OrganizationId":{ + "shape":"OrganizationId", + "documentation":"The Organization ID.
" + }, + "UserId":{ + "shape":"EntityIdentifier", + "documentation":"The WorkMail User ID.
" + }, + "NextToken":{ + "shape":"NextToken", + "documentation":"The token from the previous response to query the next page.
" + }, + "MaxResults":{ + "shape":"MaxResults", + "documentation":"The maximum amount of items that should be returned in a response.
" + } + } + }, + "ListPersonalAccessTokensResponse":{ + "type":"structure", + "members":{ + "NextToken":{ + "shape":"NextToken", + "documentation":"The token from the previous response to query the next page.
" + }, + "PersonalAccessTokenSummaries":{ + "shape":"PersonalAccessTokenSummaryList", + "documentation":"Lists all the personal tokens in an organization or user, if user ID is provided.
" + } + } + }, "ListResourceDelegatesRequest":{ "type":"structure", "required":[ @@ -4447,6 +4860,10 @@ "State":{ "shape":"EntityState", "documentation":"Filters only users with the provided state.
" + }, + "IdentityProviderUserIdPrefix":{ + "shape":"IdentityProviderUserIdPrefix", + "documentation":"Filters only users with the ID from the IAM Identity Center.
" } }, "documentation":"Filtering options for ListUsers operation. This is only used as input to Operation.
" @@ -4811,7 +5228,8 @@ "NewResourceDescription":{ "type":"string", "max":64, - "min":0 + "min":0, + "sensitive":true }, "NextToken":{ "type":"string", @@ -4927,6 +5345,96 @@ "type":"list", "member":{"shape":"Permission"} }, + "PersonalAccessTokenConfiguration":{ + "type":"structure", + "required":["Status"], + "members":{ + "Status":{ + "shape":"PersonalAccessTokenConfigurationStatus", + "documentation":"The status of the Personal Access Token allowed for the organization.
Active - Mailbox users can login to the web application and choose Settings to see the new Personal Access Tokens page to create and delete the Personal Access Tokens. Mailbox users can use the Personal Access Tokens to set up mailbox connection from desktop or mobile email clients.
Inactive - Personal Access Tokens are disabled for your organization. Mailbox users can’t create, list, or delete Personal Access Tokens and can’t use them to connect to their mailboxes from desktop or mobile email clients.
The validity of the Personal Access Token status in days.
" + } + }, + "documentation":"Displays the Personal Access Token status.
" + }, + "PersonalAccessTokenConfigurationStatus":{ + "type":"string", + "enum":[ + "ACTIVE", + "INACTIVE" + ] + }, + "PersonalAccessTokenId":{ + "type":"string", + "max":64, + "min":1, + "pattern":"[a-zA-Z0-9_-]+" + }, + "PersonalAccessTokenLifetimeInDays":{ + "type":"integer", + "box":true, + "max":3653, + "min":1 + }, + "PersonalAccessTokenName":{ + "type":"string", + "max":64, + "min":1, + "pattern":"[^\\x00-\\x1F\\x7F\\x3C\\x3E\\x5C]+" + }, + "PersonalAccessTokenScope":{ + "type":"string", + "max":256, + "min":1, + "pattern":"[^\\x00-\\x1F\\x7F\\x3C\\x3E\\x5C]+" + }, + "PersonalAccessTokenScopeList":{ + "type":"list", + "member":{"shape":"PersonalAccessTokenScope"}, + "max":10, + "min":1 + }, + "PersonalAccessTokenSummary":{ + "type":"structure", + "members":{ + "PersonalAccessTokenId":{ + "shape":"PersonalAccessTokenId", + "documentation":"The ID of the Personal Access Token.
" + }, + "UserId":{ + "shape":"WorkMailIdentifier", + "documentation":"The user ID of the WorkMail user associated with the Personal Access Token.
" + }, + "Name":{ + "shape":"PersonalAccessTokenName", + "documentation":"The name of the Personal Access Token.
" + }, + "DateCreated":{ + "shape":"Timestamp", + "documentation":"The date when the Personal Access Token was created.
" + }, + "DateLastUsed":{ + "shape":"Timestamp", + "documentation":"The date when the Personal Access Token was last used.
" + }, + "ExpiresTime":{ + "shape":"Timestamp", + "documentation":"The date when the Personal Access Token will expire.
" + }, + "Scopes":{ + "shape":"PersonalAccessTokenScopeList", + "documentation":"Lists all the Personal Access Token permissions for a mailbox.
" + } + }, + "documentation":"The summary of the Personal Access Token.
" + }, + "PersonalAccessTokenSummaryList":{ + "type":"list", + "member":{"shape":"PersonalAccessTokenSummary"} + }, "PolicyDescription":{ "type":"string", "max":256, @@ -5024,6 +5532,38 @@ "members":{ } }, + "PutIdentityProviderConfigurationRequest":{ + "type":"structure", + "required":[ + "OrganizationId", + "AuthenticationMode", + "IdentityCenterConfiguration", + "PersonalAccessTokenConfiguration" + ], + "members":{ + "OrganizationId":{ + "shape":"OrganizationId", + "documentation":"The ID of the WorkMail Organization.
" + }, + "AuthenticationMode":{ + "shape":"IdentityProviderAuthenticationMode", + "documentation":"The authentication mode used in WorkMail.
" + }, + "IdentityCenterConfiguration":{ + "shape":"IdentityCenterConfiguration", + "documentation":"The details of the IAM Identity Center configuration.
" + }, + "PersonalAccessTokenConfiguration":{ + "shape":"PersonalAccessTokenConfiguration", + "documentation":"The details of the Personal Access Token configuration.
" + } + } + }, + "PutIdentityProviderConfigurationResponse":{ + "type":"structure", + "members":{ + } + }, "PutInboundDmarcSettingsRequest":{ "type":"structure", "required":[ @@ -5297,7 +5837,8 @@ "ResourceDescription":{ "type":"string", "max":64, - "min":1 + "min":1, + "sensitive":true }, "ResourceId":{ "type":"string", @@ -5908,7 +6449,7 @@ }, "ZipCode":{ "shape":"UserAttribute", - "documentation":"Updates the user's zipcode.
" + "documentation":"Updates the user's zip code.
" }, "Department":{ "shape":"UserAttribute", @@ -5921,6 +6462,10 @@ "Office":{ "shape":"UserAttribute", "documentation":"Updates the user's office.
" + }, + "IdentityProviderUserId":{ + "shape":"IdentityProviderUserIdForUpdate", + "documentation":"User ID from the IAM Identity Center. If this parameter is empty it will be updated automatically when the user logs in for the first time to the mailbox associated with WorkMail.
" } } }, @@ -5968,6 +6513,14 @@ "DisabledDate":{ "shape":"Timestamp", "documentation":"The date indicating when the user was disabled from WorkMail use.
" + }, + "IdentityProviderUserId":{ + "shape":"IdentityProviderUserId", + "documentation":"User ID from the IAM Identity Center. If this parameter is empty it will be updated automatically when the user logs in for the first time to the mailbox associated with WorkMail.
" + }, + "IdentityProviderIdentityStoreId":{ + "shape":"IdentityProviderIdentityStoreId", + "documentation":"Identity store ID from the IAM Identity Center. If this parameter is empty it will be updated automatically when the user logs in for the first time to the mailbox associated with WorkMail.
" } }, "documentation":"The representation of an WorkMail user.
" From f634f99bd3af568a1dba51004b987da3db63da9e Mon Sep 17 00:00:00 2001 From: AWS <> Date: Wed, 30 Oct 2024 18:12:57 +0000 Subject: [PATCH 07/21] Amazon Elastic Compute Cloud Update: This release adds two new capabilities to VPC Security Groups: Security Group VPC Associations and Shared Security Groups. --- ...ure-AmazonElasticComputeCloud-a391e7c.json | 6 + .../codegen-resources/paginators-1.json | 6 + .../codegen-resources/service-2.json | 301 +++++++++++++++++- 3 files changed, 301 insertions(+), 12 deletions(-) create mode 100644 .changes/next-release/feature-AmazonElasticComputeCloud-a391e7c.json diff --git a/.changes/next-release/feature-AmazonElasticComputeCloud-a391e7c.json b/.changes/next-release/feature-AmazonElasticComputeCloud-a391e7c.json new file mode 100644 index 000000000000..e6b12352f4cb --- /dev/null +++ b/.changes/next-release/feature-AmazonElasticComputeCloud-a391e7c.json @@ -0,0 +1,6 @@ +{ + "type": "feature", + "category": "Amazon Elastic Compute Cloud", + "contributor": "", + "description": "This release adds two new capabilities to VPC Security Groups: Security Group VPC Associations and Shared Security Groups." +} diff --git a/services/ec2/src/main/resources/codegen-resources/paginators-1.json b/services/ec2/src/main/resources/codegen-resources/paginators-1.json index 262ee455bf55..eeff116227dc 100644 --- a/services/ec2/src/main/resources/codegen-resources/paginators-1.json +++ b/services/ec2/src/main/resources/codegen-resources/paginators-1.json @@ -491,6 +491,12 @@ "output_token": "NextToken", "result_key": "SecurityGroupRules" }, + "DescribeSecurityGroupVpcAssociations": { + "input_token": "NextToken", + "limit_key": "MaxResults", + "output_token": "NextToken", + "result_key": "SecurityGroupVpcAssociations" + }, "DescribeSecurityGroups": { "input_token": "NextToken", "limit_key": "MaxResults", diff --git a/services/ec2/src/main/resources/codegen-resources/service-2.json b/services/ec2/src/main/resources/codegen-resources/service-2.json index 671308adbd28..8102c612bc16 100644 --- a/services/ec2/src/main/resources/codegen-resources/service-2.json +++ b/services/ec2/src/main/resources/codegen-resources/service-2.json @@ -283,6 +283,16 @@ "output":{"shape":"AssociateRouteTableResult"}, "documentation":"Associates a subnet in your VPC or an internet gateway or virtual private gateway attached to your VPC with a route table in your VPC. This association causes traffic from the subnet or gateway to be routed according to the routes in the route table. The action returns an association ID, which you need in order to disassociate the route table later. A route table can be associated with multiple subnets.
For more information, see Route tables in the Amazon VPC User Guide.
" }, + "AssociateSecurityGroupVpc":{ + "name":"AssociateSecurityGroupVpc", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"AssociateSecurityGroupVpcRequest"}, + "output":{"shape":"AssociateSecurityGroupVpcResult"}, + "documentation":"Associates a security group with another VPC in the same Region. This enables you to use the same security group with network interfaces and instances in the specified VPC.
The VPC you want to associate the security group with must be in the same Region.
You can associate the security group with another VPC if your account owns the VPC or if the VPC was shared with you.
You must own the security group and the VPC that it was created in.
You cannot use this feature with default security groups.
You cannot use this feature with the default VPC.
Creates a Traffic Mirror session.
A Traffic Mirror session actively copies packets from a Traffic Mirror source to a Traffic Mirror target. Create a filter, and then assign it to the session to define a subset of the traffic to mirror, for example all TCP traffic.
The Traffic Mirror source and the Traffic Mirror target (monitoring appliances) can be in the same VPC, or in a different VPC connected via VPC peering or a transit gateway.
By default, no traffic is mirrored. Use CreateTrafficMirrorFilter to create filter rules that specify the traffic to mirror.
" + "documentation":"Creates a Traffic Mirror session.
A Traffic Mirror session actively copies packets from a Traffic Mirror source to a Traffic Mirror target. Create a filter, and then assign it to the session to define a subset of the traffic to mirror, for example all TCP traffic.
The Traffic Mirror source and the Traffic Mirror target (monitoring appliances) can be in the same VPC, or in a different VPC connected via VPC peering or a transit gateway.
By default, no traffic is mirrored. Use CreateTrafficMirrorFilter to create filter rules that specify the traffic to mirror.
" }, "CreateTrafficMirrorTarget":{ "name":"CreateTrafficMirrorTarget", @@ -1825,7 +1835,7 @@ "requestUri":"/" }, "input":{"shape":"DeleteSecurityGroupRequest"}, - "documentation":"Deletes a security group.
If you attempt to delete a security group that is associated with an instance or network interface or is referenced by another security group in the same VPC, the operation fails with DependencyViolation.
Deletes a security group.
If you attempt to delete a security group that is associated with an instance or network interface, is referenced by another security group in the same VPC, or has a VPC association, the operation fails with DependencyViolation.
Describes the VPCs on the other side of a VPC peering connection that are referencing the security groups you've specified in this request.
" + "documentation":"Describes the VPCs on the other side of a VPC peering or Transit Gateway connection that are referencing the security groups you've specified in this request.
" }, "DescribeSecurityGroupRules":{ "name":"DescribeSecurityGroupRules", @@ -3257,6 +3267,16 @@ "output":{"shape":"DescribeSecurityGroupRulesResult"}, "documentation":"Describes one or more of your security group rules.
" }, + "DescribeSecurityGroupVpcAssociations":{ + "name":"DescribeSecurityGroupVpcAssociations", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DescribeSecurityGroupVpcAssociationsRequest"}, + "output":{"shape":"DescribeSecurityGroupVpcAssociationsResult"}, + "documentation":"Describes security group VPC associations made with AssociateSecurityGroupVpc.
" + }, "DescribeSecurityGroups":{ "name":"DescribeSecurityGroups", "http":{ @@ -3365,7 +3385,7 @@ }, "input":{"shape":"DescribeStaleSecurityGroupsRequest"}, "output":{"shape":"DescribeStaleSecurityGroupsResult"}, - "documentation":"Describes the stale security group rules for security groups in a specified VPC. Rules are stale when they reference a deleted security group in a peered VPC. Rules can also be stale if they reference a security group in a peer VPC for which the VPC peering connection has been deleted.
" + "documentation":"Describes the stale security group rules for security groups referenced across a VPC peering connection, transit gateway connection, or with a security group VPC association. Rules are stale when they reference a deleted security group. Rules can also be stale if they reference a security group in a peer VPC for which the VPC peering connection has been deleted, across a transit gateway where the transit gateway has been deleted (or the transit gateway security group referencing feature has been disabled), or if a security group VPC association has been disassociated.
" }, "DescribeStoreImageTasks":{ "name":"DescribeStoreImageTasks", @@ -4081,6 +4101,16 @@ "input":{"shape":"DisassociateRouteTableRequest"}, "documentation":"Disassociates a subnet or gateway from a route table.
After you perform this action, the subnet no longer uses the routes in the route table. Instead, it uses the routes in the VPC's main route table. For more information about route tables, see Route tables in the Amazon VPC User Guide.
" }, + "DisassociateSecurityGroupVpc":{ + "name":"DisassociateSecurityGroupVpc", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"DisassociateSecurityGroupVpcRequest"}, + "output":{"shape":"DisassociateSecurityGroupVpcResult"}, + "documentation":"Disassociates a security group from a VPC. You cannot disassociate the security group if any Elastic network interfaces in the associated VPC are still associated with the security group. Note that the disassociation is asynchronous and you can check the status of the request with DescribeSecurityGroupVpcAssociations.
" + }, "DisassociateSubnetCidrBlock":{ "name":"DisassociateSubnetCidrBlock", "http":{ @@ -8489,6 +8519,37 @@ } } }, + "AssociateSecurityGroupVpcRequest":{ + "type":"structure", + "required":[ + "GroupId", + "VpcId" + ], + "members":{ + "GroupId":{ + "shape":"SecurityGroupId", + "documentation":"A security group ID.
" + }, + "VpcId":{ + "shape":"VpcId", + "documentation":"A VPC ID.
" + }, + "DryRun":{ + "shape":"Boolean", + "documentation":"Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
The state of the association.
", + "locationName":"state" + } + } + }, "AssociateSubnetCidrBlockRequest":{ "type":"structure", "required":["SubnetId"], @@ -14457,7 +14518,7 @@ }, "InterfaceType":{ "shape":"NetworkInterfaceCreationType", - "documentation":"The type of network interface. The default is interface.
The only supported values are interface, efa, and trunk.
The type of network interface. The default is interface.
If you specify efa-only, do not assign any IP addresses to the network interface. EFA-only network interfaces do not support IP addresses.
The only supported values are interface, efa, efa-only, and trunk.
The tags assigned to the security group.
", "locationName":"tagSet" + }, + "SecurityGroupArn":{ + "shape":"String", + "documentation":"The security group ARN.
", + "locationName":"securityGroupArn" } } }, @@ -21708,7 +21774,7 @@ }, "Filters":{ "shape":"FilterList", - "documentation":"One or more filters. Filter names and values are case-sensitive.
auto-recovery-supported - Indicates whether Amazon CloudWatch action based recovery is supported (true | false).
bare-metal - Indicates whether it is a bare metal instance type (true | false).
burstable-performance-supported - Indicates whether the instance type is a burstable performance T instance type (true | false).
current-generation - Indicates whether this instance type is the latest generation instance type of an instance family (true | false).
ebs-info.ebs-optimized-info.baseline-bandwidth-in-mbps - The baseline bandwidth performance for an EBS-optimized instance type, in Mbps.
ebs-info.ebs-optimized-info.baseline-iops - The baseline input/output storage operations per second for an EBS-optimized instance type.
ebs-info.ebs-optimized-info.baseline-throughput-in-mbps - The baseline throughput performance for an EBS-optimized instance type, in MB/s.
ebs-info.ebs-optimized-info.maximum-bandwidth-in-mbps - The maximum bandwidth performance for an EBS-optimized instance type, in Mbps.
ebs-info.ebs-optimized-info.maximum-iops - The maximum input/output storage operations per second for an EBS-optimized instance type.
ebs-info.ebs-optimized-info.maximum-throughput-in-mbps - The maximum throughput performance for an EBS-optimized instance type, in MB/s.
ebs-info.ebs-optimized-support - Indicates whether the instance type is EBS-optimized (supported | unsupported | default).
ebs-info.encryption-support - Indicates whether EBS encryption is supported (supported | unsupported).
ebs-info.nvme-support - Indicates whether non-volatile memory express (NVMe) is supported for EBS volumes (required | supported | unsupported).
free-tier-eligible - Indicates whether the instance type is eligible to use in the free tier (true | false).
hibernation-supported - Indicates whether On-Demand hibernation is supported (true | false).
hypervisor - The hypervisor (nitro | xen).
instance-storage-info.disk.count - The number of local disks.
instance-storage-info.disk.size-in-gb - The storage size of each instance storage disk, in GB.
instance-storage-info.disk.type - The storage technology for the local instance storage disks (hdd | ssd).
instance-storage-info.encryption-support - Indicates whether data is encrypted at rest (required | supported | unsupported).
instance-storage-info.nvme-support - Indicates whether non-volatile memory express (NVMe) is supported for instance store (required | supported | unsupported).
instance-storage-info.total-size-in-gb - The total amount of storage available from all local instance storage, in GB.
instance-storage-supported - Indicates whether the instance type has local instance storage (true | false).
instance-type - The instance type (for example c5.2xlarge or c5*).
memory-info.size-in-mib - The memory size.
network-info.efa-info.maximum-efa-interfaces - The maximum number of Elastic Fabric Adapters (EFAs) per instance.
network-info.efa-supported - Indicates whether the instance type supports Elastic Fabric Adapter (EFA) (true | false).
network-info.ena-support - Indicates whether Elastic Network Adapter (ENA) is supported or required (required | supported | unsupported).
network-info.encryption-in-transit-supported - Indicates whether the instance type automatically encrypts in-transit traffic between instances (true | false).
network-info.ipv4-addresses-per-interface - The maximum number of private IPv4 addresses per network interface.
network-info.ipv6-addresses-per-interface - The maximum number of private IPv6 addresses per network interface.
network-info.ipv6-supported - Indicates whether the instance type supports IPv6 (true | false).
network-info.maximum-network-cards - The maximum number of network cards per instance.
network-info.maximum-network-interfaces - The maximum number of network interfaces per instance.
network-info.network-performance - The network performance (for example, \"25 Gigabit\").
nitro-enclaves-support - Indicates whether Nitro Enclaves is supported (supported | unsupported).
nitro-tpm-support - Indicates whether NitroTPM is supported (supported | unsupported).
nitro-tpm-info.supported-versions - The supported NitroTPM version (2.0).
processor-info.supported-architecture - The CPU architecture (arm64 | i386 | x86_64).
processor-info.sustained-clock-speed-in-ghz - The CPU clock speed, in GHz.
processor-info.supported-features - The supported CPU features (amd-sev-snp).
supported-boot-mode - The boot mode (legacy-bios | uefi).
supported-root-device-type - The root device type (ebs | instance-store).
supported-usage-class - The usage class (on-demand | spot).
supported-virtualization-type - The virtualization type (hvm | paravirtual).
vcpu-info.default-cores - The default number of cores for the instance type.
vcpu-info.default-threads-per-core - The default number of threads per core for the instance type.
vcpu-info.default-vcpus - The default number of vCPUs for the instance type.
vcpu-info.valid-cores - The number of cores that can be configured for the instance type.
vcpu-info.valid-threads-per-core - The number of threads per core that can be configured for the instance type. For example, \"1\" or \"1,2\".
One or more filters. Filter names and values are case-sensitive.
auto-recovery-supported - Indicates whether Amazon CloudWatch action based recovery is supported (true | false).
bare-metal - Indicates whether it is a bare metal instance type (true | false).
burstable-performance-supported - Indicates whether the instance type is a burstable performance T instance type (true | false).
current-generation - Indicates whether this instance type is the latest generation instance type of an instance family (true | false).
ebs-info.ebs-optimized-info.baseline-bandwidth-in-mbps - The baseline bandwidth performance for an EBS-optimized instance type, in Mbps.
ebs-info.ebs-optimized-info.baseline-iops - The baseline input/output storage operations per second for an EBS-optimized instance type.
ebs-info.ebs-optimized-info.baseline-throughput-in-mbps - The baseline throughput performance for an EBS-optimized instance type, in MB/s.
ebs-info.ebs-optimized-info.maximum-bandwidth-in-mbps - The maximum bandwidth performance for an EBS-optimized instance type, in Mbps.
ebs-info.ebs-optimized-info.maximum-iops - The maximum input/output storage operations per second for an EBS-optimized instance type.
ebs-info.ebs-optimized-info.maximum-throughput-in-mbps - The maximum throughput performance for an EBS-optimized instance type, in MB/s.
ebs-info.ebs-optimized-support - Indicates whether the instance type is EBS-optimized (supported | unsupported | default).
ebs-info.encryption-support - Indicates whether EBS encryption is supported (supported | unsupported).
ebs-info.nvme-support - Indicates whether non-volatile memory express (NVMe) is supported for EBS volumes (required | supported | unsupported).
free-tier-eligible - Indicates whether the instance type is eligible to use in the free tier (true | false).
hibernation-supported - Indicates whether On-Demand hibernation is supported (true | false).
hypervisor - The hypervisor (nitro | xen).
instance-storage-info.disk.count - The number of local disks.
instance-storage-info.disk.size-in-gb - The storage size of each instance storage disk, in GB.
instance-storage-info.disk.type - The storage technology for the local instance storage disks (hdd | ssd).
instance-storage-info.encryption-support - Indicates whether data is encrypted at rest (required | supported | unsupported).
instance-storage-info.nvme-support - Indicates whether non-volatile memory express (NVMe) is supported for instance store (required | supported | unsupported).
instance-storage-info.total-size-in-gb - The total amount of storage available from all local instance storage, in GB.
instance-storage-supported - Indicates whether the instance type has local instance storage (true | false).
instance-type - The instance type (for example c5.2xlarge or c5*).
memory-info.size-in-mib - The memory size.
network-info.efa-info.maximum-efa-interfaces - The maximum number of Elastic Fabric Adapters (EFAs) per instance.
network-info.efa-supported - Indicates whether the instance type supports Elastic Fabric Adapter (EFA) (true | false).
network-info.ena-support - Indicates whether Elastic Network Adapter (ENA) is supported or required (required | supported | unsupported).
network-info.encryption-in-transit-supported - Indicates whether the instance type automatically encrypts in-transit traffic between instances (true | false).
network-info.ipv4-addresses-per-interface - The maximum number of private IPv4 addresses per network interface.
network-info.ipv6-addresses-per-interface - The maximum number of private IPv6 addresses per network interface.
network-info.ipv6-supported - Indicates whether the instance type supports IPv6 (true | false).
network-info.maximum-network-cards - The maximum number of network cards per instance.
network-info.maximum-network-interfaces - The maximum number of network interfaces per instance.
network-info.network-performance - The network performance (for example, \"25 Gigabit\").
nitro-enclaves-support - Indicates whether Nitro Enclaves is supported (supported | unsupported).
nitro-tpm-support - Indicates whether NitroTPM is supported (supported | unsupported).
nitro-tpm-info.supported-versions - The supported NitroTPM version (2.0).
processor-info.supported-architecture - The CPU architecture (arm64 | i386 | x86_64).
processor-info.sustained-clock-speed-in-ghz - The CPU clock speed, in GHz.
processor-info.supported-features - The supported CPU features (amd-sev-snp).
supported-boot-mode - The boot mode (legacy-bios | uefi).
supported-root-device-type - The root device type (ebs | instance-store).
supported-usage-class - The usage class (on-demand | spot | capacity-block).
supported-virtualization-type - The virtualization type (hvm | paravirtual).
vcpu-info.default-cores - The default number of cores for the instance type.
vcpu-info.default-threads-per-core - The default number of threads per core for the instance type.
vcpu-info.default-vcpus - The default number of vCPUs for the instance type.
vcpu-info.valid-cores - The number of cores that can be configured for the instance type.
vcpu-info.valid-threads-per-core - The number of threads per core that can be configured for the instance type. For example, \"1\" or \"1,2\".
One or more filters.
association.allocation-id - The allocation ID returned when you allocated the Elastic IP address (IPv4) for your network interface.
association.association-id - The association ID returned when the network interface was associated with an IPv4 address.
addresses.association.owner-id - The owner ID of the addresses associated with the network interface.
addresses.association.public-ip - The association ID returned when the network interface was associated with the Elastic IP address (IPv4).
addresses.primary - Whether the private IPv4 address is the primary IP address associated with the network interface.
addresses.private-ip-address - The private IPv4 addresses associated with the network interface.
association.ip-owner-id - The owner of the Elastic IP address (IPv4) associated with the network interface.
association.public-ip - The address of the Elastic IP address (IPv4) bound to the network interface.
association.public-dns-name - The public DNS name for the network interface (IPv4).
attachment.attach-time - The time that the network interface was attached to an instance.
attachment.attachment-id - The ID of the interface attachment.
attachment.delete-on-termination - Indicates whether the attachment is deleted when an instance is terminated.
attachment.device-index - The device index to which the network interface is attached.
attachment.instance-id - The ID of the instance to which the network interface is attached.
attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.
attachment.status - The status of the attachment (attaching | attached | detaching | detached).
availability-zone - The Availability Zone of the network interface.
description - The description of the network interface.
group-id - The ID of a security group associated with the network interface.
ipv6-addresses.ipv6-address - An IPv6 address associated with the network interface.
interface-type - The type of network interface (api_gateway_managed | aws_codestar_connections_managed | branch | ec2_instance_connect_endpoint | efa | efs | gateway_load_balancer | gateway_load_balancer_endpoint | global_accelerator_managed | interface | iot_rules_managed | lambda | load_balancer | nat_gateway | network_load_balancer | quicksight | transit_gateway | trunk | vpc_endpoint).
mac-address - The MAC address of the network interface.
network-interface-id - The ID of the network interface.
owner-id - The Amazon Web Services account ID of the network interface owner.
private-dns-name - The private DNS name of the network interface (IPv4).
private-ip-address - The private IPv4 address or addresses of the network interface.
requester-id - The alias or Amazon Web Services account ID of the principal or service that created the network interface.
requester-managed - Indicates whether the network interface is being managed by an Amazon Web Services service (for example, Amazon Web Services Management Console, Auto Scaling, and so on).
source-dest-check - Indicates whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.
status - The status of the network interface. If the network interface is not attached to an instance, the status is available; if a network interface is attached to an instance the status is in-use.
subnet-id - The ID of the subnet for the network interface.
tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.
tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.
vpc-id - The ID of the VPC for the network interface.
One or more filters.
association.allocation-id - The allocation ID returned when you allocated the Elastic IP address (IPv4) for your network interface.
association.association-id - The association ID returned when the network interface was associated with an IPv4 address.
addresses.association.owner-id - The owner ID of the addresses associated with the network interface.
addresses.association.public-ip - The association ID returned when the network interface was associated with the Elastic IP address (IPv4).
addresses.primary - Whether the private IPv4 address is the primary IP address associated with the network interface.
addresses.private-ip-address - The private IPv4 addresses associated with the network interface.
association.ip-owner-id - The owner of the Elastic IP address (IPv4) associated with the network interface.
association.public-ip - The address of the Elastic IP address (IPv4) bound to the network interface.
association.public-dns-name - The public DNS name for the network interface (IPv4).
attachment.attach-time - The time that the network interface was attached to an instance.
attachment.attachment-id - The ID of the interface attachment.
attachment.delete-on-termination - Indicates whether the attachment is deleted when an instance is terminated.
attachment.device-index - The device index to which the network interface is attached.
attachment.instance-id - The ID of the instance to which the network interface is attached.
attachment.instance-owner-id - The owner ID of the instance to which the network interface is attached.
attachment.status - The status of the attachment (attaching | attached | detaching | detached).
availability-zone - The Availability Zone of the network interface.
description - The description of the network interface.
group-id - The ID of a security group associated with the network interface.
ipv6-addresses.ipv6-address - An IPv6 address associated with the network interface.
interface-type - The type of network interface (api_gateway_managed | aws_codestar_connections_managed | branch | ec2_instance_connect_endpoint | efa | efa-only | efs | gateway_load_balancer | gateway_load_balancer_endpoint | global_accelerator_managed | interface | iot_rules_managed | lambda | load_balancer | nat_gateway | network_load_balancer | quicksight | transit_gateway | trunk | vpc_endpoint).
mac-address - The MAC address of the network interface.
network-interface-id - The ID of the network interface.
owner-id - The Amazon Web Services account ID of the network interface owner.
private-dns-name - The private DNS name of the network interface (IPv4).
private-ip-address - The private IPv4 address or addresses of the network interface.
requester-id - The alias or Amazon Web Services account ID of the principal or service that created the network interface.
requester-managed - Indicates whether the network interface is being managed by an Amazon Web Services service (for example, Amazon Web Services Management Console, Auto Scaling, and so on).
source-dest-check - Indicates whether the network interface performs source/destination checking. A value of true means checking is enabled, and false means checking is disabled. The value must be false for the network interface to perform network address translation (NAT) in your VPC.
status - The status of the network interface. If the network interface is not attached to an instance, the status is available; if a network interface is attached to an instance the status is in-use.
subnet-id - The ID of the subnet for the network interface.
tag:<key> - The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.
tag-key - The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.
vpc-id - The ID of the VPC for the network interface.
Security group VPC association filters.
group-id: The security group ID.
vpc-id: The ID of the associated VPC.
vpc-owner-id: The account ID of the VPC owner.
state: The state of the association.
tag:<key>: The key/value combination of a tag assigned to the resource. Use the tag key in the filter name and the tag value as the filter value. For example, to find all resources that have a tag with the key Owner and the value TeamA, specify tag:Owner for the filter name and TeamA for the filter value.
tag-key: The key of a tag assigned to the resource. Use this filter to find all resources assigned a tag with a specific key, regardless of the tag value.
The token returned from a previous paginated request. Pagination continues from the end of the items returned by the previous request.
" + }, + "MaxResults":{ + "shape":"DescribeSecurityGroupVpcAssociationsMaxResults", + "documentation":"The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output. For more information, see Pagination.
" + }, + "DryRun":{ + "shape":"Boolean", + "documentation":"Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
The security group VPC associations.
", + "locationName":"securityGroupVpcAssociationSet" + }, + "NextToken":{ + "shape":"String", + "documentation":"The token to include in another request to get the next page of items. This value is null when there are no more items to return.
The token to include in another request to get the next page of items. If there are no additional items to return, the string is empty.
", + "documentation":"The token to include in another request to get the next page of items. This value is null when there are no more items to return.
A security group ID.
" + }, + "VpcId":{ + "shape":"String", + "documentation":"A VPC ID.
" + }, + "DryRun":{ + "shape":"Boolean", + "documentation":"Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
The state of the disassociation.
", + "locationName":"state" + } + } + }, + "DisassociateSecurityGroupVpcSecurityGroupId":{"type":"string"}, "DisassociateSubnetCidrBlockRequest":{ "type":"structure", "required":["AssociationId"], @@ -36293,7 +36433,7 @@ }, "InterfaceType":{ "shape":"String", - "documentation":"The type of network interface.
Valid values: interface | efa | trunk
The type of network interface.
Valid values: interface | efa | efa-only | trunk
The type of network interface.
Valid values: interface | efa
The type of network interface.
If you specify efa-only, do not assign any IP addresses to the network interface. EFA-only network interfaces do not support IP addresses.
Valid values: interface | efa | efa-only
Indicates whether the instance type is offered for spot or On-Demand.
", + "documentation":"Indicates whether the instance type is offered for spot, On-Demand, or Capacity Blocks.
", "locationName":"supportedUsageClasses" }, "SupportedRootDeviceTypes":{ @@ -41191,7 +41331,7 @@ }, "InterfaceType":{ "shape":"String", - "documentation":"The type of network interface. To create an Elastic Fabric Adapter (EFA), specify efa. For more information, see Elastic Fabric Adapter in the Amazon EC2 User Guide.
If you are not creating an EFA, specify interface or omit this parameter.
Valid values: interface | efa
The type of network interface. To create an Elastic Fabric Adapter (EFA), specify efa or efa. For more information, see Elastic Fabric Adapter in the Amazon EC2 User Guide.
If you are not creating an EFA, specify interface or omit this parameter.
If you specify efa-only, do not assign any IP addresses to the network interface. EFA-only network interfaces do not support IP addresses.
Valid values: interface | efa | efa-only
The outbound rules that were unknown to the service. In some cases, unknownIpPermissionSet might be in a different format from the request parameter.
Details about the revoked security group rules.
", + "locationName":"revokedSecurityGroupRuleSet" } } }, @@ -52598,7 +52743,80 @@ "shape":"IpPermissionList", "documentation":"The inbound rules that were unknown to the service. In some cases, unknownIpPermissionSet might be in a different format from the request parameter.
Details about the revoked security group rules.
", + "locationName":"revokedSecurityGroupRuleSet" + } + } + }, + "RevokedSecurityGroupRule":{ + "type":"structure", + "members":{ + "SecurityGroupRuleId":{ + "shape":"SecurityGroupRuleId", + "documentation":"A security group rule ID.
", + "locationName":"securityGroupRuleId" + }, + "GroupId":{ + "shape":"SecurityGroupId", + "documentation":"A security group ID.
", + "locationName":"groupId" + }, + "IsEgress":{ + "shape":"Boolean", + "documentation":"Defines if a security group rule is an outbound rule.
", + "locationName":"isEgress" + }, + "IpProtocol":{ + "shape":"String", + "documentation":"The security group rule's protocol.
", + "locationName":"ipProtocol" + }, + "FromPort":{ + "shape":"Integer", + "documentation":"The 'from' port number of the security group rule.
", + "locationName":"fromPort" + }, + "ToPort":{ + "shape":"Integer", + "documentation":"The 'to' port number of the security group rule.
", + "locationName":"toPort" + }, + "CidrIpv4":{ + "shape":"String", + "documentation":"The IPv4 CIDR of the traffic source.
", + "locationName":"cidrIpv4" + }, + "CidrIpv6":{ + "shape":"String", + "documentation":"The IPv6 CIDR of the traffic source.
", + "locationName":"cidrIpv6" + }, + "PrefixListId":{ + "shape":"PrefixListResourceId", + "documentation":"The ID of a prefix list that's the traffic source.
", + "locationName":"prefixListId" + }, + "ReferencedGroupId":{ + "shape":"SecurityGroupId", + "documentation":"The ID of a referenced security group.
", + "locationName":"referencedGroupId" + }, + "Description":{ + "shape":"String", + "documentation":"A description of the revoked security group rule.
", + "locationName":"description" } + }, + "documentation":"A security group rule removed with RevokeSecurityGroupEgress or RevokeSecurityGroupIngress.
" + }, + "RevokedSecurityGroupRuleList":{ + "type":"list", + "member":{ + "shape":"RevokedSecurityGroupRule", + "locationName":"item" } }, "RoleId":{"type":"string"}, @@ -53888,6 +54106,11 @@ "documentation":"The ID of the VPC for the security group.
", "locationName":"vpcId" }, + "SecurityGroupArn":{ + "shape":"String", + "documentation":"The ARN of the security group.
", + "locationName":"securityGroupArn" + }, "OwnerId":{ "shape":"String", "documentation":"The Amazon Web Services account ID of the owner of the security group.
", @@ -54116,6 +54339,11 @@ "shape":"TagList", "documentation":"The tags applied to the security group rule.
", "locationName":"tagSet" + }, + "SecurityGroupRuleArn":{ + "shape":"String", + "documentation":"The ARN of the security group rule.
", + "locationName":"securityGroupRuleArn" } }, "documentation":"Describes a security group rule.
" @@ -54223,6 +54451,55 @@ "locationName":"SecurityGroup" } }, + "SecurityGroupVpcAssociation":{ + "type":"structure", + "members":{ + "GroupId":{ + "shape":"SecurityGroupId", + "documentation":"The association's security group ID.
", + "locationName":"groupId" + }, + "VpcId":{ + "shape":"VpcId", + "documentation":"The association's VPC ID.
", + "locationName":"vpcId" + }, + "VpcOwnerId":{ + "shape":"String", + "documentation":"The Amazon Web Services account ID of the owner of the VPC.
", + "locationName":"vpcOwnerId" + }, + "State":{ + "shape":"SecurityGroupVpcAssociationState", + "documentation":"The association's state.
", + "locationName":"state" + }, + "StateReason":{ + "shape":"String", + "documentation":"The association's state reason.
", + "locationName":"stateReason" + } + }, + "documentation":"A security group association with a VPC that you made with AssociateSecurityGroupVpc.
" + }, + "SecurityGroupVpcAssociationList":{ + "type":"list", + "member":{ + "shape":"SecurityGroupVpcAssociation", + "locationName":"item" + } + }, + "SecurityGroupVpcAssociationState":{ + "type":"string", + "enum":[ + "associating", + "associated", + "association-failed", + "disassociating", + "disassociated", + "disassociation-failed" + ] + }, "SelfServicePortal":{ "type":"string", "enum":[ From e651d20430f9abd81aaf1727bb53807be14e0b98 Mon Sep 17 00:00:00 2001 From: AWS <> Date: Wed, 30 Oct 2024 18:12:55 +0000 Subject: [PATCH 08/21] Amazon Location Service Places V2 Update: Release of Amazon Location Places API. Places enables you to quickly search, display, and filter places, businesses, and locations based on proximity, category, and name --- ...AmazonLocationServicePlacesV2-97efb00.json | 6 + services/geoplaces/pom.xml | 60 + .../codegen-resources/endpoint-rule-set.json | 688 ++++ .../codegen-resources/endpoint-tests.json | 392 +++ .../codegen-resources/paginators-1.json | 4 + .../codegen-resources/service-2.json | 3082 +++++++++++++++++ 6 files changed, 4232 insertions(+) create mode 100644 .changes/next-release/feature-AmazonLocationServicePlacesV2-97efb00.json create mode 100644 services/geoplaces/pom.xml create mode 100644 services/geoplaces/src/main/resources/codegen-resources/endpoint-rule-set.json create mode 100644 services/geoplaces/src/main/resources/codegen-resources/endpoint-tests.json create mode 100644 services/geoplaces/src/main/resources/codegen-resources/paginators-1.json create mode 100644 services/geoplaces/src/main/resources/codegen-resources/service-2.json diff --git a/.changes/next-release/feature-AmazonLocationServicePlacesV2-97efb00.json b/.changes/next-release/feature-AmazonLocationServicePlacesV2-97efb00.json new file mode 100644 index 000000000000..ab5e06bcdd73 --- /dev/null +++ b/.changes/next-release/feature-AmazonLocationServicePlacesV2-97efb00.json @@ -0,0 +1,6 @@ +{ + "type": "feature", + "category": "Amazon Location Service Places V2", + "contributor": "", + "description": "Release of Amazon Location Places API. Places enables you to quickly search, display, and filter places, businesses, and locations based on proximity, category, and name" +} diff --git a/services/geoplaces/pom.xml b/services/geoplaces/pom.xml new file mode 100644 index 000000000000..087eb1ee4af7 --- /dev/null +++ b/services/geoplaces/pom.xml @@ -0,0 +1,60 @@ + +The autocomplete operation speeds up and increases the accuracy of entering addresses by providing a list of address candidates matching a partially entered address. Results are sorted from most to least matching. Filtering and biasing can be used to increase the relevance of the results if additional search context is known
" + }, + "Geocode":{ + "name":"Geocode", + "http":{ + "method":"POST", + "requestUri":"/geocode", + "responseCode":200 + }, + "input":{"shape":"GeocodeRequest"}, + "output":{"shape":"GeocodeResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ValidationException"}, + {"shape":"ThrottlingException"} + ], + "documentation":"The Geocode action allows you to obtain coordinates, addresses, and other information about places.
Finds a place by its unique ID. A PlaceId is returned by other place operations.
The ReverseGeocode operation allows you to retrieve addresses and place information from coordinates.
Search nearby a specified location.
" + }, + "SearchText":{ + "name":"SearchText", + "http":{ + "method":"POST", + "requestUri":"/search-text", + "responseCode":200 + }, + "input":{"shape":"SearchTextRequest"}, + "output":{"shape":"SearchTextResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ValidationException"}, + {"shape":"ThrottlingException"} + ], + "documentation":"Use the SearchText operation to search for geocode and place information. You can then complete a follow-up query suggested from the Suggest API via a query id.
The Suggest operation finds addresses or place candidates based on incomplete or misspelled queries. You then select the best query to submit based on the returned results.
You don't have sufficient access to perform this action.
", + "error":{ + "httpStatusCode":403, + "senderFault":true + }, + "exception":true + }, + "AccessPoint":{ + "type":"structure", + "members":{ + "Position":{ + "shape":"Position", + "documentation":"The position, in longitude and latitude.
" + } + }, + "documentation":"Position of the access point represented by longitude and latitude for a vehicle.
" + }, + "AccessPointList":{ + "type":"list", + "member":{"shape":"AccessPoint"}, + "max":100, + "min":0 + }, + "AccessRestriction":{ + "type":"structure", + "members":{ + "Restricted":{ + "shape":"Boolean", + "documentation":"The restriction.
" + }, + "Categories":{ + "shape":"CategoryList", + "documentation":"Categories of results that results must belong too.
" + } + }, + "documentation":"Indicates if the access location is restricted. Index correlates to that of an access point and indicates if access through this point has some form of restriction.
" + }, + "AccessRestrictionList":{ + "type":"list", + "member":{"shape":"AccessRestriction"}, + "max":100, + "min":1 + }, + "Address":{ + "type":"structure", + "members":{ + "Label":{ + "shape":"AddressLabelString", + "documentation":"Assembled address value built out of the address components, according to the regional postal rules. This is the correctly formatted address.
" + }, + "Country":{ + "shape":"Country", + "documentation":"The country component of the address.
" + }, + "Region":{ + "shape":"Region", + "documentation":"The region or state results should be present in.
Example: North Rhine-Westphalia.
The sub-region or county for which results should be present in.
" + }, + "Locality":{ + "shape":"AddressLocalityString", + "documentation":"The locality or city of the address.
Example: Vancouver.
The district or division of a locality associated with this address.
" + }, + "SubDistrict":{ + "shape":"AddressSubDistrictString", + "documentation":"A subdivision of a district.
Example: Minden-Lübbecke.
An alphanumeric string included in a postal address to facilitate mail sorting, such as post code, postcode, or ZIP code, for which the result should posses.
" + }, + "Block":{ + "shape":"AddressBlockString", + "documentation":"Name of the block.
Example: Sunny Mansion 203 block: 2 Chome
Name of sub-block.
Example: Sunny Mansion 203 sub-block: 4
Name of the streets in the intersection.
Example: [\"Friedrichstraße\",\"Unter den Linden\"]
The name of the street results should be present in.
" + }, + "StreetComponents":{ + "shape":"StreetComponentsList", + "documentation":"Components of the street.
Example: Younge from the \"Younge street\".
" + }, + "AddressNumber":{ + "shape":"AddressAddressNumberString", + "documentation":"The number that identifies an address within a street.
" + }, + "Building":{ + "shape":"AddressBuildingString", + "documentation":"The name of the building at the address.
" + } + }, + "documentation":"The place address.
" + }, + "AddressAddressNumberString":{ + "type":"string", + "max":10, + "min":0 + }, + "AddressBlockString":{ + "type":"string", + "max":200, + "min":0 + }, + "AddressBuildingString":{ + "type":"string", + "max":200, + "min":0 + }, + "AddressComponentMatchScores":{ + "type":"structure", + "members":{ + "Country":{ + "shape":"MatchScore", + "documentation":"The alpha-2 or alpha-3 character code for the country that the results will be present in.
" + }, + "Region":{ + "shape":"MatchScore", + "documentation":"The region or state results should be to be present in.
Example: North Rhine-Westphalia.
The sub-region or county for which results should be present in.
" + }, + "Locality":{ + "shape":"MatchScore", + "documentation":"The city or locality results should be present in.
Example: Vancouver.
The district or division of a city the results should be present in.
" + }, + "SubDistrict":{ + "shape":"MatchScore", + "documentation":"A subdivision of a district.
Example: Minden-Lübbecke
An alphanumeric string included in a postal address to facilitate mail sorting, such as post code, postcode, or ZIP code, for which the result should posses.
" + }, + "Block":{ + "shape":"MatchScore", + "documentation":"Name of the block.
Example: Sunny Mansion 203 block: 2 Chome
Name of sub-block.
Example: Sunny Mansion 203 sub-block: 4
Name of the streets in the intersection.
Example: [\"Friedrichstraße\",\"Unter den Linden\"]
The house number or address results should have.
" + }, + "Building":{ + "shape":"MatchScore", + "documentation":"The name of the building at the address.
" + } + }, + "documentation":"Indicates how well the entire input matches the returned. It is equal to 1 if all input tokens are recognized and matched.
" + }, + "AddressComponentMatchScoresIntersectionList":{ + "type":"list", + "member":{"shape":"MatchScore"}, + "max":2, + "min":1 + }, + "AddressComponentPhonemes":{ + "type":"structure", + "members":{ + "Country":{ + "shape":"PhonemeTranscriptionList", + "documentation":"The alpha-2 or alpha-3 character code for the country that the results will be present in.
" + }, + "Region":{ + "shape":"PhonemeTranscriptionList", + "documentation":"How to pronounce the region or state results should be to be present in.
" + }, + "SubRegion":{ + "shape":"PhonemeTranscriptionList", + "documentation":"How to pronounce the sub-region or county for which results should be present in.
" + }, + "Locality":{ + "shape":"PhonemeTranscriptionList", + "documentation":"How to pronounce the city or locality results should be present in.
Example: Vancouver.
How to pronounce the district or division of a city results should be present in.
" + }, + "SubDistrict":{ + "shape":"PhonemeTranscriptionList", + "documentation":"How to pronounce the sub-district or division of a city results should be present in.
" + }, + "Block":{ + "shape":"PhonemeTranscriptionList", + "documentation":"How to pronounce the name of the block.
" + }, + "SubBlock":{ + "shape":"PhonemeTranscriptionList", + "documentation":"How to pronounce the name of the sub-block.
" + }, + "Street":{ + "shape":"PhonemeTranscriptionList", + "documentation":"How to pronounce the name of the street results should be present in.
" + } + }, + "documentation":"How to pronounce the various components of the address or place.
" + }, + "AddressDistrictString":{ + "type":"string", + "max":200, + "min":0 + }, + "AddressLabelString":{ + "type":"string", + "max":200, + "min":0 + }, + "AddressLocalityString":{ + "type":"string", + "max":200, + "min":0 + }, + "AddressPostalCodeString":{ + "type":"string", + "max":50, + "min":0 + }, + "AddressStreetString":{ + "type":"string", + "max":200, + "min":0 + }, + "AddressSubBlockString":{ + "type":"string", + "max":200, + "min":0 + }, + "AddressSubDistrictString":{ + "type":"string", + "max":200, + "min":0 + }, + "ApiKey":{ + "type":"string", + "max":1000, + "min":0, + "sensitive":true + }, + "AutocompleteAdditionalFeature":{ + "type":"string", + "enum":["Core"] + }, + "AutocompleteAdditionalFeatureList":{ + "type":"list", + "member":{"shape":"AutocompleteAdditionalFeature"}, + "max":1, + "min":1 + }, + "AutocompleteAddressHighlights":{ + "type":"structure", + "members":{ + "Label":{ + "shape":"HighlightList", + "documentation":"Indicates the starting and ending indexes for result items where they are identified to match the input query. This should be used to provide emphasis to output display to make selecting the correct result from a list easier for end users.
" + }, + "Country":{ + "shape":"CountryHighlights", + "documentation":"The alpha-2 or alpha-3 character code for the country that the results will be present in.
" + }, + "Region":{ + "shape":"RegionHighlights", + "documentation":"The region or state results should be to be present in.
Example: North Rhine-Westphalia.
The sub-region or county for which results should be present in.
" + }, + "Locality":{ + "shape":"HighlightList", + "documentation":"The city or locality results should be present in.
Example: Vancouver.
The district or division of a city the results should be present in.
" + }, + "SubDistrict":{ + "shape":"HighlightList", + "documentation":"Indicates the starting and ending index of the title in the text query that match the found title.
" + }, + "Street":{ + "shape":"HighlightList", + "documentation":"The name of the street results should be present in.
" + }, + "Block":{ + "shape":"HighlightList", + "documentation":"Name of the block. Example: Sunny Mansion 203 block: 2 Chome
" + }, + "SubBlock":{ + "shape":"HighlightList", + "documentation":"Name of sub-block. Example Sunny Mansion 203 sub-block: 4
" + }, + "Intersection":{ + "shape":"IntersectionHighlightsList", + "documentation":"Name of the streets in the intersection. For example: e.g. [\"Friedrichstraße\",\"Unter den Linden\"]
" + }, + "PostalCode":{ + "shape":"HighlightList", + "documentation":"An alphanumeric string included in a postal address to facilitate mail sorting, such as post code, postcode, or ZIP code for which the result should posses.
" + }, + "AddressNumber":{ + "shape":"HighlightList", + "documentation":"The house number or address results should have.
" + }, + "Building":{ + "shape":"HighlightList", + "documentation":"The name of the building at the address.
" + } + }, + "documentation":"Describes how the parts of the response element matched the input query by returning the sections of the response which matched to input query terms.
" + }, + "AutocompleteFilter":{ + "type":"structure", + "members":{ + "BoundingBox":{ + "shape":"BoundingBox", + "documentation":"The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates: [{westward lng}, {southern lat}, {eastward lng}, {northern lat}]
A list of countries that all results must be in. Countries are represented by either their alpha-2 or alpha-3 character codes.
" + }, + "IncludePlaceTypes":{ + "shape":"AutocompleteFilterPlaceTypeList", + "documentation":"The included place types.
" + } + }, + "documentation":"Autocomplete structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
" + }, + "AutocompleteFilterPlaceType":{ + "type":"string", + "enum":[ + "Locality", + "PostalCode" + ] + }, + "AutocompleteFilterPlaceTypeList":{ + "type":"list", + "member":{"shape":"AutocompleteFilterPlaceType"}, + "max":2, + "min":1 + }, + "AutocompleteHighlights":{ + "type":"structure", + "members":{ + "Title":{ + "shape":"HighlightList", + "documentation":"Indicates where the title field in the result matches the input query.
" + }, + "Address":{ + "shape":"AutocompleteAddressHighlights", + "documentation":"Describes how part of the result address match the input query.
" + } + }, + "documentation":"Describes how the parts of the response element matched the input query by returning the sections of the response which matched to input query terms.
" + }, + "AutocompleteIntendedUse":{ + "type":"string", + "enum":["SingleUse"] + }, + "AutocompleteRequest":{ + "type":"structure", + "required":["QueryText"], + "members":{ + "QueryText":{ + "shape":"AutocompleteRequestQueryTextString", + "documentation":"The free-form text query to match addresses against. This is usually a partially typed address from an end user in an address box or form.
" + }, + "MaxResults":{ + "shape":"AutocompleteRequestMaxResultsInteger", + "documentation":"An optional limit for the number of results returned in a single call.
" + }, + "BiasPosition":{ + "shape":"Position", + "documentation":"The position in longitude and latitude that the results should be close to. Typically, place results returned are ranked higher the closer they are to this position. Stored in [lng, lat] and in the WSG84 format.
The fields BiasPosition, FilterBoundingBox, and FilterCircle are mutually exclusive.
A structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
" + }, + "PostalCodeMode":{ + "shape":"PostalCodeMode", + "documentation":"The PostalCodeMode affects how postal code results are returned. If a postal code spans multiple localities and this value is empty, partial district or locality information may be returned under a single postal code result entry. If it's populated with the value cityLookup, all cities in that postal code are returned.
A list of optional additional parameters that can be requested for each result.
" + }, + "Language":{ + "shape":"LanguageTag", + "documentation":"A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
" + }, + "PoliticalView":{ + "shape":"CountryCode", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + }, + "IntendedUse":{ + "shape":"AutocompleteIntendedUse", + "documentation":"Indicates if the results will be stored. Defaults to SingleUse, if left empty.
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + } + } + }, + "AutocompleteRequestMaxResultsInteger":{ + "type":"integer", + "box":true, + "max":20, + "min":1 + }, + "AutocompleteRequestQueryTextString":{ + "type":"string", + "max":200, + "min":1, + "sensitive":true + }, + "AutocompleteResponse":{ + "type":"structure", + "required":["PricingBucket"], + "members":{ + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + }, + "ResultItems":{ + "shape":"AutocompleteResultItemList", + "documentation":"List of places or results returned for a query.
" + } + } + }, + "AutocompleteResultItem":{ + "type":"structure", + "required":[ + "PlaceId", + "PlaceType", + "Title" + ], + "members":{ + "PlaceId":{ + "shape":"AutocompleteResultItemPlaceIdString", + "documentation":"The PlaceId of the place associated with this result. This can be used to look up additional details about the result via GetPlace.
" + }, + "PlaceType":{ + "shape":"PlaceType", + "documentation":"PlaceType describes the type of result entry returned.
" + }, + "Title":{ + "shape":"AutocompleteResultItemTitleString", + "documentation":"A formatted string for display when presenting this result to an end user.
" + }, + "Address":{ + "shape":"Address", + "documentation":"The address associated with this result.
" + }, + "Distance":{ + "shape":"DistanceMeters", + "documentation":"The distance in meters between the center of the search area and this result. Useful to evaluate how far away from the original bias position the result is.
" + }, + "Language":{ + "shape":"LanguageTag", + "documentation":"A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
" + }, + "PoliticalView":{ + "shape":"CountryCode3", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + }, + "Highlights":{ + "shape":"AutocompleteHighlights", + "documentation":"Indicates the starting and ending index of the place in the text query that match the found title.
" + } + }, + "documentation":"A result matching the input query text.
" + }, + "AutocompleteResultItemList":{ + "type":"list", + "member":{"shape":"AutocompleteResultItem"}, + "max":20, + "min":0 + }, + "AutocompleteResultItemPlaceIdString":{ + "type":"string", + "max":200, + "min":0 + }, + "AutocompleteResultItemTitleString":{ + "type":"string", + "max":200, + "min":0 + }, + "Boolean":{ + "type":"boolean", + "box":true + }, + "BoundingBox":{ + "type":"list", + "member":{"shape":"Double"}, + "max":4, + "min":4, + "sensitive":true + }, + "BusinessChain":{ + "type":"structure", + "members":{ + "Name":{ + "shape":"BusinessChainNameString", + "documentation":"The business chain name.
" + }, + "Id":{ + "shape":"BusinessChainIdString", + "documentation":"The Business Chain Id.
" + } + }, + "documentation":"A businesschain is a chain of businesses that belong to the same brand. For example 7-11.
The category ID.
" + }, + "Name":{ + "shape":"CategoryNameString", + "documentation":"The category name.
" + }, + "LocalizedName":{ + "shape":"CategoryLocalizedNameString", + "documentation":"Localized name of the category type.
" + }, + "Primary":{ + "shape":"Boolean", + "documentation":"Boolean which indicates if this category is the primary offered by the place.
" + } + }, + "documentation":"Category of the Place returned.
Indicates the starting and ending index of the title in the text query that match the found title.
" + }, + "Address":{ + "shape":"AddressComponentMatchScores", + "documentation":"The place's address.
" + } + }, + "documentation":"Indicates how well the input matches the returned element. It is equal to 1 if all input tokens are recognized and matched to the title in the result.
" + }, + "ContactDetails":{ + "type":"structure", + "members":{ + "Label":{ + "shape":"ContactDetailsLabelString", + "documentation":"The contact's label.
" + }, + "Value":{ + "shape":"ContactDetailsValueString", + "documentation":"The contact's value.
" + }, + "Categories":{ + "shape":"CategoryList", + "documentation":"Categories of results that results must belong too.
" + } + }, + "documentation":"Details related to contacts.
" + }, + "ContactDetailsLabelString":{ + "type":"string", + "max":200, + "min":0 + }, + "ContactDetailsList":{ + "type":"list", + "member":{"shape":"ContactDetails"}, + "max":100, + "min":1 + }, + "ContactDetailsValueString":{ + "type":"string", + "max":200, + "min":0 + }, + "Contacts":{ + "type":"structure", + "members":{ + "Phones":{ + "shape":"ContactDetailsList", + "documentation":"List of phone numbers for the results contact.
" + }, + "Faxes":{ + "shape":"ContactDetailsList", + "documentation":"List of fax addresses for the result contact.
" + }, + "Websites":{ + "shape":"ContactDetailsList", + "documentation":"List of website URLs that belong to the result.
" + }, + "Emails":{ + "shape":"ContactDetailsList", + "documentation":"List of emails for contacts of the result.
" + } + }, + "documentation":"A list of potential contact methods for the result/place.
" + }, + "Country":{ + "type":"structure", + "members":{ + "Code2":{ + "shape":"CountryCode2", + "documentation":"Country, represented by its alpha 2-character code.
" + }, + "Code3":{ + "shape":"CountryCode3", + "documentation":"Country, represented by its alpha t-character code.
" + }, + "Name":{ + "shape":"CountryNameString", + "documentation":"Name of the country.
" + } + }, + "documentation":"The alpha-2 or alpha-3 character code for the country that the results will be present in.
" + }, + "CountryCode":{ + "type":"string", + "max":3, + "min":2, + "pattern":"([A-Z]{2}|[A-Z]{3})" + }, + "CountryCode2":{ + "type":"string", + "max":2, + "min":2, + "pattern":"[A-Z]{2}" + }, + "CountryCode3":{ + "type":"string", + "max":3, + "min":3, + "pattern":"[A-Z]{3}" + }, + "CountryCodeList":{ + "type":"list", + "member":{"shape":"CountryCode"}, + "max":100, + "min":1 + }, + "CountryHighlights":{ + "type":"structure", + "members":{ + "Code":{ + "shape":"HighlightList", + "documentation":"Indicates the starting and ending index of the country code in the text query that match the found title.
" + }, + "Name":{ + "shape":"HighlightList", + "documentation":"Indicates the starting and ending index of the country code in the text query that match the found title.
" + } + }, + "documentation":"Indicates the starting and ending index of the country in the text query that match the found title.
" + }, + "CountryNameString":{ + "type":"string", + "max":100, + "min":0 + }, + "DistanceMeters":{ + "type":"long", + "max":4294967295, + "min":0 + }, + "Double":{ + "type":"double", + "box":true + }, + "FilterBusinessChainList":{ + "type":"list", + "member":{"shape":"FilterBusinessChainListMemberString"}, + "max":10, + "min":1 + }, + "FilterBusinessChainListMemberString":{ + "type":"string", + "max":100, + "min":1 + }, + "FilterCategoryList":{ + "type":"list", + "member":{"shape":"FilterCategoryListMemberString"}, + "max":10, + "min":1 + }, + "FilterCategoryListMemberString":{ + "type":"string", + "max":100, + "min":1 + }, + "FilterCircle":{ + "type":"structure", + "required":[ + "Center", + "Radius" + ], + "members":{ + "Center":{ + "shape":"Position", + "documentation":"The center position, in longitude and latitude, of the FilterCircle.
The radius, in meters, of the FilterCircle.
The Circle that all results must be in.
Localized name of the food type.
" + }, + "Id":{ + "shape":"FoodTypeIdString", + "documentation":"The Food Type Id.
" + }, + "Primary":{ + "shape":"Boolean", + "documentation":"Boolean which indicates if this food type is the primary offered by the place. For example, if a location serves fast food, but also dessert, he primary would likely be fast food.
" + } + }, + "documentation":"List of Food types offered by this result.
A list of countries that all results must be in. Countries are represented by either their alpha-2 or alpha-3 character codes.
" + }, + "IncludePlaceTypes":{ + "shape":"GeocodeFilterPlaceTypeList", + "documentation":"The included place types.
" + } + }, + "documentation":"Geocode structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
" + }, + "GeocodeFilterPlaceType":{ + "type":"string", + "enum":[ + "Locality", + "PostalCode", + "Intersection", + "Street", + "PointAddress", + "InterpolatedAddress" + ] + }, + "GeocodeFilterPlaceTypeList":{ + "type":"list", + "member":{"shape":"GeocodeFilterPlaceType"}, + "max":6, + "min":1 + }, + "GeocodeIntendedUse":{ + "type":"string", + "enum":[ + "SingleUse", + "Storage" + ] + }, + "GeocodeQueryComponents":{ + "type":"structure", + "members":{ + "Country":{ + "shape":"GeocodeQueryComponentsCountryString", + "documentation":"The alpha-2 or alpha-3 character code for the country that the results will be present in.
" + }, + "Region":{ + "shape":"GeocodeQueryComponentsRegionString", + "documentation":"The region or state results should be to be present in.
Example: North Rhine-Westphalia.
The sub-region or county for which results should be present in.
" + }, + "Locality":{ + "shape":"GeocodeQueryComponentsLocalityString", + "documentation":"City or locality results should be present in.
Example: Vancouver.
The district or division of a city the results should be present in.
" + }, + "Street":{ + "shape":"GeocodeQueryComponentsStreetString", + "documentation":"The name of the street results should be present in.
" + }, + "AddressNumber":{ + "shape":"GeocodeQueryComponentsAddressNumberString", + "documentation":"The house number or address results should have.
" + }, + "PostalCode":{ + "shape":"GeocodeQueryComponentsPostalCodeString", + "documentation":"An alphanumeric string included in a postal address to facilitate mail sorting, such as post code, postcode, or ZIP code for which the result should posses.
" + } + }, + "documentation":"A structured free text query allows you to search for places by the name or text representation of specific properties of the place.
" + }, + "GeocodeQueryComponentsAddressNumberString":{ + "type":"string", + "max":100, + "min":1, + "pattern":"[^;]+", + "sensitive":true + }, + "GeocodeQueryComponentsCountryString":{ + "type":"string", + "max":100, + "min":1, + "pattern":"[^;]+", + "sensitive":true + }, + "GeocodeQueryComponentsDistrictString":{ + "type":"string", + "max":100, + "min":1, + "pattern":"[^;]+", + "sensitive":true + }, + "GeocodeQueryComponentsLocalityString":{ + "type":"string", + "max":100, + "min":1, + "pattern":"[^;]+", + "sensitive":true + }, + "GeocodeQueryComponentsPostalCodeString":{ + "type":"string", + "max":100, + "min":1, + "pattern":"[^;]+", + "sensitive":true + }, + "GeocodeQueryComponentsRegionString":{ + "type":"string", + "max":100, + "min":1, + "pattern":"[^;]+", + "sensitive":true + }, + "GeocodeQueryComponentsStreetString":{ + "type":"string", + "max":100, + "min":1, + "pattern":"[^;]+", + "sensitive":true + }, + "GeocodeQueryComponentsSubRegionString":{ + "type":"string", + "max":100, + "min":1, + "pattern":"[^;]+", + "sensitive":true + }, + "GeocodeRequest":{ + "type":"structure", + "members":{ + "QueryText":{ + "shape":"GeocodeRequestQueryTextString", + "documentation":"The free-form text query to match addresses against. This is usually a partially typed address from an end user in an address box or form.
" + }, + "QueryComponents":{"shape":"GeocodeQueryComponents"}, + "MaxResults":{ + "shape":"GeocodeRequestMaxResultsInteger", + "documentation":"An optional limit for the number of results returned in a single call.
" + }, + "BiasPosition":{ + "shape":"Position", + "documentation":"The position, in longitude and latitude, that the results should be close to. Typically, place results returned are ranked higher the closer they are to this position. Stored in [lng, lat] and in the WSG84 format.
The fields BiasPosition, FilterBoundingBox, and FilterCircle are mutually exclusive.
A structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
" + }, + "AdditionalFeatures":{ + "shape":"GeocodeAdditionalFeatureList", + "documentation":"A list of optional additional parameters, such as time zone, that can be requested for each result.
" + }, + "Language":{ + "shape":"LanguageTag", + "documentation":"A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
" + }, + "PoliticalView":{ + "shape":"CountryCode", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + }, + "IntendedUse":{ + "shape":"GeocodeIntendedUse", + "documentation":"Indicates if the results will be stored. Defaults to SingleUse, if left empty.
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + } + } + }, + "GeocodeRequestMaxResultsInteger":{ + "type":"integer", + "box":true, + "max":100, + "min":1 + }, + "GeocodeRequestQueryTextString":{ + "type":"string", + "max":200, + "min":1, + "sensitive":true + }, + "GeocodeResponse":{ + "type":"structure", + "required":["PricingBucket"], + "members":{ + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + }, + "ResultItems":{ + "shape":"GeocodeResultItemList", + "documentation":"List of places or results returned for a query.
" + } + } + }, + "GeocodeResultItem":{ + "type":"structure", + "required":[ + "PlaceId", + "PlaceType", + "Title" + ], + "members":{ + "PlaceId":{ + "shape":"GeocodeResultItemPlaceIdString", + "documentation":"The PlaceId of the place you wish to receive the information for.
A PlaceType is a category that the result place must belong to.
The localized display name of this result item based on request parameter language.
The place's address.
" + }, + "AddressNumberCorrected":{ + "shape":"Boolean", + "documentation":"Boolean indicating if the address provided has been corrected.
" + }, + "PostalCodeDetails":{ + "shape":"PostalCodeDetailsList", + "documentation":"Contains details about the postal code of the place/result.
" + }, + "Position":{ + "shape":"Position", + "documentation":"The position in longitude and latitude.
" + }, + "Distance":{ + "shape":"DistanceMeters", + "documentation":"The distance in meters from the QueryPosition.
" + }, + "MapView":{ + "shape":"BoundingBox", + "documentation":"The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates: [{westward lng}, {southern lat}, {eastward lng}, {northern lat}]
Categories of results that results must belong to.
" + }, + "FoodTypes":{ + "shape":"FoodTypeList", + "documentation":"List of food types offered by this result.
" + }, + "AccessPoints":{ + "shape":"AccessPointList", + "documentation":"Position of the access point represent by longitude and latitude.
" + }, + "TimeZone":{ + "shape":"TimeZone", + "documentation":"The time zone in which the place is located.
" + }, + "PoliticalView":{ + "shape":"CountryCode3", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + }, + "MatchScores":{ + "shape":"MatchScoreDetails", + "documentation":"Indicates how well the entire input matches the returned. It is equal to 1 if all input tokens are recognized and matched.
" + } + }, + "documentation":"The Geocoded result.
" + }, + "GeocodeResultItemList":{ + "type":"list", + "member":{"shape":"GeocodeResultItem"}, + "max":100, + "min":0 + }, + "GeocodeResultItemPlaceIdString":{ + "type":"string", + "max":200, + "min":0 + }, + "GeocodeResultItemTitleString":{ + "type":"string", + "max":200, + "min":0 + }, + "GetPlaceAdditionalFeature":{ + "type":"string", + "enum":[ + "TimeZone", + "Phonemes", + "Access", + "Contact" + ] + }, + "GetPlaceAdditionalFeatureList":{ + "type":"list", + "member":{"shape":"GetPlaceAdditionalFeature"}, + "max":4, + "min":1 + }, + "GetPlaceIntendedUse":{ + "type":"string", + "enum":[ + "SingleUse", + "Storage" + ] + }, + "GetPlaceRequest":{ + "type":"structure", + "required":["PlaceId"], + "members":{ + "PlaceId":{ + "shape":"GetPlaceRequestPlaceIdString", + "documentation":"The PlaceId of the place you wish to receive the information for.
A list of optional additional parameters such as time zone that can be requested for each result.
", + "location":"querystring", + "locationName":"additional-features" + }, + "Language":{ + "shape":"LanguageTag", + "documentation":"A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
", + "location":"querystring", + "locationName":"language" + }, + "PoliticalView":{ + "shape":"CountryCode", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
", + "location":"querystring", + "locationName":"political-view" + }, + "IntendedUse":{ + "shape":"GetPlaceIntendedUse", + "documentation":"Indicates if the results will be stored. Defaults to SingleUse, if left empty.
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + } + } + }, + "GetPlaceRequestPlaceIdString":{ + "type":"string", + "max":200, + "min":0, + "sensitive":true + }, + "GetPlaceResponse":{ + "type":"structure", + "required":[ + "PlaceId", + "PlaceType", + "Title", + "PricingBucket" + ], + "members":{ + "PlaceId":{ + "shape":"GetPlaceResponsePlaceIdString", + "documentation":"The PlaceId of the place you wish to receive the information for.
A PlaceType is a category that the result place must belong to.
The localized display name of this result item based on request parameter language.
The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + }, + "Address":{ + "shape":"Address", + "documentation":"The place's address.
" + }, + "AddressNumberCorrected":{ + "shape":"Boolean", + "documentation":"Boolean indicating if the address provided has been corrected.
" + }, + "PostalCodeDetails":{ + "shape":"PostalCodeDetailsList", + "documentation":"Contains details about the postal code of the place/result.
" + }, + "Position":{ + "shape":"Position", + "documentation":"The position, in longitude and latitude.
" + }, + "MapView":{ + "shape":"BoundingBox", + "documentation":"The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set of four coordinates: [{westward lng}, {southern lat}, {eastward lng}, {northern lat}]
Categories of results that results must belong to.
" + }, + "FoodTypes":{ + "shape":"FoodTypeList", + "documentation":"List of food types offered by this result.
" + }, + "BusinessChains":{ + "shape":"BusinessChainList", + "documentation":"The Business Chains associated with the place.
" + }, + "Contacts":{ + "shape":"Contacts", + "documentation":"List of potential contact methods for the result/place.
" + }, + "OpeningHours":{ + "shape":"OpeningHoursList", + "documentation":"List of opening hours objects.
" + }, + "AccessPoints":{ + "shape":"AccessPointList", + "documentation":"Position of the access point in (lng,lat).
Indicates known access restrictions on a vehicle access point. The index correlates to an access point and indicates if access through this point has some form of restriction.
" + }, + "TimeZone":{ + "shape":"TimeZone", + "documentation":"The time zone in which the place is located.
" + }, + "PoliticalView":{ + "shape":"CountryCode3", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + }, + "Phonemes":{ + "shape":"PhonemeDetails", + "documentation":"How the various components of the result's address are pronounced in various languages.
" + } + } + }, + "GetPlaceResponsePlaceIdString":{ + "type":"string", + "max":200, + "min":0 + }, + "GetPlaceResponseTitleString":{ + "type":"string", + "max":200, + "min":0 + }, + "Highlight":{ + "type":"structure", + "members":{ + "StartIndex":{ + "shape":"HighlightStartIndexInteger", + "documentation":"Start index of the highlight.
" + }, + "EndIndex":{ + "shape":"HighlightEndIndexInteger", + "documentation":"End index of the highlight.
" + }, + "Value":{ + "shape":"HighlightValueString", + "documentation":"The highlight's value.
" + } + }, + "documentation":"Describes how parts of the result response match the input query.
" + }, + "HighlightEndIndexInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "HighlightList":{ + "type":"list", + "member":{"shape":"Highlight"}, + "max":200, + "min":0 + }, + "HighlightStartIndexInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "HighlightValueString":{ + "type":"string", + "max":200, + "min":0 + }, + "InternalServerException":{ + "type":"structure", + "required":["Message"], + "members":{ + "Message":{ + "shape":"String", + "locationName":"message" + } + }, + "documentation":"The request processing has failed because of an unknown error, exception or failure.
", + "error":{"httpStatusCode":500}, + "exception":true, + "fault":true, + "retryable":{"throttling":false} + }, + "IntersectionHighlightsList":{ + "type":"list", + "member":{"shape":"HighlightList"}, + "max":100, + "min":1 + }, + "IntersectionList":{ + "type":"list", + "member":{"shape":"IntersectionStreet"}, + "max":100, + "min":1 + }, + "IntersectionStreet":{ + "type":"string", + "max":200, + "min":0 + }, + "LanguageTag":{ + "type":"string", + "max":35, + "min":2 + }, + "MatchScore":{ + "type":"double", + "max":1, + "min":0 + }, + "MatchScoreDetails":{ + "type":"structure", + "members":{ + "Overall":{ + "shape":"MatchScore", + "documentation":"Indicates how well the entire input matches the returned. It is equal to 1 if all input tokens are recognized and matched.
" + }, + "Components":{ + "shape":"ComponentMatchScores", + "documentation":"Indicates how well the component input matches the returned. It is equal to 1 if all input tokens are recognized and matched.
" + } + }, + "documentation":"Details related to the match score.
" + }, + "OpeningHours":{ + "type":"structure", + "members":{ + "Display":{ + "shape":"OpeningHoursDisplayList", + "documentation":"List of opening hours in the format they are displayed in. This can vary by result and in most cases represents how the result uniquely formats their opening hours.
" + }, + "OpenNow":{ + "shape":"Boolean", + "documentation":"Boolean which indicates if the result/place is currently open.
" + }, + "Components":{ + "shape":"OpeningHoursComponentsList", + "documentation":"Components of the opening hours object.
" + }, + "Categories":{ + "shape":"CategoryList", + "documentation":"Categories of results that results must belong too.
" + } + }, + "documentation":"List of opening hours objects.
" + }, + "OpeningHoursComponents":{ + "type":"structure", + "members":{ + "OpenTime":{ + "shape":"OpeningHoursComponentsOpenTimeString", + "documentation":"String which represents the opening hours, such as \"T070000\".
String which represents the duration of the opening period, such as \"PT12H00M\".
Days or periods when the provided opening hours are in affect.
Example: FREQ:DAILY;BYDAY:MO,TU,WE,TH,SU
Components of the opening hours object.
" + }, + "OpeningHoursComponentsList":{ + "type":"list", + "member":{"shape":"OpeningHoursComponents"}, + "max":100, + "min":1 + }, + "OpeningHoursComponentsOpenDurationString":{ + "type":"string", + "max":200, + "min":0 + }, + "OpeningHoursComponentsOpenTimeString":{ + "type":"string", + "max":21, + "min":0 + }, + "OpeningHoursComponentsRecurrenceString":{ + "type":"string", + "max":200, + "min":0 + }, + "OpeningHoursDisplay":{ + "type":"string", + "max":200, + "min":0 + }, + "OpeningHoursDisplayList":{ + "type":"list", + "member":{"shape":"OpeningHoursDisplay"}, + "max":100, + "min":1 + }, + "OpeningHoursList":{ + "type":"list", + "member":{"shape":"OpeningHours"}, + "max":100, + "min":1 + }, + "PhonemeDetails":{ + "type":"structure", + "members":{ + "Title":{ + "shape":"PhonemeTranscriptionList", + "documentation":"List of PhonemeTranscription. See PhonemeTranscription for fields.
How to pronounce the address.
" + } + }, + "documentation":"The phoneme details.
" + }, + "PhonemeTranscription":{ + "type":"structure", + "members":{ + "Value":{ + "shape":"PhonemeTranscriptionValueString", + "documentation":"Value which indicates how to pronounce the value.
" + }, + "Language":{ + "shape":"LanguageTag", + "documentation":"A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
" + }, + "Preferred":{ + "shape":"Boolean", + "documentation":"Boolean which indicates if it the preferred pronunciation.
" + } + }, + "documentation":"How to pronounce the various components of the address or place.
" + }, + "PhonemeTranscriptionList":{ + "type":"list", + "member":{"shape":"PhonemeTranscription"}, + "max":100, + "min":0 + }, + "PhonemeTranscriptionValueString":{ + "type":"string", + "max":50, + "min":0 + }, + "PlaceType":{ + "type":"string", + "enum":[ + "Country", + "Region", + "SubRegion", + "Locality", + "District", + "SubDistrict", + "PostalCode", + "Block", + "SubBlock", + "Intersection", + "Street", + "PointOfInterest", + "PointAddress", + "InterpolatedAddress" + ] + }, + "Position":{ + "type":"list", + "member":{"shape":"Double"}, + "max":2, + "min":2, + "sensitive":true + }, + "PostalAuthority":{ + "type":"string", + "enum":["Usps"] + }, + "PostalCodeDetails":{ + "type":"structure", + "members":{ + "PostalCode":{ + "shape":"PostalCodeDetailsPostalCodeString", + "documentation":"An alphanumeric string included in a postal address to facilitate mail sorting, such as post code, postcode, or ZIP code for which the result should posses.
" + }, + "PostalAuthority":{ + "shape":"PostalAuthority", + "documentation":"The postal authority or entity. This could be a governmental authority, a regulatory authority, or a designated postal operator.
" + }, + "PostalCodeType":{ + "shape":"PostalCodeType", + "documentation":"The postal code type.
" + }, + "UspsZip":{ + "shape":"UspsZip", + "documentation":"The ZIP Classification Code, or in other words what type of postal code is it.
" + }, + "UspsZipPlus4":{ + "shape":"UspsZipPlus4", + "documentation":"The USPS ZIP+4 Record Type Code.
" + } + }, + "documentation":"Contains details about the postal code of the place or result.
" + }, + "PostalCodeDetailsList":{ + "type":"list", + "member":{"shape":"PostalCodeDetails"}, + "max":100, + "min":0 + }, + "PostalCodeDetailsPostalCodeString":{ + "type":"string", + "max":50, + "min":0 + }, + "PostalCodeMode":{ + "type":"string", + "enum":[ + "MergeAllSpannedLocalities", + "EnumerateSpannedLocalities" + ] + }, + "PostalCodeType":{ + "type":"string", + "enum":[ + "UspsZip", + "UspsZipPlus4" + ] + }, + "QueryRefinement":{ + "type":"structure", + "required":[ + "RefinedTerm", + "OriginalTerm", + "StartIndex", + "EndIndex" + ], + "members":{ + "RefinedTerm":{ + "shape":"QueryRefinementRefinedTermString", + "documentation":"The term that will be suggested to the user.
" + }, + "OriginalTerm":{ + "shape":"QueryRefinementOriginalTermString", + "documentation":"The sub-string of the original query that is replaced by this query term.
" + }, + "StartIndex":{ + "shape":"QueryRefinementStartIndexInteger", + "documentation":"Start index of the parsed component.
" + }, + "EndIndex":{ + "shape":"QueryRefinementEndIndexInteger", + "documentation":"End index of the parsed query.
" + } + }, + "documentation":"Suggestions for refining individual query terms. Suggestions are returned as objects which note the term, suggested replacement, and its index in the query.
" + }, + "QueryRefinementEndIndexInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "QueryRefinementList":{ + "type":"list", + "member":{"shape":"QueryRefinement"}, + "max":10, + "min":0 + }, + "QueryRefinementOriginalTermString":{ + "type":"string", + "max":200, + "min":0 + }, + "QueryRefinementRefinedTermString":{ + "type":"string", + "max":200, + "min":0 + }, + "QueryRefinementStartIndexInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "QueryType":{ + "type":"string", + "enum":[ + "Category", + "BusinessChain" + ] + }, + "RecordTypeCode":{ + "type":"string", + "enum":[ + "Firm", + "General", + "HighRise", + "PostOfficeBox", + "Rural", + "Street" + ] + }, + "Region":{ + "type":"structure", + "members":{ + "Code":{ + "shape":"RegionCodeString", + "documentation":"Abbreviated code for a the state, province or region of the country.
Example: BC.
Name for a the state, province, or region of the country.
Example: British Columbia.
The region or state results should be to be present in.
Example: North Rhine-Westphalia.
Indicates the starting and ending index of the region in the text query that match the found title.
" + }, + "Name":{ + "shape":"HighlightList", + "documentation":"Indicates the starting and ending index of the region name in the text query that match the found title.
" + } + }, + "documentation":"Indicates the starting and ending index of the region in the text query that match the found title.
" + }, + "RegionNameString":{ + "type":"string", + "max":200, + "min":0 + }, + "ReverseGeocodeAdditionalFeature":{ + "type":"string", + "enum":[ + "TimeZone", + "Access" + ] + }, + "ReverseGeocodeAdditionalFeatureList":{ + "type":"list", + "member":{"shape":"ReverseGeocodeAdditionalFeature"}, + "max":2, + "min":1 + }, + "ReverseGeocodeFilter":{ + "type":"structure", + "members":{ + "IncludePlaceTypes":{ + "shape":"ReverseGeocodeFilterPlaceTypeList", + "documentation":"The included place types.
" + } + }, + "documentation":"The included place types.
" + }, + "ReverseGeocodeFilterPlaceType":{ + "type":"string", + "enum":[ + "Locality", + "Intersection", + "Street", + "PointAddress", + "InterpolatedAddress" + ] + }, + "ReverseGeocodeFilterPlaceTypeList":{ + "type":"list", + "member":{"shape":"ReverseGeocodeFilterPlaceType"}, + "max":5, + "min":1 + }, + "ReverseGeocodeIntendedUse":{ + "type":"string", + "enum":[ + "SingleUse", + "Storage" + ] + }, + "ReverseGeocodeRequest":{ + "type":"structure", + "required":["QueryPosition"], + "members":{ + "QueryPosition":{ + "shape":"Position", + "documentation":"The position, in [lng, lat] for which you are querying nearby resultsfor. Results closer to the position will be ranked higher then results further away from the position
The maximum distance in meters from the QueryPosition from which a result will be returned.
", + "box":true + }, + "MaxResults":{ + "shape":"ReverseGeocodeRequestMaxResultsInteger", + "documentation":"An optional limit for the number of results returned in a single call.
" + }, + "Filter":{ + "shape":"ReverseGeocodeFilter", + "documentation":"A structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
" + }, + "AdditionalFeatures":{ + "shape":"ReverseGeocodeAdditionalFeatureList", + "documentation":"A list of optional additional parameters, such as time zone that can be requested for each result.
" + }, + "Language":{ + "shape":"LanguageTag", + "documentation":"A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
" + }, + "PoliticalView":{ + "shape":"CountryCode", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + }, + "IntendedUse":{ + "shape":"ReverseGeocodeIntendedUse", + "documentation":"Indicates if the results will be stored. Defaults to SingleUse, if left empty.
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + } + } + }, + "ReverseGeocodeRequestMaxResultsInteger":{ + "type":"integer", + "box":true, + "max":100, + "min":1 + }, + "ReverseGeocodeRequestQueryRadiusLong":{ + "type":"long", + "max":21000000, + "min":1 + }, + "ReverseGeocodeResponse":{ + "type":"structure", + "required":["PricingBucket"], + "members":{ + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + }, + "ResultItems":{ + "shape":"ReverseGeocodeResultItemList", + "documentation":"List of places or results returned for a query.
" + } + } + }, + "ReverseGeocodeResultItem":{ + "type":"structure", + "required":[ + "PlaceId", + "PlaceType", + "Title" + ], + "members":{ + "PlaceId":{ + "shape":"ReverseGeocodeResultItemPlaceIdString", + "documentation":"The PlaceId of the place you wish to receive the information for.
A PlaceType is a category that the result place must belong to.
The localized display name of this result item based on request parameter language.
The place's address.
" + }, + "AddressNumberCorrected":{ + "shape":"Boolean", + "documentation":"Boolean indicating if the address provided has been corrected.
" + }, + "PostalCodeDetails":{ + "shape":"PostalCodeDetailsList", + "documentation":"Contains details about the postal code of the place/result.
" + }, + "Position":{ + "shape":"Position", + "documentation":"The position in longitude and latitude.
" + }, + "Distance":{ + "shape":"DistanceMeters", + "documentation":"The distance in meters from the QueryPosition.
" + }, + "MapView":{ + "shape":"BoundingBox", + "documentation":"The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates: [{westward lng}, {southern lat}, {eastward lng}, {northern lat}]
Categories of results that results must belong to.
" + }, + "FoodTypes":{ + "shape":"FoodTypeList", + "documentation":"List of food types offered by this result.
" + }, + "AccessPoints":{ + "shape":"AccessPointList", + "documentation":"Position of the access point represent by longitude and latitude.
" + }, + "TimeZone":{ + "shape":"TimeZone", + "documentation":"The time zone in which the place is located.
" + }, + "PoliticalView":{ + "shape":"CountryCode3", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + } + }, + "documentation":"The returned location from the Reverse Geocode action.
The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates: [{westward lng}, {southern lat}, {eastward lng}, {northern lat}]
A list of countries that all results must be in. Countries are represented by either their alpha-2 or alpha-3 character codes.
" + }, + "IncludeCategories":{ + "shape":"FilterCategoryList", + "documentation":"Categories of results that results must belong too.
" + }, + "ExcludeCategories":{ + "shape":"FilterCategoryList", + "documentation":"Categories of results that results are excluded from.
" + }, + "IncludeBusinessChains":{ + "shape":"FilterBusinessChainList", + "documentation":"The Business Chains associated with the place.
" + }, + "ExcludeBusinessChains":{ + "shape":"FilterBusinessChainList", + "documentation":"The Business Chains associated with the place.
" + }, + "IncludeFoodTypes":{ + "shape":"FilterFoodTypeList", + "documentation":"Food types that results are included from.
" + }, + "ExcludeFoodTypes":{ + "shape":"FilterFoodTypeList", + "documentation":"Food types that results are excluded from.
" + } + }, + "documentation":"SearchNearby structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
" + }, + "SearchNearbyIntendedUse":{ + "type":"string", + "enum":[ + "SingleUse", + "Storage" + ] + }, + "SearchNearbyRequest":{ + "type":"structure", + "required":["QueryPosition"], + "members":{ + "QueryPosition":{ + "shape":"Position", + "documentation":"The position, in [lng, lat] for which you are querying nearby resultsfor. Results closer to the position will be ranked higher then results further away from the position
The maximum distance in meters from the QueryPosition from which a result will be returned.
", + "box":true + }, + "MaxResults":{ + "shape":"SearchNearbyRequestMaxResultsInteger", + "documentation":"An optional limit for the number of results returned in a single call.
" + }, + "Filter":{ + "shape":"SearchNearbyFilter", + "documentation":"A structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
" + }, + "AdditionalFeatures":{ + "shape":"SearchNearbyAdditionalFeatureList", + "documentation":"A list of optional additional parameters, such as time zone, that can be requested for each result.
" + }, + "Language":{ + "shape":"LanguageTag", + "documentation":"A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
" + }, + "PoliticalView":{ + "shape":"CountryCode", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + }, + "IntendedUse":{ + "shape":"SearchNearbyIntendedUse", + "documentation":"Indicates if the results will be stored. Defaults to SingleUse, if left empty.
If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page.
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + } + } + }, + "SearchNearbyRequestMaxResultsInteger":{ + "type":"integer", + "box":true, + "max":100, + "min":1 + }, + "SearchNearbyRequestQueryRadiusLong":{ + "type":"long", + "max":21000000, + "min":1 + }, + "SearchNearbyResponse":{ + "type":"structure", + "required":["PricingBucket"], + "members":{ + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + }, + "ResultItems":{ + "shape":"SearchNearbyResultItemList", + "documentation":"List of places or results returned for a query.
" + }, + "NextToken":{ + "shape":"Token", + "documentation":"If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page.
The PlaceId of the place you wish to receive the information for.
A PlaceType is a category that the result place must belong to.
The item's title.
" + }, + "Address":{ + "shape":"Address", + "documentation":"The place's address.
" + }, + "AddressNumberCorrected":{ + "shape":"Boolean", + "documentation":"Boolean indicating if the address provided has been corrected.
" + }, + "Position":{ + "shape":"Position", + "documentation":"The position in longitude and latitude.
" + }, + "Distance":{ + "shape":"DistanceMeters", + "documentation":"The distance in meters from the QueryPosition.
" + }, + "MapView":{ + "shape":"BoundingBox", + "documentation":"The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates: [{westward lng}, {southern lat}, {eastward lng}, {northern lat}]
Categories of results that results must belong to.
" + }, + "FoodTypes":{ + "shape":"FoodTypeList", + "documentation":"List of food types offered by this result.
" + }, + "BusinessChains":{ + "shape":"BusinessChainList", + "documentation":"The Business Chains associated with the place.
" + }, + "Contacts":{ + "shape":"Contacts", + "documentation":"List of potential contact methods for the result/place.
" + }, + "OpeningHours":{ + "shape":"OpeningHoursList", + "documentation":"List of opening hours objects.
" + }, + "AccessPoints":{ + "shape":"AccessPointList", + "documentation":"Position of the access point represent by longitude and latitude.
" + }, + "AccessRestrictions":{ + "shape":"AccessRestrictionList", + "documentation":"Indicates known access restrictions on a vehicle access point. The index correlates to an access point and indicates if access through this point has some form of restriction.
" + }, + "TimeZone":{ + "shape":"TimeZone", + "documentation":"The time zone in which the place is located.
" + }, + "PoliticalView":{ + "shape":"CountryCode3", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + }, + "Phonemes":{ + "shape":"PhonemeDetails", + "documentation":"How the various components of the result's address are pronounced in various languages.
" + } + }, + "documentation":"The search results of nearby places.
" + }, + "SearchNearbyResultItemList":{ + "type":"list", + "member":{"shape":"SearchNearbyResultItem"}, + "max":100, + "min":0 + }, + "SearchNearbyResultItemPlaceIdString":{ + "type":"string", + "max":200, + "min":0 + }, + "SearchNearbyResultItemTitleString":{ + "type":"string", + "max":200, + "min":0 + }, + "SearchTextAdditionalFeature":{ + "type":"string", + "enum":[ + "TimeZone", + "Phonemes", + "Access", + "Contact" + ] + }, + "SearchTextAdditionalFeatureList":{ + "type":"list", + "member":{"shape":"SearchTextAdditionalFeature"}, + "max":4, + "min":1 + }, + "SearchTextFilter":{ + "type":"structure", + "members":{ + "BoundingBox":{ + "shape":"BoundingBox", + "documentation":"The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates: [{westward lng}, {southern lat}, {eastward lng}, {northern lat}]
A list of countries that all results must be in. Countries are represented by either their alpha-2 or alpha-3 character codes.
" + } + }, + "documentation":"SearchText structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
" + }, + "SearchTextIntendedUse":{ + "type":"string", + "enum":[ + "SingleUse", + "Storage" + ] + }, + "SearchTextRequest":{ + "type":"structure", + "members":{ + "QueryText":{ + "shape":"SearchTextRequestQueryTextString", + "documentation":"The free-form text query to match addresses against. This is usually a partially typed address from an end user in an address box or form.
" + }, + "QueryId":{ + "shape":"SearchTextRequestQueryIdString", + "documentation":"The query Id.
" + }, + "MaxResults":{ + "shape":"SearchTextRequestMaxResultsInteger", + "documentation":"An optional limit for the number of results returned in a single call.
" + }, + "BiasPosition":{ + "shape":"Position", + "documentation":"The position, in longitude and latitude, that the results should be close to. Typically, place results returned are ranked higher the closer they are to this position. Stored in [lng, lat] and in the WSG84 format.
The fields BiasPosition, FilterBoundingBox, and FilterCircle are mutually exclusive.
A structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
" + }, + "AdditionalFeatures":{ + "shape":"SearchTextAdditionalFeatureList", + "documentation":"A list of optional additional parameters, such as time zone, that can be requested for each result.
" + }, + "Language":{ + "shape":"LanguageTag", + "documentation":"A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
" + }, + "PoliticalView":{ + "shape":"CountryCode", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + }, + "IntendedUse":{ + "shape":"SearchTextIntendedUse", + "documentation":"Indicates if the results will be stored. Defaults to SingleUse, if left empty.
If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page.
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + } + } + }, + "SearchTextRequestMaxResultsInteger":{ + "type":"integer", + "box":true, + "max":100, + "min":1 + }, + "SearchTextRequestQueryIdString":{ + "type":"string", + "max":400, + "min":1, + "sensitive":true + }, + "SearchTextRequestQueryTextString":{ + "type":"string", + "max":200, + "min":1, + "sensitive":true + }, + "SearchTextResponse":{ + "type":"structure", + "required":["PricingBucket"], + "members":{ + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + }, + "ResultItems":{ + "shape":"SearchTextResultItemList", + "documentation":"List of places or results returned for a query.
" + }, + "NextToken":{ + "shape":"Token", + "documentation":"If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page.
The PlaceId of the place you wish to receive the information for.
A PlaceType is a category that the result place must belong to.
The item's title.
" + }, + "Address":{ + "shape":"Address", + "documentation":"The place's address.
" + }, + "AddressNumberCorrected":{ + "shape":"Boolean", + "documentation":"Boolean indicating if the address provided has been corrected.
" + }, + "Position":{ + "shape":"Position", + "documentation":"The position, in longitude and latitude.
" + }, + "Distance":{ + "shape":"DistanceMeters", + "documentation":"The distance in meters from the QueryPosition.
" + }, + "MapView":{ + "shape":"BoundingBox", + "documentation":"The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates: [{westward lng}, {southern lat}, {eastward lng}, {northern lat}]
Categories of results that results must belong to.
" + }, + "FoodTypes":{ + "shape":"FoodTypeList", + "documentation":"List of food types offered by this result.
" + }, + "BusinessChains":{ + "shape":"BusinessChainList", + "documentation":"The Business Chains associated with the place.
" + }, + "Contacts":{ + "shape":"Contacts", + "documentation":"List of potential contact methods for the result/place.
" + }, + "OpeningHours":{ + "shape":"OpeningHoursList", + "documentation":"List of opening hours objects.
" + }, + "AccessPoints":{ + "shape":"AccessPointList", + "documentation":"Position of the access point represent by longitude and latitude.
" + }, + "AccessRestrictions":{ + "shape":"AccessRestrictionList", + "documentation":"Indicates known access restrictions on a vehicle access point. The index correlates to an access point and indicates if access through this point has some form of restriction.
" + }, + "TimeZone":{ + "shape":"TimeZone", + "documentation":"The time zone in which the place is located.
" + }, + "PoliticalView":{ + "shape":"CountryCode3", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + }, + "Phonemes":{ + "shape":"PhonemeDetails", + "documentation":"How the various components of the result's address are pronounced in various languages.
" + } + }, + "documentation":"The text search result.
" + }, + "SearchTextResultItemList":{ + "type":"list", + "member":{"shape":"SearchTextResultItem"}, + "max":100, + "min":0 + }, + "SearchTextResultItemPlaceIdString":{ + "type":"string", + "max":200, + "min":0 + }, + "SearchTextResultItemTitleString":{ + "type":"string", + "max":200, + "min":0 + }, + "StreetComponents":{ + "type":"structure", + "members":{ + "BaseName":{ + "shape":"StreetComponentsBaseNameString", + "documentation":"Base name part of the street name.
Example: Younge from the “Younge street\".
" + }, + "Type":{ + "shape":"StreetComponentsTypeString", + "documentation":"Street type part of the street name.
Example: “avenue\".
Defines if the street type is before or after the base name.
" + }, + "TypeSeparator":{ + "shape":"TypeSeparator", + "documentation":"What character(s) separates the string from its type.
" + }, + "Prefix":{ + "shape":"StreetComponentsPrefixString", + "documentation":"A prefix is a directional identifier that precedes, but is not included in, the base name of a road.
Example: E for East.
" + }, + "Suffix":{ + "shape":"StreetComponentsSuffixString", + "documentation":"A suffix is a directional identifier that follows, but is not included in, the base name of a road.
Example W for West.
" + }, + "Direction":{ + "shape":"StreetComponentsDirectionString", + "documentation":"Indicates the official directional identifiers assigned to highways.
" + }, + "Language":{ + "shape":"LanguageTag", + "documentation":"A BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
" + } + }, + "documentation":"Components of a street.
" + }, + "StreetComponentsBaseNameString":{ + "type":"string", + "max":200, + "min":0 + }, + "StreetComponentsDirectionString":{ + "type":"string", + "max":50, + "min":0 + }, + "StreetComponentsList":{ + "type":"list", + "member":{"shape":"StreetComponents"}, + "max":100, + "min":0 + }, + "StreetComponentsPrefixString":{ + "type":"string", + "max":50, + "min":0 + }, + "StreetComponentsSuffixString":{ + "type":"string", + "max":50, + "min":0 + }, + "StreetComponentsTypeString":{ + "type":"string", + "max":50, + "min":0 + }, + "String":{"type":"string"}, + "SubRegion":{ + "type":"structure", + "members":{ + "Code":{ + "shape":"SubRegionCodeString", + "documentation":"Abbreviated code for the county or sub-region.
" + }, + "Name":{ + "shape":"SubRegionNameString", + "documentation":"Name for the county or sub-region.
" + } + }, + "documentation":"The sub-region.
" + }, + "SubRegionCodeString":{ + "type":"string", + "max":3, + "min":0 + }, + "SubRegionHighlights":{ + "type":"structure", + "members":{ + "Code":{ + "shape":"HighlightList", + "documentation":"Indicates the starting and ending index of the sub-region in the text query that match the found title.
" + }, + "Name":{ + "shape":"HighlightList", + "documentation":"Indicates the starting and ending index of the name in the text query that match the found title.
" + } + }, + "documentation":"Indicates the starting and ending index of the sub-region in the text query that match the found title.
" + }, + "SubRegionNameString":{ + "type":"string", + "max":200, + "min":0 + }, + "SuggestAdditionalFeature":{ + "type":"string", + "enum":[ + "Core", + "TimeZone", + "Phonemes", + "Access" + ] + }, + "SuggestAdditionalFeatureList":{ + "type":"list", + "member":{"shape":"SuggestAdditionalFeature"}, + "max":4, + "min":1 + }, + "SuggestAddressHighlights":{ + "type":"structure", + "members":{ + "Label":{ + "shape":"HighlightList", + "documentation":"Indicates the starting and ending indexes of the places in the result which were identified to match the textQuery. This result is useful for providing emphasis to results where the user query directly matched to make selecting the correct result from a list easier for an end user.
" + } + }, + "documentation":"Describes how the parts of the textQuery matched the input query by returning the sections of the response which matched to textQuery terms.
" + }, + "SuggestFilter":{ + "type":"structure", + "members":{ + "BoundingBox":{ + "shape":"BoundingBox", + "documentation":"The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates: [{westward lng}, {southern lat}, {eastward lng}, {northern lat}]
A list of countries that all results must be in. Countries are represented by either their alpha-2 or alpha-3 character codes.
" + } + }, + "documentation":"SuggestFilter structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
" + }, + "SuggestHighlights":{ + "type":"structure", + "members":{ + "Title":{ + "shape":"HighlightList", + "documentation":"Indicates the starting and ending index of the title in the text query that match the found title.
" + }, + "Address":{ + "shape":"SuggestAddressHighlights", + "documentation":"The place's address.
" + } + }, + "documentation":"Describes how the parts of the textQuery matched the input query by returning the sections of the response which matched to textQuery terms.
" + }, + "SuggestIntendedUse":{ + "type":"string", + "enum":["SingleUse"] + }, + "SuggestPlaceResult":{ + "type":"structure", + "members":{ + "PlaceId":{ + "shape":"SuggestPlaceResultPlaceIdString", + "documentation":"The PlaceId of the place you wish to receive the information for.
A PlaceType is a category that the result place must belong to.
The place's address.
" + }, + "Position":{ + "shape":"Position", + "documentation":"The position, in longitude and latitude.
" + }, + "Distance":{ + "shape":"DistanceMeters", + "documentation":"The distance in meters from the QueryPosition.
" + }, + "MapView":{ + "shape":"BoundingBox", + "documentation":"The bounding box enclosing the geometric shape (area or line) that an individual result covers.
The bounding box formed is defined as a set 4 coordinates: [{westward lng}, {southern lat}, {eastward lng}, {northern lat}]
Categories of results that results must belong to.
" + }, + "FoodTypes":{ + "shape":"FoodTypeList", + "documentation":"List of food types offered by this result.
" + }, + "BusinessChains":{ + "shape":"BusinessChainList", + "documentation":"The Business Chains associated with the place.
" + }, + "AccessPoints":{ + "shape":"AccessPointList", + "documentation":"Position of the access point represent by longitude and latitude.
" + }, + "AccessRestrictions":{ + "shape":"AccessRestrictionList", + "documentation":"Indicates known access restrictions on a vehicle access point. The index correlates to an access point and indicates if access through this point has some form of restriction.
" + }, + "TimeZone":{ + "shape":"TimeZone", + "documentation":"The time zone in which the place is located.
" + }, + "PoliticalView":{ + "shape":"CountryCode3", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + }, + "Phonemes":{ + "shape":"PhonemeDetails", + "documentation":"How the various components of the result's address are pronounced in various languages.
" + } + }, + "documentation":"The suggested place results.
" + }, + "SuggestPlaceResultPlaceIdString":{ + "type":"string", + "max":200, + "min":1 + }, + "SuggestQueryResult":{ + "type":"structure", + "members":{ + "QueryId":{ + "shape":"SuggestQueryResultQueryIdString", + "documentation":"QueryId can be used to complete a follow up query through the SearchText API. The QueryId retains context from the original Suggest request such as filters, political view and language. See the SearchText API documentation for more details SearchText API docs.
" + }, + "QueryType":{ + "shape":"QueryType", + "documentation":"The query type. Category qeuries will search for places which have an entry matching the given category, for example \"doctor office\". BusinessChain queries will search for instances of a given business.
" + } + }, + "documentation":"The suggested query results.
" + }, + "SuggestQueryResultQueryIdString":{ + "type":"string", + "max":400, + "min":0 + }, + "SuggestRequest":{ + "type":"structure", + "required":["QueryText"], + "members":{ + "QueryText":{ + "shape":"SuggestRequestQueryTextString", + "documentation":"The free-form text query to match addresses against. This is usually a partially typed address from an end user in an address box or form.
" + }, + "MaxResults":{ + "shape":"SuggestRequestMaxResultsInteger", + "documentation":"An optional limit for the number of results returned in a single call.
" + }, + "MaxQueryRefinements":{ + "shape":"SuggestRequestMaxQueryRefinementsInteger", + "documentation":"Maximum number of query terms to be returned for use with a search text query.
" + }, + "BiasPosition":{ + "shape":"Position", + "documentation":"The position, in longitude and latitude, that the results should be close to. Typically, place results returned are ranked higher the closer they are to this position. Stored in [lng, lat] and in the WSG84 format.
The fields BiasPosition, FilterBoundingBox, and FilterCircle are mutually exclusive.
A structure which contains a set of inclusion/exclusion properties that results must posses in order to be returned as a result.
" + }, + "AdditionalFeatures":{ + "shape":"SuggestAdditionalFeatureList", + "documentation":"A list of optional additional parameters, such as time zone, that can be requested for each result.
" + }, + "Language":{ + "shape":"LanguageTag", + "documentation":"A list of BCP 47 compliant language codes for the results to be rendered in. If there is no data for the result in the requested language, data will be returned in the default language for the entry.
" + }, + "PoliticalView":{ + "shape":"CountryCode", + "documentation":"The alpha-2 or alpha-3 character code for the political view of a country. The political view applies to the results of the request to represent unresolved territorial claims through the point of view of the specified country.
" + }, + "IntendedUse":{ + "shape":"SuggestIntendedUse", + "documentation":"Indicates if the results will be stored. Defaults to SingleUse, if left empty.
Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + } + } + }, + "SuggestRequestMaxQueryRefinementsInteger":{ + "type":"integer", + "box":true, + "max":10, + "min":1 + }, + "SuggestRequestMaxResultsInteger":{ + "type":"integer", + "box":true, + "max":100, + "min":1 + }, + "SuggestRequestQueryTextString":{ + "type":"string", + "max":200, + "min":1, + "sensitive":true + }, + "SuggestResponse":{ + "type":"structure", + "required":["PricingBucket"], + "members":{ + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the query is charged at.
For more inforamtion on pricing, please visit Amazon Location Service Pricing.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + }, + "ResultItems":{ + "shape":"SuggestResultItemList", + "documentation":"List of places or results returned for a query.
" + }, + "QueryRefinements":{ + "shape":"QueryRefinementList", + "documentation":"Maximum number of query terms to be returned for use with a search text query.
" + } + } + }, + "SuggestResultItem":{ + "type":"structure", + "required":[ + "Title", + "SuggestResultItemType" + ], + "members":{ + "Title":{ + "shape":"SuggestResultItemTitleString", + "documentation":"The display title that should be used when presenting this option to the end user.
" + }, + "SuggestResultItemType":{ + "shape":"SuggestResultItemType", + "documentation":"The result type. Place results represent the final result for a point of interest, Query results represent a follow up query which can be completed through the SearchText operation.
" + }, + "Place":{ + "shape":"SuggestPlaceResult", + "documentation":"The suggested place by its unique ID.
" + }, + "Query":{"shape":"SuggestQueryResult"}, + "Highlights":{ + "shape":"SuggestHighlights", + "documentation":"Describes how the parts of the response element matched the input query by returning the sections of the response which matched to input query terms.
" + } + }, + "documentation":"The resulting item from the suggested query.
" + }, + "SuggestResultItemList":{ + "type":"list", + "member":{"shape":"SuggestResultItem"}, + "max":100, + "min":0 + }, + "SuggestResultItemTitleString":{ + "type":"string", + "max":200, + "min":0 + }, + "SuggestResultItemType":{ + "type":"string", + "enum":[ + "Place", + "Query" + ] + }, + "ThrottlingException":{ + "type":"structure", + "required":["Message"], + "members":{ + "Message":{ + "shape":"String", + "locationName":"message" + } + }, + "documentation":"The request was denied due to request throttling.
", + "error":{ + "httpStatusCode":429, + "senderFault":true + }, + "exception":true, + "retryable":{"throttling":false} + }, + "TimeZone":{ + "type":"structure", + "required":["Name"], + "members":{ + "Name":{ + "shape":"TimeZoneNameString", + "documentation":"The time zone name.
" + }, + "Offset":{ + "shape":"TimeZoneOffsetString", + "documentation":"Time zone offset of the timezone from UTC.
" + }, + "OffsetSeconds":{ + "shape":"TimeZoneOffsetSecondsLong", + "documentation":"The offset of the time zone from UTC, in seconds.
" + } + }, + "documentation":"The time zone in which the place is located.
" + }, + "TimeZoneNameString":{ + "type":"string", + "max":200, + "min":0 + }, + "TimeZoneOffsetSecondsLong":{ + "type":"long", + "min":0 + }, + "TimeZoneOffsetString":{ + "type":"string", + "max":6, + "min":0 + }, + "Token":{ + "type":"string", + "max":2000, + "min":1 + }, + "TypePlacement":{ + "type":"string", + "enum":[ + "BeforeBaseName", + "AfterBaseName" + ] + }, + "TypeSeparator":{ + "type":"string", + "max":1, + "min":0, + "pattern":"$|^ " + }, + "UspsZip":{ + "type":"structure", + "members":{ + "ZipClassificationCode":{ + "shape":"ZipClassificationCode", + "documentation":"The ZIP Classification Code, or in other words what type of postal code is it.
" + } + }, + "documentation":"The USPS zip code.
" + }, + "UspsZipPlus4":{ + "type":"structure", + "members":{ + "RecordTypeCode":{ + "shape":"RecordTypeCode", + "documentation":"The USPS ZIP+4 Record Type Code.
" + } + }, + "documentation":"The USPS zip+4 code.
" + }, + "ValidationException":{ + "type":"structure", + "required":[ + "Message", + "Reason", + "FieldList" + ], + "members":{ + "Message":{ + "shape":"String", + "locationName":"message" + }, + "Reason":{ + "shape":"ValidationExceptionReason", + "documentation":"Test stub for reason
", + "locationName":"reason" + }, + "FieldList":{ + "shape":"ValidationExceptionFieldList", + "documentation":"Test stub for FieldList.
", + "locationName":"fieldList" + } + }, + "documentation":"The input fails to satisfy the constraints specified by an AWS service.
", + "error":{ + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, + "ValidationExceptionField":{ + "type":"structure", + "required":[ + "Name", + "Message" + ], + "members":{ + "Name":{ + "shape":"String", + "documentation":"The name of the resource.
", + "locationName":"name" + }, + "Message":{ + "shape":"String", + "documentation":"The error message.
", + "locationName":"message" + } + }, + "documentation":"The input fails to satisfy the constraints specified by the Amazon Location service.
" + }, + "ValidationExceptionFieldList":{ + "type":"list", + "member":{"shape":"ValidationExceptionField"} + }, + "ValidationExceptionReason":{ + "type":"string", + "enum":[ + "UnknownOperation", + "Missing", + "CannotParse", + "FieldValidationFailed", + "Other", + "UnknownField" + ] + }, + "ZipClassificationCode":{ + "type":"string", + "enum":[ + "Military", + "PostOfficeBoxes", + "Unique" + ] + } + }, + "documentation":"The Places API enables powerful location search and geocoding capabilities for your applications, offering global coverage with rich, detailed information. Key features include:
Forward and reverse geocoding for addresses and coordinates
Comprehensive place searches with detailed information, including:
Business names and addresses
Contact information
Hours of operation
POI (Points of Interest) categories
Food types for restaurants
Chain affiliation for relevant businesses
Global data coverage with a wide range of POI categories
Regular data updates to ensure accuracy and relevance
The user's mobile number.
" } }, - "documentation":"Contains information about the identity of a user.
For Amazon Connect instances that are created with the EXISTING_DIRECTORY identity management type, FirstName, LastName, and Email cannot be updated from within Amazon Connect because they are managed by the directory.
Contains information about the identity of a user.
For Amazon Connect instances that are created with the EXISTING_DIRECTORY identity management type, FirstName, LastName, and Email cannot be updated from within Amazon Connect because they are managed by the directory.
The FirstName and LastName length constraints below apply only to instances using SAML for identity management. If you are using Amazon Connect for identity management, the length constraints are 1-255 for FirstName, and 1-256 for LastName.
Creates a zero-ETL integration with Amazon Redshift.
" + "documentation":"Creates a zero-ETL integration or S3 event integration with Amazon Redshift.
" }, "CreateRedshiftIdcApplication":{ "name":"CreateRedshiftIdcApplication", @@ -817,7 +817,7 @@ {"shape":"IntegrationConflictOperationFault"}, {"shape":"UnsupportedOperationFault"} ], - "documentation":"Deletes a zero-ETL integration with Amazon Redshift.
" + "documentation":"Deletes a zero-ETL integration or S3 event integration with Amazon Redshift.
" }, "DeletePartner":{ "name":"DeletePartner", @@ -1334,7 +1334,7 @@ {"shape":"IntegrationNotFoundFault"}, {"shape":"UnsupportedOperationFault"} ], - "documentation":"Describes one or more zero-ETL integrations with Amazon Redshift.
" + "documentation":"Describes one or more zero-ETL or S3 event integrations with Amazon Redshift.
" }, "DescribeLoggingStatus":{ "name":"DescribeLoggingStatus", @@ -2117,7 +2117,7 @@ {"shape":"IntegrationAlreadyExistsFault"}, {"shape":"UnsupportedOperationFault"} ], - "documentation":"Modifies a zero-ETL integration with Amazon Redshift.
" + "documentation":"Modifies a zero-ETL integration or S3 event integration with Amazon Redshift.
" }, "ModifyRedshiftIdcApplication":{ "name":"ModifyRedshiftIdcApplication", @@ -4640,11 +4640,11 @@ ], "members":{ "SourceArn":{ - "shape":"String", + "shape":"SourceArn", "documentation":"The Amazon Resource Name (ARN) of the database to use as the source for replication.
" }, "TargetArn":{ - "shape":"String", + "shape":"TargetArn", "documentation":"The Amazon Resource Name (ARN) of the Amazon Redshift data warehouse to use as the target for replication.
" }, "IntegrationName":{ @@ -6009,11 +6009,11 @@ "type":"structure", "members":{ "IntegrationArn":{ - "shape":"String", + "shape":"InboundIntegrationArn", "documentation":"The Amazon Resource Name (ARN) of the inbound integration.
" }, "TargetArn":{ - "shape":"String", + "shape":"TargetArn", "documentation":"The Amazon Resource Name (ARN) of the target of an inbound integration.
" }, "MaxRecords":{ @@ -6441,7 +6441,7 @@ }, "ResourceType":{ "shape":"String", - "documentation":"The type of resource with which you want to view tags. Valid resource types are:
Cluster
CIDR/IP
EC2 security group
Snapshot
Cluster security group
Subnet group
HSM connection
HSM certificate
Parameter group
Snapshot copy grant
Integration (zero-ETL integration)
To describe the tags associated with an integration, don't specify ResourceType, instead specify the ResourceName of the integration.
For more information about Amazon Redshift resource types and constructing ARNs, go to Specifying Policy Elements: Actions, Effects, Resources, and Principals in the Amazon Redshift Cluster Management Guide.
" + "documentation":"The type of resource with which you want to view tags. Valid resource types are:
Cluster
CIDR/IP
EC2 security group
Snapshot
Cluster security group
Subnet group
HSM connection
HSM certificate
Parameter group
Snapshot copy grant
Integration (zero-ETL integration or S3 event integration)
To describe the tags associated with an integration, don't specify ResourceType, instead specify the ResourceName of the integration.
For more information about Amazon Redshift resource types and constructing ARNs, go to Specifying Policy Elements: Actions, Effects, Resources, and Principals in the Amazon Redshift Cluster Management Guide.
" }, "MaxRecords":{ "shape":"IntegerOptional", @@ -7520,7 +7520,7 @@ "type":"structure", "members":{ "IntegrationArn":{ - "shape":"String", + "shape":"InboundIntegrationArn", "documentation":"The Amazon Resource Name (ARN) of an inbound integration.
" }, "SourceArn":{ @@ -7528,7 +7528,7 @@ "documentation":"The Amazon Resource Name (ARN) of the source of an inbound integration.
" }, "TargetArn":{ - "shape":"String", + "shape":"TargetArn", "documentation":"The Amazon Resource Name (ARN) of the target of an inbound integration.
" }, "Status":{ @@ -7546,6 +7546,12 @@ }, "documentation":"The content of an inbound integration.
" }, + "InboundIntegrationArn":{ + "type":"string", + "max":255, + "min":1, + "pattern":"^arn:aws[a-z\\-]*:.+:[a-z0-9\\-]*:[0-9]*:integration:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" + }, "InboundIntegrationList":{ "type":"list", "member":{ @@ -7608,7 +7614,7 @@ "type":"structure", "members":{ "IntegrationArn":{ - "shape":"String", + "shape":"IntegrationArn", "documentation":"The Amazon Resource Name (ARN) of the integration.
" }, "IntegrationName":{ @@ -7616,11 +7622,11 @@ "documentation":"The name of the integration.
" }, "SourceArn":{ - "shape":"String", + "shape":"SourceArn", "documentation":"The Amazon Resource Name (ARN) of the database used as the source for replication.
" }, "TargetArn":{ - "shape":"String", + "shape":"TargetArn", "documentation":"The Amazon Resource Name (ARN) of the Amazon Redshift data warehouse to use as the target for replication.
" }, "Status":{ @@ -7669,7 +7675,7 @@ "type":"string", "max":255, "min":1, - "pattern":"arn:aws[a-z\\-]*:redshift:[a-z0-9\\-]*:[0-9]*:integration:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}" + "pattern":"^arn:aws[a-z\\-]*:redshift:[a-z0-9\\-]*:[0-9]*:integration:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$" }, "IntegrationConflictOperationFault":{ "type":"structure", @@ -7752,7 +7758,7 @@ "type":"structure", "members":{ }, - "documentation":"You can't create any more zero-ETL integrations because the quota has been reached.
", + "documentation":"You can't create any more zero-ETL or S3 event integrations because the quota has been reached.
", "error":{ "code":"IntegrationQuotaExceededFault", "httpStatusCode":400, @@ -11319,6 +11325,12 @@ "DESC" ] }, + "SourceArn":{ + "type":"string", + "max":255, + "min":1, + "pattern":"^arn:aws[a-z\\-]*:(s3|dynamodb):.*:.*:[a-zA-Z0-9._\\-\\/]+$" + }, "SourceIdsList":{ "type":"list", "member":{ @@ -11696,6 +11708,12 @@ }, "documentation":"" }, + "TargetArn":{ + "type":"string", + "max":2048, + "min":20, + "pattern":"^arn:aws[a-z\\-]*:redshift(-serverless)?:[a-z0-9\\-]+:[0-9]{12}:(namespace\\/|namespace:)[a-z0-9\\-]+$" + }, "TrackList":{ "type":"list", "member":{ From 73abaedf1f69c401a8950260afcd54aae4a3d0bf Mon Sep 17 00:00:00 2001 From: AWS <> Date: Wed, 30 Oct 2024 18:13:13 +0000 Subject: [PATCH 11/21] Amazon OpenSearch Service Update: This release introduces the new OpenSearch user interface (Dashboards), a new web-based application that can be associated with multiple data sources across OpenSearch managed clusters, serverless collections, and Amazon S3, so that users can gain a comprehensive insights in an unified interface. --- ...ature-AmazonOpenSearchService-b3ce932.json | 6 + .../codegen-resources/paginators-1.json | 6 + .../codegen-resources/service-2.json | 587 +++++++++++++++++- 3 files changed, 591 insertions(+), 8 deletions(-) create mode 100644 .changes/next-release/feature-AmazonOpenSearchService-b3ce932.json diff --git a/.changes/next-release/feature-AmazonOpenSearchService-b3ce932.json b/.changes/next-release/feature-AmazonOpenSearchService-b3ce932.json new file mode 100644 index 000000000000..988dca013865 --- /dev/null +++ b/.changes/next-release/feature-AmazonOpenSearchService-b3ce932.json @@ -0,0 +1,6 @@ +{ + "type": "feature", + "category": "Amazon OpenSearch Service", + "contributor": "", + "description": "This release introduces the new OpenSearch user interface (Dashboards), a new web-based application that can be associated with multiple data sources across OpenSearch managed clusters, serverless collections, and Amazon S3, so that users can gain a comprehensive insights in an unified interface." +} diff --git a/services/opensearch/src/main/resources/codegen-resources/paginators-1.json b/services/opensearch/src/main/resources/codegen-resources/paginators-1.json index d4ea79e70fcb..43a57aea1164 100644 --- a/services/opensearch/src/main/resources/codegen-resources/paginators-1.json +++ b/services/opensearch/src/main/resources/codegen-resources/paginators-1.json @@ -40,6 +40,12 @@ "output_token": "NextToken", "limit_key": "MaxResults" }, + "ListApplications": { + "input_token": "nextToken", + "output_token": "nextToken", + "limit_key": "maxResults", + "result_key": "ApplicationSummaries" + }, "ListDomainMaintenances": { "input_token": "NextToken", "output_token": "NextToken", diff --git a/services/opensearch/src/main/resources/codegen-resources/service-2.json b/services/opensearch/src/main/resources/codegen-resources/service-2.json index 86452bc4e2a5..0dd3f5a57a12 100644 --- a/services/opensearch/src/main/resources/codegen-resources/service-2.json +++ b/services/opensearch/src/main/resources/codegen-resources/service-2.json @@ -130,6 +130,25 @@ ], "documentation":"Cancels a scheduled service software update for an Amazon OpenSearch Service domain. You can only perform this operation before the AutomatedUpdateDate and when the domain's UpdateStatus is PENDING_UPDATE. For more information, see Service software updates in Amazon OpenSearch Service.
Creates an OpenSearch Application.
" + }, "CreateDomain":{ "name":"CreateDomain", "http":{ @@ -202,6 +221,26 @@ ], "documentation":"Creates an Amazon OpenSearch Service-managed VPC endpoint.
" }, + "DeleteApplication":{ + "name":"DeleteApplication", + "http":{ + "method":"DELETE", + "requestUri":"/2021-01-01/opensearch/application/{id}", + "responseCode":200 + }, + "input":{"shape":"DeleteApplicationRequest"}, + "output":{"shape":"DeleteApplicationResponse"}, + "errors":[ + {"shape":"BaseException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"ValidationException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ConflictException"}, + {"shape":"InternalException"}, + {"shape":"DisabledOperationException"} + ], + "documentation":"Deletes an existing OpenSearch Application.
" + }, "DeleteDataSource":{ "name":"DeleteDataSource", "http":{ @@ -558,6 +597,25 @@ ], "documentation":"Removes a package from the specified Amazon OpenSearch Service domain. The package can't be in use with any OpenSearch index for the dissociation to succeed. The package is still available in OpenSearch Service for association later. For more information, see Custom packages for Amazon OpenSearch Service.
" }, + "GetApplication":{ + "name":"GetApplication", + "http":{ + "method":"GET", + "requestUri":"/2021-01-01/opensearch/application/{id}", + "responseCode":200 + }, + "input":{"shape":"GetApplicationRequest"}, + "output":{"shape":"GetApplicationResponse"}, + "errors":[ + {"shape":"BaseException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"ValidationException"}, + {"shape":"AccessDeniedException"}, + {"shape":"InternalException"}, + {"shape":"DisabledOperationException"} + ], + "documentation":"Check the configuration and status of an existing OpenSearch Application.
" + }, "GetCompatibleVersions":{ "name":"GetCompatibleVersions", "http":{ @@ -661,6 +719,25 @@ ], "documentation":"Returns the most recent status of the last upgrade or upgrade eligibility check performed on an Amazon OpenSearch Service domain.
" }, + "ListApplications":{ + "name":"ListApplications", + "http":{ + "method":"GET", + "requestUri":"/2021-01-01/opensearch/list-applications", + "responseCode":200 + }, + "input":{"shape":"ListApplicationsRequest"}, + "output":{"shape":"ListApplicationsResponse"}, + "errors":[ + {"shape":"BaseException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"ValidationException"}, + {"shape":"AccessDeniedException"}, + {"shape":"InternalException"}, + {"shape":"DisabledOperationException"} + ], + "documentation":"List all OpenSearch Applications under your account.
" + }, "ListDataSources":{ "name":"ListDataSources", "http":{ @@ -952,6 +1029,26 @@ ], "documentation":"Schedules a service software update for an Amazon OpenSearch Service domain. For more information, see Service software updates in Amazon OpenSearch Service.
" }, + "UpdateApplication":{ + "name":"UpdateApplication", + "http":{ + "method":"PUT", + "requestUri":"/2021-01-01/opensearch/application/{id}", + "responseCode":200 + }, + "input":{"shape":"UpdateApplicationRequest"}, + "output":{"shape":"UpdateApplicationResponse"}, + "errors":[ + {"shape":"BaseException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"ValidationException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ConflictException"}, + {"shape":"InternalException"}, + {"shape":"DisabledOperationException"} + ], + "documentation":"Update the OpenSearch Application.
" + }, "UpdateDataSource":{ "name":"UpdateDataSource", "http":{ @@ -1124,6 +1221,10 @@ }, "documentation":"Information about an Amazon OpenSearch Service domain.
" }, + "AWSServicePrincipal":{ + "type":"string", + "enum":["application.opensearchservice.amazonaws.com"] + }, "AcceptInboundConnectionRequest":{ "type":"structure", "required":["ConnectionId"], @@ -1377,6 +1478,92 @@ }, "documentation":"The status of fine-grained access control settings for a domain.
" }, + "AppConfig":{ + "type":"structure", + "members":{ + "key":{ + "shape":"AppConfigType", + "documentation":"Specify the item to configure, such as admin role for the OpenSearch Application.
" + }, + "value":{ + "shape":"AppConfigValue", + "documentation":"Specifies the value to configure for the key, such as an IAM user ARN.
" + } + }, + "documentation":"Configurations of the OpenSearch Application.
" + }, + "AppConfigType":{ + "type":"string", + "enum":[ + "opensearchDashboards.dashboardAdmin.users", + "opensearchDashboards.dashboardAdmin.groups" + ] + }, + "AppConfigValue":{ + "type":"string", + "max":4096, + "min":1 + }, + "AppConfigs":{ + "type":"list", + "member":{"shape":"AppConfig"}, + "max":200 + }, + "ApplicationName":{ + "type":"string", + "max":30, + "min":3, + "pattern":"[a-z][a-z0-9\\-]+" + }, + "ApplicationStatus":{ + "type":"string", + "enum":[ + "CREATING", + "UPDATING", + "DELETING", + "ACTIVE", + "FAILED" + ] + }, + "ApplicationStatuses":{ + "type":"list", + "member":{"shape":"ApplicationStatus"} + }, + "ApplicationSummaries":{ + "type":"list", + "member":{"shape":"ApplicationSummary"} + }, + "ApplicationSummary":{ + "type":"structure", + "members":{ + "id":{ + "shape":"Id", + "documentation":"Unique identifier for an OpenSearch application.
" + }, + "arn":{"shape":"ARN"}, + "name":{ + "shape":"ApplicationName", + "documentation":"Name of an OpenSearch Application.
" + }, + "endpoint":{ + "shape":"String", + "documentation":"Endpoint URL of an OpenSearch Application.
" + }, + "status":{ + "shape":"ApplicationStatus", + "documentation":"Status of an OpenSearch Application. Possible values are CREATING, UPDATING, DELETING, FAILED, ACTIVE, and DELETED.
Timestamp at which an OpenSearch Application was created.
" + }, + "lastUpdatedAt":{ + "shape":"Timestamp", + "documentation":"Timestamp at which an OpenSearch Application was last updated.
" + } + }, + "documentation":"Basic information of the OpenSearch Application.
" + }, "AssociatePackageRequest":{ "type":"structure", "required":[ @@ -1411,10 +1598,7 @@ }, "AuthorizeVpcEndpointAccessRequest":{ "type":"structure", - "required":[ - "DomainName", - "Account" - ], + "required":["DomainName"], "members":{ "DomainName":{ "shape":"DomainName", @@ -1425,6 +1609,10 @@ "Account":{ "shape":"AWSAccount", "documentation":"The Amazon Web Services account ID to grant access to.
" + }, + "Service":{ + "shape":"AWSServicePrincipal", + "documentation":"The Amazon Web Services service SP to grant access to.
" } } }, @@ -2111,6 +2299,65 @@ "documentation":"The connection properties of an outbound connection.
" }, "ConnectionStatusMessage":{"type":"string"}, + "CreateApplicationRequest":{ + "type":"structure", + "required":["name"], + "members":{ + "clientToken":{ + "shape":"ClientToken", + "documentation":"A unique client idempotency token. It will be auto generated if not provided.
", + "idempotencyToken":true + }, + "name":{ + "shape":"ApplicationName", + "documentation":"Name of the OpenSearch Appication to create. Application names are unique across the applications owned by an account within an Amazon Web Services Region.
" + }, + "dataSources":{ + "shape":"DataSources", + "documentation":"Data sources to be associated with the OpenSearch Application.
" + }, + "iamIdentityCenterOptions":{ + "shape":"IamIdentityCenterOptionsInput", + "documentation":"Settings of IAM Identity Center for the OpenSearch Application.
" + }, + "appConfigs":{ + "shape":"AppConfigs", + "documentation":"Configurations of the OpenSearch Application, inlcuding admin configuration.
" + }, + "tagList":{"shape":"TagList"} + } + }, + "CreateApplicationResponse":{ + "type":"structure", + "members":{ + "id":{ + "shape":"Id", + "documentation":"Unique identifier for the created OpenSearch Application.
" + }, + "name":{ + "shape":"ApplicationName", + "documentation":"Name of the created OpenSearch Application.
" + }, + "arn":{"shape":"ARN"}, + "dataSources":{ + "shape":"DataSources", + "documentation":"Data sources associated with the created OpenSearch Application.
" + }, + "iamIdentityCenterOptions":{ + "shape":"IamIdentityCenterOptions", + "documentation":"Settings of IAM Identity Center for the created OpenSearch Application.
" + }, + "appConfigs":{ + "shape":"AppConfigs", + "documentation":"Configurations of the OpenSearch Application, inlcuding admin configuration.
" + }, + "tagList":{"shape":"TagList"}, + "createdAt":{ + "shape":"Timestamp", + "documentation":"Timestamp when the OpenSearch Application was created.
" + } + } + }, "CreateDomainRequest":{ "type":"structure", "required":["DomainName"], @@ -2175,6 +2422,10 @@ "shape":"AdvancedSecurityOptionsInput", "documentation":"Options for fine-grained access control.
" }, + "IdentityCenterOptions":{ + "shape":"IdentityCenterOptionsInput", + "documentation":"Options for IAM Identity Center Option control for the domain.
" + }, "TagList":{ "shape":"TagList", "documentation":"List of tags to add to the domain upon creation.
" @@ -2351,6 +2602,17 @@ }, "documentation":"Cross-cluster search specific connection properties.
" }, + "DataSource":{ + "type":"structure", + "members":{ + "dataSourceArn":{"shape":"ARN"}, + "dataSourceDescription":{ + "shape":"DataSourceDescription", + "documentation":"Detailed description of a data source.
" + } + }, + "documentation":"Data sources that are associated with an OpenSearch Application.
" + }, "DataSourceDescription":{ "type":"string", "max":1000, @@ -2406,6 +2668,27 @@ "documentation":"The type of data source.
", "union":true }, + "DataSources":{ + "type":"list", + "member":{"shape":"DataSource"} + }, + "DeleteApplicationRequest":{ + "type":"structure", + "required":["id"], + "members":{ + "id":{ + "shape":"Id", + "documentation":"Unique identifier for the OpenSearch Application that you want to delete.
", + "location":"uri", + "locationName":"id" + } + } + }, + "DeleteApplicationResponse":{ + "type":"structure", + "members":{ + } + }, "DeleteDataSourceRequest":{ "type":"structure", "required":[ @@ -3227,6 +3510,10 @@ "shape":"AdvancedSecurityOptionsStatus", "documentation":"Container for fine-grained access control settings for the domain.
" }, + "IdentityCenterOptions":{ + "shape":"IdentityCenterOptionsStatus", + "documentation":"Container for IAM Identity Center Option control for the domain.
" + }, "AutoTuneOptions":{ "shape":"AutoTuneOptionsStatus", "documentation":"Container for Auto-Tune settings for the domain.
" @@ -3634,6 +3921,10 @@ "shape":"AdvancedSecurityOptions", "documentation":"Settings for fine-grained access control.
" }, + "IdentityCenterOptions":{ + "shape":"IdentityCenterOptions", + "documentation":"Container for IAM Identity Center Option control for the domain.
" + }, "AutoTuneOptions":{ "shape":"AutoTuneOptionsOutput", "documentation":"Auto-Tune settings for the domain.
" @@ -3899,6 +4190,60 @@ "type":"list", "member":{"shape":"GUID"} }, + "GetApplicationRequest":{ + "type":"structure", + "required":["id"], + "members":{ + "id":{ + "shape":"Id", + "documentation":"Unique identifier of the checked OpenSearch Application.
", + "location":"uri", + "locationName":"id" + } + } + }, + "GetApplicationResponse":{ + "type":"structure", + "members":{ + "id":{ + "shape":"Id", + "documentation":"Unique identifier of the checked OpenSearch Application.
" + }, + "arn":{"shape":"ARN"}, + "name":{ + "shape":"ApplicationName", + "documentation":"Name of the checked OpenSearch Application.
" + }, + "endpoint":{ + "shape":"String", + "documentation":"Endpoint URL of the checked OpenSearch Application.
" + }, + "status":{ + "shape":"ApplicationStatus", + "documentation":"Current status of the checked OpenSearch Application. Possible values are CREATING, UPDATING, DELETING, FAILED, ACTIVE, and DELETED.
IAM Identity Center settings for the checked OpenSearch Application.
" + }, + "dataSources":{ + "shape":"DataSources", + "documentation":"Associated data sources to the checked OpenSearch Application.
" + }, + "appConfigs":{ + "shape":"AppConfigs", + "documentation":"App configurations of the checked OpenSearch Application.
" + }, + "createdAt":{ + "shape":"Timestamp", + "documentation":"Timestamp at which the checked OpenSearch Application was created.
" + }, + "lastUpdatedAt":{ + "shape":"Timestamp", + "documentation":"Timestamp at which the checked OpenSearch Application was last updated.
" + } + } + }, "GetCompatibleVersionsRequest":{ "type":"structure", "members":{ @@ -4153,12 +4498,135 @@ }, "documentation":"The IP address type status for the domain.
" }, + "IamIdentityCenterOptions":{ + "type":"structure", + "members":{ + "enabled":{ + "shape":"Boolean", + "documentation":"IAM Identity Center is enabled for the OpenSearch Application.
" + }, + "iamIdentityCenterInstanceArn":{"shape":"ARN"}, + "iamRoleForIdentityCenterApplicationArn":{ + "shape":"RoleArn", + "documentation":"Amazon Resource Name of the IAM Identity Center's Application created for the OpenSearch Application after enabling IAM Identity Center.
" + }, + "iamIdentityCenterApplicationArn":{"shape":"ARN"} + }, + "documentation":"Settings for IAM Identity Center for an OpenSearch Application.
" + }, + "IamIdentityCenterOptionsInput":{ + "type":"structure", + "members":{ + "enabled":{ + "shape":"Boolean", + "documentation":"Enable/disable settings for IAM Identity Center.
" + }, + "iamIdentityCenterInstanceArn":{"shape":"ARN"}, + "iamRoleForIdentityCenterApplicationArn":{ + "shape":"RoleArn", + "documentation":"Amazon Resource Name of IAM Identity Center's application.
" + } + }, + "documentation":"Settings for IAM Identity Center.
" + }, + "Id":{ + "type":"string", + "pattern":"[a-z0-9]{3,30}" + }, + "IdentityCenterApplicationARN":{ + "type":"string", + "max":2048, + "min":20, + "pattern":"^arn:aws[a-z\\\\-]*:[a-z]+:[a-z0-9\\\\-]*:[0-9]*:[a-z0-9\\\\-]+\\/[a-z0-9\\\\-]+\\/[a-z0-9\\\\-]+" + }, + "IdentityCenterInstanceARN":{ + "type":"string", + "max":2048, + "min":20, + "pattern":"^arn:aws[a-z\\\\-]*:[a-z]+:[a-z0-9\\\\-]*:[0-9]*:[a-z0-9\\\\-]+\\/[a-z0-9\\\\-]+" + }, + "IdentityCenterOptions":{ + "type":"structure", + "members":{ + "EnabledAPIAccess":{ + "shape":"Boolean", + "documentation":"True to enable IAM Identity Center for API access in Amazon OpenSearch Service.
" + }, + "IdentityCenterInstanceARN":{ + "shape":"IdentityCenterInstanceARN", + "documentation":"The ARN for IAM Identity Center Instance.
" + }, + "SubjectKey":{ + "shape":"SubjectKeyIdCOption", + "documentation":"Specify the attribute that contains the subject (username, userID, email) of IAM Identity Center.
" + }, + "RolesKey":{ + "shape":"RolesKeyIdCOption", + "documentation":"Specify the attribute that contains the backend role (groupName, groupID) of IAM Identity Center
" + }, + "IdentityCenterApplicationARN":{ + "shape":"IdentityCenterApplicationARN", + "documentation":"The ARN for IAM Identity Center Application which will integrate with Amazon OpenSearch Service.
" + }, + "IdentityStoreId":{ + "shape":"IdentityStoreId", + "documentation":"The ID of IAM Identity Store.
" + } + }, + "documentation":"Container for IAM Identity Center Options settings.
" + }, + "IdentityCenterOptionsInput":{ + "type":"structure", + "members":{ + "EnabledAPIAccess":{ + "shape":"Boolean", + "documentation":"True to enable IAM Identity Center for API access in Amazon OpenSearch Service.
" + }, + "IdentityCenterInstanceARN":{ + "shape":"IdentityCenterInstanceARN", + "documentation":"The ARN for IAM Identity Center Instance which will be used for IAM Identity Center Application creation.
" + }, + "SubjectKey":{ + "shape":"SubjectKeyIdCOption", + "documentation":"Specify the attribute that contains the subject (username, userID, email) of IAM Identity Center.
" + }, + "RolesKey":{ + "shape":"RolesKeyIdCOption", + "documentation":"Specify the attribute that contains the backend role (groupName, groupID) of IAM Identity Center
" + } + }, + "documentation":"Container for IAM Identity Center Options settings.
" + }, + "IdentityCenterOptionsStatus":{ + "type":"structure", + "required":[ + "Options", + "Status" + ], + "members":{ + "Options":{ + "shape":"IdentityCenterOptions", + "documentation":"Container for IAM Identity Center Options settings.
" + }, + "Status":{ + "shape":"OptionStatus", + "documentation":"The status of IAM Identity Center Options settings for a domain.
" + } + }, + "documentation":"The status of IAM Identity Center Options settings for a domain.
" + }, "IdentityPoolId":{ "type":"string", "max":55, "min":1, "pattern":"[\\w-]+:[0-9a-f-]+" }, + "IdentityStoreId":{ + "type":"string", + "max":64, + "min":1, + "pattern":"^d-[0-9a-f]{10}$|^[0-9a-f]{8}\\\\b-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-\\\\b[0-9a-f]{12}$" + }, "InboundConnection":{ "type":"structure", "members":{ @@ -4425,6 +4893,37 @@ "value":{"shape":"Limits"}, "documentation":"The role of a given instance and all applicable limits. The role performed by a given OpenSearch instance can be one of the following:
data - A data node.
master - A dedicated master node.
ultra_warm - An UltraWarm node.
OpenSearch Application Status can be used as filters for the listing request. Possible values are CREATING, UPDATING, DELETING, FAILED, ACTIVE, and DELETED.
Summary of the OpenSearch Applications, including ID, ARN, name, endpoint, status, create time and last update time.
" + }, + "nextToken":{"shape":"NextToken"} + } + }, "ListDataSourcesRequest":{ "type":"structure", "required":["DomainName"], @@ -5859,10 +6358,7 @@ }, "RevokeVpcEndpointAccessRequest":{ "type":"structure", - "required":[ - "DomainName", - "Account" - ], + "required":["DomainName"], "members":{ "DomainName":{ "shape":"DomainName", @@ -5873,6 +6369,10 @@ "Account":{ "shape":"AWSAccount", "documentation":"The account ID to revoke access from.
" + }, + "Service":{ + "shape":"AWSServicePrincipal", + "documentation":"The service SP to revoke access from.
" } } }, @@ -5892,6 +6392,13 @@ "max":64, "min":1 }, + "RolesKeyIdCOption":{ + "type":"string", + "enum":[ + "GroupName", + "GroupId" + ] + }, "RollbackOnDisable":{ "type":"string", "documentation":"The rollback state while disabling Auto-Tune for the domain.
", @@ -6369,6 +6876,14 @@ "max":64, "min":1 }, + "SubjectKeyIdCOption":{ + "type":"string", + "enum":[ + "UserName", + "UserId", + "Email" + ] + }, "TLSSecurityPolicy":{ "type":"string", "enum":[ @@ -6419,12 +6934,67 @@ "documentation":"The unit of a maintenance schedule duration. Valid value is HOUR.
Unique identifier of the OpenSearch Application to be updated.
", + "location":"uri", + "locationName":"id" + }, + "dataSources":{ + "shape":"DataSources", + "documentation":"Data sources to be associated with the OpenSearch Application.
" + }, + "appConfigs":{ + "shape":"AppConfigs", + "documentation":"Configurations to be changed for the OpenSearch Application.
" + } + } + }, + "UpdateApplicationResponse":{ + "type":"structure", + "members":{ + "id":{ + "shape":"Id", + "documentation":"Unique identifier of the updated OpenSearch Application.
" + }, + "name":{ + "shape":"ApplicationName", + "documentation":"Name of the updated OpenSearch Application.
" + }, + "arn":{"shape":"ARN"}, + "dataSources":{ + "shape":"DataSources", + "documentation":"Data sources associated with the updated OpenSearch Application.
" + }, + "iamIdentityCenterOptions":{ + "shape":"IamIdentityCenterOptions", + "documentation":"IAM Identity Center settings for the updated OpenSearch Application.
" + }, + "appConfigs":{ + "shape":"AppConfigs", + "documentation":"Configurations for the updated OpenSearch Application.
" + }, + "createdAt":{ + "shape":"Timestamp", + "documentation":"Timestamp at which the OpenSearch Application was created.
" + }, + "lastUpdatedAt":{ + "shape":"Timestamp", + "documentation":"Timestamp at which the OpenSearch Application was last updated.
" + } + } + }, "UpdateDataSourceRequest":{ "type":"structure", "required":[ @@ -6532,6 +7102,7 @@ "shape":"AdvancedSecurityOptionsInput", "documentation":"Options for fine-grained access control.
" }, + "IdentityCenterOptions":{"shape":"IdentityCenterOptionsInput"}, "AutoTuneOptions":{ "shape":"AutoTuneOptions", "documentation":"Options for Auto-Tune.
" From 4926c508b6049158cf23c4e6501be5ff1cb16b19 Mon Sep 17 00:00:00 2001 From: AWS <> Date: Wed, 30 Oct 2024 18:13:22 +0000 Subject: [PATCH 12/21] AWS AppSync Update: This release adds support for AppSync Event APIs. --- .../feature-AWSAppSync-68daa3f.json | 6 + .../codegen-resources/paginators-1.json | 12 + .../codegen-resources/service-2.json | 745 +++++++++++++++++- 3 files changed, 754 insertions(+), 9 deletions(-) create mode 100644 .changes/next-release/feature-AWSAppSync-68daa3f.json diff --git a/.changes/next-release/feature-AWSAppSync-68daa3f.json b/.changes/next-release/feature-AWSAppSync-68daa3f.json new file mode 100644 index 000000000000..7080909e9101 --- /dev/null +++ b/.changes/next-release/feature-AWSAppSync-68daa3f.json @@ -0,0 +1,6 @@ +{ + "type": "feature", + "category": "AWS AppSync", + "contributor": "", + "description": "This release adds support for AppSync Event APIs." +} diff --git a/services/appsync/src/main/resources/codegen-resources/paginators-1.json b/services/appsync/src/main/resources/codegen-resources/paginators-1.json index ad32b16b9420..131179411e6b 100644 --- a/services/appsync/src/main/resources/codegen-resources/paginators-1.json +++ b/services/appsync/src/main/resources/codegen-resources/paginators-1.json @@ -6,6 +6,18 @@ "limit_key": "maxResults", "result_key": "apiKeys" }, + "ListApis": { + "input_token": "nextToken", + "output_token": "nextToken", + "limit_key": "maxResults", + "result_key": "apis" + }, + "ListChannelNamespaces": { + "input_token": "nextToken", + "output_token": "nextToken", + "limit_key": "maxResults", + "result_key": "channelNamespaces" + }, "ListDataSources": { "input_token": "nextToken", "output_token": "nextToken", diff --git a/services/appsync/src/main/resources/codegen-resources/service-2.json b/services/appsync/src/main/resources/codegen-resources/service-2.json index 3cda40eb249c..4ecd0e692ae0 100644 --- a/services/appsync/src/main/resources/codegen-resources/service-2.json +++ b/services/appsync/src/main/resources/codegen-resources/service-2.json @@ -67,6 +67,23 @@ ], "documentation":"Creates an association between a Merged API and source API using the Merged API's identifier.
" }, + "CreateApi":{ + "name":"CreateApi", + "http":{ + "method":"POST", + "requestUri":"/v2/apis" + }, + "input":{"shape":"CreateApiRequest"}, + "output":{"shape":"CreateApiResponse"}, + "errors":[ + {"shape":"BadRequestException"}, + {"shape":"ConcurrentModificationException"}, + {"shape":"UnauthorizedException"}, + {"shape":"InternalFailureException"}, + {"shape":"ServiceQuotaExceededException"} + ], + "documentation":"Creates an Api object. Use this operation to create an AppSync API with your preferred configuration, such as an Event API that provides real-time message publishing and message subscriptions over WebSockets.
Creates a unique key that you can distribute to clients who invoke your API.
" }, + "CreateChannelNamespace":{ + "name":"CreateChannelNamespace", + "http":{ + "method":"POST", + "requestUri":"/v2/apis/{apiId}/channelNamespaces" + }, + "input":{"shape":"CreateChannelNamespaceRequest"}, + "output":{"shape":"CreateChannelNamespaceResponse"}, + "errors":[ + {"shape":"BadRequestException"}, + {"shape":"ConcurrentModificationException"}, + {"shape":"ConflictException"}, + {"shape":"NotFoundException"}, + {"shape":"UnauthorizedException"}, + {"shape":"InternalFailureException"}, + {"shape":"ServiceQuotaExceededException"} + ], + "documentation":"Creates a ChannelNamespace for an Api.
Creates a Type object.
Deletes an Api object
Deletes an API key.
" }, + "DeleteChannelNamespace":{ + "name":"DeleteChannelNamespace", + "http":{ + "method":"DELETE", + "requestUri":"/v2/apis/{apiId}/channelNamespaces/{name}" + }, + "input":{"shape":"DeleteChannelNamespaceRequest"}, + "output":{"shape":"DeleteChannelNamespaceResponse"}, + "errors":[ + {"shape":"BadRequestException"}, + {"shape":"ConcurrentModificationException"}, + {"shape":"NotFoundException"}, + {"shape":"UnauthorizedException"}, + {"shape":"InternalFailureException"}, + {"shape":"AccessDeniedException"} + ], + "documentation":"Deletes a ChannelNamespace.
Flushes an ApiCache object.
Retrieves an Api object.
Retrieves an ApiCache object.
Retrieves the channel namespace for a specified Api.
Lists the API keys for a given API.
API keys are deleted automatically 60 days after they expire. However, they may still be included in the response until they have actually been deleted. You can safely call DeleteApiKey to manually delete a key before it's automatically deleted.
Lists the APIs in your AppSync account.
ListApis returns only the high level API details. For more detailed information about an API, use GetApi.
Lists the channel namespaces for a specified Api.
ListChannelNamespaces returns only high level details for the channel namespace. To retrieve code handlers, use GetChannelNamespace.
Untags a resource.
" }, + "UpdateApi":{ + "name":"UpdateApi", + "http":{ + "method":"POST", + "requestUri":"/v2/apis/{apiId}" + }, + "input":{"shape":"UpdateApiRequest"}, + "output":{"shape":"UpdateApiResponse"}, + "errors":[ + {"shape":"BadRequestException"}, + {"shape":"ConcurrentModificationException"}, + {"shape":"NotFoundException"}, + {"shape":"UnauthorizedException"}, + {"shape":"InternalFailureException"}, + {"shape":"AccessDeniedException"} + ], + "documentation":"Updates an Api.
Updates an API key. You can update the key as long as it's not deleted.
" }, + "UpdateChannelNamespace":{ + "name":"UpdateChannelNamespace", + "http":{ + "method":"POST", + "requestUri":"/v2/apis/{apiId}/channelNamespaces/{name}" + }, + "input":{"shape":"UpdateChannelNamespaceRequest"}, + "output":{"shape":"UpdateChannelNamespaceResponse"}, + "errors":[ + {"shape":"BadRequestException"}, + {"shape":"ConcurrentModificationException"}, + {"shape":"NotFoundException"}, + {"shape":"UnauthorizedException"}, + {"shape":"InternalFailureException"}, + {"shape":"AccessDeniedException"} + ], + "documentation":"Updates a ChannelNamespace associated with an Api.
The Api ID.
The name of the Api.
The owner contact information for the Api
The DNS records for the API. This will include an HTTP and a real-time endpoint.
" + }, + "apiArn":{ + "shape":"String", + "documentation":"The Amazon Resource Name (ARN) for the Api.
The date and time that the Api was created.
A flag indicating whether to use X-Ray tracing for this Api.
The Amazon Resource Name (ARN) of the WAF web access control list (web ACL) associated with this Api, if one exists.
The Event API configuration. This includes the default authorization configuration for connecting, publishing, and subscribing to an Event API.
" + } + }, + "documentation":"Describes an AppSync API. You can use Api for an AppSync API with your preferred configuration, such as an Event API that provides real-time message publishing and message subscriptions over WebSockets.
The authorization type.
" + } + }, + "documentation":"Describes an authorization configuration. Use AuthMode to specify the publishing and subscription authorization configuration for an Event API.
The authorization type.
" + }, + "cognitoConfig":{ + "shape":"CognitoConfig", + "documentation":"Describes an Amazon Cognito user pool configuration.
" + }, + "openIDConnectConfig":{"shape":"OpenIDConnectConfig"}, + "lambdaAuthorizerConfig":{"shape":"LambdaAuthorizerConfig"} + }, + "documentation":"Describes an authorization provider.
" + }, + "AuthProviders":{ + "type":"list", + "member":{"shape":"AuthProvider"} + }, "AuthenticationType":{ "type":"string", "enum":[ @@ -1499,6 +1763,49 @@ "min":20, "pattern":"^arn:[a-z-]*:(acm|iam):[a-z0-9-]*:\\d{12}:(certificate|server-certificate)/[0-9A-Za-z_/-]*$" }, + "ChannelNamespace":{ + "type":"structure", + "members":{ + "apiId":{ + "shape":"String", + "documentation":"The Api ID.
The name of the channel namespace. This name must be unique within the Api.
The authorization mode to use for subscribing to messages on the channel namespace. This configuration overrides the default Apiauthorization configuration.
The authorization mode to use for publishing messages on the channel namespace. This configuration overrides the default Apiauthorization configuration.
The event handler functions that run custom business logic to process published events and subscribe requests.
" + }, + "tags":{"shape":"TagMap"}, + "channelNamespaceArn":{ + "shape":"String", + "documentation":"The Amazon Resource Name (ARN) for the ChannelNamespace.
The date and time that the ChannelNamespace was created.
The date and time that the ChannelNamespace was last changed.
Describes a channel namespace associated with an Api. The ChannelNamespace contains the definitions for code handlers for the Api.
The user pool ID.
" + }, + "awsRegion":{ + "shape":"String", + "documentation":"The Amazon Web Services Region in which the user pool was created.
" + }, + "appIdClientRegex":{ + "shape":"String", + "documentation":"A regular expression for validating the incoming Amazon Cognito user pool app client ID. If this value isn't set, no filtering is applied.
" + } + }, + "documentation":"Describes an Amazon Cognito configuration.
" + }, "CognitoUserPoolConfig":{ "type":"structure", "required":[ @@ -1585,6 +1914,15 @@ "NONE" ] }, + "ConflictException":{ + "type":"structure", + "members":{ + "message":{"shape":"String"} + }, + "documentation":"A conflict with a previous successful update is detected. This typically occurs when the previous update did not have time to propagate before the next update was made. A retry (with appropriate backoff logic) is the recommended response to this exception.
", + "error":{"httpStatusCode":409}, + "exception":true + }, "ConflictHandlerType":{ "type":"string", "enum":[ @@ -1681,6 +2019,75 @@ } } }, + "CreateApiRequest":{ + "type":"structure", + "required":["name"], + "members":{ + "name":{ + "shape":"ApiName", + "documentation":"The name for the Api.
The owner contact information for the Api.
The Event API configuration. This includes the default authorization configuration for connecting, publishing, and subscribing to an Event API.
" + } + } + }, + "CreateApiResponse":{ + "type":"structure", + "members":{ + "api":{ + "shape":"Api", + "documentation":"The Api object.
The Api ID.
The name of the ChannelNamespace. This name must be unique within the Api
The authorization mode to use for subscribing to messages on the channel namespace. This configuration overrides the default Api authorization configuration.
The authorization mode to use for publishing messages on the channel namespace. This configuration overrides the default Api authorization configuration.
The event handler functions that run custom business logic to process published events and subscribe requests.
" + }, + "tags":{"shape":"TagMap"} + } + }, + "CreateChannelNamespaceResponse":{ + "type":"structure", + "members":{ + "channelNamespace":{ + "shape":"ChannelNamespace", + "documentation":"The ChannelNamespace object.
Configuration for Lambda function authorization.
" }, - "visibility":{ - "shape":"GraphQLApiVisibility", - "documentation":"Sets the value of the GraphQL API to public (GLOBAL) or private (PRIVATE). If no value is provided, the visibility will be set to GLOBAL by default. This value cannot be changed once the API has been created.
The value that indicates whether the GraphQL API is a standard API (GRAPHQL) or merged API (MERGED).
The Identity and Access Management service role ARN for a merged API. The AppSync service assumes this role on behalf of the Merged API to validate access to source APIs at runtime and to prompt the AUTO_MERGE to update the merged API endpoint with the source API changes automatically.
Sets the value of the GraphQL API to public (GLOBAL) or private (PRIVATE). If no value is provided, the visibility will be set to GLOBAL by default. This value cannot be changed once the API has been created.
The owner contact information for an API resource.
This field accepts any string input with a length of 0 - 256 characters.
" @@ -2302,6 +2709,49 @@ "members":{ } }, + "DeleteApiRequest":{ + "type":"structure", + "required":["apiId"], + "members":{ + "apiId":{ + "shape":"String", + "documentation":"The Api ID.
The ID of the Api associated with the ChannelNamespace.
The name of the ChannelNamespace.
Describes an Amazon EventBridge bus data source configuration.
" }, + "EventConfig":{ + "type":"structure", + "required":[ + "authProviders", + "connectionAuthModes", + "defaultPublishAuthModes", + "defaultSubscribeAuthModes" + ], + "members":{ + "authProviders":{ + "shape":"AuthProviders", + "documentation":"A list of authorization providers.
" + }, + "connectionAuthModes":{ + "shape":"AuthModes", + "documentation":"A list of valid authorization modes for the Event API connections.
" + }, + "defaultPublishAuthModes":{ + "shape":"AuthModes", + "documentation":"A list of valid authorization modes for the Event API publishing.
" + }, + "defaultSubscribeAuthModes":{ + "shape":"AuthModes", + "documentation":"A list of valid authorization modes for the Event API subscriptions.
" + }, + "logConfig":{ + "shape":"EventLogConfig", + "documentation":"The CloudWatch Logs configuration for the Event API.
" + } + }, + "documentation":"Describes the authorization configuration for connections, message publishing, message subscriptions, and logging for an Event API.
" + }, + "EventLogConfig":{ + "type":"structure", + "required":[ + "logLevel", + "cloudWatchLogsRoleArn" + ], + "members":{ + "logLevel":{ + "shape":"EventLogLevel", + "documentation":"The type of information to log for the Event API.
" + }, + "cloudWatchLogsRoleArn":{ + "shape":"String", + "documentation":"The IAM service role that AppSync assumes to publish CloudWatch Logs in your account.
" + } + }, + "documentation":"Describes the CloudWatch Logs configuration for the Event API.
" + }, + "EventLogLevel":{ + "type":"string", + "enum":[ + "NONE", + "ERROR", + "ALL", + "INFO", + "DEBUG" + ] + }, "FieldLogLevel":{ "type":"string", "enum":[ @@ -2921,6 +3431,57 @@ }, "documentation":"Represents the output of a GetApiCache operation.
The Api ID.
The Api object.
The Api ID.
The name of the ChannelNamespace.
The ChannelNamespace object.
A boolean flag that determines whether SDL should be generated for introspected types or not. If set to true, each model will contain an sdl property that contains the SDL for that type. The SDL only contains the type data and no additional metadata or directives.
A boolean flag that determines whether SDL should be generated for introspected types. If set to true, each model will contain an sdl property that contains the SDL for that type. The SDL only contains the type data and no additional metadata or directives.
An identifier that was returned from the previous call to this operation, which you can use to return the next set of items in the list.
", + "location":"querystring", + "locationName":"nextToken" + }, + "maxResults":{ + "shape":"MaxResults", + "documentation":"The maximum number of results that you want the request to return.
", + "location":"querystring", + "locationName":"maxResults" + } + } + }, + "ListApisResponse":{ + "type":"structure", + "members":{ + "apis":{ + "shape":"Apis", + "documentation":"The Api objects.
An identifier that was returned from the previous call to this operation, which you can use to return the next set of items in the list.
" + } + } + }, + "ListChannelNamespacesRequest":{ + "type":"structure", + "required":["apiId"], + "members":{ + "apiId":{ + "shape":"String", + "documentation":"The Api ID.
An identifier that was returned from the previous call to this operation, which you can use to return the next set of items in the list.
", + "location":"querystring", + "locationName":"nextToken" + }, + "maxResults":{ + "shape":"MaxResults", + "documentation":"The maximum number of results that you want the request to return.
", + "location":"querystring", + "locationName":"maxResults" + } + } + }, + "ListChannelNamespacesResponse":{ + "type":"structure", + "members":{ + "channelNamespaces":{ + "shape":"ChannelNamespaces", + "documentation":"The ChannelNamespace objects.
An identifier that was returned from the previous call to this operation, which you can use to return the next set of items in the list.
" + } + } + }, "ListDataSourcesRequest":{ "type":"structure", "required":["apiId"], @@ -3907,7 +4535,7 @@ "members":{ "fieldLogLevel":{ "shape":"FieldLogLevel", - "documentation":"The field logging level. Values can be NONE, ERROR, INFO, DEBUG, or ALL.
NONE: No field-level logs are captured.
ERROR: Logs the following information only for the fields that are in the error category:
The error section in the server response.
Field-level errors.
The generated request/response functions that got resolved for error fields.
INFO: Logs the following information only for the fields that are in the info and error categories:
Info-level messages.
The user messages sent through $util.log.info and console.log.
Field-level tracing and mapping logs are not shown.
DEBUG: Logs the following information only for the fields that are in the debug, info, and error categories:
Debug-level messages.
The user messages sent through $util.log.info, $util.log.debug, console.log, and console.debug.
Field-level tracing and mapping logs are not shown.
ALL: The following information is logged for all fields in the query:
Field-level tracing information.
The generated request/response functions that were resolved for each field.
The field logging level. Values can be NONE, ERROR, or ALL.
NONE: No field-level logs are captured.
ERROR: Logs the following information only for the fields that are in error:
The error section in the server response.
Field-level errors.
The generated request/response functions that got resolved for error fields.
ALL: The following information is logged for all fields in the query:
Field-level tracing information.
The generated request/response functions that got resolved for each field.
The operation exceeded the service quota for this resource.
", + "error":{"httpStatusCode":402}, + "exception":true + }, "SourceApiAssociation":{ "type":"structure", "members":{ @@ -4549,6 +5198,7 @@ "min":2, "pattern":"^[\\s\\S]*$" }, + "Timestamp":{"type":"timestamp"}, "Type":{ "type":"structure", "members":{ @@ -4703,6 +5353,84 @@ } } }, + "UpdateApiRequest":{ + "type":"structure", + "required":[ + "apiId", + "name" + ], + "members":{ + "apiId":{ + "shape":"String", + "documentation":"The Api ID.
The name of the Api.
" + }, + "ownerContact":{ + "shape":"String", + "documentation":"The owner contact information for the Api.
The new event configuration. This includes the default authorization configuration for connecting, publishing, and subscribing to an Event API.
" + } + } + }, + "UpdateApiResponse":{ + "type":"structure", + "members":{ + "api":{ + "shape":"Api", + "documentation":"The Api object.
The Api ID.
The name of the ChannelNamespace.
The authorization mode to use for subscribing to messages on the channel namespace. This configuration overrides the default Api authorization configuration.
The authorization mode to use for publishing messages on the channel namespace. This configuration overrides the default Api authorization configuration.
The event handler functions that run custom business logic to process published events and subscribe requests.
" + } + } + }, + "UpdateChannelNamespaceResponse":{ + "type":"structure", + "members":{ + "channelNamespace":{ + "shape":"ChannelNamespace", + "documentation":"The ChannelNamespace object.
The custom port to use when connecting to a workgroup. Valid port ranges are 5431-5455 and 8191-8215. The default is 5439.
" }, + "pricePerformanceTarget":{ + "shape":"PerformanceTarget", + "documentation":"An object that represents the price performance target settings for the workgroup.
" + }, "publiclyAccessible":{ "shape":"Boolean", "documentation":"A value that specifies whether the workgroup can be accessed from a public network.
" @@ -2597,6 +2601,33 @@ }, "ParameterKey":{"type":"string"}, "ParameterValue":{"type":"string"}, + "PerformanceTarget":{ + "type":"structure", + "members":{ + "level":{ + "shape":"PerformanceTargetLevelInteger", + "documentation":"The target price performance level for the workgroup. Valid values include 1, 25, 50, 75, and 100. These correspond to the price performance levels LOW_COST, ECONOMICAL, BALANCED, RESOURCEFUL, and HIGH_PERFORMANCE.
" + }, + "status":{ + "shape":"PerformanceTargetStatus", + "documentation":"Whether the price performance target is enabled for the workgroup.
" + } + }, + "documentation":"An object that represents the price performance target settings for the workgroup.
" + }, + "PerformanceTargetLevelInteger":{ + "type":"integer", + "box":true, + "max":100, + "min":1 + }, + "PerformanceTargetStatus":{ + "type":"string", + "enum":[ + "ENABLED", + "DISABLED" + ] + }, "PutResourcePolicyRequest":{ "type":"structure", "required":[ @@ -3616,6 +3647,10 @@ "shape":"Integer", "documentation":"The custom port to use when connecting to a workgroup. Valid port ranges are 5431-5455 and 8191-8215. The default is 5439.
" }, + "pricePerformanceTarget":{ + "shape":"PerformanceTarget", + "documentation":"An object that represents the price performance target settings for the workgroup.
" + }, "publiclyAccessible":{ "shape":"Boolean", "documentation":"A value that specifies whether the workgroup can be accessible from a public network.
" @@ -3824,6 +3859,10 @@ "shape":"Integer", "documentation":"The custom port to use when connecting to a workgroup. Valid port ranges are 5431-5455 and 8191-8215. The default is 5439.
" }, + "pricePerformanceTarget":{ + "shape":"PerformanceTarget", + "documentation":"An object that represents the price performance target settings for the workgroup.
" + }, "publiclyAccessible":{ "shape":"Boolean", "documentation":"A value that specifies whether the workgroup can be accessible from a public network.
" From c3b8d2824b6d2b0067df10415c997674e0039424 Mon Sep 17 00:00:00 2001 From: AWS <> Date: Wed, 30 Oct 2024 18:13:36 +0000 Subject: [PATCH 14/21] Amazon Route 53 Update: This release adds support for TLSA, SSHFP, SVCB, and HTTPS record types. --- .../feature-AmazonRoute53-d97b66b.json | 6 ++++++ .../resources/codegen-resources/service-2.json | 17 +++++++++++------ 2 files changed, 17 insertions(+), 6 deletions(-) create mode 100644 .changes/next-release/feature-AmazonRoute53-d97b66b.json diff --git a/.changes/next-release/feature-AmazonRoute53-d97b66b.json b/.changes/next-release/feature-AmazonRoute53-d97b66b.json new file mode 100644 index 000000000000..b8394f2aa571 --- /dev/null +++ b/.changes/next-release/feature-AmazonRoute53-d97b66b.json @@ -0,0 +1,6 @@ +{ + "type": "feature", + "category": "Amazon Route 53", + "contributor": "", + "description": "This release adds support for TLSA, SSHFP, SVCB, and HTTPS record types." +} diff --git a/services/route53/src/main/resources/codegen-resources/service-2.json b/services/route53/src/main/resources/codegen-resources/service-2.json index 590e550071d3..917e40121327 100644 --- a/services/route53/src/main/resources/codegen-resources/service-2.json +++ b/services/route53/src/main/resources/codegen-resources/service-2.json @@ -235,7 +235,7 @@ {"shape":"QueryLoggingConfigAlreadyExists"}, {"shape":"InsufficientCloudWatchLogsResourcePolicy"} ], - "documentation":"Creates a configuration for DNS query logging. After you create a query logging configuration, Amazon Route 53 begins to publish log data to an Amazon CloudWatch Logs log group.
DNS query logs contain information about the queries that Route 53 receives for a specified public hosted zone, such as the following:
Route 53 edge location that responded to the DNS query
Domain or subdomain that was requested
DNS record type, such as A or AAAA
DNS response code, such as NoError or ServFail
Before you create a query logging configuration, perform the following operations.
If you create a query logging configuration using the Route 53 console, Route 53 performs these operations automatically.
Create a CloudWatch Logs log group, and make note of the ARN, which you specify when you create a query logging configuration. Note the following:
You must create the log group in the us-east-1 region.
You must use the same Amazon Web Services account to create the log group and the hosted zone that you want to configure query logging for.
When you create log groups for query logging, we recommend that you use a consistent prefix, for example:
/aws/route53/hosted zone name
In the next step, you'll create a resource policy, which controls access to one or more log groups and the associated Amazon Web Services resources, such as Route 53 hosted zones. There's a limit on the number of resource policies that you can create, so we recommend that you use a consistent prefix so you can use the same resource policy for all the log groups that you create for query logging.
Create a CloudWatch Logs resource policy, and give it the permissions that Route 53 needs to create log streams and to send query logs to log streams. For the value of Resource, specify the ARN for the log group that you created in the previous step. To use the same resource policy for all the CloudWatch Logs log groups that you created for query logging configurations, replace the hosted zone name with *, for example:
arn:aws:logs:us-east-1:123412341234:log-group:/aws/route53/*
To avoid the confused deputy problem, a security issue where an entity without a permission for an action can coerce a more-privileged entity to perform it, you can optionally limit the permissions that a service has to a resource in a resource-based policy by supplying the following values:
For aws:SourceArn, supply the hosted zone ARN used in creating the query logging configuration. For example, aws:SourceArn: arn:aws:route53:::hostedzone/hosted zone ID.
For aws:SourceAccount, supply the account ID for the account that creates the query logging configuration. For example, aws:SourceAccount:111111111111.
For more information, see The confused deputy problem in the Amazon Web Services IAM User Guide.
You can't use the CloudWatch console to create or edit a resource policy. You must use the CloudWatch API, one of the Amazon Web Services SDKs, or the CLI.
When Route 53 finishes creating the configuration for DNS query logging, it does the following:
Creates a log stream for an edge location the first time that the edge location responds to DNS queries for the specified hosted zone. That log stream is used to log all queries that Route 53 responds to for that edge location.
Begins to send query logs to the applicable log stream.
The name of each log stream is in the following format:
hosted zone ID/edge location code
The edge location code is a three-letter code and an arbitrarily assigned number, for example, DFW3. The three-letter code typically corresponds with the International Air Transport Association airport code for an airport near the edge location. (These abbreviations might change in the future.) For a list of edge locations, see \"The Route 53 Global Network\" on the Route 53 Product Details page.
Query logs contain only the queries that DNS resolvers forward to Route 53. If a DNS resolver has already cached the response to a query (such as the IP address for a load balancer for example.com), the resolver will continue to return the cached response. It doesn't forward another query to Route 53 until the TTL for the corresponding resource record set expires. Depending on how many DNS queries are submitted for a resource record set, and depending on the TTL for that resource record set, query logs might contain information about only one query out of every several thousand queries that are submitted to DNS. For more information about how DNS works, see Routing Internet Traffic to Your Website or Web Application in the Amazon Route 53 Developer Guide.
For a list of the values in each query log and the format of each value, see Logging DNS Queries in the Amazon Route 53 Developer Guide.
For information about charges for query logs, see Amazon CloudWatch Pricing.
If you want Route 53 to stop sending query logs to CloudWatch Logs, delete the query logging configuration. For more information, see DeleteQueryLoggingConfig.
Creates a configuration for DNS query logging. After you create a query logging configuration, Amazon Route 53 begins to publish log data to an Amazon CloudWatch Logs log group.
DNS query logs contain information about the queries that Route 53 receives for a specified public hosted zone, such as the following:
Route 53 edge location that responded to the DNS query
Domain or subdomain that was requested
DNS record type, such as A or AAAA
DNS response code, such as NoError or ServFail
Before you create a query logging configuration, perform the following operations.
If you create a query logging configuration using the Route 53 console, Route 53 performs these operations automatically.
Create a CloudWatch Logs log group, and make note of the ARN, which you specify when you create a query logging configuration. Note the following:
You must create the log group in the us-east-1 region.
You must use the same Amazon Web Services account to create the log group and the hosted zone that you want to configure query logging for.
When you create log groups for query logging, we recommend that you use a consistent prefix, for example:
/aws/route53/hosted zone name
In the next step, you'll create a resource policy, which controls access to one or more log groups and the associated Amazon Web Services resources, such as Route 53 hosted zones. There's a limit on the number of resource policies that you can create, so we recommend that you use a consistent prefix so you can use the same resource policy for all the log groups that you create for query logging.
Create a CloudWatch Logs resource policy, and give it the permissions that Route 53 needs to create log streams and to send query logs to log streams. You must create the CloudWatch Logs resource policy in the us-east-1 region. For the value of Resource, specify the ARN for the log group that you created in the previous step. To use the same resource policy for all the CloudWatch Logs log groups that you created for query logging configurations, replace the hosted zone name with *, for example:
arn:aws:logs:us-east-1:123412341234:log-group:/aws/route53/*
To avoid the confused deputy problem, a security issue where an entity without a permission for an action can coerce a more-privileged entity to perform it, you can optionally limit the permissions that a service has to a resource in a resource-based policy by supplying the following values:
For aws:SourceArn, supply the hosted zone ARN used in creating the query logging configuration. For example, aws:SourceArn: arn:aws:route53:::hostedzone/hosted zone ID.
For aws:SourceAccount, supply the account ID for the account that creates the query logging configuration. For example, aws:SourceAccount:111111111111.
For more information, see The confused deputy problem in the Amazon Web Services IAM User Guide.
You can't use the CloudWatch console to create or edit a resource policy. You must use the CloudWatch API, one of the Amazon Web Services SDKs, or the CLI.
When Route 53 finishes creating the configuration for DNS query logging, it does the following:
Creates a log stream for an edge location the first time that the edge location responds to DNS queries for the specified hosted zone. That log stream is used to log all queries that Route 53 responds to for that edge location.
Begins to send query logs to the applicable log stream.
The name of each log stream is in the following format:
hosted zone ID/edge location code
The edge location code is a three-letter code and an arbitrarily assigned number, for example, DFW3. The three-letter code typically corresponds with the International Air Transport Association airport code for an airport near the edge location. (These abbreviations might change in the future.) For a list of edge locations, see \"The Route 53 Global Network\" on the Route 53 Product Details page.
Query logs contain only the queries that DNS resolvers forward to Route 53. If a DNS resolver has already cached the response to a query (such as the IP address for a load balancer for example.com), the resolver will continue to return the cached response. It doesn't forward another query to Route 53 until the TTL for the corresponding resource record set expires. Depending on how many DNS queries are submitted for a resource record set, and depending on the TTL for that resource record set, query logs might contain information about only one query out of every several thousand queries that are submitted to DNS. For more information about how DNS works, see Routing Internet Traffic to Your Website or Web Application in the Amazon Route 53 Developer Guide.
For a list of the values in each query log and the format of each value, see Logging DNS Queries in the Amazon Route 53 Developer Guide.
For information about charges for query logs, see Amazon CloudWatch Pricing.
If you want Route 53 to stop sending query logs to CloudWatch Logs, delete the query logging configuration. For more information, see DeleteQueryLoggingConfig.
Gets information about a specified hosted zone including the four name servers assigned to the hosted zone.
" + "documentation":"Gets information about a specified hosted zone including the four name servers assigned to the hosted zone.
returns the VPCs associated with the specified hosted zone and does not reflect the VPC associations by Route 53 Profiles. To get the associations to a Profile, call the ListProfileAssociations API.
Lists all the private hosted zones that a specified VPC is associated with, regardless of which Amazon Web Services account or Amazon Web Services service owns the hosted zones. The HostedZoneOwner structure in the response contains one of the following values:
An OwningAccount element, which contains the account number of either the current Amazon Web Services account or another Amazon Web Services account. Some services, such as Cloud Map, create hosted zones using the current account.
An OwningService element, which identifies the Amazon Web Services service that created and owns the hosted zone. For example, if a hosted zone was created by Amazon Elastic File System (Amazon EFS), the value of Owner is efs.amazonaws.com.
When listing private hosted zones, the hosted zone and the Amazon VPC must belong to the same partition where the hosted zones were created. A partition is a group of Amazon Web Services Regions. Each Amazon Web Services account is scoped to one partition.
The following are the supported partitions:
aws - Amazon Web Services Regions
aws-cn - China Regions
aws-us-gov - Amazon Web Services GovCloud (US) Region
For more information, see Access Management in the Amazon Web Services General Reference.
Lists all the private hosted zones that a specified VPC is associated with, regardless of which Amazon Web Services account or Amazon Web Services service owns the hosted zones. The HostedZoneOwner structure in the response contains one of the following values:
An OwningAccount element, which contains the account number of either the current Amazon Web Services account or another Amazon Web Services account. Some services, such as Cloud Map, create hosted zones using the current account.
An OwningService element, which identifies the Amazon Web Services service that created and owns the hosted zone. For example, if a hosted zone was created by Amazon Elastic File System (Amazon EFS), the value of Owner is efs.amazonaws.com.
ListHostedZonesByVPC returns the hosted zones associated with the specified VPC and does not reflect the hosted zone associations to VPCs via Route 53 Profiles. To get the associations to a Profile, call the ListProfileResourceAssociations API.
When listing private hosted zones, the hosted zone and the Amazon VPC must belong to the same partition where the hosted zones were created. A partition is a group of Amazon Web Services Regions. Each Amazon Web Services account is scoped to one partition.
The following are the supported partitions:
aws - Amazon Web Services Regions
aws-cn - China Regions
aws-us-gov - Amazon Web Services GovCloud (US) Region
For more information, see Access Management in the Amazon Web Services General Reference.
The type of health check that you want to create, which indicates how Amazon Route 53 determines whether an endpoint is healthy.
You can't change the value of Type after you create a health check.
You can create the following types of health checks:
HTTP: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and waits for an HTTP status code of 200 or greater and less than 400.
HTTPS: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and waits for an HTTP status code of 200 or greater and less than 400.
If you specify HTTPS for the value of Type, the endpoint must support TLS v1.0 or later.
HTTP_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.
HTTPS_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.
TCP: Route 53 tries to establish a TCP connection.
CLOUDWATCH_METRIC: The health check is associated with a CloudWatch alarm. If the state of the alarm is OK, the health check is considered healthy. If the state is ALARM, the health check is considered unhealthy. If CloudWatch doesn't have sufficient data to determine whether the state is OK or ALARM, the health check status depends on the setting for InsufficientDataHealthStatus: Healthy, Unhealthy, or LastKnownStatus.
CALCULATED: For health checks that monitor the status of other health checks, Route 53 adds up the number of health checks that Route 53 health checkers consider to be healthy and compares that number with the value of HealthThreshold.
RECOVERY_CONTROL: The health check is associated with a Route53 Application Recovery Controller routing control. If the routing control state is ON, the health check is considered healthy. If the state is OFF, the health check is considered unhealthy.
For more information, see How Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.
" + "documentation":"The type of health check that you want to create, which indicates how Amazon Route 53 determines whether an endpoint is healthy.
You can't change the value of Type after you create a health check.
You can create the following types of health checks:
HTTP: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and waits for an HTTP status code of 200 or greater and less than 400.
HTTPS: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and waits for an HTTP status code of 200 or greater and less than 400.
If you specify HTTPS for the value of Type, the endpoint must support TLS v1.0, v1.1, or v1.2.
HTTP_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTP request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.
HTTPS_STR_MATCH: Route 53 tries to establish a TCP connection. If successful, Route 53 submits an HTTPS request and searches the first 5,120 bytes of the response body for the string that you specify in SearchString.
TCP: Route 53 tries to establish a TCP connection.
CLOUDWATCH_METRIC: The health check is associated with a CloudWatch alarm. If the state of the alarm is OK, the health check is considered healthy. If the state is ALARM, the health check is considered unhealthy. If CloudWatch doesn't have sufficient data to determine whether the state is OK or ALARM, the health check status depends on the setting for InsufficientDataHealthStatus: Healthy, Unhealthy, or LastKnownStatus.
CALCULATED: For health checks that monitor the status of other health checks, Route 53 adds up the number of health checks that Route 53 health checkers consider to be healthy and compares that number with the value of HealthThreshold.
RECOVERY_CONTROL: The health check is associated with a Route53 Application Recovery Controller routing control. If the routing control state is ON, the health check is considered healthy. If the state is OFF, the health check is considered unhealthy.
For more information, see How Route 53 Determines Whether an Endpoint Is Healthy in the Amazon Route 53 Developer Guide.
" }, "ResourcePath":{ "shape":"ResourcePath", @@ -5381,7 +5381,11 @@ "SPF", "AAAA", "CAA", - "DS" + "DS", + "TLSA", + "SSHFP", + "SVCB", + "HTTPS" ] }, "RecordData":{ @@ -5457,7 +5461,7 @@ }, "Type":{ "shape":"RRType", - "documentation":"The DNS record type. For information about different record types and how data is encoded for them, see Supported DNS Resource Record Types in the Amazon Route 53 Developer Guide.
Valid values for basic resource record sets: A | AAAA | CAA | CNAME | DS |MX | NAPTR | NS | PTR | SOA | SPF | SRV | TXT
Values for weighted, latency, geolocation, and failover resource record sets: A | AAAA | CAA | CNAME | MX | NAPTR | PTR | SPF | SRV | TXT. When creating a group of weighted, latency, geolocation, or failover resource record sets, specify the same value for all of the resource record sets in the group.
Valid values for multivalue answer resource record sets: A | AAAA | MX | NAPTR | PTR | SPF | SRV | TXT
SPF records were formerly used to verify the identity of the sender of email messages. However, we no longer recommend that you create resource record sets for which the value of Type is SPF. RFC 7208, Sender Policy Framework (SPF) for Authorizing Use of Domains in Email, Version 1, has been updated to say, \"...[I]ts existence and mechanism defined in [RFC4408] have led to some interoperability issues. Accordingly, its use is no longer appropriate for SPF version 1; implementations are not to use it.\" In RFC 7208, see section 14.1, The SPF DNS Record Type.
Values for alias resource record sets:
Amazon API Gateway custom regional APIs and edge-optimized APIs: A
CloudFront distributions: A
If IPv6 is enabled for the distribution, create two resource record sets to route traffic to your distribution, one with a value of A and one with a value of AAAA.
Amazon API Gateway environment that has a regionalized subdomain: A
ELB load balancers: A | AAAA
Amazon S3 buckets: A
Amazon Virtual Private Cloud interface VPC endpoints A
Another resource record set in this hosted zone: Specify the type of the resource record set that you're creating the alias for. All values are supported except NS and SOA.
If you're creating an alias record that has the same name as the hosted zone (known as the zone apex), you can't route traffic to a record for which the value of Type is CNAME. This is because the alias record must have the same type as the record you're routing traffic to, and creating a CNAME record for the zone apex isn't supported even for an alias record.
The DNS record type. For information about different record types and how data is encoded for them, see Supported DNS Resource Record Types in the Amazon Route 53 Developer Guide.
Valid values for basic resource record sets: A | AAAA | CAA | CNAME | DS |MX | NAPTR | NS | PTR | SOA | SPF | SRV | TXT| TLSA| SSHFP| SVCB| HTTPS
Values for weighted, latency, geolocation, and failover resource record sets: A | AAAA | CAA | CNAME | MX | NAPTR | PTR | SPF | SRV | TXT| TLSA| SSHFP| SVCB| HTTPS. When creating a group of weighted, latency, geolocation, or failover resource record sets, specify the same value for all of the resource record sets in the group.
Valid values for multivalue answer resource record sets: A | AAAA | MX | NAPTR | PTR | SPF | SRV | TXT| CAA| TLSA| SSHFP| SVCB| HTTPS
SPF records were formerly used to verify the identity of the sender of email messages. However, we no longer recommend that you create resource record sets for which the value of Type is SPF. RFC 7208, Sender Policy Framework (SPF) for Authorizing Use of Domains in Email, Version 1, has been updated to say, \"...[I]ts existence and mechanism defined in [RFC4408] have led to some interoperability issues. Accordingly, its use is no longer appropriate for SPF version 1; implementations are not to use it.\" In RFC 7208, see section 14.1, The SPF DNS Record Type.
Values for alias resource record sets:
Amazon API Gateway custom regional APIs and edge-optimized APIs: A
CloudFront distributions: A
If IPv6 is enabled for the distribution, create two resource record sets to route traffic to your distribution, one with a value of A and one with a value of AAAA.
Amazon API Gateway environment that has a regionalized subdomain: A
ELB load balancers: A | AAAA
Amazon S3 buckets: A
Amazon Virtual Private Cloud interface VPC endpoints A
Another resource record set in this hosted zone: Specify the type of the resource record set that you're creating the alias for. All values are supported except NS and SOA.
If you're creating an alias record that has the same name as the hosted zone (known as the zone apex), you can't route traffic to a record for which the value of Type is CNAME. This is because the alias record must have the same type as the record you're routing traffic to, and creating a CNAME record for the zone apex isn't supported even for an alias record.
Use the CalculateIsolines action to find service areas that can be reached in a given threshold of time, distance.
Calculates route matrix containing the results for all pairs of Origins to Destinations. Each row corresponds to one entry in Origins. Each entry in the row corresponds to the route from that entry in Origins to an entry in Destinations positions.
" + }, + "CalculateRoutes":{ + "name":"CalculateRoutes", + "http":{ + "method":"POST", + "requestUri":"/routes", + "responseCode":200 + }, + "input":{"shape":"CalculateRoutesRequest"}, + "output":{"shape":"CalculateRoutesResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ValidationException"}, + {"shape":"ThrottlingException"} + ], + "documentation":"Calculates a route given the following required parameters: Origin and Destination.
Calculates the optimal order to travel between a set of waypoints to minimize either the travel time or the distance travelled during the journey, based on road network restrictions and the traffic pattern data.
" + }, + "SnapToRoads":{ + "name":"SnapToRoads", + "http":{ + "method":"POST", + "requestUri":"/snap-to-roads", + "responseCode":200 + }, + "input":{"shape":"SnapToRoadsRequest"}, + "output":{"shape":"SnapToRoadsResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ValidationException"}, + {"shape":"ThrottlingException"} + ], + "documentation":"The SnapToRoads action matches GPS trace to roads most likely traveled on.
" + } + }, + "shapes":{ + "AccessDeniedException":{ + "type":"structure", + "required":["Message"], + "members":{ + "Message":{ + "shape":"String", + "locationName":"message" + } + }, + "documentation":"You don't have sufficient access to perform this action.
", + "error":{ + "httpStatusCode":403, + "senderFault":true + }, + "exception":true + }, + "ApiKey":{ + "type":"string", + "max":1000, + "min":0, + "sensitive":true + }, + "BeforeWaypointsList":{ + "type":"list", + "member":{"shape":"WaypointIndex"} + }, + "Boolean":{ + "type":"boolean", + "box":true + }, + "BoundingBox":{ + "type":"list", + "member":{"shape":"Double"}, + "max":4, + "min":4, + "sensitive":true + }, + "CalculateIsolinesRequest":{ + "type":"structure", + "required":["Thresholds"], + "members":{ + "Allow":{ + "shape":"IsolineAllowOptions", + "documentation":"Features that are allowed while calculating. a route
" + }, + "ArrivalTime":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"Time of arrival at the destination.
Time format: YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Examples:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
Features that are avoided while calculating a route. Avoidance is on a best-case basis. If an avoidance can't be satisfied for a particular case, it violates the avoidance and the returned response produces a notice for the violation.
" + }, + "DepartNow":{ + "shape":"Boolean", + "documentation":"Uses the current time as the time of departure.
" + }, + "DepartureTime":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"Time of departure from thr origin.
Time format:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Examples:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
The final position for the route. In the World Geodetic System (WGS 84) format: [longitude, latitude].
Destination related options.
" + }, + "IsolineGeometryFormat":{ + "shape":"GeometryFormat", + "documentation":"The format of the returned IsolineGeometry.
Default Value:FlexiblePolyline
Defines the granularity of the returned Isoline
" + }, + "Key":{ + "shape":"ApiKey", + "documentation":"Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + }, + "OptimizeIsolineFor":{ + "shape":"IsolineOptimizationObjective", + "documentation":"Specifies the optimization criteria for when calculating an isoline. AccurateCalculation generates an isoline of higher granularity that is more precise. FastCalculation generates an isoline faster by reducing the granularity, and in turn the quality of the isoline. BalancedCalculation generates an isoline by balancing between quality and performance.
Default Value: BalancedCalculation
Specifies the optimization criteria for calculating a route.
Default Value: FastestRoute
The start position for the route.
" + }, + "OriginOptions":{ + "shape":"IsolineOriginOptions", + "documentation":"Origin related options.
" + }, + "Thresholds":{ + "shape":"IsolineThresholds", + "documentation":"Threshold to be used for the isoline calculation. Up to 3 thresholds per provided type can be requested.
" + }, + "Traffic":{ + "shape":"IsolineTrafficOptions", + "documentation":"Traffic related options.
" + }, + "TravelMode":{ + "shape":"IsolineTravelMode", + "documentation":"Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.
The mode Scooter also applies to motorcycles, set to Scooter when wanted to calculate options for motorcycles.
Default Value: Car
Travel mode related options for the provided travel mode.
" + } + } + }, + "CalculateIsolinesResponse":{ + "type":"structure", + "required":[ + "IsolineGeometryFormat", + "Isolines", + "PricingBucket" + ], + "members":{ + "ArrivalTime":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"Time of arrival at the destination. This parameter is returned only if the Destination parameters was provided in the request.
Time format:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Examples:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
Time of departure from thr origin.
Time format:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Examples:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
The format of the returned IsolineGeometry.
Default Value:FlexiblePolyline
Calculated isolines and associated properties.
" + }, + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the query is charged at.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + }, + "SnappedDestination":{ + "shape":"Position", + "documentation":"Snapped destination that was used for the Isoline calculation.
" + }, + "SnappedOrigin":{ + "shape":"Position", + "documentation":"Snapped origin that was used for the Isoline calculation.
" + } + } + }, + "CalculateRouteMatrixRequest":{ + "type":"structure", + "required":[ + "Destinations", + "Origins", + "RoutingBoundary" + ], + "members":{ + "Allow":{ + "shape":"RouteMatrixAllowOptions", + "documentation":"Features that are allowed while calculating. a route
" + }, + "Avoid":{ + "shape":"RouteMatrixAvoidanceOptions", + "documentation":"Features that are avoided while calculating a route. Avoidance is on a best-case basis. If an avoidance can't be satisfied for a particular case, it violates the avoidance and the returned response produces a notice for the violation.
" + }, + "DepartNow":{ + "shape":"Boolean", + "documentation":"Uses the current time as the time of departure.
" + }, + "DepartureTime":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"Time of departure from thr origin.
Time format:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Examples:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
List of destinations for the route.
" + }, + "Exclude":{ + "shape":"RouteMatrixExclusionOptions", + "documentation":"Features to be strictly excluded while calculating the route.
" + }, + "Key":{ + "shape":"ApiKey", + "documentation":"Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + }, + "OptimizeRoutingFor":{ + "shape":"RoutingObjective", + "documentation":"Specifies the optimization criteria for calculating a route.
Default Value: FastestRoute
The position in longitude and latitude for the origin.
" + }, + "RoutingBoundary":{ + "shape":"RouteMatrixBoundary", + "documentation":"Boundary within which the matrix is to be calculated. All data, origins and destinations outside the boundary are considered invalid.
When request routing boundary was set as AutoCircle, the response routing boundary will return Circle derived from the AutoCircle settings.
Traffic related options.
" + }, + "TravelMode":{ + "shape":"RouteMatrixTravelMode", + "documentation":"Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.
Default Value: Car
Travel mode related options for the provided travel mode.
" + } + } + }, + "CalculateRouteMatrixRequestDestinationsList":{ + "type":"list", + "member":{"shape":"RouteMatrixDestination"}, + "min":1 + }, + "CalculateRouteMatrixRequestOriginsList":{ + "type":"list", + "member":{"shape":"RouteMatrixOrigin"}, + "min":1 + }, + "CalculateRouteMatrixResponse":{ + "type":"structure", + "required":[ + "ErrorCount", + "PricingBucket", + "RouteMatrix", + "RoutingBoundary" + ], + "members":{ + "ErrorCount":{ + "shape":"CalculateRouteMatrixResponseErrorCountInteger", + "documentation":"The count of error results in the route matrix. If this number is 0, all routes were calculated successfully.
" + }, + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the query is charged at.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + }, + "RouteMatrix":{ + "shape":"RouteMatrix", + "documentation":"The calculated route matrix containing the results for all pairs of Origins to Destination positions. Each row corresponds to one entry in Origins. Each entry in the row corresponds to the route from that entry in Origins to an entry in Destination positions.
" + }, + "RoutingBoundary":{ + "shape":"RouteMatrixBoundary", + "documentation":"Boundary within which the matrix is to be calculated. All data, origins and destinations outside the boundary are considered invalid.
When request routing boundary was set as AutoCircle, the response routing boundary will return Circle derived from the AutoCircle settings.
Features that are allowed while calculating. a route
" + }, + "ArrivalTime":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"Time of arrival at the destination.
Time format:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Examples:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
Features that are avoided while calculating a route. Avoidance is on a best-case basis. If an avoidance can't be satisfied for a particular case, it violates the avoidance and the returned response produces a notice for the violation.
" + }, + "DepartNow":{ + "shape":"Boolean", + "documentation":"Uses the current time as the time of departure.
" + }, + "DepartureTime":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"Time of departure from thr origin.
Time format:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Examples:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
The final position for the route. In the World Geodetic System (WGS 84) format: [longitude, latitude].
Destination related options.
" + }, + "Driver":{ + "shape":"RouteDriverOptions", + "documentation":"Driver related options.
" + }, + "Exclude":{ + "shape":"RouteExclusionOptions", + "documentation":"Features to be strictly excluded while calculating the route.
" + }, + "InstructionsMeasurementSystem":{ + "shape":"MeasurementSystem", + "documentation":"Measurement system to be used for instructions within steps in the response.
" + }, + "Key":{ + "shape":"ApiKey", + "documentation":"Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + }, + "Languages":{ + "shape":"CalculateRoutesRequestLanguagesList", + "documentation":"List of languages for instructions within steps in the response.
Instructions in the requested language are returned only if they are available.
A list of optional additional parameters such as timezone that can be requested for each result.
Elevation: Retrieves the elevation information for each location.
Incidents: Provides information on traffic incidents along the route.
PassThroughWaypoints: Indicates waypoints that are passed through without stopping.
Summary: Returns a summary of the route, including distance and duration.
Tolls: Supplies toll cost information along the route.
TravelStepInstructions: Provides step-by-step instructions for travel along the route.
TruckRoadTypes: Returns information about road types suitable for trucks.
TypicalDuration: Gives typical travel duration based on historical data.
Zones: Specifies the time zone information for each waypoint.
Specifies the format of the geometry returned for each leg of the route. You can choose between two different geometry encoding formats.
FlexiblePolyline: A compact and precise encoding format for the leg geometry. For more information on the format, see the GitHub repository for FlexiblePolyline .
Simple: A less compact encoding, which is easier to decode but may be less precise and result in larger payloads.
Maximum number of alternative routes to be provided in the response, if available.
" + }, + "OptimizeRoutingFor":{ + "shape":"RoutingObjective", + "documentation":"Specifies the optimization criteria for calculating a route.
Default Value: FastestRoute
The start position for the route.
" + }, + "OriginOptions":{ + "shape":"RouteOriginOptions", + "documentation":"Origin related options.
" + }, + "SpanAdditionalFeatures":{ + "shape":"RouteSpanAdditionalFeatureList", + "documentation":"A list of optional features such as SpeedLimit that can be requested for a Span. A span is a section of a Leg for which the requested features have the same values.
" + }, + "Tolls":{ + "shape":"RouteTollOptions", + "documentation":"Toll related options.
" + }, + "Traffic":{ + "shape":"RouteTrafficOptions", + "documentation":"Traffic related options.
" + }, + "TravelMode":{ + "shape":"RouteTravelMode", + "documentation":"Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.
Default Value: Car
Travel mode related options for the provided travel mode.
" + }, + "TravelStepType":{ + "shape":"RouteTravelStepType", + "documentation":"Type of step returned by the response. Default provides basic steps intended for web based applications. TurnByTurn provides detailed instructions with more granularity intended for a turn based naviagtion system.
" + }, + "Waypoints":{ + "shape":"RouteWaypointList", + "documentation":"List of waypoints between the Origin and Destination.
" + } + } + }, + "CalculateRoutesRequestLanguagesList":{ + "type":"list", + "member":{"shape":"LanguageTag"}, + "max":10, + "min":0 + }, + "CalculateRoutesRequestMaxAlternativesInteger":{ + "type":"integer", + "box":true, + "max":5, + "min":0 + }, + "CalculateRoutesResponse":{ + "type":"structure", + "required":[ + "LegGeometryFormat", + "Notices", + "PricingBucket", + "Routes" + ], + "members":{ + "LegGeometryFormat":{ + "shape":"GeometryFormat", + "documentation":"Specifies the format of the geometry returned for each leg of the route.
" + }, + "Notices":{ + "shape":"RouteResponseNoticeList", + "documentation":"Notices are additional information returned that indicate issues that occurred during route calculation.
" + }, + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the query is charged at.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + }, + "Routes":{ + "shape":"RouteList", + "documentation":"The path from the origin to the destination.
" + } + } + }, + "Circle":{ + "type":"structure", + "required":[ + "Center", + "Radius" + ], + "members":{ + "Center":{ + "shape":"Position", + "documentation":"Center of the Circle defined in longitude and latitude coordinates.
Example: [-123.1174, 49.2847] represents the position with longitude -123.1174 and latitude 49.2847.
Radius of the Circle.
Unit: meters
Geometry defined as a circle. When request routing boundary was set as AutoCircle, the response routing boundary will return Circle derived from the AutoCircle settings.
An ordered list of positions used to plot a route on a map.
LineString and Polyline are mutually exclusive properties.
Radius that defines the width of the corridor.
" + } + }, + "documentation":"Geometry defined as a corridor - a LineString with a radius that defines the width of the corridor.
", + "sensitive":true + }, + "CountryCode":{ + "type":"string", + "max":3, + "min":2, + "pattern":"([A-Z]{2}|[A-Z]{3})" + }, + "CountryCode3":{ + "type":"string", + "max":3, + "min":3, + "pattern":"[A-Z]{3}" + }, + "CountryCodeList":{ + "type":"list", + "member":{"shape":"CountryCode"}, + "max":100, + "min":1 + }, + "CurrencyCode":{ + "type":"string", + "max":3, + "min":3, + "pattern":"[A-Z]{3}" + }, + "DayOfWeek":{ + "type":"string", + "enum":[ + "Monday", + "Tuesday", + "Wednesday", + "Thursday", + "Friday", + "Saturday", + "Sunday" + ] + }, + "DimensionCentimeters":{ + "type":"long", + "max":4294967295, + "min":0 + }, + "DistanceMeters":{ + "type":"long", + "max":4294967295, + "min":0 + }, + "DistanceThresholdList":{ + "type":"list", + "member":{"shape":"DistanceThresholdListMemberLong"}, + "max":5, + "min":1 + }, + "DistanceThresholdListMemberLong":{ + "type":"long", + "max":300000, + "min":0 + }, + "Double":{ + "type":"double", + "box":true + }, + "DurationSeconds":{ + "type":"long", + "max":4294967295, + "min":0 + }, + "GeometryFormat":{ + "type":"string", + "enum":[ + "FlexiblePolyline", + "Simple" + ] + }, + "Heading":{ + "type":"double", + "max":360.0, + "min":0.0 + }, + "IndexList":{ + "type":"list", + "member":{"shape":"Integer"} + }, + "Integer":{ + "type":"integer", + "box":true + }, + "InternalServerException":{ + "type":"structure", + "required":["Message"], + "members":{ + "Message":{ + "shape":"String", + "locationName":"message" + } + }, + "documentation":"The request processing has failed because of an unknown error, exception or failure.
", + "error":{"httpStatusCode":500}, + "exception":true, + "fault":true, + "retryable":{"throttling":false} + }, + "Isoline":{ + "type":"structure", + "required":[ + "Connections", + "Geometries" + ], + "members":{ + "Connections":{ + "shape":"IsolineConnectionList", + "documentation":"Isolines may contain multiple components, if these components are connected by ferry links. These components are returned as separate polygons while the ferry links are returned as connections.
" + }, + "DistanceThreshold":{ + "shape":"DistanceMeters", + "documentation":"Distance threshold corresponding to the calculated Isoline.
" + }, + "Geometries":{ + "shape":"IsolineShapeGeometryList", + "documentation":"Geometries for the Calculated isolines.
" + }, + "TimeThreshold":{ + "shape":"DurationSeconds", + "documentation":"Time threshold corresponding to the calculated isoline.
" + } + }, + "documentation":"Calculated isolines and associated properties.
" + }, + "IsolineAllowOptions":{ + "type":"structure", + "members":{ + "Hot":{ + "shape":"Boolean", + "documentation":"Allow Hot (High Occupancy Toll) lanes while calculating the route.
" + }, + "Hov":{ + "shape":"Boolean", + "documentation":"Allow Hov (High Occupancy vehicle) lanes while calculating the route.
" + } + }, + "documentation":"Features that are allowed while calculating. a route
" + }, + "IsolineAvoidanceArea":{ + "type":"structure", + "required":["Geometry"], + "members":{ + "Except":{ + "shape":"IsolineAvoidanceAreaGeometryList", + "documentation":"Exceptions to the provided avoidance geometry, to be included while calculating the route.
" + }, + "Geometry":{ + "shape":"IsolineAvoidanceAreaGeometry", + "documentation":"Geometry of the area to be avoided.
" + } + }, + "documentation":"The area to be avoided.
" + }, + "IsolineAvoidanceAreaGeometry":{ + "type":"structure", + "members":{ + "BoundingBox":{ + "shape":"BoundingBox", + "documentation":"Geometry defined as a bounding box. The first pair represents the X and Y coordinates (longitude and latitude,) of the southwest corner of the bounding box; the second pair represents the X and Y coordinates (longitude and latitude) of the northeast corner.
" + }, + "Corridor":{ + "shape":"Corridor", + "documentation":"Geometry defined as a corridor - a LineString with a radius that defines the width of the corridor.
" + }, + "Polygon":{ + "shape":"IsolineAvoidanceAreaGeometryPolygonList", + "documentation":"A list of Polygon will be excluded for calculating isolines, the list can only contain 1 polygon.
" + }, + "PolylineCorridor":{ + "shape":"PolylineCorridor", + "documentation":"Geometry defined as an encoded corridor – a polyline with a radius that defines the width of the corridor. For more information on polyline encoding, see https://github.com/heremaps/flexiblepolyline/blob/master/README.md.
" + }, + "PolylinePolygon":{ + "shape":"IsolineAvoidanceAreaGeometryPolylinePolygonList", + "documentation":"A list of PolylinePolygon's that are excluded for calculating isolines, the list can only contain 1 polygon. For more information on polyline encoding, see https://github.com/heremaps/flexiblepolyline/blob/master/README.md.
" + } + }, + "documentation":"The avoidance geometry, to be included while calculating the route.
" + }, + "IsolineAvoidanceAreaGeometryList":{ + "type":"list", + "member":{"shape":"IsolineAvoidanceAreaGeometry"} + }, + "IsolineAvoidanceAreaGeometryPolygonList":{ + "type":"list", + "member":{"shape":"LinearRing"}, + "max":1, + "min":1 + }, + "IsolineAvoidanceAreaGeometryPolylinePolygonList":{ + "type":"list", + "member":{"shape":"PolylineRing"}, + "max":1, + "min":1 + }, + "IsolineAvoidanceAreaList":{ + "type":"list", + "member":{"shape":"IsolineAvoidanceArea"} + }, + "IsolineAvoidanceOptions":{ + "type":"structure", + "members":{ + "Areas":{ + "shape":"IsolineAvoidanceAreaList", + "documentation":"Areas to be avoided.
" + }, + "CarShuttleTrains":{ + "shape":"Boolean", + "documentation":"Avoid car-shuttle-trains while calculating the route.
" + }, + "ControlledAccessHighways":{ + "shape":"Boolean", + "documentation":"Avoid controlled access highways while calculating the route.
" + }, + "DirtRoads":{ + "shape":"Boolean", + "documentation":"Avoid dirt roads while calculating the route.
" + }, + "Ferries":{ + "shape":"Boolean", + "documentation":"Avoid ferries while calculating the route.
" + }, + "SeasonalClosure":{ + "shape":"Boolean", + "documentation":"Avoid roads that have seasonal closure while calculating the route.
" + }, + "TollRoads":{ + "shape":"Boolean", + "documentation":"Avoids roads where the specified toll transponders are the only mode of payment.
" + }, + "TollTransponders":{ + "shape":"Boolean", + "documentation":"Avoids roads where the specified toll transponders are the only mode of payment.
" + }, + "TruckRoadTypes":{ + "shape":"TruckRoadTypeList", + "documentation":"Truck road type identifiers. BK1 through BK4 apply only to Sweden. A2,A4,B2,B4,C,D,ET2,ET4 apply only to Mexico.
There are currently no other supported values as of 26th April 2024.
Avoid tunnels while calculating the route.
" + }, + "UTurns":{ + "shape":"Boolean", + "documentation":"Avoid U-turns for calculation on highways and motorways.
" + }, + "ZoneCategories":{ + "shape":"IsolineAvoidanceZoneCategoryList", + "documentation":"Zone categories to be avoided.
" + } + }, + "documentation":"Features that are avoided while calculating a route. Avoidance is on a best-case basis. If an avoidance can't be satisfied for a particular case, it violates the avoidance and the returned response produces a notice for the violation.
" + }, + "IsolineAvoidanceZoneCategory":{ + "type":"structure", + "members":{ + "Category":{ + "shape":"IsolineZoneCategory", + "documentation":"Zone category to be avoided.
" + } + }, + "documentation":"Zone category to be avoided.
" + }, + "IsolineAvoidanceZoneCategoryList":{ + "type":"list", + "member":{"shape":"IsolineAvoidanceZoneCategory"}, + "max":3, + "min":0 + }, + "IsolineCarOptions":{ + "type":"structure", + "members":{ + "EngineType":{ + "shape":"IsolineEngineType", + "documentation":"Engine type of the vehicle.
" + }, + "LicensePlate":{ + "shape":"IsolineVehicleLicensePlate", + "documentation":"The vehicle License Plate.
" + }, + "MaxSpeed":{ + "shape":"IsolineCarOptionsMaxSpeedDouble", + "documentation":"Maximum speed.
Unit: KilometersPerHour
The number of occupants in the vehicle.
Default Value: 1
Options for vehicles.
" + }, + "IsolineCarOptionsMaxSpeedDouble":{ + "type":"double", + "max":252.0, + "min":3.6 + }, + "IsolineCarOptionsOccupancyInteger":{ + "type":"integer", + "box":true, + "min":1 + }, + "IsolineConnection":{ + "type":"structure", + "required":[ + "FromPolygonIndex", + "Geometry", + "ToPolygonIndex" + ], + "members":{ + "FromPolygonIndex":{ + "shape":"IsolineConnectionFromPolygonIndexInteger", + "documentation":"Index of the polygon corresponding to the \"from\" component of the connection. The polygon is available from Isoline[].Geometries.
The isoline geometry.
" + }, + "ToPolygonIndex":{ + "shape":"IsolineConnectionToPolygonIndexInteger", + "documentation":"Index of the polygon corresponding to the \"to\" component of the connection. The polygon is available from Isoline[].Geometries.
Isolines may contain multiple components, if these components are connected by ferry links. These components are returned as separate polygons while the ferry links are returned as connections.
" + }, + "IsolineConnectionFromPolygonIndexInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "IsolineConnectionGeometry":{ + "type":"structure", + "members":{ + "LineString":{ + "shape":"LineString", + "documentation":"An ordered list of positions used to plot a route on a map.
LineString and Polyline are mutually exclusive properties.
An ordered list of positions used to plot a route on a map in a lossy compression format.
LineString and Polyline are mutually exclusive properties.
Geometry of the connection between different Isoline components.
" + }, + "IsolineConnectionList":{ + "type":"list", + "member":{"shape":"IsolineConnection"} + }, + "IsolineConnectionToPolygonIndexInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "IsolineDestinationOptions":{ + "type":"structure", + "members":{ + "AvoidActionsForDistance":{ + "shape":"DistanceMeters", + "documentation":"Avoids actions for the provided distance. This is typically to consider for users in moving vehicles who may not have sufficient time to make an action at an origin or a destination.
" + }, + "Heading":{ + "shape":"Heading", + "documentation":"GPS Heading at the position.
" + }, + "Matching":{ + "shape":"IsolineMatchingOptions", + "documentation":"Options to configure matching the provided position to the road network.
" + }, + "SideOfStreet":{ + "shape":"IsolineSideOfStreetOptions", + "documentation":"Options to configure matching the provided position to a side of the street.
" + } + }, + "documentation":"Destination related options.
" + }, + "IsolineEngineType":{ + "type":"string", + "enum":[ + "Electric", + "InternalCombustion", + "PluginHybrid" + ] + }, + "IsolineGranularityOptions":{ + "type":"structure", + "members":{ + "MaxPoints":{ + "shape":"IsolineGranularityOptionsMaxPointsInteger", + "documentation":"Maximum number of points of returned Isoline.
" + }, + "MaxResolution":{ + "shape":"DistanceMeters", + "documentation":"Maximum resolution of the returned isoline.
Unit: centimeters
Isoline granularity related options.
" + }, + "IsolineGranularityOptionsMaxPointsInteger":{ + "type":"integer", + "box":true, + "min":31 + }, + "IsolineHazardousCargoType":{ + "type":"string", + "enum":[ + "Combustible", + "Corrosive", + "Explosive", + "Flammable", + "Gas", + "HarmfulToWater", + "Organic", + "Other", + "Poison", + "PoisonousInhalation", + "Radioactive" + ] + }, + "IsolineHazardousCargoTypeList":{ + "type":"list", + "member":{"shape":"IsolineHazardousCargoType"}, + "max":11, + "min":0 + }, + "IsolineList":{ + "type":"list", + "member":{"shape":"Isoline"}, + "max":5, + "min":1 + }, + "IsolineMatchingOptions":{ + "type":"structure", + "members":{ + "NameHint":{ + "shape":"SensitiveString", + "documentation":"Attempts to match the provided position to a road similar to the provided name.
" + }, + "OnRoadThreshold":{ + "shape":"DistanceMeters", + "documentation":"If the distance to a highway/bridge/tunnel/sliproad is within threshold, the waypoint will be snapped to the highway/bridge/tunnel/sliproad.
Unit: meters
Considers all roads within the provided radius to match the provided destination to. The roads that are considered are determined by the provided Strategy.
Unit: Meters
Strategy that defines matching of the position onto the road network. MatchAny considers all roads possible, whereas MatchMostSignificantRoad matches to the most significant road.
" + } + }, + "documentation":"Isoline matching related options.
" + }, + "IsolineOptimizationObjective":{ + "type":"string", + "enum":[ + "AccurateCalculation", + "BalancedCalculation", + "FastCalculation" + ] + }, + "IsolineOriginOptions":{ + "type":"structure", + "members":{ + "AvoidActionsForDistance":{ + "shape":"DistanceMeters", + "documentation":"Avoids actions for the provided distance. This is typically to consider for users in moving vehicles who may not have sufficient time to make an action at an origin or a destination.
" + }, + "Heading":{ + "shape":"Heading", + "documentation":"GPS Heading at the position.
" + }, + "Matching":{ + "shape":"IsolineMatchingOptions", + "documentation":"Options to configure matching the provided position to the road network.
" + }, + "SideOfStreet":{ + "shape":"IsolineSideOfStreetOptions", + "documentation":"Options to configure matching the provided position to a side of the street.
" + } + }, + "documentation":"Options for the property.
" + }, + "IsolineScooterOptions":{ + "type":"structure", + "members":{ + "EngineType":{ + "shape":"IsolineEngineType", + "documentation":"Engine type of the vehicle.
" + }, + "LicensePlate":{ + "shape":"IsolineVehicleLicensePlate", + "documentation":"The vehicle License Plate.
" + }, + "MaxSpeed":{ + "shape":"IsolineScooterOptionsMaxSpeedDouble", + "documentation":"Maximum speed specified.
Unit: KilometersPerHour
The number of occupants in the vehicle.
Default Value: 1
Options for the property.
" + }, + "IsolineScooterOptionsMaxSpeedDouble":{ + "type":"double", + "max":252.0, + "min":3.6 + }, + "IsolineScooterOptionsOccupancyInteger":{ + "type":"integer", + "box":true, + "min":1 + }, + "IsolineShapeGeometry":{ + "type":"structure", + "members":{ + "Polygon":{ + "shape":"LinearRings", + "documentation":"A list of Isoline Polygons, for each isoline polygon, it contains polygons of the first linear ring (the outer ring) and from 2nd item to the last item (the inner rings).
" + }, + "PolylinePolygon":{ + "shape":"PolylineRingList", + "documentation":"A list of Isoline PolylinePolygon, for each isoline PolylinePolygon, it contains PolylinePolygon of the first linear ring (the outer ring) and from 2nd item to the last item (the inner rings). For more information on polyline encoding, see https://github.com/heremaps/flexiblepolyline/blob/master/README.md.
" + } + }, + "documentation":"Geometry of the connection between different Isoline components.
" + }, + "IsolineShapeGeometryList":{ + "type":"list", + "member":{"shape":"IsolineShapeGeometry"} + }, + "IsolineSideOfStreetOptions":{ + "type":"structure", + "required":["Position"], + "members":{ + "Position":{ + "shape":"Position", + "documentation":"Position defined as [longitude, latitude].
Strategy that defines when the side of street position should be used. AnyStreet will always use the provided position.
Default Value: DividedStreetOnly
Options to configure matching the provided position to a side of the street.
" + }, + "IsolineThresholds":{ + "type":"structure", + "members":{ + "Distance":{ + "shape":"DistanceThresholdList", + "documentation":"Distance to be used for the isoline calculation.
" + }, + "Time":{ + "shape":"TimeThresholdList", + "documentation":"Time to be used for the isoline calculation.
" + } + }, + "documentation":"Threshold to be used for the isoline calculation. Up to 3 thresholds per provided type can be requested.
" + }, + "IsolineTrafficOptions":{ + "type":"structure", + "members":{ + "FlowEventThresholdOverride":{ + "shape":"DurationSeconds", + "documentation":"Duration for which flow traffic is considered valid. For this period, the flow traffic is used over historical traffic data. Flow traffic refers to congestion, which changes very quickly. Duration in seconds for which flow traffic event would be considered valid. While flow traffic event is valid it will be used over the historical traffic data.
Unit: seconds
Determines if traffic should be used or ignored while calculating the route.
Default Value: UseTrafficData
Options related to traffic.
" + }, + "IsolineTrailerOptions":{ + "type":"structure", + "members":{ + "AxleCount":{ + "shape":"IsolineTrailerOptionsAxleCountInteger", + "documentation":"Total number of axles of the vehicle.
" + }, + "TrailerCount":{ + "shape":"IsolineTrailerOptionsTrailerCountInteger", + "documentation":"Number of trailers attached to the vehicle.
Default Value: 0
Trailer options corresponding to the vehicle.
" + }, + "IsolineTrailerOptionsAxleCountInteger":{ + "type":"integer", + "box":true, + "min":1 + }, + "IsolineTrailerOptionsTrailerCountInteger":{ + "type":"integer", + "box":true, + "max":255, + "min":1 + }, + "IsolineTravelMode":{ + "type":"string", + "enum":[ + "Car", + "Pedestrian", + "Scooter", + "Truck" + ] + }, + "IsolineTravelModeOptions":{ + "type":"structure", + "members":{ + "Car":{ + "shape":"IsolineCarOptions", + "documentation":"Travel mode options when the provided travel mode is \"Car\"
" + }, + "Scooter":{ + "shape":"IsolineScooterOptions", + "documentation":"Travel mode options when the provided travel mode is \"Scooter\"
" + }, + "Truck":{ + "shape":"IsolineTruckOptions", + "documentation":"Travel mode options when the provided travel mode is \"Truck\"
" + } + }, + "documentation":"Travel mode related options for the provided travel mode.
" + }, + "IsolineTruckOptions":{ + "type":"structure", + "members":{ + "AxleCount":{ + "shape":"IsolineTruckOptionsAxleCountInteger", + "documentation":"Total number of axles of the vehicle.
" + }, + "EngineType":{ + "shape":"IsolineEngineType", + "documentation":"Engine type of the vehicle.
" + }, + "GrossWeight":{ + "shape":"WeightKilograms", + "documentation":"Gross weight of the vehicle including trailers, and goods at capacity.
Unit: Kilograms
List of Hazardous cargo contained in the vehicle.
" + }, + "Height":{ + "shape":"IsolineTruckOptionsHeightLong", + "documentation":"Height of the vehicle.
Unit: centimeters
Height of the vehicle above its first axle.
Unit: centimeters
Kingpin to rear axle length of the vehicle.
Unit: centimeters
Length of the vehicle.
Unit: centimeters
The vehicle License Plate.
" + }, + "MaxSpeed":{ + "shape":"IsolineTruckOptionsMaxSpeedDouble", + "documentation":"Maximum speed specified.
Unit: KilometersPerHour
The number of occupants in the vehicle.
Default Value: 1
Payload capacity of the vehicle and trailers attached.
Unit: kilograms
Number of tires on the vehicle.
" + }, + "Trailer":{ + "shape":"IsolineTrailerOptions", + "documentation":"Trailer options corresponding to the vehicle.
" + }, + "TruckType":{ + "shape":"IsolineTruckType", + "documentation":"Type of the truck.
" + }, + "TunnelRestrictionCode":{ + "shape":"TunnelRestrictionCode", + "documentation":"The tunnel restriction code.
Tunnel categories in this list indicate the restrictions which apply to certain tunnels in Great Britain. They relate to the types of dangerous goods that can be transported through them.
Tunnel Category B
Risk Level: Limited risk
Restrictions: Few restrictions
Tunnel Category C
Risk Level: Medium risk
Restrictions: Some restrictions
Tunnel Category D
Risk Level: High risk
Restrictions: Many restrictions occur
Tunnel Category E
Risk Level: Very high risk
Restrictions: Restricted tunnel
Heaviest weight per axle irrespective of the axle type or the axle group. Meant for usage in countries where the differences in axle types or axle groups are not distinguished.
Unit: Kilograms
Specifies the total weight for the specified axle group. Meant for usage in countries that have different regulations based on the axle group type.
Unit: Kilograms
Width of the vehicle.
Unit: centimeters
Travel mode options when the provided travel mode is \"Truck\"
" + }, + "IsolineTruckOptionsAxleCountInteger":{ + "type":"integer", + "box":true, + "max":255, + "min":2 + }, + "IsolineTruckOptionsHeightAboveFirstAxleLong":{ + "type":"long", + "max":5000, + "min":0 + }, + "IsolineTruckOptionsHeightLong":{ + "type":"long", + "max":5000, + "min":0 + }, + "IsolineTruckOptionsLengthLong":{ + "type":"long", + "max":30000, + "min":0 + }, + "IsolineTruckOptionsMaxSpeedDouble":{ + "type":"double", + "max":252.0, + "min":3.6 + }, + "IsolineTruckOptionsOccupancyInteger":{ + "type":"integer", + "box":true, + "min":1 + }, + "IsolineTruckOptionsTireCountInteger":{ + "type":"integer", + "box":true, + "max":255, + "min":1 + }, + "IsolineTruckOptionsWidthLong":{ + "type":"long", + "max":5000, + "min":0 + }, + "IsolineTruckType":{ + "type":"string", + "enum":[ + "LightTruck", + "StraightTruck", + "Tractor" + ] + }, + "IsolineVehicleLicensePlate":{ + "type":"structure", + "members":{ + "LastCharacter":{ + "shape":"IsolineVehicleLicensePlateLastCharacterString", + "documentation":"The last character of the License Plate.
" + } + }, + "documentation":"The vehicle license plate.
" + }, + "IsolineVehicleLicensePlateLastCharacterString":{ + "type":"string", + "max":1, + "min":1 + }, + "IsolineZoneCategory":{ + "type":"string", + "enum":[ + "CongestionPricing", + "Environmental", + "Vignette" + ] + }, + "LanguageTag":{ + "type":"string", + "max":35, + "min":2 + }, + "LineString":{ + "type":"list", + "member":{"shape":"Position"}, + "min":2 + }, + "LinearRing":{ + "type":"list", + "member":{"shape":"Position"}, + "min":4 + }, + "LinearRings":{ + "type":"list", + "member":{"shape":"LinearRing"}, + "min":1 + }, + "LocalizedString":{ + "type":"structure", + "required":["Value"], + "members":{ + "Language":{ + "shape":"LanguageTag", + "documentation":"A list of BCP 47 compliant language codes for the results to be rendered in. The request uses the regional default as the fallback if the requested language can't be provided.
" + }, + "Value":{ + "shape":"String", + "documentation":"The value of the localized string.
" + } + }, + "documentation":"The localized string.
" + }, + "LocalizedStringList":{ + "type":"list", + "member":{"shape":"LocalizedString"} + }, + "MatchingStrategy":{ + "type":"string", + "enum":[ + "MatchAny", + "MatchMostSignificantRoad" + ] + }, + "MeasurementSystem":{ + "type":"string", + "enum":[ + "Metric", + "Imperial" + ] + }, + "OptimizeWaypointsRequest":{ + "type":"structure", + "required":["Origin"], + "members":{ + "Avoid":{ + "shape":"WaypointOptimizationAvoidanceOptions", + "documentation":"Features that are avoided while calculating a route. Avoidance is on a best-case basis. If an avoidance can't be satisfied for a particular case, this setting is ignored.
" + }, + "DepartureTime":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"Departure time from the waypoint.
Time format:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Examples:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
The final position for the route in the World Geodetic System (WGS 84) format: [longitude, latitude].
Destination related options.
" + }, + "Driver":{ + "shape":"WaypointOptimizationDriverOptions", + "documentation":"Driver related options.
" + }, + "Exclude":{ + "shape":"WaypointOptimizationExclusionOptions", + "documentation":"Features to be strictly excluded while calculating the route.
" + }, + "Key":{ + "shape":"ApiKey", + "documentation":"Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + }, + "OptimizeSequencingFor":{ + "shape":"WaypointOptimizationSequencingObjective", + "documentation":"Specifies the optimization criteria for the calculated sequence.
Default Value: FastestRoute.
The start position for the route.
" + }, + "OriginOptions":{ + "shape":"WaypointOptimizationOriginOptions", + "documentation":"Origin related options.
" + }, + "Traffic":{ + "shape":"WaypointOptimizationTrafficOptions", + "documentation":"Traffic-related options.
" + }, + "TravelMode":{ + "shape":"WaypointOptimizationTravelMode", + "documentation":"Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.
Default Value: Car
Travel mode related options for the provided travel mode.
" + }, + "Waypoints":{ + "shape":"WaypointOptimizationWaypointList", + "documentation":"List of waypoints between the Origin and Destination.
Details about the connection from one waypoint to the next, within the optimized sequence.
" + }, + "Distance":{ + "shape":"DistanceMeters", + "documentation":"Overall distance to travel the whole sequence.
" + }, + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Overall duration to travel the whole sequence.
Unit: seconds
Returns waypoints that caused the optimization problem to fail, and the constraints that were unsatisfied leading to the failure.
" + }, + "OptimizedWaypoints":{ + "shape":"WaypointOptimizationOptimizedWaypointList", + "documentation":"Waypoints in the order of the optimized sequence.
" + }, + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the query is charged at.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + }, + "TimeBreakdown":{ + "shape":"WaypointOptimizationTimeBreakdown", + "documentation":"Time breakdown for the sequence.
" + } + } + }, + "Polyline":{ + "type":"string", + "min":1, + "sensitive":true + }, + "PolylineCorridor":{ + "type":"structure", + "required":[ + "Polyline", + "Radius" + ], + "members":{ + "Polyline":{ + "shape":"Polyline", + "documentation":"An ordered list of positions used to plot a route on a map in a lossy compression format.
LineString and Polyline are mutually exclusive properties.
Considers all roads within the provided radius to match the provided destination to. The roads that are considered are determined by the provided Strategy.
Unit: Meters
Geometry defined as an encoded corridor - an encoded polyline with a radius that defines the width of the corridor.
", + "sensitive":true + }, + "PolylineRing":{ + "type":"string", + "min":1, + "sensitive":true + }, + "PolylineRingList":{ + "type":"list", + "member":{"shape":"PolylineRing"}, + "min":1 + }, + "Position":{ + "type":"list", + "member":{"shape":"Double"}, + "max":2, + "min":2, + "sensitive":true + }, + "Position23":{ + "type":"list", + "member":{"shape":"Double"}, + "max":3, + "min":2, + "sensitive":true + }, + "RoadSnapHazardousCargoType":{ + "type":"string", + "enum":[ + "Combustible", + "Corrosive", + "Explosive", + "Flammable", + "Gas", + "HarmfulToWater", + "Organic", + "Other", + "Poison", + "PoisonousInhalation", + "Radioactive" + ] + }, + "RoadSnapHazardousCargoTypeList":{ + "type":"list", + "member":{"shape":"RoadSnapHazardousCargoType"}, + "max":11, + "min":0 + }, + "RoadSnapNotice":{ + "type":"structure", + "required":[ + "Code", + "Title", + "TracePointIndexes" + ], + "members":{ + "Code":{ + "shape":"RoadSnapNoticeCode", + "documentation":"Code corresponding to the issue.
" + }, + "Title":{ + "shape":"String", + "documentation":"The notice title.
" + }, + "TracePointIndexes":{ + "shape":"RoadSnapTracePointIndexList", + "documentation":"TracePoint indices for which the provided notice code corresponds to.
" + } + }, + "documentation":"Notices provide information around factors that may have influenced snapping in a manner atypical to the standard use cases.
" + }, + "RoadSnapNoticeCode":{ + "type":"string", + "enum":[ + "TracePointsHeadingIgnored", + "TracePointsIgnored", + "TracePointsMovedByLargeDistance", + "TracePointsNotMatched", + "TracePointsOutOfSequence", + "TracePointsSpeedEstimated", + "TracePointsSpeedIgnored" + ] + }, + "RoadSnapNoticeList":{ + "type":"list", + "member":{"shape":"RoadSnapNotice"} + }, + "RoadSnapSnappedGeometry":{ + "type":"structure", + "members":{ + "LineString":{ + "shape":"LineString", + "documentation":"An ordered list of positions used to plot a route on a map.
LineString and Polyline are mutually exclusive properties.
An ordered list of positions used to plot a route on a map in a lossy compression format.
LineString and Polyline are mutually exclusive properties.
Interpolated geometry for the snapped route that is overlay-able onto a map.
" + }, + "RoadSnapSnappedTracePoint":{ + "type":"structure", + "required":[ + "Confidence", + "OriginalPosition", + "SnappedPosition" + ], + "members":{ + "Confidence":{ + "shape":"RoadSnapSnappedTracePointConfidenceDouble", + "documentation":"Confidence value for the correctness of this point match.
" + }, + "OriginalPosition":{ + "shape":"Position", + "documentation":"Position of the TracePoint provided within the request, at the same index.
" + }, + "SnappedPosition":{ + "shape":"Position", + "documentation":"Snapped position of the TracePoint provided within the request, at the same index.
" + } + }, + "documentation":"TracePoints snapped onto the road network.
" + }, + "RoadSnapSnappedTracePointConfidenceDouble":{ + "type":"double", + "box":true, + "max":1, + "min":0 + }, + "RoadSnapSnappedTracePointList":{ + "type":"list", + "member":{"shape":"RoadSnapSnappedTracePoint"} + }, + "RoadSnapTracePoint":{ + "type":"structure", + "required":["Position"], + "members":{ + "Heading":{ + "shape":"Heading", + "documentation":"GPS Heading at the position.
" + }, + "Position":{ + "shape":"Position", + "documentation":"Position defined as [longitude, latitude].
Speed at the specified trace point .
Unit: KilometersPerHour
Timestamp of the event.
" + } + }, + "documentation":"TracePoint indices for which the provided notice code corresponds to.
" + }, + "RoadSnapTracePointIndexList":{ + "type":"list", + "member":{"shape":"Integer"}, + "max":1000, + "min":1 + }, + "RoadSnapTrailerOptions":{ + "type":"structure", + "members":{ + "TrailerCount":{ + "shape":"RoadSnapTrailerOptionsTrailerCountInteger", + "documentation":"Number of trailers attached to the vehicle.
Default Value: 0
Trailer options corresponding to the vehicle.
" + }, + "RoadSnapTrailerOptionsTrailerCountInteger":{ + "type":"integer", + "box":true, + "max":255, + "min":0 + }, + "RoadSnapTravelMode":{ + "type":"string", + "enum":[ + "Car", + "Pedestrian", + "Scooter", + "Truck" + ] + }, + "RoadSnapTravelModeOptions":{ + "type":"structure", + "members":{ + "Truck":{ + "shape":"RoadSnapTruckOptions", + "documentation":"Travel mode options when the provided travel mode is \"Truck\".
" + } + }, + "documentation":"Travel mode related options for the provided travel mode.
" + }, + "RoadSnapTruckOptions":{ + "type":"structure", + "members":{ + "GrossWeight":{ + "shape":"WeightKilograms", + "documentation":"Gross weight of the vehicle including trailers, and goods at capacity.
Unit: Kilograms
List of Hazardous cargos contained in the vehicle.
" + }, + "Height":{ + "shape":"RoadSnapTruckOptionsHeightLong", + "documentation":"Height of the vehicle.
Unit: centimeters
Length of the vehicle.
Unit: centimeters
Trailer options corresponding to the vehicle.
" + }, + "TunnelRestrictionCode":{ + "shape":"TunnelRestrictionCode", + "documentation":"The tunnel restriction code.
Tunnel categories in this list indicate the restrictions which apply to certain tunnels in Great Britain. They relate to the types of dangerous goods that can be transported through them.
Tunnel Category B
Risk Level: Limited risk
Restrictions: Few restrictions
Tunnel Category C
Risk Level: Medium risk
Restrictions: Some restrictions
Tunnel Category D
Risk Level: High risk
Restrictions: Many restrictions occur
Tunnel Category E
Risk Level: Very high risk
Restrictions: Restricted tunnel
Width of the vehicle in centimenters.
" + } + }, + "documentation":"Travel mode options when the provided travel mode is \"Truck\".
" + }, + "RoadSnapTruckOptionsHeightLong":{ + "type":"long", + "max":5000, + "min":0 + }, + "RoadSnapTruckOptionsLengthLong":{ + "type":"long", + "max":30000, + "min":0 + }, + "RoadSnapTruckOptionsWidthLong":{ + "type":"long", + "max":5000, + "min":0 + }, + "RoundaboutAngle":{ + "type":"double", + "max":360, + "min":-360 + }, + "Route":{ + "type":"structure", + "required":[ + "Legs", + "MajorRoadLabels" + ], + "members":{ + "Legs":{ + "shape":"RouteLegList", + "documentation":"A leg is a section of a route from one waypoint to the next. A leg could be of type Vehicle, Pedestrian or Ferry. Legs of different types could occur together within a single route. For example, a car employing the use of a Ferry will contain Vehicle legs corresponding to journey on land, and Ferry legs corresponding to the journey via Ferry.
" + }, + "MajorRoadLabels":{ + "shape":"RouteMajorRoadLabelsList", + "documentation":"Important labels including names and route numbers that differentiate the current route from the alternatives presented.
" + }, + "Summary":{ + "shape":"RouteSummary", + "documentation":"Summarized details of the leg.
" + } + }, + "documentation":"The route.
" + }, + "RouteAllowOptions":{ + "type":"structure", + "members":{ + "Hot":{ + "shape":"Boolean", + "documentation":"Allow Hot (High Occupancy Toll) lanes while calculating the route.
" + }, + "Hov":{ + "shape":"Boolean", + "documentation":"Allow Hov (High Occupancy vehicle) lanes while calculating the route.
" + } + }, + "documentation":"Features that are allowed while calculating. a route
" + }, + "RouteAvoidanceArea":{ + "type":"structure", + "required":["Geometry"], + "members":{ + "Except":{ + "shape":"RouteAvoidanceAreaGeometryList", + "documentation":"Exceptions to the provided avoidance geometry, to be included while calculating the route.
" + }, + "Geometry":{"shape":"RouteAvoidanceAreaGeometry"} + }, + "documentation":"Areas to be avoided.
" + }, + "RouteAvoidanceAreaGeometry":{ + "type":"structure", + "members":{ + "Corridor":{ + "shape":"Corridor", + "documentation":"Geometry defined as a corridor - a LineString with a radius that defines the width of the corridor.
" + }, + "BoundingBox":{ + "shape":"BoundingBox", + "documentation":"Geometry defined as a bounding box. The first pair represents the X and Y coordinates (longitude and latitude,) of the southwest corner of the bounding box; the second pair represents the X and Y coordinates (longitude and latitude) of the northeast corner.
" + }, + "Polygon":{ + "shape":"RouteAvoidanceAreaGeometryPolygonList", + "documentation":"Geometry defined as a polygon with only one linear ring.
" + }, + "PolylineCorridor":{ + "shape":"PolylineCorridor", + "documentation":"Geometry defined as an encoded corridor - an encoded polyline with a radius that defines the width of the corridor.
" + }, + "PolylinePolygon":{ + "shape":"RouteAvoidanceAreaGeometryPolylinePolygonList", + "documentation":"A list of Isoline PolylinePolygon, for each isoline PolylinePolygon, it contains PolylinePolygon of the first linear ring (the outer ring) and from 2nd item to the last item (the inner rings). For more information on polyline encoding, see https://github.com/heremaps/flexiblepolyline/blob/master/README.md.
" + } + }, + "documentation":"Geometry of the area to be avoided.
" + }, + "RouteAvoidanceAreaGeometryList":{ + "type":"list", + "member":{"shape":"RouteAvoidanceAreaGeometry"} + }, + "RouteAvoidanceAreaGeometryPolygonList":{ + "type":"list", + "member":{"shape":"LinearRing"}, + "max":1, + "min":1 + }, + "RouteAvoidanceAreaGeometryPolylinePolygonList":{ + "type":"list", + "member":{"shape":"PolylineRing"}, + "max":1, + "min":1 + }, + "RouteAvoidanceAreaList":{ + "type":"list", + "member":{"shape":"RouteAvoidanceArea"} + }, + "RouteAvoidanceOptions":{ + "type":"structure", + "members":{ + "Areas":{ + "shape":"RouteAvoidanceAreaList", + "documentation":"Areas to be avoided.
" + }, + "CarShuttleTrains":{ + "shape":"Boolean", + "documentation":"Avoid car-shuttle-trains while calculating the route.
" + }, + "ControlledAccessHighways":{ + "shape":"Boolean", + "documentation":"Avoid controlled access highways while calculating the route.
" + }, + "DirtRoads":{ + "shape":"Boolean", + "documentation":"Avoid dirt roads while calculating the route.
" + }, + "Ferries":{ + "shape":"Boolean", + "documentation":"Avoid ferries while calculating the route.
" + }, + "SeasonalClosure":{ + "shape":"Boolean", + "documentation":"Avoid roads that have seasonal closure while calculating the route.
" + }, + "TollRoads":{ + "shape":"Boolean", + "documentation":"Avoids roads where the specified toll transponders are the only mode of payment.
" + }, + "TollTransponders":{ + "shape":"Boolean", + "documentation":"Avoids roads where the specified toll transponders are the only mode of payment.
" + }, + "TruckRoadTypes":{ + "shape":"TruckRoadTypeList", + "documentation":"Truck road type identifiers. BK1 through BK4 apply only to Sweden. A2,A4,B2,B4,C,D,ET2,ET4 apply only to Mexico.
There are currently no other supported values as of 26th April 2024.
Avoid tunnels while calculating the route.
" + }, + "UTurns":{ + "shape":"Boolean", + "documentation":"Avoid U-turns for calculation on highways and motorways.
" + }, + "ZoneCategories":{ + "shape":"RouteAvoidanceZoneCategoryList", + "documentation":"Zone categories to be avoided.
" + } + }, + "documentation":"Options related to areas to be avoided.
" + }, + "RouteAvoidanceZoneCategory":{ + "type":"structure", + "required":["Category"], + "members":{ + "Category":{ + "shape":"RouteZoneCategory", + "documentation":"Zone category to be avoided.
" + } + }, + "documentation":"Zone categories to be avoided.
" + }, + "RouteAvoidanceZoneCategoryList":{ + "type":"list", + "member":{"shape":"RouteAvoidanceZoneCategory"}, + "max":3, + "min":0 + }, + "RouteCarOptions":{ + "type":"structure", + "members":{ + "EngineType":{ + "shape":"RouteEngineType", + "documentation":"Engine type of the vehicle.
" + }, + "LicensePlate":{ + "shape":"RouteVehicleLicensePlate", + "documentation":"The vehicle License Plate.
" + }, + "MaxSpeed":{ + "shape":"RouteCarOptionsMaxSpeedDouble", + "documentation":"Maximum speed specified.
Unit: KilometersPerHour
The number of occupants in the vehicle.
Default Value: 1
Travel mode options when the provided travel mode is \"Car\"
" + }, + "RouteCarOptionsMaxSpeedDouble":{ + "type":"double", + "max":252.0, + "min":3.6 + }, + "RouteCarOptionsOccupancyInteger":{ + "type":"integer", + "box":true, + "min":1 + }, + "RouteContinueHighwayStepDetails":{ + "type":"structure", + "required":["Intersection"], + "members":{ + "Intersection":{ + "shape":"LocalizedStringList", + "documentation":"Name of the intersection, if applicable to the step.
" + }, + "SteeringDirection":{ + "shape":"RouteSteeringDirection", + "documentation":"Steering direction for the step.
" + }, + "TurnAngle":{ + "shape":"TurnAngle", + "documentation":"Angle of the turn.
" + }, + "TurnIntensity":{ + "shape":"RouteTurnIntensity", + "documentation":"Intensity of the turn.
" + } + }, + "documentation":"Details related to the continue highway step.
" + }, + "RouteContinueStepDetails":{ + "type":"structure", + "required":["Intersection"], + "members":{ + "Intersection":{ + "shape":"LocalizedStringList", + "documentation":"Name of the intersection, if applicable to the step.
" + } + }, + "documentation":"Details related to the continue step.
" + }, + "RouteDestinationOptions":{ + "type":"structure", + "members":{ + "AvoidActionsForDistance":{ + "shape":"RouteDestinationOptionsAvoidActionsForDistanceLong", + "documentation":"Avoids actions for the provided distance. This is typically to consider for users in moving vehicles who may not have sufficient time to make an action at an origin or a destination.
" + }, + "AvoidUTurns":{ + "shape":"Boolean", + "documentation":"Avoid U-turns for calculation on highways and motorways.
" + }, + "Heading":{ + "shape":"Heading", + "documentation":"GPS Heading at the position.
" + }, + "Matching":{ + "shape":"RouteMatchingOptions", + "documentation":"Options to configure matching the provided position to the road network.
" + }, + "SideOfStreet":{ + "shape":"RouteSideOfStreetOptions", + "documentation":"Options to configure matching the provided position to a side of the street.
" + }, + "StopDuration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the stop.
Unit: seconds
Options related to the destination.
" + }, + "RouteDestinationOptionsAvoidActionsForDistanceLong":{ + "type":"long", + "max":2000 + }, + "RouteDirection":{ + "type":"string", + "enum":[ + "East", + "North", + "South", + "West" + ] + }, + "RouteDriverOptions":{ + "type":"structure", + "members":{ + "Schedule":{ + "shape":"RouteDriverScheduleIntervalList", + "documentation":"Driver work-rest schedule. Stops are added to fulfil the provided rest schedule.
" + } + }, + "documentation":"Driver related options.
" + }, + "RouteDriverScheduleInterval":{ + "type":"structure", + "required":[ + "DriveDuration", + "RestDuration" + ], + "members":{ + "DriveDuration":{ + "shape":"DurationSeconds", + "documentation":"Maximum allowed driving time before stopping to rest.
Unit: seconds
Resting time before the driver can continue driving.
Unit: seconds
Interval of the driver work-rest schedule. Stops are added to fulfil the provided rest schedule.
" + }, + "RouteDriverScheduleIntervalList":{ + "type":"list", + "member":{"shape":"RouteDriverScheduleInterval"} + }, + "RouteEmissionType":{ + "type":"structure", + "required":["Type"], + "members":{ + "Co2EmissionClass":{ + "shape":"String", + "documentation":"The CO 2 emission classes.
" + }, + "Type":{ + "shape":"String", + "documentation":"Type of the emission.
Valid values: Euro1, Euro2, Euro3, Euro4, Euro5, Euro6, EuroEev
Type of the emission.
Valid values: Euro1, Euro2, Euro3, Euro4, Euro5, Euro6, EuroEev
Name of the intersection, if applicable to the step.
" + }, + "SteeringDirection":{ + "shape":"RouteSteeringDirection", + "documentation":"Steering direction for the step.
" + }, + "TurnAngle":{ + "shape":"TurnAngle", + "documentation":"Angle of the turn.
" + }, + "TurnIntensity":{ + "shape":"RouteTurnIntensity", + "documentation":"Intensity of the turn.
" + } + }, + "documentation":"Details related to the enter highway step.
" + }, + "RouteExclusionOptions":{ + "type":"structure", + "required":["Countries"], + "members":{ + "Countries":{ + "shape":"CountryCodeList", + "documentation":"List of countries to be avoided defined by two-letter or three-letter country codes.
" + } + }, + "documentation":"Exclusion options for the route.
" + }, + "RouteExitStepDetails":{ + "type":"structure", + "required":["Intersection"], + "members":{ + "Intersection":{ + "shape":"LocalizedStringList", + "documentation":"Name of the intersection, if applicable to the step.
" + }, + "RelativeExit":{ + "shape":"RouteExitStepDetailsRelativeExitInteger", + "documentation":"Exit to be taken.
" + }, + "SteeringDirection":{ + "shape":"RouteSteeringDirection", + "documentation":"Steering direction for the step.
" + }, + "TurnAngle":{ + "shape":"TurnAngle", + "documentation":"Angle of the turn.
" + }, + "TurnIntensity":{ + "shape":"RouteTurnIntensity", + "documentation":"Intensity of the turn.
" + } + }, + "documentation":"Details related to the exit step.
" + }, + "RouteExitStepDetailsRelativeExitInteger":{ + "type":"integer", + "box":true, + "max":12, + "min":1 + }, + "RouteFerryAfterTravelStep":{ + "type":"structure", + "required":[ + "Duration", + "Type" + ], + "members":{ + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the step.
Unit: seconds
Brief description of the step in the requested language.
Only available when the TravelStepType is Default.
Type of the step.
" + } + }, + "documentation":"Steps of a leg that must be performed after the travel portion of the leg.
" + }, + "RouteFerryAfterTravelStepList":{ + "type":"list", + "member":{"shape":"RouteFerryAfterTravelStep"} + }, + "RouteFerryAfterTravelStepType":{ + "type":"string", + "enum":["Deboard"] + }, + "RouteFerryArrival":{ + "type":"structure", + "required":["Place"], + "members":{ + "Place":{ + "shape":"RouteFerryPlace", + "documentation":"The place details.
" + }, + "Time":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"The time.
" + } + }, + "documentation":"Details corresponding to the arrival for the leg.
" + }, + "RouteFerryBeforeTravelStep":{ + "type":"structure", + "required":[ + "Duration", + "Type" + ], + "members":{ + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the step.
Unit: seconds
Brief description of the step in the requested language.
Only available when the TravelStepType is Default.
Type of the step.
" + } + }, + "documentation":"Steps of a leg that must be performed before the travel portion of the leg.
" + }, + "RouteFerryBeforeTravelStepList":{ + "type":"list", + "member":{"shape":"RouteFerryBeforeTravelStep"} + }, + "RouteFerryBeforeTravelStepType":{ + "type":"string", + "enum":["Board"] + }, + "RouteFerryDeparture":{ + "type":"structure", + "required":["Place"], + "members":{ + "Place":{ + "shape":"RouteFerryPlace", + "documentation":"The place details.
" + }, + "Time":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"The time.
" + } + }, + "documentation":"Details corresponding to the departure for the leg.
" + }, + "RouteFerryLegDetails":{ + "type":"structure", + "required":[ + "AfterTravelSteps", + "Arrival", + "BeforeTravelSteps", + "Departure", + "Notices", + "PassThroughWaypoints", + "Spans", + "TravelSteps" + ], + "members":{ + "AfterTravelSteps":{ + "shape":"RouteFerryAfterTravelStepList", + "documentation":"Steps of a leg that must be performed after the travel portion of the leg.
" + }, + "Arrival":{ + "shape":"RouteFerryArrival", + "documentation":"Details corresponding to the arrival for the leg.
" + }, + "BeforeTravelSteps":{ + "shape":"RouteFerryBeforeTravelStepList", + "documentation":"Steps of a leg that must be performed before the travel portion of the leg.
" + }, + "Departure":{ + "shape":"RouteFerryDeparture", + "documentation":"Details corresponding to the departure for the leg.
" + }, + "Notices":{ + "shape":"RouteFerryNoticeList", + "documentation":"Notices are additional information returned that indicate issues that occurred during route calculation.
" + }, + "PassThroughWaypoints":{ + "shape":"RoutePassThroughWaypointList", + "documentation":"Waypoints that were passed through during the leg. This includes the waypoints that were configured with the PassThrough option.
" + }, + "RouteName":{ + "shape":"String", + "documentation":"Route name of the ferry line.
" + }, + "Spans":{ + "shape":"RouteFerrySpanList", + "documentation":"Spans that were computed for the requested SpanAdditionalFeatures.
" + }, + "Summary":{ + "shape":"RouteFerrySummary", + "documentation":"Summarized details of the leg.
" + }, + "TravelSteps":{ + "shape":"RouteFerryTravelStepList", + "documentation":"Steps of a leg that must be performed before the travel portion of the leg.
" + } + }, + "documentation":"FerryLegDetails is populated when the Leg type is Ferry, and provides additional information that is specific
" + }, + "RouteFerryNotice":{ + "type":"structure", + "required":["Code"], + "members":{ + "Code":{ + "shape":"RouteFerryNoticeCode", + "documentation":"Code corresponding to the issue.
" + }, + "Impact":{ + "shape":"RouteNoticeImpact", + "documentation":"Impact corresponding to the issue. While Low impact notices can be safely ignored, High impact notices must be evaluated further to determine the impact.
" + } + }, + "documentation":"Notices are additional information returned that indicate issues that occurred during route calculation.
" + }, + "RouteFerryNoticeCode":{ + "type":"string", + "enum":[ + "AccuratePolylineUnavailable", + "NoSchedule", + "Other", + "ViolatedAvoidFerry", + "ViolatedAvoidRailFerry" + ] + }, + "RouteFerryNoticeList":{ + "type":"list", + "member":{"shape":"RouteFerryNotice"} + }, + "RouteFerryOverviewSummary":{ + "type":"structure", + "required":[ + "Distance", + "Duration" + ], + "members":{ + "Distance":{ + "shape":"DistanceMeters", + "documentation":"Distance of the step.
" + }, + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the step.
Unit: seconds
Summarized details of the leg.
" + }, + "RouteFerryPlace":{ + "type":"structure", + "required":["Position"], + "members":{ + "Name":{ + "shape":"String", + "documentation":"The name of the place.
" + }, + "OriginalPosition":{ + "shape":"Position23", + "documentation":"Position provided in the request.
" + }, + "Position":{ + "shape":"Position23", + "documentation":"Position defined as [longitude, latitude].
Index of the waypoint in the request.
" + } + }, + "documentation":"Position provided in the request.
" + }, + "RouteFerryPlaceWaypointIndexInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RouteFerrySpan":{ + "type":"structure", + "members":{ + "Country":{ + "shape":"CountryCode3", + "documentation":"3 letter Country code corresponding to the Span.
" + }, + "Distance":{ + "shape":"DistanceMeters", + "documentation":"Distance of the computed span. This feature doesn't split a span, but is always computed on a span split by other properties.
" + }, + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the computed span. This feature doesn't split a span, but is always computed on a span split by other properties.
Unit: seconds
Offset in the leg geometry corresponding to the start of this span.
" + }, + "Names":{ + "shape":"LocalizedStringList", + "documentation":"Provides an array of names of the ferry span in available languages.
" + }, + "Region":{ + "shape":"RouteFerrySpanRegionString", + "documentation":"2-3 letter Region code corresponding to the Span. This is either a province or a state.
" + } + }, + "documentation":"Span computed for the requested SpanAdditionalFeatures.
" + }, + "RouteFerrySpanGeometryOffsetInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RouteFerrySpanList":{ + "type":"list", + "member":{"shape":"RouteFerrySpan"} + }, + "RouteFerrySpanRegionString":{ + "type":"string", + "max":3, + "min":0 + }, + "RouteFerrySummary":{ + "type":"structure", + "members":{ + "Overview":{ + "shape":"RouteFerryOverviewSummary", + "documentation":"Summarized details for the leg including before travel, travel and after travel steps.
" + }, + "TravelOnly":{ + "shape":"RouteFerryTravelOnlySummary", + "documentation":"Summarized details for the leg including travel steps only. The Distance for the travel only portion of the journey is in meters
" + } + }, + "documentation":"Summarized details for the leg including travel steps only. The Distance for the travel only portion of the journey is the same as the Distance within the Overview summary.
" + }, + "RouteFerryTravelOnlySummary":{ + "type":"structure", + "required":["Duration"], + "members":{ + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Total duration in free flowing traffic, which is the best case or shortest duration possible to cover the leg.
Unit: seconds
Summarized details for the leg including travel steps only. The Distance for the travel only portion of the journey is the same as the Distance within the Overview summary.
" + }, + "RouteFerryTravelStep":{ + "type":"structure", + "required":[ + "Duration", + "Type" + ], + "members":{ + "Distance":{ + "shape":"DistanceMeters", + "documentation":"Distance of the step.
" + }, + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the step.
Unit: seconds
Offset in the leg geometry corresponding to the start of this step.
" + }, + "Instruction":{ + "shape":"String", + "documentation":"Brief description of the step in the requested language.
Only available when the TravelStepType is Default.
Type of the step.
" + } + }, + "documentation":"Steps of a leg that must be performed during the travel portion of the leg.
" + }, + "RouteFerryTravelStepGeometryOffsetInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RouteFerryTravelStepList":{ + "type":"list", + "member":{"shape":"RouteFerryTravelStep"} + }, + "RouteFerryTravelStepType":{ + "type":"string", + "enum":[ + "Depart", + "Continue", + "Arrive" + ] + }, + "RouteHazardousCargoType":{ + "type":"string", + "enum":[ + "Combustible", + "Corrosive", + "Explosive", + "Flammable", + "Gas", + "HarmfulToWater", + "Organic", + "Other", + "Poison", + "PoisonousInhalation", + "Radioactive" + ] + }, + "RouteHazardousCargoTypeList":{ + "type":"list", + "member":{"shape":"RouteHazardousCargoType"}, + "max":11, + "min":0 + }, + "RouteKeepStepDetails":{ + "type":"structure", + "required":["Intersection"], + "members":{ + "Intersection":{ + "shape":"LocalizedStringList", + "documentation":"Name of the intersection, if applicable to the step.
" + }, + "SteeringDirection":{ + "shape":"RouteSteeringDirection", + "documentation":"Steering direction for the step.
" + }, + "TurnAngle":{ + "shape":"TurnAngle", + "documentation":"Angle of the turn.
" + }, + "TurnIntensity":{ + "shape":"RouteTurnIntensity", + "documentation":"Intensity of the turn.
" + } + }, + "documentation":"Details that are specific to a Keep step.
" + }, + "RouteLeg":{ + "type":"structure", + "required":[ + "Geometry", + "TravelMode", + "Type" + ], + "members":{ + "FerryLegDetails":{ + "shape":"RouteFerryLegDetails", + "documentation":"FerryLegDetails is populated when the Leg type is Ferry, and provides additional information that is specific
" + }, + "Geometry":{ + "shape":"RouteLegGeometry", + "documentation":"Geometry of the area to be avoided.
" + }, + "Language":{ + "shape":"LanguageTag", + "documentation":"List of languages for instructions within steps in the response.
" + }, + "PedestrianLegDetails":{ + "shape":"RoutePedestrianLegDetails", + "documentation":"Details related to the pedestrian leg.
" + }, + "TravelMode":{ + "shape":"RouteLegTravelMode", + "documentation":"Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.
Default Value: Car
Type of the leg.
" + }, + "VehicleLegDetails":{ + "shape":"RouteVehicleLegDetails", + "documentation":"Details related to the vehicle leg.
" + } + }, + "documentation":"A leg is a section of a route from one waypoint to the next. A leg could be of type Vehicle, Pedestrian or Ferry. Legs of different types could occur together within a single route. For example, a car employing the use of a Ferry will contain Vehicle legs corresponding to journey on land, and Ferry legs corresponding to the journey via Ferry.
" + }, + "RouteLegAdditionalFeature":{ + "type":"string", + "enum":[ + "Elevation", + "Incidents", + "PassThroughWaypoints", + "Summary", + "Tolls", + "TravelStepInstructions", + "TruckRoadTypes", + "TypicalDuration", + "Zones" + ] + }, + "RouteLegAdditionalFeatureList":{ + "type":"list", + "member":{"shape":"RouteLegAdditionalFeature"}, + "max":9, + "min":0 + }, + "RouteLegGeometry":{ + "type":"structure", + "members":{ + "LineString":{ + "shape":"LineString", + "documentation":"An ordered list of positions used to plot a route on a map.
LineString and Polyline are mutually exclusive properties.
An ordered list of positions used to plot a route on a map in a lossy compression format.
LineString and Polyline are mutually exclusive properties.
The returned Route leg geometry.
" + }, + "RouteLegList":{ + "type":"list", + "member":{"shape":"RouteLeg"} + }, + "RouteLegTravelMode":{ + "type":"string", + "enum":[ + "Car", + "Ferry", + "Pedestrian", + "Scooter", + "Truck" + ] + }, + "RouteLegType":{ + "type":"string", + "enum":[ + "Ferry", + "Pedestrian", + "Vehicle" + ] + }, + "RouteList":{ + "type":"list", + "member":{"shape":"Route"} + }, + "RouteMajorRoadLabel":{ + "type":"structure", + "members":{ + "RoadName":{ + "shape":"LocalizedString", + "documentation":"Name of the road (localized).
" + }, + "RouteNumber":{ + "shape":"RouteNumber", + "documentation":"Route number of the road.
" + } + }, + "documentation":"Important labels including names and route numbers that differentiate the current route from the alternatives presented.
" + }, + "RouteMajorRoadLabelsList":{ + "type":"list", + "member":{"shape":"RouteMajorRoadLabel"}, + "max":2, + "min":0 + }, + "RouteMatchingOptions":{ + "type":"structure", + "members":{ + "NameHint":{ + "shape":"RouteMatchingOptionsNameHintString", + "documentation":"Attempts to match the provided position to a road similar to the provided name.
" + }, + "OnRoadThreshold":{ + "shape":"DistanceMeters", + "documentation":"If the distance to a highway/bridge/tunnel/sliproad is within threshold, the waypoint will be snapped to the highway/bridge/tunnel/sliproad.
Unit: meters
Considers all roads within the provided radius to match the provided destination to. The roads that are considered are determined by the provided Strategy.
Unit: Meters
Strategy that defines matching of the position onto the road network. MatchAny considers all roads possible, whereas MatchMostSignificantRoad matches to the most significant road.
" + } + }, + "documentation":"Options related to route matching.
" + }, + "RouteMatchingOptionsNameHintString":{ + "type":"string", + "max":100, + "min":0, + "sensitive":true + }, + "RouteMatrix":{ + "type":"list", + "member":{"shape":"RouteMatrixRow"} + }, + "RouteMatrixAllowOptions":{ + "type":"structure", + "members":{ + "Hot":{ + "shape":"Boolean", + "documentation":"Allow Hot (High Occupancy Toll) lanes while calculating the route.
" + }, + "Hov":{ + "shape":"Boolean", + "documentation":"Allow Hov (High Occupancy vehicle) lanes while calculating the route.
" + } + }, + "documentation":"Allow Options related to the route matrix.
" + }, + "RouteMatrixAutoCircle":{ + "type":"structure", + "members":{ + "Margin":{ + "shape":"RouteMatrixAutoCircleMarginLong", + "documentation":"The margin provided for the calculation.
" + }, + "MaxRadius":{ + "shape":"RouteMatrixAutoCircleMaxRadiusLong", + "documentation":"The maximum size of the radius provided for the calculation.
" + } + }, + "documentation":"Provides the circle that was used while calculating the route.
" + }, + "RouteMatrixAutoCircleMarginLong":{ + "type":"long", + "max":200000, + "min":0 + }, + "RouteMatrixAutoCircleMaxRadiusLong":{ + "type":"long", + "max":200000, + "min":0 + }, + "RouteMatrixAvoidanceArea":{ + "type":"structure", + "required":["Geometry"], + "members":{ + "Geometry":{ + "shape":"RouteMatrixAvoidanceAreaGeometry", + "documentation":"Geometry of the area to be avoided.
" + } + }, + "documentation":"Area to be avoided.
" + }, + "RouteMatrixAvoidanceAreaGeometry":{ + "type":"structure", + "members":{ + "BoundingBox":{ + "shape":"BoundingBox", + "documentation":"Geometry defined as a bounding box. The first pair represents the X and Y coordinates (longitude and latitude,) of the southwest corner of the bounding box; the second pair represents the X and Y coordinates (longitude and latitude) of the northeast corner.
" + }, + "Polygon":{ + "shape":"RouteMatrixAvoidanceAreaGeometryPolygonList", + "documentation":"Geometry defined as a polygon with only one linear ring.
" + }, + "PolylinePolygon":{ + "shape":"RouteMatrixAvoidanceAreaGeometryPolylinePolygonList", + "documentation":"A list of Isoline PolylinePolygon, for each isoline PolylinePolygon, it contains PolylinePolygon of the first linear ring (the outer ring) and from second item to the last item (the inner rings). For more information on polyline encoding, see https://github.com/heremaps/flexiblepolyline/blob/master/README.md.
" + } + }, + "documentation":"Geometry of the area to be avoided.
" + }, + "RouteMatrixAvoidanceAreaGeometryPolygonList":{ + "type":"list", + "member":{"shape":"LinearRing"}, + "max":1, + "min":1 + }, + "RouteMatrixAvoidanceAreaGeometryPolylinePolygonList":{ + "type":"list", + "member":{"shape":"PolylineRing"}, + "max":1, + "min":1 + }, + "RouteMatrixAvoidanceOptions":{ + "type":"structure", + "members":{ + "Areas":{ + "shape":"RouteMatrixAvoidanceOptionsAreasList", + "documentation":"Areas to be avoided.
" + }, + "CarShuttleTrains":{ + "shape":"Boolean", + "documentation":"Avoid car-shuttle-trains while calculating the route.
" + }, + "ControlledAccessHighways":{ + "shape":"Boolean", + "documentation":"Avoid controlled access highways while calculating the route.
" + }, + "DirtRoads":{ + "shape":"Boolean", + "documentation":"Avoid dirt roads while calculating the route.
" + }, + "Ferries":{ + "shape":"Boolean", + "documentation":"Avoid ferries while calculating the route.
" + }, + "TollRoads":{ + "shape":"Boolean", + "documentation":"Avoids roads where the specified toll transponders are the only mode of payment.
" + }, + "TollTransponders":{ + "shape":"Boolean", + "documentation":"Avoids roads where the specified toll transponders are the only mode of payment.
" + }, + "TruckRoadTypes":{ + "shape":"TruckRoadTypeList", + "documentation":"Truck road type identifiers. BK1 through BK4 apply only to Sweden. A2,A4,B2,B4,C,D,ET2,ET4 apply only to Mexico.
There are currently no other supported values as of 26th April 2024.
Avoid tunnels while calculating the route.
" + }, + "UTurns":{ + "shape":"Boolean", + "documentation":"Avoid U-turns for calculation on highways and motorways.
" + }, + "ZoneCategories":{ + "shape":"RouteMatrixAvoidanceZoneCategoryList", + "documentation":"Zone categories to be avoided.
" + } + }, + "documentation":"Options related to the route matrix.
" + }, + "RouteMatrixAvoidanceOptionsAreasList":{ + "type":"list", + "member":{"shape":"RouteMatrixAvoidanceArea"}, + "max":250, + "min":0 + }, + "RouteMatrixAvoidanceZoneCategory":{ + "type":"structure", + "members":{ + "Category":{ + "shape":"RouteMatrixZoneCategory", + "documentation":"Zone category to be avoided.
" + } + }, + "documentation":"Zone categories to be avoided.
" + }, + "RouteMatrixAvoidanceZoneCategoryList":{ + "type":"list", + "member":{"shape":"RouteMatrixAvoidanceZoneCategory"}, + "max":3, + "min":0 + }, + "RouteMatrixBoundary":{ + "type":"structure", + "members":{ + "Geometry":{ + "shape":"RouteMatrixBoundaryGeometry", + "documentation":"Geometry of the area to be avoided.
" + }, + "Unbounded":{ + "shape":"Boolean", + "documentation":"No restrictions in terms of a routing boundary, and is typically used for longer routes.
" + } + }, + "documentation":"Boundary within which the matrix is to be calculated. All data, origins and destinations outside the boundary are considered invalid.
" + }, + "RouteMatrixBoundaryGeometry":{ + "type":"structure", + "members":{ + "AutoCircle":{ + "shape":"RouteMatrixAutoCircle", + "documentation":"Provides the circle that was used while calculating the route.
" + }, + "Circle":{ + "shape":"Circle", + "documentation":"Geometry defined as a circle. When request routing boundary was set as AutoCircle, the response routing boundary will return Circle derived from the AutoCircle settings.
Geometry defined as a bounding box. The first pair represents the X and Y coordinates (longitude and latitude,) of the southwest corner of the bounding box; the second pair represents the X and Y coordinates (longitude and latitude) of the northeast corner.
" + }, + "Polygon":{ + "shape":"RouteMatrixBoundaryGeometryPolygonList", + "documentation":"Geometry defined as a polygon with only one linear ring.
" + } + }, + "documentation":"Geometry of the routing boundary.
" + }, + "RouteMatrixBoundaryGeometryPolygonList":{ + "type":"list", + "member":{"shape":"LinearRing"}, + "max":1, + "min":1 + }, + "RouteMatrixCarOptions":{ + "type":"structure", + "members":{ + "LicensePlate":{ + "shape":"RouteMatrixVehicleLicensePlate", + "documentation":"The vehicle License Plate.
" + }, + "MaxSpeed":{ + "shape":"RouteMatrixCarOptionsMaxSpeedDouble", + "documentation":"Maximum speed
Unit: KilometersPerHour
The number of occupants in the vehicle.
Default Value: 1
Options related to the car.
" + }, + "RouteMatrixCarOptionsMaxSpeedDouble":{ + "type":"double", + "max":252.0, + "min":3.6 + }, + "RouteMatrixCarOptionsOccupancyInteger":{ + "type":"integer", + "box":true, + "min":1 + }, + "RouteMatrixDestination":{ + "type":"structure", + "required":["Position"], + "members":{ + "Options":{ + "shape":"RouteMatrixDestinationOptions", + "documentation":"Destination related options.
" + }, + "Position":{ + "shape":"Position", + "documentation":"Position defined as [longitude, latitude].
The route destination.
" + }, + "RouteMatrixDestinationOptions":{ + "type":"structure", + "members":{ + "AvoidActionsForDistance":{ + "shape":"RouteMatrixDestinationOptionsAvoidActionsForDistanceLong", + "documentation":"Avoids actions for the provided distance. This is typically to consider for users in moving vehicles who may not have sufficient time to make an action at an origin or a destination.
" + }, + "Heading":{ + "shape":"Heading", + "documentation":"GPS Heading at the position.
" + }, + "Matching":{ + "shape":"RouteMatrixMatchingOptions", + "documentation":"Options to configure matching the provided position to the road network.
" + }, + "SideOfStreet":{ + "shape":"RouteMatrixSideOfStreetOptions", + "documentation":"Options to configure matching the provided position to a side of the street.
" + } + }, + "documentation":"Options related to the destination.
" + }, + "RouteMatrixDestinationOptionsAvoidActionsForDistanceLong":{ + "type":"long", + "min":0 + }, + "RouteMatrixEntry":{ + "type":"structure", + "required":[ + "Distance", + "Duration" + ], + "members":{ + "Distance":{ + "shape":"DistanceMeters", + "documentation":"The total distance of travel for the route.
" + }, + "Duration":{ + "shape":"DurationSeconds", + "documentation":"The expected duration of travel for the route.
Unit: seconds
Error code that occurred during calculation of the route.
" + } + }, + "documentation":"The calculated route matrix containing the results for all pairs of Origins to Destination positions. Each row corresponds to one entry in Origins. Each entry in the row corresponds to the route from that entry in Origins to an entry in Destination positions.
" + }, + "RouteMatrixErrorCode":{ + "type":"string", + "enum":[ + "NoMatch", + "NoMatchDestination", + "NoMatchOrigin", + "NoRoute", + "OutOfBounds", + "OutOfBoundsDestination", + "OutOfBoundsOrigin", + "Other", + "Violation" + ] + }, + "RouteMatrixExclusionOptions":{ + "type":"structure", + "required":["Countries"], + "members":{ + "Countries":{ + "shape":"CountryCodeList", + "documentation":"List of countries to be avoided defined by two-letter or three-letter country codes.
" + } + }, + "documentation":"Exclusion options.
" + }, + "RouteMatrixHazardousCargoType":{ + "type":"string", + "enum":[ + "Combustible", + "Corrosive", + "Explosive", + "Flammable", + "Gas", + "HarmfulToWater", + "Organic", + "Other", + "Poison", + "PoisonousInhalation", + "Radioactive" + ] + }, + "RouteMatrixHazardousCargoTypeList":{ + "type":"list", + "member":{"shape":"RouteMatrixHazardousCargoType"}, + "max":11, + "min":0 + }, + "RouteMatrixMatchingOptions":{ + "type":"structure", + "members":{ + "NameHint":{ + "shape":"SensitiveString", + "documentation":"Attempts to match the provided position to a road similar to the provided name.
" + }, + "OnRoadThreshold":{ + "shape":"RouteMatrixMatchingOptionsOnRoadThresholdLong", + "documentation":"If the distance to a highway/bridge/tunnel/sliproad is within threshold, the waypoint will be snapped to the highway/bridge/tunnel/sliproad.
Unit: meters
Considers all roads within the provided radius to match the provided destination to. The roads that are considered are determined by the provided Strategy.
Unit: Meters
Strategy that defines matching of the position onto the road network. MatchAny considers all roads possible, whereas MatchMostSignificantRoad matches to the most significant road.
" + } + }, + "documentation":"Matching options.
" + }, + "RouteMatrixMatchingOptionsOnRoadThresholdLong":{ + "type":"long", + "min":0 + }, + "RouteMatrixOrigin":{ + "type":"structure", + "required":["Position"], + "members":{ + "Options":{ + "shape":"RouteMatrixOriginOptions", + "documentation":"Origin related options.
" + }, + "Position":{ + "shape":"Position", + "documentation":"Position defined as [longitude, latitude].
The start position for the route.
" + }, + "RouteMatrixOriginOptions":{ + "type":"structure", + "members":{ + "AvoidActionsForDistance":{ + "shape":"RouteMatrixOriginOptionsAvoidActionsForDistanceLong", + "documentation":"Avoids actions for the provided distance. This is typically to consider for users in moving vehicles who may not have sufficient time to make an action at an origin or a destination.
" + }, + "Heading":{ + "shape":"Heading", + "documentation":"GPS Heading at the position.
" + }, + "Matching":{ + "shape":"RouteMatrixMatchingOptions", + "documentation":"Options to configure matching the provided position to the road network.
" + }, + "SideOfStreet":{ + "shape":"RouteMatrixSideOfStreetOptions", + "documentation":"Options to configure matching the provided position to a side of the street.
" + } + }, + "documentation":"Origin related options.
" + }, + "RouteMatrixOriginOptionsAvoidActionsForDistanceLong":{ + "type":"long", + "min":0 + }, + "RouteMatrixRow":{ + "type":"list", + "member":{"shape":"RouteMatrixEntry"} + }, + "RouteMatrixScooterOptions":{ + "type":"structure", + "members":{ + "LicensePlate":{ + "shape":"RouteMatrixVehicleLicensePlate", + "documentation":"The vehicle License Plate.
" + }, + "MaxSpeed":{ + "shape":"RouteMatrixScooterOptionsMaxSpeedDouble", + "documentation":"Maximum speed.
Unit: KilometersPerHour
The number of occupants in the vehicle.
Default Value: 1
Travel mode options when the provided travel mode is \"Scooter\"
" + }, + "RouteMatrixScooterOptionsMaxSpeedDouble":{ + "type":"double", + "max":252.0, + "min":3.6 + }, + "RouteMatrixScooterOptionsOccupancyInteger":{ + "type":"integer", + "box":true, + "min":1 + }, + "RouteMatrixSideOfStreetOptions":{ + "type":"structure", + "required":["Position"], + "members":{ + "Position":{ + "shape":"Position", + "documentation":"Position defined as [longitude, latitude].
Strategy that defines when the side of street position should be used. AnyStreet will always use the provided position.
Default Value: DividedStreetOnly
Options to configure matching the provided position to a side of the street.
" + }, + "RouteMatrixTrafficOptions":{ + "type":"structure", + "members":{ + "FlowEventThresholdOverride":{ + "shape":"DurationSeconds", + "documentation":"Duration for which flow traffic is considered valid. For this period, the flow traffic is used over historical traffic data. Flow traffic refers to congestion, which changes very quickly. Duration in seconds for which flow traffic event would be considered valid. While flow traffic event is valid it will be used over the historical traffic data.
" + }, + "Usage":{ + "shape":"TrafficUsage", + "documentation":"Determines if traffic should be used or ignored while calculating the route.
Default Value: UseTrafficData
Traffic related options.
" + }, + "RouteMatrixTrailerOptions":{ + "type":"structure", + "members":{ + "TrailerCount":{ + "shape":"RouteMatrixTrailerOptionsTrailerCountInteger", + "documentation":"Number of trailers attached to the vehicle.
Default Value: 0
Trailer options corresponding to the vehicle.
" + }, + "RouteMatrixTrailerOptionsTrailerCountInteger":{ + "type":"integer", + "box":true, + "max":255, + "min":0 + }, + "RouteMatrixTravelMode":{ + "type":"string", + "enum":[ + "Car", + "Pedestrian", + "Scooter", + "Truck" + ] + }, + "RouteMatrixTravelModeOptions":{ + "type":"structure", + "members":{ + "Car":{ + "shape":"RouteMatrixCarOptions", + "documentation":"Travel mode options when the provided travel mode is \"Car\"
" + }, + "Scooter":{ + "shape":"RouteMatrixScooterOptions", + "documentation":"Travel mode options when the provided travel mode is \"Scooter\"
" + }, + "Truck":{ + "shape":"RouteMatrixTruckOptions", + "documentation":"Travel mode options when the provided travel mode is \"Truck\"
" + } + }, + "documentation":"Travel mode related options for the provided travel mode.
" + }, + "RouteMatrixTruckOptions":{ + "type":"structure", + "members":{ + "AxleCount":{ + "shape":"RouteMatrixTruckOptionsAxleCountInteger", + "documentation":"Total number of axles of the vehicle.
" + }, + "GrossWeight":{ + "shape":"WeightKilograms", + "documentation":"Gross weight of the vehicle including trailers, and goods at capacity.
Unit: Kilograms
List of Hazardous cargo contained in the vehicle.
" + }, + "Height":{ + "shape":"RouteMatrixTruckOptionsHeightLong", + "documentation":"Height of the vehicle.
Unit: centimeters
Kingpin to rear axle length of the vehicle
Unit: centimeters
Length of the vehicle.
Unit: centimeters
The vehicle License Plate.
" + }, + "MaxSpeed":{ + "shape":"RouteMatrixTruckOptionsMaxSpeedDouble", + "documentation":"Maximum speed
Unit: KilometersPerHour
The number of occupants in the vehicle.
Default Value: 1
Payload capacity of the vehicle and trailers attached.
Unit: kilograms
Trailer options corresponding to the vehicle.
" + }, + "TruckType":{ + "shape":"RouteMatrixTruckType", + "documentation":"Type of the truck.
" + }, + "TunnelRestrictionCode":{ + "shape":"TunnelRestrictionCode", + "documentation":"The tunnel restriction code.
Tunnel categories in this list indicate the restrictions which apply to certain tunnels in Great Britain. They relate to the types of dangerous goods that can be transported through them.
Tunnel Category B
Risk Level: Limited risk
Restrictions: Few restrictions
Tunnel Category C
Risk Level: Medium risk
Restrictions: Some restrictions
Tunnel Category D
Risk Level: High risk
Restrictions: Many restrictions occur
Tunnel Category E
Risk Level: Very high risk
Restrictions: Restricted tunnel
Heaviest weight per axle irrespective of the axle type or the axle group. Meant for usage in countries where the differences in axle types or axle groups are not distinguished.
Unit: Kilograms
Specifies the total weight for the specified axle group. Meant for usage in countries that have different regulations based on the axle group type.
" + }, + "Width":{ + "shape":"RouteMatrixTruckOptionsWidthLong", + "documentation":"Width of the vehicle.
Unit: centimeters
Travel mode options when the provided travel mode is \"Truck\"
" + }, + "RouteMatrixTruckOptionsAxleCountInteger":{ + "type":"integer", + "box":true, + "max":255, + "min":2 + }, + "RouteMatrixTruckOptionsHeightLong":{ + "type":"long", + "max":5000, + "min":0 + }, + "RouteMatrixTruckOptionsLengthLong":{ + "type":"long", + "max":30000, + "min":0 + }, + "RouteMatrixTruckOptionsMaxSpeedDouble":{ + "type":"double", + "max":252.0, + "min":3.6 + }, + "RouteMatrixTruckOptionsOccupancyInteger":{ + "type":"integer", + "box":true, + "min":1 + }, + "RouteMatrixTruckOptionsWidthLong":{ + "type":"long", + "max":5000, + "min":0 + }, + "RouteMatrixTruckType":{ + "type":"string", + "enum":[ + "LightTruck", + "StraightTruck", + "Tractor" + ] + }, + "RouteMatrixVehicleLicensePlate":{ + "type":"structure", + "members":{ + "LastCharacter":{ + "shape":"RouteMatrixVehicleLicensePlateLastCharacterString", + "documentation":"The last character of the License Plate.
" + } + }, + "documentation":"The vehicle License Plate.
" + }, + "RouteMatrixVehicleLicensePlateLastCharacterString":{ + "type":"string", + "max":1, + "min":1 + }, + "RouteMatrixZoneCategory":{ + "type":"string", + "enum":[ + "CongestionPricing", + "Environmental", + "Vignette" + ] + }, + "RouteNoticeDetailRange":{ + "type":"structure", + "members":{ + "Min":{ + "shape":"RouteNoticeDetailRangeMinInteger", + "documentation":"Minimum value for the range.
" + }, + "Max":{ + "shape":"RouteNoticeDetailRangeMaxInteger", + "documentation":"Maximum value for the range.
" + } + }, + "documentation":"Notice Detail that is a range.
" + }, + "RouteNoticeDetailRangeMaxInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RouteNoticeDetailRangeMinInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RouteNoticeImpact":{ + "type":"string", + "enum":[ + "High", + "Low" + ] + }, + "RouteNumber":{ + "type":"structure", + "required":["Value"], + "members":{ + "Direction":{ + "shape":"RouteDirection", + "documentation":"Directional identifier of the route.
" + }, + "Language":{ + "shape":"LanguageTag", + "documentation":"List of languages for instructions corresponding to the route number.
" + }, + "Value":{ + "shape":"String", + "documentation":"The route number.
" + } + }, + "documentation":"The route number.
" + }, + "RouteNumberList":{ + "type":"list", + "member":{"shape":"RouteNumber"} + }, + "RouteOriginOptions":{ + "type":"structure", + "members":{ + "AvoidActionsForDistance":{ + "shape":"RouteOriginOptionsAvoidActionsForDistanceLong", + "documentation":"Avoids actions for the provided distance. This is typically to consider for users in moving vehicles who may not have sufficient time to make an action at an origin or a destination.
" + }, + "AvoidUTurns":{ + "shape":"Boolean", + "documentation":"Avoid U-turns for calculation on highways and motorways.
" + }, + "Heading":{ + "shape":"Heading", + "documentation":"GPS Heading at the position.
" + }, + "Matching":{ + "shape":"RouteMatchingOptions", + "documentation":"Options to configure matching the provided position to the road network.
" + }, + "SideOfStreet":{ + "shape":"RouteSideOfStreetOptions", + "documentation":"Options to configure matching the provided position to a side of the street.
" + } + }, + "documentation":"Origin related options.
" + }, + "RouteOriginOptionsAvoidActionsForDistanceLong":{ + "type":"long", + "max":2000 + }, + "RoutePassThroughPlace":{ + "type":"structure", + "required":["Position"], + "members":{ + "OriginalPosition":{ + "shape":"Position23", + "documentation":"Position provided in the request.
" + }, + "Position":{ + "shape":"Position23", + "documentation":"Position defined as [longitude, latitude].
Index of the waypoint in the request.
" + } + }, + "documentation":"The place where the waypoint is passed through and not treated as a stop.
" + }, + "RoutePassThroughPlaceWaypointIndexInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RoutePassThroughWaypoint":{ + "type":"structure", + "required":["Place"], + "members":{ + "GeometryOffset":{ + "shape":"RoutePassThroughWaypointGeometryOffsetInteger", + "documentation":"Offset in the leg geometry corresponding to the start of this step.
" + }, + "Place":{ + "shape":"RoutePassThroughPlace", + "documentation":"The place details.
" + } + }, + "documentation":"If the waypoint should be treated as a stop. If yes, the route is split up into different legs around the stop.
" + }, + "RoutePassThroughWaypointGeometryOffsetInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RoutePassThroughWaypointList":{ + "type":"list", + "member":{"shape":"RoutePassThroughWaypoint"} + }, + "RoutePedestrianArrival":{ + "type":"structure", + "required":["Place"], + "members":{ + "Place":{ + "shape":"RoutePedestrianPlace", + "documentation":"The place details.
" + }, + "Time":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"The time.
" + } + }, + "documentation":"Details corresponding to the arrival for a leg.
Time format:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Examples:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
The place details.
" + }, + "Time":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"The time.
" + } + }, + "documentation":"Details corresponding to the departure for a leg.
Time format:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Examples:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
Details corresponding to the arrival for the leg.
" + }, + "Departure":{ + "shape":"RoutePedestrianDeparture", + "documentation":"Details corresponding to the departure for the leg.
" + }, + "Notices":{ + "shape":"RoutePedestrianNoticeList", + "documentation":"Notices are additional information returned that indicate issues that occurred during route calculation.
" + }, + "PassThroughWaypoints":{ + "shape":"RoutePassThroughWaypointList", + "documentation":"Waypoints that were passed through during the leg. This includes the waypoints that were configured with the PassThrough option.
" + }, + "Spans":{ + "shape":"RoutePedestrianSpanList", + "documentation":"Spans that were computed for the requested SpanAdditionalFeatures.
" + }, + "Summary":{ + "shape":"RoutePedestrianSummary", + "documentation":"Summarized details of the leg.
" + }, + "TravelSteps":{ + "shape":"RoutePedestrianTravelStepList", + "documentation":"Steps of a leg that must be performed before the travel portion of the leg.
" + } + }, + "documentation":"Details that are specific to a pedestrian leg.
" + }, + "RoutePedestrianNotice":{ + "type":"structure", + "required":["Code"], + "members":{ + "Code":{ + "shape":"RoutePedestrianNoticeCode", + "documentation":"Code corresponding to the issue.
" + }, + "Impact":{ + "shape":"RouteNoticeImpact", + "documentation":"Impact corresponding to the issue. While Low impact notices can be safely ignored, High impact notices must be evaluated further to determine the impact.
" + } + }, + "documentation":"Notices are additional information returned that indicate issues that occurred during route calculation.
" + }, + "RoutePedestrianNoticeCode":{ + "type":"string", + "enum":[ + "AccuratePolylineUnavailable", + "Other", + "ViolatedAvoidDirtRoad", + "ViolatedAvoidTunnel", + "ViolatedPedestrianOption" + ] + }, + "RoutePedestrianNoticeList":{ + "type":"list", + "member":{"shape":"RoutePedestrianNotice"} + }, + "RoutePedestrianOptions":{ + "type":"structure", + "members":{ + "Speed":{ + "shape":"RoutePedestrianOptionsSpeedDouble", + "documentation":"Walking speed in Kilometers per hour.
", + "box":true + } + }, + "documentation":"Options related to the pedestrian.
" + }, + "RoutePedestrianOptionsSpeedDouble":{ + "type":"double", + "max":7.2, + "min":1.8 + }, + "RoutePedestrianOverviewSummary":{ + "type":"structure", + "required":[ + "Distance", + "Duration" + ], + "members":{ + "Distance":{ + "shape":"DistanceMeters", + "documentation":"Distance of the step.
" + }, + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the step.
" + } + }, + "documentation":"Provides a summary of a pedestrian route step.
" + }, + "RoutePedestrianPlace":{ + "type":"structure", + "required":["Position"], + "members":{ + "Name":{ + "shape":"String", + "documentation":"The name of the place.
" + }, + "OriginalPosition":{ + "shape":"Position23", + "documentation":"Position provided in the request.
" + }, + "Position":{ + "shape":"Position23", + "documentation":"Position defined as [longitude, latitude].
Options to configure matching the provided position to a side of the street.
" + }, + "WaypointIndex":{ + "shape":"RoutePedestrianPlaceWaypointIndexInteger", + "documentation":"Index of the waypoint in the request.
" + } + }, + "documentation":"Place details corresponding to the arrival or departure.
" + }, + "RoutePedestrianPlaceWaypointIndexInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RoutePedestrianSpan":{ + "type":"structure", + "members":{ + "BestCaseDuration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the computed span without traffic congestion.
Unit: seconds
3 letter Country code corresponding to the Span.
" + }, + "Distance":{ + "shape":"DistanceMeters", + "documentation":"Distance of the computed span. This feature doesn't split a span, but is always computed on a span split by other properties.
" + }, + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the computed span. This feature doesn't split a span, but is always computed on a span split by other properties.
Unit: seconds
Dynamic speed details corresponding to the span.
Unit: KilometersPerHour
Functional classification of the road segment corresponding to the span.
" + }, + "GeometryOffset":{ + "shape":"RoutePedestrianSpanGeometryOffsetInteger", + "documentation":"Offset in the leg geometry corresponding to the start of this span.
" + }, + "Incidents":{ + "shape":"IndexList", + "documentation":"Incidents corresponding to the span. These index into the Incidents in the parent Leg.
" + }, + "Names":{ + "shape":"LocalizedStringList", + "documentation":"Provides an array of names of the pedestrian span in available languages.
" + }, + "PedestrianAccess":{ + "shape":"RouteSpanPedestrianAccessAttributeList", + "documentation":"Access attributes for a pedestrian corresponding to the span.
" + }, + "Region":{ + "shape":"RoutePedestrianSpanRegionString", + "documentation":"2-3 letter Region code corresponding to the Span. This is either a province or a state.
" + }, + "RoadAttributes":{ + "shape":"RouteSpanRoadAttributeList", + "documentation":"Attributes for the road segment corresponding to the span.
" + }, + "RouteNumbers":{ + "shape":"RouteNumberList", + "documentation":"Designated route name or number corresponding to the span.
" + }, + "SpeedLimit":{ + "shape":"RouteSpanSpeedLimitDetails", + "documentation":"Speed limit details corresponding to the span.
Unit: KilometersPerHour
Duration of the computed span under typical traffic congestion.
Unit: seconds
Span computed for the requested SpanAdditionalFeatures.
" + }, + "RoutePedestrianSpanFunctionalClassificationInteger":{ + "type":"integer", + "box":true, + "max":5, + "min":1 + }, + "RoutePedestrianSpanGeometryOffsetInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RoutePedestrianSpanList":{ + "type":"list", + "member":{"shape":"RoutePedestrianSpan"} + }, + "RoutePedestrianSpanRegionString":{ + "type":"string", + "max":3, + "min":0 + }, + "RoutePedestrianSummary":{ + "type":"structure", + "members":{ + "Overview":{ + "shape":"RoutePedestrianOverviewSummary", + "documentation":"Summarized details for the leg including before travel, travel and after travel steps.
" + }, + "TravelOnly":{ + "shape":"RoutePedestrianTravelOnlySummary", + "documentation":"Summarized details for the leg including travel steps only. The Distance for the travel only portion of the journey is in meters
" + } + }, + "documentation":"Summarized details for the leg including before travel, travel and after travel steps.
" + }, + "RoutePedestrianTravelOnlySummary":{ + "type":"structure", + "required":["Duration"], + "members":{ + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the step.
Unit: seconds
Summarized details for the leg including travel steps.
" + }, + "RoutePedestrianTravelStep":{ + "type":"structure", + "required":[ + "Duration", + "Type" + ], + "members":{ + "ContinueStepDetails":{ + "shape":"RouteContinueStepDetails", + "documentation":"Details related to the continue step.
" + }, + "CurrentRoad":{ + "shape":"RouteRoad", + "documentation":"Details of the current road. See RouteRoad for details of sub-attributes.
" + }, + "Distance":{ + "shape":"DistanceMeters", + "documentation":"Distance of the step.
" + }, + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the step.
Unit: seconds
Exit number of the road exit, if applicable.
" + }, + "GeometryOffset":{ + "shape":"RoutePedestrianTravelStepGeometryOffsetInteger", + "documentation":"Offset in the leg geometry corresponding to the start of this step.
" + }, + "Instruction":{ + "shape":"String", + "documentation":"Brief description of the step in the requested language.
Only available when the TravelStepType is Default.
Details that are specific to a Keep step.
" + }, + "NextRoad":{ + "shape":"RouteRoad", + "documentation":"Details of the next road. See RouteRoad for details of sub-attributes.
" + }, + "RoundaboutEnterStepDetails":{ + "shape":"RouteRoundaboutEnterStepDetails", + "documentation":"Details that are specific to a Roundabout Enter step.
" + }, + "RoundaboutExitStepDetails":{ + "shape":"RouteRoundaboutExitStepDetails", + "documentation":"Details that are specific to a Roundabout Exit step.
" + }, + "RoundaboutPassStepDetails":{ + "shape":"RouteRoundaboutPassStepDetails", + "documentation":"Details that are specific to a Roundabout Pass step.
" + }, + "Signpost":{ + "shape":"RouteSignpost", + "documentation":"Sign post information of the action, applicable only for TurnByTurn steps. See RouteSignpost for details of sub-attributes.
" + }, + "TurnStepDetails":{ + "shape":"RouteTurnStepDetails", + "documentation":"Details that are specific to a turn step.
" + }, + "Type":{ + "shape":"RoutePedestrianTravelStepType", + "documentation":"Type of the step.
" + } + }, + "documentation":"Steps of a leg that must be performed during the travel portion of the leg.
" + }, + "RoutePedestrianTravelStepGeometryOffsetInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RoutePedestrianTravelStepList":{ + "type":"list", + "member":{"shape":"RoutePedestrianTravelStep"} + }, + "RoutePedestrianTravelStepType":{ + "type":"string", + "enum":[ + "Arrive", + "Continue", + "Depart", + "Keep", + "RoundaboutEnter", + "RoundaboutExit", + "RoundaboutPass", + "Turn", + "Exit", + "Ramp", + "UTurn" + ] + }, + "RouteRampStepDetails":{ + "type":"structure", + "required":["Intersection"], + "members":{ + "Intersection":{ + "shape":"LocalizedStringList", + "documentation":"Name of the intersection, if applicable to the step.
" + }, + "SteeringDirection":{ + "shape":"RouteSteeringDirection", + "documentation":"Steering direction for the step.
" + }, + "TurnAngle":{ + "shape":"TurnAngle", + "documentation":"Angle of the turn.
" + }, + "TurnIntensity":{ + "shape":"RouteTurnIntensity", + "documentation":"Intensity of the turn.
" + } + }, + "documentation":"Details that are specific to a ramp step.
" + }, + "RouteResponseNotice":{ + "type":"structure", + "required":["Code"], + "members":{ + "Code":{ + "shape":"RouteResponseNoticeCode", + "documentation":"Code corresponding to the issue.
" + }, + "Impact":{ + "shape":"RouteNoticeImpact", + "documentation":"Impact corresponding to the issue. While Low impact notices can be safely ignored, High impact notices must be evaluated further to determine the impact.
" + } + }, + "documentation":"Notices are additional information returned that indicate issues that occurred during route calculation.
" + }, + "RouteResponseNoticeCode":{ + "type":"string", + "enum":[ + "MainLanguageNotFound", + "Other", + "TravelTimeExceedsDriverWorkHours" + ] + }, + "RouteResponseNoticeList":{ + "type":"list", + "member":{"shape":"RouteResponseNotice"} + }, + "RouteRoad":{ + "type":"structure", + "required":[ + "RoadName", + "RouteNumber", + "Towards" + ], + "members":{ + "RoadName":{ + "shape":"LocalizedStringList", + "documentation":"Name of the road (localized).
" + }, + "RouteNumber":{ + "shape":"RouteNumberList", + "documentation":"Route number of the road.
" + }, + "Towards":{ + "shape":"LocalizedStringList", + "documentation":"Names of destinations that can be reached when traveling on the road.
" + }, + "Type":{ + "shape":"RouteRoadType", + "documentation":"The type of road.
" + } + }, + "documentation":"The road on the route.
" + }, + "RouteRoadType":{ + "type":"string", + "enum":[ + "Highway", + "Rural", + "Urban" + ] + }, + "RouteRoundaboutEnterStepDetails":{ + "type":"structure", + "required":["Intersection"], + "members":{ + "Intersection":{ + "shape":"LocalizedStringList", + "documentation":"Name of the intersection, if applicable to the step.
" + }, + "SteeringDirection":{ + "shape":"RouteSteeringDirection", + "documentation":"Steering direction for the step.
" + }, + "TurnAngle":{ + "shape":"TurnAngle", + "documentation":"Angle of the turn.
" + }, + "TurnIntensity":{ + "shape":"RouteTurnIntensity", + "documentation":"Intensity of the turn.
" + } + }, + "documentation":"Details about the roundabout leg.
" + }, + "RouteRoundaboutExitStepDetails":{ + "type":"structure", + "required":["Intersection"], + "members":{ + "Intersection":{ + "shape":"LocalizedStringList", + "documentation":"Name of the intersection, if applicable to the step.
" + }, + "RelativeExit":{ + "shape":"RouteRoundaboutExitStepDetailsRelativeExitInteger", + "documentation":"Exit to be taken.
" + }, + "RoundaboutAngle":{ + "shape":"RoundaboutAngle", + "documentation":"Angle of the roundabout.
" + }, + "SteeringDirection":{ + "shape":"RouteSteeringDirection", + "documentation":"Steering direction for the step.
" + } + }, + "documentation":"Details about the roundabout step.
" + }, + "RouteRoundaboutExitStepDetailsRelativeExitInteger":{ + "type":"integer", + "box":true, + "max":12, + "min":1 + }, + "RouteRoundaboutPassStepDetails":{ + "type":"structure", + "required":["Intersection"], + "members":{ + "Intersection":{ + "shape":"LocalizedStringList", + "documentation":"Name of the intersection, if applicable to the step.
" + }, + "SteeringDirection":{ + "shape":"RouteSteeringDirection", + "documentation":"Steering direction for the step.
" + }, + "TurnAngle":{ + "shape":"TurnAngle", + "documentation":"Angle of the turn.
" + }, + "TurnIntensity":{ + "shape":"RouteTurnIntensity", + "documentation":"Intensity of the turn.
" + } + }, + "documentation":"Details about the step.
" + }, + "RouteScooterOptions":{ + "type":"structure", + "members":{ + "EngineType":{ + "shape":"RouteEngineType", + "documentation":"Engine type of the vehicle.
" + }, + "LicensePlate":{ + "shape":"RouteVehicleLicensePlate", + "documentation":"The vehicle License Plate.
" + }, + "MaxSpeed":{ + "shape":"RouteScooterOptionsMaxSpeedDouble", + "documentation":"Maximum speed
Unit: KilometersPerHour
The number of occupants in the vehicle.
Default Value: 1
Travel mode options when the provided travel mode is \"Scooter\"
" + }, + "RouteScooterOptionsMaxSpeedDouble":{ + "type":"double", + "max":252.0, + "min":3.6 + }, + "RouteScooterOptionsOccupancyInteger":{ + "type":"integer", + "box":true, + "min":1 + }, + "RouteSideOfStreet":{ + "type":"string", + "enum":[ + "Left", + "Right" + ] + }, + "RouteSideOfStreetOptions":{ + "type":"structure", + "required":["Position"], + "members":{ + "Position":{ + "shape":"Position", + "documentation":"Position defined as [longitude, latitude].
Strategy that defines when the side of street position should be used.
Default Value: DividedStreetOnly
Options to configure matching the provided position to a side of the street.
" + }, + "RouteSignpost":{ + "type":"structure", + "required":["Labels"], + "members":{ + "Labels":{ + "shape":"RouteSignpostLabelList", + "documentation":"Labels present on the sign post.
" + } + }, + "documentation":"Sign post information of the action, applicable only for TurnByTurn steps. See RouteSignpost for details of sub-attributes.
" + }, + "RouteSignpostLabel":{ + "type":"structure", + "members":{ + "RouteNumber":{ + "shape":"RouteNumber", + "documentation":"Route number of the road.
" + }, + "Text":{ + "shape":"LocalizedString", + "documentation":"The Signpost text.
" + } + }, + "documentation":"Labels presented on the sign post.
" + }, + "RouteSignpostLabelList":{ + "type":"list", + "member":{"shape":"RouteSignpostLabel"} + }, + "RouteSpanAdditionalFeature":{ + "type":"string", + "enum":[ + "BestCaseDuration", + "CarAccess", + "Country", + "Distance", + "Duration", + "DynamicSpeed", + "FunctionalClassification", + "Gates", + "Incidents", + "Names", + "Notices", + "PedestrianAccess", + "RailwayCrossings", + "Region", + "RoadAttributes", + "RouteNumbers", + "ScooterAccess", + "SpeedLimit", + "TollSystems", + "TruckAccess", + "TruckRoadTypes", + "TypicalDuration", + "Zones", + "Consumption" + ] + }, + "RouteSpanAdditionalFeatureList":{ + "type":"list", + "member":{"shape":"RouteSpanAdditionalFeature"}, + "max":24, + "min":0 + }, + "RouteSpanCarAccessAttribute":{ + "type":"string", + "enum":[ + "Allowed", + "NoThroughTraffic", + "TollRoad" + ] + }, + "RouteSpanCarAccessAttributeList":{ + "type":"list", + "member":{"shape":"RouteSpanCarAccessAttribute"}, + "max":3, + "min":0 + }, + "RouteSpanDynamicSpeedDetails":{ + "type":"structure", + "members":{ + "BestCaseSpeed":{ + "shape":"SpeedKilometersPerHour", + "documentation":"Estimated speed while traversing the span without traffic congestion.
Unit: KilometersPerHour
Estimated time to turn from this span into the next.
Unit: seconds
Estimated speed while traversing the span under typical traffic congestion.
Unit: KilometersPerHour
Details about the dynamic speed.
Unit: KilometersPerHour
Maximum speed.
Unit: KilometersPerHour
If the span doesn't have a speed limit like the Autobahn.
" + } + }, + "documentation":"Details about the speed limit corresponding to the span.
Unit: KilometersPerHour
Distance of the route.
" + }, + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the route.
Unit: seconds
Toll summary for the complete route.
" + } + }, + "documentation":"Summarized details for the leg including travel steps only. The Distance for the travel only portion of the journey is the same as the Distance within the Overview summary.
" + }, + "RouteToll":{ + "type":"structure", + "required":[ + "PaymentSites", + "Rates", + "Systems" + ], + "members":{ + "Country":{ + "shape":"CountryCode3", + "documentation":"The alpha-2 or alpha-3 character code for the country.
" + }, + "PaymentSites":{ + "shape":"RouteTollPaymentSiteList", + "documentation":"Locations or sites where the toll fare is collected.
" + }, + "Rates":{ + "shape":"RouteTollRateList", + "documentation":"Toll rates that need to be paid to travel this leg of the route.
" + }, + "Systems":{ + "shape":"IndexList", + "documentation":"Toll systems are authorities that collect payments for the toll.
" + } + }, + "documentation":"Provides details about toll information along a route, including the payment sites, applicable toll rates, toll systems, and the country associated with the toll collection.
" + }, + "RouteTollList":{ + "type":"list", + "member":{"shape":"RouteToll"} + }, + "RouteTollOptions":{ + "type":"structure", + "members":{ + "AllTransponders":{ + "shape":"Boolean", + "documentation":"Specifies if the user has valid transponder with access to all toll systems. This impacts toll calculation, and if true the price with transponders is used.
" + }, + "AllVignettes":{ + "shape":"Boolean", + "documentation":"Specifies if the user has valid vignettes with access for all toll roads. If a user has a vignette for a toll road, then toll cost for that road is omitted since no further payment is necessary.
" + }, + "Currency":{ + "shape":"CurrencyCode", + "documentation":"Currency code corresponding to the price. This is the same as Currency specified in the request.
" + }, + "EmissionType":{ + "shape":"RouteEmissionType", + "documentation":"Emission type of the vehicle for toll cost calculation.
Valid values: Euro1, Euro2, Euro3, Euro4, Euro5, Euro6, EuroEev
Vehicle category for toll cost calculation.
" + } + }, + "documentation":"Options related to Tolls on a route.
" + }, + "RouteTollPass":{ + "type":"structure", + "members":{ + "IncludesReturnTrip":{ + "shape":"Boolean", + "documentation":"If the pass includes the rate for the return leg of the trip.
" + }, + "SeniorPass":{ + "shape":"Boolean", + "documentation":"If the pass is only valid for senior persons.
" + }, + "TransferCount":{ + "shape":"RouteTollPassTransferCountInteger", + "documentation":"If the toll pass can be transferred, and how many times.
" + }, + "TripCount":{ + "shape":"RouteTollPassTripCountInteger", + "documentation":"Number of trips the pass is valid for.
" + }, + "ValidityPeriod":{ + "shape":"RouteTollPassValidityPeriod", + "documentation":"Period for which the pass is valid.
" + } + }, + "documentation":"Details if the toll rate can be a pass that supports multiple trips.
" + }, + "RouteTollPassTransferCountInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RouteTollPassTripCountInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RouteTollPassValidityPeriod":{ + "type":"structure", + "required":["Period"], + "members":{ + "Period":{ + "shape":"RouteTollPassValidityPeriodType", + "documentation":"Validity period.
" + }, + "PeriodCount":{ + "shape":"RouteTollPassValidityPeriodPeriodCountInteger", + "documentation":"Counts for the validity period.
" + } + }, + "documentation":"Period for which the pass is valid.
" + }, + "RouteTollPassValidityPeriodPeriodCountInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RouteTollPassValidityPeriodType":{ + "type":"string", + "enum":[ + "Annual", + "Days", + "ExtendedAnnual", + "Minutes", + "Months" + ] + }, + "RouteTollPaymentMethod":{ + "type":"string", + "enum":[ + "BankCard", + "Cash", + "CashExact", + "CreditCard", + "PassSubscription", + "TravelCard", + "Transponder", + "VideoToll" + ] + }, + "RouteTollPaymentMethodList":{ + "type":"list", + "member":{"shape":"RouteTollPaymentMethod"}, + "max":8, + "min":0 + }, + "RouteTollPaymentSite":{ + "type":"structure", + "required":["Position"], + "members":{ + "Name":{ + "shape":"String", + "documentation":"Name of the payment site.
" + }, + "Position":{ + "shape":"Position23", + "documentation":"Position defined as [longitude, latitude].
Locations or sites where the toll fare is collected.
" + }, + "RouteTollPaymentSiteList":{ + "type":"list", + "member":{"shape":"RouteTollPaymentSite"} + }, + "RouteTollPrice":{ + "type":"structure", + "required":[ + "Currency", + "Estimate", + "Range", + "Value" + ], + "members":{ + "Currency":{ + "shape":"CurrencyCode", + "documentation":"Currency code corresponding to the price. This is the same as Currency specified in the request.
" + }, + "Estimate":{ + "shape":"Boolean", + "documentation":"If the price is an estimate or an exact value.
" + }, + "PerDuration":{ + "shape":"DurationSeconds", + "documentation":"Duration for which the price corresponds to.
Unit: seconds
If the price is a range or an exact value. If any of the toll fares making up the route is a range, the overall price is also a range.
" + }, + "RangeValue":{ + "shape":"RouteTollPriceValueRange", + "documentation":"Price range with a minimum and maximum value, if a range.
" + }, + "Value":{ + "shape":"RouteTollPriceValueDouble", + "documentation":"Exact price, if not a range.
" + } + }, + "documentation":"The toll price.
" + }, + "RouteTollPriceSummary":{ + "type":"structure", + "required":[ + "Currency", + "Estimate", + "Range", + "Value" + ], + "members":{ + "Currency":{ + "shape":"CurrencyCode", + "documentation":"Currency code corresponding to the price. This is the same as Currency specified in the request.
" + }, + "Estimate":{ + "shape":"Boolean", + "documentation":"If the price is an estimate or an exact value.
" + }, + "Range":{ + "shape":"Boolean", + "documentation":"If the price is a range or an exact value. If any of the toll fares making up the route is a range, the overall price is also a range.
" + }, + "RangeValue":{ + "shape":"RouteTollPriceValueRange", + "documentation":"Price range with a minimum and maximum value, if a range.
" + }, + "Value":{ + "shape":"RouteTollPriceSummaryValueDouble", + "documentation":"Exact price, if not a range.
" + } + }, + "documentation":"Summary of the route and toll price.
" + }, + "RouteTollPriceSummaryValueDouble":{ + "type":"double", + "box":true, + "min":0.0 + }, + "RouteTollPriceValueDouble":{ + "type":"double", + "box":true, + "min":0.0 + }, + "RouteTollPriceValueRange":{ + "type":"structure", + "required":[ + "Min", + "Max" + ], + "members":{ + "Min":{ + "shape":"RouteTollPriceValueRangeMinDouble", + "documentation":"Minimum price.
" + }, + "Max":{ + "shape":"RouteTollPriceValueRangeMaxDouble", + "documentation":"Maximum price.
" + } + }, + "documentation":"Price range with a minimum and maximum value, if a range.
" + }, + "RouteTollPriceValueRangeMaxDouble":{ + "type":"double", + "box":true, + "min":0.0 + }, + "RouteTollPriceValueRangeMinDouble":{ + "type":"double", + "box":true, + "min":0.0 + }, + "RouteTollRate":{ + "type":"structure", + "required":[ + "Id", + "LocalPrice", + "Name", + "PaymentMethods", + "Transponders" + ], + "members":{ + "ApplicableTimes":{ + "shape":"String", + "documentation":"Time when the rate is valid.
" + }, + "ConvertedPrice":{ + "shape":"RouteTollPrice", + "documentation":"Price in the converted currency as specified in the request.
" + }, + "Id":{ + "shape":"String", + "documentation":"The Toll rate Id.
" + }, + "LocalPrice":{ + "shape":"RouteTollPrice", + "documentation":"Price in the local regional currency.
" + }, + "Name":{ + "shape":"String", + "documentation":"The name of the toll.
" + }, + "Pass":{ + "shape":"RouteTollPass", + "documentation":"Details if the toll rate can be a pass that supports multiple trips.
" + }, + "PaymentMethods":{ + "shape":"RouteTollPaymentMethodList", + "documentation":"Accepted payment methods at the toll.
" + }, + "Transponders":{ + "shape":"RouteTransponderList", + "documentation":"Transponders for which this toll can be applied.
" + } + }, + "documentation":"The toll rate.
" + }, + "RouteTollRateList":{ + "type":"list", + "member":{"shape":"RouteTollRate"} + }, + "RouteTollSummary":{ + "type":"structure", + "members":{ + "Total":{ + "shape":"RouteTollPriceSummary", + "documentation":"Total toll summary for the complete route. Total is the only summary available today.
" + } + }, + "documentation":"The toll summary for the complete route.
" + }, + "RouteTollSystem":{ + "type":"structure", + "members":{ + "Name":{ + "shape":"String", + "documentation":"The toll system name.
" + } + }, + "documentation":"Toll systems are authorities that collect payments for the toll.
" + }, + "RouteTollSystemList":{ + "type":"list", + "member":{"shape":"RouteTollSystem"} + }, + "RouteTollVehicleCategory":{ + "type":"string", + "enum":["Minibus"] + }, + "RouteTrafficOptions":{ + "type":"structure", + "members":{ + "FlowEventThresholdOverride":{ + "shape":"DurationSeconds", + "documentation":"Duration for which flow traffic is considered valid. For this period, the flow traffic is used over historical traffic data. Flow traffic refers to congestion, which changes very quickly. Duration in seconds for which flow traffic event would be considered valid. While flow traffic event is valid it will be used over the historical traffic data.
" + }, + "Usage":{ + "shape":"TrafficUsage", + "documentation":"Determines if traffic should be used or ignored while calculating the route.
Default Value: UseTrafficData
Traffic options for the route.
" + }, + "RouteTrailerOptions":{ + "type":"structure", + "members":{ + "AxleCount":{ + "shape":"RouteTrailerOptionsAxleCountInteger", + "documentation":"Total number of axles of the vehicle.
" + }, + "TrailerCount":{ + "shape":"RouteTrailerOptionsTrailerCountInteger", + "documentation":"Number of trailers attached to the vehicle.
Default Value: 0
Trailer options corresponding to the vehicle.
" + }, + "RouteTrailerOptionsAxleCountInteger":{ + "type":"integer", + "box":true, + "min":1 + }, + "RouteTrailerOptionsTrailerCountInteger":{ + "type":"integer", + "box":true, + "max":255, + "min":1 + }, + "RouteTransponder":{ + "type":"structure", + "members":{ + "SystemName":{ + "shape":"String", + "documentation":"Names of the toll system collecting the toll.
" + } + }, + "documentation":"Transponders for which this toll can be applied.
" + }, + "RouteTransponderList":{ + "type":"list", + "member":{"shape":"RouteTransponder"} + }, + "RouteTravelMode":{ + "type":"string", + "enum":[ + "Car", + "Pedestrian", + "Scooter", + "Truck" + ] + }, + "RouteTravelModeOptions":{ + "type":"structure", + "members":{ + "Car":{ + "shape":"RouteCarOptions", + "documentation":"Travel mode options when the provided travel mode is \"Car\"
" + }, + "Pedestrian":{ + "shape":"RoutePedestrianOptions", + "documentation":"Travel mode options when the provided travel mode is \"Pedestrian\"
" + }, + "Scooter":{ + "shape":"RouteScooterOptions", + "documentation":"Travel mode options when the provided travel mode is \"Scooter\"
" + }, + "Truck":{ + "shape":"RouteTruckOptions", + "documentation":"Travel mode options when the provided travel mode is \"Truck\"
" + } + }, + "documentation":"Travel mode related options for the provided travel mode.
" + }, + "RouteTravelStepType":{ + "type":"string", + "enum":[ + "Default", + "TurnByTurn" + ] + }, + "RouteTruckOptions":{ + "type":"structure", + "members":{ + "AxleCount":{ + "shape":"RouteTruckOptionsAxleCountInteger", + "documentation":"Total number of axles of the vehicle.
" + }, + "EngineType":{ + "shape":"RouteEngineType", + "documentation":"Engine type of the vehicle.
" + }, + "GrossWeight":{ + "shape":"WeightKilograms", + "documentation":"Gross weight of the vehicle including trailers, and goods at capacity.
Unit: Kilograms
List of Hazardous cargo contained in the vehicle.
" + }, + "Height":{ + "shape":"RouteTruckOptionsHeightLong", + "documentation":"Height of the vehicle.
Unit: centimeters
Height of the vehicle above its first axle.
Unit: centimeters
Kingpin to rear axle length of the vehicle.
Unit: centimeters
Length of the vehicle.
Unit: c
The vehicle License Plate.
" + }, + "MaxSpeed":{ + "shape":"RouteTruckOptionsMaxSpeedDouble", + "documentation":"Maximum speed
Unit: KilometersPerHour
The number of occupants in the vehicle.
Default Value: 1
Payload capacity of the vehicle and trailers attached.
Unit: kilograms
Number of tires on the vehicle.
" + }, + "Trailer":{ + "shape":"RouteTrailerOptions", + "documentation":"Trailer options corresponding to the vehicle.
" + }, + "TruckType":{ + "shape":"RouteTruckType", + "documentation":"Type of the truck.
" + }, + "TunnelRestrictionCode":{ + "shape":"RouteTruckOptionsTunnelRestrictionCodeString", + "documentation":"The tunnel restriction code.
Tunnel categories in this list indicate the restrictions which apply to certain tunnels in Great Britain. They relate to the types of dangerous goods that can be transported through them.
Tunnel Category B
Risk Level: Limited risk
Restrictions: Few restrictions
Tunnel Category C
Risk Level: Medium risk
Restrictions: Some restrictions
Tunnel Category D
Risk Level: High risk
Restrictions: Many restrictions occur
Tunnel Category E
Risk Level: Very high risk
Restrictions: Restricted tunnel
Heaviest weight per axle irrespective of the axle type or the axle group. Meant for usage in countries where the differences in axle types or axle groups are not distinguished.
Unit: Kilograms
Specifies the total weight for the specified axle group. Meant for usage in countries that have different regulations based on the axle group type.
Unit: Kilograms
Width of the vehicle.
Unit: centimeters
Travel mode options when the provided travel mode is \"Truck\"
" + }, + "RouteTruckOptionsAxleCountInteger":{ + "type":"integer", + "box":true, + "max":255, + "min":2 + }, + "RouteTruckOptionsHeightAboveFirstAxleLong":{ + "type":"long", + "max":5000, + "min":0 + }, + "RouteTruckOptionsHeightLong":{ + "type":"long", + "max":5000, + "min":0 + }, + "RouteTruckOptionsLengthLong":{ + "type":"long", + "max":30000, + "min":0 + }, + "RouteTruckOptionsMaxSpeedDouble":{ + "type":"double", + "max":252.0, + "min":3.6 + }, + "RouteTruckOptionsOccupancyInteger":{ + "type":"integer", + "box":true, + "min":1 + }, + "RouteTruckOptionsTireCountInteger":{ + "type":"integer", + "box":true, + "max":255, + "min":1 + }, + "RouteTruckOptionsTunnelRestrictionCodeString":{ + "type":"string", + "max":20, + "min":0 + }, + "RouteTruckOptionsWidthLong":{ + "type":"long", + "max":5000, + "min":0 + }, + "RouteTruckType":{ + "type":"string", + "enum":[ + "LightTruck", + "StraightTruck", + "Tractor" + ] + }, + "RouteTurnIntensity":{ + "type":"string", + "enum":[ + "Sharp", + "Slight", + "Typical" + ] + }, + "RouteTurnStepDetails":{ + "type":"structure", + "required":["Intersection"], + "members":{ + "Intersection":{ + "shape":"LocalizedStringList", + "documentation":"Name of the intersection, if applicable to the step.
" + }, + "SteeringDirection":{ + "shape":"RouteSteeringDirection", + "documentation":"Steering direction for the step.
" + }, + "TurnAngle":{ + "shape":"TurnAngle", + "documentation":"Angle of the turn.
" + }, + "TurnIntensity":{ + "shape":"RouteTurnIntensity", + "documentation":"Intensity of the turn.
" + } + }, + "documentation":"Details related to the turn step.
" + }, + "RouteUTurnStepDetails":{ + "type":"structure", + "required":["Intersection"], + "members":{ + "Intersection":{ + "shape":"LocalizedStringList", + "documentation":"Name of the intersection, if applicable to the step.
" + }, + "SteeringDirection":{ + "shape":"RouteSteeringDirection", + "documentation":"Steering direction for the step.
" + }, + "TurnAngle":{ + "shape":"TurnAngle", + "documentation":"Angle of the turn.
" + }, + "TurnIntensity":{ + "shape":"RouteTurnIntensity", + "documentation":"Intensity of the turn.
" + } + }, + "documentation":"Details related to the U-turn step.
" + }, + "RouteVehicleArrival":{ + "type":"structure", + "required":["Place"], + "members":{ + "Place":{ + "shape":"RouteVehiclePlace", + "documentation":"The place details.
" + }, + "Time":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"The time.
" + } + }, + "documentation":"Details corresponding to the arrival for a leg.
" + }, + "RouteVehicleDeparture":{ + "type":"structure", + "required":["Place"], + "members":{ + "Place":{ + "shape":"RouteVehiclePlace", + "documentation":"The place details.
" + }, + "Time":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"The departure time.
" + } + }, + "documentation":"Details corresponding to the departure for the leg.
" + }, + "RouteVehicleIncident":{ + "type":"structure", + "members":{ + "Description":{ + "shape":"String", + "documentation":"Brief readable description of the incident.
" + }, + "EndTime":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"End timestamp of the incident.
" + }, + "Severity":{ + "shape":"RouteVehicleIncidentSeverity", + "documentation":"Severity of the incident Critical - The part of the route the incident affects is unusable. Major- Major impact on the leg duration, for example stop and go Minor- Minor impact on the leg duration, for example traffic jam Low - Low on duration, for example slightly increased traffic
" + }, + "StartTime":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"Start time of the incident.
" + }, + "Type":{ + "shape":"RouteVehicleIncidentType", + "documentation":"Type of the incident.
" + } + }, + "documentation":"Incidents corresponding to this leg of the route.
" + }, + "RouteVehicleIncidentList":{ + "type":"list", + "member":{"shape":"RouteVehicleIncident"} + }, + "RouteVehicleIncidentSeverity":{ + "type":"string", + "enum":[ + "Critical", + "High", + "Medium", + "Low" + ] + }, + "RouteVehicleIncidentType":{ + "type":"string", + "enum":[ + "Accident", + "Congestion", + "Construction", + "DisabledVehicle", + "LaneRestriction", + "MassTransit", + "Other", + "PlannedEvent", + "RoadClosure", + "RoadHazard", + "Weather" + ] + }, + "RouteVehicleLegDetails":{ + "type":"structure", + "required":[ + "Arrival", + "Departure", + "Incidents", + "Notices", + "PassThroughWaypoints", + "Spans", + "Tolls", + "TollSystems", + "TravelSteps", + "TruckRoadTypes", + "Zones" + ], + "members":{ + "Arrival":{ + "shape":"RouteVehicleArrival", + "documentation":"Details corresponding to the arrival for the leg.
" + }, + "Departure":{ + "shape":"RouteVehicleDeparture", + "documentation":"Details corresponding to the departure for the leg.
" + }, + "Incidents":{ + "shape":"RouteVehicleIncidentList", + "documentation":"Incidents corresponding to this leg of the route.
" + }, + "Notices":{ + "shape":"RouteVehicleNoticeList", + "documentation":"Notices are additional information returned that indicate issues that occurred during route calculation.
" + }, + "PassThroughWaypoints":{ + "shape":"RoutePassThroughWaypointList", + "documentation":"Waypoints that were passed through during the leg. This includes the waypoints that were configured with the PassThrough option.
" + }, + "Spans":{ + "shape":"RouteVehicleSpanList", + "documentation":"Spans that were computed for the requested SpanAdditionalFeatures.
" + }, + "Summary":{ + "shape":"RouteVehicleSummary", + "documentation":"Summarized details of the leg.
" + }, + "Tolls":{ + "shape":"RouteTollList", + "documentation":"Toll related options.
" + }, + "TollSystems":{ + "shape":"RouteTollSystemList", + "documentation":"Toll systems are authorities that collect payments for the toll.
" + }, + "TravelSteps":{ + "shape":"RouteVehicleTravelStepList", + "documentation":"Steps of a leg that must be performed before the travel portion of the leg.
" + }, + "TruckRoadTypes":{ + "shape":"TruckRoadTypeList", + "documentation":"Truck road type identifiers. BK1 through BK4 apply only to Sweden. A2,A4,B2,B4,C,D,ET2,ET4 apply only to Mexico.
There are currently no other supported values as of 26th April 2024.
Zones corresponding to this leg of the route.
" + } + }, + "documentation":"Steps of a leg that correspond to the travel portion of the leg.
" + }, + "RouteVehicleLicensePlate":{ + "type":"structure", + "members":{ + "LastCharacter":{ + "shape":"RouteVehicleLicensePlateLastCharacterString", + "documentation":"The last character of the License Plate.
" + } + }, + "documentation":"License plate information of the vehicle. Currently, only the last character is used where license plate based controlled access is enforced.
" + }, + "RouteVehicleLicensePlateLastCharacterString":{ + "type":"string", + "max":1, + "min":1 + }, + "RouteVehicleNotice":{ + "type":"structure", + "required":[ + "Code", + "Details" + ], + "members":{ + "Code":{ + "shape":"RouteVehicleNoticeCode", + "documentation":"Code corresponding to the issue.
" + }, + "Details":{ + "shape":"RouteVehicleNoticeDetailList", + "documentation":"Additional details of the notice.
" + }, + "Impact":{ + "shape":"RouteNoticeImpact", + "documentation":"Impact corresponding to the issue. While Low impact notices can be safely ignored, High impact notices must be evaluated further to determine the impact.
" + } + }, + "documentation":"Notices are additional information returned that indicate issues that occurred during route calculation.
" + }, + "RouteVehicleNoticeCode":{ + "type":"string", + "enum":[ + "AccuratePolylineUnavailable", + "Other", + "PotentialViolatedAvoidTollRoadUsage", + "PotentialViolatedCarpoolUsage", + "PotentialViolatedTurnRestrictionUsage", + "PotentialViolatedVehicleRestrictionUsage", + "PotentialViolatedZoneRestrictionUsage", + "SeasonalClosure", + "TollsDataTemporarilyUnavailable", + "TollsDataUnavailable", + "TollTransponder", + "ViolatedAvoidControlledAccessHighway", + "ViolatedAvoidDifficultTurns", + "ViolatedAvoidDirtRoad", + "ViolatedAvoidSeasonalClosure", + "ViolatedAvoidTollRoad", + "ViolatedAvoidTollTransponder", + "ViolatedAvoidTruckRoadType", + "ViolatedAvoidTunnel", + "ViolatedAvoidUTurns", + "ViolatedBlockedRoad", + "ViolatedCarpool", + "ViolatedEmergencyGate", + "ViolatedStartDirection", + "ViolatedTurnRestriction", + "ViolatedVehicleRestriction", + "ViolatedZoneRestriction" + ] + }, + "RouteVehicleNoticeDetail":{ + "type":"structure", + "members":{ + "Title":{ + "shape":"String", + "documentation":"The notice title.
" + }, + "ViolatedConstraints":{ + "shape":"RouteViolatedConstraints", + "documentation":"Any violated constraints.
" + } + }, + "documentation":"Additional details of the notice.
" + }, + "RouteVehicleNoticeDetailList":{ + "type":"list", + "member":{"shape":"RouteVehicleNoticeDetail"} + }, + "RouteVehicleNoticeList":{ + "type":"list", + "member":{"shape":"RouteVehicleNotice"} + }, + "RouteVehicleOverviewSummary":{ + "type":"structure", + "required":[ + "Distance", + "Duration" + ], + "members":{ + "BestCaseDuration":{ + "shape":"DurationSeconds", + "documentation":"Total duration in free flowing traffic, which is the best case or shortest duration possible to cover the leg.
Unit: seconds
Distance of the step.
" + }, + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the step.
Unit: seconds
Duration of the computed span under typical traffic congestion.
Unit: seconds
Summarized details of the leg.
" + }, + "RouteVehiclePlace":{ + "type":"structure", + "required":["Position"], + "members":{ + "Name":{ + "shape":"String", + "documentation":"The name of the place.
" + }, + "OriginalPosition":{ + "shape":"Position23", + "documentation":"Position provided in the request.
" + }, + "Position":{ + "shape":"Position23", + "documentation":"Position defined as [longitude, latitude].
Options to configure matching the provided position to a side of the street.
" + }, + "WaypointIndex":{ + "shape":"RouteVehiclePlaceWaypointIndexInteger", + "documentation":"Index of the waypoint in the request.
" + } + }, + "documentation":"Place details corresponding to the arrival or departure.
" + }, + "RouteVehiclePlaceWaypointIndexInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RouteVehicleSpan":{ + "type":"structure", + "members":{ + "BestCaseDuration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the computed span without traffic congestion.
Unit: seconds
Access attributes for a car corresponding to the span.
" + }, + "Country":{ + "shape":"CountryCode3", + "documentation":"3 letter Country code corresponding to the Span.
" + }, + "Distance":{ + "shape":"DistanceMeters", + "documentation":"Distance of the computed span. This feature doesn't split a span, but is always computed on a span split by other properties.
" + }, + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the computed span. This feature doesn't split a span, but is always computed on a span split by other properties.
Unit: seconds
Dynamic speed details corresponding to the span.
Unit: KilometersPerHour
Functional classification of the road segment corresponding to the span.
" + }, + "Gate":{ + "shape":"RouteSpanGateAttribute", + "documentation":"Attributes corresponding to a gate. The gate is present at the end of the returned span.
" + }, + "GeometryOffset":{ + "shape":"RouteVehicleSpanGeometryOffsetInteger", + "documentation":"Offset in the leg geometry corresponding to the start of this span.
" + }, + "Incidents":{ + "shape":"IndexList", + "documentation":"Incidents corresponding to the span. These index into the Incidents in the parent Leg.
" + }, + "Names":{ + "shape":"LocalizedStringList", + "documentation":"Provides an array of names of the vehicle span in available languages.
" + }, + "Notices":{ + "shape":"IndexList", + "documentation":"Notices are additional information returned that indicate issues that occurred during route calculation.
" + }, + "RailwayCrossing":{ + "shape":"RouteSpanRailwayCrossingAttribute", + "documentation":"Attributes corresponding to a railway crossing. The gate is present at the end of the returned span.
" + }, + "Region":{ + "shape":"RouteVehicleSpanRegionString", + "documentation":"2-3 letter Region code corresponding to the Span. This is either a province or a state.
" + }, + "RoadAttributes":{ + "shape":"RouteSpanRoadAttributeList", + "documentation":"Attributes for the road segment corresponding to the span.
" + }, + "RouteNumbers":{ + "shape":"RouteNumberList", + "documentation":"Designated route name or number corresponding to the span.
" + }, + "ScooterAccess":{ + "shape":"RouteSpanScooterAccessAttributeList", + "documentation":"Access attributes for a scooter corresponding to the span.
" + }, + "SpeedLimit":{ + "shape":"RouteSpanSpeedLimitDetails", + "documentation":"Speed limit details corresponding to the span.
Unit: KilometersPerHour
Toll systems are authorities that collect payments for the toll.
" + }, + "TruckAccess":{ + "shape":"RouteSpanTruckAccessAttributeList", + "documentation":"Access attributes for a truck corresponding to the span.
" + }, + "TruckRoadTypes":{ + "shape":"IndexList", + "documentation":"Truck road type identifiers. BK1 through BK4 apply only to Sweden. A2,A4,B2,B4,C,D,ET2,ET4 apply only to Mexico.
There are currently no other supported values as of 26th April 2024.
Duration of the computed span under typical traffic congestion.
Unit: seconds
Zones corresponding to this leg of the route.
" + } + }, + "documentation":"Span computed for the requested SpanAdditionalFeatures.
" + }, + "RouteVehicleSpanFunctionalClassificationInteger":{ + "type":"integer", + "box":true, + "max":5, + "min":1 + }, + "RouteVehicleSpanGeometryOffsetInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RouteVehicleSpanList":{ + "type":"list", + "member":{"shape":"RouteVehicleSpan"} + }, + "RouteVehicleSpanRegionString":{ + "type":"string", + "max":3, + "min":0 + }, + "RouteVehicleSummary":{ + "type":"structure", + "members":{ + "Overview":{ + "shape":"RouteVehicleOverviewSummary", + "documentation":"Summarized details for the leg including before travel, travel and after travel steps.
" + }, + "TravelOnly":{ + "shape":"RouteVehicleTravelOnlySummary", + "documentation":"Summarized details for the leg including travel steps only. The Distance for the travel only portion of the journey is in meters
" + } + }, + "documentation":"Summarized details of the route.
" + }, + "RouteVehicleTravelOnlySummary":{ + "type":"structure", + "required":["Duration"], + "members":{ + "BestCaseDuration":{ + "shape":"DurationSeconds", + "documentation":"Total duration in free flowing traffic, which is the best case or shortest duration possible to cover the leg.
Unit: seconds
Duration of the step.
Unit: seconds
Duration of the computed span under typical traffic congestion.
Unit: seconds
Summarized details of the route.
" + }, + "RouteVehicleTravelStep":{ + "type":"structure", + "required":[ + "Duration", + "Type" + ], + "members":{ + "ContinueHighwayStepDetails":{ + "shape":"RouteContinueHighwayStepDetails", + "documentation":"Details that are specific to a Continue Highway step.
" + }, + "ContinueStepDetails":{ + "shape":"RouteContinueStepDetails", + "documentation":"Details that are specific to a Continue step.
" + }, + "CurrentRoad":{ + "shape":"RouteRoad", + "documentation":"Details of the current road.
" + }, + "Distance":{ + "shape":"DistanceMeters", + "documentation":"Distance of the step.
" + }, + "Duration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the step.
Unit: seconds
Details that are specific to a Enter Highway step.
" + }, + "ExitNumber":{ + "shape":"LocalizedStringList", + "documentation":"Exit number of the road exit, if applicable.
" + }, + "ExitStepDetails":{ + "shape":"RouteExitStepDetails", + "documentation":"Details that are specific to a Roundabout Exit step.
" + }, + "GeometryOffset":{ + "shape":"RouteVehicleTravelStepGeometryOffsetInteger", + "documentation":"Offset in the leg geometry corresponding to the start of this step.
" + }, + "Instruction":{ + "shape":"String", + "documentation":"Brief description of the step in the requested language.
Only available when the TravelStepType is Default.
Details that are specific to a Keep step.
" + }, + "NextRoad":{ + "shape":"RouteRoad", + "documentation":"Details of the next road. See RouteRoad for details of sub-attributes.
" + }, + "RampStepDetails":{ + "shape":"RouteRampStepDetails", + "documentation":"Details that are specific to a Ramp step.
" + }, + "RoundaboutEnterStepDetails":{ + "shape":"RouteRoundaboutEnterStepDetails", + "documentation":"Details that are specific to a Roundabout Enter step.
" + }, + "RoundaboutExitStepDetails":{ + "shape":"RouteRoundaboutExitStepDetails", + "documentation":"Details that are specific to a Roundabout Exit step.
" + }, + "RoundaboutPassStepDetails":{ + "shape":"RouteRoundaboutPassStepDetails", + "documentation":"Details that are specific to a Roundabout Pass step.
" + }, + "Signpost":{ + "shape":"RouteSignpost", + "documentation":"Sign post information of the action, applicable only for TurnByTurn steps. See RouteSignpost for details of sub-attributes.
" + }, + "TurnStepDetails":{ + "shape":"RouteTurnStepDetails", + "documentation":"Details that are specific to a Turn step.
" + }, + "Type":{ + "shape":"RouteVehicleTravelStepType", + "documentation":"Type of the step.
" + }, + "UTurnStepDetails":{ + "shape":"RouteUTurnStepDetails", + "documentation":"Details that are specific to a Turn step.
" + } + }, + "documentation":"Steps of a leg that correspond to the travel portion of the leg.
" + }, + "RouteVehicleTravelStepGeometryOffsetInteger":{ + "type":"integer", + "box":true, + "min":0 + }, + "RouteVehicleTravelStepList":{ + "type":"list", + "member":{"shape":"RouteVehicleTravelStep"} + }, + "RouteVehicleTravelStepType":{ + "type":"string", + "enum":[ + "Arrive", + "Continue", + "ContinueHighway", + "Depart", + "EnterHighway", + "Exit", + "Keep", + "Ramp", + "RoundaboutEnter", + "RoundaboutExit", + "RoundaboutPass", + "Turn", + "UTurn" + ] + }, + "RouteViolatedConstraints":{ + "type":"structure", + "required":["HazardousCargos"], + "members":{ + "AllHazardsRestricted":{ + "shape":"Boolean", + "documentation":"This restriction applies to truck cargo, where the resulting route excludes roads on which hazardous materials are prohibited from being transported.
" + }, + "AxleCount":{ + "shape":"RouteNoticeDetailRange", + "documentation":"Total number of axles of the vehicle.
" + }, + "HazardousCargos":{ + "shape":"RouteHazardousCargoTypeList", + "documentation":"List of Hazardous cargo contained in the vehicle.
" + }, + "MaxHeight":{ + "shape":"DimensionCentimeters", + "documentation":"The maximum height of the vehicle.
" + }, + "MaxKpraLength":{ + "shape":"DimensionCentimeters", + "documentation":"The maximum Kpra length of the vehicle.
Unit: centimeters
The maximum length of the vehicle.
" + }, + "MaxPayloadCapacity":{ + "shape":"WeightKilograms", + "documentation":"The maximum load capacity of the vehicle.
Unit: kilograms
The maximum weight of the route.
Unit: Kilograms
The maximum weight per axle of the vehicle.
Unit: Kilograms
The maximum weight per axle group of the vehicle.
Unit: Kilograms
The maximum width of the vehicle.
" + }, + "Occupancy":{ + "shape":"RouteNoticeDetailRange", + "documentation":"The number of occupants in the vehicle.
Default Value: 1
Access radius restrictions based on time.
" + }, + "TimeDependent":{ + "shape":"Boolean", + "documentation":"The time dependent constraint.
" + }, + "TrailerCount":{ + "shape":"RouteNoticeDetailRange", + "documentation":"Number of trailers attached to the vehicle.
Default Value: 0
Travel mode corresponding to the leg.
" + }, + "TruckRoadType":{ + "shape":"String", + "documentation":"Truck road type identifiers. BK1 through BK4 apply only to Sweden. A2,A4,B2,B4,C,D,ET2,ET4 apply only to Mexico.
There are currently no other supported values as of 26th April 2024.
Type of the truck.
" + }, + "TunnelRestrictionCode":{ + "shape":"TunnelRestrictionCode", + "documentation":"The tunnel restriction code.
Tunnel categories in this list indicate the restrictions which apply to certain tunnels in Great Britain. They relate to the types of dangerous goods that can be transported through them.
Tunnel Category B
Risk Level: Limited risk
Restrictions: Few restrictions
Tunnel Category C
Risk Level: Medium risk
Restrictions: Some restrictions
Tunnel Category D
Risk Level: High risk
Restrictions: Many restrictions occur
Tunnel Category E
Risk Level: Very high risk
Restrictions: Restricted tunnel
This property contains a summary of violated constraints.
" + }, + "RouteWaypoint":{ + "type":"structure", + "required":["Position"], + "members":{ + "AvoidActionsForDistance":{ + "shape":"RouteWaypointAvoidActionsForDistanceLong", + "documentation":"Avoids actions for the provided distance. This is typically to consider for users in moving vehicles who may not have sufficient time to make an action at an origin or a destination.
" + }, + "AvoidUTurns":{ + "shape":"Boolean", + "documentation":"Avoid U-turns for calculation on highways and motorways.
" + }, + "Heading":{ + "shape":"Heading", + "documentation":"GPS Heading at the position.
" + }, + "Matching":{ + "shape":"RouteMatchingOptions", + "documentation":"Options to configure matching the provided position to the road network.
" + }, + "PassThrough":{ + "shape":"Boolean", + "documentation":"If the waypoint should not be treated as a stop. If yes, the waypoint is passed through and doesn't split the route into different legs.
" + }, + "Position":{ + "shape":"Position", + "documentation":"Position defined as [longitude, latitude].
Options to configure matching the provided position to a side of the street.
" + }, + "StopDuration":{ + "shape":"DurationSeconds", + "documentation":"Duration of the stop.
Unit: seconds
Waypoint between the Origin and Destination.
" + }, + "RouteWaypointAvoidActionsForDistanceLong":{ + "type":"long", + "max":2000 + }, + "RouteWaypointList":{ + "type":"list", + "member":{"shape":"RouteWaypoint"} + }, + "RouteWeightConstraint":{ + "type":"structure", + "required":[ + "Type", + "Value" + ], + "members":{ + "Type":{ + "shape":"RouteWeightConstraintType", + "documentation":"The type of constraint.
" + }, + "Value":{ + "shape":"WeightKilograms", + "documentation":"The constraint value.
Unit: Kilograms
The weight constraint for the route.
Unit: Kilograms
The zone category.
" + }, + "Name":{ + "shape":"String", + "documentation":"The name of the zone.
" + } + }, + "documentation":"The zone.
" + }, + "RouteZoneCategory":{ + "type":"string", + "enum":[ + "CongestionPricing", + "Environmental", + "Vignette" + ] + }, + "RouteZoneList":{ + "type":"list", + "member":{"shape":"RouteZone"} + }, + "RoutingObjective":{ + "type":"string", + "enum":[ + "FastestRoute", + "ShortestRoute" + ] + }, + "SensitiveString":{ + "type":"string", + "sensitive":true + }, + "SideOfStreetMatchingStrategy":{ + "type":"string", + "enum":[ + "AnyStreet", + "DividedStreetOnly" + ] + }, + "SnapToRoadsRequest":{ + "type":"structure", + "required":["TracePoints"], + "members":{ + "Key":{ + "shape":"ApiKey", + "documentation":"Optional: The API key to be used for authorization. Either an API key or valid SigV4 signature must be provided when making a request.
", + "location":"querystring", + "locationName":"key" + }, + "SnappedGeometryFormat":{ + "shape":"GeometryFormat", + "documentation":"Chooses what the returned SnappedGeometry format should be.
Default Value: FlexiblePolyline
The radius around the provided tracepoint that is considered for snapping.
Unit: meters
Default value: 300
List of trace points to be snapped onto the road network.
" + }, + "TravelMode":{ + "shape":"RoadSnapTravelMode", + "documentation":"Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.
Default Value: Car
Travel mode related options for the provided travel mode.
" + } + } + }, + "SnapToRoadsRequestSnapRadiusLong":{ + "type":"long", + "max":10000, + "min":0 + }, + "SnapToRoadsRequestTracePointsList":{ + "type":"list", + "member":{"shape":"RoadSnapTracePoint"}, + "max":5000, + "min":2 + }, + "SnapToRoadsResponse":{ + "type":"structure", + "required":[ + "Notices", + "PricingBucket", + "SnappedGeometryFormat", + "SnappedTracePoints" + ], + "members":{ + "Notices":{ + "shape":"RoadSnapNoticeList", + "documentation":"Notices are additional information returned that indicate issues that occurred during route calculation.
" + }, + "PricingBucket":{ + "shape":"String", + "documentation":"The pricing bucket for which the query is charged at.
", + "location":"header", + "locationName":"x-amz-geo-pricing-bucket" + }, + "SnappedGeometry":{ + "shape":"RoadSnapSnappedGeometry", + "documentation":"The interpolated geometry for the snapped route onto the road network.
" + }, + "SnappedGeometryFormat":{ + "shape":"GeometryFormat", + "documentation":"Specifies the format of the geometry returned for each leg of the route.
" + }, + "SnappedTracePoints":{ + "shape":"RoadSnapSnappedTracePointList", + "documentation":"The trace points snapped onto the road network.
" + } + } + }, + "SpeedKilometersPerHour":{ + "type":"double", + "min":0.0 + }, + "String":{"type":"string"}, + "ThrottlingException":{ + "type":"structure", + "required":["Message"], + "members":{ + "Message":{ + "shape":"String", + "locationName":"message" + } + }, + "documentation":"The request was denied due to request throttling.
", + "error":{ + "httpStatusCode":429, + "senderFault":true + }, + "exception":true, + "retryable":{"throttling":false} + }, + "TimeOfDay":{ + "type":"string", + "pattern":"([0-1]?[0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9](Z|[+-]([0-1]?[0-9]|2[0-3]):[0-5][0-9])" + }, + "TimeThresholdList":{ + "type":"list", + "member":{"shape":"TimeThresholdListMemberLong"}, + "max":5, + "min":1 + }, + "TimeThresholdListMemberLong":{ + "type":"long", + "max":10800, + "min":0 + }, + "TimestampWithTimezoneOffset":{ + "type":"string", + "pattern":"([1-2][0-9]{3})-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9]|60)(\\.[0-9]{0,9})?(Z|[+-]([01][0-9]|2[0-3]):[0-5][0-9])" + }, + "TrafficUsage":{ + "type":"string", + "enum":[ + "IgnoreTrafficData", + "UseTrafficData" + ] + }, + "TruckRoadType":{ + "type":"string", + "max":3, + "min":1 + }, + "TruckRoadTypeList":{ + "type":"list", + "member":{"shape":"TruckRoadType"}, + "max":12, + "min":1 + }, + "TunnelRestrictionCode":{ + "type":"string", + "max":1, + "min":1 + }, + "TurnAngle":{ + "type":"double", + "max":180, + "min":-180 + }, + "ValidationException":{ + "type":"structure", + "required":[ + "Message", + "Reason", + "FieldList" + ], + "members":{ + "Message":{ + "shape":"String", + "locationName":"message" + }, + "Reason":{ + "shape":"ValidationExceptionReason", + "documentation":"A message with the reason for the validation exception error.
", + "locationName":"reason" + }, + "FieldList":{ + "shape":"ValidationExceptionFieldList", + "documentation":"The field where the invalid entry was detected.
", + "locationName":"fieldList" + } + }, + "documentation":"The input fails to satisfy the constraints specified by an AWS service.
", + "error":{ + "httpStatusCode":400, + "senderFault":true + }, + "exception":true + }, + "ValidationExceptionField":{ + "type":"structure", + "required":[ + "Name", + "Message" + ], + "members":{ + "Name":{ + "shape":"String", + "documentation":"The name of the Validation Exception Field.
", + "locationName":"name" + }, + "Message":{ + "shape":"String", + "documentation":"The error message.
", + "locationName":"message" + } + }, + "documentation":"The input fails to satisfy the constraints specified by the Amazon Location service.
" + }, + "ValidationExceptionFieldList":{ + "type":"list", + "member":{"shape":"ValidationExceptionField"} + }, + "ValidationExceptionReason":{ + "type":"string", + "enum":[ + "UnknownOperation", + "Missing", + "CannotParse", + "FieldValidationFailed", + "Other", + "UnknownField" + ] + }, + "WaypointId":{ + "type":"string", + "max":100, + "min":1 + }, + "WaypointIndex":{"type":"integer"}, + "WaypointOptimizationAccessHours":{ + "type":"structure", + "required":[ + "From", + "To" + ], + "members":{ + "From":{ + "shape":"WaypointOptimizationAccessHoursEntry", + "documentation":"Contains the ID of the starting waypoint in this connection.
" + }, + "To":{ + "shape":"WaypointOptimizationAccessHoursEntry", + "documentation":"Contains the ID of the ending waypoint in this connection.
" + } + }, + "documentation":"Access hours corresponding to when a destination can be visited.
" + }, + "WaypointOptimizationAccessHoursEntry":{ + "type":"structure", + "required":[ + "DayOfWeek", + "TimeOfDay" + ], + "members":{ + "DayOfWeek":{ + "shape":"DayOfWeek", + "documentation":"Day of the week.
" + }, + "TimeOfDay":{ + "shape":"TimeOfDay", + "documentation":"Time of the day.
" + } + }, + "documentation":"Hours of entry.
" + }, + "WaypointOptimizationAvoidanceArea":{ + "type":"structure", + "required":["Geometry"], + "members":{ + "Geometry":{ + "shape":"WaypointOptimizationAvoidanceAreaGeometry", + "documentation":"Geometry of the area to be avoided.
" + } + }, + "documentation":"The area to be avoided.
" + }, + "WaypointOptimizationAvoidanceAreaGeometry":{ + "type":"structure", + "members":{ + "BoundingBox":{ + "shape":"BoundingBox", + "documentation":"Geometry defined as a bounding box. The first pair represents the X and Y coordinates (longitude and latitude,) of the southwest corner of the bounding box; the second pair represents the X and Y coordinates (longitude and latitude) of the northeast corner.
" + } + }, + "documentation":"Geometry of the area to be avoided.
" + }, + "WaypointOptimizationAvoidanceOptions":{ + "type":"structure", + "members":{ + "Areas":{ + "shape":"WaypointOptimizationAvoidanceOptionsAreasList", + "documentation":"Areas to be avoided.
" + }, + "CarShuttleTrains":{ + "shape":"Boolean", + "documentation":"Avoidance options for cars-shuttles-trains.
" + }, + "ControlledAccessHighways":{ + "shape":"Boolean", + "documentation":"Avoid controlled access highways while calculating the route.
" + }, + "DirtRoads":{ + "shape":"Boolean", + "documentation":"Avoid dirt roads while calculating the route.
" + }, + "Ferries":{ + "shape":"Boolean", + "documentation":"Avoidance options for ferries.
" + }, + "TollRoads":{ + "shape":"Boolean", + "documentation":"Avoids roads where the specified toll transponders are the only mode of payment.
" + }, + "Tunnels":{ + "shape":"Boolean", + "documentation":"Avoid tunnels while calculating the route.
" + }, + "UTurns":{ + "shape":"Boolean", + "documentation":"Avoid U-turns for calculation on highways and motorways.
" + } + }, + "documentation":"Options for WaypointOptimizationAvoidance.
" + }, + "WaypointOptimizationAvoidanceOptionsAreasList":{ + "type":"list", + "member":{"shape":"WaypointOptimizationAvoidanceArea"}, + "max":20, + "min":0 + }, + "WaypointOptimizationConnection":{ + "type":"structure", + "required":[ + "Distance", + "From", + "RestDuration", + "To", + "TravelDuration", + "WaitDuration" + ], + "members":{ + "Distance":{ + "shape":"DistanceMeters", + "documentation":"Distance of the step.
" + }, + "From":{ + "shape":"WaypointId", + "documentation":"contains the ID of the starting waypoint in this connection.
" + }, + "RestDuration":{ + "shape":"DurationSeconds", + "documentation":"Resting time before the driver can continue driving.
" + }, + "To":{ + "shape":"WaypointId", + "documentation":"Contains the ID of the ending waypoint in this connection.
" + }, + "TravelDuration":{ + "shape":"DurationSeconds", + "documentation":"Total duration.
Unit: seconds
Duration of a wait step.
Unit: seconds
This contains information such as distance and duration from one waypoint to the next waypoint in the sequence.
" + }, + "WaypointOptimizationConnectionList":{ + "type":"list", + "member":{"shape":"WaypointOptimizationConnection"} + }, + "WaypointOptimizationConstraint":{ + "type":"string", + "enum":[ + "AccessHours", + "AppointmentTime", + "Before", + "Heading", + "ServiceDuration", + "SideOfStreet" + ] + }, + "WaypointOptimizationDestinationOptions":{ + "type":"structure", + "members":{ + "AccessHours":{ + "shape":"WaypointOptimizationAccessHours", + "documentation":"Access hours corresponding to when a waypoint can be visited.
" + }, + "AppointmentTime":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"Appointment time at the destination.
" + }, + "Heading":{ + "shape":"Heading", + "documentation":"GPS Heading at the position.
" + }, + "Id":{ + "shape":"WaypointId", + "documentation":"The waypoint Id.
" + }, + "ServiceDuration":{ + "shape":"DurationSeconds", + "documentation":"Service time spent at the destination. At an appointment, the service time should be the appointment duration.
Unit: seconds
Options to configure matching the provided position to a side of the street.
" + } + }, + "documentation":"Destination related options.
" + }, + "WaypointOptimizationDriverOptions":{ + "type":"structure", + "members":{ + "RestCycles":{ + "shape":"WaypointOptimizationRestCycles", + "documentation":"Driver work-rest schedules defined by a short and long cycle. A rest needs to be taken after the short work duration. The short cycle can be repeated until you hit the long work duration, at which point the long rest duration should be taken before restarting.
" + }, + "RestProfile":{ + "shape":"WaypointOptimizationRestProfile", + "documentation":"Pre defined rest profiles for a driver schedule. The only currently supported profile is EU.
" + }, + "TreatServiceTimeAs":{ + "shape":"WaypointOptimizationServiceTimeTreatment", + "documentation":"If the service time provided at a waypoint/destination should be considered as rest or work. This contributes to the total time breakdown returned within the response.
" + } + }, + "documentation":"Driver related options.
" + }, + "WaypointOptimizationExclusionOptions":{ + "type":"structure", + "required":["Countries"], + "members":{ + "Countries":{ + "shape":"CountryCodeList", + "documentation":"List of countries to be avoided defined by two-letter or three-letter country codes.
" + } + }, + "documentation":"Exclusion options.
" + }, + "WaypointOptimizationFailedConstraint":{ + "type":"structure", + "members":{ + "Constraint":{ + "shape":"WaypointOptimizationConstraint", + "documentation":"The failed constraint.
" + }, + "Reason":{ + "shape":"String", + "documentation":"Reason for the failed constraint.
" + } + }, + "documentation":"The failed constraint.
" + }, + "WaypointOptimizationFailedConstraintList":{ + "type":"list", + "member":{"shape":"WaypointOptimizationFailedConstraint"} + }, + "WaypointOptimizationHazardousCargoType":{ + "type":"string", + "enum":[ + "Combustible", + "Corrosive", + "Explosive", + "Flammable", + "Gas", + "HarmfulToWater", + "Organic", + "Other", + "Poison", + "PoisonousInhalation", + "Radioactive" + ] + }, + "WaypointOptimizationHazardousCargoTypeList":{ + "type":"list", + "member":{"shape":"WaypointOptimizationHazardousCargoType"} + }, + "WaypointOptimizationImpedingWaypoint":{ + "type":"structure", + "required":[ + "FailedConstraints", + "Id", + "Position" + ], + "members":{ + "FailedConstraints":{ + "shape":"WaypointOptimizationFailedConstraintList", + "documentation":"Failed constraints for an impeding waypoint.
" + }, + "Id":{ + "shape":"WaypointId", + "documentation":"The waypoint Id.
" + }, + "Position":{ + "shape":"Position", + "documentation":"Position defined as [longitude, latitude].
The impeding waypoint.
" + }, + "WaypointOptimizationImpedingWaypointList":{ + "type":"list", + "member":{"shape":"WaypointOptimizationImpedingWaypoint"} + }, + "WaypointOptimizationOptimizedWaypoint":{ + "type":"structure", + "required":[ + "DepartureTime", + "Id", + "Position" + ], + "members":{ + "ArrivalTime":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"Estimated time of arrival at the destination.
Time format:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Examples:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
Estimated time of departure from thr origin.
Time format:YYYY-MM-DDThh:mm:ss.sssZ | YYYY-MM-DDThh:mm:ss.sss+hh:mm
Examples:
2020-04-22T17:57:24Z
2020-04-22T17:57:24+02:00
The waypoint Id.
" + }, + "Position":{ + "shape":"Position", + "documentation":"Position defined as [longitude, latitude].
The optimized waypoint.
" + }, + "WaypointOptimizationOptimizedWaypointList":{ + "type":"list", + "member":{"shape":"WaypointOptimizationOptimizedWaypoint"} + }, + "WaypointOptimizationOriginOptions":{ + "type":"structure", + "members":{ + "Id":{ + "shape":"WaypointId", + "documentation":"The Origin Id.
" + } + }, + "documentation":"Options related to the origin.
" + }, + "WaypointOptimizationPedestrianOptions":{ + "type":"structure", + "members":{ + "Speed":{ + "shape":"WaypointOptimizationPedestrianOptionsSpeedDouble", + "documentation":"Walking speed.
Unit: KilometersPerHour
Options related to a pedestrian.
" + }, + "WaypointOptimizationPedestrianOptionsSpeedDouble":{ + "type":"double", + "max":7.2, + "min":1.8 + }, + "WaypointOptimizationRestCycleDurations":{ + "type":"structure", + "required":[ + "RestDuration", + "WorkDuration" + ], + "members":{ + "RestDuration":{ + "shape":"DurationSeconds", + "documentation":"Resting phase of the cycle.
Unit: seconds
Working phase of the cycle.
Unit: seconds
Driver work-rest schedules defined by a short and long cycle. A rest needs to be taken after the short work duration. The short cycle can be repeated until you hit the long work duration, at which point the long rest duration should be taken before restarting.
Unit: seconds
Long cycle for a driver work-rest schedule.
" + }, + "ShortCycle":{ + "shape":"WaypointOptimizationRestCycleDurations", + "documentation":"Short cycle for a driver work-rest schedule
" + } + }, + "documentation":"Resting phase of the cycle.
" + }, + "WaypointOptimizationRestProfile":{ + "type":"structure", + "required":["Profile"], + "members":{ + "Profile":{ + "shape":"WaypointOptimizationRestProfileProfileString", + "documentation":"Pre defined rest profiles for a driver schedule. The only currently supported profile is EU.
" + } + }, + "documentation":"Pre defined rest profiles for a driver schedule. The only currently supported profile is EU.
" + }, + "WaypointOptimizationRestProfileProfileString":{ + "type":"string", + "max":2, + "min":2 + }, + "WaypointOptimizationSequencingObjective":{ + "type":"string", + "enum":[ + "FastestRoute", + "ShortestRoute" + ] + }, + "WaypointOptimizationServiceTimeTreatment":{ + "type":"string", + "enum":[ + "Rest", + "Work" + ] + }, + "WaypointOptimizationSideOfStreetOptions":{ + "type":"structure", + "required":["Position"], + "members":{ + "Position":{ + "shape":"Position", + "documentation":"Position defined as [longitude, latitude].
Strategy that defines when the side of street position should be used. AnyStreet will always use the provided position.
Default Value: DividedStreetOnly
Options to configure matching the provided position to a side of the street.
" + }, + "WaypointOptimizationTimeBreakdown":{ + "type":"structure", + "required":[ + "RestDuration", + "ServiceDuration", + "TravelDuration", + "WaitDuration" + ], + "members":{ + "RestDuration":{ + "shape":"DurationSeconds", + "documentation":"Resting phase of the cycle.
Unit: seconds
Service time spent at the destination. At an appointment, the service time should be the appointment duration.
Unit: seconds
Traveling phase of the cycle.
Unit: seconds
Waiting phase of the cycle.
Unit: seconds
Time breakdown for the sequence.
" + }, + "WaypointOptimizationTrafficOptions":{ + "type":"structure", + "members":{ + "Usage":{ + "shape":"TrafficUsage", + "documentation":"Determines if traffic should be used or ignored while calculating the route.
Default Value: UseTrafficData
Options related to traffic.
" + }, + "WaypointOptimizationTrailerOptions":{ + "type":"structure", + "members":{ + "TrailerCount":{ + "shape":"WaypointOptimizationTrailerOptionsTrailerCountInteger", + "documentation":"Number of trailers attached to the vehicle.
Default Value: 0
Trailer options corresponding to the vehicle.
" + }, + "WaypointOptimizationTrailerOptionsTrailerCountInteger":{ + "type":"integer", + "box":true, + "max":255, + "min":0 + }, + "WaypointOptimizationTravelMode":{ + "type":"string", + "enum":[ + "Car", + "Pedestrian", + "Scooter", + "Truck" + ] + }, + "WaypointOptimizationTravelModeOptions":{ + "type":"structure", + "members":{ + "Pedestrian":{ + "shape":"WaypointOptimizationPedestrianOptions", + "documentation":"Travel mode options when the provided travel mode is \"Pedestrian\"
" + }, + "Truck":{ + "shape":"WaypointOptimizationTruckOptions", + "documentation":"Travel mode options when the provided travel mode is \"Truck\"
" + } + }, + "documentation":"Travel mode related options for the provided travel mode.
" + }, + "WaypointOptimizationTruckOptions":{ + "type":"structure", + "members":{ + "GrossWeight":{ + "shape":"WeightKilograms", + "documentation":"Gross weight of the vehicle including trailers, and goods at capacity.
Unit: Kilograms
List of Hazardous cargo contained in the vehicle.
" + }, + "Height":{ + "shape":"WaypointOptimizationTruckOptionsHeightLong", + "documentation":"Height of the vehicle.
Unit: centimeters
Length of the vehicle.
Unit: centimeters
Trailer options corresponding to the vehicle.
" + }, + "TruckType":{ + "shape":"WaypointOptimizationTruckType", + "documentation":"Type of the truck.
" + }, + "TunnelRestrictionCode":{ + "shape":"TunnelRestrictionCode", + "documentation":"The tunnel restriction code.
Tunnel categories in this list indicate the restrictions which apply to certain tunnels in Great Britain. They relate to the types of dangerous goods that can be transported through them.
Tunnel Category B
Risk Level: Limited risk
Restrictions: Few restrictions
Tunnel Category C
Risk Level: Medium risk
Restrictions: Some restrictions
Tunnel Category D
Risk Level: High risk
Restrictions: Many restrictions occur
Tunnel Category E
Risk Level: Very high risk
Restrictions: Restricted tunnel
Heaviest weight per axle irrespective of the axle type or the axle group. Meant for usage in countries where the differences in axle types or axle groups are not distinguished.
Unit: Kilograms
Width of the vehicle.
Unit: centimeters
Travel mode options when the provided travel mode is \"Truck\"
" + }, + "WaypointOptimizationTruckOptionsHeightLong":{ + "type":"long", + "max":5000, + "min":0 + }, + "WaypointOptimizationTruckOptionsLengthLong":{ + "type":"long", + "max":30000, + "min":0 + }, + "WaypointOptimizationTruckOptionsWidthLong":{ + "type":"long", + "max":5000, + "min":0 + }, + "WaypointOptimizationTruckType":{ + "type":"string", + "enum":[ + "StraightTruck", + "Tractor" + ] + }, + "WaypointOptimizationWaypoint":{ + "type":"structure", + "required":["Position"], + "members":{ + "AccessHours":{ + "shape":"WaypointOptimizationAccessHours", + "documentation":"Access hours corresponding to when a waypoint can be visited.
" + }, + "AppointmentTime":{ + "shape":"TimestampWithTimezoneOffset", + "documentation":"Appointment time at the waypoint.
" + }, + "Before":{ + "shape":"BeforeWaypointsList", + "documentation":"Constraint defining what waypoints are to be visited after this waypoint.
" + }, + "Heading":{ + "shape":"Heading", + "documentation":"GPS Heading at the position.
" + }, + "Id":{ + "shape":"WaypointId", + "documentation":"The waypoint Id.
" + }, + "Position":{ + "shape":"Position", + "documentation":"Position defined as [longitude, latitude].
Service time spent at the waypoint. At an appointment, the service time should be the appointment duration.
Unit: seconds
Options to configure matching the provided position to a side of the street.
" + } + }, + "documentation":"Waypoint between the Origin and Destination.
" + }, + "WaypointOptimizationWaypointList":{ + "type":"list", + "member":{"shape":"WaypointOptimizationWaypoint"} + }, + "WeightKilograms":{ + "type":"long", + "max":4294967295, + "min":0 + }, + "WeightPerAxleGroup":{ + "type":"structure", + "members":{ + "Single":{ + "shape":"WeightKilograms", + "documentation":"Weight for single axle group.
Unit: Kilograms
Weight for tandem axle group.
Unit: Kilograms
Weight for triple axle group.
Unit: Kilograms
Weight for quad axle group.
Unit: Kilograms
Weight for quad quint group.
Unit: Kilograms
Specifies the total weight for the specified axle group. Meant for usage in countries that have different regulations based on the axle group type.
Unit: Kilograms
With the Amazon Location Routes API you can calculate routes and estimate travel time based on up-to-date road network and live traffic information.
Calculate optimal travel routes and estimate travel times using up-to-date road network and traffic data. Key features include:
Point-to-point routing with estimated travel time, distance, and turn-by-turn directions
Multi-point route optimization to minimize travel time or distance
Route matrices for efficient multi-destination planning
Isoline calculations to determine reachable areas within specified time or distance thresholds
Map-matching to align GPS traces with the road network
Creates a URL for a specified UserProfile in a Domain. When accessed in a web browser, the user will be automatically signed in to the domain, and granted access to all of the Apps and files associated with the Domain's Amazon Elastic File System volume. This operation can only be called when the authentication mode equals IAM.
The IAM role or user passed to this API defines the permissions to access the app. Once the presigned URL is created, no additional permission is required to access this URL. IAM authorization policies for this API are also enforced for every HTTP request and WebSocket frame that attempts to connect to the app.
You can restrict access to this API and to the URL that it returns to a list of IP addresses, Amazon VPCs or Amazon VPC Endpoints that you specify. For more information, see Connect to Amazon SageMaker Studio Through an Interface VPC Endpoint .
The URL that you get from a call to CreatePresignedDomainUrl has a default timeout of 5 minutes. You can configure this value using ExpiresInSeconds. If you try to use the URL after the timeout limit expires, you are directed to the Amazon Web Services console sign-in page.
Creates a URL for a specified UserProfile in a Domain. When accessed in a web browser, the user will be automatically signed in to the domain, and granted access to all of the Apps and files associated with the Domain's Amazon Elastic File System volume. This operation can only be called when the authentication mode equals IAM.
The IAM role or user passed to this API defines the permissions to access the app. Once the presigned URL is created, no additional permission is required to access this URL. IAM authorization policies for this API are also enforced for every HTTP request and WebSocket frame that attempts to connect to the app.
You can restrict access to this API and to the URL that it returns to a list of IP addresses, Amazon VPCs or Amazon VPC Endpoints that you specify. For more information, see Connect to Amazon SageMaker Studio Through an Interface VPC Endpoint .
The URL that you get from a call to CreatePresignedDomainUrl has a default timeout of 5 minutes. You can configure this value using ExpiresInSeconds. If you try to use the URL after the timeout limit expires, you are directed to the Amazon Web Services console sign-in page.
The JupyterLab session default expiration time is 12 hours. You can configure this value using SessionExpirationDurationInSeconds.
The model card associated with the model package. Since ModelPackageModelCard is tied to a model package, it is a specific usage of a model card and its schema is simplified compared to the schema of ModelCard. The ModelPackageModelCard schema does not include model_package_details, and model_overview is composed of the model_creator and model_artifact properties. For more information about the model package model card schema, see Model package model card schema. For more information about the model card associated with the model package, see View the Details of a Model Version.
A structure describing the current state of the model in its life cycle.
" } } }, @@ -15724,6 +15728,10 @@ "ModelCard":{ "shape":"ModelPackageModelCard", "documentation":"The model card associated with the model package. Since ModelPackageModelCard is tied to a model package, it is a specific usage of a model card and its schema is simplified compared to the schema of ModelCard. The ModelPackageModelCard schema does not include model_package_details, and model_overview is composed of the model_creator and model_artifact properties. For more information about the model package model card schema, see Model package model card schema. For more information about the model card associated with the model package, see View the Details of a Model Version.
A structure describing the current state of the model in its life cycle.
" } } }, @@ -28104,6 +28112,28 @@ "max":1, "min":1 }, + "ModelLifeCycle":{ + "type":"structure", + "required":[ + "Stage", + "StageStatus" + ], + "members":{ + "Stage":{ + "shape":"EntityName", + "documentation":"The current stage in the model life cycle.
" + }, + "StageStatus":{ + "shape":"EntityName", + "documentation":"The current status of a stage in model life cycle.
" + }, + "StageDescription":{ + "shape":"StageDescription", + "documentation":"Describes the stage related details.
" + } + }, + "documentation":"A structure describing the current state of the model in its life cycle.
" + }, "ModelMetadataFilter":{ "type":"structure", "required":[ @@ -28317,6 +28347,10 @@ }, "SecurityConfig":{"shape":"ModelPackageSecurityConfig"}, "ModelCard":{"shape":"ModelPackageModelCard"}, + "ModelLifeCycle":{ + "shape":"ModelLifeCycle", + "documentation":"A structure describing the current state of the model in its life cycle.
" + }, "Tags":{ "shape":"TagList", "documentation":"A list of the tags associated with the model package. For more information, see Tagging Amazon Web Services resources in the Amazon Web Services General Reference Guide.
" @@ -35034,6 +35068,12 @@ "TFRecord" ] }, + "StageDescription":{ + "type":"string", + "max":1024, + "min":0, + "pattern":"^.{0,1024}$" + }, "StageStatus":{ "type":"string", "enum":[ @@ -36467,7 +36507,6 @@ "ml.p4de.24xlarge", "ml.p5.48xlarge", "ml.p5e.48xlarge", - "ml.p5en.48xlarge", "ml.c5.xlarge", "ml.c5.2xlarge", "ml.c5.4xlarge", @@ -36489,7 +36528,6 @@ "ml.trn1.2xlarge", "ml.trn1.32xlarge", "ml.trn1n.32xlarge", - "ml.trn2.48xlarge", "ml.m6i.large", "ml.m6i.xlarge", "ml.m6i.2xlarge", @@ -38659,6 +38697,14 @@ "ModelCard":{ "shape":"ModelPackageModelCard", "documentation":"The model card associated with the model package. Since ModelPackageModelCard is tied to a model package, it is a specific usage of a model card and its schema is simplified compared to the schema of ModelCard. The ModelPackageModelCard schema does not include model_package_details, and model_overview is composed of the model_creator and model_artifact properties. For more information about the model package model card schema, see Model package model card schema. For more information about the model card associated with the model package, see View the Details of a Model Version.
A structure describing the current state of the model in its life cycle.
" + }, + "ClientToken":{ + "shape":"ClientToken", + "documentation":"A unique token that guarantees that the call to this API is idempotent.
" } } }, @@ -39452,7 +39498,7 @@ "type":"string", "max":176, "min":1, - "pattern":"(arn:aws[a-z\\-]*:sagemaker:[a-z0-9\\-]*:[0-9]{12}:[a-z\\-]*\\/)?([a-zA-Z0-9]([a-zA-Z0-9-]){0,62})(? Date: Wed, 30 Oct 2024 18:14:33 +0000 Subject: [PATCH 17/21] OpenSearch Service Serverless Update: Neo Integration via IAM Identity Center (IdC) --- ...e-OpenSearchServiceServerless-5750d88.json | 6 + .../codegen-resources/service-2.json | 107 +++++++++++++++++- 2 files changed, 112 insertions(+), 1 deletion(-) create mode 100644 .changes/next-release/feature-OpenSearchServiceServerless-5750d88.json diff --git a/.changes/next-release/feature-OpenSearchServiceServerless-5750d88.json b/.changes/next-release/feature-OpenSearchServiceServerless-5750d88.json new file mode 100644 index 000000000000..afce894bac57 --- /dev/null +++ b/.changes/next-release/feature-OpenSearchServiceServerless-5750d88.json @@ -0,0 +1,6 @@ +{ + "type": "feature", + "category": "OpenSearch Service Serverless", + "contributor": "", + "description": "Neo Integration via IAM Identity Center (IdC)" +} diff --git a/services/opensearchserverless/src/main/resources/codegen-resources/service-2.json b/services/opensearchserverless/src/main/resources/codegen-resources/service-2.json index 9d705d7c7bb1..1cfc970ee354 100644 --- a/services/opensearchserverless/src/main/resources/codegen-resources/service-2.json +++ b/services/opensearchserverless/src/main/resources/codegen-resources/service-2.json @@ -1133,6 +1133,25 @@ } } }, + "CreateIamIdentityCenterConfigOptions":{ + "type":"structure", + "required":["instanceArn"], + "members":{ + "groupAttribute":{ + "shape":"IamIdentityCenterGroupAttribute", + "documentation":"The group attribute for this IAM Identity Center integration. Defaults to GroupId.
The ARN of the IAM Identity Center instance used to integrate with OpenSearch Serverless.
" + }, + "userAttribute":{ + "shape":"IamIdentityCenterUserAttribute", + "documentation":"The user attribute for this IAM Identity Center integration. Defaults to UserId.
Describes IAM Identity Center options for creating an OpenSearch Serverless security configuration in the form of a key-value map.
" + }, "CreateLifecyclePolicyRequest":{ "type":"structure", "required":[ @@ -1189,6 +1208,10 @@ "shape":"ConfigDescription", "documentation":"A description of the security configuration.
" }, + "iamIdentityCenterOptions":{ + "shape":"CreateIamIdentityCenterConfigOptions", + "documentation":"Describes IAM Identity Center options in the form of a key-value map. This field is required if you specify iamidentitycenter for the type parameter.
" + }, "name":{ "shape":"ConfigName", "documentation":"The name of the security configuration.
" @@ -1676,6 +1699,63 @@ } } }, + "IamIdentityCenterApplicationArn":{ + "type":"string", + "max":1224, + "min":10, + "pattern":"^arn:(aws|aws-us-gov|aws-cn|aws-iso|aws-iso-b):sso::\\d{12}:application/(sso)?ins-[a-zA-Z0-9-.]{16}/apl-[a-zA-Z0-9]{16}$" + }, + "IamIdentityCenterConfigOptions":{ + "type":"structure", + "members":{ + "applicationArn":{ + "shape":"IamIdentityCenterApplicationArn", + "documentation":"The ARN of the IAM Identity Center application used to integrate with OpenSearch Serverless.
" + }, + "applicationDescription":{ + "shape":"String", + "documentation":"The description of the IAM Identity Center application used to integrate with OpenSearch Serverless.
" + }, + "applicationName":{ + "shape":"String", + "documentation":"The name of the IAM Identity Center application used to integrate with OpenSearch Serverless.
" + }, + "groupAttribute":{ + "shape":"IamIdentityCenterGroupAttribute", + "documentation":"The group attribute for this IAM Identity Center integration. Defaults to GroupId.
The ARN of the IAM Identity Center instance used to integrate with OpenSearch Serverless.
" + }, + "userAttribute":{ + "shape":"IamIdentityCenterUserAttribute", + "documentation":"The user attribute for this IAM Identity Center integration. Defaults to UserId
Describes IAM Identity Center options for an OpenSearch Serverless security configuration in the form of a key-value map.
" + }, + "IamIdentityCenterGroupAttribute":{ + "type":"string", + "enum":[ + "GroupId", + "GroupName" + ] + }, + "IamIdentityCenterInstanceArn":{ + "type":"string", + "max":1224, + "min":10, + "pattern":"^arn:(aws|aws-us-gov|aws-cn|aws-iso|aws-iso-b):sso:::instance/(sso)?ins-[a-zA-Z0-9-.]{16}$" + }, + "IamIdentityCenterUserAttribute":{ + "type":"string", + "enum":[ + "UserId", + "UserName", + "Email" + ] + }, "IndexingCapacityValue":{ "type":"integer", "box":true, @@ -2225,6 +2305,10 @@ "shape":"ConfigDescription", "documentation":"The description of the security configuration.
" }, + "iamIdentityCenterOptions":{ + "shape":"IamIdentityCenterConfigOptions", + "documentation":"Describes IAM Identity Center options in the form of a key-value map.
" + }, "id":{ "shape":"SecurityConfigId", "documentation":"The unique identifier of the security configuration.
" @@ -2295,7 +2379,10 @@ }, "SecurityConfigType":{ "type":"string", - "enum":["saml"] + "enum":[ + "saml", + "iamidentitycenter" + ] }, "SecurityGroupId":{ "type":"string", @@ -2663,6 +2750,20 @@ } } }, + "UpdateIamIdentityCenterConfigOptions":{ + "type":"structure", + "members":{ + "groupAttribute":{ + "shape":"IamIdentityCenterGroupAttribute", + "documentation":"The group attribute for this IAM Identity Center integration. Defaults to GroupId.
The user attribute for this IAM Identity Center integration. Defaults to UserId.
Describes IAM Identity Center options for updating an OpenSearch Serverless security configuration in the form of a key-value map.
" + }, "UpdateLifecyclePolicyRequest":{ "type":"structure", "required":[ @@ -2727,6 +2828,10 @@ "shape":"ConfigDescription", "documentation":"A description of the security configuration.
" }, + "iamIdentityCenterOptionsUpdates":{ + "shape":"UpdateIamIdentityCenterConfigOptions", + "documentation":"Describes IAM Identity Center options in the form of a key-value map.
" + }, "id":{ "shape":"SecurityConfigId", "documentation":"The security configuration identifier. For SAML the ID will be saml/<accountId>/<idpProviderName>. For example, saml/123456789123/OKTADev.
The number of seconds that can pass without any TCP traffic sent through the firewall before the firewall determines that the connection is idle. After the idle timeout passes, data packets are dropped, however, the next TCP SYN packet is considered a new flow and is processed by the firewall. Clients or targets can use TCP keepalive packets to reset the idle timeout.
You can define the TcpIdleTimeoutSeconds value to be between 60 and 6000 seconds. If no value is provided, it defaults to 350 seconds.
Describes the amount of time that can pass without any traffic sent through the firewall before the firewall determines that the connection is idle and Network Firewall removes the flow entry from its flow table. Existing connections and flows are not impacted when you update this value. Only new connections after you update this value are impacted.
" + }, "GeneratedRulesType":{ "type":"string", "enum":[ @@ -2837,6 +2847,10 @@ "StreamExceptionPolicy":{ "shape":"StreamExceptionPolicy", "documentation":"Configures how Network Firewall processes traffic when a network connection breaks midstream. Network connections can break due to disruptions in external networks or within the firewall itself.
DROP - Network Firewall fails closed and drops all subsequent traffic going to the firewall. This is the default behavior.
CONTINUE - Network Firewall continues to apply rules to the subsequent traffic without context from traffic before the break. This impacts the behavior of rules that depend on this context. For example, if you have a stateful rule to drop http traffic, Network Firewall won't match the traffic for this rule because the service won't have the context from session initialization defining the application layer protocol as HTTP. However, this behavior is rule dependent—a TCP-layer rule using a flow:stateless rule would still match, as would the aws:drop_strict default action.
REJECT - Network Firewall fails closed and drops all subsequent traffic going to the firewall. Network Firewall also sends a TCP reject packet back to your client so that the client can immediately establish a new session. Network Firewall will have context about the new session and will apply rules to the subsequent traffic.
Configures the amount of time that can pass without any traffic sent through the firewall before the firewall determines that the connection is idle.
" } }, "documentation":"Configuration settings for the handling of the stateful rule groups in a firewall policy.
" @@ -3256,6 +3270,7 @@ "type":"list", "member":{"shape":"TargetType"} }, + "TcpIdleTimeoutRangeBound":{"type":"integer"}, "ThrottlingException":{ "type":"structure", "members":{ @@ -3751,5 +3766,5 @@ "member":{"shape":"VpcId"} } }, - "documentation":"This is the API Reference for Network Firewall. This guide is for developers who need detailed information about the Network Firewall API actions, data types, and errors.
The REST API requires you to handle connection details, such as calculating signatures, handling request retries, and error handling. For general information about using the Amazon Web Services REST APIs, see Amazon Web Services APIs.
To access Network Firewall using the REST API endpoint: https://network-firewall.<region>.amazonaws.com
Alternatively, you can use one of the Amazon Web Services SDKs to access an API that's tailored to the programming language or platform that you're using. For more information, see Amazon Web Services SDKs.
For descriptions of Network Firewall features, including and step-by-step instructions on how to use them through the Network Firewall console, see the Network Firewall Developer Guide.
Network Firewall is a stateful, managed, network firewall and intrusion detection and prevention service for Amazon Virtual Private Cloud (Amazon VPC). With Network Firewall, you can filter traffic at the perimeter of your VPC. This includes filtering traffic going to and coming from an internet gateway, NAT gateway, or over VPN or Direct Connect. Network Firewall uses rules that are compatible with Suricata, a free, open source network analysis and threat detection engine. Network Firewall supports Suricata version 6.0.9. For information about Suricata, see the Suricata website.
You can use Network Firewall to monitor and protect your VPC traffic in a number of ways. The following are just a few examples:
Allow domains or IP addresses for known Amazon Web Services service endpoints, such as Amazon S3, and block all other forms of traffic.
Use custom lists of known bad domains to limit the types of domain names that your applications can access.
Perform deep packet inspection on traffic entering or leaving your VPC.
Use stateful protocol detection to filter protocols like HTTPS, regardless of the port used.
To enable Network Firewall for your VPCs, you perform steps in both Amazon VPC and in Network Firewall. For information about using Amazon VPC, see Amazon VPC User Guide.
To start using Network Firewall, do the following:
(Optional) If you don't already have a VPC that you want to protect, create it in Amazon VPC.
In Amazon VPC, in each Availability Zone where you want to have a firewall endpoint, create a subnet for the sole use of Network Firewall.
In Network Firewall, create stateless and stateful rule groups, to define the components of the network traffic filtering behavior that you want your firewall to have.
In Network Firewall, create a firewall policy that uses your rule groups and specifies additional default traffic filtering behavior.
In Network Firewall, create a firewall and specify your new firewall policy and VPC subnets. Network Firewall creates a firewall endpoint in each subnet that you specify, with the behavior that's defined in the firewall policy.
In Amazon VPC, use ingress routing enhancements to route traffic through the new firewall endpoints.
This is the API Reference for Network Firewall. This guide is for developers who need detailed information about the Network Firewall API actions, data types, and errors.
The REST API requires you to handle connection details, such as calculating signatures, handling request retries, and error handling. For general information about using the Amazon Web Services REST APIs, see Amazon Web Services APIs.
To access Network Firewall using the REST API endpoint: https://network-firewall.<region>.amazonaws.com
Alternatively, you can use one of the Amazon Web Services SDKs to access an API that's tailored to the programming language or platform that you're using. For more information, see Amazon Web Services SDKs.
For descriptions of Network Firewall features, including and step-by-step instructions on how to use them through the Network Firewall console, see the Network Firewall Developer Guide.
Network Firewall is a stateful, managed, network firewall and intrusion detection and prevention service for Amazon Virtual Private Cloud (Amazon VPC). With Network Firewall, you can filter traffic at the perimeter of your VPC. This includes filtering traffic going to and coming from an internet gateway, NAT gateway, or over VPN or Direct Connect. Network Firewall uses rules that are compatible with Suricata, a free, open source network analysis and threat detection engine.
You can use Network Firewall to monitor and protect your VPC traffic in a number of ways. The following are just a few examples:
Allow domains or IP addresses for known Amazon Web Services service endpoints, such as Amazon S3, and block all other forms of traffic.
Use custom lists of known bad domains to limit the types of domain names that your applications can access.
Perform deep packet inspection on traffic entering or leaving your VPC.
Use stateful protocol detection to filter protocols like HTTPS, regardless of the port used.
To enable Network Firewall for your VPCs, you perform steps in both Amazon VPC and in Network Firewall. For information about using Amazon VPC, see Amazon VPC User Guide.
To start using Network Firewall, do the following:
(Optional) If you don't already have a VPC that you want to protect, create it in Amazon VPC.
In Amazon VPC, in each Availability Zone where you want to have a firewall endpoint, create a subnet for the sole use of Network Firewall.
In Network Firewall, create stateless and stateful rule groups, to define the components of the network traffic filtering behavior that you want your firewall to have.
In Network Firewall, create a firewall policy that uses your rule groups and specifies additional default traffic filtering behavior.
In Network Firewall, create a firewall and specify your new firewall policy and VPC subnets. Network Firewall creates a firewall endpoint in each subnet that you specify, with the behavior that's defined in the firewall policy.
In Amazon VPC, use ingress routing enhancements to route traffic through the new firewall endpoints.
Activates an DataSync agent that you've deployed in your storage environment. The activation process associates the agent with your Amazon Web Services account.
If you haven't deployed an agent yet, see the following topics to learn more:
If you're transferring between Amazon Web Services storage services, you don't need a DataSync agent.
Activates an DataSync agent that you deploy in your storage environment. The activation process associates the agent with your Amazon Web Services account.
If you haven't deployed an agent yet, see Do I need a DataSync agent?
" }, "CreateLocationAzureBlob":{ "name":"CreateLocationAzureBlob", @@ -522,7 +523,7 @@ {"shape":"InvalidRequestException"}, {"shape":"InternalException"} ], - "documentation":"Provides information about an execution of your DataSync task. You can use this operation to help monitor the progress of an ongoing transfer or check the results of the transfer.
" + "documentation":"Provides information about an execution of your DataSync task. You can use this operation to help monitor the progress of an ongoing data transfer or check the results of the transfer.
Some DescribeTaskExecution response elements are only relevant to a specific task mode. For information, see Understanding task mode differences and Understanding data transfer performance metrics.
Starts an DataSync transfer task. For each task, you can only run one task execution at a time.
There are several phases to a task execution. For more information, see Task execution statuses.
If you're planning to transfer data to or from an Amazon S3 location, review how DataSync can affect your S3 request charges and the DataSync pricing page before you begin.
Starts an DataSync transfer task. For each task, you can only run one task execution at a time.
There are several steps to a task execution. For more information, see Task execution statuses.
If you're planning to transfer data to or from an Amazon S3 location, review how DataSync can affect your S3 request charges and the DataSync pricing page before you begin.
Specifies your DataSync agent's activation key. If you don't have an activation key, see Activate your agent.
" + "documentation":"Specifies your DataSync agent's activation key. If you don't have an activation key, see Activating your agent.
" }, "AgentName":{ "shape":"TagValue", - "documentation":"Specifies a name for your agent. You can see this name in the DataSync console.
" + "documentation":"Specifies a name for your agent. We recommend specifying a name that you can remember.
" }, "Tags":{ "shape":"InputTagList", @@ -1096,15 +1097,15 @@ }, "VpcEndpointId":{ "shape":"VpcEndpointId", - "documentation":"Specifies the ID of the VPC endpoint that you want your agent to connect to. For example, a VPC endpoint ID looks like vpce-01234d5aff67890e1.
The VPC endpoint you use must include the DataSync service name (for example, com.amazonaws.us-east-2.datasync).
Specifies the ID of the VPC service endpoint that you're using. For example, a VPC endpoint ID looks like vpce-01234d5aff67890e1.
The VPC service endpoint you use must include the DataSync service name (for example, com.amazonaws.us-east-2.datasync).
Specifies the ARN of the subnet where you want to run your DataSync task when using a VPC endpoint. This is the subnet where DataSync creates and manages the network interfaces for your transfer. You can only specify one ARN.
" + "documentation":"Specifies the ARN of the subnet where your VPC service endpoint is located. You can only specify one ARN.
" }, "SecurityGroupArns":{ "shape":"PLSecurityGroupArnList", - "documentation":"Specifies the Amazon Resource Name (ARN) of the security group that protects your task's network interfaces when using a virtual private cloud (VPC) endpoint. You can only specify one ARN.
" + "documentation":"Specifies the Amazon Resource Name (ARN) of the security group that allows traffic between your agent and VPC service endpoint. You can only specify one ARN.
" } }, "documentation":"CreateAgentRequest
" @@ -1179,15 +1180,15 @@ "members":{ "Subdirectory":{ "shape":"EfsSubdirectory", - "documentation":"Specifies a mount path for your Amazon EFS file system. This is where DataSync reads or writes data (depending on if this is a source or destination location). By default, DataSync uses the root directory, but you can also include subdirectories.
You must specify a value with forward slashes (for example, /path/to/folder).
Specifies a mount path for your Amazon EFS file system. This is where DataSync reads or writes data (depending on if this is a source or destination location) on your file system.
By default, DataSync uses the root directory (or access point if you provide one by using AccessPointArn). You can also include subdirectories using forward slashes (for example, /path/to/folder).
Specifies the ARN for the Amazon EFS file system.
" + "documentation":"Specifies the ARN for your Amazon EFS file system.
" }, "Ec2Config":{ "shape":"Ec2Config", - "documentation":"Specifies the subnet and security groups DataSync uses to access your Amazon EFS file system.
" + "documentation":"Specifies the subnet and security groups DataSync uses to connect to one of your Amazon EFS file system's mount targets.
" }, "Tags":{ "shape":"InputTagList", @@ -1195,15 +1196,15 @@ }, "AccessPointArn":{ "shape":"EfsAccessPointArn", - "documentation":"Specifies the Amazon Resource Name (ARN) of the access point that DataSync uses to access the Amazon EFS file system.
" + "documentation":"Specifies the Amazon Resource Name (ARN) of the access point that DataSync uses to mount your Amazon EFS file system.
For more information, see Accessing restricted file systems.
" }, "FileSystemAccessRoleArn":{ "shape":"IamRoleArn", - "documentation":"Specifies an Identity and Access Management (IAM) role that DataSync assumes when mounting the Amazon EFS file system.
" + "documentation":"Specifies an Identity and Access Management (IAM) role that allows DataSync to access your Amazon EFS file system.
For information on creating this role, see Creating a DataSync IAM role for file system access.
" }, "InTransitEncryption":{ "shape":"EfsInTransitEncryption", - "documentation":"Specifies whether you want DataSync to use Transport Layer Security (TLS) 1.2 encryption when it copies data to or from the Amazon EFS file system.
If you specify an access point using AccessPointArn or an IAM role using FileSystemAccessRoleArn, you must set this parameter to TLS1_2.
Specifies whether you want DataSync to use Transport Layer Security (TLS) 1.2 encryption when it transfers data to or from your Amazon EFS file system.
If you specify an access point using AccessPointArn or an IAM role using FileSystemAccessRoleArn, you must set this parameter to TLS1_2.
CreateLocationEfsRequest
" @@ -1346,7 +1347,7 @@ }, "SecurityGroupArns":{ "shape":"Ec2SecurityGroupArnList", - "documentation":"Specifies the ARNs of the security groups that provide access to your file system's preferred subnet.
If you choose a security group that doesn't allow connections from within itself, do one of the following:
Configure the security group to allow it to communicate within itself.
Choose a different security group that can communicate with the mount target's security group.
Specifies the ARNs of the Amazon EC2 security groups that provide access to your file system's preferred subnet.
The security groups that you specify must be able to communicate with your file system's security groups. For information about configuring security groups for file system access, see the Amazon FSx for Windows File Server User Guide .
If you choose a security group that doesn't allow connections from within itself, do one of the following:
Configure the security group to allow it to communicate within itself.
Choose a different security group that can communicate with the mount target's security group.
The Amazon Resource Names (ARNs) of the agents that are used to connect to the HDFS cluster.
" + "documentation":"The Amazon Resource Names (ARNs) of the DataSync agents that can connect to your HDFS cluster.
" }, "Tags":{ "shape":"InputTagList", @@ -1442,7 +1443,7 @@ "members":{ "LocationArn":{ "shape":"LocationArn", - "documentation":"The ARN of the source HDFS cluster location that's created.
" + "documentation":"The ARN of the source HDFS cluster location that you create.
" } } }, @@ -1464,7 +1465,7 @@ }, "OnPremConfig":{ "shape":"OnPremConfig", - "documentation":"Specifies the Amazon Resource Name (ARN) of the DataSync agent that want to connect to your NFS file server.
You can specify more than one agent. For more information, see Using multiple agents for transfers.
" + "documentation":"Specifies the Amazon Resource Name (ARN) of the DataSync agent that can connect to your NFS file server.
You can specify more than one agent. For more information, see Using multiple DataSync agents.
" }, "MountOptions":{ "shape":"NfsMountOptions", @@ -1525,7 +1526,7 @@ }, "AgentArns":{ "shape":"AgentArnList", - "documentation":"Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can securely connect with your location.
" + "documentation":"Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can connect with your object storage system.
" }, "Tags":{ "shape":"InputTagList", @@ -1621,7 +1622,7 @@ }, "AgentArns":{ "shape":"AgentArnList", - "documentation":"Specifies the DataSync agent (or agents) which you want to connect to your SMB file server. You specify an agent by using its Amazon Resource Name (ARN).
" + "documentation":"Specifies the DataSync agent (or agents) that can connect to your SMB file server. You specify an agent by using its Amazon Resource Name (ARN).
" }, "MountOptions":{ "shape":"SmbMountOptions", @@ -1661,7 +1662,7 @@ }, "CloudWatchLogGroupArn":{ "shape":"LogGroupArn", - "documentation":"Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log group for monitoring your task.
" + "documentation":"Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log group for monitoring your task.
For Enhanced mode tasks, you don't need to specify anything. DataSync automatically sends logs to a CloudWatch log group named /aws/datasync.
Specifies include filters define the files, objects, and folders in your source location that you want DataSync to transfer. For more information and examples, see Specifying what DataSync transfers by using filters.
" + "documentation":"Specifies include filters that define the files, objects, and folders in your source location that you want DataSync to transfer. For more information and examples, see Specifying what DataSync transfers by using filters.
" }, "ManifestConfig":{ "shape":"ManifestConfig", @@ -1694,6 +1695,10 @@ "TaskReportConfig":{ "shape":"TaskReportConfig", "documentation":"Specifies how you want to configure a task report, which provides detailed information about your DataSync transfer. For more information, see Monitoring your DataSync transfers with task reports.
When using this parameter, your caller identity (the role that you're using DataSync with) must have the iam:PassRole permission. The AWSDataSyncFullAccess policy includes this permission.
Specifies one of the following task modes for your data transfer:
ENHANCED - Transfer virtually unlimited numbers of objects with enhanced metrics, more detailed logs, and higher performance than Basic mode. Currently available for transfers between Amazon S3 locations.
To create an Enhanced mode task, the IAM role that you use to call the CreateTask operation must have the iam:CreateServiceLinkedRole permission.
BASIC (default) - Transfer files or objects between Amazon Web Services storage and on-premises, edge, or other cloud storage. DataSync quotas apply.
For more information, see Understanding task mode differences.
" } }, "documentation":"CreateTaskRequest
" @@ -1934,15 +1939,15 @@ }, "AccessPointArn":{ "shape":"EfsAccessPointArn", - "documentation":"The ARN of the access point that DataSync uses to access the Amazon EFS file system.
" + "documentation":"The ARN of the access point that DataSync uses to access the Amazon EFS file system.
For more information, see Accessing restricted file systems.
" }, "FileSystemAccessRoleArn":{ "shape":"IamRoleArn", - "documentation":"The Identity and Access Management (IAM) role that DataSync assumes when mounting the Amazon EFS file system.
" + "documentation":"The Identity and Access Management (IAM) role that allows DataSync to access your Amazon EFS file system.
For more information, see Creating a DataSync IAM role for file system access.
" }, "InTransitEncryption":{ "shape":"EfsInTransitEncryption", - "documentation":"Describes whether DataSync uses Transport Layer Security (TLS) encryption when copying data to or from the Amazon EFS file system.
" + "documentation":"Indicates whether DataSync uses Transport Layer Security (TLS) encryption when transferring data to or from the Amazon EFS file system.
" } }, "documentation":"DescribeLocationEfsResponse
" @@ -2076,7 +2081,7 @@ }, "SecurityGroupArns":{ "shape":"Ec2SecurityGroupArnList", - "documentation":"The ARNs of the security groups that are configured for the FSx for Windows File Server file system.
" + "documentation":"The ARNs of the Amazon EC2 security groups that provide access to your file system's preferred subnet.
For information about configuring security groups for file system access, see the Amazon FSx for Windows File Server User Guide .
" }, "CreationTime":{ "shape":"Time", @@ -2514,27 +2519,27 @@ }, "EstimatedFilesToTransfer":{ "shape":"long", - "documentation":"The expected number of files, objects, and directories that DataSync will transfer over the network. This value is calculated during the task execution's PREPARING phase before the TRANSFERRING phase. The calculation is based on comparing the content of the source and destination locations and finding the difference that needs to be transferred.
The number of files, objects, and directories that DataSync expects to transfer over the network. This value is calculated during the task execution's PREPARING step before the TRANSFERRING step.
How this gets calculated depends primarily on your task’s transfer mode configuration:
If TranserMode is set to CHANGED - The calculation is based on comparing the content of the source and destination locations and determining the difference that needs to be transferred. The difference can include:
Anything that's added or modified at the source location.
Anything that's in both locations and modified at the destination after an initial transfer (unless OverwriteMode is set to NEVER).
(Basic task mode only) The number of items that DataSync expects to delete (if PreserveDeletedFiles is set to REMOVE).
If TranserMode is set to ALL - The calculation is based only on the items that DataSync finds at the source location.
The estimated physical number of bytes that will transfer over the network.
" + "documentation":"The number of logical bytes that DataSync expects to write to the destination location.
" }, "FilesTransferred":{ "shape":"long", - "documentation":"The actual number of files, objects, and directories that DataSync transferred over the network. This value is updated periodically during the task execution's TRANSFERRING phase when something is read from the source and sent over the network.
If DataSync fails to transfer something, this value can be less than EstimatedFilesToTransfer. In some cases, this value can also be greater than EstimatedFilesToTransfer. This element is implementation-specific for some location types, so don't use it as an exact indication of what transferred or to monitor your task execution.
The number of files, objects, and directories that DataSync actually transfers over the network. This value is updated periodically during the task execution's TRANSFERRING step when something is read from the source and sent over the network.
If DataSync fails to transfer something, this value can be less than EstimatedFilesToTransfer. In some cases, this value can also be greater than EstimatedFilesToTransfer. This element is implementation-specific for some location types, so don't use it as an exact indication of what's transferring or to monitor your task execution.
The number of logical bytes written to the destination location.
" + "documentation":"The number of logical bytes that DataSync actually writes to the destination location.
" }, "BytesTransferred":{ "shape":"long", - "documentation":"The total number of bytes that are involved in the transfer. For the number of bytes sent over the network, see BytesCompressed.
The number of bytes that DataSync sends to the network before compression (if compression is possible). For the number of bytes transferred over the network, see BytesCompressed.
" }, "BytesCompressed":{ "shape":"long", - "documentation":"The physical number of bytes transferred over the network after compression was applied. In most cases, this number is less than BytesTransferred unless the data isn't compressible.
The number of physical bytes that DataSync transfers over the network after compression (if compression is possible). This number is typically less than BytesTransferred unless the data isn't compressible.
Not currently supported with Enhanced mode tasks.
The number of files, objects, and directories that DataSync deleted in your destination location. If you don't configure your task to delete data in the destination that isn't in the source, the value is always 0.
The number of files, objects, and directories that DataSync actually deletes in your destination location. If you don't configure your task to delete data in the destination that isn't in the source, the value is always 0.
The number of files, objects, and directories that DataSync skipped during your transfer.
" + "documentation":"The number of files, objects, and directories that DataSync skips during your transfer.
" }, "FilesVerified":{ "shape":"long", - "documentation":"The number of files, objects, and directories that DataSync verified during your transfer.
When you configure your task to verify only the data that's transferred, DataSync doesn't verify directories in some situations or files that fail to transfer.
The number of files, objects, and directories that DataSync verifies during your transfer.
When you configure your task to verify only the data that's transferred, DataSync doesn't verify directories in some situations or files that fail to transfer.
The expected number of files, objects, and directories that DataSync will delete in your destination location. If you don't configure your task to delete data in the destination that isn't in the source, the value is always 0.
The number of files, objects, and directories that DataSync expects to delete in your destination location. If you don't configure your task to delete data in the destination that isn't in the source, the value is always 0.
The task mode that you're using. For more information, see Choosing a task mode for your data transfer.
" + }, + "FilesPrepared":{ + "shape":"long", + "documentation":"The number of objects that DataSync will attempt to transfer after comparing your source and destination locations.
Applies only to Enhanced mode tasks.
This metric isn't applicable if you configure your task to transfer all data. In that scenario, DataSync copies everything from the source to the destination without comparing differences between the locations.
" + }, + "FilesListed":{ + "shape":"TaskExecutionFilesListedDetail", + "documentation":"The number of objects that DataSync finds at your locations.
Applies only to Enhanced mode tasks.
The number of objects that DataSync fails to prepare, transfer, verify, and delete during your task execution.
Applies only to Enhanced mode tasks.
DescribeTaskExecutionResponse
" @@ -2607,7 +2628,7 @@ }, "CloudWatchLogGroupArn":{ "shape":"LogGroupArn", - "documentation":"The Amazon Resource Name (ARN) of an Amazon CloudWatch log group for monitoring your task.
For more information, see Monitoring DataSync with Amazon CloudWatch.
" + "documentation":"The Amazon Resource Name (ARN) of an Amazon CloudWatch log group for monitoring your task.
For more information, see Monitoring data transfers with CloudWatch Logs.
" }, "SourceNetworkInterfaceArns":{ "shape":"SourceNetworkInterfaceArns", @@ -2656,6 +2677,10 @@ "ScheduleDetails":{ "shape":"TaskScheduleDetails", "documentation":"The details about your task schedule.
" + }, + "TaskMode":{ + "shape":"TaskMode", + "documentation":"The task mode that you're using. For more information, see Choosing a task mode for your data transfer.
" } }, "documentation":"DescribeTaskResponse
" @@ -2778,7 +2803,7 @@ "documentation":"Specifies the Amazon Resource Names (ARNs) of the security groups associated with an Amazon EFS file system's mount target.
" } }, - "documentation":"The subnet and security groups that DataSync uses to access your Amazon EFS file system.
" + "documentation":"The subnet and security groups that DataSync uses to connect to one of your Amazon EFS file system's mount targets.
" }, "Ec2SecurityGroupArn":{ "type":"string", @@ -3846,10 +3871,10 @@ "members":{ "AgentArns":{ "shape":"AgentArnList", - "documentation":"The Amazon Resource Names (ARNs) of the agents connecting to a transfer location.
" + "documentation":"The Amazon Resource Names (ARNs) of the DataSync agents that can connect to your NFS file server.
You can specify more than one agent. For more information, see Using multiple DataSync agents.
" } }, - "documentation":"The DataSync agents that are connecting to a Network File System (NFS) location.
" + "documentation":"The DataSync agents that can connect to your Network File System (NFS) file server.
" }, "Operator":{ "type":"string", @@ -3871,7 +3896,7 @@ "members":{ "VerifyMode":{ "shape":"VerifyMode", - "documentation":"Specifies how and when DataSync checks the integrity of your data during a transfer.
ONLY_FILES_TRANSFERRED (recommended) - DataSync calculates the checksum of transferred files and metadata at the source location. At the end of the transfer, DataSync then compares this checksum to the checksum calculated on those files at the destination.
We recommend this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
POINT_IN_TIME_CONSISTENT (default) - At the end of the transfer, DataSync scans the entire source and destination to verify that both locations are fully synchronized.
If you use a manifest, DataSync only scans and verifies what's listed in the manifest.
You can't use this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
NONE - DataSync doesn't run additional verification at the end of the transfer. All data transmissions are still integrity-checked with checksum verification during the transfer.
Specifies if and how DataSync checks the integrity of your data at the end of your transfer.
ONLY_FILES_TRANSFERRED (recommended) - DataSync calculates the checksum of transferred data (including metadata) at the source location. At the end of the transfer, DataSync then compares this checksum to the checksum calculated on that data at the destination.
This is the default option for Enhanced mode tasks.
We recommend this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
POINT_IN_TIME_CONSISTENT - At the end of the transfer, DataSync checks the entire source and destination to verify that both locations are fully synchronized.
The is the default option for Basic mode tasks and isn't currently supported with Enhanced mode tasks.
If you use a manifest, DataSync only scans and verifies what's listed in the manifest.
You can't use this option when transferring to S3 Glacier Flexible Retrieval or S3 Glacier Deep Archive storage classes. For more information, see Storage class considerations with Amazon S3 locations.
NONE - DataSync performs data integrity checks only during your transfer. Unlike other options, there's no additional verification at the end of your transfer.
Specifies whether to preserve metadata indicating the last time a file was read or written to.
The behavior of Atime isn't fully standard across platforms, so DataSync can only do this on a best-effort basis.
BEST_EFFORT (default) - DataSync attempts to preserve the original Atime attribute on all source files (that is, the version before the PREPARING phase of the task execution). This option is recommended.
NONE - Ignores Atime.
If Atime is set to BEST_EFFORT, Mtime must be set to PRESERVE.
If Atime is set to NONE, Mtime must also be NONE.
Specifies whether to preserve metadata indicating the last time a file was read or written to.
The behavior of Atime isn't fully standard across platforms, so DataSync can only do this on a best-effort basis.
BEST_EFFORT (default) - DataSync attempts to preserve the original Atime attribute on all source files (that is, the version before the PREPARING steps of the task execution). This option is recommended.
NONE - Ignores Atime.
If Atime is set to BEST_EFFORT, Mtime must be set to PRESERVE.
If Atime is set to NONE, Mtime must also be NONE.
Specifies whether to preserve metadata indicating the last time that a file was written to before the PREPARING phase of your task execution. This option is required when you need to run the a task more than once.
PRESERVE (default) - Preserves original Mtime, which is recommended.
NONE - Ignores Mtime.
If Mtime is set to PRESERVE, Atime must be set to BEST_EFFORT.
If Mtime is set to NONE, Atime must also be set to NONE.
Specifies whether to preserve metadata indicating the last time that a file was written to before the PREPARING step of your task execution. This option is required when you need to run the a task more than once.
PRESERVE (default) - Preserves original Mtime, which is recommended.
NONE - Ignores Mtime.
If Mtime is set to PRESERVE, Atime must be set to BEST_EFFORT.
If Mtime is set to NONE, Atime must also be set to NONE.
Specifies the POSIX group ID (GID) of the file's owners.
INT_VALUE (default) - Preserves the integer value of user ID (UID) and GID, which is recommended.
NONE - Ignores UID and GID.
For more information, see Metadata copied by DataSync.
" + "documentation":"Specifies the POSIX group ID (GID) of the file's owners.
INT_VALUE (default) - Preserves the integer value of user ID (UID) and GID, which is recommended.
NONE - Ignores UID and GID.
For more information, see Understanding how DataSync handles file and object metadata.
" }, "PreserveDeletedFiles":{ "shape":"PreserveDeletedFiles", @@ -3903,11 +3928,11 @@ }, "PosixPermissions":{ "shape":"PosixPermissions", - "documentation":"Specifies which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file.
For more information, see Metadata copied by DataSync.
PRESERVE (default) - Preserves POSIX-style permissions, which is recommended.
NONE - Ignores POSIX-style permissions.
DataSync can preserve extant permissions of a source location.
Specifies which users or groups can access a file for a specific purpose such as reading, writing, or execution of the file.
For more information, see Understanding how DataSync handles file and object metadata.
PRESERVE (default) - Preserves POSIX-style permissions, which is recommended.
NONE - Ignores POSIX-style permissions.
DataSync can preserve extant permissions of a source location.
Limits the bandwidth used by a DataSync task. For example, if you want DataSync to use a maximum of 1 MB, set this value to 1048576 (=1024*1024).
Limits the bandwidth used by a DataSync task. For example, if you want DataSync to use a maximum of 1 MB, set this value to 1048576 (=1024*1024).
Not applicable to Enhanced mode tasks.
Determines whether DataSync transfers only the data and metadata that differ between the source and the destination location or transfers all the content from the source (without comparing what's in the destination).
CHANGED (default) - DataSync copies only data or metadata that is new or different content from the source location to the destination location.
ALL - DataSync copies everything in the source to the destination without comparing differences between the locations.
Specifies whether DataSync transfers only the data (including metadata) that differs between locations following an initial copy or transfers all data every time you run the task. If you're planning on recurring transfers, you might only want to transfer what's changed since your previous task execution.
CHANGED (default) - After your initial full transfer, DataSync copies only the data and metadata that differs between the source and destination location.
ALL - DataSync copies everything in the source to the destination without comparing differences between the locations.
Specifies which components of the SMB security descriptor are copied from source to destination objects.
This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations or between two FSx for Windows File Server locations. For more information, see how DataSync handles metadata.
OWNER_DACL (default) - For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
DataSync won't copy NTFS system access control lists (SACLs) with this option.
OWNER_DACL_SACL - For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
SACLs, which are used by administrators to log attempts to access a secured object.
Copying SACLs requires granting additional permissions to the Windows user that DataSync uses to access your SMB location. For information about choosing a user with the right permissions, see required permissions for SMB, FSx for Windows File Server, or FSx for ONTAP (depending on the type of location in your transfer).
NONE - None of the SMB security descriptor components are copied. Destination objects are owned by the user that was provided for accessing the destination location. DACLs and SACLs are set based on the destination server’s configuration.
Specifies which components of the SMB security descriptor are copied from source to destination objects.
This value is only used for transfers between SMB and Amazon FSx for Windows File Server locations or between two FSx for Windows File Server locations. For more information, see Understanding how DataSync handles file and object metadata.
OWNER_DACL (default) - For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
DataSync won't copy NTFS system access control lists (SACLs) with this option.
OWNER_DACL_SACL - For each copied object, DataSync copies the following metadata:
The object owner.
NTFS discretionary access control lists (DACLs), which determine whether to grant access to an object.
SACLs, which are used by administrators to log attempts to access a secured object.
Copying SACLs requires granting additional permissions to the Windows user that DataSync uses to access your SMB location. For information about choosing a user with the right permissions, see required permissions for SMB, FSx for Windows File Server, or FSx for ONTAP (depending on the type of location in your transfer).
NONE - None of the SMB security descriptor components are copied. Destination objects are owned by the user that was provided for accessing the destination location. DACLs and SACLs are set based on the destination server’s configuration.
Specifies the VPC endpoint provided by Amazon Web Services PrivateLink that your agent connects to.
" + "documentation":"Specifies the VPC endpoint provided by Amazon Web Services PrivateLink that your agent connects to.
" }, "SubnetArns":{ "shape":"PLSubnetArnList", @@ -4280,8 +4305,8 @@ }, "S3BucketArn":{ "type":"string", - "max":156, - "pattern":"^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):(s3|s3-outposts):[a-z\\-0-9]*:[0-9]*:.*$" + "max":268, + "pattern":"^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):s3:[a-z\\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):s3-outposts:[a-z\\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\\-_]{1,255}$" }, "S3Config":{ "type":"structure", @@ -4643,6 +4668,42 @@ "max":128, "pattern":"^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\\-0-9]*:[0-9]{12}:task/task-[0-9a-f]{17}/execution/exec-[0-9a-f]{17}$" }, + "TaskExecutionFilesFailedDetail":{ + "type":"structure", + "members":{ + "Prepare":{ + "shape":"long", + "documentation":"The number of objects that DataSync fails to prepare during your task execution.
" + }, + "Transfer":{ + "shape":"long", + "documentation":"The number of objects that DataSync fails to transfer during your task execution.
" + }, + "Verify":{ + "shape":"long", + "documentation":"The number of objects that DataSync fails to verify during your task execution.
" + }, + "Delete":{ + "shape":"long", + "documentation":"The number of objects that DataSync fails to delete during your task execution.
" + } + }, + "documentation":"The number of objects that DataSync fails to prepare, transfer, verify, and delete during your task execution.
Applies only to Enhanced mode tasks.
The number of objects that DataSync finds at your source location.
With a manifest, DataSync lists only what's in your manifest (and not everything at your source location).
With an include filter, DataSync lists only what matches the filter at your source location.
With an exclude filter, DataSync lists everything at your source location before applying the filter.
The number of objects that DataSync finds at your destination location. This metric is only applicable if you configure your task to delete data in the destination that isn't in the source.
" + } + }, + "documentation":"The number of objects that DataSync finds at your locations.
Applies only to Enhanced mode tasks.
The status of a task execution. For more information, see Task execution statuses.
" + }, + "TaskMode":{ + "shape":"TaskMode", + "documentation":"The task mode that you're using. For more information, see Choosing a task mode for your data transfer.
" } }, "documentation":"Represents a single entry in a list of DataSync task executions that's returned with the ListTaskExecutions operation.
" @@ -4666,42 +4731,42 @@ "members":{ "PrepareDuration":{ "shape":"Duration", - "documentation":"The total time in milliseconds that DataSync spent in the PREPARING phase.
" + "documentation":"The time in milliseconds that your task execution was in the PREPARING step. For more information, see Task execution statuses.
For Enhanced mode tasks, the value is always 0. For more information, see How DataSync prepares your data transfer.
The status of the PREPARING phase.
" + "documentation":"The status of the PREPARING step for your task execution. For more information, see Task execution statuses.
The total time in milliseconds that DataSync took to transfer the file from the source to the destination location.
" + "documentation":"The time in milliseconds that your task execution ran.
" }, "TransferDuration":{ "shape":"Duration", - "documentation":"The total time in milliseconds that DataSync spent in the TRANSFERRING phase.
" + "documentation":"The time in milliseconds that your task execution was in the TRANSFERRING step. For more information, see Task execution statuses.
For Enhanced mode tasks, the value is always 0. For more information, see How DataSync transfers your data.
The status of the TRANSFERRING phase.
" + "documentation":"The status of the TRANSFERRING step for your task execution. For more information, see Task execution statuses.
The total time in milliseconds that DataSync spent in the VERIFYING phase.
" + "documentation":"The time in milliseconds that your task execution was in the VERIFYING step. For more information, see Task execution statuses.
For Enhanced mode tasks, the value is always 0. For more information, see How DataSync verifies your data's integrity.
The status of the VERIFYING phase.
" + "documentation":"The status of the VERIFYING step for your task execution. For more information, see Task execution statuses.
Errors that DataSync encountered during execution of the task. You can use this error code to help troubleshoot issues.
" + "documentation":"An error that DataSync encountered during your task execution. You can use this information to help troubleshoot issues.
" }, "ErrorDetail":{ "shape":"string", - "documentation":"Detailed description of an error that was encountered during the task execution. You can use this information to help troubleshoot issues.
" + "documentation":"The detailed description of an error that DataSync encountered during your task execution. You can use this information to help troubleshoot issues.
" } }, - "documentation":"Describes the detailed result of a TaskExecution operation. This result includes the time in milliseconds spent in each phase, the status of the task execution, and the errors encountered.
Provides detailed information about the result of your DataSync task execution.
" }, "TaskExecutionStatus":{ "type":"string", @@ -4768,10 +4833,21 @@ "Name":{ "shape":"TagValue", "documentation":"The name of the task.
" + }, + "TaskMode":{ + "shape":"TaskMode", + "documentation":"The task mode that you're using. For more information, see Choosing a task mode for your data transfer.
" } }, "documentation":"Represents a single entry in a list of tasks. TaskListEntry returns an array that contains a list of tasks when the ListTasks operation is called. A task includes the source and destination file systems to sync and the options to use for the tasks.
Specifies your task schedule by using a cron expression in UTC time. For information about cron expression syntax, see the Amazon EventBridge User Guide .
" + "documentation":"Specifies your task schedule by using a cron or rate expression.
Use cron expressions for task schedules that run on a specific time and day. For example, the following cron expression creates a task schedule that runs at 8 AM on the first Wednesday of every month:
cron(0 8 * * 3#1)
Use rate expressions for task schedules that run on a regular interval. For example, the following rate expression creates a task schedule that runs every 12 hours:
rate(12 hours)
For information about cron and rate expression syntax, see the Amazon EventBridge User Guide .
" }, "Status":{ "shape":"ScheduleStatus", @@ -5046,7 +5122,7 @@ }, "AgentArns":{ "shape":"AgentArnList", - "documentation":"The ARNs of the agents that are used to connect to the HDFS cluster.
" + "documentation":"The Amazon Resource Names (ARNs) of the DataSync agents that can connect to your HDFS cluster.
" } } }, @@ -5106,7 +5182,7 @@ }, "AgentArns":{ "shape":"AgentArnList", - "documentation":"Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can securely connect with your location.
" + "documentation":"Specifies the Amazon Resource Names (ARNs) of the DataSync agents that can connect with your object storage system.
" }, "ServerCertificate":{ "shape":"ObjectStorageCertificate", @@ -5145,7 +5221,7 @@ }, "AgentArns":{ "shape":"AgentArnList", - "documentation":"Specifies the DataSync agent (or agents) which you want to connect to your SMB file server. You specify an agent by using its Amazon Resource Name (ARN).
" + "documentation":"Specifies the DataSync agent (or agents) that can connect to your SMB file server. You specify an agent by using its Amazon Resource Name (ARN).
" }, "MountOptions":{"shape":"SmbMountOptions"} } @@ -5232,7 +5308,7 @@ }, "CloudWatchLogGroupArn":{ "shape":"LogGroupArn", - "documentation":"Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log group for monitoring your task.
" + "documentation":"Specifies the Amazon Resource Name (ARN) of an Amazon CloudWatch log group for monitoring your task.
For Enhanced mode tasks, you must use /aws/datasync as your log group name. For example:
arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync:*
For more information, see Monitoring data transfers with CloudWatch Logs.
" }, "Includes":{ "shape":"FilterList", From 2765fb2a8fd3b4bb8524118d9109c1399b9c392d Mon Sep 17 00:00:00 2001 From: AWS <> Date: Wed, 30 Oct 2024 18:16:23 +0000 Subject: [PATCH 20/21] Updated endpoints.json and partitions.json. --- .changes/next-release/feature-AWSSDKforJavav2-0443982.json | 6 ++++++ .../amazon/awssdk/regions/internal/region/endpoints.json | 6 ++++++ 2 files changed, 12 insertions(+) create mode 100644 .changes/next-release/feature-AWSSDKforJavav2-0443982.json diff --git a/.changes/next-release/feature-AWSSDKforJavav2-0443982.json b/.changes/next-release/feature-AWSSDKforJavav2-0443982.json new file mode 100644 index 000000000000..e5b5ee3ca5e3 --- /dev/null +++ b/.changes/next-release/feature-AWSSDKforJavav2-0443982.json @@ -0,0 +1,6 @@ +{ + "type": "feature", + "category": "AWS SDK for Java v2", + "contributor": "", + "description": "Updated endpoint and partition metadata." +} diff --git a/core/regions/src/main/resources/software/amazon/awssdk/regions/internal/region/endpoints.json b/core/regions/src/main/resources/software/amazon/awssdk/regions/internal/region/endpoints.json index 402bb50da55b..43bbe1e77d85 100644 --- a/core/regions/src/main/resources/software/amazon/awssdk/regions/internal/region/endpoints.json +++ b/core/regions/src/main/resources/software/amazon/awssdk/regions/internal/region/endpoints.json @@ -27551,6 +27551,12 @@ } } }, + "memory-db" : { + "endpoints" : { + "us-gov-east-1" : { }, + "us-gov-west-1" : { } + } + }, "metering.marketplace" : { "defaults" : { "credentialScope" : { From 2fb6de542a1080dd99496699d59245e977a008b9 Mon Sep 17 00:00:00 2001 From: AWS <> Date: Wed, 30 Oct 2024 18:17:44 +0000 Subject: [PATCH 21/21] Release 2.29.4. Updated CHANGELOG.md, README.md and all pom.xml. --- .changes/2.29.4.json | 120 ++++++++++++++++++ .../feature-AWSAppSync-68daa3f.json | 6 - .../feature-AWSDataSync-6e7bc3d.json | 6 - .../feature-AWSNetworkFirewall-8048a64.json | 6 - .../feature-AWSSDKforJavav2-0443982.json | 6 - .../feature-AWSSDKforJavav2-22a34e4.json | 6 - .../feature-AmazonConnectService-876afc9.json | 6 - ...ure-AmazonEC2ContainerService-1c7f1ff.json | 6 - ...ure-AmazonElasticComputeCloud-a391e7c.json | 6 - .../feature-AmazonKeyspaces-67a28cb.json | 6 - ...e-AmazonLocationServiceMapsV2-ba57d08.json | 6 - ...AmazonLocationServicePlacesV2-97efb00.json | 6 - ...AmazonLocationServiceRoutesV2-1f89504.json | 6 - ...ature-AmazonOpenSearchService-b3ce932.json | 6 - .../feature-AmazonRedshift-f6845a7.json | 6 - .../feature-AmazonRoute53-d97b66b.json | 6 - ...eature-AmazonSageMakerService-82f92b8.json | 6 - .../feature-AmazonWorkMail-9d747a2.json | 6 - ...e-OpenSearchServiceServerless-5750d88.json | 6 - .../feature-RedshiftServerless-309f852.json | 6 - CHANGELOG.md | 74 +++++++++++ README.md | 8 +- archetypes/archetype-app-quickstart/pom.xml | 2 +- archetypes/archetype-lambda/pom.xml | 2 +- archetypes/archetype-tools/pom.xml | 2 +- archetypes/pom.xml | 2 +- aws-sdk-java/pom.xml | 17 ++- bom-internal/pom.xml | 2 +- bom/pom.xml | 17 ++- bundle-logging-bridge/pom.xml | 2 +- bundle-sdk/pom.xml | 2 +- bundle/pom.xml | 2 +- codegen-lite-maven-plugin/pom.xml | 2 +- codegen-lite/pom.xml | 2 +- codegen-maven-plugin/pom.xml | 2 +- codegen/pom.xml | 2 +- core/annotations/pom.xml | 2 +- core/arns/pom.xml | 2 +- core/auth-crt/pom.xml | 2 +- core/auth/pom.xml | 2 +- core/aws-core/pom.xml | 2 +- core/checksums-spi/pom.xml | 2 +- core/checksums/pom.xml | 2 +- core/crt-core/pom.xml | 2 +- core/endpoints-spi/pom.xml | 2 +- core/http-auth-aws-crt/pom.xml | 2 +- core/http-auth-aws-eventstream/pom.xml | 2 +- core/http-auth-aws/pom.xml | 2 +- core/http-auth-spi/pom.xml | 2 +- core/http-auth/pom.xml | 2 +- core/identity-spi/pom.xml | 2 +- core/imds/pom.xml | 2 +- core/json-utils/pom.xml | 2 +- core/metrics-spi/pom.xml | 2 +- core/pom.xml | 2 +- core/profiles/pom.xml | 2 +- core/protocols/aws-cbor-protocol/pom.xml | 2 +- core/protocols/aws-json-protocol/pom.xml | 2 +- core/protocols/aws-query-protocol/pom.xml | 2 +- core/protocols/aws-xml-protocol/pom.xml | 2 +- core/protocols/pom.xml | 2 +- core/protocols/protocol-core/pom.xml | 2 +- core/protocols/smithy-rpcv2-protocol/pom.xml | 2 +- core/regions/pom.xml | 2 +- core/retries-spi/pom.xml | 2 +- core/retries/pom.xml | 2 +- core/sdk-core/pom.xml | 2 +- http-client-spi/pom.xml | 2 +- http-clients/apache-client/pom.xml | 2 +- http-clients/aws-crt-client/pom.xml | 2 +- http-clients/netty-nio-client/pom.xml | 2 +- http-clients/pom.xml | 2 +- http-clients/url-connection-client/pom.xml | 2 +- .../cloudwatch-metric-publisher/pom.xml | 2 +- metric-publishers/pom.xml | 2 +- pom.xml | 2 +- release-scripts/pom.xml | 2 +- services-custom/dynamodb-enhanced/pom.xml | 2 +- services-custom/iam-policy-builder/pom.xml | 2 +- services-custom/pom.xml | 2 +- .../s3-event-notifications/pom.xml | 2 +- services-custom/s3-transfer-manager/pom.xml | 2 +- services/accessanalyzer/pom.xml | 2 +- services/account/pom.xml | 2 +- services/acm/pom.xml | 2 +- services/acmpca/pom.xml | 2 +- services/amp/pom.xml | 2 +- services/amplify/pom.xml | 2 +- services/amplifybackend/pom.xml | 2 +- services/amplifyuibuilder/pom.xml | 2 +- services/apigateway/pom.xml | 2 +- services/apigatewaymanagementapi/pom.xml | 2 +- services/apigatewayv2/pom.xml | 2 +- services/appconfig/pom.xml | 2 +- services/appconfigdata/pom.xml | 2 +- services/appfabric/pom.xml | 2 +- services/appflow/pom.xml | 2 +- services/appintegrations/pom.xml | 2 +- services/applicationautoscaling/pom.xml | 2 +- services/applicationcostprofiler/pom.xml | 2 +- services/applicationdiscovery/pom.xml | 2 +- services/applicationinsights/pom.xml | 2 +- services/applicationsignals/pom.xml | 2 +- services/appmesh/pom.xml | 2 +- services/apprunner/pom.xml | 2 +- services/appstream/pom.xml | 2 +- services/appsync/pom.xml | 2 +- services/apptest/pom.xml | 2 +- services/arczonalshift/pom.xml | 2 +- services/artifact/pom.xml | 2 +- services/athena/pom.xml | 2 +- services/auditmanager/pom.xml | 2 +- services/autoscaling/pom.xml | 2 +- services/autoscalingplans/pom.xml | 2 +- services/b2bi/pom.xml | 2 +- services/backup/pom.xml | 2 +- services/backupgateway/pom.xml | 2 +- services/batch/pom.xml | 2 +- services/bcmdataexports/pom.xml | 2 +- services/bedrock/pom.xml | 2 +- services/bedrockagent/pom.xml | 2 +- services/bedrockagentruntime/pom.xml | 2 +- services/bedrockruntime/pom.xml | 2 +- services/billingconductor/pom.xml | 2 +- services/braket/pom.xml | 2 +- services/budgets/pom.xml | 2 +- services/chatbot/pom.xml | 2 +- services/chime/pom.xml | 2 +- services/chimesdkidentity/pom.xml | 2 +- services/chimesdkmediapipelines/pom.xml | 2 +- services/chimesdkmeetings/pom.xml | 2 +- services/chimesdkmessaging/pom.xml | 2 +- services/chimesdkvoice/pom.xml | 2 +- services/cleanrooms/pom.xml | 2 +- services/cleanroomsml/pom.xml | 2 +- services/cloud9/pom.xml | 2 +- services/cloudcontrol/pom.xml | 2 +- services/clouddirectory/pom.xml | 2 +- services/cloudformation/pom.xml | 2 +- services/cloudfront/pom.xml | 2 +- services/cloudfrontkeyvaluestore/pom.xml | 2 +- services/cloudhsm/pom.xml | 2 +- services/cloudhsmv2/pom.xml | 2 +- services/cloudsearch/pom.xml | 2 +- services/cloudsearchdomain/pom.xml | 2 +- services/cloudtrail/pom.xml | 2 +- services/cloudtraildata/pom.xml | 2 +- services/cloudwatch/pom.xml | 2 +- services/cloudwatchevents/pom.xml | 2 +- services/cloudwatchlogs/pom.xml | 2 +- services/codeartifact/pom.xml | 2 +- services/codebuild/pom.xml | 2 +- services/codecatalyst/pom.xml | 2 +- services/codecommit/pom.xml | 2 +- services/codeconnections/pom.xml | 2 +- services/codedeploy/pom.xml | 2 +- services/codeguruprofiler/pom.xml | 2 +- services/codegurureviewer/pom.xml | 2 +- services/codegurusecurity/pom.xml | 2 +- services/codepipeline/pom.xml | 2 +- services/codestarconnections/pom.xml | 2 +- services/codestarnotifications/pom.xml | 2 +- services/cognitoidentity/pom.xml | 2 +- services/cognitoidentityprovider/pom.xml | 2 +- services/cognitosync/pom.xml | 2 +- services/comprehend/pom.xml | 2 +- services/comprehendmedical/pom.xml | 2 +- services/computeoptimizer/pom.xml | 2 +- services/config/pom.xml | 2 +- services/connect/pom.xml | 2 +- services/connectcampaigns/pom.xml | 2 +- services/connectcases/pom.xml | 2 +- services/connectcontactlens/pom.xml | 2 +- services/connectparticipant/pom.xml | 2 +- services/controlcatalog/pom.xml | 2 +- services/controltower/pom.xml | 2 +- services/costandusagereport/pom.xml | 2 +- services/costexplorer/pom.xml | 2 +- services/costoptimizationhub/pom.xml | 2 +- services/customerprofiles/pom.xml | 2 +- services/databasemigration/pom.xml | 2 +- services/databrew/pom.xml | 2 +- services/dataexchange/pom.xml | 2 +- services/datapipeline/pom.xml | 2 +- services/datasync/pom.xml | 2 +- services/datazone/pom.xml | 2 +- services/dax/pom.xml | 2 +- services/deadline/pom.xml | 2 +- services/detective/pom.xml | 2 +- services/devicefarm/pom.xml | 2 +- services/devopsguru/pom.xml | 2 +- services/directconnect/pom.xml | 2 +- services/directory/pom.xml | 2 +- services/directoryservicedata/pom.xml | 2 +- services/dlm/pom.xml | 2 +- services/docdb/pom.xml | 2 +- services/docdbelastic/pom.xml | 2 +- services/drs/pom.xml | 2 +- services/dynamodb/pom.xml | 2 +- services/ebs/pom.xml | 2 +- services/ec2/pom.xml | 2 +- services/ec2instanceconnect/pom.xml | 2 +- services/ecr/pom.xml | 2 +- services/ecrpublic/pom.xml | 2 +- services/ecs/pom.xml | 2 +- services/efs/pom.xml | 2 +- services/eks/pom.xml | 2 +- services/eksauth/pom.xml | 2 +- services/elasticache/pom.xml | 2 +- services/elasticbeanstalk/pom.xml | 2 +- services/elasticinference/pom.xml | 2 +- services/elasticloadbalancing/pom.xml | 2 +- services/elasticloadbalancingv2/pom.xml | 2 +- services/elasticsearch/pom.xml | 2 +- services/elastictranscoder/pom.xml | 2 +- services/emr/pom.xml | 2 +- services/emrcontainers/pom.xml | 2 +- services/emrserverless/pom.xml | 2 +- services/entityresolution/pom.xml | 2 +- services/eventbridge/pom.xml | 2 +- services/evidently/pom.xml | 2 +- services/finspace/pom.xml | 2 +- services/finspacedata/pom.xml | 2 +- services/firehose/pom.xml | 2 +- services/fis/pom.xml | 2 +- services/fms/pom.xml | 2 +- services/forecast/pom.xml | 2 +- services/forecastquery/pom.xml | 2 +- services/frauddetector/pom.xml | 2 +- services/freetier/pom.xml | 2 +- services/fsx/pom.xml | 2 +- services/gamelift/pom.xml | 2 +- services/geomaps/pom.xml | 2 +- services/geoplaces/pom.xml | 2 +- services/georoutes/pom.xml | 2 +- services/glacier/pom.xml | 2 +- services/globalaccelerator/pom.xml | 2 +- services/glue/pom.xml | 2 +- services/grafana/pom.xml | 2 +- services/greengrass/pom.xml | 2 +- services/greengrassv2/pom.xml | 2 +- services/groundstation/pom.xml | 2 +- services/guardduty/pom.xml | 2 +- services/health/pom.xml | 2 +- services/healthlake/pom.xml | 2 +- services/iam/pom.xml | 2 +- services/identitystore/pom.xml | 2 +- services/imagebuilder/pom.xml | 2 +- services/inspector/pom.xml | 2 +- services/inspector2/pom.xml | 2 +- services/inspectorscan/pom.xml | 2 +- services/internetmonitor/pom.xml | 2 +- services/iot/pom.xml | 2 +- services/iot1clickdevices/pom.xml | 2 +- services/iot1clickprojects/pom.xml | 2 +- services/iotanalytics/pom.xml | 2 +- services/iotdataplane/pom.xml | 2 +- services/iotdeviceadvisor/pom.xml | 2 +- services/iotevents/pom.xml | 2 +- services/ioteventsdata/pom.xml | 2 +- services/iotfleethub/pom.xml | 2 +- services/iotfleetwise/pom.xml | 2 +- services/iotjobsdataplane/pom.xml | 2 +- services/iotsecuretunneling/pom.xml | 2 +- services/iotsitewise/pom.xml | 2 +- services/iotthingsgraph/pom.xml | 2 +- services/iottwinmaker/pom.xml | 2 +- services/iotwireless/pom.xml | 2 +- services/ivs/pom.xml | 2 +- services/ivschat/pom.xml | 2 +- services/ivsrealtime/pom.xml | 2 +- services/kafka/pom.xml | 2 +- services/kafkaconnect/pom.xml | 2 +- services/kendra/pom.xml | 2 +- services/kendraranking/pom.xml | 2 +- services/keyspaces/pom.xml | 2 +- services/kinesis/pom.xml | 2 +- services/kinesisanalytics/pom.xml | 2 +- services/kinesisanalyticsv2/pom.xml | 2 +- services/kinesisvideo/pom.xml | 2 +- services/kinesisvideoarchivedmedia/pom.xml | 2 +- services/kinesisvideomedia/pom.xml | 2 +- services/kinesisvideosignaling/pom.xml | 2 +- services/kinesisvideowebrtcstorage/pom.xml | 2 +- services/kms/pom.xml | 2 +- services/lakeformation/pom.xml | 2 +- services/lambda/pom.xml | 2 +- services/launchwizard/pom.xml | 2 +- services/lexmodelbuilding/pom.xml | 2 +- services/lexmodelsv2/pom.xml | 2 +- services/lexruntime/pom.xml | 2 +- services/lexruntimev2/pom.xml | 2 +- services/licensemanager/pom.xml | 2 +- .../licensemanagerlinuxsubscriptions/pom.xml | 2 +- .../licensemanagerusersubscriptions/pom.xml | 2 +- services/lightsail/pom.xml | 2 +- services/location/pom.xml | 2 +- services/lookoutequipment/pom.xml | 2 +- services/lookoutmetrics/pom.xml | 2 +- services/lookoutvision/pom.xml | 2 +- services/m2/pom.xml | 2 +- services/machinelearning/pom.xml | 2 +- services/macie2/pom.xml | 2 +- services/mailmanager/pom.xml | 2 +- services/managedblockchain/pom.xml | 2 +- services/managedblockchainquery/pom.xml | 2 +- services/marketplaceagreement/pom.xml | 2 +- services/marketplacecatalog/pom.xml | 2 +- services/marketplacecommerceanalytics/pom.xml | 2 +- services/marketplacedeployment/pom.xml | 2 +- services/marketplaceentitlement/pom.xml | 2 +- services/marketplacemetering/pom.xml | 2 +- services/marketplacereporting/pom.xml | 2 +- services/mediaconnect/pom.xml | 2 +- services/mediaconvert/pom.xml | 2 +- services/medialive/pom.xml | 2 +- services/mediapackage/pom.xml | 2 +- services/mediapackagev2/pom.xml | 2 +- services/mediapackagevod/pom.xml | 2 +- services/mediastore/pom.xml | 2 +- services/mediastoredata/pom.xml | 2 +- services/mediatailor/pom.xml | 2 +- services/medicalimaging/pom.xml | 2 +- services/memorydb/pom.xml | 2 +- services/mgn/pom.xml | 2 +- services/migrationhub/pom.xml | 2 +- services/migrationhubconfig/pom.xml | 2 +- services/migrationhuborchestrator/pom.xml | 2 +- services/migrationhubrefactorspaces/pom.xml | 2 +- services/migrationhubstrategy/pom.xml | 2 +- services/mq/pom.xml | 2 +- services/mturk/pom.xml | 2 +- services/mwaa/pom.xml | 2 +- services/neptune/pom.xml | 2 +- services/neptunedata/pom.xml | 2 +- services/neptunegraph/pom.xml | 2 +- services/networkfirewall/pom.xml | 2 +- services/networkmanager/pom.xml | 2 +- services/networkmonitor/pom.xml | 2 +- services/oam/pom.xml | 2 +- services/omics/pom.xml | 2 +- services/opensearch/pom.xml | 2 +- services/opensearchserverless/pom.xml | 2 +- services/opsworks/pom.xml | 2 +- services/opsworkscm/pom.xml | 2 +- services/organizations/pom.xml | 2 +- services/osis/pom.xml | 2 +- services/outposts/pom.xml | 2 +- services/panorama/pom.xml | 2 +- services/paymentcryptography/pom.xml | 2 +- services/paymentcryptographydata/pom.xml | 2 +- services/pcaconnectorad/pom.xml | 2 +- services/pcaconnectorscep/pom.xml | 2 +- services/pcs/pom.xml | 2 +- services/personalize/pom.xml | 2 +- services/personalizeevents/pom.xml | 2 +- services/personalizeruntime/pom.xml | 2 +- services/pi/pom.xml | 2 +- services/pinpoint/pom.xml | 2 +- services/pinpointemail/pom.xml | 2 +- services/pinpointsmsvoice/pom.xml | 2 +- services/pinpointsmsvoicev2/pom.xml | 2 +- services/pipes/pom.xml | 2 +- services/polly/pom.xml | 2 +- services/pom.xml | 5 +- services/pricing/pom.xml | 2 +- services/privatenetworks/pom.xml | 2 +- services/proton/pom.xml | 2 +- services/qapps/pom.xml | 2 +- services/qbusiness/pom.xml | 2 +- services/qconnect/pom.xml | 2 +- services/qldb/pom.xml | 2 +- services/qldbsession/pom.xml | 2 +- services/quicksight/pom.xml | 2 +- services/ram/pom.xml | 2 +- services/rbin/pom.xml | 2 +- services/rds/pom.xml | 2 +- services/rdsdata/pom.xml | 2 +- services/redshift/pom.xml | 2 +- services/redshiftdata/pom.xml | 2 +- services/redshiftserverless/pom.xml | 2 +- services/rekognition/pom.xml | 2 +- services/repostspace/pom.xml | 2 +- services/resiliencehub/pom.xml | 2 +- services/resourceexplorer2/pom.xml | 2 +- services/resourcegroups/pom.xml | 2 +- services/resourcegroupstaggingapi/pom.xml | 2 +- services/robomaker/pom.xml | 2 +- services/rolesanywhere/pom.xml | 2 +- services/route53/pom.xml | 2 +- services/route53domains/pom.xml | 2 +- services/route53profiles/pom.xml | 2 +- services/route53recoverycluster/pom.xml | 2 +- services/route53recoverycontrolconfig/pom.xml | 2 +- services/route53recoveryreadiness/pom.xml | 2 +- services/route53resolver/pom.xml | 2 +- services/rum/pom.xml | 2 +- services/s3/pom.xml | 2 +- services/s3control/pom.xml | 2 +- services/s3outposts/pom.xml | 2 +- services/sagemaker/pom.xml | 2 +- services/sagemakera2iruntime/pom.xml | 2 +- services/sagemakeredge/pom.xml | 2 +- services/sagemakerfeaturestoreruntime/pom.xml | 2 +- services/sagemakergeospatial/pom.xml | 2 +- services/sagemakermetrics/pom.xml | 2 +- services/sagemakerruntime/pom.xml | 2 +- services/savingsplans/pom.xml | 2 +- services/scheduler/pom.xml | 2 +- services/schemas/pom.xml | 2 +- services/secretsmanager/pom.xml | 2 +- services/securityhub/pom.xml | 2 +- services/securitylake/pom.xml | 2 +- .../serverlessapplicationrepository/pom.xml | 2 +- services/servicecatalog/pom.xml | 2 +- services/servicecatalogappregistry/pom.xml | 2 +- services/servicediscovery/pom.xml | 2 +- services/servicequotas/pom.xml | 2 +- services/ses/pom.xml | 2 +- services/sesv2/pom.xml | 2 +- services/sfn/pom.xml | 2 +- services/shield/pom.xml | 2 +- services/signer/pom.xml | 2 +- services/simspaceweaver/pom.xml | 2 +- services/sms/pom.xml | 2 +- services/snowball/pom.xml | 2 +- services/snowdevicemanagement/pom.xml | 2 +- services/sns/pom.xml | 2 +- services/socialmessaging/pom.xml | 2 +- services/sqs/pom.xml | 2 +- services/ssm/pom.xml | 2 +- services/ssmcontacts/pom.xml | 2 +- services/ssmincidents/pom.xml | 2 +- services/ssmquicksetup/pom.xml | 2 +- services/ssmsap/pom.xml | 2 +- services/sso/pom.xml | 2 +- services/ssoadmin/pom.xml | 2 +- services/ssooidc/pom.xml | 2 +- services/storagegateway/pom.xml | 2 +- services/sts/pom.xml | 2 +- services/supplychain/pom.xml | 2 +- services/support/pom.xml | 2 +- services/supportapp/pom.xml | 2 +- services/swf/pom.xml | 2 +- services/synthetics/pom.xml | 2 +- services/taxsettings/pom.xml | 2 +- services/textract/pom.xml | 2 +- services/timestreaminfluxdb/pom.xml | 2 +- services/timestreamquery/pom.xml | 2 +- services/timestreamwrite/pom.xml | 2 +- services/tnb/pom.xml | 2 +- services/transcribe/pom.xml | 2 +- services/transcribestreaming/pom.xml | 2 +- services/transfer/pom.xml | 2 +- services/translate/pom.xml | 2 +- services/trustedadvisor/pom.xml | 2 +- services/verifiedpermissions/pom.xml | 2 +- services/voiceid/pom.xml | 2 +- services/vpclattice/pom.xml | 2 +- services/waf/pom.xml | 2 +- services/wafv2/pom.xml | 2 +- services/wellarchitected/pom.xml | 2 +- services/wisdom/pom.xml | 2 +- services/workdocs/pom.xml | 2 +- services/workmail/pom.xml | 2 +- services/workmailmessageflow/pom.xml | 2 +- services/workspaces/pom.xml | 2 +- services/workspacesthinclient/pom.xml | 2 +- services/workspacesweb/pom.xml | 2 +- services/xray/pom.xml | 2 +- test/auth-tests/pom.xml | 2 +- .../pom.xml | 2 +- test/bundle-shading-tests/pom.xml | 2 +- test/codegen-generated-classes-test/pom.xml | 2 +- test/crt-unavailable-tests/pom.xml | 2 +- test/http-client-tests/pom.xml | 2 +- test/module-path-tests/pom.xml | 2 +- .../pom.xml | 2 +- test/protocol-tests-core/pom.xml | 2 +- test/protocol-tests/pom.xml | 2 +- test/region-testing/pom.xml | 2 +- test/ruleset-testing-core/pom.xml | 2 +- test/s3-benchmarks/pom.xml | 2 +- test/sdk-benchmarks/pom.xml | 2 +- test/sdk-native-image-test/pom.xml | 2 +- test/service-test-utils/pom.xml | 2 +- test/stability-tests/pom.xml | 2 +- test/test-utils/pom.xml | 2 +- test/tests-coverage-reporting/pom.xml | 2 +- test/v2-migration-tests/pom.xml | 2 +- third-party/pom.xml | 2 +- third-party/third-party-jackson-core/pom.xml | 2 +- .../pom.xml | 2 +- third-party/third-party-slf4j-api/pom.xml | 2 +- utils/pom.xml | 2 +- v2-migration/pom.xml | 2 +- 496 files changed, 705 insertions(+), 592 deletions(-) create mode 100644 .changes/2.29.4.json delete mode 100644 .changes/next-release/feature-AWSAppSync-68daa3f.json delete mode 100644 .changes/next-release/feature-AWSDataSync-6e7bc3d.json delete mode 100644 .changes/next-release/feature-AWSNetworkFirewall-8048a64.json delete mode 100644 .changes/next-release/feature-AWSSDKforJavav2-0443982.json delete mode 100644 .changes/next-release/feature-AWSSDKforJavav2-22a34e4.json delete mode 100644 .changes/next-release/feature-AmazonConnectService-876afc9.json delete mode 100644 .changes/next-release/feature-AmazonEC2ContainerService-1c7f1ff.json delete mode 100644 .changes/next-release/feature-AmazonElasticComputeCloud-a391e7c.json delete mode 100644 .changes/next-release/feature-AmazonKeyspaces-67a28cb.json delete mode 100644 .changes/next-release/feature-AmazonLocationServiceMapsV2-ba57d08.json delete mode 100644 .changes/next-release/feature-AmazonLocationServicePlacesV2-97efb00.json delete mode 100644 .changes/next-release/feature-AmazonLocationServiceRoutesV2-1f89504.json delete mode 100644 .changes/next-release/feature-AmazonOpenSearchService-b3ce932.json delete mode 100644 .changes/next-release/feature-AmazonRedshift-f6845a7.json delete mode 100644 .changes/next-release/feature-AmazonRoute53-d97b66b.json delete mode 100644 .changes/next-release/feature-AmazonSageMakerService-82f92b8.json delete mode 100644 .changes/next-release/feature-AmazonWorkMail-9d747a2.json delete mode 100644 .changes/next-release/feature-OpenSearchServiceServerless-5750d88.json delete mode 100644 .changes/next-release/feature-RedshiftServerless-309f852.json diff --git a/.changes/2.29.4.json b/.changes/2.29.4.json new file mode 100644 index 000000000000..d85a1a2e86ed --- /dev/null +++ b/.changes/2.29.4.json @@ -0,0 +1,120 @@ +{ + "version": "2.29.4", + "date": "2024-10-30", + "entries": [ + { + "type": "feature", + "category": "AWS AppSync", + "contributor": "", + "description": "This release adds support for AppSync Event APIs." + }, + { + "type": "feature", + "category": "AWS DataSync", + "contributor": "", + "description": "AWS DataSync now supports Enhanced mode tasks. This task mode supports transfer of virtually unlimited numbers of objects with enhanced metrics, more detailed logs, and higher performance than Basic mode. This mode currently supports transfers between Amazon S3 locations." + }, + { + "type": "feature", + "category": "AWS Network Firewall", + "contributor": "", + "description": "AWS Network Firewall now supports configuring TCP idle timeout" + }, + { + "type": "feature", + "category": "AWS SDK for Java v2", + "contributor": "", + "description": "Adds support for tracking feature usage in a new user agent metadata section and adds a base set of features. Where features were already a part of the user agent string, they are now converted to the new format where a feature is represented as a Base64 encoded string. For example, using DynamoDb Enhanced Client was previously recorded as 'hll/ddb-enh' in the user agent, but is now a 'd' in the business metrics metadata section 'm/'." + }, + { + "type": "feature", + "category": "Amazon Connect Service", + "contributor": "", + "description": "Updated the public documentation for the UserIdentityInfo object to accurately reflect the character limits for the FirstName and LastName fields, which were previously listed as 1-100 characters." + }, + { + "type": "feature", + "category": "Amazon EC2 Container Service", + "contributor": "", + "description": "This release supports service deployments and service revisions which provide a comprehensive view of your Amazon ECS service history." + }, + { + "type": "feature", + "category": "Amazon Elastic Compute Cloud", + "contributor": "", + "description": "This release adds two new capabilities to VPC Security Groups: Security Group VPC Associations and Shared Security Groups." + }, + { + "type": "feature", + "category": "Amazon Keyspaces", + "contributor": "", + "description": "Adds support for interacting with user-defined types (UDTs) through the following new operations: Create-Type, Delete-Type, List-Types, Get-Type." + }, + { + "type": "feature", + "category": "Amazon Location Service Maps V2", + "contributor": "", + "description": "Release of Amazon Location Maps API. Maps enables you to build digital maps that showcase your locations, visualize your data, and unlock insights to drive your business" + }, + { + "type": "feature", + "category": "Amazon Location Service Places V2", + "contributor": "", + "description": "Release of Amazon Location Places API. Places enables you to quickly search, display, and filter places, businesses, and locations based on proximity, category, and name" + }, + { + "type": "feature", + "category": "Amazon Location Service Routes V2", + "contributor": "", + "description": "Release of Amazon Location Routes API. Routes enables you to plan efficient routes and streamline deliveries by leveraging real-time traffic, vehicle restrictions, and turn-by-turn directions." + }, + { + "type": "feature", + "category": "Amazon OpenSearch Service", + "contributor": "", + "description": "This release introduces the new OpenSearch user interface (Dashboards), a new web-based application that can be associated with multiple data sources across OpenSearch managed clusters, serverless collections, and Amazon S3, so that users can gain a comprehensive insights in an unified interface." + }, + { + "type": "feature", + "category": "Amazon Redshift", + "contributor": "", + "description": "This release launches S3 event integrations to create and manage integrations from an Amazon S3 source into an Amazon Redshift database." + }, + { + "type": "feature", + "category": "Amazon Route 53", + "contributor": "", + "description": "This release adds support for TLSA, SSHFP, SVCB, and HTTPS record types." + }, + { + "type": "feature", + "category": "Amazon SageMaker Service", + "contributor": "", + "description": "Added support for Model Registry Staging construct. Users can define series of stages that models can progress through for model workflows and lifecycle. This simplifies tracking and managing models as they transition through development, testing, and production stages." + }, + { + "type": "feature", + "category": "Amazon WorkMail", + "contributor": "", + "description": "This release adds support for Multi-Factor Authentication (MFA) and Personal Access Tokens through integration with AWS IAM Identity Center." + }, + { + "type": "feature", + "category": "OpenSearch Service Serverless", + "contributor": "", + "description": "Neo Integration via IAM Identity Center (IdC)" + }, + { + "type": "feature", + "category": "Redshift Serverless", + "contributor": "", + "description": "Adds and updates API members for the Redshift Serverless AI-driven scaling and optimization feature using the price-performance target setting." + }, + { + "type": "feature", + "category": "AWS SDK for Java v2", + "contributor": "", + "description": "Updated endpoint and partition metadata." + } + ] +} \ No newline at end of file diff --git a/.changes/next-release/feature-AWSAppSync-68daa3f.json b/.changes/next-release/feature-AWSAppSync-68daa3f.json deleted file mode 100644 index 7080909e9101..000000000000 --- a/.changes/next-release/feature-AWSAppSync-68daa3f.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "AWS AppSync", - "contributor": "", - "description": "This release adds support for AppSync Event APIs." -} diff --git a/.changes/next-release/feature-AWSDataSync-6e7bc3d.json b/.changes/next-release/feature-AWSDataSync-6e7bc3d.json deleted file mode 100644 index cab9f52be1ee..000000000000 --- a/.changes/next-release/feature-AWSDataSync-6e7bc3d.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "AWS DataSync", - "contributor": "", - "description": "AWS DataSync now supports Enhanced mode tasks. This task mode supports transfer of virtually unlimited numbers of objects with enhanced metrics, more detailed logs, and higher performance than Basic mode. This mode currently supports transfers between Amazon S3 locations." -} diff --git a/.changes/next-release/feature-AWSNetworkFirewall-8048a64.json b/.changes/next-release/feature-AWSNetworkFirewall-8048a64.json deleted file mode 100644 index ce5495e061ec..000000000000 --- a/.changes/next-release/feature-AWSNetworkFirewall-8048a64.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "AWS Network Firewall", - "contributor": "", - "description": "AWS Network Firewall now supports configuring TCP idle timeout" -} diff --git a/.changes/next-release/feature-AWSSDKforJavav2-0443982.json b/.changes/next-release/feature-AWSSDKforJavav2-0443982.json deleted file mode 100644 index e5b5ee3ca5e3..000000000000 --- a/.changes/next-release/feature-AWSSDKforJavav2-0443982.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "AWS SDK for Java v2", - "contributor": "", - "description": "Updated endpoint and partition metadata." -} diff --git a/.changes/next-release/feature-AWSSDKforJavav2-22a34e4.json b/.changes/next-release/feature-AWSSDKforJavav2-22a34e4.json deleted file mode 100644 index 59ab61339f8e..000000000000 --- a/.changes/next-release/feature-AWSSDKforJavav2-22a34e4.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "AWS SDK for Java v2", - "contributor": "", - "description": "Adds support for tracking feature usage in a new user agent metadata section and adds a base set of features. Where features were already a part of the user agent string, they are now converted to the new format where a feature is represented as a Base64 encoded string. For example, using DynamoDb Enhanced Client was previously recorded as 'hll/ddb-enh' in the user agent, but is now a 'd' in the business metrics metadata section 'm/'." -} diff --git a/.changes/next-release/feature-AmazonConnectService-876afc9.json b/.changes/next-release/feature-AmazonConnectService-876afc9.json deleted file mode 100644 index 0493ec5b9181..000000000000 --- a/.changes/next-release/feature-AmazonConnectService-876afc9.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Amazon Connect Service", - "contributor": "", - "description": "Updated the public documentation for the UserIdentityInfo object to accurately reflect the character limits for the FirstName and LastName fields, which were previously listed as 1-100 characters." -} diff --git a/.changes/next-release/feature-AmazonEC2ContainerService-1c7f1ff.json b/.changes/next-release/feature-AmazonEC2ContainerService-1c7f1ff.json deleted file mode 100644 index 044e551185d1..000000000000 --- a/.changes/next-release/feature-AmazonEC2ContainerService-1c7f1ff.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Amazon EC2 Container Service", - "contributor": "", - "description": "This release supports service deployments and service revisions which provide a comprehensive view of your Amazon ECS service history." -} diff --git a/.changes/next-release/feature-AmazonElasticComputeCloud-a391e7c.json b/.changes/next-release/feature-AmazonElasticComputeCloud-a391e7c.json deleted file mode 100644 index e6b12352f4cb..000000000000 --- a/.changes/next-release/feature-AmazonElasticComputeCloud-a391e7c.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Amazon Elastic Compute Cloud", - "contributor": "", - "description": "This release adds two new capabilities to VPC Security Groups: Security Group VPC Associations and Shared Security Groups." -} diff --git a/.changes/next-release/feature-AmazonKeyspaces-67a28cb.json b/.changes/next-release/feature-AmazonKeyspaces-67a28cb.json deleted file mode 100644 index 7c4acbaa1224..000000000000 --- a/.changes/next-release/feature-AmazonKeyspaces-67a28cb.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Amazon Keyspaces", - "contributor": "", - "description": "Adds support for interacting with user-defined types (UDTs) through the following new operations: Create-Type, Delete-Type, List-Types, Get-Type." -} diff --git a/.changes/next-release/feature-AmazonLocationServiceMapsV2-ba57d08.json b/.changes/next-release/feature-AmazonLocationServiceMapsV2-ba57d08.json deleted file mode 100644 index 979fc1642e9d..000000000000 --- a/.changes/next-release/feature-AmazonLocationServiceMapsV2-ba57d08.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Amazon Location Service Maps V2", - "contributor": "", - "description": "Release of Amazon Location Maps API. Maps enables you to build digital maps that showcase your locations, visualize your data, and unlock insights to drive your business" -} diff --git a/.changes/next-release/feature-AmazonLocationServicePlacesV2-97efb00.json b/.changes/next-release/feature-AmazonLocationServicePlacesV2-97efb00.json deleted file mode 100644 index ab5e06bcdd73..000000000000 --- a/.changes/next-release/feature-AmazonLocationServicePlacesV2-97efb00.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Amazon Location Service Places V2", - "contributor": "", - "description": "Release of Amazon Location Places API. Places enables you to quickly search, display, and filter places, businesses, and locations based on proximity, category, and name" -} diff --git a/.changes/next-release/feature-AmazonLocationServiceRoutesV2-1f89504.json b/.changes/next-release/feature-AmazonLocationServiceRoutesV2-1f89504.json deleted file mode 100644 index 479657fd0f93..000000000000 --- a/.changes/next-release/feature-AmazonLocationServiceRoutesV2-1f89504.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Amazon Location Service Routes V2", - "contributor": "", - "description": "Release of Amazon Location Routes API. Routes enables you to plan efficient routes and streamline deliveries by leveraging real-time traffic, vehicle restrictions, and turn-by-turn directions." -} diff --git a/.changes/next-release/feature-AmazonOpenSearchService-b3ce932.json b/.changes/next-release/feature-AmazonOpenSearchService-b3ce932.json deleted file mode 100644 index 988dca013865..000000000000 --- a/.changes/next-release/feature-AmazonOpenSearchService-b3ce932.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Amazon OpenSearch Service", - "contributor": "", - "description": "This release introduces the new OpenSearch user interface (Dashboards), a new web-based application that can be associated with multiple data sources across OpenSearch managed clusters, serverless collections, and Amazon S3, so that users can gain a comprehensive insights in an unified interface." -} diff --git a/.changes/next-release/feature-AmazonRedshift-f6845a7.json b/.changes/next-release/feature-AmazonRedshift-f6845a7.json deleted file mode 100644 index 10b480f71e92..000000000000 --- a/.changes/next-release/feature-AmazonRedshift-f6845a7.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Amazon Redshift", - "contributor": "", - "description": "This release launches S3 event integrations to create and manage integrations from an Amazon S3 source into an Amazon Redshift database." -} diff --git a/.changes/next-release/feature-AmazonRoute53-d97b66b.json b/.changes/next-release/feature-AmazonRoute53-d97b66b.json deleted file mode 100644 index b8394f2aa571..000000000000 --- a/.changes/next-release/feature-AmazonRoute53-d97b66b.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Amazon Route 53", - "contributor": "", - "description": "This release adds support for TLSA, SSHFP, SVCB, and HTTPS record types." -} diff --git a/.changes/next-release/feature-AmazonSageMakerService-82f92b8.json b/.changes/next-release/feature-AmazonSageMakerService-82f92b8.json deleted file mode 100644 index b03536b1a147..000000000000 --- a/.changes/next-release/feature-AmazonSageMakerService-82f92b8.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Amazon SageMaker Service", - "contributor": "", - "description": "Added support for Model Registry Staging construct. Users can define series of stages that models can progress through for model workflows and lifecycle. This simplifies tracking and managing models as they transition through development, testing, and production stages." -} diff --git a/.changes/next-release/feature-AmazonWorkMail-9d747a2.json b/.changes/next-release/feature-AmazonWorkMail-9d747a2.json deleted file mode 100644 index 77b62988e239..000000000000 --- a/.changes/next-release/feature-AmazonWorkMail-9d747a2.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Amazon WorkMail", - "contributor": "", - "description": "This release adds support for Multi-Factor Authentication (MFA) and Personal Access Tokens through integration with AWS IAM Identity Center." -} diff --git a/.changes/next-release/feature-OpenSearchServiceServerless-5750d88.json b/.changes/next-release/feature-OpenSearchServiceServerless-5750d88.json deleted file mode 100644 index afce894bac57..000000000000 --- a/.changes/next-release/feature-OpenSearchServiceServerless-5750d88.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "OpenSearch Service Serverless", - "contributor": "", - "description": "Neo Integration via IAM Identity Center (IdC)" -} diff --git a/.changes/next-release/feature-RedshiftServerless-309f852.json b/.changes/next-release/feature-RedshiftServerless-309f852.json deleted file mode 100644 index 502572c88248..000000000000 --- a/.changes/next-release/feature-RedshiftServerless-309f852.json +++ /dev/null @@ -1,6 +0,0 @@ -{ - "type": "feature", - "category": "Redshift Serverless", - "contributor": "", - "description": "Adds and updates API members for the Redshift Serverless AI-driven scaling and optimization feature using the price-performance target setting." -} diff --git a/CHANGELOG.md b/CHANGELOG.md index d614b4d58d63..285da69c9359 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,4 +1,78 @@ #### 👋 _Looking for changelogs for older versions? You can find them in the [changelogs](./changelogs) directory._ +# __2.29.4__ __2024-10-30__ +## __AWS AppSync__ + - ### Features + - This release adds support for AppSync Event APIs. + +## __AWS DataSync__ + - ### Features + - AWS DataSync now supports Enhanced mode tasks. This task mode supports transfer of virtually unlimited numbers of objects with enhanced metrics, more detailed logs, and higher performance than Basic mode. This mode currently supports transfers between Amazon S3 locations. + +## __AWS Network Firewall__ + - ### Features + - AWS Network Firewall now supports configuring TCP idle timeout + +## __AWS SDK for Java v2__ + - ### Features + - Adds support for tracking feature usage in a new user agent metadata section and adds a base set of features. Where features were already a part of the user agent string, they are now converted to the new format where a feature is represented as a Base64 encoded string. For example, using DynamoDb Enhanced Client was previously recorded as 'hll/ddb-enh' in the user agent, but is now a 'd' in the business metrics metadata section 'm/'. + - Updated endpoint and partition metadata. + +## __Amazon Connect Service__ + - ### Features + - Updated the public documentation for the UserIdentityInfo object to accurately reflect the character limits for the FirstName and LastName fields, which were previously listed as 1-100 characters. + +## __Amazon EC2 Container Service__ + - ### Features + - This release supports service deployments and service revisions which provide a comprehensive view of your Amazon ECS service history. + +## __Amazon Elastic Compute Cloud__ + - ### Features + - This release adds two new capabilities to VPC Security Groups: Security Group VPC Associations and Shared Security Groups. + +## __Amazon Keyspaces__ + - ### Features + - Adds support for interacting with user-defined types (UDTs) through the following new operations: Create-Type, Delete-Type, List-Types, Get-Type. + +## __Amazon Location Service Maps V2__ + - ### Features + - Release of Amazon Location Maps API. Maps enables you to build digital maps that showcase your locations, visualize your data, and unlock insights to drive your business + +## __Amazon Location Service Places V2__ + - ### Features + - Release of Amazon Location Places API. Places enables you to quickly search, display, and filter places, businesses, and locations based on proximity, category, and name + +## __Amazon Location Service Routes V2__ + - ### Features + - Release of Amazon Location Routes API. Routes enables you to plan efficient routes and streamline deliveries by leveraging real-time traffic, vehicle restrictions, and turn-by-turn directions. + +## __Amazon OpenSearch Service__ + - ### Features + - This release introduces the new OpenSearch user interface (Dashboards), a new web-based application that can be associated with multiple data sources across OpenSearch managed clusters, serverless collections, and Amazon S3, so that users can gain a comprehensive insights in an unified interface. + +## __Amazon Redshift__ + - ### Features + - This release launches S3 event integrations to create and manage integrations from an Amazon S3 source into an Amazon Redshift database. + +## __Amazon Route 53__ + - ### Features + - This release adds support for TLSA, SSHFP, SVCB, and HTTPS record types. + +## __Amazon SageMaker Service__ + - ### Features + - Added support for Model Registry Staging construct. Users can define series of stages that models can progress through for model workflows and lifecycle. This simplifies tracking and managing models as they transition through development, testing, and production stages. + +## __Amazon WorkMail__ + - ### Features + - This release adds support for Multi-Factor Authentication (MFA) and Personal Access Tokens through integration with AWS IAM Identity Center. + +## __OpenSearch Service Serverless__ + - ### Features + - Neo Integration via IAM Identity Center (IdC) + +## __Redshift Serverless__ + - ### Features + - Adds and updates API members for the Redshift Serverless AI-driven scaling and optimization feature using the price-performance target setting. + # __2.29.3__ __2024-10-29__ ## __AWS Clean Rooms Service__ - ### Features diff --git a/README.md b/README.md index e6eb415f67ba..5f33a9ccad77 100644 --- a/README.md +++ b/README.md @@ -51,7 +51,7 @@ To automatically manage module versions (currently all modules have the same ver