The names of the metadata types that you can use to filter and group your results. For example, AZ returns a list of Availability Zones.
The name of the dimension. Each Dimension is available for a different Context. For more information, see Context.
The names of the metadata types that you can use to filter and group your results. For example, AZ returns a list of Availability Zones. LINK_ACCOUNT_NAME and SERVICE_CODE can only be used in CostCategoryRule.
The name of the dimension. Each Dimension is available for a different Context. For more information, see Context. LINK_ACCOUNT_NAME and SERVICE_CODE can only be used in CostCategoryRule.
The attributes that apply to a specific dimension value. For example, if the value is a linked account, the attribute is that account name.
", "GetCostAndUsageWithResourcesResponse$DimensionValueAttributes": "The attributes that apply to a specific dimension value. For example, if the value is a linked account, the attribute is that account name.
", - "GetDimensionValuesResponse$DimensionValues": "The filters that you used to filter your request. Some dimensions are available only for a specific context.
If you set the context to COST_AND_USAGE, you can use the following dimensions for searching:
AZ - The Availability Zone. An example is us-east-1a.
DATABASE_ENGINE - The Amazon Relational Database Service database. Examples are Aurora or MySQL.
INSTANCE_TYPE - The type of Amazon EC2 instance. An example is m4.xlarge.
LEGAL_ENTITY_NAME - The name of the organization that sells you Amazon Web Services services, such as Amazon Web Services.
LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the Amazon Web Services ID of the member account.
OPERATING_SYSTEM - The operating system. Examples are Windows or Linux.
OPERATION - The action performed. Examples include RunInstance and CreateBucket.
PLATFORM - The Amazon EC2 operating system. Examples are Windows or Linux.
PURCHASE_TYPE - The reservation type of the purchase to which this usage is related. Examples include On-Demand Instances and Standard Reserved Instances.
SERVICE - The Amazon Web Services service such as Amazon DynamoDB.
USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. The response for the GetDimensionValues operation includes a unit attribute. Examples include GB and Hrs.
USAGE_TYPE_GROUP - The grouping of common usage types. An example is Amazon EC2: CloudWatch – Alarms. The response for this operation includes a unit attribute.
RECORD_TYPE - The different types of charges such as RI fees, usage costs, tax refunds, and credits.
RESOURCE_ID - The unique identifier of the resource. ResourceId is an opt-in feature only available for last 14 days for EC2-Compute Service.
If you set the context to RESERVATIONS, you can use the following dimensions for searching:
AZ - The Availability Zone. An example is us-east-1a.
CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or Linux.
DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments. Valid values are SingleAZ and MultiAZ.
INSTANCE_TYPE - The type of Amazon EC2 instance. An example is m4.xlarge.
LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the Amazon Web Services ID of the member account.
PLATFORM - The Amazon EC2 operating system. Examples are Windows or Linux.
REGION - The Amazon Web Services Region.
SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values are regional or a single Availability Zone.
TAG (Coverage only) - The tags that are associated with a Reserved Instance (RI).
TENANCY - The tenancy of a resource. Examples are shared or dedicated.
If you set the context to SAVINGS_PLANS, you can use the following dimensions for searching:
SAVINGS_PLANS_TYPE - Type of Savings Plans (EC2 Instance or Compute)
PAYMENT_OPTION - Payment option for the given Savings Plans (for example, All Upfront)
REGION - The Amazon Web Services Region.
INSTANCE_TYPE_FAMILY - The family of instances (For example, m5)
LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the Amazon Web Services ID of the member account.
SAVINGS_PLAN_ARN - The unique identifier for your Savings Plan
The filters that you used to filter your request. Some dimensions are available only for a specific context.
If you set the context to COST_AND_USAGE, you can use the following dimensions for searching:
AZ - The Availability Zone. An example is us-east-1a.
DATABASE_ENGINE - The Amazon Relational Database Service database. Examples are Aurora or MySQL.
INSTANCE_TYPE - The type of Amazon EC2 instance. An example is m4.xlarge.
LEGAL_ENTITY_NAME - The name of the organization that sells you Amazon Web Services services, such as Amazon Web Services.
LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the Amazon Web Services ID of the member account.
OPERATING_SYSTEM - The operating system. Examples are Windows or Linux.
OPERATION - The action performed. Examples include RunInstance and CreateBucket.
PLATFORM - The Amazon EC2 operating system. Examples are Windows or Linux.
PURCHASE_TYPE - The reservation type of the purchase to which this usage is related. Examples include On-Demand Instances and Standard Reserved Instances.
SERVICE - The Amazon Web Services service such as Amazon DynamoDB.
USAGE_TYPE - The type of usage. An example is DataTransfer-In-Bytes. The response for the GetDimensionValues operation includes a unit attribute. Examples include GB and Hrs.
USAGE_TYPE_GROUP - The grouping of common usage types. An example is Amazon EC2: CloudWatch – Alarms. The response for this operation includes a unit attribute.
RECORD_TYPE - The different types of charges such as RI fees, usage costs, tax refunds, and credits.
RESOURCE_ID - The unique identifier of the resource. ResourceId is an opt-in feature only available for last 14 days for EC2-Compute Service. You can opt-in by enabling Hourly and Resource Level Data in Cost Management Console preferences.
If you set the context to RESERVATIONS, you can use the following dimensions for searching:
AZ - The Availability Zone. An example is us-east-1a.
CACHE_ENGINE - The Amazon ElastiCache operating system. Examples are Windows or Linux.
DEPLOYMENT_OPTION - The scope of Amazon Relational Database Service deployments. Valid values are SingleAZ and MultiAZ.
INSTANCE_TYPE - The type of Amazon EC2 instance. An example is m4.xlarge.
LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the Amazon Web Services ID of the member account.
PLATFORM - The Amazon EC2 operating system. Examples are Windows or Linux.
REGION - The Amazon Web Services Region.
SCOPE (Utilization only) - The scope of a Reserved Instance (RI). Values are regional or a single Availability Zone.
TAG (Coverage only) - The tags that are associated with a Reserved Instance (RI).
TENANCY - The tenancy of a resource. Examples are shared or dedicated.
If you set the context to SAVINGS_PLANS, you can use the following dimensions for searching:
SAVINGS_PLANS_TYPE - Type of Savings Plans (EC2 Instance or Compute)
PAYMENT_OPTION - Payment option for the given Savings Plans (for example, All Upfront)
REGION - The Amazon Web Services Region.
INSTANCE_TYPE_FAMILY - The family of instances (For example, m5)
LINKED_ACCOUNT - The description in the attribute map that includes the full name of the member account. The value field contains the Amazon Web Services ID of the member account.
SAVINGS_PLAN_ARN - The unique identifier for your Savings Plan
The values that are available for a tag.
If Values and Key aren't specified, the ABSENT MatchOption is applied to all tags. That is, it's filtered on resources with no tags.
If Values is provided and Key isn't specified, the ABSENT MatchOption is applied to the tag Key only. That is, it's filtered on resources without the given tag key.
The values that are available for a tag.
If Values and Key aren't specified, the ABSENT MatchOption is applied to all tags. That is, it's filtered on resources with no tags.
If Key is provided and Values isn't specified, the ABSENT MatchOption is applied to the tag Key only. That is, it's filtered on resources without the given tag key.
The specific Tag to use for Expression.
The period of time that you want the usage and costs for.
", "refs": { - "CostCategory$EffectiveStart": "The effective state data of your Cost Category.
", - "CostCategory$EffectiveEnd": "The effective end data of your Cost Category.
", + "CostCategory$EffectiveStart": "The effective start date of your Cost Category.
", + "CostCategory$EffectiveEnd": "The effective end date of your Cost Category.
", "CostCategoryReference$EffectiveStart": "The Cost Category's effective start date.
", "CostCategoryReference$EffectiveEnd": "The Cost Category's effective end date.
", - "CreateCostCategoryDefinitionResponse$EffectiveStart": "The Cost Category's effective start date.
", + "CreateCostCategoryDefinitionRequest$EffectiveStart": "The Cost Category's effective start date. It can only be a billing start date (first day of the month). If the date isn't provided, it's the first day of the current month. Dates can't be before the previous twelve months, or in the future.
", + "CreateCostCategoryDefinitionResponse$EffectiveStart": "The Cost Category's effective start date. It can only be a billing start date (first day of the month).
", "DeleteCostCategoryDefinitionResponse$EffectiveEnd": "The effective end date of the Cost Category as a result of deleting it. No costs after this date is categorized by the deleted Cost Category.
", "DescribeCostCategoryDefinitionRequest$EffectiveOn": "The date when the Cost Category was effective.
", "ListCostCategoryDefinitionsRequest$EffectiveOn": "The date when the Cost Category was effective.
", - "UpdateCostCategoryDefinitionResponse$EffectiveStart": "The Cost Category's effective start date.
" + "UpdateCostCategoryDefinitionRequest$EffectiveStart": "The Cost Category's effective start date. It can only be a billing start date (first day of the month). If the date isn't provided, it's the first day of the current month. Dates can't be before the previous twelve months, or in the future.
", + "UpdateCostCategoryDefinitionResponse$EffectiveStart": "The Cost Category's effective start date. It can only be a billing start date (first day of the month).
" } } } diff --git a/models/apis/kendra/2019-02-03/docs-2.json b/models/apis/kendra/2019-02-03/docs-2.json index 33b60943e7..842c98fb1b 100644 --- a/models/apis/kendra/2019-02-03/docs-2.json +++ b/models/apis/kendra/2019-02-03/docs-2.json @@ -2,8 +2,8 @@ "version": "2.0", "service": "Amazon Kendra is a service for indexing large document sets.
", "operations": { - "AssociateEntitiesToExperience": "Grants users or groups in your Amazon Web Services SSO identity source access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", - "AssociatePersonasToEntities": "Defines the specific permissions of users or groups in your Amazon Web Services SSO identity source with access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", + "AssociateEntitiesToExperience": "Grants users or groups in your IAM Identity Center identity source access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", + "AssociatePersonasToEntities": "Defines the specific permissions of users or groups in your IAM Identity Center identity source with access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", "BatchDeleteDocument": "Removes one or more documents from an index. The documents must have been added with the BatchPutDocument API.
The documents are deleted asynchronously. You can see the progress of the deletion by using Amazon Web Services CloudWatch. Any error messages related to the processing of the batch are sent to you CloudWatch log.
", "BatchGetDocumentStatus": "Returns the indexing status for one or more documents submitted with the BatchPutDocument API.
When you use the BatchPutDocument API, documents are indexed asynchronously. You can use the BatchGetDocumentStatus API to get the current status of a list of documents so that you can determine if they have been successfully indexed.
You can also use the BatchGetDocumentStatus API to check the status of the BatchDeleteDocument API. When a document is deleted from the index, Amazon Kendra returns NOT_FOUND as the status.
Adds one or more documents to an index.
The BatchPutDocument API enables you to ingest inline documents or a set of documents stored in an Amazon S3 bucket. Use this API to ingest your text and unstructured text into an index, add custom attributes to the documents, and to attach an access control list to the documents added to the index.
The documents are indexed asynchronously. You can see the progress of the batch using Amazon Web Services CloudWatch. Any error messages related to processing the batch are sent to your Amazon Web Services CloudWatch log.
For an example of ingesting inline documents using Python and Java SDKs, see Adding files directly to an index.
", @@ -32,15 +32,15 @@ "DescribeQuerySuggestionsBlockList": "Gets information about a block list used for query suggestions for an index.
This is used to check the current settings that are applied to a block list.
DescribeQuerySuggestionsBlockList is currently not supported in the Amazon Web Services GovCloud (US-West) region.
Gets information on the settings of query suggestions for an index.
This is used to check the current settings applied to query suggestions.
DescribeQuerySuggestionsConfig is currently not supported in the Amazon Web Services GovCloud (US-West) region.
Gets information about an existing Amazon Kendra thesaurus.
", - "DisassociateEntitiesFromExperience": "Prevents users or groups in your Amazon Web Services SSO identity source from accessing your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", - "DisassociatePersonasFromEntities": "Removes the specific permissions of users or groups in your Amazon Web Services SSO identity source with access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", + "DisassociateEntitiesFromExperience": "Prevents users or groups in your IAM Identity Center identity source from accessing your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", + "DisassociatePersonasFromEntities": "Removes the specific permissions of users or groups in your IAM Identity Center identity source with access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", "GetQuerySuggestions": "Fetches the queries that are suggested to your users.
GetQuerySuggestions is currently not supported in the Amazon Web Services GovCloud (US-West) region.
Retrieves search metrics data. The data provides a snapshot of how your users interact with your search application and how effective the application is.
", "ListAccessControlConfigurations": "Lists one or more access control configurations for an index. This includes user and group access information for your documents. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents.
", "ListDataSourceSyncJobs": "Gets statistics about synchronizing a data source connector.
", "ListDataSources": "Lists the data source connectors that you have created.
", "ListEntityPersonas": "Lists specific permissions of users and groups with access to your Amazon Kendra experience.
", - "ListExperienceEntities": "Lists users or groups in your Amazon Web Services SSO identity source that are granted access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", + "ListExperienceEntities": "Lists users or groups in your IAM Identity Center identity source that are granted access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", "ListExperiences": "Lists one or more Amazon Kendra experiences. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", "ListFaqs": "Gets a list of FAQ lists associated with an index.
", "ListGroupsOlderThanOrderingId": "Provides a list of groups that are mapped to users before a given ordering or timestamp identifier.
ListGroupsOlderThanOrderingId is currently not supported in the Amazon Web Services GovCloud (US-West) region.
Lists the users or groups in your Amazon Web Services SSO identity source that failed to properly configure with your Amazon Kendra experience.
" + "AssociateEntitiesToExperienceResponse$FailedEntityList": "Lists the users or groups in your IAM Identity Center identity source that failed to properly configure with your Amazon Kendra experience.
" } }, "AssociateEntitiesToExperienceRequest": { @@ -175,7 +175,7 @@ "AssociateEntityList": { "base": null, "refs": { - "AssociateEntitiesToExperienceRequest$EntityList": "Lists users or groups in your Amazon Web Services SSO identity source.
" + "AssociateEntitiesToExperienceRequest$EntityList": "Lists users or groups in your IAM Identity Center identity source.
" } }, "AssociatePersonasToEntitiesRequest": { @@ -1134,7 +1134,7 @@ "DisassociateEntityList": { "base": null, "refs": { - "DisassociateEntitiesFromExperienceRequest$EntityList": "Lists users or groups in your Amazon Web Services SSO identity source.
" + "DisassociateEntitiesFromExperienceRequest$EntityList": "Lists users or groups in your IAM Identity Center identity source.
" } }, "DisassociatePersonasFromEntitiesRequest": { @@ -1369,7 +1369,7 @@ } }, "EntityConfiguration": { - "base": "Provides the configuration information for users or groups in your Amazon Web Services SSO identity source to grant access your Amazon Kendra experience.
", + "base": "Provides the configuration information for users or groups in your IAM Identity Center identity source to grant access your Amazon Kendra experience.
", "refs": { "AssociateEntityList$member": null, "DisassociateEntityList$member": null @@ -1390,22 +1390,22 @@ "EntityId": { "base": null, "refs": { - "EntityConfiguration$EntityId": "The identifier of a user or group in your Amazon Web Services SSO identity source. For example, a user ID could be an email.
", + "EntityConfiguration$EntityId": "The identifier of a user or group in your IAM Identity Center identity source. For example, a user ID could be an email.
", "EntityIdsList$member": null, - "EntityPersonaConfiguration$EntityId": "The identifier of a user or group in your Amazon Web Services SSO identity source. For example, a user ID could be an email.
", - "ExperienceEntitiesSummary$EntityId": "The identifier of a user or group in your Amazon Web Services SSO identity source. For example, a user ID could be an email.
", - "FailedEntity$EntityId": "The identifier of the user or group in your Amazon Web Services SSO identity source. For example, a user ID could be an email.
", - "PersonasSummary$EntityId": "The identifier of a user or group in your Amazon Web Services SSO identity source. For example, a user ID could be an email.
" + "EntityPersonaConfiguration$EntityId": "The identifier of a user or group in your IAM Identity Center identity source. For example, a user ID could be an email.
", + "ExperienceEntitiesSummary$EntityId": "The identifier of a user or group in your IAM Identity Center identity source. For example, a user ID could be an email.
", + "FailedEntity$EntityId": "The identifier of the user or group in your IAM Identity Center identity source. For example, a user ID could be an email.
", + "PersonasSummary$EntityId": "The identifier of a user or group in your IAM Identity Center identity source. For example, a user ID could be an email.
" } }, "EntityIdsList": { "base": null, "refs": { - "DisassociatePersonasFromEntitiesRequest$EntityIds": "The identifiers of users or groups in your Amazon Web Services SSO identity source. For example, user IDs could be user emails.
" + "DisassociatePersonasFromEntitiesRequest$EntityIds": "The identifiers of users or groups in your IAM Identity Center identity source. For example, user IDs could be user emails.
" } }, "EntityPersonaConfiguration": { - "base": "Provides the configuration information for users or groups in your Amazon Web Services SSO identity source for access to your Amazon Kendra experience. Specific permissions are defined for each user or group once they are granted access to your Amazon Kendra experience.
", + "base": "Provides the configuration information for users or groups in your IAM Identity Center identity source for access to your Amazon Kendra experience. Specific permissions are defined for each user or group once they are granted access to your Amazon Kendra experience.
", "refs": { "EntityPersonaConfigurationList$member": null } @@ -1413,7 +1413,7 @@ "EntityPersonaConfigurationList": { "base": null, "refs": { - "AssociatePersonasToEntitiesRequest$Personas": "The personas that define the specific permissions of users or groups in your Amazon Web Services SSO identity source. The available personas or access roles are Owner and Viewer. For more information on these personas, see Providing access to your search page.
The personas that define the specific permissions of users or groups in your IAM Identity Center identity source. The available personas or access roles are Owner and Viewer. For more information on these personas, see Providing access to your search page.
When the Status field value is FAILED, the ErrorMessage field contains a message that explains why.
The error message containing details if there are issues processing the block list.
", "DescribeThesaurusResponse$ErrorMessage": "When the Status field value is FAILED, the ErrorMessage field provides more information.
The reason the user or group in your Amazon Web Services SSO identity source failed to properly configure with your Amazon Kendra experience.
", + "FailedEntity$ErrorMessage": "The reason the user or group in your IAM Identity Center identity source failed to properly configure with your Amazon Kendra experience.
", "InternalServerException$Message": null, "InvalidRequestException$Message": null, "ResourceAlreadyExistException$Message": null, @@ -1500,7 +1500,7 @@ } }, "ExperienceEntitiesSummary": { - "base": "Summary information for users or groups in your Amazon Web Services SSO identity source with granted access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", + "base": "Summary information for users or groups in your IAM Identity Center identity source with granted access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", "refs": { "ExperienceEntitiesSummaryList$member": null } @@ -1583,7 +1583,7 @@ } }, "FailedEntity": { - "base": "Information on the users or groups in your Amazon Web Services SSO identity source that failed to properly configure with your Amazon Kendra experience.
", + "base": "Information on the users or groups in your IAM Identity Center identity source that failed to properly configure with your Amazon Kendra experience.
", "refs": { "AssociateEntitiesToExperienceFailedEntityList$member": null, "FailedEntityList$member": null @@ -1592,9 +1592,9 @@ "FailedEntityList": { "base": null, "refs": { - "AssociatePersonasToEntitiesResponse$FailedEntityList": "Lists the users or groups in your Amazon Web Services SSO identity source that failed to properly configure with your Amazon Kendra experience.
", - "DisassociateEntitiesFromExperienceResponse$FailedEntityList": "Lists the users or groups in your Amazon Web Services SSO identity source that failed to properly remove access to your Amazon Kendra experience.
", - "DisassociatePersonasFromEntitiesResponse$FailedEntityList": "Lists the users or groups in your Amazon Web Services SSO identity source that failed to properly remove access to your Amazon Kendra experience.
" + "AssociatePersonasToEntitiesResponse$FailedEntityList": "Lists the users or groups in your IAM Identity Center identity source that failed to properly configure with your Amazon Kendra experience.
", + "DisassociateEntitiesFromExperienceResponse$FailedEntityList": "Lists the users or groups in your IAM Identity Center identity source that failed to properly remove access to your Amazon Kendra experience.
", + "DisassociatePersonasFromEntitiesResponse$FailedEntityList": "Lists the users or groups in your IAM Identity Center identity source that failed to properly remove access to your Amazon Kendra experience.
" } }, "FailureReason": { @@ -1832,7 +1832,7 @@ "IdentityAttributeName": { "base": null, "refs": { - "UserIdentityConfiguration$IdentityAttributeName": "The Amazon Web Services SSO field name that contains the identifiers of your users, such as their emails. This is used for user context filtering and for granting access to your Amazon Kendra experience. You must set up Amazon Web Services SSO with Amazon Kendra. You must include your users and groups in your Access Control List when you ingest documents into your index. For more information, see Getting started with an Amazon Web Services SSO identity source.
" + "UserIdentityConfiguration$IdentityAttributeName": "The IAM Identity Center field name that contains the identifiers of your users, such as their emails. This is used for user context filtering and for granting access to your Amazon Kendra experience. You must set up IAM Identity Center with Amazon Kendra. You must include your users and groups in your Access Control List when you ingest documents into your index. For more information, see Getting started with an IAM Identity Center identity source.
" } }, "Importance": { @@ -2498,12 +2498,12 @@ "Persona": { "base": null, "refs": { - "EntityPersonaConfiguration$Persona": "The persona that defines the specific permissions of the user or group in your Amazon Web Services SSO identity source. The available personas or access roles are Owner and Viewer. For more information on these personas, see Providing access to your search page.
The persona that defines the specific permissions of the user or group in your Amazon Web Services SSO identity source. The available personas or access roles are Owner and Viewer. For more information on these personas, see Providing access to your search page.
The persona that defines the specific permissions of the user or group in your IAM Identity Center identity source. The available personas or access roles are Owner and Viewer. For more information on these personas, see Providing access to your search page.
The persona that defines the specific permissions of the user or group in your IAM Identity Center identity source. The available personas or access roles are Owner and Viewer. For more information on these personas, see Providing access to your search page.
Summary information for users or groups in your Amazon Web Services SSO identity source. This applies to users and groups with specific permissions that define their level of access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", + "base": "Summary information for users or groups in your IAM Identity Center identity source. This applies to users and groups with specific permissions that define their level of access to your Amazon Kendra experience. You can create an Amazon Kendra experience such as a search application. For more information on creating a search application experience, see Building a search experience with no code.
", "refs": { "PersonasSummaryList$member": null } @@ -2787,14 +2787,14 @@ "refs": { "BatchPutDocumentRequest$RoleArn": "The Amazon Resource Name (ARN) of a role that is allowed to run the BatchPutDocument API. For more information, see IAM Roles for Amazon Kendra.
The Amazon Resource Name (ARN) of a role with permission to access the data source and required resources. For more information, see IAM roles for Amazon Kendra.
You can't specify the RoleArn parameter when the Type parameter is set to CUSTOM. If you do, you receive a ValidationException exception.
The RoleArn parameter is required for all other data sources.
The Amazon Resource Name (ARN) of a role with permission to access Query API, QuerySuggestions API, SubmitFeedback API, and Amazon Web Services SSO that stores your user and group information. For more information, see IAM roles for Amazon Kendra.
The Amazon Resource Name (ARN) of a role with permission to access Query API, QuerySuggestions API, SubmitFeedback API, and IAM Identity Center that stores your user and group information. For more information, see IAM roles for Amazon Kendra.
The Amazon Resource Name (ARN) of a role with permission to access the S3 bucket that contains the FAQs. For more information, see IAM Roles for Amazon Kendra.
", "CreateIndexRequest$RoleArn": "An Identity and Access Management (IAM) role that gives Amazon Kendra permissions to access your Amazon CloudWatch logs and metrics. This is also the role you use when you call the BatchPutDocument API to index documents from an Amazon S3 bucket.
The IAM (Identity and Access Management) role used by Amazon Kendra to access the block list text file in your S3 bucket.
You need permissions to the role ARN (Amazon Web Services Resource Name). The role needs S3 read permissions to your file in S3 and needs to give STS (Security Token Service) assume role permissions to Amazon Kendra.
", "CreateThesaurusRequest$RoleArn": "An IAM role that gives Amazon Kendra permissions to access thesaurus file specified in SourceS3Path.
The Amazon Resource Name (ARN) of a role with permission to run PreExtractionHookConfiguration and PostExtractionHookConfiguration for altering document metadata and content during the document ingestion process. For more information, see IAM roles for Amazon Kendra.
The Amazon Resource Name (ARN) of the role with permission to access the data source and required resources.
", - "DescribeExperienceResponse$RoleArn": "Shows the Amazon Resource Name (ARN) of a role with permission to access Query API, QuerySuggestions API, SubmitFeedback API, and Amazon Web Services SSO that stores your user and group information.
Shows the Amazon Resource Name (ARN) of a role with permission to access Query API, QuerySuggestions API, SubmitFeedback API, and IAM Identity Center that stores your user and group information.
The Amazon Resource Name (ARN) of the role that provides access to the S3 bucket containing the input files for the FAQ.
", "DescribeIndexResponse$RoleArn": "The Amazon Resource Name (ARN) of the IAM role that gives Amazon Kendra permission to write to your Amazon Cloudwatch logs.
", "DescribeQuerySuggestionsBlockListResponse$RoleArn": "The IAM (Identity and Access Management) role used by Amazon Kendra to access the block list text file in S3.
The role needs S3 read permissions to your file in S3 and needs to give STS (Security Token Service) assume role permissions to Amazon Kendra.
", @@ -2802,7 +2802,7 @@ "JwtTokenTypeConfiguration$SecretManagerArn": "The Amazon Resource Name (arn) of the secret.
", "PutPrincipalMappingRequest$RoleArn": "The Amazon Resource Name (ARN) of a role that has access to the S3 file that contains your list of users or sub groups that belong to a group.
For more information, see IAM roles for Amazon Kendra.
", "UpdateDataSourceRequest$RoleArn": "The Amazon Resource Name (ARN) of a role with permission to access the data source and required resources. For more information, see IAM roles for Amazon Kendra.
", - "UpdateExperienceRequest$RoleArn": "The Amazon Resource Name (ARN) of a role with permission to access Query API, QuerySuggestions API, SubmitFeedback API, and Amazon Web Services SSO that stores your user and group information. For more information, see IAM roles for Amazon Kendra.
The Amazon Resource Name (ARN) of a role with permission to access Query API, QuerySuggestions API, SubmitFeedback API, and IAM Identity Center that stores your user and group information. For more information, see IAM roles for Amazon Kendra.
An Identity and Access Management (IAM) role that gives Amazon Kendra permission to access Amazon CloudWatch logs and metrics.
", "UpdateQuerySuggestionsBlockListRequest$RoleArn": "The IAM (Identity and Access Management) role used to access the block list text file in S3.
", "UpdateThesaurusRequest$RoleArn": "An IAM role that gives Amazon Kendra permissions to access thesaurus file specified in SourceS3Path.
The template schema used for the data source.
The following links to the template schema for data sources where templates are supported:
", + "base": "The template schema used for the data source, where templates schemas are supported.
See Data source template schemas.
", "refs": { - "TemplateConfiguration$Template": "The template schema used for the data source.
The following links to the template schema for data sources where templates are supported:
" + "TemplateConfiguration$Template": "The template schema used for the data source, where templates schemas are supported.
See Data source template schemas.
" } }, "TemplateConfiguration": { @@ -3634,17 +3634,17 @@ } }, "UserGroupResolutionConfiguration": { - "base": "Provides the configuration information to fetch access levels of groups and users from an Amazon Web Services Single Sign On identity source. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents. You can also use the PutPrincipalMapping API to map users to their groups so that you only need to provide the user ID when you issue the query.
To set up an Amazon Web Services SSO identity source in the console to use with Amazon Kendra, see Getting started with an Amazon Web Services SSO identity source. You must also grant the required permissions to use Amazon Web Services SSO with Amazon Kendra. For more information, see IAM roles for Amazon Web Services SSO.
Amazon Kendra currently does not support using UserGroupResolutionConfiguration with an Amazon Web Services organization member account for your Amazon Web Services SSO identify source. You must create your index in the management account for the organization in order to use UserGroupResolutionConfiguration.
Provides the configuration information to fetch access levels of groups and users from an IAM Identity Center (successor to Single Sign-On) identity source. This is useful for user context filtering, where search results are filtered based on the user or their group access to documents. You can also use the PutPrincipalMapping API to map users to their groups so that you only need to provide the user ID when you issue the query.
To set up an IAM Identity Center identity source in the console to use with Amazon Kendra, see Getting started with an IAM Identity Center identity source. You must also grant the required permissions to use IAM Identity Center with Amazon Kendra. For more information, see IAM roles for IAM Identity Center.
Amazon Kendra currently does not support using UserGroupResolutionConfiguration with an Amazon Web Services organization member account for your IAM Identity Center identify source. You must create your index in the management account for the organization in order to use UserGroupResolutionConfiguration.
Enables fetching access levels of groups and users from an Amazon Web Services Single Sign On identity source. To configure this, see UserGroupResolutionConfiguration.
", - "DescribeIndexResponse$UserGroupResolutionConfiguration": "Whether you have enabled the configuration for fetching access levels of groups and users from an Amazon Web Services Single Sign On identity source.
", - "UpdateIndexRequest$UserGroupResolutionConfiguration": "Enables fetching access levels of groups and users from an Amazon Web Services Single Sign On identity source. To configure this, see UserGroupResolutionConfiguration.
" + "CreateIndexRequest$UserGroupResolutionConfiguration": "Enables fetching access levels of groups and users from an IAM Identity Center (successor to Single Sign-On) identity source. To configure this, see UserGroupResolutionConfiguration.
", + "DescribeIndexResponse$UserGroupResolutionConfiguration": "Whether you have enabled the configuration for fetching access levels of groups and users from an IAM Identity Center (successor to Single Sign-On) identity source.
", + "UpdateIndexRequest$UserGroupResolutionConfiguration": "Enables fetching access levels of groups and users from an IAM Identity Center (successor to Single Sign-On) identity source. To configure this, see UserGroupResolutionConfiguration.
" } }, "UserGroupResolutionMode": { "base": null, "refs": { - "UserGroupResolutionConfiguration$UserGroupResolutionMode": "The identity store provider (mode) you want to use to fetch access levels of groups and users. Amazon Web Services Single Sign On is currently the only available mode. Your users and groups must exist in an Amazon Web Services SSO identity source in order to use this mode.
" + "UserGroupResolutionConfiguration$UserGroupResolutionMode": "The identity store provider (mode) you want to use to fetch access levels of groups and users. IAM Identity Center (successor to Single Sign-On) is currently the only available mode. Your users and groups must exist in an IAM Identity Center identity source in order to use this mode.
" } }, "UserId": { @@ -3656,7 +3656,7 @@ "UserIdentityConfiguration": { "base": "Provides the configuration information for the identifiers of your users.
", "refs": { - "ExperienceConfiguration$UserIdentityConfiguration": "The Amazon Web Services SSO field name that contains the identifiers of your users, such as their emails.
" + "ExperienceConfiguration$UserIdentityConfiguration": "The IAM Identity Center field name that contains the identifiers of your users, such as their emails.
" } }, "UserNameAttributeField": { diff --git a/models/apis/location/2020-11-19/api-2.json b/models/apis/location/2020-11-19/api-2.json index 46332daa98..0643877c4c 100644 --- a/models/apis/location/2020-11-19/api-2.json +++ b/models/apis/location/2020-11-19/api-2.json @@ -600,6 +600,24 @@ ], "endpoint":{"hostPrefix":"maps."} }, + "GetPlace":{ + "name":"GetPlace", + "http":{ + "method":"GET", + "requestUri":"/places/v0/indexes/{IndexName}/places/{PlaceId}", + "responseCode":200 + }, + "input":{"shape":"GetPlaceRequest"}, + "output":{"shape":"GetPlaceResponse"}, + "errors":[ + {"shape":"InternalServerException"}, + {"shape":"ResourceNotFoundException"}, + {"shape":"AccessDeniedException"}, + {"shape":"ValidationException"}, + {"shape":"ThrottlingException"} + ], + "endpoint":{"hostPrefix":"places."} + }, "ListDevicePositions":{ "name":"ListDevicePositions", "http":{ @@ -1610,7 +1628,7 @@ ], "members":{ "CreateTime":{"shape":"Timestamp"}, - "MapArn":{"shape":"Arn"}, + "MapArn":{"shape":"GeoArn"}, "MapName":{"shape":"ResourceName"} } }, @@ -1864,7 +1882,7 @@ "CreateTime":{"shape":"Timestamp"}, "DataSource":{"shape":"String"}, "Description":{"shape":"ResourceDescription"}, - "MapArn":{"shape":"Arn"}, + "MapArn":{"shape":"GeoArn"}, "MapName":{"shape":"ResourceName"}, "PricingPlan":{ "shape":"PricingPlan", @@ -2067,6 +2085,12 @@ "type":"double", "box":true }, + "GeoArn":{ + "type":"string", + "max":1600, + "min":0, + "pattern":"^arn(:[a-z0-9]+([.-][a-z0-9]+)*):geo(:([a-z0-9]+([.-][a-z0-9]+)*))(:[0-9]+):((\\*)|([-a-z]+[/][*-._\\w]+))$" + }, "GeofenceGeometry":{ "type":"structure", "members":{ @@ -2336,6 +2360,37 @@ }, "payload":"Blob" }, + "GetPlaceRequest":{ + "type":"structure", + "required":[ + "IndexName", + "PlaceId" + ], + "members":{ + "IndexName":{ + "shape":"ResourceName", + "location":"uri", + "locationName":"IndexName" + }, + "Language":{ + "shape":"LanguageTag", + "location":"querystring", + "locationName":"language" + }, + "PlaceId":{ + "shape":"PlaceId", + "location":"uri", + "locationName":"PlaceId" + } + } + }, + "GetPlaceResponse":{ + "type":"structure", + "required":["Place"], + "members":{ + "Place":{"shape":"Place"} + } + }, "Id":{ "type":"string", "max":100, @@ -2837,7 +2892,9 @@ "Region":{"shape":"String"}, "Street":{"shape":"String"}, "SubRegion":{"shape":"String"}, - "TimeZone":{"shape":"TimeZone"} + "TimeZone":{"shape":"TimeZone"}, + "UnitNumber":{"shape":"String"}, + "UnitType":{"shape":"String"} } }, "PlaceGeometry":{ @@ -2846,6 +2903,7 @@ "Point":{"shape":"Position"} } }, + "PlaceId":{"type":"string"}, "PlaceIndexSearchResultLimit":{ "type":"integer", "max":50, @@ -3018,7 +3076,8 @@ ], "members":{ "Distance":{"shape":"SearchForPositionResultDistanceDouble"}, - "Place":{"shape":"Place"} + "Place":{"shape":"Place"}, + "PlaceId":{"shape":"PlaceId"} } }, "SearchForPositionResultDistanceDouble":{ @@ -3034,6 +3093,7 @@ "type":"structure", "required":["Text"], "members":{ + "PlaceId":{"shape":"PlaceId"}, "Text":{"shape":"String"} } }, @@ -3047,6 +3107,7 @@ "members":{ "Distance":{"shape":"SearchForTextResultDistanceDouble"}, "Place":{"shape":"Place"}, + "PlaceId":{"shape":"PlaceId"}, "Relevance":{"shape":"SearchForTextResultRelevanceDouble"} } }, @@ -3480,7 +3541,7 @@ "UpdateTime" ], "members":{ - "MapArn":{"shape":"Arn"}, + "MapArn":{"shape":"GeoArn"}, "MapName":{"shape":"ResourceName"}, "UpdateTime":{"shape":"Timestamp"} } diff --git a/models/apis/location/2020-11-19/docs-2.json b/models/apis/location/2020-11-19/docs-2.json index 0803f7c517..6bc1690e39 100644 --- a/models/apis/location/2020-11-19/docs-2.json +++ b/models/apis/location/2020-11-19/docs-2.json @@ -34,6 +34,7 @@ "GetMapSprites": "Retrieves the sprite sheet corresponding to a map resource. The sprite sheet is a PNG image paired with a JSON document describing the offsets of individual icons that will be displayed on a rendered map.
", "GetMapStyleDescriptor": "Retrieves the map style descriptor from a map resource.
The style descriptor contains specifications on how features render on a map. For example, what data to display, what order to display the data in, and the style for the data. Style descriptors follow the Mapbox Style Specification.
", "GetMapTile": "Retrieves a vector data tile from the map resource. 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.
The origin (0, 0) is the top left of the map. Increasing the zoom level by 1 doubles both the X and Y dimensions, so a tile containing data for the entire world at (0/0/0) will be split into 4 tiles at zoom 1 (1/0/0, 1/0/1, 1/1/0, 1/1/1).
", + "GetPlace": "Finds a place by its unique ID. A PlaceId is returned by other search operations.
A PlaceId is valid only if all of the following are the same in the original search request and the call to GetPlace.
Customer AWS account
AWS Region
Data provider specified in the place index resource
A batch request to retrieve all device positions.
", "ListGeofenceCollections": "Lists geofence collections in your AWS account.
", "ListGeofences": "Lists geofences stored in a given geofence collection.
", @@ -67,12 +68,10 @@ "ArnList$member": null, "AssociateTrackerConsumerRequest$ConsumerArn": "The Amazon Resource Name (ARN) for the geofence collection to be associated to tracker resource. Used when you need to specify a resource across all AWS.
Format example: arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollectionConsumer
The Amazon Resource Name (ARN) for the geofence collection resource. Used when you need to specify a resource across all AWS.
Format example: arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollection
The Amazon Resource Name (ARN) for the map resource. Used to specify a resource across all AWS.
Format example: arn:aws:geo:region:account-id:maps/ExampleMap
The Amazon Resource Name (ARN) for the place index resource. Used to specify a resource across AWS.
Format example: arn:aws:geo:region:account-id:place-index/ExamplePlaceIndex
The Amazon Resource Name (ARN) for the route calculator resource. Use the ARN when you specify a resource across all AWS.
Format example: arn:aws:geo:region:account-id:route-calculator/ExampleCalculator
The Amazon Resource Name (ARN) for the tracker resource. Used when you need to specify a resource across all AWS.
Format example: arn:aws:geo:region:account-id:tracker/ExampleTracker
The Amazon Resource Name (ARN) for the geofence collection resource. Used when you need to specify a resource across all AWS.
Format example: arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollection
The Amazon Resource Name (ARN) for the map resource. Used to specify a resource across all AWS.
Format example: arn:aws:geo:region:account-id:maps/ExampleMap
The Amazon Resource Name (ARN) for the place index resource. Used to specify a resource across AWS.
Format example: arn:aws:geo:region:account-id:place-index/ExamplePlaceIndex
The Amazon Resource Name (ARN) for the Route calculator resource. Use the ARN when you specify a resource across AWS.
Format example: arn:aws:geo:region:account-id:route-calculator/ExampleCalculator
The Amazon Resource Name (ARN) for the tracker resource. Used when you need to specify a resource across all AWS.
Format example: arn:aws:geo:region:account-id:tracker/ExampleTracker
The Amazon Resource Name (ARN) of the resource whose tags you want to update.
Format example: arn:aws:geo:region:account-id:resourcetype/ExampleResource
The Amazon Resource Name (ARN) of the resource from which you want to remove tags.
Format example: arn:aws:geo:region:account-id:resourcetype/ExampleResource
The Amazon Resource Name (ARN) of the updated geofence collection. Used to specify a resource across AWS.
Format example: arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollection
The Amazon Resource Name (ARN) of the updated map resource. Used to specify a resource across AWS.
Format example: arn:aws:geo:region:account-id:maps/ExampleMap
The Amazon Resource Name (ARN) of the upated place index resource. Used to specify a resource across AWS.
Format example: arn:aws:geo:region:account-id:place- index/ExamplePlaceIndex
The Amazon Resource Name (ARN) of the updated route calculator resource. Used to specify a resource across AWS.
Format example: arn:aws:geo:region:account-id:route- calculator/ExampleCalculator
The Amazon Resource Name (ARN) of the updated tracker resource. Used to specify a resource across AWS.
Format example: arn:aws:geo:region:account-id:tracker/ExampleTracker
The Amazon Resource Name (ARN) for the map resource. Used to specify a resource across all AWS.
Format example: arn:aws:geo:region:account-id:maps/ExampleMap
The Amazon Resource Name (ARN) for the map resource. Used to specify a resource across all AWS.
Format example: arn:aws:geo:region:account-id:maps/ExampleMap
The Amazon Resource Name (ARN) of the updated map resource. Used to specify a resource across AWS.
Format example: arn:aws:geo:region:account-id:maps/ExampleMap
Contains the geofence geometry details.
A geofence geometry is made up of either a polygon or a circle. Can be either a polygon or a circle. Including both will return a validation error.
Amazon Location doesn't currently support polygons with holes, multipolygons, polygons that are wound clockwise, or that cross the antimeridian.
The name of the sprite file. Use the following file names for the sprite sheet:
sprites.png
sprites@2x.png for high pixel density displays
For the JSON document contain image offsets. Use the following file names:
sprites.json
sprites@2x.json for high pixel density displays
The name of the sprite file. Use the following file names for the sprite sheet:
sprites.png
sprites@2x.png for high pixel density displays
For the JSON document containing image offsets. Use the following file names:
sprites.json
sprites@2x.json for high pixel density displays
The preferred language used to return results. The value must be a valid BCP 47 language tag, for example, en for English.
This setting affects the languages used in the results, but not the results themselves. If no language is specified, or not supported for a particular result, the partner automatically chooses a language for the result.
For an example, we'll use the Greek language. You search for a location around Athens, Greece, with the language parameter set to en. The city in the results will most likely be returned as Athens.
If you set the language parameter to el, for Greek, then the city in the results will more likely be returned as Αθήνα.
If the data provider does not have a value for Greek, the result will be in a language that the provider does support.
", "SearchPlaceIndexForPositionRequest$Language": "The preferred language used to return results. The value must be a valid BCP 47 language tag, for example, en for English.
This setting affects the languages used in the results, but not the results themselves. If no language is specified, or not supported for a particular result, the partner automatically chooses a language for the result.
For an example, we'll use the Greek language. You search for a location around Athens, Greece, with the language parameter set to en. The city in the results will most likely be returned as Athens.
If you set the language parameter to el, for Greek, then the city in the results will more likely be returned as Αθήνα.
If the data provider does not have a value for Greek, the result will be in a language that the provider does support.
", "SearchPlaceIndexForPositionSummary$Language": "The preferred language used to return results. Matches the language in the request. The value is a valid BCP 47 language tag, for example, en for English.
The preferred language used to return results. The value must be a valid BCP 47 language tag, for example, en for English.
This setting affects the languages used in the results. If no language is specified, or not supported for a particular result, the partner automatically chooses a language for the result.
For an example, we'll use the Greek language. You search for Athens, Gr to get suggestions with the language parameter set to en. The results found will most likely be returned as Athens, Greece.
If you set the language parameter to el, for Greek, then the result found will more likely be returned as Αθήνα, Ελλάδα.
If the data provider does not have a value for Greek, the result will be in a language that the provider does support.
", @@ -1148,6 +1165,7 @@ "Place": { "base": "Contains details about addresses or points of interest that match the search criteria.
Not all details are included with all responses. Some details may only be returned by specific data partners.
", "refs": { + "GetPlaceResponse$Place": "Details about the result, such as its address and position.
", "SearchForPositionResult$Place": "Details about the search result, such as its address and position.
", "SearchForTextResult$Place": "Details about the search result, such as its address and position.
" } @@ -1158,6 +1176,15 @@ "Place$Geometry": null } }, + "PlaceId": { + "base": null, + "refs": { + "GetPlaceRequest$PlaceId": "The identifier of the place to find.
", + "SearchForPositionResult$PlaceId": "The unique identifier of the place. You can use this with the GetPlace operation to find the place again later.
For SearchPlaceIndexForPosition operations, the PlaceId is returned only by place indexes that use HERE as a data provider.
The unique identifier of the place. You can use this with the GetPlace operation to find the place again later.
For SearchPlaceIndexForSuggestions operations, the PlaceId is returned by place indexes that use HERE or Esri as data providers.
The unique identifier of the place. You can use this with the GetPlace operation to find the place again later.
For SearchPlaceIndexForText operations, the PlaceId is returned only by place indexes that use HERE as a data provider.
The map resource associated with the sprite file.
", "GetMapStyleDescriptorRequest$MapName": "The map resource to retrieve the style descriptor from.
", "GetMapTileRequest$MapName": "The map resource to retrieve the map tiles from.
", + "GetPlaceRequest$IndexName": "The name of the place index resource that you want to use for the search.
", "ListDevicePositionsRequest$TrackerName": "The tracker resource containing the requested devices.
", "ListGeofenceCollectionsResponseEntry$CollectionName": "The name of the geofence collection.
", "ListGeofencesRequest$CollectionName": "The name of the geofence collection storing the list of geofences.
", @@ -1617,6 +1645,8 @@ "Place$Region": "A name for an area or geographical division, such as a province or state name. For example, British Columbia.
The name for a street or a road to identify a location. For example, Main Street.
A country, or an area that's part of a larger region. For example, Metro Vancouver.
For addresses with multiple units, the unit identifier. Can include numbers and letters, for example 3B or Unit 123.
Returned only for a place index that uses Esri as a data provider. Is not returned for SearchPlaceIndexForPosition.
For addresses with a UnitNumber, the type of unit. For example, Apartment.
A message about the error that occurred for the route calculation.
", "SearchForSuggestionsResult$Text": "The text of the place suggestion, typically formatted as an address string.
", diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index ab4b9716bb..a737e8e29c 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -1418,10 +1418,23 @@ }, "ca-central-1" : { "variants" : [ { + "hostname" : "appmesh-fips.ca-central-1.amazonaws.com", + "tags" : [ "fips" ] + }, { + "hostname" : "appmesh-fips.ca-central-1.api.aws", + "tags" : [ "dualstack", "fips" ] + }, { "hostname" : "appmesh.ca-central-1.api.aws", "tags" : [ "dualstack" ] } ] }, + "ca-central-1-fips" : { + "credentialScope" : { + "region" : "ca-central-1" + }, + "deprecated" : true, + "hostname" : "appmesh-fips.ca-central-1.amazonaws.com" + }, "eu-central-1" : { "variants" : [ { "hostname" : "appmesh.eu-central-1.api.aws", @@ -1472,27 +1485,79 @@ }, "us-east-1" : { "variants" : [ { + "hostname" : "appmesh-fips.us-east-1.amazonaws.com", + "tags" : [ "fips" ] + }, { + "hostname" : "appmesh-fips.us-east-1.api.aws", + "tags" : [ "dualstack", "fips" ] + }, { "hostname" : "appmesh.us-east-1.api.aws", "tags" : [ "dualstack" ] } ] }, + "us-east-1-fips" : { + "credentialScope" : { + "region" : "us-east-1" + }, + "deprecated" : true, + "hostname" : "appmesh-fips.us-east-1.amazonaws.com" + }, "us-east-2" : { "variants" : [ { + "hostname" : "appmesh-fips.us-east-2.amazonaws.com", + "tags" : [ "fips" ] + }, { + "hostname" : "appmesh-fips.us-east-2.api.aws", + "tags" : [ "dualstack", "fips" ] + }, { "hostname" : "appmesh.us-east-2.api.aws", "tags" : [ "dualstack" ] } ] }, + "us-east-2-fips" : { + "credentialScope" : { + "region" : "us-east-2" + }, + "deprecated" : true, + "hostname" : "appmesh-fips.us-east-2.amazonaws.com" + }, "us-west-1" : { "variants" : [ { + "hostname" : "appmesh-fips.us-west-1.amazonaws.com", + "tags" : [ "fips" ] + }, { + "hostname" : "appmesh-fips.us-west-1.api.aws", + "tags" : [ "dualstack", "fips" ] + }, { "hostname" : "appmesh.us-west-1.api.aws", "tags" : [ "dualstack" ] } ] }, + "us-west-1-fips" : { + "credentialScope" : { + "region" : "us-west-1" + }, + "deprecated" : true, + "hostname" : "appmesh-fips.us-west-1.amazonaws.com" + }, "us-west-2" : { "variants" : [ { + "hostname" : "appmesh-fips.us-west-2.amazonaws.com", + "tags" : [ "fips" ] + }, { + "hostname" : "appmesh-fips.us-west-2.api.aws", + "tags" : [ "dualstack", "fips" ] + }, { "hostname" : "appmesh.us-west-2.api.aws", "tags" : [ "dualstack" ] } ] + }, + "us-west-2-fips" : { + "credentialScope" : { + "region" : "us-west-2" + }, + "deprecated" : true, + "hostname" : "appmesh-fips.us-west-2.amazonaws.com" } } }, @@ -5504,8 +5569,25 @@ "ap-northeast-2" : { }, "ap-south-1" : { }, "ap-southeast-1" : { }, + "ap-southeast-2" : { }, + "ca-central-1" : { + "variants" : [ { + "hostname" : "emr-serverless-fips.ca-central-1.amazonaws.com", + "tags" : [ "fips" ] + } ] + }, "eu-central-1" : { }, + "eu-north-1" : { }, "eu-west-1" : { }, + "eu-west-2" : { }, + "eu-west-3" : { }, + "fips-ca-central-1" : { + "credentialScope" : { + "region" : "ca-central-1" + }, + "deprecated" : true, + "hostname" : "emr-serverless-fips.ca-central-1.amazonaws.com" + }, "fips-us-east-1" : { "credentialScope" : { "region" : "us-east-1" @@ -5520,6 +5602,13 @@ "deprecated" : true, "hostname" : "emr-serverless-fips.us-east-2.amazonaws.com" }, + "fips-us-west-1" : { + "credentialScope" : { + "region" : "us-west-1" + }, + "deprecated" : true, + "hostname" : "emr-serverless-fips.us-west-1.amazonaws.com" + }, "fips-us-west-2" : { "credentialScope" : { "region" : "us-west-2" @@ -5540,6 +5629,12 @@ "tags" : [ "fips" ] } ] }, + "us-west-1" : { + "variants" : [ { + "hostname" : "emr-serverless-fips.us-west-1.amazonaws.com", + "tags" : [ "fips" ] + } ] + }, "us-west-2" : { "variants" : [ { "hostname" : "emr-serverless-fips.us-west-2.amazonaws.com", diff --git a/service/costexplorer/api.go b/service/costexplorer/api.go index 72328dc056..5fbffa1915 100644 --- a/service/costexplorer/api.go +++ b/service/costexplorer/api.go @@ -4054,10 +4054,10 @@ type CostCategory struct { // The default value for the cost category. DefaultValue *string `min:"1" type:"string"` - // The effective end data of your Cost Category. + // The effective end date of your Cost Category. EffectiveEnd *string `min:"20" type:"string"` - // The effective state data of your Cost Category. + // The effective start date of your Cost Category. // // EffectiveStart is a required field EffectiveStart *string `min:"20" type:"string" required:"true"` @@ -5223,6 +5223,12 @@ type CreateCostCategoryDefinitionInput struct { // The default value for the cost category. DefaultValue *string `min:"1" type:"string"` + // The Cost Category's effective start date. It can only be a billing start + // date (first day of the month). If the date isn't provided, it's the first + // day of the current month. Dates can't be before the previous twelve months, + // or in the future. + EffectiveStart *string `min:"20" type:"string"` + // The unique name of the Cost Category. // // Name is a required field @@ -5294,6 +5300,9 @@ func (s *CreateCostCategoryDefinitionInput) Validate() error { if s.DefaultValue != nil && len(*s.DefaultValue) < 1 { invalidParams.Add(request.NewErrParamMinLen("DefaultValue", 1)) } + if s.EffectiveStart != nil && len(*s.EffectiveStart) < 20 { + invalidParams.Add(request.NewErrParamMinLen("EffectiveStart", 20)) + } if s.Name == nil { invalidParams.Add(request.NewErrParamRequired("Name")) } @@ -5355,6 +5364,12 @@ func (s *CreateCostCategoryDefinitionInput) SetDefaultValue(v string) *CreateCos return s } +// SetEffectiveStart sets the EffectiveStart field's value. +func (s *CreateCostCategoryDefinitionInput) SetEffectiveStart(v string) *CreateCostCategoryDefinitionInput { + s.EffectiveStart = &v + return s +} + // SetName sets the Name field's value. func (s *CreateCostCategoryDefinitionInput) SetName(v string) *CreateCostCategoryDefinitionInput { s.Name = &v @@ -5391,7 +5406,8 @@ type CreateCostCategoryDefinitionOutput struct { // The unique identifier for your newly created Cost Category. CostCategoryArn *string `min:"20" type:"string"` - // The Cost Category's effective start date. + // The Cost Category's effective start date. It can only be a billing start + // date (first day of the month). EffectiveStart *string `min:"20" type:"string"` } @@ -6006,7 +6022,8 @@ type DimensionValues struct { _ struct{} `type:"structure"` // The names of the metadata types that you can use to filter and group your - // results. For example, AZ returns a list of Availability Zones. + // results. For example, AZ returns a list of Availability Zones. LINK_ACCOUNT_NAME + // and SERVICE_CODE can only be used in CostCategoryRule (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/AAPI_CostCategoryRule.html). Key *string `type:"string" enum:"Dimension"` // The match options that you can use to filter your results. MatchOptions is @@ -8273,7 +8290,8 @@ type GetDimensionValuesInput struct { Context *string `type:"string" enum:"Context"` // The name of the dimension. Each Dimension is available for a different Context. - // For more information, see Context. + // For more information, see Context. LINK_ACCOUNT_NAME and SERVICE_CODE can + // only be used in CostCategoryRule (https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/AAPI_CostCategoryRule.html). // // Dimension is a required field Dimension *string `type:"string" required:"true" enum:"Dimension"` @@ -8516,6 +8534,8 @@ type GetDimensionValuesOutput struct { // // * RESOURCE_ID - The unique identifier of the resource. ResourceId is an // opt-in feature only available for last 14 days for EC2-Compute Service. + // You can opt-in by enabling Hourly and Resource Level Data in Cost Management + // Console preferences. // // If you set the context to RESERVATIONS, you can use the following dimensions // for searching: @@ -14536,7 +14556,7 @@ func (s TagResourceOutput) GoString() string { // If Values and Key aren't specified, the ABSENT MatchOption is applied to // all tags. That is, it's filtered on resources with no tags. // -// If Values is provided and Key isn't specified, the ABSENT MatchOption is +// If Key is provided and Values isn't specified, the ABSENT MatchOption is // applied to the tag Key only. That is, it's filtered on resources without // the given tag key. type TagValues struct { @@ -15518,6 +15538,12 @@ type UpdateCostCategoryDefinitionInput struct { // The default value for the cost category. DefaultValue *string `min:"1" type:"string"` + // The Cost Category's effective start date. It can only be a billing start + // date (first day of the month). If the date isn't provided, it's the first + // day of the current month. Dates can't be before the previous twelve months, + // or in the future. + EffectiveStart *string `min:"20" type:"string"` + // The rule schema version in this particular Cost Category. // // RuleVersion is a required field @@ -15564,6 +15590,9 @@ func (s *UpdateCostCategoryDefinitionInput) Validate() error { if s.DefaultValue != nil && len(*s.DefaultValue) < 1 { invalidParams.Add(request.NewErrParamMinLen("DefaultValue", 1)) } + if s.EffectiveStart != nil && len(*s.EffectiveStart) < 20 { + invalidParams.Add(request.NewErrParamMinLen("EffectiveStart", 20)) + } if s.RuleVersion == nil { invalidParams.Add(request.NewErrParamRequired("RuleVersion")) } @@ -15615,6 +15644,12 @@ func (s *UpdateCostCategoryDefinitionInput) SetDefaultValue(v string) *UpdateCos return s } +// SetEffectiveStart sets the EffectiveStart field's value. +func (s *UpdateCostCategoryDefinitionInput) SetEffectiveStart(v string) *UpdateCostCategoryDefinitionInput { + s.EffectiveStart = &v + return s +} + // SetRuleVersion sets the RuleVersion field's value. func (s *UpdateCostCategoryDefinitionInput) SetRuleVersion(v string) *UpdateCostCategoryDefinitionInput { s.RuleVersion = &v @@ -15639,7 +15674,8 @@ type UpdateCostCategoryDefinitionOutput struct { // The unique identifier for your Cost Category. CostCategoryArn *string `min:"20" type:"string"` - // The Cost Category's effective start date. + // The Cost Category's effective start date. It can only be a billing start + // date (first day of the month). EffectiveStart *string `min:"20" type:"string"` } diff --git a/service/kendra/api.go b/service/kendra/api.go index d5a08d000c..4ff523fa5e 100644 --- a/service/kendra/api.go +++ b/service/kendra/api.go @@ -56,7 +56,7 @@ func (c *Kendra) AssociateEntitiesToExperienceRequest(input *AssociateEntitiesTo // AssociateEntitiesToExperience API operation for AWSKendraFrontendService. // -// Grants users or groups in your Amazon Web Services SSO identity source access +// Grants users or groups in your IAM Identity Center identity source access // to your Amazon Kendra experience. You can create an Amazon Kendra experience // such as a search application. For more information on creating a search application // experience, see Building a search experience with no code (https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html). @@ -147,11 +147,11 @@ func (c *Kendra) AssociatePersonasToEntitiesRequest(input *AssociatePersonasToEn // AssociatePersonasToEntities API operation for AWSKendraFrontendService. // -// Defines the specific permissions of users or groups in your Amazon Web Services -// SSO identity source with access to your Amazon Kendra experience. You can -// create an Amazon Kendra experience such as a search application. For more -// information on creating a search application experience, see Building a search -// experience with no code (https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html). +// Defines the specific permissions of users or groups in your IAM Identity +// Center identity source with access to your Amazon Kendra experience. You +// can create an Amazon Kendra experience such as a search application. For +// more information on creating a search application experience, see Building +// a search experience with no code (https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -2881,8 +2881,8 @@ func (c *Kendra) DisassociateEntitiesFromExperienceRequest(input *DisassociateEn // DisassociateEntitiesFromExperience API operation for AWSKendraFrontendService. // -// Prevents users or groups in your Amazon Web Services SSO identity source -// from accessing your Amazon Kendra experience. You can create an Amazon Kendra +// Prevents users or groups in your IAM Identity Center identity source from +// accessing your Amazon Kendra experience. You can create an Amazon Kendra // experience such as a search application. For more information on creating // a search application experience, see Building a search experience with no // code (https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html). @@ -2971,11 +2971,11 @@ func (c *Kendra) DisassociatePersonasFromEntitiesRequest(input *DisassociatePers // DisassociatePersonasFromEntities API operation for AWSKendraFrontendService. // -// Removes the specific permissions of users or groups in your Amazon Web Services -// SSO identity source with access to your Amazon Kendra experience. You can -// create an Amazon Kendra experience such as a search application. For more -// information on creating a search application experience, see Building a search -// experience with no code (https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html). +// Removes the specific permissions of users or groups in your IAM Identity +// Center identity source with access to your Amazon Kendra experience. You +// can create an Amazon Kendra experience such as a search application. For +// more information on creating a search application experience, see Building +// a search experience with no code (https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions // with awserr.Error's Code and Message methods to get detailed information about @@ -3881,8 +3881,8 @@ func (c *Kendra) ListExperienceEntitiesRequest(input *ListExperienceEntitiesInpu // ListExperienceEntities API operation for AWSKendraFrontendService. // -// Lists users or groups in your Amazon Web Services SSO identity source that -// are granted access to your Amazon Kendra experience. You can create an Amazon +// Lists users or groups in your IAM Identity Center identity source that are +// granted access to your Amazon Kendra experience. You can create an Amazon // Kendra experience such as a search application. For more information on creating // a search application experience, see Building a search experience with no // code (https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html). @@ -6839,7 +6839,7 @@ func (s *AlfrescoConfiguration) SetWikiFieldMappings(v []*DataSourceToIndexField type AssociateEntitiesToExperienceInput struct { _ struct{} `type:"structure"` - // Lists users or groups in your Amazon Web Services SSO identity source. + // Lists users or groups in your IAM Identity Center identity source. // // EntityList is a required field EntityList []*EntityConfiguration `min:"1" type:"list" required:"true"` @@ -6932,8 +6932,8 @@ func (s *AssociateEntitiesToExperienceInput) SetIndexId(v string) *AssociateEnti type AssociateEntitiesToExperienceOutput struct { _ struct{} `type:"structure"` - // Lists the users or groups in your Amazon Web Services SSO identity source - // that failed to properly configure with your Amazon Kendra experience. + // Lists the users or groups in your IAM Identity Center identity source that + // failed to properly configure with your Amazon Kendra experience. FailedEntityList []*FailedEntity `min:"1" type:"list"` } @@ -6975,8 +6975,8 @@ type AssociatePersonasToEntitiesInput struct { IndexId *string `min:"36" type:"string" required:"true"` // The personas that define the specific permissions of users or groups in your - // Amazon Web Services SSO identity source. The available personas or access - // roles are Owner and Viewer. For more information on these personas, see Providing + // IAM Identity Center identity source. The available personas or access roles + // are Owner and Viewer. For more information on these personas, see Providing // access to your search page (https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html#access-search-experience). // // Personas is a required field @@ -7060,8 +7060,8 @@ func (s *AssociatePersonasToEntitiesInput) SetPersonas(v []*EntityPersonaConfigu type AssociatePersonasToEntitiesOutput struct { _ struct{} `type:"structure"` - // Lists the users or groups in your Amazon Web Services SSO identity source - // that failed to properly configure with your Amazon Kendra experience. + // Lists the users or groups in your IAM Identity Center identity source that + // failed to properly configure with your Amazon Kendra experience. FailedEntityList []*FailedEntity `min:"1" type:"list"` } @@ -10195,9 +10195,9 @@ type CreateExperienceInput struct { Name *string `min:"1" type:"string" required:"true"` // The Amazon Resource Name (ARN) of a role with permission to access Query - // API, QuerySuggestions API, SubmitFeedback API, and Amazon Web Services SSO - // that stores your user and group information. For more information, see IAM - // roles for Amazon Kendra (https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html). + // API, QuerySuggestions API, SubmitFeedback API, and IAM Identity Center that + // stores your user and group information. For more information, see IAM roles + // for Amazon Kendra (https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html). RoleArn *string `type:"string"` } @@ -10584,8 +10584,8 @@ type CreateIndexInput struct { // to the user will be searchable and displayable. UserContextPolicy *string `type:"string" enum:"UserContextPolicy"` - // Enables fetching access levels of groups and users from an Amazon Web Services - // Single Sign On identity source. To configure this, see UserGroupResolutionConfiguration + // Enables fetching access levels of groups and users from an IAM Identity Center + // (successor to Single Sign-On) identity source. To configure this, see UserGroupResolutionConfiguration // (https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html). UserGroupResolutionConfiguration *UserGroupResolutionConfiguration `type:"structure"` @@ -13406,8 +13406,8 @@ type DescribeExperienceOutput struct { Name *string `min:"1" type:"string"` // Shows the Amazon Resource Name (ARN) of a role with permission to access - // Query API, QuerySuggestions API, SubmitFeedback API, and Amazon Web Services - // SSO that stores your user and group information. + // Query API, QuerySuggestions API, SubmitFeedback API, and IAM Identity Center + // that stores your user and group information. RoleArn *string `type:"string"` // The current processing status of your Amazon Kendra experience. When the @@ -13812,7 +13812,8 @@ type DescribeIndexOutput struct { UserContextPolicy *string `type:"string" enum:"UserContextPolicy"` // Whether you have enabled the configuration for fetching access levels of - // groups and users from an Amazon Web Services Single Sign On identity source. + // groups and users from an IAM Identity Center (successor to Single Sign-On) + // identity source. UserGroupResolutionConfiguration *UserGroupResolutionConfiguration `type:"structure"` // The user token configuration for the Amazon Kendra index. @@ -14685,7 +14686,7 @@ func (s *DescribeThesaurusOutput) SetUpdatedAt(v time.Time) *DescribeThesaurusOu type DisassociateEntitiesFromExperienceInput struct { _ struct{} `type:"structure"` - // Lists users or groups in your Amazon Web Services SSO identity source. + // Lists users or groups in your IAM Identity Center identity source. // // EntityList is a required field EntityList []*EntityConfiguration `min:"1" type:"list" required:"true"` @@ -14778,8 +14779,8 @@ func (s *DisassociateEntitiesFromExperienceInput) SetIndexId(v string) *Disassoc type DisassociateEntitiesFromExperienceOutput struct { _ struct{} `type:"structure"` - // Lists the users or groups in your Amazon Web Services SSO identity source - // that failed to properly remove access to your Amazon Kendra experience. + // Lists the users or groups in your IAM Identity Center identity source that + // failed to properly remove access to your Amazon Kendra experience. FailedEntityList []*FailedEntity `min:"1" type:"list"` } @@ -14810,8 +14811,8 @@ func (s *DisassociateEntitiesFromExperienceOutput) SetFailedEntityList(v []*Fail type DisassociatePersonasFromEntitiesInput struct { _ struct{} `type:"structure"` - // The identifiers of users or groups in your Amazon Web Services SSO identity - // source. For example, user IDs could be user emails. + // The identifiers of users or groups in your IAM Identity Center identity source. + // For example, user IDs could be user emails. // // EntityIds is a required field EntityIds []*string `min:"1" type:"list" required:"true"` @@ -14894,8 +14895,8 @@ func (s *DisassociatePersonasFromEntitiesInput) SetIndexId(v string) *Disassocia type DisassociatePersonasFromEntitiesOutput struct { _ struct{} `type:"structure"` - // Lists the users or groups in your Amazon Web Services SSO identity source - // that failed to properly remove access to your Amazon Kendra experience. + // Lists the users or groups in your IAM Identity Center identity source that + // failed to properly remove access to your Amazon Kendra experience. FailedEntityList []*FailedEntity `min:"1" type:"list"` } @@ -15808,13 +15809,13 @@ func (s *DocumentsMetadataConfiguration) SetS3Prefix(v string) *DocumentsMetadat return s } -// Provides the configuration information for users or groups in your Amazon -// Web Services SSO identity source to grant access your Amazon Kendra experience. +// Provides the configuration information for users or groups in your IAM Identity +// Center identity source to grant access your Amazon Kendra experience. type EntityConfiguration struct { _ struct{} `type:"structure"` - // The identifier of a user or group in your Amazon Web Services SSO identity - // source. For example, a user ID could be an email. + // The identifier of a user or group in your IAM Identity Center identity source. + // For example, a user ID could be an email. // // EntityId is a required field EntityId *string `min:"1" type:"string" required:"true"` @@ -15962,21 +15963,21 @@ func (s *EntityDisplayData) SetUserName(v string) *EntityDisplayData { return s } -// Provides the configuration information for users or groups in your Amazon -// Web Services SSO identity source for access to your Amazon Kendra experience. -// Specific permissions are defined for each user or group once they are granted -// access to your Amazon Kendra experience. +// Provides the configuration information for users or groups in your IAM Identity +// Center identity source for access to your Amazon Kendra experience. Specific +// permissions are defined for each user or group once they are granted access +// to your Amazon Kendra experience. type EntityPersonaConfiguration struct { _ struct{} `type:"structure"` - // The identifier of a user or group in your Amazon Web Services SSO identity - // source. For example, a user ID could be an email. + // The identifier of a user or group in your IAM Identity Center identity source. + // For example, a user ID could be an email. // // EntityId is a required field EntityId *string `min:"1" type:"string" required:"true"` // The persona that defines the specific permissions of the user or group in - // your Amazon Web Services SSO identity source. The available personas or access + // your IAM Identity Center identity source. The available personas or access // roles are Owner and Viewer. For more information on these personas, see Providing // access to your search page (https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html#access-search-experience). // @@ -16044,7 +16045,7 @@ type ExperienceConfiguration struct { // you want to use for your Amazon Kendra experience. ContentSourceConfiguration *ContentSourceConfiguration `type:"structure"` - // The Amazon Web Services SSO field name that contains the identifiers of your + // The IAM Identity Center field name that contains the identifiers of your // users, such as their emails. UserIdentityConfiguration *UserIdentityConfiguration `type:"structure"` } @@ -16143,7 +16144,7 @@ func (s *ExperienceEndpoint) SetEndpointType(v string) *ExperienceEndpoint { return s } -// Summary information for users or groups in your Amazon Web Services SSO identity +// Summary information for users or groups in your IAM Identity Center identity // source with granted access to your Amazon Kendra experience. You can create // an Amazon Kendra experience such as a search application. For more information // on creating a search application experience, see Building a search experience @@ -16154,8 +16155,8 @@ type ExperienceEntitiesSummary struct { // Information about the user entity. DisplayData *EntityDisplayData `type:"structure"` - // The identifier of a user or group in your Amazon Web Services SSO identity - // source. For example, a user ID could be an email. + // The identifier of a user or group in your IAM Identity Center identity source. + // For example, a user ID could be an email. EntityId *string `min:"1" type:"string"` // Shows the type as User or Group. @@ -16416,16 +16417,16 @@ func (s *FacetResult) SetDocumentAttributeValueType(v string) *FacetResult { return s } -// Information on the users or groups in your Amazon Web Services SSO identity -// source that failed to properly configure with your Amazon Kendra experience. +// Information on the users or groups in your IAM Identity Center identity source +// that failed to properly configure with your Amazon Kendra experience. type FailedEntity struct { _ struct{} `type:"structure"` - // The identifier of the user or group in your Amazon Web Services SSO identity + // The identifier of the user or group in your IAM Identity Center identity // source. For example, a user ID could be an email. EntityId *string `min:"1" type:"string"` - // The reason the user or group in your Amazon Web Services SSO identity source + // The reason the user or group in your IAM Identity Center identity source // failed to properly configure with your Amazon Kendra experience. ErrorMessage *string `min:"1" type:"string"` } @@ -20864,7 +20865,7 @@ func (s *OneDriveUsers) SetOneDriveUserS3Path(v *S3Path) *OneDriveUsers { return s } -// Summary information for users or groups in your Amazon Web Services SSO identity +// Summary information for users or groups in your IAM Identity Center identity // source. This applies to users and groups with specific permissions that define // their level of access to your Amazon Kendra experience. You can create an // Amazon Kendra experience such as a search application. For more information @@ -20876,12 +20877,12 @@ type PersonasSummary struct { // The date-time the summary information was created. CreatedAt *time.Time `type:"timestamp"` - // The identifier of a user or group in your Amazon Web Services SSO identity - // source. For example, a user ID could be an email. + // The identifier of a user or group in your IAM Identity Center identity source. + // For example, a user ID could be an email. EntityId *string `min:"1" type:"string"` // The persona that defines the specific permissions of the user or group in - // your Amazon Web Services SSO identity source. The available personas or access + // your IAM Identity Center identity source. The available personas or access // roles are Owner and Viewer. For more information on these personas, see Providing // access to your search page (https://docs.aws.amazon.com/kendra/latest/dg/deploying-search-experience-no-code.html#access-search-experience). Persona *string `type:"string" enum:"Persona"` @@ -26461,9 +26462,9 @@ type UpdateExperienceInput struct { Name *string `min:"1" type:"string"` // The Amazon Resource Name (ARN) of a role with permission to access Query - // API, QuerySuggestions API, SubmitFeedback API, and Amazon Web Services SSO - // that stores your user and group information. For more information, see IAM - // roles for Amazon Kendra (https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html). + // API, QuerySuggestions API, SubmitFeedback API, and IAM Identity Center that + // stores your user and group information. For more information, see IAM roles + // for Amazon Kendra (https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html). RoleArn *string `type:"string"` } @@ -26607,8 +26608,8 @@ type UpdateIndexInput struct { // The user context policy. UserContextPolicy *string `type:"string" enum:"UserContextPolicy"` - // Enables fetching access levels of groups and users from an Amazon Web Services - // Single Sign On identity source. To configure this, see UserGroupResolutionConfiguration + // Enables fetching access levels of groups and users from an IAM Identity Center + // (successor to Single Sign-On) identity source. To configure this, see UserGroupResolutionConfiguration // (https://docs.aws.amazon.com/kendra/latest/dg/API_UserGroupResolutionConfiguration.html). UserGroupResolutionConfiguration *UserGroupResolutionConfiguration `type:"structure"` @@ -27385,31 +27386,31 @@ func (s *UserContext) SetUserId(v string) *UserContext { } // Provides the configuration information to fetch access levels of groups and -// users from an Amazon Web Services Single Sign On identity source. This is -// useful for user context filtering, where search results are filtered based -// on the user or their group access to documents. You can also use the PutPrincipalMapping -// (https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html) +// users from an IAM Identity Center (successor to Single Sign-On) identity +// source. This is useful for user context filtering, where search results are +// filtered based on the user or their group access to documents. You can also +// use the PutPrincipalMapping (https://docs.aws.amazon.com/kendra/latest/dg/API_PutPrincipalMapping.html) // API to map users to their groups so that you only need to provide the user // ID when you issue the query. // -// To set up an Amazon Web Services SSO identity source in the console to use -// with Amazon Kendra, see Getting started with an Amazon Web Services SSO identity -// source (https://docs.aws.amazon.com/kendra/latest/dg/getting-started-aws-sso.html). -// You must also grant the required permissions to use Amazon Web Services SSO -// with Amazon Kendra. For more information, see IAM roles for Amazon Web Services -// SSO (https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-aws-sso). +// To set up an IAM Identity Center identity source in the console to use with +// Amazon Kendra, see Getting started with an IAM Identity Center identity source +// (https://docs.aws.amazon.com/kendra/latest/dg/getting-started-aws-sso.html). +// You must also grant the required permissions to use IAM Identity Center with +// Amazon Kendra. For more information, see IAM roles for IAM Identity Center +// (https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-aws-sso). // // Amazon Kendra currently does not support using UserGroupResolutionConfiguration -// with an Amazon Web Services organization member account for your Amazon Web -// Services SSO identify source. You must create your index in the management -// account for the organization in order to use UserGroupResolutionConfiguration. +// with an Amazon Web Services organization member account for your IAM Identity +// Center identify source. You must create your index in the management account +// for the organization in order to use UserGroupResolutionConfiguration. type UserGroupResolutionConfiguration struct { _ struct{} `type:"structure"` // The identity store provider (mode) you want to use to fetch access levels - // of groups and users. Amazon Web Services Single Sign On is currently the - // only available mode. Your users and groups must exist in an Amazon Web Services - // SSO identity source in order to use this mode. + // of groups and users. IAM Identity Center (successor to Single Sign-On) is + // currently the only available mode. Your users and groups must exist in an + // IAM Identity Center identity source in order to use this mode. // // UserGroupResolutionMode is a required field UserGroupResolutionMode *string `type:"string" required:"true" enum:"UserGroupResolutionMode"` @@ -27456,13 +27457,13 @@ func (s *UserGroupResolutionConfiguration) SetUserGroupResolutionMode(v string) type UserIdentityConfiguration struct { _ struct{} `type:"structure"` - // The Amazon Web Services SSO field name that contains the identifiers of your + // The IAM Identity Center field name that contains the identifiers of your // users, such as their emails. This is used for user context filtering (https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html) // and for granting access to your Amazon Kendra experience. You must set up - // Amazon Web Services SSO with Amazon Kendra. You must include your users and - // groups in your Access Control List when you ingest documents into your index. - // For more information, see Getting started with an Amazon Web Services SSO - // identity source (https://docs.aws.amazon.com/kendra/latest/dg/getting-started-aws-sso.html). + // IAM Identity Center with Amazon Kendra. You must include your users and groups + // in your Access Control List when you ingest documents into your index. For + // more information, see Getting started with an IAM Identity Center identity + // source (https://docs.aws.amazon.com/kendra/latest/dg/getting-started-aws-sso.html). IdentityAttributeName *string `min:"1" type:"string"` } diff --git a/service/locationservice/api.go b/service/locationservice/api.go index 12dc8b7c2a..07d40b3b05 100644 --- a/service/locationservice/api.go +++ b/service/locationservice/api.go @@ -3289,6 +3289,110 @@ func (c *LocationService) GetMapTileWithContext(ctx aws.Context, input *GetMapTi return out, req.Send() } +const opGetPlace = "GetPlace" + +// GetPlaceRequest generates a "aws/request.Request" representing the +// client's request for the GetPlace operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See GetPlace for more information on using the GetPlace +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// // Example sending a request using the GetPlaceRequest method. +// req, resp := client.GetPlaceRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/GetPlace +func (c *LocationService) GetPlaceRequest(input *GetPlaceInput) (req *request.Request, output *GetPlaceOutput) { + op := &request.Operation{ + Name: opGetPlace, + HTTPMethod: "GET", + HTTPPath: "/places/v0/indexes/{IndexName}/places/{PlaceId}", + } + + if input == nil { + input = &GetPlaceInput{} + } + + output = &GetPlaceOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Build.PushBackNamed(protocol.NewHostPrefixHandler("places.", nil)) + req.Handlers.Build.PushBackNamed(protocol.ValidateEndpointHostHandler) + return +} + +// GetPlace API operation for Amazon Location Service. +// +// Finds a place by its unique ID. A PlaceId is returned by other search operations. +// +// A PlaceId is valid only if all of the following are the same in the original +// search request and the call to GetPlace. +// +// - Customer AWS account +// +// - AWS Region +// +// - Data provider specified in the place index resource +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for Amazon Location Service's +// API operation GetPlace for usage and error information. +// +// Returned Error Types: +// +// - InternalServerException +// The request has failed to process because of an unknown server error, exception, +// or failure. +// +// - ResourceNotFoundException +// The resource that you've entered was not found in your AWS account. +// +// - AccessDeniedException +// The request was denied because of insufficient access or permissions. Check +// with an administrator to verify your permissions. +// +// - ValidationException +// The input failed to meet the constraints specified by the AWS service. +// +// - ThrottlingException +// The request was denied because of request throttling. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/location-2020-11-19/GetPlace +func (c *LocationService) GetPlace(input *GetPlaceInput) (*GetPlaceOutput, error) { + req, out := c.GetPlaceRequest(input) + return out, req.Send() +} + +// GetPlaceWithContext is the same as GetPlace with the addition of +// the ability to pass a context and additional request options. +// +// See GetPlace for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *LocationService) GetPlaceWithContext(ctx aws.Context, input *GetPlaceInput, opts ...request.Option) (*GetPlaceOutput, error) { + req, out := c.GetPlaceRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opListDevicePositions = "ListDevicePositions" // ListDevicePositionsRequest generates a "aws/request.Request" representing the @@ -11285,7 +11389,7 @@ type GetMapSpritesInput struct { // // * sprites@2x.png for high pixel density displays // - // For the JSON document contain image offsets. Use the following file names: + // For the JSON document containing image offsets. Use the following file names: // // * sprites.json // @@ -11622,6 +11726,133 @@ func (s *GetMapTileOutput) SetContentType(v string) *GetMapTileOutput { return s } +type GetPlaceInput struct { + _ struct{} `type:"structure" nopayload:"true"` + + // The name of the place index resource that you want to use for the search. + // + // IndexName is a required field + IndexName *string `location:"uri" locationName:"IndexName" min:"1" type:"string" required:"true"` + + // The preferred language used to return results. The value must be a valid + // BCP 47 (https://tools.ietf.org/search/bcp47) language tag, for example, en + // for English. + // + // This setting affects the languages used in the results, but not the results + // themselves. If no language is specified, or not supported for a particular + // result, the partner automatically chooses a language for the result. + // + // For an example, we'll use the Greek language. You search for a location around + // Athens, Greece, with the language parameter set to en. The city in the results + // will most likely be returned as Athens. + // + // If you set the language parameter to el, for Greek, then the city in the + // results will more likely be returned as Αθήνα. + // + // If the data provider does not have a value for Greek, the result will be + // in a language that the provider does support. + Language *string `location:"querystring" locationName:"language" min:"2" type:"string"` + + // The identifier of the place to find. + // + // PlaceId is a required field + PlaceId *string `location:"uri" locationName:"PlaceId" type:"string" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s GetPlaceInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s GetPlaceInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *GetPlaceInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "GetPlaceInput"} + if s.IndexName == nil { + invalidParams.Add(request.NewErrParamRequired("IndexName")) + } + if s.IndexName != nil && len(*s.IndexName) < 1 { + invalidParams.Add(request.NewErrParamMinLen("IndexName", 1)) + } + if s.Language != nil && len(*s.Language) < 2 { + invalidParams.Add(request.NewErrParamMinLen("Language", 2)) + } + if s.PlaceId == nil { + invalidParams.Add(request.NewErrParamRequired("PlaceId")) + } + if s.PlaceId != nil && len(*s.PlaceId) < 1 { + invalidParams.Add(request.NewErrParamMinLen("PlaceId", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetIndexName sets the IndexName field's value. +func (s *GetPlaceInput) SetIndexName(v string) *GetPlaceInput { + s.IndexName = &v + return s +} + +// SetLanguage sets the Language field's value. +func (s *GetPlaceInput) SetLanguage(v string) *GetPlaceInput { + s.Language = &v + return s +} + +// SetPlaceId sets the PlaceId field's value. +func (s *GetPlaceInput) SetPlaceId(v string) *GetPlaceInput { + s.PlaceId = &v + return s +} + +type GetPlaceOutput struct { + _ struct{} `type:"structure"` + + // Details about the result, such as its address and position. + // + // Place is a required field + Place *Place `type:"structure" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s GetPlaceOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s GetPlaceOutput) GoString() string { + return s.String() +} + +// SetPlace sets the Place field's value. +func (s *GetPlaceOutput) SetPlace(v *Place) *GetPlaceOutput { + s.Place = v + return s +} + // The request has failed to process because of an unknown server error, exception, // or failure. type InternalServerException struct { @@ -13629,6 +13860,16 @@ type Place struct { // The time zone in which the Place is located. Returned only when using Here // as the selected partner. TimeZone *TimeZone `type:"structure"` + + // For addresses with multiple units, the unit identifier. Can include numbers + // and letters, for example 3B or Unit 123. + // + // Returned only for a place index that uses Esri as a data provider. Is not + // returned for SearchPlaceIndexForPosition. + UnitNumber *string `type:"string"` + + // For addresses with a UnitNumber, the type of unit. For example, Apartment. + UnitType *string `type:"string"` } // String returns the string representation. @@ -13721,6 +13962,18 @@ func (s *Place) SetTimeZone(v *TimeZone) *Place { return s } +// SetUnitNumber sets the UnitNumber field's value. +func (s *Place) SetUnitNumber(v string) *Place { + s.UnitNumber = &v + return s +} + +// SetUnitType sets the UnitType field's value. +func (s *Place) SetUnitType(v string) *Place { + s.UnitType = &v + return s +} + // Places uses a point geometry to specify a location or a Place. type PlaceGeometry struct { _ struct{} `type:"structure"` @@ -14153,6 +14406,13 @@ type SearchForPositionResult struct { // // Place is a required field Place *Place `type:"structure" required:"true"` + + // The unique identifier of the place. You can use this with the GetPlace operation + // to find the place again later. + // + // For SearchPlaceIndexForPosition operations, the PlaceId is returned only + // by place indexes that use HERE as a data provider. + PlaceId *string `type:"string"` } // String returns the string representation. @@ -14185,11 +14445,24 @@ func (s *SearchForPositionResult) SetPlace(v *Place) *SearchForPositionResult { return s } +// SetPlaceId sets the PlaceId field's value. +func (s *SearchForPositionResult) SetPlaceId(v string) *SearchForPositionResult { + s.PlaceId = &v + return s +} + // Contains a place suggestion resulting from a place suggestion query that // is run on a place index resource. type SearchForSuggestionsResult struct { _ struct{} `type:"structure"` + // The unique identifier of the place. You can use this with the GetPlace operation + // to find the place again later. + // + // For SearchPlaceIndexForSuggestions operations, the PlaceId is returned by + // place indexes that use HERE or Esri as data providers. + PlaceId *string `type:"string"` + // The text of the place suggestion, typically formatted as an address string. // // Text is a required field @@ -14214,6 +14487,12 @@ func (s SearchForSuggestionsResult) GoString() string { return s.String() } +// SetPlaceId sets the PlaceId field's value. +func (s *SearchForSuggestionsResult) SetPlaceId(v string) *SearchForSuggestionsResult { + s.PlaceId = &v + return s +} + // SetText sets the Text field's value. func (s *SearchForSuggestionsResult) SetText(v string) *SearchForSuggestionsResult { s.Text = &v @@ -14238,6 +14517,13 @@ type SearchForTextResult struct { // Place is a required field Place *Place `type:"structure" required:"true"` + // The unique identifier of the place. You can use this with the GetPlace operation + // to find the place again later. + // + // For SearchPlaceIndexForText operations, the PlaceId is returned only by place + // indexes that use HERE as a data provider. + PlaceId *string `type:"string"` + // The relative confidence in the match for a result among the results returned. // For example, if more fields for an address match (including house number, // street, city, country/region, and postal code), the relevance score is closer @@ -14277,6 +14563,12 @@ func (s *SearchForTextResult) SetPlace(v *Place) *SearchForTextResult { return s } +// SetPlaceId sets the PlaceId field's value. +func (s *SearchForTextResult) SetPlaceId(v string) *SearchForTextResult { + s.PlaceId = &v + return s +} + // SetRelevance sets the Relevance field's value. func (s *SearchForTextResult) SetRelevance(v float64) *SearchForTextResult { s.Relevance = &v diff --git a/service/locationservice/locationserviceiface/interface.go b/service/locationservice/locationserviceiface/interface.go index 47a7972ff0..b82f3b0066 100644 --- a/service/locationservice/locationserviceiface/interface.go +++ b/service/locationservice/locationserviceiface/interface.go @@ -191,6 +191,10 @@ type LocationServiceAPI interface { GetMapTileWithContext(aws.Context, *locationservice.GetMapTileInput, ...request.Option) (*locationservice.GetMapTileOutput, error) GetMapTileRequest(*locationservice.GetMapTileInput) (*request.Request, *locationservice.GetMapTileOutput) + GetPlace(*locationservice.GetPlaceInput) (*locationservice.GetPlaceOutput, error) + GetPlaceWithContext(aws.Context, *locationservice.GetPlaceInput, ...request.Option) (*locationservice.GetPlaceOutput, error) + GetPlaceRequest(*locationservice.GetPlaceInput) (*request.Request, *locationservice.GetPlaceOutput) + ListDevicePositions(*locationservice.ListDevicePositionsInput) (*locationservice.ListDevicePositionsOutput, error) ListDevicePositionsWithContext(aws.Context, *locationservice.ListDevicePositionsInput, ...request.Option) (*locationservice.ListDevicePositionsOutput, error) ListDevicePositionsRequest(*locationservice.ListDevicePositionsInput) (*request.Request, *locationservice.ListDevicePositionsOutput)