From 9f2d852a32f664e84822e3e2aefb7398f4fceda2 Mon Sep 17 00:00:00 2001 From: aws-sdk-go-automation <43143561+aws-sdk-go-automation@users.noreply.github.com> Date: Wed, 22 Sep 2021 11:23:28 -0700 Subject: [PATCH] Release v1.40.47 (2021-09-22) (#4106) Release v1.40.47 (2021-09-22) === ### Service Client Updates * `service/iam`: Updates service documentation * Added changes to OIDC API about not using port numbers in the URL. * `service/imagebuilder`: Updates service API and documentation * `service/license-manager`: Updates service API and documentation * `service/mediapackage-vod`: Updates service API and documentation * `service/mediatailor`: Updates service API and documentation * `service/models.lex.v2`: Updates service API, documentation, and paginators * `service/wafv2`: Updates service API and documentation --- CHANGELOG.md | 13 + aws/endpoints/defaults.go | 24 + aws/version.go | 2 +- models/apis/iam/2010-05-08/docs-2.json | 106 +- .../apis/imagebuilder/2019-12-02/api-2.json | 44 +- .../apis/imagebuilder/2019-12-02/docs-2.json | 86 +- .../license-manager/2018-08-01/api-2.json | 145 ++ .../license-manager/2018-08-01/docs-2.json | 181 +- .../mediapackage-vod/2018-11-07/api-2.json | 4 + .../mediapackage-vod/2018-11-07/docs-2.json | 1 + models/apis/mediatailor/2018-04-23/api-2.json | 61 + .../apis/mediatailor/2018-04-23/docs-2.json | 26 +- .../apis/models.lex.v2/2020-08-07/api-2.json | 199 +- .../apis/models.lex.v2/2020-08-07/docs-2.json | 149 +- .../2020-08-07/paginators-1.json | 5 + models/apis/wafv2/2019-07-29/api-2.json | 16 +- models/apis/wafv2/2019-07-29/docs-2.json | 11 +- models/endpoints/endpoints.json | 22 + service/iam/api.go | 357 ++-- service/imagebuilder/api.go | 371 +++- service/lexmodelsv2/api.go | 1846 +++++++++++++++-- service/lexmodelsv2/errors.go | 19 + .../lexmodelsv2/lexmodelsv2iface/interface.go | 11 + service/licensemanager/api.go | 1276 +++++++++--- service/licensemanager/doc.go | 4 +- service/licensemanager/errors.go | 4 +- .../licensemanageriface/interface.go | 12 + service/mediapackagevod/api.go | 11 + service/mediatailor/api.go | 257 ++- .../mediatailor/mediatailoriface/interface.go | 8 +- service/wafv2/api.go | 117 ++ 31 files changed, 4606 insertions(+), 782 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 62909fa903c..bba534d50fe 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,16 @@ +Release v1.40.47 (2021-09-22) +=== + +### Service Client Updates +* `service/iam`: Updates service documentation + * Added changes to OIDC API about not using port numbers in the URL. +* `service/imagebuilder`: Updates service API and documentation +* `service/license-manager`: Updates service API and documentation +* `service/mediapackage-vod`: Updates service API and documentation +* `service/mediatailor`: Updates service API and documentation +* `service/models.lex.v2`: Updates service API, documentation, and paginators +* `service/wafv2`: Updates service API and documentation + Release v1.40.46 (2021-09-21) === diff --git a/aws/endpoints/defaults.go b/aws/endpoints/defaults.go index 553d611b9b0..2ae3d38238f 100644 --- a/aws/endpoints/defaults.go +++ b/aws/endpoints/defaults.go @@ -1016,6 +1016,23 @@ var awsPartition = partition{ "us-west-2": endpoint{}, }, }, + "auditmanager": service{ + + Endpoints: endpoints{ + "ap-northeast-1": endpoint{}, + "ap-south-1": endpoint{}, + "ap-southeast-1": endpoint{}, + "ap-southeast-2": endpoint{}, + "ca-central-1": endpoint{}, + "eu-central-1": endpoint{}, + "eu-west-1": endpoint{}, + "eu-west-2": endpoint{}, + "us-east-1": endpoint{}, + "us-east-2": endpoint{}, + "us-west-1": endpoint{}, + "us-west-2": endpoint{}, + }, + }, "autoscaling": service{ Defaults: endpoint{ Protocols: []string{"http", "https"}, @@ -8073,6 +8090,13 @@ var awscnPartition = partition{ "cn-northwest-1": endpoint{}, }, }, + "appmesh": service{ + + Endpoints: endpoints{ + "cn-north-1": endpoint{}, + "cn-northwest-1": endpoint{}, + }, + }, "appsync": service{ Endpoints: endpoints{ diff --git a/aws/version.go b/aws/version.go index 22ce839ab5d..343916f49de 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.40.46" +const SDKVersion = "1.40.47" diff --git a/models/apis/iam/2010-05-08/docs-2.json b/models/apis/iam/2010-05-08/docs-2.json index 9319cfd24c2..9de7d6c29c5 100644 --- a/models/apis/iam/2010-05-08/docs-2.json +++ b/models/apis/iam/2010-05-08/docs-2.json @@ -8,29 +8,29 @@ "AttachGroupPolicy": "

Attaches the specified managed policy to the specified IAM group.

You use this operation to attach a managed policy to a group. To embed an inline policy in a group, use PutGroupPolicy.

As a best practice, you can validate your IAM policies. To learn more, see Validating IAM policies in the IAM User Guide.

For more information about policies, see Managed policies and inline policies in the IAM User Guide.

", "AttachRolePolicy": "

Attaches the specified managed policy to the specified IAM role. When you attach a managed policy to a role, the managed policy becomes part of the role's permission (access) policy.

You cannot use a managed policy as the role's trust policy. The role's trust policy is created at the same time as the role, using CreateRole. You can update a role's trust policy using UpdateAssumeRolePolicy.

Use this operation to attach a managed policy to a role. To embed an inline policy in a role, use PutRolePolicy. For more information about policies, see Managed policies and inline policies in the IAM User Guide.

As a best practice, you can validate your IAM policies. To learn more, see Validating IAM policies in the IAM User Guide.

", "AttachUserPolicy": "

Attaches the specified managed policy to the specified user.

You use this operation to attach a managed policy to a user. To embed an inline policy in a user, use PutUserPolicy.

As a best practice, you can validate your IAM policies. To learn more, see Validating IAM policies in the IAM User Guide.

For more information about policies, see Managed policies and inline policies in the IAM User Guide.

", - "ChangePassword": "

Changes the password of the IAM user who is calling this operation. This operation can be performed using the CLI, the Amazon Web Services API, or the My Security Credentials page in the Management Console. The account root user password is not affected by this operation.

Use UpdateLoginProfile to use the CLI, the Amazon Web Services API, or the Users page in the IAM console to change the password for any IAM user. For more information about modifying passwords, see Managing passwords in the IAM User Guide.

", - "CreateAccessKey": "

Creates a new Amazon Web Services secret access key and corresponding Amazon Web Services access key ID for the specified user. The default status for new keys is Active.

If you do not specify a user name, IAM determines the user name implicitly based on the Amazon Web Services access key ID signing the request. This operation works for access keys under the account. Consequently, you can use this operation to manage account root user credentials. This is true even if the account has no associated users.

For information about quotas on the number of keys you can create, see IAM and STS quotas in the IAM User Guide.

To ensure the security of your account, the secret access key is accessible only during key and user creation. You must save the key (for example, in a text file) if you want to be able to access it again. If a secret key is lost, you can delete the access keys for the associated user and then create new keys.

", - "CreateAccountAlias": "

Creates an alias for your account. For information about using an account alias, see Using an alias for your account ID in the IAM User Guide.

", + "ChangePassword": "

Changes the password of the IAM user who is calling this operation. This operation can be performed using the CLI, the Amazon Web Services API, or the My Security Credentials page in the Amazon Web Services Management Console. The Amazon Web Services account root user password is not affected by this operation.

Use UpdateLoginProfile to use the CLI, the Amazon Web Services API, or the Users page in the IAM console to change the password for any IAM user. For more information about modifying passwords, see Managing passwords in the IAM User Guide.

", + "CreateAccessKey": "

Creates a new Amazon Web Services secret access key and corresponding Amazon Web Services access key ID for the specified user. The default status for new keys is Active.

If you do not specify a user name, IAM determines the user name implicitly based on the Amazon Web Services access key ID signing the request. This operation works for access keys under the Amazon Web Services account. Consequently, you can use this operation to manage Amazon Web Services account root user credentials. This is true even if the Amazon Web Services account has no associated users.

For information about quotas on the number of keys you can create, see IAM and STS quotas in the IAM User Guide.

To ensure the security of your Amazon Web Services account, the secret access key is accessible only during key and user creation. You must save the key (for example, in a text file) if you want to be able to access it again. If a secret key is lost, you can delete the access keys for the associated user and then create new keys.

", + "CreateAccountAlias": "

Creates an alias for your Amazon Web Services account. For information about using an Amazon Web Services account alias, see Using an alias for your Amazon Web Services account ID in the IAM User Guide.

", "CreateGroup": "

Creates a new group.

For information about the number of groups you can create, see IAM and STS quotas in the IAM User Guide.

", "CreateInstanceProfile": "

Creates a new instance profile. For information about instance profiles, see Using roles for applications on Amazon EC2 in the IAM User Guide, and Instance profiles in the Amazon EC2 User Guide.

For information about the number of instance profiles you can create, see IAM object quotas in the IAM User Guide.

", - "CreateLoginProfile": "

Creates a password for the specified IAM user. A password allows an IAM user to access Amazon Web Services services through the Management Console.

You can use the CLI, the Amazon Web Services API, or the Users page in the IAM console to create a password for any IAM user. Use ChangePassword to update your own existing password in the My Security Credentials page in the Management Console.

For more information about managing passwords, see Managing passwords in the IAM User Guide.

", - "CreateOpenIDConnectProvider": "

Creates an IAM entity to describe an identity provider (IdP) that supports OpenID Connect (OIDC).

The OIDC provider that you create with this operation can be used as a principal in a role's trust policy. Such a policy establishes a trust relationship between Amazon Web Services and the OIDC provider.

If you are using an OIDC identity provider from Google, Facebook, or Amazon Cognito, you don't need to create a separate IAM identity provider. These OIDC identity providers are already built-in to Amazon Web Services and are available for your use. Instead, you can move directly to creating new roles using your identity provider. To learn more, see Creating a role for web identity or OpenID connect federation in the IAM User Guide.

When you create the IAM OIDC provider, you specify the following:

You get all of this information from the OIDC IdP that you want to use to access Amazon Web Services.

Amazon Web Services secures communication with some OIDC identity providers (IdPs) through our library of trusted certificate authorities (CAs) instead of using a certificate thumbprint to verify your IdP server certificate. These OIDC IdPs include Google, and those that use an Amazon S3 bucket to host a JSON Web Key Set (JWKS) endpoint. In these cases, your legacy thumbprint remains in your configuration, but is no longer used for validation.

The trust for the OIDC provider is derived from the IAM provider that this operation creates. Therefore, it is best to limit access to the CreateOpenIDConnectProvider operation to highly privileged users.

", - "CreatePolicy": "

Creates a new managed policy for your account.

This operation creates a policy version with a version identifier of v1 and sets v1 as the policy's default version. For more information about policy versions, see Versioning for managed policies in the IAM User Guide.

As a best practice, you can validate your IAM policies. To learn more, see Validating IAM policies in the IAM User Guide.

For more information about managed policies in general, see Managed policies and inline policies in the IAM User Guide.

", + "CreateLoginProfile": "

Creates a password for the specified IAM user. A password allows an IAM user to access Amazon Web Services services through the Amazon Web Services Management Console.

You can use the CLI, the Amazon Web Services API, or the Users page in the IAM console to create a password for any IAM user. Use ChangePassword to update your own existing password in the My Security Credentials page in the Amazon Web Services Management Console.

For more information about managing passwords, see Managing passwords in the IAM User Guide.

", + "CreateOpenIDConnectProvider": "

Creates an IAM entity to describe an identity provider (IdP) that supports OpenID Connect (OIDC).

The OIDC provider that you create with this operation can be used as a principal in a role's trust policy. Such a policy establishes a trust relationship between Amazon Web Services and the OIDC provider.

If you are using an OIDC identity provider from Google, Facebook, or Amazon Cognito, you don't need to create a separate IAM identity provider. These OIDC identity providers are already built-in to Amazon Web Services and are available for your use. Instead, you can move directly to creating new roles using your identity provider. To learn more, see Creating a role for web identity or OpenID connect federation in the IAM User Guide.

When you create the IAM OIDC provider, you specify the following:

You get all of this information from the OIDC IdP you want to use to access Amazon Web Services.

Amazon Web Services secures communication with some OIDC identity providers (IdPs) through our library of trusted certificate authorities (CAs) instead of using a certificate thumbprint to verify your IdP server certificate. These OIDC IdPs include Google, and those that use an Amazon S3 bucket to host a JSON Web Key Set (JWKS) endpoint. In these cases, your legacy thumbprint remains in your configuration, but is no longer used for validation.

The trust for the OIDC provider is derived from the IAM provider that this operation creates. Therefore, it is best to limit access to the CreateOpenIDConnectProvider operation to highly privileged users.

", + "CreatePolicy": "

Creates a new managed policy for your Amazon Web Services account.

This operation creates a policy version with a version identifier of v1 and sets v1 as the policy's default version. For more information about policy versions, see Versioning for managed policies in the IAM User Guide.

As a best practice, you can validate your IAM policies. To learn more, see Validating IAM policies in the IAM User Guide.

For more information about managed policies in general, see Managed policies and inline policies in the IAM User Guide.

", "CreatePolicyVersion": "

Creates a new version of the specified managed policy. To update a managed policy, you create a new policy version. A managed policy can have up to five versions. If the policy has five versions, you must delete an existing version using DeletePolicyVersion before you create a new version.

Optionally, you can set the new version as the policy's default version. The default version is the version that is in effect for the IAM users, groups, and roles to which the policy is attached.

For more information about managed policy versions, see Versioning for managed policies in the IAM User Guide.

", - "CreateRole": "

Creates a new role for your account. For more information about roles, see IAM roles. For information about quotas for role names and the number of roles you can create, see IAM and STS quotas in the IAM User Guide.

", - "CreateSAMLProvider": "

Creates an IAM resource that describes an identity provider (IdP) that supports SAML 2.0.

The SAML provider resource that you create with this operation can be used as a principal in an IAM role's trust policy. Such a policy can enable federated users who sign in using the SAML IdP to assume the role. You can create an IAM role that supports Web-based single sign-on (SSO) to the Management Console or one that supports API access to Amazon Web Services.

When you create the SAML provider resource, you upload a SAML metadata document that you get from your IdP. That document includes the issuer's name, expiration information, and keys that can be used to validate the SAML authentication response (assertions) that the IdP sends. You must generate the metadata document using the identity management software that is used as your organization's IdP.

This operation requires Signature Version 4.

For more information, see Enabling SAML 2.0 federated users to access the Management Console and About SAML 2.0-based federation in the IAM User Guide.

", + "CreateRole": "

Creates a new role for your Amazon Web Services account. For more information about roles, see IAM roles. For information about quotas for role names and the number of roles you can create, see IAM and STS quotas in the IAM User Guide.

", + "CreateSAMLProvider": "

Creates an IAM resource that describes an identity provider (IdP) that supports SAML 2.0.

The SAML provider resource that you create with this operation can be used as a principal in an IAM role's trust policy. Such a policy can enable federated users who sign in using the SAML IdP to assume the role. You can create an IAM role that supports Web-based single sign-on (SSO) to the Amazon Web Services Management Console or one that supports API access to Amazon Web Services.

When you create the SAML provider resource, you upload a SAML metadata document that you get from your IdP. That document includes the issuer's name, expiration information, and keys that can be used to validate the SAML authentication response (assertions) that the IdP sends. You must generate the metadata document using the identity management software that is used as your organization's IdP.

This operation requires Signature Version 4.

For more information, see Enabling SAML 2.0 federated users to access the Amazon Web Services Management Console and About SAML 2.0-based federation in the IAM User Guide.

", "CreateServiceLinkedRole": "

Creates an IAM role that is linked to a specific Amazon Web Services service. The service controls the attached policies and when the role can be deleted. This helps ensure that the service is not broken by an unexpectedly changed or deleted role, which could put your Amazon Web Services resources into an unknown state. Allowing the service to control the role helps improve service stability and proper cleanup when a service and its role are no longer needed. For more information, see Using service-linked roles in the IAM User Guide.

To attach a policy to this service-linked role, you must make the request using the Amazon Web Services service that depends on this role.

", "CreateServiceSpecificCredential": "

Generates a set of credentials consisting of a user name and password that can be used to access the service specified in the request. These credentials are generated by IAM, and can be used only for the specified service.

You can have a maximum of two sets of service-specific credentials for each supported service per user.

You can create service-specific credentials for CodeCommit and Amazon Keyspaces (for Apache Cassandra).

You can reset the password to a new service-generated value by calling ResetServiceSpecificCredential.

For more information about service-specific credentials, see Using IAM with CodeCommit: Git credentials, SSH keys, and Amazon Web Services access keys in the IAM User Guide.

", - "CreateUser": "

Creates a new IAM user for your account.

For information about quotas for the number of IAM users you can create, see IAM and STS quotas in the IAM User Guide.

", - "CreateVirtualMFADevice": "

Creates a new virtual MFA device for the account. After creating the virtual MFA, use EnableMFADevice to attach the MFA device to an IAM user. For more information about creating and working with virtual MFA devices, see Using a virtual MFA device in the IAM User Guide.

For information about the maximum number of MFA devices you can create, see IAM and STS quotas in the IAM User Guide.

The seed information contained in the QR code and the Base32 string should be treated like any other secret access information. In other words, protect the seed information as you would your Amazon Web Services access keys or your passwords. After you provision your virtual device, you should ensure that the information is destroyed following secure procedures.

", + "CreateUser": "

Creates a new IAM user for your Amazon Web Services account.

For information about quotas for the number of IAM users you can create, see IAM and STS quotas in the IAM User Guide.

", + "CreateVirtualMFADevice": "

Creates a new virtual MFA device for the Amazon Web Services account. After creating the virtual MFA, use EnableMFADevice to attach the MFA device to an IAM user. For more information about creating and working with virtual MFA devices, see Using a virtual MFA device in the IAM User Guide.

For information about the maximum number of MFA devices you can create, see IAM and STS quotas in the IAM User Guide.

The seed information contained in the QR code and the Base32 string should be treated like any other secret access information. In other words, protect the seed information as you would your Amazon Web Services access keys or your passwords. After you provision your virtual device, you should ensure that the information is destroyed following secure procedures.

", "DeactivateMFADevice": "

Deactivates the specified MFA device and removes it from association with the user name for which it was originally enabled.

For more information about creating and working with virtual MFA devices, see Enabling a virtual multi-factor authentication (MFA) device in the IAM User Guide.

", - "DeleteAccessKey": "

Deletes the access key pair associated with the specified IAM user.

If you do not specify a user name, IAM determines the user name implicitly based on the Amazon Web Services access key ID signing the request. This operation works for access keys under the account. Consequently, you can use this operation to manage account root user credentials even if the account has no associated users.

", - "DeleteAccountAlias": "

Deletes the specified account alias. For information about using an Amazon Web Services account alias, see Using an alias for your account ID in the IAM User Guide.

", - "DeleteAccountPasswordPolicy": "

Deletes the password policy for the account. There are no parameters.

", + "DeleteAccessKey": "

Deletes the access key pair associated with the specified IAM user.

If you do not specify a user name, IAM determines the user name implicitly based on the Amazon Web Services access key ID signing the request. This operation works for access keys under the Amazon Web Services account. Consequently, you can use this operation to manage Amazon Web Services account root user credentials even if the Amazon Web Services account has no associated users.

", + "DeleteAccountAlias": "

Deletes the specified Amazon Web Services account alias. For information about using an Amazon Web Services account alias, see Using an alias for your Amazon Web Services account ID in the IAM User Guide.

", + "DeleteAccountPasswordPolicy": "

Deletes the password policy for the Amazon Web Services account. There are no parameters.

", "DeleteGroup": "

Deletes the specified IAM group. The group must not contain any users or have any attached policies.

", "DeleteGroupPolicy": "

Deletes the specified inline policy that is embedded in the specified IAM group.

A group can also have managed policies attached to it. To detach a managed policy from a group, use DetachGroupPolicy. For more information about policies, refer to Managed policies and inline policies in the IAM User Guide.

", "DeleteInstanceProfile": "

Deletes the specified instance profile. The instance profile must not have an associated role.

Make sure that you do not have any Amazon EC2 instances running with the instance profile you are about to delete. Deleting a role or instance profile that is associated with a running instance will break any applications running on the instance.

For more information about instance profiles, see About instance profiles.

", - "DeleteLoginProfile": "

Deletes the password for the specified IAM user, which terminates the user's ability to access Amazon Web Services services through the Management Console.

You can use the CLI, the Amazon Web Services API, or the Users page in the IAM console to delete a password for any IAM user. You can use ChangePassword to update, but not delete, your own password in the My Security Credentials page in the Management Console.

Deleting a user's password does not prevent a user from accessing Amazon Web Services through the command line interface or the API. To prevent all user access, you must also either make any access keys inactive or delete them. For more information about making keys inactive or deleting them, see UpdateAccessKey and DeleteAccessKey.

", + "DeleteLoginProfile": "

Deletes the password for the specified IAM user, which terminates the user's ability to access Amazon Web Services services through the Amazon Web Services Management Console.

You can use the CLI, the Amazon Web Services API, or the Users page in the IAM console to delete a password for any IAM user. You can use ChangePassword to update, but not delete, your own password in the My Security Credentials page in the Amazon Web Services Management Console.

Deleting a user's password does not prevent a user from accessing Amazon Web Services through the command line interface or the API. To prevent all user access, you must also either make any access keys inactive or delete them. For more information about making keys inactive or deleting them, see UpdateAccessKey and DeleteAccessKey.

", "DeleteOpenIDConnectProvider": "

Deletes an OpenID Connect identity provider (IdP) resource object in IAM.

Deleting an IAM OIDC provider resource does not update any roles that reference the provider as a principal in their trust policies. Any attempt to assume a role that references a deleted provider fails.

This operation is idempotent; it does not fail or return an error if you call the operation for a provider that does not exist.

", "DeletePolicy": "

Deletes the specified managed policy.

Before you can delete a managed policy, you must first detach the policy from all users, groups, and roles that it is attached to. In addition, you must delete all the policy's versions. The following steps describe the process for deleting a managed policy:

For information about managed policies, see Managed policies and inline policies in the IAM User Guide.

", "DeletePolicyVersion": "

Deletes the specified version from the specified managed policy.

You cannot delete the default version from a policy using this operation. To delete the default version from a policy, use DeletePolicy. To find out which version of a policy is marked as the default version, use ListPolicyVersions.

For information about versions for managed policies, see Versioning for managed policies in the IAM User Guide.

", @@ -42,8 +42,8 @@ "DeleteServerCertificate": "

Deletes the specified server certificate.

For more information about working with server certificates, see Working with server certificates in the IAM User Guide. This topic also includes a list of Amazon Web Services services that can use the server certificates that you manage with IAM.

If you are using a server certificate with Elastic Load Balancing, deleting the certificate could have implications for your application. If Elastic Load Balancing doesn't detect the deletion of bound certificates, it may continue to use the certificates. This could cause Elastic Load Balancing to stop accepting traffic. We recommend that you remove the reference to the certificate from Elastic Load Balancing before using this command to delete the certificate. For more information, see DeleteLoadBalancerListeners in the Elastic Load Balancing API Reference.

", "DeleteServiceLinkedRole": "

Submits a service-linked role deletion request and returns a DeletionTaskId, which you can use to check the status of the deletion. Before you call this operation, confirm that the role has no active sessions and that any resources used by the role in the linked service are deleted. If you call this operation more than once for the same service-linked role and an earlier deletion task is not complete, then the DeletionTaskId of the earlier request is returned.

If you submit a deletion request for a service-linked role whose linked service is still accessing a resource, then the deletion task fails. If it fails, the GetServiceLinkedRoleDeletionStatus operation returns the reason for the failure, usually including the resources that must be deleted. To delete the service-linked role, you must first remove those resources from the linked service and then submit the deletion request again. Resources are specific to the service that is linked to the role. For more information about removing resources from a service, see the Amazon Web Services documentation for your service.

For more information about service-linked roles, see Roles terms and concepts: Amazon Web Services service-linked role in the IAM User Guide.

", "DeleteServiceSpecificCredential": "

Deletes the specified service-specific credential.

", - "DeleteSigningCertificate": "

Deletes a signing certificate associated with the specified IAM user.

If you do not specify a user name, IAM determines the user name implicitly based on the Amazon Web Services access key ID signing the request. This operation works for access keys under the account. Consequently, you can use this operation to manage account root user credentials even if the account has no associated IAM users.

", - "DeleteUser": "

Deletes the specified IAM user. Unlike the Management Console, when you delete a user programmatically, you must delete the items attached to the user manually, or the deletion fails. For more information, see Deleting an IAM user. Before attempting to delete a user, remove the following items:

", + "DeleteSigningCertificate": "

Deletes a signing certificate associated with the specified IAM user.

If you do not specify a user name, IAM determines the user name implicitly based on the Amazon Web Services access key ID signing the request. This operation works for access keys under the Amazon Web Services account. Consequently, you can use this operation to manage Amazon Web Services account root user credentials even if the Amazon Web Services account has no associated IAM users.

", + "DeleteUser": "

Deletes the specified IAM user. Unlike the Amazon Web Services Management Console, when you delete a user programmatically, you must delete the items attached to the user manually, or the deletion fails. For more information, see Deleting an IAM user. Before attempting to delete a user, remove the following items:

", "DeleteUserPermissionsBoundary": "

Deletes the permissions boundary for the specified IAM user.

Deleting the permissions boundary for a user might increase its permissions by allowing the user to perform all the actions granted in its permissions policies.

", "DeleteUserPolicy": "

Deletes the specified inline policy that is embedded in the specified IAM user.

A user can also have managed policies attached to it. To detach a managed policy from a user, use DetachUserPolicy. For more information about policies, refer to Managed policies and inline policies in the IAM User Guide.

", "DeleteVirtualMFADevice": "

Deletes a virtual MFA device.

You must deactivate a user's virtual MFA device before you can delete it. For information about deactivating MFA devices, see DeactivateMFADevice.

", @@ -51,20 +51,20 @@ "DetachRolePolicy": "

Removes the specified managed policy from the specified role.

A role can also have inline policies embedded with it. To delete an inline policy, use DeleteRolePolicy. For information about policies, see Managed policies and inline policies in the IAM User Guide.

", "DetachUserPolicy": "

Removes the specified managed policy from the specified user.

A user can also have inline policies embedded with it. To delete an inline policy, use DeleteUserPolicy. For information about policies, see Managed policies and inline policies in the IAM User Guide.

", "EnableMFADevice": "

Enables the specified MFA device and associates it with the specified IAM user. When enabled, the MFA device is required for every subsequent login by the IAM user associated with the device.

", - "GenerateCredentialReport": "

Generates a credential report for the account. For more information about the credential report, see Getting credential reports in the IAM User Guide.

", - "GenerateOrganizationsAccessReport": "

Generates a report for service last accessed data for Organizations. You can generate a report for any entities (organization root, organizational unit, or account) or policies in your organization.

To call this operation, you must be signed in using your Organizations management account credentials. You can use your long-term IAM user or root user credentials, or temporary credentials from assuming an IAM role. SCPs must be enabled for your organization root. You must have the required IAM and Organizations permissions. For more information, see Refining permissions using service last accessed data in the IAM User Guide.

You can generate a service last accessed data report for entities by specifying only the entity's path. This data includes a list of services that are allowed by any service control policies (SCPs) that apply to the entity.

You can generate a service last accessed data report for a policy by specifying an entity's path and an optional Organizations policy ID. This data includes a list of services that are allowed by the specified SCP.

For each service in both report types, the data includes the most recent account activity that the policy allows to account principals in the entity or the entity's children. For important information about the data, reporting period, permissions required, troubleshooting, and supported Regions see Reducing permissions using service last accessed data in the IAM User Guide.

The data includes all attempts to access Amazon Web Services, not just the successful ones. This includes all attempts that were made using the Management Console, the Amazon Web Services API through any of the SDKs, or any of the command line tools. An unexpected entry in the service last accessed data does not mean that an account has been compromised, because the request might have been denied. Refer to your CloudTrail logs as the authoritative source for information about all API calls and whether they were successful or denied access. For more information, see Logging IAM events with CloudTrail in the IAM User Guide.

This operation returns a JobId. Use this parameter in the GetOrganizationsAccessReport operation to check the status of the report generation. To check the status of this request, use the JobId parameter in the GetOrganizationsAccessReport operation and test the JobStatus response parameter. When the job is complete, you can retrieve the report.

To generate a service last accessed data report for entities, specify an entity path without specifying the optional Organizations policy ID. The type of entity that you specify determines the data returned in the report.

To generate a service last accessed data report for policies, specify an entity path and the optional Organizations policy ID. The type of entity that you specify determines the data returned for each service.

Service last accessed data does not use other policy types when determining whether a principal could access a service. These other policy types include identity-based policies, resource-based policies, access control lists, IAM permissions boundaries, and STS assume role policies. It only applies SCP logic. For more about the evaluation of policy types, see Evaluating policies in the IAM User Guide.

For more information about service last accessed data, see Reducing policy scope by viewing user activity in the IAM User Guide.

", - "GenerateServiceLastAccessedDetails": "

Generates a report that includes details about when an IAM resource (user, group, role, or policy) was last used in an attempt to access Amazon Web Services services. Recent activity usually appears within four hours. IAM reports activity for the last 365 days, or less if your Region began supporting this feature within the last year. For more information, see Regions where data is tracked.

The service last accessed data includes all attempts to access an Amazon Web Services API, not just the successful ones. This includes all attempts that were made using the Management Console, the Amazon Web Services API through any of the SDKs, or any of the command line tools. An unexpected entry in the service last accessed data does not mean that your account has been compromised, because the request might have been denied. Refer to your CloudTrail logs as the authoritative source for information about all API calls and whether they were successful or denied access. For more information, see Logging IAM events with CloudTrail in the IAM User Guide.

The GenerateServiceLastAccessedDetails operation returns a JobId. Use this parameter in the following operations to retrieve the following details from your report:

To check the status of the GenerateServiceLastAccessedDetails request, use the JobId parameter in the same operations and test the JobStatus response parameter.

For additional information about the permissions policies that allow an identity (user, group, or role) to access specific services, use the ListPoliciesGrantingServiceAccess operation.

Service last accessed data does not use other policy types when determining whether a resource could access a service. These other policy types include resource-based policies, access control lists, Organizations policies, IAM permissions boundaries, and STS assume role policies. It only applies permissions policy logic. For more about the evaluation of policy types, see Evaluating policies in the IAM User Guide.

For more information about service and action last accessed data, see Reducing permissions using service last accessed data in the IAM User Guide.

", + "GenerateCredentialReport": "

Generates a credential report for the Amazon Web Services account. For more information about the credential report, see Getting credential reports in the IAM User Guide.

", + "GenerateOrganizationsAccessReport": "

Generates a report for service last accessed data for Organizations. You can generate a report for any entities (organization root, organizational unit, or account) or policies in your organization.

To call this operation, you must be signed in using your Organizations management account credentials. You can use your long-term IAM user or root user credentials, or temporary credentials from assuming an IAM role. SCPs must be enabled for your organization root. You must have the required IAM and Organizations permissions. For more information, see Refining permissions using service last accessed data in the IAM User Guide.

You can generate a service last accessed data report for entities by specifying only the entity's path. This data includes a list of services that are allowed by any service control policies (SCPs) that apply to the entity.

You can generate a service last accessed data report for a policy by specifying an entity's path and an optional Organizations policy ID. This data includes a list of services that are allowed by the specified SCP.

For each service in both report types, the data includes the most recent account activity that the policy allows to account principals in the entity or the entity's children. For important information about the data, reporting period, permissions required, troubleshooting, and supported Regions see Reducing permissions using service last accessed data in the IAM User Guide.

The data includes all attempts to access Amazon Web Services, not just the successful ones. This includes all attempts that were made using the Amazon Web Services Management Console, the Amazon Web Services API through any of the SDKs, or any of the command line tools. An unexpected entry in the service last accessed data does not mean that an account has been compromised, because the request might have been denied. Refer to your CloudTrail logs as the authoritative source for information about all API calls and whether they were successful or denied access. For more information, see Logging IAM events with CloudTrail in the IAM User Guide.

This operation returns a JobId. Use this parameter in the GetOrganizationsAccessReport operation to check the status of the report generation. To check the status of this request, use the JobId parameter in the GetOrganizationsAccessReport operation and test the JobStatus response parameter. When the job is complete, you can retrieve the report.

To generate a service last accessed data report for entities, specify an entity path without specifying the optional Organizations policy ID. The type of entity that you specify determines the data returned in the report.

To generate a service last accessed data report for policies, specify an entity path and the optional Organizations policy ID. The type of entity that you specify determines the data returned for each service.

Service last accessed data does not use other policy types when determining whether a principal could access a service. These other policy types include identity-based policies, resource-based policies, access control lists, IAM permissions boundaries, and STS assume role policies. It only applies SCP logic. For more about the evaluation of policy types, see Evaluating policies in the IAM User Guide.

For more information about service last accessed data, see Reducing policy scope by viewing user activity in the IAM User Guide.

", + "GenerateServiceLastAccessedDetails": "

Generates a report that includes details about when an IAM resource (user, group, role, or policy) was last used in an attempt to access Amazon Web Services services. Recent activity usually appears within four hours. IAM reports activity for the last 365 days, or less if your Region began supporting this feature within the last year. For more information, see Regions where data is tracked.

The service last accessed data includes all attempts to access an Amazon Web Services API, not just the successful ones. This includes all attempts that were made using the Amazon Web Services Management Console, the Amazon Web Services API through any of the SDKs, or any of the command line tools. An unexpected entry in the service last accessed data does not mean that your account has been compromised, because the request might have been denied. Refer to your CloudTrail logs as the authoritative source for information about all API calls and whether they were successful or denied access. For more information, see Logging IAM events with CloudTrail in the IAM User Guide.

The GenerateServiceLastAccessedDetails operation returns a JobId. Use this parameter in the following operations to retrieve the following details from your report:

To check the status of the GenerateServiceLastAccessedDetails request, use the JobId parameter in the same operations and test the JobStatus response parameter.

For additional information about the permissions policies that allow an identity (user, group, or role) to access specific services, use the ListPoliciesGrantingServiceAccess operation.

Service last accessed data does not use other policy types when determining whether a resource could access a service. These other policy types include resource-based policies, access control lists, Organizations policies, IAM permissions boundaries, and STS assume role policies. It only applies permissions policy logic. For more about the evaluation of policy types, see Evaluating policies in the IAM User Guide.

For more information about service and action last accessed data, see Reducing permissions using service last accessed data in the IAM User Guide.

", "GetAccessKeyLastUsed": "

Retrieves information about when the specified access key was last used. The information includes the date and time of last use, along with the Amazon Web Services service and Region that were specified in the last request made with that key.

", "GetAccountAuthorizationDetails": "

Retrieves information about all IAM users, groups, roles, and policies in your Amazon Web Services account, including their relationships to one another. Use this operation to obtain a snapshot of the configuration of IAM permissions (users, groups, roles, and policies) in your account.

Policies returned by this operation are URL-encoded compliant with RFC 3986. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the decode method of the java.net.URLDecoder utility class in the Java SDK. Other languages and SDKs provide similar functionality.

You can optionally filter the results using the Filter parameter. You can paginate the results using the MaxItems and Marker parameters.

", - "GetAccountPasswordPolicy": "

Retrieves the password policy for the account. This tells you the complexity requirements and mandatory rotation periods for the IAM user passwords in your account. For more information about using a password policy, see Managing an IAM password policy.

", + "GetAccountPasswordPolicy": "

Retrieves the password policy for the Amazon Web Services account. This tells you the complexity requirements and mandatory rotation periods for the IAM user passwords in your account. For more information about using a password policy, see Managing an IAM password policy.

", "GetAccountSummary": "

Retrieves information about IAM entity usage and IAM quotas in the Amazon Web Services account.

For information about IAM quotas, see IAM and STS quotas in the IAM User Guide.

", "GetContextKeysForCustomPolicy": "

Gets a list of all of the context keys referenced in the input policies. The policies are supplied as a list of one or more strings. To get the context keys from policies associated with an IAM user, group, or role, use GetContextKeysForPrincipalPolicy.

Context keys are variables maintained by Amazon Web Services and its services that provide details about the context of an API query request. Context keys can be evaluated by testing against a value specified in an IAM policy. Use GetContextKeysForCustomPolicy to understand what key names and values you must supply when you call SimulateCustomPolicy. Note that all parameters are shown in unencoded form here for clarity but must be URL encoded to be included as a part of a real HTML request.

", "GetContextKeysForPrincipalPolicy": "

Gets a list of all of the context keys referenced in all the IAM policies that are attached to the specified IAM entity. The entity can be an IAM user, group, or role. If you specify a user, then the request also includes all of the policies attached to groups that the user is a member of.

You can optionally include a list of one or more additional policies, specified as strings. If you want to include only a list of policies by string, use GetContextKeysForCustomPolicy instead.

Note: This operation discloses information about the permissions granted to other users. If you do not want users to see other user's permissions, then consider allowing them to use GetContextKeysForCustomPolicy instead.

Context keys are variables maintained by Amazon Web Services and its services that provide details about the context of an API query request. Context keys can be evaluated by testing against a value in an IAM policy. Use GetContextKeysForPrincipalPolicy to understand what key names and values you must supply when you call SimulatePrincipalPolicy.

", - "GetCredentialReport": "

Retrieves a credential report for the account. For more information about the credential report, see Getting credential reports in the IAM User Guide.

", + "GetCredentialReport": "

Retrieves a credential report for the Amazon Web Services account. For more information about the credential report, see Getting credential reports in the IAM User Guide.

", "GetGroup": "

Returns a list of IAM users that are in the specified IAM group. You can paginate the results using the MaxItems and Marker parameters.

", "GetGroupPolicy": "

Retrieves the specified inline policy document that is embedded in the specified IAM group.

Policies returned by this operation are URL-encoded compliant with RFC 3986. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the decode method of the java.net.URLDecoder utility class in the Java SDK. Other languages and SDKs provide similar functionality.

An IAM group can also have managed policies attached to it. To retrieve a managed policy document that is attached to a group, use GetPolicy to determine the policy's default version, then use GetPolicyVersion to retrieve the policy document.

For more information about policies, see Managed policies and inline policies in the IAM User Guide.

", "GetInstanceProfile": "

Retrieves information about the specified instance profile, including the instance profile's path, GUID, ARN, and role. For more information about instance profiles, see About instance profiles in the IAM User Guide.

", - "GetLoginProfile": "

Retrieves the user name for the specified IAM user. A login profile is created when you create a password for the user to access the Management Console. If the user does not exist or does not have a password, the operation returns a 404 (NoSuchEntity) error.

If you create an IAM user with access to the console, the CreateDate reflects the date you created the initial password for the user.

If you create an IAM user with programmatic access, and then later add a password for the user to access the Management Console, the CreateDate reflects the initial password creation date. A user with programmatic access does not have a login profile unless you create a password for the user to access the Management Console.

", + "GetLoginProfile": "

Retrieves the user name for the specified IAM user. A login profile is created when you create a password for the user to access the Amazon Web Services Management Console. If the user does not exist or does not have a password, the operation returns a 404 (NoSuchEntity) error.

If you create an IAM user with access to the console, the CreateDate reflects the date you created the initial password for the user.

If you create an IAM user with programmatic access, and then later add a password for the user to access the Amazon Web Services Management Console, the CreateDate reflects the initial password creation date. A user with programmatic access does not have a login profile unless you create a password for the user to access the Amazon Web Services Management Console.

", "GetOpenIDConnectProvider": "

Returns information about the specified OpenID Connect (OIDC) provider resource object in IAM.

", "GetOrganizationsAccessReport": "

Retrieves the service last accessed data report for Organizations that was previously generated using the GenerateOrganizationsAccessReport operation. This operation retrieves the status of your report job and the report contents.

Depending on the parameters that you passed when you generated the report, the data returned could include different information. For details, see GenerateOrganizationsAccessReport.

To call this operation, you must be signed in to the management account in your organization. SCPs must be enabled for your organization root. You must have permissions to perform this operation. For more information, see Refining permissions using service last accessed data in the IAM User Guide.

For each service that principals in an account (root users, IAM users, or IAM roles) could access using SCPs, the operation returns details about the most recent access attempt. If there was no attempt, the service is listed without details about the most recent attempt to access the service. If the operation fails, it returns the reason that it failed.

By default, the list is sorted by service namespace.

", "GetPolicy": "

Retrieves information about the specified managed policy, including the policy's default version and the total number of IAM users, groups, and roles to which the policy is attached. To retrieve the list of the specific users, groups, and roles that the policy is attached to, use ListEntitiesForPolicy. This operation returns metadata about the policy. To retrieve the actual policy document for a specific version of the policy, use GetPolicyVersion.

This operation retrieves information about managed policies. To retrieve information about an inline policy that is embedded with an IAM user, group, or role, use GetUserPolicy, GetGroupPolicy, or GetRolePolicy.

For more information about policies, see Managed policies and inline policies in the IAM User Guide.

", @@ -79,8 +79,8 @@ "GetServiceLinkedRoleDeletionStatus": "

Retrieves the status of your service-linked role deletion. After you use DeleteServiceLinkedRole to submit a service-linked role for deletion, you can use the DeletionTaskId parameter in GetServiceLinkedRoleDeletionStatus to check the status of the deletion. If the deletion fails, this operation returns the reason that it failed, if that information is returned by the service.

", "GetUser": "

Retrieves information about the specified IAM user, including the user's creation date, path, unique ID, and ARN.

If you do not specify a user name, IAM determines the user name implicitly based on the Amazon Web Services access key ID used to sign the request to this operation.

", "GetUserPolicy": "

Retrieves the specified inline policy document that is embedded in the specified IAM user.

Policies returned by this operation are URL-encoded compliant with RFC 3986. You can use a URL decoding method to convert the policy back to plain JSON text. For example, if you use Java, you can use the decode method of the java.net.URLDecoder utility class in the Java SDK. Other languages and SDKs provide similar functionality.

An IAM user can also have managed policies attached to it. To retrieve a managed policy document that is attached to a user, use GetPolicy to determine the policy's default version. Then use GetPolicyVersion to retrieve the policy document.

For more information about policies, see Managed policies and inline policies in the IAM User Guide.

", - "ListAccessKeys": "

Returns information about the access key IDs associated with the specified IAM user. If there is none, the operation returns an empty list.

Although each user is limited to a small number of keys, you can still paginate the results using the MaxItems and Marker parameters.

If the UserName field is not specified, the user name is determined implicitly based on the Amazon Web Services access key ID used to sign the request. This operation works for access keys under the account. Consequently, you can use this operation to manage account root user credentials even if the account has no associated users.

To ensure the security of your account, the secret access key is accessible only during key and user creation.

", - "ListAccountAliases": "

Lists the account alias associated with the account (Note: you can have only one). For information about using an account alias, see Using an alias for your account ID in the IAM User Guide.

", + "ListAccessKeys": "

Returns information about the access key IDs associated with the specified IAM user. If there is none, the operation returns an empty list.

Although each user is limited to a small number of keys, you can still paginate the results using the MaxItems and Marker parameters.

If the UserName field is not specified, the user name is determined implicitly based on the Amazon Web Services access key ID used to sign the request. This operation works for access keys under the Amazon Web Services account. Consequently, you can use this operation to manage Amazon Web Services account root user credentials even if the Amazon Web Services account has no associated users.

To ensure the security of your Amazon Web Services account, the secret access key is accessible only during key and user creation.

", + "ListAccountAliases": "

Lists the account alias associated with the Amazon Web Services account (Note: you can have only one). For information about using an Amazon Web Services account alias, see Using an alias for your Amazon Web Services account ID in the IAM User Guide.

", "ListAttachedGroupPolicies": "

Lists all managed policies that are attached to the specified IAM group.

An IAM group can also have inline policies embedded with it. To list the inline policies for a group, use ListGroupPolicies. For information about policies, see Managed policies and inline policies in the IAM User Guide.

You can paginate the results using the MaxItems and Marker parameters. You can use the PathPrefix parameter to limit the list of policies to only those matching the specified path prefix. If there are no policies attached to the specified group (or none that match the specified path prefix), the operation returns an empty list.

", "ListAttachedRolePolicies": "

Lists all managed policies that are attached to the specified IAM role.

An IAM role can also have inline policies embedded with it. To list the inline policies for a role, use ListRolePolicies. For information about policies, see Managed policies and inline policies in the IAM User Guide.

You can paginate the results using the MaxItems and Marker parameters. You can use the PathPrefix parameter to limit the list of policies to only those matching the specified path prefix. If there are no policies attached to the specified role (or none that match the specified path prefix), the operation returns an empty list.

", "ListAttachedUserPolicies": "

Lists all managed policies that are attached to the specified IAM user.

An IAM user can also have inline policies embedded with it. To list the inline policies for a user, use ListUserPolicies. For information about policies, see Managed policies and inline policies in the IAM User Guide.

You can paginate the results using the MaxItems and Marker parameters. You can use the PathPrefix parameter to limit the list of policies to only those matching the specified path prefix. If there are no policies attached to the specified group (or none that match the specified path prefix), the operation returns an empty list.

", @@ -94,8 +94,8 @@ "ListMFADeviceTags": "

Lists the tags that are attached to the specified IAM virtual multi-factor authentication (MFA) device. The returned list of tags is sorted by tag key. For more information about tagging, see Tagging IAM resources in the IAM User Guide.

", "ListMFADevices": "

Lists the MFA devices for an IAM user. If the request includes a IAM user name, then this operation lists all the MFA devices associated with the specified user. If you do not specify a user name, IAM determines the user name implicitly based on the Amazon Web Services access key ID signing the request for this operation.

You can paginate the results using the MaxItems and Marker parameters.

", "ListOpenIDConnectProviderTags": "

Lists the tags that are attached to the specified OpenID Connect (OIDC)-compatible identity provider. The returned list of tags is sorted by tag key. For more information, see About web identity federation.

For more information about tagging, see Tagging IAM resources in the IAM User Guide.

", - "ListOpenIDConnectProviders": "

Lists information about the IAM OpenID Connect (OIDC) provider resource objects defined in the account.

IAM resource-listing operations return a subset of the available attributes for the resource. For example, this operation does not return tags, even though they are an attribute of the returned object. To view all of the information for an OIDC provider, see GetOpenIDConnectProvider.

", - "ListPolicies": "

Lists all the managed policies that are available in your account, including your own customer-defined managed policies and all Amazon Web Services managed policies.

You can filter the list of policies that is returned using the optional OnlyAttached, Scope, and PathPrefix parameters. For example, to list only the customer managed policies in your Amazon Web Services account, set Scope to Local. To list only Amazon Web Services managed policies, set Scope to AWS.

You can paginate the results using the MaxItems and Marker parameters.

For more information about managed policies, see Managed policies and inline policies in the IAM User Guide.

IAM resource-listing operations return a subset of the available attributes for the resource. For example, this operation does not return tags, even though they are an attribute of the returned object. To view all of the information for a customer manged policy, see GetPolicy.

", + "ListOpenIDConnectProviders": "

Lists information about the IAM OpenID Connect (OIDC) provider resource objects defined in the Amazon Web Services account.

IAM resource-listing operations return a subset of the available attributes for the resource. For example, this operation does not return tags, even though they are an attribute of the returned object. To view all of the information for an OIDC provider, see GetOpenIDConnectProvider.

", + "ListPolicies": "

Lists all the managed policies that are available in your Amazon Web Services account, including your own customer-defined managed policies and all Amazon Web Services managed policies.

You can filter the list of policies that is returned using the optional OnlyAttached, Scope, and PathPrefix parameters. For example, to list only the customer managed policies in your Amazon Web Services account, set Scope to Local. To list only Amazon Web Services managed policies, set Scope to AWS.

You can paginate the results using the MaxItems and Marker parameters.

For more information about managed policies, see Managed policies and inline policies in the IAM User Guide.

IAM resource-listing operations return a subset of the available attributes for the resource. For example, this operation does not return tags, even though they are an attribute of the returned object. To view all of the information for a customer manged policy, see GetPolicy.

", "ListPoliciesGrantingServiceAccess": "

Retrieves a list of policies that the IAM identity (user, group, or role) can use to access each specified service.

This operation does not use other policy types when determining whether a resource could access a service. These other policy types include resource-based policies, access control lists, Organizations policies, IAM permissions boundaries, and STS assume role policies. It only applies permissions policy logic. For more about the evaluation of policy types, see Evaluating policies in the IAM User Guide.

The list of policies returned by the operation depends on the ARN of the identity that you provide.

For each managed policy, this operation returns the ARN and policy name. For each inline policy, it returns the policy name and the entity to which it is attached. Inline policies do not have an ARN. For more information about these policy types, see Managed policies and inline policies in the IAM User Guide.

Policies that are attached to users and roles as permissions boundaries are not returned. To view which managed policy is currently used to set the permissions boundary for a user or role, use the GetUser or GetRole operations.

", "ListPolicyTags": "

Lists the tags that are attached to the specified IAM customer managed policy. The returned list of tags is sorted by tag key. For more information about tagging, see Tagging IAM resources in the IAM User Guide.

", "ListPolicyVersions": "

Lists information about the versions of the specified managed policy, including the version that is currently set as the policy's default version.

For more information about managed policies, see Managed policies and inline policies in the IAM User Guide.

", @@ -108,11 +108,11 @@ "ListServerCertificateTags": "

Lists the tags that are attached to the specified IAM server certificate. The returned list of tags is sorted by tag key. For more information about tagging, see Tagging IAM resources in the IAM User Guide.

For certificates in a Region supported by Certificate Manager (ACM), we recommend that you don't use IAM server certificates. Instead, use ACM to provision, manage, and deploy your server certificates. For more information about IAM server certificates, Working with server certificates in the IAM User Guide.

", "ListServerCertificates": "

Lists the server certificates stored in IAM that have the specified path prefix. If none exist, the operation returns an empty list.

You can paginate the results using the MaxItems and Marker parameters.

For more information about working with server certificates, see Working with server certificates in the IAM User Guide. This topic also includes a list of Amazon Web Services services that can use the server certificates that you manage with IAM.

IAM resource-listing operations return a subset of the available attributes for the resource. For example, this operation does not return tags, even though they are an attribute of the returned object. To view all of the information for a servercertificate, see GetServerCertificate.

", "ListServiceSpecificCredentials": "

Returns information about the service-specific credentials associated with the specified IAM user. If none exists, the operation returns an empty list. The service-specific credentials returned by this operation are used only for authenticating the IAM user to a specific service. For more information about using service-specific credentials to authenticate to an Amazon Web Services service, see Set up service-specific credentials in the CodeCommit User Guide.

", - "ListSigningCertificates": "

Returns information about the signing certificates associated with the specified IAM user. If none exists, the operation returns an empty list.

Although each user is limited to a small number of signing certificates, you can still paginate the results using the MaxItems and Marker parameters.

If the UserName field is not specified, the user name is determined implicitly based on the Amazon Web Services access key ID used to sign the request for this operation. This operation works for access keys under the account. Consequently, you can use this operation to manage account root user credentials even if the account has no associated users.

", + "ListSigningCertificates": "

Returns information about the signing certificates associated with the specified IAM user. If none exists, the operation returns an empty list.

Although each user is limited to a small number of signing certificates, you can still paginate the results using the MaxItems and Marker parameters.

If the UserName field is not specified, the user name is determined implicitly based on the Amazon Web Services access key ID used to sign the request for this operation. This operation works for access keys under the Amazon Web Services account. Consequently, you can use this operation to manage Amazon Web Services account root user credentials even if the Amazon Web Services account has no associated users.

", "ListUserPolicies": "

Lists the names of the inline policies embedded in the specified IAM user.

An IAM user can also have managed policies attached to it. To list the managed policies that are attached to a user, use ListAttachedUserPolicies. For more information about policies, see Managed policies and inline policies in the IAM User Guide.

You can paginate the results using the MaxItems and Marker parameters. If there are no inline policies embedded with the specified user, the operation returns an empty list.

", "ListUserTags": "

Lists the tags that are attached to the specified IAM user. The returned list of tags is sorted by tag key. For more information about tagging, see Tagging IAM resources in the IAM User Guide.

", - "ListUsers": "

Lists the IAM users that have the specified path prefix. If no path prefix is specified, the operation returns all users in the account. If there are none, the operation returns an empty list.

IAM resource-listing operations return a subset of the available attributes for the resource. For example, this operation does not return tags, even though they are an attribute of the returned object. To view all of the information for a user, see GetUser.

You can paginate the results using the MaxItems and Marker parameters.

", - "ListVirtualMFADevices": "

Lists the virtual MFA devices defined in the account by assignment status. If you do not specify an assignment status, the operation returns a list of all virtual MFA devices. Assignment status can be Assigned, Unassigned, or Any.

IAM resource-listing operations return a subset of the available attributes for the resource. For example, this operation does not return tags, even though they are an attribute of the returned object. To view all of the information for a virtual MFA device, see ListVirtualMFADevices.

You can paginate the results using the MaxItems and Marker parameters.

", + "ListUsers": "

Lists the IAM users that have the specified path prefix. If no path prefix is specified, the operation returns all users in the Amazon Web Services account. If there are none, the operation returns an empty list.

IAM resource-listing operations return a subset of the available attributes for the resource. For example, this operation does not return tags, even though they are an attribute of the returned object. To view all of the information for a user, see GetUser.

You can paginate the results using the MaxItems and Marker parameters.

", + "ListVirtualMFADevices": "

Lists the virtual MFA devices defined in the Amazon Web Services account by assignment status. If you do not specify an assignment status, the operation returns a list of all virtual MFA devices. Assignment status can be Assigned, Unassigned, or Any.

IAM resource-listing operations return a subset of the available attributes for the resource. For example, this operation does not return tags, even though they are an attribute of the returned object. To view all of the information for a virtual MFA device, see ListVirtualMFADevices.

You can paginate the results using the MaxItems and Marker parameters.

", "PutGroupPolicy": "

Adds or updates an inline policy document that is embedded in the specified IAM group.

A user can also have managed policies attached to it. To attach a managed policy to a group, use AttachGroupPolicy. To create a new managed policy, use CreatePolicy. For information about policies, see Managed policies and inline policies in the IAM User Guide.

For information about the maximum number of inline policies that you can embed in a group, see IAM and STS quotas in the IAM User Guide.

Because policy documents can be large, you should use POST rather than GET when calling PutGroupPolicy. For general information about using the Query API with IAM, see Making query requests in the IAM User Guide.

", "PutRolePermissionsBoundary": "

Adds or updates the policy that is specified as the IAM role's permissions boundary. You can use an Amazon Web Services managed policy or a customer managed policy to set the boundary for a role. Use the boundary to control the maximum permissions that the role can have. Setting a permissions boundary is an advanced feature that can affect the permissions for the role.

You cannot set the boundary for a service-linked role.

Policies used as permissions boundaries do not provide permissions. You must also attach a permissions policy to the role. To learn how the effective permissions for a role are evaluated, see IAM JSON policy evaluation logic in the IAM User Guide.

", "PutRolePolicy": "

Adds or updates an inline policy document that is embedded in the specified IAM role.

When you embed an inline policy in a role, the inline policy is used as part of the role's access (permissions) policy. The role's trust policy is created at the same time as the role, using CreateRole. You can update a role's trust policy using UpdateAssumeRolePolicy. For more information about IAM roles, see Using roles to delegate permissions and federate identities.

A role can also have a managed policy attached to it. To attach a managed policy to a role, use AttachRolePolicy. To create a new managed policy, use CreatePolicy. For information about policies, see Managed policies and inline policies in the IAM User Guide.

For information about the maximum number of inline policies that you can embed with a role, see IAM and STS quotas in the IAM User Guide.

Because policy documents can be large, you should use POST rather than GET when calling PutRolePolicy. For general information about using the Query API with IAM, see Making query requests in the IAM User Guide.

", @@ -124,7 +124,7 @@ "ResetServiceSpecificCredential": "

Resets the password for a service-specific credential. The new password is Amazon Web Services generated and cryptographically strong. It cannot be configured by the user. Resetting the password immediately invalidates the previous password associated with this user.

", "ResyncMFADevice": "

Synchronizes the specified MFA device with its IAM resource object on the Amazon Web Services servers.

For more information about creating and working with virtual MFA devices, see Using a virtual MFA device in the IAM User Guide.

", "SetDefaultPolicyVersion": "

Sets the specified version of the specified policy as the policy's default (operative) version.

This operation affects all users, groups, and roles that the policy is attached to. To list the users, groups, and roles that the policy is attached to, use ListEntitiesForPolicy.

For information about managed policies, see Managed policies and inline policies in the IAM User Guide.

", - "SetSecurityTokenServicePreferences": "

Sets the specified version of the global endpoint token as the token version used for the account.

By default, Security Token Service (STS) is available as a global service, and all STS requests go to a single endpoint at https://sts.amazonaws.com. Amazon Web Services recommends using Regional STS endpoints to reduce latency, build in redundancy, and increase session token availability. For information about Regional endpoints for STS, see Security Token Service endpoints and quotas in the Amazon Web Services General Reference.

If you make an STS call to the global endpoint, the resulting session tokens might be valid in some Regions but not others. It depends on the version that is set in this operation. Version 1 tokens are valid only in Regions that are available by default. These tokens do not work in manually enabled Regions, such as Asia Pacific (Hong Kong). Version 2 tokens are valid in all Regions. However, version 2 tokens are longer and might affect systems where you temporarily store tokens. For information, see Activating and deactivating STS in an Region in the IAM User Guide.

To view the current session token version, see the GlobalEndpointTokenVersion entry in the response of the GetAccountSummary operation.

", + "SetSecurityTokenServicePreferences": "

Sets the specified version of the global endpoint token as the token version used for the Amazon Web Services account.

By default, Security Token Service (STS) is available as a global service, and all STS requests go to a single endpoint at https://sts.amazonaws.com. Amazon Web Services recommends using Regional STS endpoints to reduce latency, build in redundancy, and increase session token availability. For information about Regional endpoints for STS, see Security Token Service endpoints and quotas in the Amazon Web Services General Reference.

If you make an STS call to the global endpoint, the resulting session tokens might be valid in some Regions but not others. It depends on the version that is set in this operation. Version 1 tokens are valid only in Amazon Web Services Regions that are available by default. These tokens do not work in manually enabled Regions, such as Asia Pacific (Hong Kong). Version 2 tokens are valid in all Regions. However, version 2 tokens are longer and might affect systems where you temporarily store tokens. For information, see Activating and deactivating STS in an Amazon Web Services Region in the IAM User Guide.

To view the current session token version, see the GlobalEndpointTokenVersion entry in the response of the GetAccountSummary operation.

", "SimulateCustomPolicy": "

Simulate how a set of IAM policies and optionally a resource-based policy works with a list of API operations and Amazon Web Services resources to determine the policies' effective permissions. The policies are provided as strings.

The simulation does not perform the API operations; it only checks the authorization to determine if the simulated policies allow or deny the operations. You can simulate resources that don't exist in your account.

If you want to simulate existing policies that are attached to an IAM user, group, or role, use SimulatePrincipalPolicy instead.

Context keys are variables that are maintained by Amazon Web Services and its services and which provide details about the context of an API query request. You can use the Condition element of an IAM policy to evaluate context keys. To get the list of context keys that the policies require for correct simulation, use GetContextKeysForCustomPolicy.

If the output is long, you can use MaxItems and Marker parameters to paginate the results.

For more information about using the policy simulator, see Testing IAM policies with the IAM policy simulator in the IAM User Guide.

", "SimulatePrincipalPolicy": "

Simulate how a set of IAM policies attached to an IAM entity works with a list of API operations and Amazon Web Services resources to determine the policies' effective permissions. The entity can be an IAM user, group, or role. If you specify a user, then the simulation also includes all of the policies that are attached to groups that the user belongs to. You can simulate resources that don't exist in your account.

You can optionally include a list of one or more additional policies specified as strings to include in the simulation. If you want to simulate only policies specified as strings, use SimulateCustomPolicy instead.

You can also optionally include one resource-based policy to be evaluated with each of the resources included in the simulation.

The simulation does not perform the API operations; it only checks the authorization to determine if the simulated policies allow or deny the operations.

Note: This operation discloses information about the permissions granted to other users. If you do not want users to see other user's permissions, then consider allowing them to use SimulateCustomPolicy instead.

Context keys are variables maintained by Amazon Web Services and its services that provide details about the context of an API query request. You can use the Condition element of an IAM policy to evaluate context keys. To get the list of context keys that the policies require for correct simulation, use GetContextKeysForPrincipalPolicy.

If the output is long, you can use the MaxItems and Marker parameters to paginate the results.

For more information about using the policy simulator, see Testing IAM policies with the IAM policy simulator in the IAM User Guide.

", "TagInstanceProfile": "

Adds one or more tags to an IAM instance profile. If a tag with the same key name already exists, then that tag is overwritten with the new value.

Each tag consists of a key name and an associated value. By assigning tags to your resources, you can do the following:

", @@ -143,11 +143,11 @@ "UntagSAMLProvider": "

Removes the specified tags from the specified Security Assertion Markup Language (SAML) identity provider in IAM. For more information about these providers, see About web identity federation. For more information about tagging, see Tagging IAM resources in the IAM User Guide.

", "UntagServerCertificate": "

Removes the specified tags from the IAM server certificate. For more information about tagging, see Tagging IAM resources in the IAM User Guide.

For certificates in a Region supported by Certificate Manager (ACM), we recommend that you don't use IAM server certificates. Instead, use ACM to provision, manage, and deploy your server certificates. For more information about IAM server certificates, Working with server certificates in the IAM User Guide.

", "UntagUser": "

Removes the specified tags from the user. For more information about tagging, see Tagging IAM resources in the IAM User Guide.

", - "UpdateAccessKey": "

Changes the status of the specified access key from Active to Inactive, or vice versa. This operation can be used to disable a user's key as part of a key rotation workflow.

If the UserName is not specified, the user name is determined implicitly based on the Amazon Web Services access key ID used to sign the request. This operation works for access keys under the account. Consequently, you can use this operation to manage account root user credentials even if the account has no associated users.

For information about rotating keys, see Managing keys and certificates in the IAM User Guide.

", - "UpdateAccountPasswordPolicy": "

Updates the password policy settings for the account.

For more information about using a password policy, see Managing an IAM password policy in the IAM User Guide.

", + "UpdateAccessKey": "

Changes the status of the specified access key from Active to Inactive, or vice versa. This operation can be used to disable a user's key as part of a key rotation workflow.

If the UserName is not specified, the user name is determined implicitly based on the Amazon Web Services access key ID used to sign the request. This operation works for access keys under the Amazon Web Services account. Consequently, you can use this operation to manage Amazon Web Services account root user credentials even if the Amazon Web Services account has no associated users.

For information about rotating keys, see Managing keys and certificates in the IAM User Guide.

", + "UpdateAccountPasswordPolicy": "

Updates the password policy settings for the Amazon Web Services account.

For more information about using a password policy, see Managing an IAM password policy in the IAM User Guide.

", "UpdateAssumeRolePolicy": "

Updates the policy that grants an IAM entity permission to assume a role. This is typically referred to as the \"role trust policy\". For more information about roles, see Using roles to delegate permissions and federate identities.

", "UpdateGroup": "

Updates the name and/or the path of the specified IAM group.

You should understand the implications of changing a group's path or name. For more information, see Renaming users and groups in the IAM User Guide.

The person making the request (the principal), must have permission to change the role group with the old name and the new name. For example, to change the group named Managers to MGRs, the principal must have a policy that allows them to update both groups. If the principal has permission to update the Managers group, but not the MGRs group, then the update fails. For more information about permissions, see Access management.

", - "UpdateLoginProfile": "

Changes the password for the specified IAM user. You can use the CLI, the Amazon Web Services API, or the Users page in the IAM console to change the password for any IAM user. Use ChangePassword to change your own password in the My Security Credentials page in the Management Console.

For more information about modifying passwords, see Managing passwords in the IAM User Guide.

", + "UpdateLoginProfile": "

Changes the password for the specified IAM user. You can use the CLI, the Amazon Web Services API, or the Users page in the IAM console to change the password for any IAM user. Use ChangePassword to change your own password in the My Security Credentials page in the Amazon Web Services Management Console.

For more information about modifying passwords, see Managing passwords in the IAM User Guide.

", "UpdateOpenIDConnectProviderThumbprint": "

Replaces the existing list of server certificate thumbprints associated with an OpenID Connect (OIDC) provider resource object with a new list of thumbprints.

The list that you pass with this operation completely replaces the existing list of thumbprints. (The lists are not merged.)

Typically, you need to update a thumbprint only when the identity provider certificate changes, which occurs rarely. However, if the provider's certificate does change, any attempt to assume an IAM role that specifies the OIDC provider as a principal fails until the certificate thumbprint is updated.

Amazon Web Services secures communication with some OIDC identity providers (IdPs) through our library of trusted certificate authorities (CAs) instead of using a certificate thumbprint to verify your IdP server certificate. These OIDC IdPs include Google, and those that use an Amazon S3 bucket to host a JSON Web Key Set (JWKS) endpoint. In these cases, your legacy thumbprint remains in your configuration, but is no longer used for validation.

Trust for the OIDC provider is derived from the provider certificate and is validated by the thumbprint. Therefore, it is best to limit access to the UpdateOpenIDConnectProviderThumbprint operation to highly privileged users.

", "UpdateRole": "

Updates the description or maximum session duration setting of a role.

", "UpdateRoleDescription": "

Use UpdateRole instead.

Modifies only the description of a role. This operation performs the same function as the Description parameter in the UpdateRole operation.

", @@ -155,11 +155,11 @@ "UpdateSSHPublicKey": "

Sets the status of an IAM user's SSH public key to active or inactive. SSH public keys that are inactive cannot be used for authentication. This operation can be used to disable a user's SSH public key as part of a key rotation work flow.

The SSH public key affected by this operation is used only for authenticating the associated IAM user to an CodeCommit repository. For more information about using SSH keys to authenticate to an CodeCommit repository, see Set up CodeCommit for SSH connections in the CodeCommit User Guide.

", "UpdateServerCertificate": "

Updates the name and/or the path of the specified server certificate stored in IAM.

For more information about working with server certificates, see Working with server certificates in the IAM User Guide. This topic also includes a list of Amazon Web Services services that can use the server certificates that you manage with IAM.

You should understand the implications of changing a server certificate's path or name. For more information, see Renaming a server certificate in the IAM User Guide.

The person making the request (the principal), must have permission to change the server certificate with the old name and the new name. For example, to change the certificate named ProductionCert to ProdCert, the principal must have a policy that allows them to update both certificates. If the principal has permission to update the ProductionCert group, but not the ProdCert certificate, then the update fails. For more information about permissions, see Access management in the IAM User Guide.

", "UpdateServiceSpecificCredential": "

Sets the status of a service-specific credential to Active or Inactive. Service-specific credentials that are inactive cannot be used for authentication to the service. This operation can be used to disable a user's service-specific credential as part of a credential rotation work flow.

", - "UpdateSigningCertificate": "

Changes the status of the specified user signing certificate from active to disabled, or vice versa. This operation can be used to disable an IAM user's signing certificate as part of a certificate rotation work flow.

If the UserName field is not specified, the user name is determined implicitly based on the Amazon Web Services access key ID used to sign the request. This operation works for access keys under the account. Consequently, you can use this operation to manage account root user credentials even if the account has no associated users.

", + "UpdateSigningCertificate": "

Changes the status of the specified user signing certificate from active to disabled, or vice versa. This operation can be used to disable an IAM user's signing certificate as part of a certificate rotation work flow.

If the UserName field is not specified, the user name is determined implicitly based on the Amazon Web Services access key ID used to sign the request. This operation works for access keys under the Amazon Web Services account. Consequently, you can use this operation to manage Amazon Web Services account root user credentials even if the Amazon Web Services account has no associated users.

", "UpdateUser": "

Updates the name and/or the path of the specified IAM user.

You should understand the implications of changing an IAM user's path or name. For more information, see Renaming an IAM user and Renaming an IAM group in the IAM User Guide.

To change a user name, the requester must have appropriate permissions on both the source object and the target object. For example, to change Bob to Robert, the entity making the request must have permission on Bob and Robert, or must have permission on all (*). For more information about permissions, see Permissions and policies.

", "UploadSSHPublicKey": "

Uploads an SSH public key and associates it with the specified IAM user.

The SSH public key uploaded by this operation can be used only for authenticating the associated IAM user to an CodeCommit repository. For more information about using SSH keys to authenticate to an CodeCommit repository, see Set up CodeCommit for SSH connections in the CodeCommit User Guide.

", - "UploadServerCertificate": "

Uploads a server certificate entity for the account. The server certificate entity includes a public key certificate, a private key, and an optional certificate chain, which should all be PEM-encoded.

We recommend that you use Certificate Manager to provision, manage, and deploy your server certificates. With ACM you can request a certificate, deploy it to Amazon Web Services resources, and let ACM handle certificate renewals for you. Certificates provided by ACM are free. For more information about using ACM, see the Certificate Manager User Guide.

For more information about working with server certificates, see Working with server certificates in the IAM User Guide. This topic includes a list of Amazon Web Services services that can use the server certificates that you manage with IAM.

For information about the number of server certificates you can upload, see IAM and STS quotas in the IAM User Guide.

Because the body of the public key certificate, private key, and the certificate chain can be large, you should use POST rather than GET when calling UploadServerCertificate. For information about setting up signatures and authorization through the API, see Signing Amazon Web Services API requests in the Amazon Web Services General Reference. For general information about using the Query API with IAM, see Calling the API by making HTTP query requests in the IAM User Guide.

", - "UploadSigningCertificate": "

Uploads an X.509 signing certificate and associates it with the specified IAM user. Some Amazon Web Services services require you to use certificates to validate requests that are signed with a corresponding private key. When you upload the certificate, its default status is Active.

For information about when you would use an X.509 signing certificate, see Managing server certificates in IAM in the IAM User Guide.

If the UserName is not specified, the IAM user name is determined implicitly based on the Amazon Web Services access key ID used to sign the request. This operation works for access keys under the account. Consequently, you can use this operation to manage account root user credentials even if the account has no associated users.

Because the body of an X.509 certificate can be large, you should use POST rather than GET when calling UploadSigningCertificate. For information about setting up signatures and authorization through the API, see Signing Amazon Web Services API requests in the Amazon Web Services General Reference. For general information about using the Query API with IAM, see Making query requests in the IAM User Guide.

" + "UploadServerCertificate": "

Uploads a server certificate entity for the Amazon Web Services account. The server certificate entity includes a public key certificate, a private key, and an optional certificate chain, which should all be PEM-encoded.

We recommend that you use Certificate Manager to provision, manage, and deploy your server certificates. With ACM you can request a certificate, deploy it to Amazon Web Services resources, and let ACM handle certificate renewals for you. Certificates provided by ACM are free. For more information about using ACM, see the Certificate Manager User Guide.

For more information about working with server certificates, see Working with server certificates in the IAM User Guide. This topic includes a list of Amazon Web Services services that can use the server certificates that you manage with IAM.

For information about the number of server certificates you can upload, see IAM and STS quotas in the IAM User Guide.

Because the body of the public key certificate, private key, and the certificate chain can be large, you should use POST rather than GET when calling UploadServerCertificate. For information about setting up signatures and authorization through the API, see Signing Amazon Web Services API requests in the Amazon Web Services General Reference. For general information about using the Query API with IAM, see Calling the API by making HTTP query requests in the IAM User Guide.

", + "UploadSigningCertificate": "

Uploads an X.509 signing certificate and associates it with the specified IAM user. Some Amazon Web Services services require you to use certificates to validate requests that are signed with a corresponding private key. When you upload the certificate, its default status is Active.

For information about when you would use an X.509 signing certificate, see Managing server certificates in IAM in the IAM User Guide.

If the UserName is not specified, the IAM user name is determined implicitly based on the Amazon Web Services access key ID used to sign the request. This operation works for access keys under the Amazon Web Services account. Consequently, you can use this operation to manage Amazon Web Services account root user credentials even if the Amazon Web Services account has no associated users.

Because the body of an X.509 certificate can be large, you should use POST rather than GET when calling UploadSigningCertificate. For information about setting up signatures and authorization through the API, see Signing Amazon Web Services API requests in the Amazon Web Services General Reference. For general information about using the Query API with IAM, see Making query requests in the IAM User Guide.

" }, "shapes": { "AccessAdvisorUsageGranularityType": { @@ -1438,13 +1438,13 @@ "OpenIDConnectProviderListType": { "base": "

Contains a list of IAM OpenID Connect providers.

", "refs": { - "ListOpenIDConnectProvidersResponse$OpenIDConnectProviderList": "

The list of IAM OIDC provider resource objects defined in the account.

" + "ListOpenIDConnectProvidersResponse$OpenIDConnectProviderList": "

The list of IAM OIDC provider resource objects defined in the Amazon Web Services account.

" } }, "OpenIDConnectProviderUrlType": { "base": "

Contains a URL that specifies the endpoint for an OpenID Connect provider.

", "refs": { - "CreateOpenIDConnectProviderRequest$Url": "

The URL of the identity provider. The URL must begin with https:// and should correspond to the iss claim in the provider's OpenID Connect ID tokens. Per the OIDC standard, path components are allowed but query parameters are not. Typically the URL consists of only a hostname, like https://server.example.org or https://example.com.

You cannot register the same provider multiple times in a single account. If you try to submit a URL that has already been used for an OpenID Connect provider in the account, you will get an error.

", + "CreateOpenIDConnectProviderRequest$Url": "

The URL of the identity provider. The URL must begin with https:// and should correspond to the iss claim in the provider's OpenID Connect ID tokens. Per the OIDC standard, path components are allowed but query parameters are not. Typically the URL consists of only a hostname, like https://server.example.org or https://example.com. The URL should not contain a port number.

You cannot register the same provider multiple times in a single Amazon Web Services account. If you try to submit a URL that has already been used for an OpenID Connect provider in the Amazon Web Services account, you will get an error.

", "GetOpenIDConnectProviderResponse$Url": "

The URL that the IAM OIDC provider resource object is associated with. For more information, see CreateOpenIDConnectProvider.

" } }, @@ -1697,9 +1697,9 @@ "EvaluationResult$EvalResourceName": "

The ARN of the resource that the indicated API operation was tested on.

", "ResourceNameListType$member": null, "ResourceSpecificResult$EvalResourceName": "

The name of the simulated resource, in Amazon Resource Name (ARN) format.

", - "SimulateCustomPolicyRequest$ResourceOwner": "

An ARN representing the account ID that specifies the owner of any simulated resource that does not identify its owner in the resource ARN. Examples of resource ARNs include an S3 bucket or object. If ResourceOwner is specified, it is also used as the account owner of any ResourcePolicy included in the simulation. If the ResourceOwner parameter is not specified, then the owner of the resources and the resource policy defaults to the account of the identity provided in CallerArn. This parameter is required only if you specify a resource-based policy and account that owns the resource is different from the account that owns the simulated calling user CallerArn.

The ARN for an account uses the following syntax: arn:aws:iam::AWS-account-ID:root. For example, to represent the account with the 112233445566 ID, use the following ARN: arn:aws:iam::112233445566-ID:root.

", + "SimulateCustomPolicyRequest$ResourceOwner": "

An ARN representing the Amazon Web Services account ID that specifies the owner of any simulated resource that does not identify its owner in the resource ARN. Examples of resource ARNs include an S3 bucket or object. If ResourceOwner is specified, it is also used as the account owner of any ResourcePolicy included in the simulation. If the ResourceOwner parameter is not specified, then the owner of the resources and the resource policy defaults to the account of the identity provided in CallerArn. This parameter is required only if you specify a resource-based policy and account that owns the resource is different from the account that owns the simulated calling user CallerArn.

The ARN for an account uses the following syntax: arn:aws:iam::AWS-account-ID:root. For example, to represent the account with the 112233445566 ID, use the following ARN: arn:aws:iam::112233445566-ID:root.

", "SimulateCustomPolicyRequest$CallerArn": "

The ARN of the IAM user that you want to use as the simulated caller of the API operations. CallerArn is required if you include a ResourcePolicy so that the policy's Principal element has a value to use in evaluating the policy.

You can specify only the ARN of an IAM user. You cannot specify the ARN of an assumed role, federated user, or a service principal.

", - "SimulatePrincipalPolicyRequest$ResourceOwner": "

An account ID that specifies the owner of any simulated resource that does not identify its owner in the resource ARN. Examples of resource ARNs include an S3 bucket or object. If ResourceOwner is specified, it is also used as the account owner of any ResourcePolicy included in the simulation. If the ResourceOwner parameter is not specified, then the owner of the resources and the resource policy defaults to the account of the identity provided in CallerArn. This parameter is required only if you specify a resource-based policy and account that owns the resource is different from the account that owns the simulated calling user CallerArn.

", + "SimulatePrincipalPolicyRequest$ResourceOwner": "

An Amazon Web Services account ID that specifies the owner of any simulated resource that does not identify its owner in the resource ARN. Examples of resource ARNs include an S3 bucket or object. If ResourceOwner is specified, it is also used as the account owner of any ResourcePolicy included in the simulation. If the ResourceOwner parameter is not specified, then the owner of the resources and the resource policy defaults to the account of the identity provided in CallerArn. This parameter is required only if you specify a resource-based policy and account that owns the resource is different from the account that owns the simulated calling user CallerArn.

", "SimulatePrincipalPolicyRequest$CallerArn": "

The ARN of the IAM user that you want to specify as the simulated caller of the API operations. If you do not specify a CallerArn, it defaults to the ARN of the user that you specify in PolicySourceArn, if you specified a user. If you include both a PolicySourceArn (for example, arn:aws:iam::123456789012:user/David) and a CallerArn (for example, arn:aws:iam::123456789012:user/Bob), the result is that you simulate calling the API operations as Bob, as if Bob had David's policies.

You can specify only the ARN of an IAM user. You cannot specify the ARN of an assumed role, federated user, or a service principal.

CallerArn is required if you include a ResourcePolicy and the PolicySourceArn is not the ARN for an IAM user. This is required so that the resource-based policy's Principal element has a value to use in evaluating the policy.

For more information about ARNs, see Amazon Resource Names (ARNs) in the Amazon Web Services General Reference.

" } }, @@ -2360,7 +2360,7 @@ "UpdateAccountPasswordPolicyRequest$RequireNumbers": "

Specifies whether IAM user passwords must contain at least one numeric character (0 to 9).

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one numeric character.

", "UpdateAccountPasswordPolicyRequest$RequireUppercaseCharacters": "

Specifies whether IAM user passwords must contain at least one uppercase character from the ISO basic Latin alphabet (A to Z).

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one uppercase character.

", "UpdateAccountPasswordPolicyRequest$RequireLowercaseCharacters": "

Specifies whether IAM user passwords must contain at least one lowercase character from the ISO basic Latin alphabet (a to z).

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that passwords do not require at least one lowercase character.

", - "UpdateAccountPasswordPolicyRequest$AllowUsersToChangePassword": "

Allows all IAM users in your account to use the Management Console to change their own passwords. For more information, see Letting IAM users change their own passwords in the IAM User Guide.

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that IAM users in the account do not automatically have permissions to change their own password.

" + "UpdateAccountPasswordPolicyRequest$AllowUsersToChangePassword": "

Allows all IAM users in your account to use the Amazon Web Services Management Console to change their own passwords. For more information, see Letting IAM users change their own passwords in the IAM User Guide.

If you do not specify a value for this parameter, then the operation uses the default value of false. The result is that IAM users in the account do not automatically have permissions to change their own password.

" } }, "certificateBodyType": { @@ -2396,7 +2396,7 @@ "clientIDListType": { "base": null, "refs": { - "CreateOpenIDConnectProviderRequest$ClientIDList": "

A list of client IDs (also known as audiences). When a mobile or web app registers with an OpenID Connect provider, they establish a value that identifies the application. (This is the value that's sent as the client_id parameter on OAuth requests.)

You can register multiple client IDs with the same provider. For example, you might have multiple applications that use the same OIDC provider. You cannot register more than 100 client IDs with a single IAM OIDC provider.

There is no defined format for a client ID. The CreateOpenIDConnectProviderRequest operation accepts client IDs up to 255 characters long.

", + "CreateOpenIDConnectProviderRequest$ClientIDList": "

Provides a list of client IDs, also known as audiences. When a mobile or web app registers with an OpenID Connect provider, they establish a value that identifies the application. This is the value that's sent as the client_id parameter on OAuth requests.

You can register multiple client IDs with the same provider. For example, you might have multiple applications that use the same OIDC provider. You cannot register more than 100 client IDs with a single IAM OIDC provider.

There is no defined format for a client ID. The CreateOpenIDConnectProviderRequest operation accepts client IDs up to 255 characters long.

", "GetOpenIDConnectProviderResponse$ClientIDList": "

A list of client IDs (also known as audiences) that are associated with the specified IAM OIDC provider resource object. For more information, see CreateOpenIDConnectProvider.

" } }, @@ -2441,7 +2441,7 @@ "AccessKeyMetadata$CreateDate": "

The date when the access key was created.

", "EntityDetails$LastAuthenticated": "

The date and time, in ISO 8601 date-time format, when the authenticated entity last attempted to access Amazon Web Services. Amazon Web Services does not report unauthenticated requests.

This field is null if no IAM entities attempted to access the service within the reporting period.

", "GetCredentialReportResponse$GeneratedTime": "

The date and time when the credential report was created, in ISO 8601 date-time format.

", - "GetOpenIDConnectProviderResponse$CreateDate": "

The date and time when the IAM OIDC provider resource object was created in the account.

", + "GetOpenIDConnectProviderResponse$CreateDate": "

The date and time when the IAM OIDC provider resource object was created in the Amazon Web Services account.

", "GetOrganizationsAccessReportResponse$JobCreationDate": "

The date and time, in ISO 8601 date-time format, when the report job was created.

", "GetOrganizationsAccessReportResponse$JobCompletionDate": "

The date and time, in ISO 8601 date-time format, when the generated report job was completed or failed.

This field is null if the job is still in progress, as indicated by a job status value of IN_PROGRESS.

", "GetSAMLProviderResponse$CreateDate": "

The date and time when the SAML provider was created.

", @@ -2569,7 +2569,7 @@ "globalEndpointTokenVersion": { "base": null, "refs": { - "SetSecurityTokenServicePreferencesRequest$GlobalEndpointTokenVersion": "

The version of the global endpoint token. Version 1 tokens are valid only in Regions that are available by default. These tokens do not work in manually enabled Regions, such as Asia Pacific (Hong Kong). Version 2 tokens are valid in all Regions. However, version 2 tokens are longer and might affect systems where you temporarily store tokens.

For information, see Activating and deactivating STS in an Region in the IAM User Guide.

" + "SetSecurityTokenServicePreferencesRequest$GlobalEndpointTokenVersion": "

The version of the global endpoint token. Version 1 tokens are valid only in Amazon Web Services Regions that are available by default. These tokens do not work in manually enabled Regions, such as Asia Pacific (Hong Kong). Version 2 tokens are valid in all Regions. However, version 2 tokens are longer and might affect systems where you temporarily store tokens.

For information, see Activating and deactivating STS in an Amazon Web Services Region in the IAM User Guide.

" } }, "groupDetailListType": { @@ -2886,9 +2886,9 @@ "base": null, "refs": { "ChangePasswordRequest$OldPassword": "

The IAM user's current password.

", - "ChangePasswordRequest$NewPassword": "

The new password. The new password must conform to the account's password policy, if one exists.

The regex pattern that is used to validate this parameter is a string of characters. That string can include almost any printable ASCII character from the space (\\u0020) through the end of the ASCII character range (\\u00FF). You can also include the tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D) characters. Any of these characters are valid in a password. However, many tools, such as the Management Console, might restrict the ability to type certain characters because they have special meaning within that tool.

", - "CreateLoginProfileRequest$Password": "

The new password for the user.

The regex pattern that is used to validate this parameter is a string of characters. That string can include almost any printable ASCII character from the space (\\u0020) through the end of the ASCII character range (\\u00FF). You can also include the tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D) characters. Any of these characters are valid in a password. However, many tools, such as the Management Console, might restrict the ability to type certain characters because they have special meaning within that tool.

", - "UpdateLoginProfileRequest$Password": "

The new password for the specified IAM user.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

However, the format can be further restricted by the account administrator by setting a password policy on the account. For more information, see UpdateAccountPasswordPolicy.

" + "ChangePasswordRequest$NewPassword": "

The new password. The new password must conform to the Amazon Web Services account's password policy, if one exists.

The regex pattern that is used to validate this parameter is a string of characters. That string can include almost any printable ASCII character from the space (\\u0020) through the end of the ASCII character range (\\u00FF). You can also include the tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D) characters. Any of these characters are valid in a password. However, many tools, such as the Amazon Web Services Management Console, might restrict the ability to type certain characters because they have special meaning within that tool.

", + "CreateLoginProfileRequest$Password": "

The new password for the user.

The regex pattern that is used to validate this parameter is a string of characters. That string can include almost any printable ASCII character from the space (\\u0020) through the end of the ASCII character range (\\u00FF). You can also include the tab (\\u0009), line feed (\\u000A), and carriage return (\\u000D) characters. Any of these characters are valid in a password. However, many tools, such as the Amazon Web Services Management Console, might restrict the ability to type certain characters because they have special meaning within that tool.

", + "UpdateLoginProfileRequest$Password": "

The new password for the specified IAM user.

The regex pattern used to validate this parameter is a string of characters consisting of the following:

However, the format can be further restricted by the account administrator by setting a password policy on the Amazon Web Services account. For more information, see UpdateAccountPasswordPolicy.

" } }, "pathPrefixType": { @@ -3036,7 +3036,7 @@ "policyPathType": { "base": null, "refs": { - "CreatePolicyRequest$Path": "

The path for the policy.

For more information about paths, see IAM identifiers in the IAM User Guide.

This parameter is optional. If it is not included, it defaults to a slash (/).

This parameter allows (through its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

", + "CreatePolicyRequest$Path": "

The path for the policy.

For more information about paths, see IAM identifiers in the IAM User Guide.

This parameter is optional. If it is not included, it defaults to a slash (/).

This parameter allows (through its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

You cannot use an asterisk (*) in the path name.

", "ListAttachedGroupPoliciesRequest$PathPrefix": "

The path prefix for filtering the results. This parameter is optional. If it is not included, it defaults to a slash (/), listing all policies.

This parameter allows (through its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

", "ListAttachedRolePoliciesRequest$PathPrefix": "

The path prefix for filtering the results. This parameter is optional. If it is not included, it defaults to a slash (/), listing all policies.

This parameter allows (through its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

", "ListAttachedUserPoliciesRequest$PathPrefix": "

The path prefix for filtering the results. This parameter is optional. If it is not included, it defaults to a slash (/), listing all policies.

This parameter allows (through its regex pattern) a string of characters consisting of either a forward slash (/) by itself or a string that must begin and end with forward slashes. In addition, it can contain any ASCII character from the ! (\\u0021) through the DEL character (\\u007F), including most punctuation characters, digits, and upper and lowercased letters.

", @@ -3048,7 +3048,7 @@ "policyScopeType": { "base": null, "refs": { - "ListPoliciesRequest$Scope": "

The scope to use for filtering the results.

To list only Amazon Web Services managed policies, set Scope to AWS. To list only the customer managed policies in your account, set Scope to Local.

This parameter is optional. If it is not included, or if it is set to All, all policies are returned.

" + "ListPoliciesRequest$Scope": "

The scope to use for filtering the results.

To list only Amazon Web Services managed policies, set Scope to AWS. To list only the customer managed policies in your Amazon Web Services account, set Scope to Local.

This parameter is optional. If it is not included, or if it is set to All, all policies are returned.

" } }, "policyType": { @@ -3334,10 +3334,10 @@ "refs": { "AccessDetail$Region": "

The Region where the last service access attempt occurred.

This field is null if no principals in the reported Organizations entity attempted to access the service within the reporting period.

", "AccessKeyLastUsed$ServiceName": "

The name of the Amazon Web Services service with which this access key was most recently used. The value of this field is \"N/A\" in the following situations:

", - "AccessKeyLastUsed$Region": "

The Region where this access key was most recently used. The value for this field is \"N/A\" in the following situations:

For more information about Regions, see Regions and endpoints in the Amazon Web Services General Reference.

", + "AccessKeyLastUsed$Region": "

The Amazon Web Services Region where this access key was most recently used. The value for this field is \"N/A\" in the following situations:

For more information about Amazon Web Services Regions, see Regions and endpoints in the Amazon Web Services General Reference.

", "ErrorDetails$Message": "

Detailed information about the reason that the operation failed.

", "ErrorDetails$Code": "

The error code associated with the operation failure.

", - "RoleLastUsed$Region": "

The name of the Region in which the role was last used.

", + "RoleLastUsed$Region": "

The name of the Amazon Web Services Region in which the role was last used.

", "ServiceLastAccessed$LastAuthenticatedRegion": "

The Region from which the authenticated entity (user or role) last attempted to access the service. Amazon Web Services does not report unauthenticated requests.

This field is null if no IAM entities attempted to access the service within the reporting period.

", "TrackedActionLastAccessed$ActionName": "

The name of the tracked action to which access was attempted. Tracked actions are actions that report activity to IAM.

", "TrackedActionLastAccessed$LastAccessedRegion": "

The Region from which the authenticated entity (user or role) last attempted to access the tracked action. Amazon Web Services does not report unauthenticated requests.

This field is null if no IAM entities attempted to access the service within the reporting period.

" @@ -3432,7 +3432,7 @@ "thumbprintListType": { "base": "

Contains a list of thumbprints of identity provider server certificates.

", "refs": { - "CreateOpenIDConnectProviderRequest$ThumbprintList": "

A list of server certificate thumbprints for the OpenID Connect (OIDC) identity provider's server certificates. Typically this list includes only one entry. However, IAM lets you have up to five thumbprints for an OIDC provider. This lets you maintain multiple thumbprints if the identity provider is rotating certificates.

The server certificate thumbprint is the hex-encoded SHA-1 hash value of the X.509 certificate used by the domain where the OpenID Connect provider makes its keys available. It is always a 40-character string.

You must provide at least one thumbprint when creating an IAM OIDC provider. For example, assume that the OIDC provider is server.example.com and the provider stores its keys at https://keys.server.example.com/openid-connect. In that case, the thumbprint string would be the hex-encoded SHA-1 hash value of the certificate used by https://keys.server.example.com.

For more information about obtaining the OIDC provider's thumbprint, see Obtaining the thumbprint for an OpenID Connect provider in the IAM User Guide.

", + "CreateOpenIDConnectProviderRequest$ThumbprintList": "

A list of server certificate thumbprints for the OpenID Connect (OIDC) identity provider's server certificates. Typically this list includes only one entry. However, IAM lets you have up to five thumbprints for an OIDC provider. This lets you maintain multiple thumbprints if the identity provider is rotating certificates.

The server certificate thumbprint is the hex-encoded SHA-1 hash value of the X.509 certificate used by the domain where the OpenID Connect provider makes its keys available. It is always a 40-character string.

You must provide at least one thumbprint when creating an IAM OIDC provider. For example, assume that the OIDC provider is server.example.com and the provider stores its keys at https://keys.server.example.com/openid-connect. In that case, the thumbprint string would be the hex-encoded SHA-1 hash value of the certificate used by https://keys.server.example.com.

For more information about obtaining the OIDC provider thumbprint, see Obtaining the thumbprint for an OpenID Connect provider in the IAM User Guide.

", "GetOpenIDConnectProviderResponse$ThumbprintList": "

A list of certificate thumbprints that are associated with the specified IAM OIDC provider resource object. For more information, see CreateOpenIDConnectProvider.

", "UpdateOpenIDConnectProviderThumbprintRequest$ThumbprintList": "

A list of certificate thumbprints that are associated with the specified IAM OpenID Connect provider. For more information, see CreateOpenIDConnectProvider.

" } @@ -3488,7 +3488,7 @@ "ListAttachedUserPoliciesRequest$UserName": "

The name (friendly name, not ARN) of the user to list attached policies for.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

", "ListSSHPublicKeysRequest$UserName": "

The name of the IAM user to list SSH public keys for. If none is specified, the UserName field is determined implicitly based on the Amazon Web Services access key used to sign the request.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

", "ListServiceSpecificCredentialsRequest$UserName": "

The name of the user whose service-specific credentials you want information about. If this value is not specified, then the operation assumes the user whose credentials are used to call the operation.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

", - "LoginProfile$UserName": "

The name of the user, which can be used for signing in to the Management Console.

", + "LoginProfile$UserName": "

The name of the user, which can be used for signing in to the Amazon Web Services Management Console.

", "MFADevice$UserName": "

The user with whom the MFA device is associated.

", "PolicyUser$UserName": "

The name (friendly name, not ARN) identifying the user.

", "PutUserPermissionsBoundaryRequest$UserName": "

The name (friendly name, not ARN) of the IAM user for which you want to set the permissions boundary.

", diff --git a/models/apis/imagebuilder/2019-12-02/api-2.json b/models/apis/imagebuilder/2019-12-02/api-2.json index da4ea023928..76e7dd09612 100644 --- a/models/apis/imagebuilder/2019-12-02/api-2.json +++ b/models/apis/imagebuilder/2019-12-02/api-2.json @@ -1019,6 +1019,7 @@ "type":{"shape":"ComponentType"}, "platform":{"shape":"Platform"}, "supportedOsVersions":{"shape":"OsVersionList"}, + "state":{"shape":"ComponentState"}, "parameters":{"shape":"ComponentParameterDetailList"}, "owner":{"shape":"NonEmptyString"}, "data":{"shape":"ComponentData"}, @@ -1110,6 +1111,17 @@ "type":"list", "member":{"shape":"ComponentParameterValue"} }, + "ComponentState":{ + "type":"structure", + "members":{ + "status":{"shape":"ComponentStatus"}, + "reason":{"shape":"NonEmptyString"} + } + }, + "ComponentStatus":{ + "type":"string", + "enum":["DEPRECATED"] + }, "ComponentSummary":{ "type":"structure", "members":{ @@ -1118,6 +1130,7 @@ "version":{"shape":"VersionNumber"}, "platform":{"shape":"Platform"}, "supportedOsVersions":{"shape":"OsVersionList"}, + "state":{"shape":"ComponentState"}, "type":{"shape":"ComponentType"}, "owner":{"shape":"NonEmptyString"}, "description":{"shape":"NonEmptyString"}, @@ -1447,6 +1460,7 @@ "terminateInstanceOnFailure":{"shape":"NullableBoolean"}, "snsTopicArn":{"shape":"SnsTopicArn"}, "resourceTags":{"shape":"ResourceTagMap"}, + "instanceMetadataOptions":{"shape":"InstanceMetadataOptions"}, "tags":{"shape":"TagMap"}, "clientToken":{ "shape":"ClientToken", @@ -1653,12 +1667,13 @@ "kmsKeyId":{"shape":"NonEmptyString"}, "snapshotId":{"shape":"NonEmptyString"}, "volumeSize":{"shape":"EbsVolumeSizeInteger"}, - "volumeType":{"shape":"EbsVolumeType"} + "volumeType":{"shape":"EbsVolumeType"}, + "throughput":{"shape":"EbsVolumeThroughput"} } }, "EbsIopsInteger":{ "type":"integer", - "max":10000, + "max":64000, "min":100 }, "EbsVolumeSizeInteger":{ @@ -1666,6 +1681,11 @@ "max":16000, "min":1 }, + "EbsVolumeThroughput":{ + "type":"integer", + "max":1000, + "min":125 + }, "EbsVolumeType":{ "type":"string", "enum":[ @@ -1917,6 +1937,15 @@ "infrastructureConfiguration":{"shape":"InfrastructureConfiguration"} } }, + "HttpPutResponseHopLimit":{ + "type":"integer", + "max":64, + "min":1 + }, + "HttpTokens":{ + "type":"string", + "pattern":"optional|required" + }, "IdempotentParameterMismatchException":{ "type":"structure", "members":{ @@ -2176,6 +2205,7 @@ "dateCreated":{"shape":"DateTime"}, "dateUpdated":{"shape":"DateTime"}, "resourceTags":{"shape":"ResourceTagMap"}, + "instanceMetadataOptions":{"shape":"InstanceMetadataOptions"}, "tags":{"shape":"TagMap"} } }, @@ -2233,6 +2263,13 @@ "blockDeviceMappings":{"shape":"InstanceBlockDeviceMappings"} } }, + "InstanceMetadataOptions":{ + "type":"structure", + "members":{ + "httpTokens":{"shape":"HttpTokens"}, + "httpPutResponseHopLimit":{"shape":"HttpPutResponseHopLimit"} + } + }, "InstanceProfileNameType":{ "type":"string", "max":256, @@ -3001,7 +3038,8 @@ "shape":"ClientToken", "idempotencyToken":true }, - "resourceTags":{"shape":"ResourceTagMap"} + "resourceTags":{"shape":"ResourceTagMap"}, + "instanceMetadataOptions":{"shape":"InstanceMetadataOptions"} } }, "UpdateInfrastructureConfigurationResponse":{ diff --git a/models/apis/imagebuilder/2019-12-02/docs-2.json b/models/apis/imagebuilder/2019-12-02/docs-2.json index 69cd2e5a670..f58306b7f98 100644 --- a/models/apis/imagebuilder/2019-12-02/docs-2.json +++ b/models/apis/imagebuilder/2019-12-02/docs-2.json @@ -13,7 +13,7 @@ "DeleteComponent": "

Deletes a component build version.

", "DeleteContainerRecipe": "

Deletes a container recipe.

", "DeleteDistributionConfiguration": "

Deletes a distribution configuration.

", - "DeleteImage": "

Deletes an image.

", + "DeleteImage": "

Deletes an Image Builder image resource. This does not delete any EC2 AMIs or ECR container images that are created during the image build process. You must clean those up separately, using the appropriate Amazon EC2 or Amazon ECR console actions, or API or CLI commands.

", "DeleteImagePipeline": "

Deletes an image pipeline.

", "DeleteImageRecipe": "

Deletes an image recipe.

", "DeleteInfrastructureConfiguration": "

Deletes an infrastructure configuration.

", @@ -29,12 +29,12 @@ "GetImageRecipePolicy": "

Gets an image recipe policy.

", "GetInfrastructureConfiguration": "

Gets an infrastructure configuration.

", "ImportComponent": "

Imports a component and transforms its data into a component document.

", - "ListComponentBuildVersions": "

Returns the list of component build versions for the specified semantic version.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Filtering: When you retrieve or reference a resource with a semantic version, you can use wildcards (x) to filter your results. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards. For example, specifying \"1.2.x\", or \"1.x.x\" works to filter list results, but neither \"1.x.2\", nor \"x.2.x\" will work. You do not have to specify the build - Image Builder automatically uses a wildcard for that, if applicable.

", - "ListComponents": "

Returns the list of component build versions for the specified semantic version.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Filtering: When you retrieve or reference a resource with a semantic version, you can use wildcards (x) to filter your results. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards. For example, specifying \"1.2.x\", or \"1.x.x\" works to filter list results, but neither \"1.x.2\", nor \"x.2.x\" will work. You do not have to specify the build - Image Builder automatically uses a wildcard for that, if applicable.

", + "ListComponentBuildVersions": "

Returns the list of component build versions for the specified semantic version.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the source image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

", + "ListComponents": "

Returns the list of component build versions for the specified semantic version.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the source image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

", "ListContainerRecipes": "

Returns a list of container recipes.

", "ListDistributionConfigurations": "

Returns a list of distribution configurations.

", "ListImageBuildVersions": "

Returns a list of image build versions.

", - "ListImagePackages": "

List the Packages that are associated with an Image Build Version, as determined by Amazon EC2 Systems Manager Inventory at build time.

", + "ListImagePackages": "

List the Packages that are associated with an Image Build Version, as determined by Amazon Web Services Systems Manager Inventory at build time.

", "ListImagePipelineImages": "

Returns a list of images created by the specified pipeline.

", "ListImagePipelines": "

Returns a list of image pipelines.

", "ListImageRecipes": "

Returns a list of image recipes.

", @@ -68,7 +68,7 @@ } }, "AdditionalInstanceConfiguration": { - "base": "

In addition to your infrastruction configuration, these settings provide an extra layer of control over your build instances. For instances where Image Builder installs the SSM agent, you can choose whether to keep it for the AMI that you create. You can also specify commands to run on launch for all of your build instances.

", + "base": "

In addition to your infrastruction configuration, these settings provide an extra layer of control over your build instances. For instances where Image Builder installs the Systems Manager agent, you can choose whether to keep it for the AMI that you create. You can also specify commands to run on launch for all of your build instances.

", "refs": { "CreateImageRecipeRequest$additionalInstanceConfiguration": "

Specify additional settings and launch scripts for your build instances.

", "ImageRecipe$additionalInstanceConfiguration": "

Before you create a new AMI, Image Builder launches temporary Amazon EC2 instances to build and test your image configuration. Instance configuration adds a layer of control over those instances. You can define settings and add scripts to run when an instance is launched from your AMI.

" @@ -268,6 +268,19 @@ "ComponentParameterDetail$defaultValue": "

The default value of this parameter if no input is provided.

" } }, + "ComponentState": { + "base": "

A group of fields that describe the current status of components that are no longer active.

", + "refs": { + "Component$state": "

Describes the current status of the component. This is used for components that are no longer active.

", + "ComponentSummary$state": "

Describes the current status of the component.

" + } + }, + "ComponentStatus": { + "base": null, + "refs": { + "ComponentState$status": "

The current state of the component.

" + } + }, "ComponentSummary": { "base": "

A high-level summary of a component.

", "refs": { @@ -624,6 +637,12 @@ "EbsInstanceBlockDeviceSpecification$volumeSize": "

Use to override the device's volume size.

" } }, + "EbsVolumeThroughput": { + "base": null, + "refs": { + "EbsInstanceBlockDeviceSpecification$throughput": "

For GP3 volumes only – The throughput in MiB/s that the volume supports.

" + } + }, "EbsVolumeType": { "base": null, "refs": { @@ -811,6 +830,18 @@ "refs": { } }, + "HttpPutResponseHopLimit": { + "base": null, + "refs": { + "InstanceMetadataOptions$httpPutResponseHopLimit": "

Limit the number of hops that an instance metadata request can traverse to reach its destination.

" + } + }, + "HttpTokens": { + "base": null, + "refs": { + "InstanceMetadataOptions$httpTokens": "

Indicates whether a signed token header is required for instance metadata retrieval requests. The values affect the response as follows:

The default setting is optional.

" + } + }, "IdempotentParameterMismatchException": { "base": "

You have specified a client token for an operation using parameter values that differ from a previous request that used the same client token.

", "refs": { @@ -828,8 +859,8 @@ "CancelImageCreationRequest$imageBuildVersionArn": "

The Amazon Resource Name (ARN) of the image whose creation you want to cancel.

", "CancelImageCreationResponse$imageBuildVersionArn": "

The Amazon Resource Name (ARN) of the image whose creation has been cancelled.

", "CreateImageResponse$imageBuildVersionArn": "

The Amazon Resource Name (ARN) of the image that was created by this request.

", - "DeleteImageRequest$imageBuildVersionArn": "

The Amazon Resource Name (ARN) of the image to delete.

", - "DeleteImageResponse$imageBuildVersionArn": "

The Amazon Resource Name (ARN) of the image that was deleted.

", + "DeleteImageRequest$imageBuildVersionArn": "

The Amazon Resource Name (ARN) of the Image Builder image resource to delete.

", + "DeleteImageResponse$imageBuildVersionArn": "

The Amazon Resource Name (ARN) of the Image Builder image resource that was deleted.

", "GetImagePolicyRequest$imageArn": "

The Amazon Resource Name (ARN) of the image whose policy you want to retrieve.

", "ListImagePackagesRequest$imageBuildVersionArn": "

Filter results for the ListImagePackages request by the Image Build Version ARN

", "PutImagePolicyRequest$imageArn": "

The Amazon Resource Name (ARN) of the image that this policy should be applied to.

", @@ -1005,7 +1036,7 @@ "ImageVersionList": { "base": null, "refs": { - "ListImagesResponse$imageVersionList": "

The list of image semantic versions.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Filtering: When you retrieve or reference a resource with a semantic version, you can use wildcards (x) to filter your results. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards. For example, specifying \"1.2.x\", or \"1.x.x\" works to filter list results, but neither \"1.x.2\", nor \"x.2.x\" will work. You do not have to specify the build - Image Builder automatically uses a wildcard for that, if applicable.

" + "ListImagesResponse$imageVersionList": "

The list of image semantic versions.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the source image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

" } }, "ImportComponentRequest": { @@ -1084,6 +1115,14 @@ "CreateContainerRecipeRequest$instanceConfiguration": "

A group of options that can be used to configure an instance for building and testing container images.

" } }, + "InstanceMetadataOptions": { + "base": "

The instance metadata options that apply to the HTTP requests that pipeline builds use to launch EC2 build and test instances. For more information about instance metadata options, see Configure the instance metadata options in the Amazon EC2 User Guide for Linux instances, or Configure the instance metadata options in the Amazon EC2 Windows Guide for Windows instances.

", + "refs": { + "CreateInfrastructureConfigurationRequest$instanceMetadataOptions": "

The instance metadata options that you can set for the HTTP requests that pipeline builds use to launch EC2 build and test instances.

", + "InfrastructureConfiguration$instanceMetadataOptions": "

The instance metadata option settings for the infrastructure configuration.

", + "UpdateInfrastructureConfigurationRequest$instanceMetadataOptions": "

The instance metadata options that you can set for the HTTP requests that pipeline builds use to launch EC2 build and test instances. For more information about instance metadata options, see one of the following links:

" + } + }, "InstanceProfileNameType": { "base": null, "refs": { @@ -1102,7 +1141,7 @@ "InstanceTypeList": { "base": null, "refs": { - "CreateInfrastructureConfigurationRequest$instanceTypes": "

The instance types of the infrastructure configuration. You can specify one or more instance types to use for this build. The service will pick one of these instance types based on availability.

", + "CreateInfrastructureConfigurationRequest$instanceTypes": "

The instance metadata options that you can set for the HTTP requests that pipeline builds use to launch EC2 build and test instances. For more information about instance metadata options, see one of the following links:

", "InfrastructureConfiguration$instanceTypes": "

The instance types of the infrastructure configuration.

", "InfrastructureConfigurationSummary$instanceTypes": "

The instance types of the infrastructure configuration.

", "UpdateInfrastructureConfigurationRequest$instanceTypes": "

The instance types of the infrastructure configuration. You can specify one or more instance types to use for this build. The service will pick one of these instance types based on availability.

" @@ -1317,6 +1356,7 @@ "Component$changeDescription": "

The change description of the component.

", "Component$owner": "

The owner of the component.

", "Component$kmsKeyId": "

The KMS key identifier used to encrypt the component.

", + "ComponentState$reason": "

Describes how or why the component changed state.

", "ComponentSummary$owner": "

The owner of the component.

", "ComponentSummary$description": "

The description of the component.

", "ComponentSummary$changeDescription": "

The change description of the component.

", @@ -1352,7 +1392,7 @@ "CreateImageResponse$requestId": "

The request ID that uniquely identifies this request.

", "CreateInfrastructureConfigurationRequest$description": "

The description of the infrastructure configuration.

", "CreateInfrastructureConfigurationRequest$subnetId": "

The subnet ID in which to place the instance used to customize your Amazon EC2 AMI.

", - "CreateInfrastructureConfigurationRequest$keyPair": "

The key pair of the infrastructure configuration. This can be used to log on to and debug the instance used to create your image.

", + "CreateInfrastructureConfigurationRequest$keyPair": "

The key pair of the infrastructure configuration. You can use this to log on to and debug the instance used to create your image.

", "CreateInfrastructureConfigurationResponse$requestId": "

The request ID that uniquely identifies this request.

", "DeleteComponentResponse$requestId": "

The request ID that uniquely identifies this request.

", "DeleteContainerRecipeResponse$requestId": "

The request ID that uniquely identifies this request.

", @@ -1433,7 +1473,7 @@ "UpdateImagePipelineResponse$requestId": "

The request ID that uniquely identifies this request.

", "UpdateInfrastructureConfigurationRequest$description": "

The description of the infrastructure configuration.

", "UpdateInfrastructureConfigurationRequest$subnetId": "

The subnet ID to place the instance used to customize your Amazon EC2 AMI in.

", - "UpdateInfrastructureConfigurationRequest$keyPair": "

The key pair of the infrastructure configuration. This can be used to log on to and debug the instance used to create your image.

", + "UpdateInfrastructureConfigurationRequest$keyPair": "

The key pair of the infrastructure configuration. You can use this to log on to and debug the instance used to create your image.

", "UpdateInfrastructureConfigurationResponse$requestId": "

The request ID that uniquely identifies this request.

" } }, @@ -1452,7 +1492,7 @@ "ImageTestsConfiguration$imageTestsEnabled": "

Defines if tests should be executed when building this image.

", "InfrastructureConfiguration$terminateInstanceOnFailure": "

The terminate instance on failure configuration of the infrastructure configuration.

", "ListImagesRequest$includeDeprecated": "

Includes deprecated images in the response list.

", - "SystemsManagerAgent$uninstallAfterBuild": "

Controls whether the SSM agent is removed from your final build image, prior to creating the new AMI. If this is set to true, then the agent is removed from the final image. If it's set to false, then the agent is left in, so that it is included in the new AMI. The default value is false.

", + "SystemsManagerAgent$uninstallAfterBuild": "

Controls whether the Systems Manager agent is removed from your final build image, prior to creating the new AMI. If this is set to true, then the agent is removed from the final image. If it's set to false, then the agent is left in, so that it is included in the new AMI. The default value is false.

", "UpdateImagePipelineRequest$enhancedImageMetadataEnabled": "

Collects additional information about the image being created, including the operating system (OS) version and package list. This information is used to enhance the overall experience of using EC2 Image Builder. Enabled by default.

", "UpdateInfrastructureConfigurationRequest$terminateInstanceOnFailure": "

The terminate instance on failure setting of the infrastructure configuration. Set to false if you want Image Builder to retain the instance used to configure your AMI if the build or test phase of your workflow fails.

" } @@ -1744,9 +1784,9 @@ } }, "SystemsManagerAgent": { - "base": "

Contains settings for the SSM agent on your build instance.

", + "base": "

Contains settings for the Systems Manager agent on your build instance.

", "refs": { - "AdditionalInstanceConfiguration$systemsManagerAgent": "

Contains settings for the SSM agent on your build instance.

" + "AdditionalInstanceConfiguration$systemsManagerAgent": "

Contains settings for the Systems Manager agent on your build instance.

" } }, "TagKey": { @@ -1874,7 +1914,7 @@ "UserDataOverride": { "base": null, "refs": { - "AdditionalInstanceConfiguration$userDataOverride": "

Use this property to provide commands or a command script to run when you launch your build instance.

The userDataOverride property replaces any commands that Image Builder might have added to ensure that SSM is installed on your Linux build instance. If you override the user data, make sure that you add commands to install SSM, if it is not pre-installed on your source image.

" + "AdditionalInstanceConfiguration$userDataOverride": "

Use this property to provide commands or a command script to run when you launch your build instance.

The userDataOverride property replaces any commands that Image Builder might have added to ensure that Systems Manager is installed on your Linux build instance. If you override the user data, make sure that you add commands to install Systems Manager, if it is not pre-installed on your source image.

" } }, "VersionNumber": { @@ -1882,16 +1922,16 @@ "refs": { "Component$version": "

The version of the component.

", "ComponentSummary$version": "

The version of the component.

", - "ComponentVersion$version": "

The semantic version of the component.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number, and that is not open for updates.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

Filtering: When you retrieve or reference a resource with a semantic version, you can use wildcards (x) to filter your results. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards. For example, specifying \"1.2.x\", or \"1.x.x\" works to filter list results, but neither \"1.x.2\", nor \"x.2.x\" will work. You do not have to specify the build - Image Builder automatically uses a wildcard for that, if applicable.

", - "ContainerRecipe$version": "

The semantic version of the container recipe.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number, and that is not open for updates.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

Filtering: When you retrieve or reference a resource with a semantic version, you can use wildcards (x) to filter your results. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards. For example, specifying \"1.2.x\", or \"1.x.x\" works to filter list results, but neither \"1.x.2\", nor \"x.2.x\" will work. You do not have to specify the build - Image Builder automatically uses a wildcard for that, if applicable.

", - "CreateComponentRequest$semanticVersion": "

The semantic version of the component. This version follows the semantic version syntax.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number, and that is not open for updates.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

", - "CreateContainerRecipeRequest$semanticVersion": "

The semantic version of the container recipe. This version follows the semantic version syntax.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number, and that is not open for updates.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

", - "CreateImageRecipeRequest$semanticVersion": "

The semantic version of the image recipe. This version follows the semantic version syntax.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number, and that is not open for updates.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

", - "Image$version": "

The semantic version of the image.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number, and that is not open for updates.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

Filtering: When you retrieve or reference a resource with a semantic version, you can use wildcards (x) to filter your results. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards. For example, specifying \"1.2.x\", or \"1.x.x\" works to filter list results, but neither \"1.x.2\", nor \"x.2.x\" will work. You do not have to specify the build - Image Builder automatically uses a wildcard for that, if applicable.

", + "ComponentVersion$version": "

The semantic version of the component.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the source image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

", + "ContainerRecipe$version": "

The semantic version of the container recipe.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the source image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

", + "CreateComponentRequest$semanticVersion": "

The semantic version of the component. This version follows the semantic version syntax.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

", + "CreateContainerRecipeRequest$semanticVersion": "

The semantic version of the container recipe. This version follows the semantic version syntax.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

", + "CreateImageRecipeRequest$semanticVersion": "

The semantic version of the image recipe. This version follows the semantic version syntax.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

", + "Image$version": "

The semantic version of the image.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the source image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

", "ImageRecipe$version": "

The version of the image recipe.

", "ImageSummary$version": "

The version of the image.

", - "ImageVersion$version": "

Details for a specific version of an Image Builder image. This version follows the semantic version syntax.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number, and that is not open for updates.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

Filtering: When you retrieve or reference a resource with a semantic version, you can use wildcards (x) to filter your results. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards. For example, specifying \"1.2.x\", or \"1.x.x\" works to filter list results, but neither \"1.x.2\", nor \"x.2.x\" will work. You do not have to specify the build - Image Builder automatically uses a wildcard for that, if applicable.

", - "ImportComponentRequest$semanticVersion": "

The semantic version of the component. This version follows the semantic version syntax.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Filtering: When you retrieve or reference a resource with a semantic version, you can use wildcards (x) to filter your results. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards. For example, specifying \"1.2.x\", or \"1.x.x\" works to filter list results, but neither \"1.x.2\", nor \"x.2.x\" will work. You do not have to specify the build - Image Builder automatically uses a wildcard for that, if applicable.

" + "ImageVersion$version": "

Details for a specific version of an Image Builder image. This version follows the semantic version syntax.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Assignment: For the first three nodes you can assign any positive integer value, including zero, with an upper limit of 2^30-1, or 1073741823 for each node. Image Builder automatically assigns the build number to the fourth node.

Patterns: You can use any numeric pattern that adheres to the assignment requirements for the nodes that you can assign. For example, you might choose a software version pattern, such as 1.0.0, or a date, such as 2021.01.01.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the source image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

", + "ImportComponentRequest$semanticVersion": "

The semantic version of the component. This version follows the semantic version syntax.

The semantic version has four nodes: <major>.<minor>.<patch>/<build>. You can assign values for the first three, and can filter on all of them.

Filtering: With semantic versioning, you have the flexibility to use wildcards (x) to specify the most recent versions or nodes when selecting the source image or components for your recipe. When you use a wildcard in any node, all nodes to the right of the first wildcard must also be wildcards.

" } } } diff --git a/models/apis/license-manager/2018-08-01/api-2.json b/models/apis/license-manager/2018-08-01/api-2.json index fee63a02a7d..280752b3694 100644 --- a/models/apis/license-manager/2018-08-01/api-2.json +++ b/models/apis/license-manager/2018-08-01/api-2.json @@ -163,6 +163,23 @@ {"shape":"RateLimitExceededException"} ] }, + "CreateLicenseConversionTaskForResource":{ + "name":"CreateLicenseConversionTaskForResource", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"CreateLicenseConversionTaskForResourceRequest"}, + "output":{"shape":"CreateLicenseConversionTaskForResourceResponse"}, + "errors":[ + {"shape":"InvalidParameterValueException"}, + {"shape":"ValidationException"}, + {"shape":"ServerInternalException"}, + {"shape":"AuthorizationException"}, + {"shape":"AccessDeniedException"}, + {"shape":"RateLimitExceededException"} + ] + }, "CreateLicenseManagerReportGenerator":{ "name":"CreateLicenseManagerReportGenerator", "http":{ @@ -395,6 +412,22 @@ {"shape":"RateLimitExceededException"} ] }, + "GetLicenseConversionTask":{ + "name":"GetLicenseConversionTask", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"GetLicenseConversionTaskRequest"}, + "output":{"shape":"GetLicenseConversionTaskResponse"}, + "errors":[ + {"shape":"InvalidParameterValueException"}, + {"shape":"ServerInternalException"}, + {"shape":"AuthorizationException"}, + {"shape":"AccessDeniedException"}, + {"shape":"RateLimitExceededException"} + ] + }, "GetLicenseManagerReportGenerator":{ "name":"GetLicenseManagerReportGenerator", "http":{ @@ -514,6 +547,22 @@ {"shape":"RateLimitExceededException"} ] }, + "ListLicenseConversionTasks":{ + "name":"ListLicenseConversionTasks", + "http":{ + "method":"POST", + "requestUri":"/" + }, + "input":{"shape":"ListLicenseConversionTasksRequest"}, + "output":{"shape":"ListLicenseConversionTasksResponse"}, + "errors":[ + {"shape":"InvalidParameterValueException"}, + {"shape":"ServerInternalException"}, + {"shape":"AuthorizationException"}, + {"shape":"AccessDeniedException"}, + {"shape":"RateLimitExceededException"} + ] + }, "ListLicenseManagerReportGenerators":{ "name":"ListLicenseManagerReportGenerators", "http":{ @@ -1076,6 +1125,25 @@ "LicenseConfigurationArn":{"shape":"String"} } }, + "CreateLicenseConversionTaskForResourceRequest":{ + "type":"structure", + "required":[ + "ResourceArn", + "SourceLicenseContext", + "DestinationLicenseContext" + ], + "members":{ + "ResourceArn":{"shape":"Arn"}, + "SourceLicenseContext":{"shape":"LicenseConversionContext"}, + "DestinationLicenseContext":{"shape":"LicenseConversionContext"} + } + }, + "CreateLicenseConversionTaskForResourceResponse":{ + "type":"structure", + "members":{ + "LicenseConversionTaskId":{"shape":"LicenseConversionTaskId"} + } + }, "CreateLicenseManagerReportGeneratorRequest":{ "type":"structure", "required":[ @@ -1515,6 +1583,27 @@ "DisassociateWhenNotFound":{"shape":"BoxBoolean"} } }, + "GetLicenseConversionTaskRequest":{ + "type":"structure", + "required":["LicenseConversionTaskId"], + "members":{ + "LicenseConversionTaskId":{"shape":"LicenseConversionTaskId"} + } + }, + "GetLicenseConversionTaskResponse":{ + "type":"structure", + "members":{ + "LicenseConversionTaskId":{"shape":"LicenseConversionTaskId"}, + "ResourceArn":{"shape":"String"}, + "SourceLicenseContext":{"shape":"LicenseConversionContext"}, + "DestinationLicenseContext":{"shape":"LicenseConversionContext"}, + "StatusMessage":{"shape":"String"}, + "Status":{"shape":"LicenseConversionTaskStatus"}, + "StartTime":{"shape":"DateTime"}, + "LicenseConversionTime":{"shape":"DateTime"}, + "EndTime":{"shape":"DateTime"} + } + }, "GetLicenseManagerReportGeneratorRequest":{ "type":"structure", "required":["LicenseManagerReportGeneratorArn"], @@ -1780,6 +1869,43 @@ "type":"list", "member":{"shape":"LicenseConfiguration"} }, + "LicenseConversionContext":{ + "type":"structure", + "members":{ + "UsageOperation":{"shape":"UsageOperation"} + } + }, + "LicenseConversionTask":{ + "type":"structure", + "members":{ + "LicenseConversionTaskId":{"shape":"LicenseConversionTaskId"}, + "ResourceArn":{"shape":"String"}, + "SourceLicenseContext":{"shape":"LicenseConversionContext"}, + "DestinationLicenseContext":{"shape":"LicenseConversionContext"}, + "Status":{"shape":"LicenseConversionTaskStatus"}, + "StatusMessage":{"shape":"String"}, + "StartTime":{"shape":"DateTime"}, + "LicenseConversionTime":{"shape":"DateTime"}, + "EndTime":{"shape":"DateTime"} + } + }, + "LicenseConversionTaskId":{ + "type":"string", + "max":50, + "pattern":"^lct-[a-zA-Z0-9]*" + }, + "LicenseConversionTaskStatus":{ + "type":"string", + "enum":[ + "IN_PROGRESS", + "SUCCEEDED", + "FAILED" + ] + }, + "LicenseConversionTasks":{ + "type":"list", + "member":{"shape":"LicenseConversionTask"} + }, "LicenseCountingType":{ "type":"string", "enum":[ @@ -1918,6 +2044,21 @@ "NextToken":{"shape":"String"} } }, + "ListLicenseConversionTasksRequest":{ + "type":"structure", + "members":{ + "NextToken":{"shape":"String"}, + "MaxResults":{"shape":"BoxInteger"}, + "Filters":{"shape":"Filters"} + } + }, + "ListLicenseConversionTasksResponse":{ + "type":"structure", + "members":{ + "LicenseConversionTasks":{"shape":"LicenseConversionTasks"}, + "NextToken":{"shape":"String"} + } + }, "ListLicenseManagerReportGeneratorsRequest":{ "type":"structure", "members":{ @@ -2506,6 +2647,10 @@ "members":{ } }, + "UsageOperation":{ + "type":"string", + "max":50 + }, "ValidationException":{ "type":"structure", "members":{ diff --git a/models/apis/license-manager/2018-08-01/docs-2.json b/models/apis/license-manager/2018-08-01/docs-2.json index dd77022e654..36e1cb0995c 100644 --- a/models/apis/license-manager/2018-08-01/docs-2.json +++ b/models/apis/license-manager/2018-08-01/docs-2.json @@ -1,35 +1,38 @@ { "version": "2.0", - "service": " AWS License Manager

AWS License Manager makes it easier to manage licenses from software vendors across multiple AWS accounts and on-premises servers.

", + "service": "

License Manager makes it easier to manage licenses from software vendors across multiple Amazon Web Services accounts and on-premises servers.

", "operations": { "AcceptGrant": "

Accepts the specified grant.

", "CheckInLicense": "

Checks in the specified license. Check in a license when it is no longer in use.

", "CheckoutBorrowLicense": "

Checks out the specified license for offline use.

", "CheckoutLicense": "

Checks out the specified license.

", - "CreateGrant": "

Creates a grant for the specified license. A grant shares the use of license entitlements with specific AWS accounts.

", + "CreateGrant": "

Creates a grant for the specified license. A grant shares the use of license entitlements with specific Amazon Web Services accounts.

", "CreateGrantVersion": "

Creates a new version of the specified grant.

", "CreateLicense": "

Creates a license.

", "CreateLicenseConfiguration": "

Creates a license configuration.

A license configuration is an abstraction of a customer license agreement that can be consumed and enforced by License Manager. Components include specifications for the license type (licensing by instance, socket, CPU, or vCPU), allowed tenancy (shared tenancy, Dedicated Instance, Dedicated Host, or all of these), license affinity to host (how long a license must be associated with a host), and the number of licenses purchased and used.

", - "CreateLicenseManagerReportGenerator": "

Creates a new report generator.

", + "CreateLicenseConversionTaskForResource": "

Creates a new license conversion task.

", + "CreateLicenseManagerReportGenerator": "

Creates a report generator.

", "CreateLicenseVersion": "

Creates a new version of the specified license.

", "CreateToken": "

Creates a long-lived token.

A refresh token is a JWT token used to get an access token. With an access token, you can call AssumeRoleWithWebIdentity to get role credentials that you can use to call License Manager to manage the specified license.

", "DeleteGrant": "

Deletes the specified grant.

", "DeleteLicense": "

Deletes the specified license.

", "DeleteLicenseConfiguration": "

Deletes the specified license configuration.

You cannot delete a license configuration that is in use.

", - "DeleteLicenseManagerReportGenerator": "

Delete an existing report generator.

This action deletes the report generator, which stops it from generating future reports and cannot be reversed. However, the previous reports from this generator will remain in your S3 bucket.

", + "DeleteLicenseManagerReportGenerator": "

Deletes the specified report generator.

This action deletes the report generator, which stops it from generating future reports. The action cannot be reversed. It has no effect on the previous reports from this generator.

", "DeleteToken": "

Deletes the specified token. Must be called in the license home Region.

", "ExtendLicenseConsumption": "

Extends the expiration date for license consumption.

", "GetAccessToken": "

Gets a temporary access token to use with AssumeRoleWithWebIdentity. Access tokens are valid for one hour.

", "GetGrant": "

Gets detailed information about the specified grant.

", "GetLicense": "

Gets detailed information about the specified license.

", "GetLicenseConfiguration": "

Gets detailed information about the specified license configuration.

", - "GetLicenseManagerReportGenerator": "

Gets information on the specified report generator.

", + "GetLicenseConversionTask": "

Gets information about the specified license type conversion task.

", + "GetLicenseManagerReportGenerator": "

Gets information about the specified report generator.

", "GetLicenseUsage": "

Gets detailed information about the usage of the specified license.

", "GetServiceSettings": "

Gets the License Manager settings for the current Region.

", "ListAssociationsForLicenseConfiguration": "

Lists the resource associations for the specified license configuration.

Resource associations need not consume licenses from a license configuration. For example, an AMI or a stopped instance might not consume a license (depending on the license rules).

", "ListDistributedGrants": "

Lists the grants distributed for the specified license.

", "ListFailuresForLicenseConfigurationOperations": "

Lists the license configuration operations that failed.

", "ListLicenseConfigurations": "

Lists the license configurations for your account.

", + "ListLicenseConversionTasks": "

Lists the license type conversion tasks for your account.

", "ListLicenseManagerReportGenerators": "

Lists the report generators for your account.

", "ListLicenseSpecificationsForResource": "

Describes the license configurations for the specified resource.

", "ListLicenseVersions": "

Lists all versions of the specified license.

", @@ -44,8 +47,8 @@ "TagResource": "

Adds the specified tags to the specified license configuration.

", "UntagResource": "

Removes the specified tags from the specified license configuration.

", "UpdateLicenseConfiguration": "

Modifies the attributes of an existing license configuration.

", - "UpdateLicenseManagerReportGenerator": "

Updates a report generator.

After you make changes to a report generator, it will start generating new reports within 60 minutes of being updated.

", - "UpdateLicenseSpecificationsForResource": "

Adds or removes the specified license configurations for the specified AWS resource.

You can update the license specifications of AMIs, instances, and hosts. You cannot update the license specifications for launch templates and AWS CloudFormation templates, as they send license configurations to the operation that creates the resource.

", + "UpdateLicenseManagerReportGenerator": "

Updates a report generator.

After you make changes to a report generator, it starts generating new reports within 60 minutes of being updated.

", + "UpdateLicenseSpecificationsForResource": "

Adds or removes the specified license configurations for the specified Amazon Web Services resource.

You can update the license specifications of AMIs, instances, and hosts. You cannot update the license specifications for launch templates and CloudFormation templates, as they send license configurations to the operation that creates the resource.

", "UpdateServiceSettings": "

Updates License Manager settings for the current Region.

" }, "shapes": { @@ -91,6 +94,7 @@ "CreateGrantResponse$GrantArn": "

Grant ARN.

", "CreateGrantVersionRequest$GrantArn": "

Amazon Resource Name (ARN) of the grant.

", "CreateGrantVersionResponse$GrantArn": "

Grant ARN.

", + "CreateLicenseConversionTaskForResourceRequest$ResourceArn": "

Amazon Resource Name (ARN) of the resource you are converting the license type for.

", "CreateLicenseResponse$LicenseArn": "

Amazon Resource Name (ARN) of the license.

", "CreateLicenseVersionRequest$LicenseArn": "

Amazon Resource Name (ARN) of the license.

", "CreateLicenseVersionResponse$LicenseArn": "

License ARN.

", @@ -121,12 +125,12 @@ "ListLicensesRequest$LicenseArns": "

Amazon Resource Names (ARNs) of the licenses.

", "ListReceivedGrantsRequest$GrantArns": "

Amazon Resource Names (ARNs) of the grants.

", "ListReceivedLicensesRequest$LicenseArns": "

Amazon Resource Names (ARNs) of the licenses.

", - "ReportContext$licenseConfigurationArns": "

Amazon Resource Number (ARN) of the license configuration that this generator reports on.

", + "ReportContext$licenseConfigurationArns": "

Amazon Resource Name (ARN) of the license configuration that this generator reports on.

", "TokenData$RoleArns": "

Amazon Resource Names (ARN) of the roles included in the token.

" } }, "AuthorizationException": { - "base": "

The AWS user account does not have permission to perform the action. Check the IAM policy associated with this account.

", + "base": "

The Amazon Web Services user account does not have permission to perform the action. Check the IAM policy associated with this account.

", "refs": { } }, @@ -141,7 +145,7 @@ "base": null, "refs": { "ExtendLicenseConsumptionRequest$DryRun": "

Checks whether you have the required permissions for the action, without actually making the request. Provides an error response if you do not have the required permissions.

", - "OrganizationConfiguration$EnableIntegration": "

Enables AWS Organization integration.

" + "OrganizationConfiguration$EnableIntegration": "

Enables Organizations integration.

" } }, "BorrowConfiguration": { @@ -175,6 +179,7 @@ "ListAssociationsForLicenseConfigurationRequest$MaxResults": "

Maximum number of results to return in a single call.

", "ListFailuresForLicenseConfigurationOperationsRequest$MaxResults": "

Maximum number of results to return in a single call.

", "ListLicenseConfigurationsRequest$MaxResults": "

Maximum number of results to return in a single call.

", + "ListLicenseConversionTasksRequest$MaxResults": "

Maximum number of results to return in a single call.

", "ListLicenseSpecificationsForResourceRequest$MaxResults": "

Maximum number of results to return in a single call.

", "ListResourceInventoryRequest$MaxResults": "

Maximum number of results to return in a single call.

", "ListUsageForLicenseConfigurationRequest$MaxResults": "

Maximum number of results to return in a single call.

", @@ -308,6 +313,16 @@ "refs": { } }, + "CreateLicenseConversionTaskForResourceRequest": { + "base": null, + "refs": { + } + }, + "CreateLicenseConversionTaskForResourceResponse": { + "base": null, + "refs": { + } + }, "CreateLicenseManagerReportGeneratorRequest": { "base": null, "refs": { @@ -352,8 +367,14 @@ "base": null, "refs": { "AutomatedDiscoveryInformation$LastRunTime": "

Time that automated discovery last ran.

", + "GetLicenseConversionTaskResponse$StartTime": "

Time at which the license type conversion task was started .

", + "GetLicenseConversionTaskResponse$LicenseConversionTime": "

Amount of time to complete the license type conversion.

", + "GetLicenseConversionTaskResponse$EndTime": "

Time at which the license type conversion task was completed.

", "LicenseConfigurationAssociation$AssociationTime": "

Time when the license configuration was associated with the resource.

", "LicenseConfigurationUsage$AssociationTime": "

Time when the license configuration was initially associated with the resource.

", + "LicenseConversionTask$StartTime": "

The time the conversion task was started at.

", + "LicenseConversionTask$LicenseConversionTime": "

The time the usage operation value of the resource was changed.

", + "LicenseConversionTask$EndTime": "

The time the conversion task was completed.

", "LicenseOperationFailure$FailureTime": "

Failure time.

" } }, @@ -541,7 +562,8 @@ "Filters": { "base": null, "refs": { - "ListLicenseConfigurationsRequest$Filters": "

Filters to scope the results. The following filters and logical operators are supported:

", + "ListLicenseConfigurationsRequest$Filters": "

Filters to scope the results. The following filters and logical operators are supported:

", + "ListLicenseConversionTasksRequest$Filters": "

Filters to scope the results. Valid filters are ResourceArns and Status.

", "ListUsageForLicenseConfigurationRequest$Filters": "

Filters to scope the results. The following filters and logical operators are supported:

" } }, @@ -575,6 +597,16 @@ "refs": { } }, + "GetLicenseConversionTaskRequest": { + "base": null, + "refs": { + } + }, + "GetLicenseConversionTaskResponse": { + "base": null, + "refs": { + } + }, "GetLicenseManagerReportGeneratorRequest": { "base": null, "refs": { @@ -662,7 +694,7 @@ "CheckoutLicenseResponse$Expiration": "

Date and time at which the license checkout expires.

", "DatetimeRange$Begin": "

Start of the time range.

", "DatetimeRange$End": "

End of the time range.

", - "DeleteLicenseResponse$DeletionDate": "

Date on which the license is deleted.

", + "DeleteLicenseResponse$DeletionDate": "

Date when the license is deleted.

", "ExtendLicenseConsumptionResponse$Expiration": "

Date and time at which the license consumption expires.

", "GrantedLicense$CreateTime": "

Creation time of the granted license.

", "License$CreateTime": "

License creation time.

", @@ -673,7 +705,7 @@ "base": null, "refs": { "CreateTokenRequest$ExpirationInDays": "

Token expiration, in days, counted from token creation. The default is 365 days.

", - "ReportFrequency$value": "

Number of times within the frequency period that a report will be generated. Currently only 1 is supported.

" + "ReportFrequency$value": "

Number of times within the frequency period that a report is generated. The only supported value is 1.

" } }, "InvalidParameterValueException": { @@ -701,7 +733,7 @@ "InventoryFilterList": { "base": null, "refs": { - "ListResourceInventoryRequest$Filters": "

Filters to scope the results. The following filters and logical operators are supported:

" + "ListResourceInventoryRequest$Filters": "

Filters to scope the results. The following filters and logical operators are supported:

" } }, "Issuer": { @@ -719,7 +751,7 @@ } }, "License": { - "base": "

Software license that is managed in AWS License Manager.

", + "base": "

Software license that is managed in License Manager.

", "refs": { "GetLicenseResponse$License": "

License details.

", "LicenseList$member": null @@ -767,11 +799,50 @@ "ListLicenseConfigurationsResponse$LicenseConfigurations": "

Information about the license configurations.

" } }, + "LicenseConversionContext": { + "base": "

Information about a license type conversion task.

", + "refs": { + "CreateLicenseConversionTaskForResourceRequest$SourceLicenseContext": "

Information that identifies the license type you are converting from. For the structure of the source license, see Convert a license type using the AWS CLI in the License Manager User Guide.

", + "CreateLicenseConversionTaskForResourceRequest$DestinationLicenseContext": "

Information that identifies the license type you are converting to. For the structure of the destination license, see Convert a license type using the AWS CLI in the License Manager User Guide.

", + "GetLicenseConversionTaskResponse$SourceLicenseContext": "

Information about the license type converted from.

", + "GetLicenseConversionTaskResponse$DestinationLicenseContext": "

Information about the license type converted to.

", + "LicenseConversionTask$SourceLicenseContext": "

Information about the license type this conversion task converted from.

", + "LicenseConversionTask$DestinationLicenseContext": "

Information about the license type this conversion task converted to.

" + } + }, + "LicenseConversionTask": { + "base": "

Information about a license type conversion task.

", + "refs": { + "LicenseConversionTasks$member": null + } + }, + "LicenseConversionTaskId": { + "base": null, + "refs": { + "CreateLicenseConversionTaskForResourceResponse$LicenseConversionTaskId": "

The ID of the created license type conversion task.

", + "GetLicenseConversionTaskRequest$LicenseConversionTaskId": "

ID of the license type conversion task to retrieve information on.

", + "GetLicenseConversionTaskResponse$LicenseConversionTaskId": "

ID of the license type conversion task.

", + "LicenseConversionTask$LicenseConversionTaskId": "

The ID of the license type conversion task.

" + } + }, + "LicenseConversionTaskStatus": { + "base": null, + "refs": { + "GetLicenseConversionTaskResponse$Status": "

Status of the license type conversion task.

", + "LicenseConversionTask$Status": "

The status of the conversion task.

" + } + }, + "LicenseConversionTasks": { + "base": null, + "refs": { + "ListLicenseConversionTasksResponse$LicenseConversionTasks": "

Information about the license configuration tasks for your account.

" + } + }, "LicenseCountingType": { "base": null, "refs": { "CreateLicenseConfigurationRequest$LicenseCountingType": "

Dimension used to track the license inventory.

", - "GetLicenseConfigurationResponse$LicenseCountingType": "

Dimension on which the licenses are counted.

", + "GetLicenseConfigurationResponse$LicenseCountingType": "

Dimension for which the licenses are counted.

", "LicenseConfiguration$LicenseCountingType": "

Dimension to use to track the license inventory.

" } }, @@ -875,6 +946,16 @@ "refs": { } }, + "ListLicenseConversionTasksRequest": { + "base": null, + "refs": { + } + }, + "ListLicenseConversionTasksResponse": { + "base": null, + "refs": { + } + }, "ListLicenseManagerReportGeneratorsRequest": { "base": null, "refs": { @@ -1066,10 +1147,10 @@ } }, "OrganizationConfiguration": { - "base": "

Configuration information for AWS Organizations.

", + "base": "

Configuration information for Organizations.

", "refs": { - "GetServiceSettingsResponse$OrganizationConfiguration": "

Indicates whether AWS Organizations is integrated with License Manager for cross-account discovery.

", - "UpdateServiceSettingsRequest$OrganizationConfiguration": "

Enables integration with AWS Organizations for cross-account discovery.

" + "GetServiceSettingsResponse$OrganizationConfiguration": "

Indicates whether Organizations is integrated with License Manager for cross-account discovery.

", + "UpdateServiceSettingsRequest$OrganizationConfiguration": "

Enables integration with Organizations for cross-account discovery.

" } }, "PrincipalArnList": { @@ -1093,7 +1174,7 @@ "ProductInformationFilterList": { "base": null, "refs": { - "ProductInformation$ProductInformationFilterList": "

A Product information filter consists of a ProductInformationFilterComparator which is a logical operator, a ProductInformationFilterName which specifies the type of filter being declared, and a ProductInformationFilterValue that specifies the value to filter on.

Accepted values for ProductInformationFilterName are listed here along with descriptions and valid options for ProductInformationFilterComparator.

The following filters and are supported when the resource type is SSM_MANAGED:

The following filters and logical operators are supported when the resource type is RDS:

" + "ProductInformation$ProductInformationFilterList": "

A Product information filter consists of a ProductInformationFilterComparator which is a logical operator, a ProductInformationFilterName which specifies the type of filter being declared, and a ProductInformationFilterValue that specifies the value to filter on.

Accepted values for ProductInformationFilterName are listed here along with descriptions and valid options for ProductInformationFilterComparator.

The following filters and are supported when the resource type is SSM_MANAGED:

The following filters and logical operators are supported when the resource type is RDS:

" } }, "ProductInformationList": { @@ -1153,16 +1234,16 @@ "base": "

Details of the license configuration that this generator reports on.

", "refs": { "CreateLicenseManagerReportGeneratorRequest$ReportContext": "

Defines the type of license configuration the report generator tracks.

", - "ReportGenerator$ReportContext": "

License configuration type this generator reports on.

", - "UpdateLicenseManagerReportGeneratorRequest$ReportContext": "

?

" + "ReportGenerator$ReportContext": "

License configuration type for this generator.

", + "UpdateLicenseManagerReportGeneratorRequest$ReportContext": "

The report context.

" } }, "ReportFrequency": { - "base": "

Details on how frequently reports are generated.

", + "base": "

Details about how frequently reports are generated.

", "refs": { "CreateLicenseManagerReportGeneratorRequest$ReportFrequency": "

Frequency by which reports are generated. Reports can be generated daily, monthly, or weekly.

", - "ReportGenerator$ReportFrequency": "

Details on how frequently reports are generated.

", - "UpdateLicenseManagerReportGeneratorRequest$ReportFrequency": "

Frequency by which reports are generated. The following options are avaiable:

??? What are the APi value options?

" + "ReportGenerator$ReportFrequency": "

Details about how frequently reports are generated.

", + "UpdateLicenseManagerReportGeneratorRequest$ReportFrequency": "

Frequency by which reports are generated.

" } }, "ReportFrequencyType": { @@ -1174,14 +1255,14 @@ "ReportGenerator": { "base": "

Describe the details of a report generator.

", "refs": { - "GetLicenseManagerReportGeneratorResponse$ReportGenerator": "

A report generator that creates periodic reports on your license configurations.

", + "GetLicenseManagerReportGeneratorResponse$ReportGenerator": "

A report generator that creates periodic reports about your license configurations.

", "ReportGeneratorList$member": null } }, "ReportGeneratorList": { "base": null, "refs": { - "ListLicenseManagerReportGeneratorsResponse$ReportGenerators": "

A report generator that creates periodic reports on your license configurations.

" + "ListLicenseManagerReportGeneratorsResponse$ReportGenerators": "

A report generator that creates periodic reports about your license configurations.

" } }, "ReportGeneratorName": { @@ -1200,9 +1281,9 @@ "ReportTypeList": { "base": null, "refs": { - "CreateLicenseManagerReportGeneratorRequest$Type": "

Type of reports to generate. The following report types an be generated:

", + "CreateLicenseManagerReportGeneratorRequest$Type": "

Type of reports to generate. The following report types an be generated:

", "ReportGenerator$ReportType": "

Type of reports that are generated.

", - "UpdateLicenseManagerReportGeneratorRequest$Type": "

Type of reports to generate. The following report types an be generated:

" + "UpdateLicenseManagerReportGeneratorRequest$Type": "

Type of reports to generate. The following report types are supported:

" } }, "ResourceInventory": { @@ -1259,10 +1340,10 @@ "StatusReasonMessage": { "base": null, "refs": { - "CreateGrantVersionRequest$StatusReason": null, - "DeleteGrantRequest$StatusReason": null, + "CreateGrantVersionRequest$StatusReason": "

Grant status reason.

", + "DeleteGrantRequest$StatusReason": "

The Status reason for the delete request.

", "Grant$StatusReason": "

Grant status reason.

", - "ReceivedMetadata$ReceivedStatusReason": null + "ReceivedMetadata$ReceivedStatusReason": "

Received status reason.

" } }, "String": { @@ -1290,7 +1371,7 @@ "CreateLicenseConfigurationRequest$Description": "

Description of the license configuration.

", "CreateLicenseConfigurationResponse$LicenseConfigurationArn": "

Amazon Resource Name (ARN) of the license configuration.

", "CreateLicenseManagerReportGeneratorRequest$Description": "

Description of the report generator.

", - "CreateLicenseManagerReportGeneratorResponse$LicenseManagerReportGeneratorArn": "

The Amazon Resource Number (ARN) of the new report generator.

", + "CreateLicenseManagerReportGeneratorResponse$LicenseManagerReportGeneratorArn": "

The Amazon Resource Name (ARN) of the new report generator.

", "CreateLicenseRequest$LicenseName": "

License name.

", "CreateLicenseRequest$ProductName": "

Product name.

", "CreateLicenseRequest$ProductSKU": "

Product SKU.

", @@ -1306,7 +1387,7 @@ "DeleteGrantRequest$Version": "

Current version of the grant.

", "DeleteGrantResponse$Version": "

Grant version.

", "DeleteLicenseConfigurationRequest$LicenseConfigurationArn": "

ID of the license configuration.

", - "DeleteLicenseManagerReportGeneratorRequest$LicenseManagerReportGeneratorArn": "

Amazon Resource Number (ARN) of the report generator that will be deleted.

", + "DeleteLicenseManagerReportGeneratorRequest$LicenseManagerReportGeneratorArn": "

Amazon Resource Name (ARN) of the report generator to be deleted.

", "DeleteLicenseRequest$SourceVersion": "

Current version of the license.

", "DeleteTokenRequest$TokenId": "

Token ID.

", "Entitlement$Name": "

Entitlement name.

", @@ -1327,11 +1408,13 @@ "GetLicenseConfigurationResponse$Description": "

Description of the license configuration.

", "GetLicenseConfigurationResponse$Status": "

License configuration status.

", "GetLicenseConfigurationResponse$OwnerAccountId": "

Account ID of the owner of the license configuration.

", - "GetLicenseManagerReportGeneratorRequest$LicenseManagerReportGeneratorArn": "

mazon Resource Number (ARN) of the report generator to retrieve information on.

", + "GetLicenseConversionTaskResponse$ResourceArn": "

Amazon Resource Names (ARN) of the resources the license conversion task is associated with.

", + "GetLicenseConversionTaskResponse$StatusMessage": "

The status message for the conversion task.

", + "GetLicenseManagerReportGeneratorRequest$LicenseManagerReportGeneratorArn": "

Amazon Resource Name (ARN) of the report generator.

", "GetLicenseRequest$Version": "

License version.

", "GetServiceSettingsResponse$S3BucketArn": "

Regional S3 bucket path for storing reports, license trail event data, discovery data, and so on.

", "GetServiceSettingsResponse$SnsTopicArn": "

SNS topic configured to receive notifications from License Manager.

", - "GetServiceSettingsResponse$LicenseManagerResourceShareArn": "

Amazon Resource Name (ARN) of the AWS resource share. The License Manager management account provides member accounts with access to this share.

", + "GetServiceSettingsResponse$LicenseManagerResourceShareArn": "

Amazon Resource Name (ARN) of the resource share. The License Manager management account provides member accounts with access to this share.

", "Grant$GrantName": "

Grant name.

", "Grant$HomeRegion": "

Home Region of the grant.

", "Grant$Version": "

Grant version.

", @@ -1344,9 +1427,9 @@ "InventoryFilter$Name": "

Name of the filter.

", "InventoryFilter$Value": "

Value of the filter.

", "Issuer$Name": "

Issuer name.

", - "Issuer$SignKey": "

Asymmetric CMK from AWS Key Management Service. The CMK must have a key usage of sign and verify, and support the RSASSA-PSS SHA-256 signing algorithm.

", + "Issuer$SignKey": "

Asymmetric KMS key from Key Management Service. The KMS key must have a key usage of sign and verify, and support the RSASSA-PSS SHA-256 signing algorithm.

", "IssuerDetails$Name": "

Issuer name.

", - "IssuerDetails$SignKey": "

Asymmetric CMK from AWS Key Management Service. The CMK must have a key usage of sign and verify, and support the RSASSA-PSS SHA-256 signing algorithm.

", + "IssuerDetails$SignKey": "

Asymmetric KMS key from Key Management Service. The KMS key must have a key usage of sign and verify, and support the RSASSA-PSS SHA-256 signing algorithm.

", "IssuerDetails$KeyFingerprint": "

Issuer key fingerprint.

", "License$LicenseName": "

License name.

", "License$ProductName": "

Product name.

", @@ -1361,15 +1444,17 @@ "LicenseConfiguration$Status": "

Status of the license configuration.

", "LicenseConfiguration$OwnerAccountId": "

Account ID of the license configuration's owner.

", "LicenseConfigurationAssociation$ResourceArn": "

Amazon Resource Name (ARN) of the resource.

", - "LicenseConfigurationAssociation$ResourceOwnerId": "

ID of the AWS account that owns the resource consuming licenses.

", + "LicenseConfigurationAssociation$ResourceOwnerId": "

ID of the Amazon Web Services account that owns the resource consuming licenses.

", "LicenseConfigurationAssociation$AmiAssociationScope": "

Scope of AMI associations. The possible value is cross-account.

", "LicenseConfigurationUsage$ResourceArn": "

Amazon Resource Name (ARN) of the resource.

", "LicenseConfigurationUsage$ResourceStatus": "

Status of the resource.

", "LicenseConfigurationUsage$ResourceOwnerId": "

ID of the account that owns the resource.

", + "LicenseConversionTask$ResourceArn": "

The Amazon Resource Name (ARN) of the resource associated with the license type conversion task.

", + "LicenseConversionTask$StatusMessage": "

The status message for the conversion task.

", "LicenseOperationFailure$ResourceArn": "

Amazon Resource Name (ARN) of the resource.

", "LicenseOperationFailure$ErrorMessage": "

Error message.

", "LicenseOperationFailure$OperationName": "

Name of the operation.

", - "LicenseOperationFailure$ResourceOwnerId": "

ID of the AWS account that owns the resource.

", + "LicenseOperationFailure$ResourceOwnerId": "

ID of the Amazon Web Services account that owns the resource.

", "LicenseOperationFailure$OperationRequestedBy": "

The requester is \"License Manager Automated Discovery\".

", "LicenseSpecification$LicenseConfigurationArn": "

Amazon Resource Name (ARN) of the license configuration.

", "LicenseSpecification$AmiAssociationScope": "

Scope of AMI associations. The possible value is cross-account.

", @@ -1383,6 +1468,8 @@ "ListFailuresForLicenseConfigurationOperationsResponse$NextToken": "

Token for the next set of results.

", "ListLicenseConfigurationsRequest$NextToken": "

Token for the next set of results.

", "ListLicenseConfigurationsResponse$NextToken": "

Token for the next set of results.

", + "ListLicenseConversionTasksRequest$NextToken": "

Token for the next set of results.

", + "ListLicenseConversionTasksResponse$NextToken": "

Token for the next set of results.

", "ListLicenseManagerReportGeneratorsRequest$NextToken": "

Token for the next set of results.

", "ListLicenseManagerReportGeneratorsResponse$NextToken": "

Token for the next set of results.

", "ListLicenseSpecificationsForResourceRequest$ResourceArn": "

Amazon Resource Name (ARN) of a resource that has an associated license configuration.

", @@ -1412,11 +1499,11 @@ "ProductInformationFilter$ProductInformationFilterComparator": "

Logical operator.

", "RejectGrantResponse$Version": "

Grant version.

", "ReportGenerator$ReportGeneratorName": "

Name of the report generator.

", - "ReportGenerator$LicenseManagerReportGeneratorArn": "

Amazon Resource Number (ARN) of the report generator.

", + "ReportGenerator$LicenseManagerReportGeneratorArn": "

Amazon Resource Name (ARN) of the report generator.

", "ReportGenerator$LastRunStatus": "

Status of the last report generation attempt.

", "ReportGenerator$LastRunFailureReason": "

Failure message for the last report generation attempt.

", "ReportGenerator$LastReportGenerationTime": "

Time the last report was generated at.

", - "ReportGenerator$ReportCreatorAccount": "

The AWS account ID used to create the report generator.

", + "ReportGenerator$ReportCreatorAccount": "

The Amazon Web Services account ID used to create the report generator.

", "ReportGenerator$Description": "

Description of the report generator.

", "ReportGenerator$CreateTime": "

Time the report was created.

", "ResourceInventory$ResourceId": "

ID of the resource.

", @@ -1439,9 +1526,9 @@ "UpdateLicenseConfigurationRequest$LicenseConfigurationArn": "

Amazon Resource Name (ARN) of the license configuration.

", "UpdateLicenseConfigurationRequest$Name": "

New name of the license configuration.

", "UpdateLicenseConfigurationRequest$Description": "

New description of the license configuration.

", - "UpdateLicenseManagerReportGeneratorRequest$LicenseManagerReportGeneratorArn": "

Amazon Resource Number (ARN) of the report generator to update.

", + "UpdateLicenseManagerReportGeneratorRequest$LicenseManagerReportGeneratorArn": "

Amazon Resource Name (ARN) of the report generator to update.

", "UpdateLicenseManagerReportGeneratorRequest$Description": "

Description of the report generator.

", - "UpdateLicenseSpecificationsForResourceRequest$ResourceArn": "

Amazon Resource Name (ARN) of the AWS resource.

", + "UpdateLicenseSpecificationsForResourceRequest$ResourceArn": "

Amazon Resource Name (ARN) of the Amazon Web Services resource.

", "UpdateServiceSettingsRequest$S3BucketArn": "

Amazon Resource Name (ARN) of the Amazon S3 bucket where the License Manager information is stored.

", "UpdateServiceSettingsRequest$SnsTopicArn": "

Amazon Resource Name (ARN) of the Amazon SNS topic used for License Manager alerts.

" } @@ -1572,6 +1659,12 @@ "refs": { } }, + "UsageOperation": { + "base": null, + "refs": { + "LicenseConversionContext$UsageOperation": "

The Usage operation value that corresponds to the license type you are converting your resource from. For more information about which platforms correspond to which usage operation values see Sample data: usage operation by platform

" + } + }, "ValidationException": { "base": "

The provided input is not valid. Try your request again.

", "refs": { diff --git a/models/apis/mediapackage-vod/2018-11-07/api-2.json b/models/apis/mediapackage-vod/2018-11-07/api-2.json index 658e9474177..74962223cf0 100644 --- a/models/apis/mediapackage-vod/2018-11-07/api-2.json +++ b/models/apis/mediapackage-vod/2018-11-07/api-2.json @@ -1259,6 +1259,10 @@ "locationName": "packagingConfigurationId", "shape": "__string" }, + "Status": { + "locationName": "status", + "shape": "__string" + }, "Url": { "locationName": "url", "shape": "__string" diff --git a/models/apis/mediapackage-vod/2018-11-07/docs-2.json b/models/apis/mediapackage-vod/2018-11-07/docs-2.json index f5a2f14bced..f65189c4edd 100644 --- a/models/apis/mediapackage-vod/2018-11-07/docs-2.json +++ b/models/apis/mediapackage-vod/2018-11-07/docs-2.json @@ -355,6 +355,7 @@ "DashManifest$ManifestName" : "An optional string to include in the name of the manifest.", "EgressAccessLogs$LogGroupName" : "Customize the log group name.", "EgressEndpoint$PackagingConfigurationId" : "The ID of the PackagingConfiguration being applied to the Asset.", + "EgressEndpoint$Status" : "The current processing status of the asset used for the packaging configuration. The status can be either QUEUED, PROCESSING, PLAYABLE, or FAILED. Status information won't be available for most assets ingested before 2021-09-30.", "EgressEndpoint$Url" : "The URL of the parent manifest for the repackaged Asset.", "HlsEncryption$ConstantInitializationVector" : "A constant initialization vector for encryption (optional).\nWhen not specified the initialization vector will be periodically rotated.\n", "HlsManifest$ManifestName" : "An optional string to include in the name of the manifest.", diff --git a/models/apis/mediatailor/2018-04-23/api-2.json b/models/apis/mediatailor/2018-04-23/api-2.json index e3981bffdd3..60666f866fc 100644 --- a/models/apis/mediatailor/2018-04-23/api-2.json +++ b/models/apis/mediatailor/2018-04-23/api-2.json @@ -12,6 +12,21 @@ "uid": "mediatailor-2018-04-23" }, "operations": { + "ConfigureLogsForPlaybackConfiguration": { + "errors": [], + "http": { + "method": "PUT", + "requestUri": "/configureLogs/playbackConfiguration", + "responseCode": 200 + }, + "input": { + "shape": "ConfigureLogsForPlaybackConfigurationRequest" + }, + "name": "ConfigureLogsForPlaybackConfiguration", + "output": { + "shape": "ConfigureLogsForPlaybackConfigurationResponse" + } + }, "CreateChannel": { "errors": [], "http": { @@ -680,6 +695,32 @@ "shape": "__mapOf__string" } }, + "ConfigureLogsForPlaybackConfigurationRequest": { + "members": { + "PercentEnabled": { + "shape": "__integer" + }, + "PlaybackConfigurationName": { + "shape": "__string" + } + }, + "required": [ + "PercentEnabled", + "PlaybackConfigurationName" + ], + "type": "structure" + }, + "ConfigureLogsForPlaybackConfigurationResponse": { + "members": { + "PercentEnabled": { + "shape": "__integer" + }, + "PlaybackConfigurationName": { + "shape": "__string" + } + }, + "type": "structure" + }, "CreateChannelRequest": { "members": { "ChannelName": { @@ -1361,6 +1402,9 @@ "LivePreRollConfiguration": { "shape": "LivePreRollConfiguration" }, + "LogConfiguration": { + "shape": "LogConfiguration" + }, "ManifestProcessingRules": { "shape": "ManifestProcessingRules" }, @@ -1626,6 +1670,17 @@ }, "type": "structure" }, + "LogConfiguration": { + "members": { + "PercentEnabled": { + "shape": "__integer" + } + }, + "required": [ + "PercentEnabled" + ], + "type": "structure" + }, "ManifestProcessingRules": { "members": { "AdMarkerPassthrough": { @@ -1685,6 +1740,9 @@ "LivePreRollConfiguration": { "shape": "LivePreRollConfiguration" }, + "LogConfiguration": { + "shape": "LogConfiguration" + }, "ManifestProcessingRules": { "shape": "ManifestProcessingRules" }, @@ -1821,6 +1879,9 @@ "LivePreRollConfiguration": { "shape": "LivePreRollConfiguration" }, + "LogConfiguration": { + "shape": "LogConfiguration" + }, "ManifestProcessingRules": { "shape": "ManifestProcessingRules" }, diff --git a/models/apis/mediatailor/2018-04-23/docs-2.json b/models/apis/mediatailor/2018-04-23/docs-2.json index 291bd889570..9660ce26751 100644 --- a/models/apis/mediatailor/2018-04-23/docs-2.json +++ b/models/apis/mediatailor/2018-04-23/docs-2.json @@ -1,5 +1,6 @@ { "operations": { + "ConfigureLogsForPlaybackConfiguration": "

Configures Amazon CloudWatch log settings for a playback configuration.

", "CreateChannel": "

Creates a channel.

", "CreateProgram": "

Creates a program.

", "CreateSourceLocation": "

Creates a source location on a specific channel.

", @@ -121,6 +122,14 @@ "PlaybackConfiguration$ConfigurationAliases": "

The player parameters and aliases used as dynamic variables during session initialization. For more information, see Domain Variables.

" } }, + "ConfigureLogsForPlaybackConfigurationRequest": { + "base": "

Configures Amazon CloudWatch log settings for an existing MediaTailor playback configuration.

", + "refs": {} + }, + "ConfigureLogsForPlaybackConfigurationResponse": { + "base": "

Amazon CloudWatch log settings for a playback configuration.

", + "refs": {} + }, "CreateChannelRequest": { "base": "

The configuration for this channel.

", "refs": {} @@ -288,6 +297,13 @@ "PutPlaybackConfigurationRequest$LivePreRollConfiguration": "

The configuration for pre-roll ad insertion.

" } }, + "LogConfiguration": { + "base": "

Returns Amazon CloudWatch log settings for a playback configuration.

", + "refs": { + "GetPlaybackConfigurationResponse$LogConfiguration": "

The Amazon CloudWatch log settings for a playback configuration.

", + "PlaybackConfiguration$LogConfiguration": "

The Amazon CloudWatch log settings for a playback configuration.

" + } + }, "ManifestProcessingRules": { "base": "

The configuration for manifest processing rules. Manifest processing rules enable customization of the personalized manifests created by MediaTailor.

", "refs": { @@ -346,7 +362,7 @@ } }, "RequestOutputItem": { - "base": "

The ouput configuration for this channel.

", + "base": "

The output configuration for this channel.

", "refs": { "RequestOutputs$member": null } @@ -406,7 +422,7 @@ "refs": { "AdBreak$Slate": "

Ad break slate configuration.

", "Channel$FillerSlate": "

Contains information about the slate used to fill gaps between programs in the schedule. You must configure FillerSlate if your channel uses an LINEAR PlaybackMode.

", - "CreateChannelRequest$FillerSlate": "

The slate used to fill gaps between programs in the schedule. You must configure filler slate if your channel uses an LINEAR PlaybackMode.

", + "CreateChannelRequest$FillerSlate": "

The slate used to fill gaps between programs in the schedule. You must configure filler slate if your channel uses a LINEAR PlaybackMode.

", "DescribeChannelResponse$FillerSlate": "

Contains information about the slate used to fill gaps between programs in the schedule.

" } }, @@ -465,12 +481,15 @@ "__integer": { "base": null, "refs": { + "ConfigureLogsForPlaybackConfigurationRequest$PercentEnabled": "

The percentage of session logs that MediaTailor sends to your Cloudwatch Logs account. For example, if your playback configuration has 1000 sessions and percentEnabled is set to 60, MediaTailor sends logs for 600 of the sessions to CloudWatch Logs. MediaTailor decides at random which of the playback configuration sessions to send logs for. If you want to view logs for a specific session, you can use the debug log mode.

Valid values: 0 - 100

", + "ConfigureLogsForPlaybackConfigurationResponse$PercentEnabled": "

The percentage of session logs that MediaTailor sends to your Cloudwatch Logs account.

", "DashPlaylistSettings$ManifestWindowSeconds": "

The total duration (in seconds) of each manifest. Minimum value: 30 seconds. Maximum value: 3600 seconds.

", "DashPlaylistSettings$MinBufferTimeSeconds": "

Minimum amount of content (measured in seconds) that a player must keep available in the buffer. Minimum value: 2 seconds. Maximum value: 60 seconds.

", "DashPlaylistSettings$MinUpdatePeriodSeconds": "

Minimum amount of time (in seconds) that the player should wait before requesting updates to the manifest. Minimum value: 2 seconds. Maximum value: 60 seconds.

", "DashPlaylistSettings$SuggestedPresentationDelaySeconds": "

Amount of time (in seconds) that the player should be from the live point at the end of the manifest. Minimum value: 2 seconds. Maximum value: 60 seconds.

", "HlsPlaylistSettings$ManifestWindowSeconds": "

The total duration (in seconds) of each manifest. Minimum value: 30 seconds. Maximum value: 3600 seconds.

", "LivePreRollConfiguration$MaxDurationSeconds": "The maximum allowed duration for the pre-roll ad avail. AWS Elemental MediaTailor won't play pre-roll ads to exceed this duration, regardless of the total duration of ads that the ADS returns.", + "LogConfiguration$PercentEnabled": "

The percentage of session logs that MediaTailor sends to your Cloudwatch Logs account. For example, if your playback configuration has 1000 sessions and percentEnabled is set to 60, MediaTailor sends logs for 600 of the sessions to CloudWatch Logs. MediaTailor decides at random which of the playback configuration sessions to send logs for. If you want to view logs for a specific session, you can use the debug log mode.

Valid values: 0 - 100

", "SpliceInsertMessage$AvailNum": "

This is written to splice_insert.avail_num, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is 0. Values must be between 0 and 256, inclusive.

", "SpliceInsertMessage$AvailsExpected": "

This is written to splice_insert.avails_expected, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is 0. Values must be between 0 and 256, inclusive.

", "SpliceInsertMessage$SpliceEventId": "

This is written to splice_insert.splice_event_id, as defined in section 9.7.3.1 of the SCTE-35 specification. The default value is 1.

", @@ -585,6 +604,8 @@ "Channel$ChannelName": "

The name of the channel.

", "Channel$ChannelState": "

Returns the state whether the channel is running or not.

", "Channel$PlaybackMode": "

The type of playback mode for this channel.

LINEAR - Programs play back-to-back only once.

LOOP - Programs play back-to-back in an endless loop. When the last program in the schedule plays, playback loops back to the first program in the schedule.

", + "ConfigureLogsForPlaybackConfigurationRequest$PlaybackConfigurationName": "

The name of the playback configuration.

", + "ConfigureLogsForPlaybackConfigurationResponse$PlaybackConfigurationName": "

The name of the playback configuration.

", "CreateProgramRequest$SourceLocationName": "

The name of the source location.

", "CreateProgramRequest$VodSourceName": "

The name that's used to refer to a VOD source.

", "DashConfiguration$ManifestEndpointPrefix": "

The URL generated by MediaTailor to initiate a playback session. The session uses server-side reporting. This setting is ignored in PUT operations.

", @@ -619,7 +640,6 @@ "HttpPackageConfiguration$Path": "

The relative path to the URL for this VOD source. This is combined with SourceLocation::HttpConfiguration::BaseUrl to form a valid URL.

", "HttpPackageConfiguration$SourceGroup": "

The name of the source group. This has to match one of the Channel::Outputs::SourceGroup.

", "ListAlertsResponse$NextToken": "

Pagination token from the list request. Use the token to fetch the next page of results.

", - "ListAlertsResponse$ResourceArn": "

The Amazon Resource Name (ARN) of the resource.

", "ListChannelsResponse$NextToken": "

Pagination token returned by the list request when results exceed the maximum allowed. Use the token to fetch the next page of results.

", "ListPlaybackConfigurationsResponse$NextToken": "

Pagination token returned by the GET list request when results exceed the maximum allowed. Use the token to fetch the next page of results.

", "ListSourceLocationsResponse$NextToken": "

Pagination token from the list request. Use the token to fetch the next page of results.

", diff --git a/models/apis/models.lex.v2/2020-08-07/api-2.json b/models/apis/models.lex.v2/2020-08-07/api-2.json index 4bfd8526123..a01ba3f8929 100644 --- a/models/apis/models.lex.v2/2020-08-07/api-2.json +++ b/models/apis/models.lex.v2/2020-08-07/api-2.json @@ -418,6 +418,21 @@ {"shape":"InternalServerException"} ] }, + "DeleteUtterances":{ + "name":"DeleteUtterances", + "http":{ + "method":"DELETE", + "requestUri":"/bots/{botId}/utterances/", + "responseCode":204 + }, + "input":{"shape":"DeleteUtterancesRequest"}, + "output":{"shape":"DeleteUtterancesResponse"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"ThrottlingException"}, + {"shape":"InternalServerException"} + ] + }, "DescribeBot":{ "name":"DescribeBot", "http":{ @@ -584,6 +599,22 @@ {"shape":"InternalServerException"} ] }, + "ListAggregatedUtterances":{ + "name":"ListAggregatedUtterances", + "http":{ + "method":"POST", + "requestUri":"/bots/{botId}/aggregatedutterances/", + "responseCode":200 + }, + "input":{"shape":"ListAggregatedUtterancesRequest"}, + "output":{"shape":"ListAggregatedUtterancesResponse"}, + "errors":[ + {"shape":"ValidationException"}, + {"shape":"PreconditionFailedException"}, + {"shape":"ThrottlingException"}, + {"shape":"InternalServerException"} + ] + }, "ListBotAliases":{ "name":"ListBotAliases", "http":{ @@ -970,6 +1001,69 @@ } }, "shapes":{ + "AggregatedUtterancesFilter":{ + "type":"structure", + "required":[ + "name", + "values", + "operator" + ], + "members":{ + "name":{"shape":"AggregatedUtterancesFilterName"}, + "values":{"shape":"FilterValues"}, + "operator":{"shape":"AggregatedUtterancesFilterOperator"} + } + }, + "AggregatedUtterancesFilterName":{ + "type":"string", + "enum":["Utterance"] + }, + "AggregatedUtterancesFilterOperator":{ + "type":"string", + "enum":[ + "CO", + "EQ" + ] + }, + "AggregatedUtterancesFilters":{ + "type":"list", + "member":{"shape":"AggregatedUtterancesFilter"}, + "max":1, + "min":1 + }, + "AggregatedUtterancesSortAttribute":{ + "type":"string", + "enum":[ + "HitCount", + "MissedCount" + ] + }, + "AggregatedUtterancesSortBy":{ + "type":"structure", + "required":[ + "attribute", + "order" + ], + "members":{ + "attribute":{"shape":"AggregatedUtterancesSortAttribute"}, + "order":{"shape":"SortOrder"} + } + }, + "AggregatedUtterancesSummary":{ + "type":"structure", + "members":{ + "utterance":{"shape":"Utterance"}, + "hitCount":{"shape":"HitCount"}, + "missedCount":{"shape":"MissedCount"}, + "utteranceFirstRecordedInAggregationDuration":{"shape":"Timestamp"}, + "utteranceLastRecordedInAggregationDuration":{"shape":"Timestamp"}, + "containsDataFromDeletedResources":{"shape":"BoxedBoolean"} + } + }, + "AggregatedUtterancesSummaryList":{ + "type":"list", + "member":{"shape":"AggregatedUtterancesSummary"} + }, "AmazonResourceName":{ "type":"string", "max":1011, @@ -2271,6 +2365,32 @@ } } }, + "DeleteUtterancesRequest":{ + "type":"structure", + "required":["botId"], + "members":{ + "botId":{ + "shape":"Id", + "location":"uri", + "locationName":"botId" + }, + "localeId":{ + "shape":"LocaleId", + "location":"querystring", + "locationName":"localeId" + }, + "sessionId":{ + "shape":"SessionId", + "location":"querystring", + "locationName":"sessionId" + } + } + }, + "DeleteUtterancesResponse":{ + "type":"structure", + "members":{ + } + }, "DescribeBotAliasRequest":{ "type":"structure", "required":[ @@ -2761,6 +2881,7 @@ "enabled":{"shape":"Boolean"} } }, + "HitCount":{"type":"integer"}, "Id":{ "type":"string", "max":10, @@ -3015,6 +3136,44 @@ "codeHookInterfaceVersion":{"shape":"CodeHookInterfaceVersion"} } }, + "ListAggregatedUtterancesRequest":{ + "type":"structure", + "required":[ + "botId", + "localeId", + "aggregationDuration" + ], + "members":{ + "botId":{ + "shape":"Id", + "location":"uri", + "locationName":"botId" + }, + "botAliasId":{"shape":"BotAliasId"}, + "botVersion":{"shape":"BotVersion"}, + "localeId":{"shape":"LocaleId"}, + "aggregationDuration":{"shape":"UtteranceAggregationDuration"}, + "sortBy":{"shape":"AggregatedUtterancesSortBy"}, + "filters":{"shape":"AggregatedUtterancesFilters"}, + "maxResults":{"shape":"MaxResults"}, + "nextToken":{"shape":"NextToken"} + } + }, + "ListAggregatedUtterancesResponse":{ + "type":"structure", + "members":{ + "botId":{"shape":"Id"}, + "botAliasId":{"shape":"BotAliasId"}, + "botVersion":{"shape":"BotVersion"}, + "localeId":{"shape":"LocaleId"}, + "aggregationDuration":{"shape":"UtteranceAggregationDuration"}, + "aggregationWindowStartTime":{"shape":"Timestamp"}, + "aggregationWindowEndTime":{"shape":"Timestamp"}, + "aggregationLastRefreshedDateTime":{"shape":"Timestamp"}, + "aggregatedUtterancesSummaries":{"shape":"AggregatedUtterancesSummaryList"}, + "nextToken":{"shape":"NextToken"} + } + }, "ListBotAliasesRequest":{ "type":"structure", "required":["botId"], @@ -3379,6 +3538,7 @@ "max":2, "min":0 }, + "MissedCount":{"type":"integer"}, "MultipleValuesSetting":{ "type":"structure", "members":{ @@ -3516,9 +3676,20 @@ }, "RegexPattern":{ "type":"string", - "max":100, + "max":300, "min":1 }, + "RelativeAggregationDuration":{ + "type":"structure", + "required":[ + "timeDimension", + "timeValue" + ], + "members":{ + "timeDimension":{"shape":"TimeDimension"}, + "timeValue":{"shape":"TimeValue"} + } + }, "ResourceCount":{"type":"integer"}, "ResourceNotFoundException":{ "type":"structure", @@ -3618,6 +3789,12 @@ "error":{"httpStatusCode":402}, "exception":true }, + "SessionId":{ + "type":"string", + "max":100, + "min":2, + "pattern":"[0-9a-zA-Z._:-]+" + }, "SessionTTL":{ "type":"integer", "max":86400, @@ -3985,6 +4162,19 @@ "error":{"httpStatusCode":429}, "exception":true }, + "TimeDimension":{ + "type":"string", + "enum":[ + "Hours", + "Days", + "Weeks" + ] + }, + "TimeValue":{ + "type":"integer", + "max":24, + "min":1 + }, "Timestamp":{"type":"timestamp"}, "UntagResourceRequest":{ "type":"structure", @@ -4369,6 +4559,13 @@ } }, "Utterance":{"type":"string"}, + "UtteranceAggregationDuration":{ + "type":"structure", + "required":["relativeAggregationDuration"], + "members":{ + "relativeAggregationDuration":{"shape":"RelativeAggregationDuration"} + } + }, "ValidationException":{ "type":"structure", "members":{ diff --git a/models/apis/models.lex.v2/2020-08-07/docs-2.json b/models/apis/models.lex.v2/2020-08-07/docs-2.json index 9839494f821..d1af4b8848e 100644 --- a/models/apis/models.lex.v2/2020-08-07/docs-2.json +++ b/models/apis/models.lex.v2/2020-08-07/docs-2.json @@ -25,6 +25,7 @@ "DeleteResourcePolicyStatement": "

Deletes a policy statement from a resource policy. If you delete the last statement from a policy, the policy is deleted. If you specify a statement ID that doesn't exist in the policy, or if the bot or bot alias doesn't have a policy attached, Amazon Lex returns an exception.

", "DeleteSlot": "

Deletes the specified slot from an intent.

", "DeleteSlotType": "

Deletes a slot type from a bot locale.

If a slot is using the slot type, Amazon Lex throws a ResourceInUseException exception. To avoid the exception, set the skipResourceInUseCheck parameter to true.

", + "DeleteUtterances": "

Deletes stored utterances.

Amazon Lex stores the utterances that users send to your bot. Utterances are stored for 15 days for use with the operation, and then stored indefinitely for use in improving the ability of your bot to respond to user input..

Use the DeleteUtterances operation to manually delete utterances for a specific session. When you use the DeleteUtterances operation, utterances stored for improving your bot's ability to respond to user input are deleted immediately. Utterances stored for use with the ListAggregatedUtterances operation are deleted after 15 days.

", "DescribeBot": "

Provides metadata information about a bot.

", "DescribeBotAlias": "

Get information about a specific bot alias.

", "DescribeBotLocale": "

Describes the settings that a bot has for a specific locale.

", @@ -35,6 +36,7 @@ "DescribeResourcePolicy": "

Gets the resource policy and policy revision for a bot or bot alias.

", "DescribeSlot": "

Gets metadata information about a slot.

", "DescribeSlotType": "

Gets metadata information about a slot type.

", + "ListAggregatedUtterances": "

Provides a list of utterances that users have sent to the bot.

Utterances are aggregated by the text of the utterance. For example, all instances where customers used the phrase \"I want to order pizza\" are aggregated into the same line in the response.

You can see both detected utterances and missed utterances. A detected utterance is where the bot properly recognized the utterance and activated the associated intent. A missed utterance was not recognized by the bot and didn't activate an intent.

Utterances can be aggregated for a bot alias or for a bot version, but not both at the same time.

Utterances statistics are not generated under the following conditions:

", "ListBotAliases": "

Gets a list of aliases for the specified bot.

", "ListBotLocales": "

Gets a list of locales for the specified bot.

", "ListBotVersions": "

Gets information about all of the versions of a bot.

The ListBotVersions operation returns a summary of each version of a bot. For example, if a bot has three numbered versions, the ListBotVersions operation returns for summaries, one for each numbered version and one for the DRAFT version.

The ListBotVersions operation always returns at least one version, the DRAFT version.

", @@ -60,6 +62,54 @@ "UpdateSlotType": "

Updates the configuration of an existing slot type.

" }, "shapes": { + "AggregatedUtterancesFilter": { + "base": "

Filters responses returned by the ListAggregatedUtterances operation.

", + "refs": { + "AggregatedUtterancesFilters$member": null + } + }, + "AggregatedUtterancesFilterName": { + "base": null, + "refs": { + "AggregatedUtterancesFilter$name": "

The name of the field to filter the utterance list.

" + } + }, + "AggregatedUtterancesFilterOperator": { + "base": null, + "refs": { + "AggregatedUtterancesFilter$operator": "

The operator to use for the filter. Specify EQ when the ListAggregatedUtterances operation should return only utterances that equal the specified value. Specify CO when the ListAggregatedUtterances operation should return utterances that contain the specified value.

" + } + }, + "AggregatedUtterancesFilters": { + "base": null, + "refs": { + "ListAggregatedUtterancesRequest$filters": "

Provides the specification of a filter used to limit the utterances in the response to only those that match the filter specification. You can only specify one filter and one string to filter on.

" + } + }, + "AggregatedUtterancesSortAttribute": { + "base": null, + "refs": { + "AggregatedUtterancesSortBy$attribute": "

The utterance attribute to sort by.

" + } + }, + "AggregatedUtterancesSortBy": { + "base": "

Specifies attributes for sorting a list of utterances.

", + "refs": { + "ListAggregatedUtterancesRequest$sortBy": "

Specifies sorting parameters for the list of utterances. You can sort by the hit count, the missed count, or the number of distinct sessions the utterance appeared in.

" + } + }, + "AggregatedUtterancesSummary": { + "base": "

Provides summary information for aggregated utterances. The ListAggregatedUtterances operations combines all instances of the same utterance into a single aggregated summary.

", + "refs": { + "AggregatedUtterancesSummaryList$member": null + } + }, + "AggregatedUtterancesSummaryList": { + "base": null, + "refs": { + "ListAggregatedUtterancesResponse$aggregatedUtterancesSummaries": "

Summaries of the aggregated utterance data. Each response contains information about the number of times that the utterance was seen during the time period, whether it was detected or missed, and when it was seen during the time period.

" + } + }, "AmazonResourceName": { "base": null, "refs": { @@ -145,6 +195,8 @@ "DeleteBotAliasResponse$botAliasId": "

The unique identifier of the bot alias to delete.

", "DescribeBotAliasRequest$botAliasId": "

The identifier of the bot alias to describe.

", "DescribeBotAliasResponse$botAliasId": "

The identifier of the bot alias.

", + "ListAggregatedUtterancesRequest$botAliasId": "

The identifier of the bot alias associated with this request. If you specify the bot alias, you can't specify the bot version.

", + "ListAggregatedUtterancesResponse$botAliasId": "

The identifier of the bot alias that contains the utterances. If you specified the bot version, the bot alias ID isn't returned.

", "UpdateBotAliasRequest$botAliasId": "

The unique identifier of the bot alias.

", "UpdateBotAliasResponse$botAliasId": "

The identifier of the updated bot alias.

" } @@ -367,6 +419,8 @@ "DescribeSlotResponse$botVersion": "

The version of the bot associated with the slot.

", "DescribeSlotTypeRequest$botVersion": "

The version of the bot associated with the slot type.

", "DescribeSlotTypeResponse$botVersion": "

The version of the bot associated with the slot type.

", + "ListAggregatedUtterancesRequest$botVersion": "

The identifier of the bot version associated with this request. If you specify the bot version, you can't specify the bot alias.

", + "ListAggregatedUtterancesResponse$botVersion": "

The identifier of the bot version that contains the utterances. If you specified the bot alias, the bot version isn't returned.

", "ListBotLocalesRequest$botVersion": "

The version of the bot to list locales for.

", "ListBotLocalesResponse$botVersion": "

The version of the bot.

", "ListExportsRequest$botVersion": "

The version of the bot to list exports for.

", @@ -421,6 +475,7 @@ "BoxedBoolean": { "base": null, "refs": { + "AggregatedUtterancesSummary$containsDataFromDeletedResources": "

Aggregated utterance data may contain utterances from versions of your bot that have since been deleted. When the aggregated contains this kind of data, this field is set to true.

", "IntentClosingSetting$active": "

Specifies whether an intent's closing response is used. When this field is false, the closing response isn't sent to the user and no closing input from the user is used. If the active field isn't specified, the default is true.

", "IntentConfirmationSetting$active": "

Specifies whether the intent's confirmation is sent to the user. When this field is false, confirmation and declination responses aren't sent and processing continues as if the responses aren't present. If the active field isn't specified, the default is true.

", "PromptSpecification$allowInterrupt": "

Indicates whether the user can interrupt a speech prompt from the bot.

", @@ -601,7 +656,7 @@ } }, "ConflictException": { - "base": "

", + "base": "

The action that you tried to perform couldn't be completed because the resource is in a conflicting state. For example, deleting a bot that is in the CREATING state. Try your request again.

", "refs": { } }, @@ -856,6 +911,16 @@ "refs": { } }, + "DeleteUtterancesRequest": { + "base": null, + "refs": { + } + }, + "DeleteUtterancesResponse": { + "base": null, + "refs": { + } + }, "DescribeBotAliasRequest": { "base": null, "refs": { @@ -1156,6 +1221,7 @@ "FilterValues": { "base": null, "refs": { + "AggregatedUtterancesFilter$values": "

The value to use for filtering the list of bots.

", "BotFilter$values": "

The value to use for filtering the list of bots.

", "BotLocaleFilter$values": "

The value to use for filtering the list of bots.

", "ExportFilter$values": "

The values to use to fileter the response.

", @@ -1175,6 +1241,12 @@ "UpdateIntentResponse$fulfillmentCodeHook": "

The updated Lambda function called when the intent is ready for fulfillment.

" } }, + "HitCount": { + "base": null, + "refs": { + "AggregatedUtterancesSummary$hitCount": "

The number of times that the utterance was detected by Amazon Lex during the time period. When an utterance is detected, it activates an intent or a slot.

" + } + }, "Id": { "base": null, "refs": { @@ -1223,6 +1295,7 @@ "DeleteSlotRequest$intentId": "

The identifier of the intent associated with the slot.

", "DeleteSlotTypeRequest$slotTypeId": "

The identifier of the slot type to delete.

", "DeleteSlotTypeRequest$botId": "

The identifier of the bot associated with the slot type.

", + "DeleteUtterancesRequest$botId": "

The unique identifier of the bot that contains the utterances.

", "DescribeBotAliasRequest$botId": "

The identifier of the bot associated with the bot alias to describe.

", "DescribeBotAliasResponse$botId": "

The identifier of the bot associated with the bot alias.

", "DescribeBotLocaleRequest$botId": "

The identifier of the bot associated with the locale.

", @@ -1252,6 +1325,8 @@ "ExportSummary$exportId": "

The unique identifier that Amazon Lex assigned to the export.

", "ImportSummary$importId": "

The unique identifier that Amazon Lex assigned to the import.

", "IntentSummary$intentId": "

The unique identifier assigned to the intent. Use this ID to get detailed information about the intent with the DescribeIntent operation.

", + "ListAggregatedUtterancesRequest$botId": "

The unique identifier of the bot associated with this request.

", + "ListAggregatedUtterancesResponse$botId": "

The identifier of the bot that contains the utterances.

", "ListBotAliasesRequest$botId": "

The identifier of the bot to list aliases for.

", "ListBotAliasesResponse$botId": "

The identifier of the bot associated with the aliases.

", "ListBotLocalesRequest$botId": "

The identifier of the bot to list locales for.

", @@ -1493,7 +1568,7 @@ } }, "InternalServerException": { - "base": "

", + "base": "

The service encountered an unexpected condition. Try your request again.

", "refs": { } }, @@ -1531,6 +1606,16 @@ "CodeHookSpecification$lambdaCodeHook": null } }, + "ListAggregatedUtterancesRequest": { + "base": null, + "refs": { + } + }, + "ListAggregatedUtterancesResponse": { + "base": null, + "refs": { + } + }, "ListBotAliasesRequest": { "base": null, "refs": { @@ -1674,6 +1759,7 @@ "DeleteIntentRequest$localeId": "

The identifier of the language and locale where the bot will be deleted. The string must match one of the supported locales. For more information, see Supported languages.

", "DeleteSlotRequest$localeId": "

The identifier of the language and locale that the slot will be deleted from. The string must match one of the supported locales. For more information, see Supported languages.

", "DeleteSlotTypeRequest$localeId": "

The identifier of the language and locale that the slot type will be deleted from. The string must match one of the supported locales. For more information, see Supported languages.

", + "DeleteUtterancesRequest$localeId": "

The identifier of the language and locale where the utterances were collected. The string must match one of the supported locales. For more information, see Supported languages.

", "DescribeBotLocaleRequest$localeId": "

The unique identifier of the locale to describe. The string must match one of the supported locales. For more information, see Supported languages.

", "DescribeBotLocaleResponse$localeId": "

The unique identifier of the described locale.

", "DescribeIntentRequest$localeId": "

The identifier of the language and locale of the intent to describe. The string must match one of the supported locales. For more information, see Supported languages.

", @@ -1682,6 +1768,8 @@ "DescribeSlotResponse$localeId": "

The language and locale specified for the slot.

", "DescribeSlotTypeRequest$localeId": "

The identifier of the language and locale of the slot type to describe. The string must match one of the supported locales. For more information, see Supported languages.

", "DescribeSlotTypeResponse$localeId": "

The language and locale specified for the slot type.

", + "ListAggregatedUtterancesRequest$localeId": "

The identifier of the language and locale where the utterances were collected. For more information, see Supported languages.

", + "ListAggregatedUtterancesResponse$localeId": "

The identifier of the language and locale that the utterances are in.

", "ListBuiltInIntentsRequest$localeId": "

The identifier of the language and locale of the intents to list. The string must match one of the supported locales. For more information, see Supported languages.

", "ListBuiltInIntentsResponse$localeId": "

The language and locale of the intents in the list.

", "ListBuiltInSlotTypesRequest$localeId": "

The identifier of the language and locale of the slot types to list. The string must match one of the supported locales. For more information, see Supported languages.

", @@ -1721,6 +1809,7 @@ "MaxResults": { "base": null, "refs": { + "ListAggregatedUtterancesRequest$maxResults": "

The maximum number of utterances to return in each page of results. If there are fewer results than the maximum page size, only the actual number of results are returned. If you don't specify the maxResults parameter, 1,000 results are returned.

", "ListBotAliasesRequest$maxResults": "

The maximum number of aliases to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.

", "ListBotLocalesRequest$maxResults": "

The maximum number of aliases to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.

", "ListBotVersionsRequest$maxResults": "

The maximum number of versions to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.

", @@ -1768,6 +1857,12 @@ "MessageGroup$variations": "

Message variations to send to the user. When variations are defined, Amazon Lex chooses the primary message or one of the variations to send to the user.

" } }, + "MissedCount": { + "base": null, + "refs": { + "AggregatedUtterancesSummary$missedCount": "

The number of times that the utterance was missed by Amazon Lex An utterance is missed when it doesn't activate an intent or slot.

" + } + }, "MultipleValuesSetting": { "base": "

Indicates whether a slot can return multiple values.

", "refs": { @@ -1825,6 +1920,8 @@ "NextToken": { "base": null, "refs": { + "ListAggregatedUtterancesRequest$nextToken": "

If the response from the ListAggregatedUtterances operation contains more results that specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.

", + "ListAggregatedUtterancesResponse$nextToken": "

A token that indicates whether there are more results to return in a response to the ListAggregatedUtterances operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListAggregatedUtterances operation request to get the next page of results.

", "ListBotAliasesRequest$nextToken": "

If the response from the ListBotAliases operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.

", "ListBotAliasesResponse$nextToken": "

A token that indicates whether there are more results to return in a response to the ListBotAliases operation. If the nextToken field is present, you send the contents as the nextToken parameter of a ListBotAliases operation request to get the next page of results.

", "ListBotLocalesRequest$nextToken": "

If the response from the ListBotLocales operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token as the nextToken parameter to return the next page of results.

", @@ -1928,7 +2025,7 @@ } }, "PreconditionFailedException": { - "base": "

", + "base": "

Your request couldn't be completed because one or more request fields aren't valid. Check the fields in your request and try again.

", "refs": { } }, @@ -1989,6 +2086,12 @@ "SlotValueRegexFilter$pattern": "

A regular expression used to validate the value of a slot.

Use a standard regular expression. Amazon Lex supports the following characters in the regular expression:

Represent Unicode characters with four digits, for example \"\\u0041\" or \"\\u005A\".

The following regular expression operators are not supported:

" } }, + "RelativeAggregationDuration": { + "base": "

Specifies the time window that utterance statistics are returned for. The time window is always relative to the last time that the that utterances were aggregated. For example, if the ListAggregatedUtterances operation is called at 1600, the time window is set to 1 hour, and the last refresh time was 1530, only utterances made between 1430 and 1530 are returned.

You can choose the time window that statistics should be returned for.

", + "refs": { + "UtteranceAggregationDuration$relativeAggregationDuration": "

The desired time window for aggregating utterances.

" + } + }, "ResourceCount": { "base": null, "refs": { @@ -1997,7 +2100,7 @@ } }, "ResourceNotFoundException": { - "base": "

", + "base": "

You asked to describe a resource that doesn't exist. Check the resource that you are requesting and try again.

", "refs": { } }, @@ -2108,10 +2211,16 @@ } }, "ServiceQuotaExceededException": { - "base": "

", + "base": "

You have reached a quota for your bot.

", "refs": { } }, + "SessionId": { + "base": null, + "refs": { + "DeleteUtterancesRequest$sessionId": "

The unique identifier of the session with the user. The ID is returned in the response from the and operations.

" + } + }, "SessionTTL": { "base": null, "refs": { @@ -2337,6 +2446,7 @@ "SortOrder": { "base": null, "refs": { + "AggregatedUtterancesSortBy$order": "

Specifies whether to sort the aggregated utterances in ascending or descending order.

", "BotLocaleSortBy$order": "

Specifies whether to sort the bot locales in ascending or descending order.

", "BotSortBy$order": "

The order to sort the list. You can choose ascending or descending.

", "BotVersionSortBy$order": "

The order to sort the list. You can specify ascending or descending order.

", @@ -2446,13 +2556,27 @@ } }, "ThrottlingException": { - "base": "

", + "base": "

Your request rate is too high. Reduce the frequency of requests.

", "refs": { } }, + "TimeDimension": { + "base": null, + "refs": { + "RelativeAggregationDuration$timeDimension": "

The type of time period that the timeValue field represents.

" + } + }, + "TimeValue": { + "base": null, + "refs": { + "RelativeAggregationDuration$timeValue": "

The period of the time window to gather statistics for. The valid value depends on the setting of the timeDimension field.

" + } + }, "Timestamp": { "base": null, "refs": { + "AggregatedUtterancesSummary$utteranceFirstRecordedInAggregationDuration": "

The date and time that the utterance was first recorded in the time window for aggregation. An utterance may have been sent to Amazon Lex before that time, but only utterances within the time window are counted.

", + "AggregatedUtterancesSummary$utteranceLastRecordedInAggregationDuration": "

The last date and time that an utterance was recorded in the time window for aggregation. An utterance may be sent to Amazon Lex after that time, but only utterances within the time window are counted.

", "BotAliasHistoryEvent$startDate": "

The date and time that the event started.

", "BotAliasHistoryEvent$endDate": "

The date and time that the event ended.

", "BotAliasSummary$creationDateTime": "

A timestamp of the date and time that the bot alias was created.

", @@ -2494,6 +2618,9 @@ "ImportSummary$creationDateTime": "

The date and time that the import was created.

", "ImportSummary$lastUpdatedDateTime": "

The date and time that the import was last updated.

", "IntentSummary$lastUpdatedDateTime": "

The timestamp of the date and time that the intent was last updated.

", + "ListAggregatedUtterancesResponse$aggregationWindowStartTime": "

The date and time that the aggregation window begins. Only data collected after this time is returned in the results.

", + "ListAggregatedUtterancesResponse$aggregationWindowEndTime": "

The date and time that the aggregation window ends. Only data collected between the start time and the end time are returned in the results.

", + "ListAggregatedUtterancesResponse$aggregationLastRefreshedDateTime": "

The last date and time that the aggregated data was collected. The time period depends on the length of the aggregation window.

", "SlotSummary$lastUpdatedDateTime": "

The timestamp of the last date and time that the slot was updated.

", "SlotTypeSummary$lastUpdatedDateTime": "

A timestamp of the date and time that the slot type was last updated.

", "StartImportResponse$creationDateTime": "

The date and time that the import request was created.

", @@ -2606,11 +2733,19 @@ "Utterance": { "base": null, "refs": { + "AggregatedUtterancesSummary$utterance": "

The text of the utterance. If the utterance was used with the RecognizeUtterance operation, the text is the transcription of the audio utterance.

", "SampleUtterance$utterance": "

The sample utterance that Amazon Lex uses to build its machine-learning model to recognize intents.

" } }, + "UtteranceAggregationDuration": { + "base": "

Provides parameters for setting the time window and duration for aggregating utterance data.

", + "refs": { + "ListAggregatedUtterancesRequest$aggregationDuration": "

The time window for aggregating the utterance information. You can specify a time between one hour and two weeks.

", + "ListAggregatedUtterancesResponse$aggregationDuration": "

The time period used to aggregate the utterance data.

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

", + "base": "

One of the input parameters in your request isn't valid. Check the parameters and try your request again.

", "refs": { } }, diff --git a/models/apis/models.lex.v2/2020-08-07/paginators-1.json b/models/apis/models.lex.v2/2020-08-07/paginators-1.json index 3353a41d24e..a05bc8545b7 100644 --- a/models/apis/models.lex.v2/2020-08-07/paginators-1.json +++ b/models/apis/models.lex.v2/2020-08-07/paginators-1.json @@ -1,5 +1,10 @@ { "pagination": { + "ListAggregatedUtterances": { + "input_token": "nextToken", + "output_token": "nextToken", + "limit_key": "maxResults" + }, "ListBotAliases": { "input_token": "nextToken", "output_token": "nextToken", diff --git a/models/apis/wafv2/2019-07-29/api-2.json b/models/apis/wafv2/2019-07-29/api-2.json index 1e11ec6aae5..4802d2ebb48 100755 --- a/models/apis/wafv2/2019-07-29/api-2.json +++ b/models/apis/wafv2/2019-07-29/api-2.json @@ -2532,6 +2532,19 @@ "RegexString":{"shape":"RegexPatternString"} } }, + "RegexMatchStatement":{ + "type":"structure", + "required":[ + "RegexString", + "FieldToMatch", + "TextTransformations" + ], + "members":{ + "RegexString":{"shape":"RegexPatternString"}, + "FieldToMatch":{"shape":"FieldToMatch"}, + "TextTransformations":{"shape":"TextTransformations"} + } + }, "RegexPatternSet":{ "type":"structure", "members":{ @@ -2800,7 +2813,8 @@ "OrStatement":{"shape":"OrStatement"}, "NotStatement":{"shape":"NotStatement"}, "ManagedRuleGroupStatement":{"shape":"ManagedRuleGroupStatement"}, - "LabelMatchStatement":{"shape":"LabelMatchStatement"} + "LabelMatchStatement":{"shape":"LabelMatchStatement"}, + "RegexMatchStatement":{"shape":"RegexMatchStatement"} } }, "Statements":{ diff --git a/models/apis/wafv2/2019-07-29/docs-2.json b/models/apis/wafv2/2019-07-29/docs-2.json index 4a8f2675793..7beadf0b2ed 100755 --- a/models/apis/wafv2/2019-07-29/docs-2.json +++ b/models/apis/wafv2/2019-07-29/docs-2.json @@ -553,6 +553,7 @@ "refs": { "ByteMatchStatement$FieldToMatch": "

The part of a web request that you want WAF to inspect. For more information, see FieldToMatch.

", "RedactedFields$member": null, + "RegexMatchStatement$FieldToMatch": "

The part of a web request that you want WAF to inspect. For more information, see FieldToMatch.

", "RegexPatternSetReferenceStatement$FieldToMatch": "

The part of a web request that you want WAF to inspect. For more information, see FieldToMatch.

", "SizeConstraintStatement$FieldToMatch": "

The part of a web request that you want WAF to inspect. For more information, see FieldToMatch.

", "SqliMatchStatement$FieldToMatch": "

The part of a web request that you want WAF to inspect. For more information, see FieldToMatch.

", @@ -1340,6 +1341,12 @@ "RegularExpressionList$member": null } }, + "RegexMatchStatement": { + "base": "

A rule statement used to search web request components for a match against a single regular expression.

", + "refs": { + "Statement$RegexMatchStatement": "

A rule statement used to search web request components for a match against a single regular expression.

" + } + }, "RegexPatternSet": { "base": "

Contains one or more regular expressions.

WAF assigns an ARN to each RegexPatternSet that you create. To use a set in a rule, you provide the ARN to the Rule statement RegexPatternSetReferenceStatement.

", "refs": { @@ -1368,7 +1375,8 @@ "RegexPatternString": { "base": null, "refs": { - "Regex$RegexString": "

The string representing the regular expression.

" + "Regex$RegexString": "

The string representing the regular expression.

", + "RegexMatchStatement$RegexString": "

The string representing the regular expression.

" } }, "RegularExpressionList": { @@ -1702,6 +1710,7 @@ "base": null, "refs": { "ByteMatchStatement$TextTransformations": "

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. If you specify one or more transformations in a rule statement, WAF performs all transformations on the content of the request component identified by FieldToMatch, starting from the lowest priority setting, before inspecting the content for a match.

", + "RegexMatchStatement$TextTransformations": "

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. If you specify one or more transformations in a rule statement, WAF performs all transformations on the content of the request component identified by FieldToMatch, starting from the lowest priority setting, before inspecting the content for a match.

", "RegexPatternSetReferenceStatement$TextTransformations": "

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. If you specify one or more transformations in a rule statement, WAF performs all transformations on the content of the request component identified by FieldToMatch, starting from the lowest priority setting, before inspecting the content for a match.

", "SizeConstraintStatement$TextTransformations": "

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. If you specify one or more transformations in a rule statement, WAF performs all transformations on the content of the request component identified by FieldToMatch, starting from the lowest priority setting, before inspecting the content for a match.

", "SqliMatchStatement$TextTransformations": "

Text transformations eliminate some of the unusual formatting that attackers use in web requests in an effort to bypass detection. If you specify one or more transformations in a rule statement, WAF performs all transformations on the content of the request component identified by FieldToMatch, starting from the lowest priority setting, before inspecting the content for a match.

", diff --git a/models/endpoints/endpoints.json b/models/endpoints/endpoints.json index abb9dbe4cef..92fb704642c 100644 --- a/models/endpoints/endpoints.json +++ b/models/endpoints/endpoints.json @@ -898,6 +898,22 @@ "us-west-2" : { } } }, + "auditmanager" : { + "endpoints" : { + "ap-northeast-1" : { }, + "ap-south-1" : { }, + "ap-southeast-1" : { }, + "ap-southeast-2" : { }, + "ca-central-1" : { }, + "eu-central-1" : { }, + "eu-west-1" : { }, + "eu-west-2" : { }, + "us-east-1" : { }, + "us-east-2" : { }, + "us-west-1" : { }, + "us-west-2" : { } + } + }, "autoscaling" : { "defaults" : { "protocols" : [ "http", "https" ] @@ -7838,6 +7854,12 @@ "cn-northwest-1" : { } } }, + "appmesh" : { + "endpoints" : { + "cn-north-1" : { }, + "cn-northwest-1" : { } + } + }, "appsync" : { "endpoints" : { "cn-north-1" : { }, diff --git a/service/iam/api.go b/service/iam/api.go index 12bef432068..4c5f41c92c1 100644 --- a/service/iam/api.go +++ b/service/iam/api.go @@ -699,8 +699,9 @@ func (c *IAM) ChangePasswordRequest(input *ChangePasswordInput) (req *request.Re // // Changes the password of the IAM user who is calling this operation. This // operation can be performed using the CLI, the Amazon Web Services API, or -// the My Security Credentials page in the Management Console. The account root -// user password is not affected by this operation. +// the My Security Credentials page in the Amazon Web Services Management Console. +// The Amazon Web Services account root user password is not affected by this +// operation. // // Use UpdateLoginProfile to use the CLI, the Amazon Web Services API, or the // Users page in the IAM console to change the password for any IAM user. For @@ -814,19 +815,20 @@ func (c *IAM) CreateAccessKeyRequest(input *CreateAccessKeyInput) (req *request. // // If you do not specify a user name, IAM determines the user name implicitly // based on the Amazon Web Services access key ID signing the request. This -// operation works for access keys under the account. Consequently, you can -// use this operation to manage account root user credentials. This is true -// even if the account has no associated users. +// operation works for access keys under the Amazon Web Services account. Consequently, +// you can use this operation to manage Amazon Web Services account root user +// credentials. This is true even if the Amazon Web Services account has no +// associated users. // // For information about quotas on the number of keys you can create, see IAM // and STS quotas (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-quotas.html) // in the IAM User Guide. // -// To ensure the security of your account, the secret access key is accessible -// only during key and user creation. You must save the key (for example, in -// a text file) if you want to be able to access it again. If a secret key is -// lost, you can delete the access keys for the associated user and then create -// new keys. +// To ensure the security of your Amazon Web Services account, the secret access +// key is accessible only during key and user creation. You must save the key +// (for example, in a text file) if you want to be able to access it again. +// If a secret key is lost, you can delete the access keys for the associated +// user and then create new keys. // // 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 @@ -916,8 +918,9 @@ func (c *IAM) CreateAccountAliasRequest(input *CreateAccountAliasInput) (req *re // CreateAccountAlias API operation for AWS Identity and Access Management. // -// Creates an alias for your account. For information about using an account -// alias, see Using an alias for your account ID (https://docs.aws.amazon.com/IAM/latest/UserGuide/AccountAlias.html) +// Creates an alias for your Amazon Web Services account. For information about +// using an Amazon Web Services account alias, see Using an alias for your Amazon +// Web Services account ID (https://docs.aws.amazon.com/IAM/latest/UserGuide/AccountAlias.html) // in the IAM User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -1210,12 +1213,13 @@ func (c *IAM) CreateLoginProfileRequest(input *CreateLoginProfileInput) (req *re // CreateLoginProfile API operation for AWS Identity and Access Management. // // Creates a password for the specified IAM user. A password allows an IAM user -// to access Amazon Web Services services through the Management Console. +// to access Amazon Web Services services through the Amazon Web Services Management +// Console. // // You can use the CLI, the Amazon Web Services API, or the Users page in the // IAM console to create a password for any IAM user. Use ChangePassword to // update your own existing password in the My Security Credentials page in -// the Management Console. +// the Amazon Web Services Management Console. // // For more information about managing passwords, see Managing passwords (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_ManagingLogins.html) // in the IAM User Guide. @@ -1340,8 +1344,8 @@ func (c *IAM) CreateOpenIDConnectProviderRequest(input *CreateOpenIDConnectProvi // * A list of thumbprints of one or more server certificates that the IdP // uses // -// You get all of this information from the OIDC IdP that you want to use to -// access Amazon Web Services. +// You get all of this information from the OIDC IdP you want to use to access +// Amazon Web Services. // // Amazon Web Services secures communication with some OIDC identity providers // (IdPs) through our library of trusted certificate authorities (CAs) instead @@ -1450,7 +1454,7 @@ func (c *IAM) CreatePolicyRequest(input *CreatePolicyInput) (req *request.Reques // CreatePolicy API operation for AWS Identity and Access Management. // -// Creates a new managed policy for your account. +// Creates a new managed policy for your Amazon Web Services account. // // This operation creates a policy version with a version identifier of v1 and // sets v1 as the policy's default version. For more information about policy @@ -1673,8 +1677,8 @@ func (c *IAM) CreateRoleRequest(input *CreateRoleInput) (req *request.Request, o // CreateRole API operation for AWS Identity and Access Management. // -// Creates a new role for your account. For more information about roles, see -// IAM roles (https://docs.aws.amazon.com/IAM/latest/UserGuide/WorkingWithRoles.html). +// Creates a new role for your Amazon Web Services account. For more information +// about roles, see IAM roles (https://docs.aws.amazon.com/IAM/latest/UserGuide/WorkingWithRoles.html). // For information about quotas for role names and the number of roles you can // create, see IAM and STS quotas (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-quotas.html) // in the IAM User Guide. @@ -1785,8 +1789,8 @@ func (c *IAM) CreateSAMLProviderRequest(input *CreateSAMLProviderInput) (req *re // The SAML provider resource that you create with this operation can be used // as a principal in an IAM role's trust policy. Such a policy can enable federated // users who sign in using the SAML IdP to assume the role. You can create an -// IAM role that supports Web-based single sign-on (SSO) to the Management Console -// or one that supports API access to Amazon Web Services. +// IAM role that supports Web-based single sign-on (SSO) to the Amazon Web Services +// Management Console or one that supports API access to Amazon Web Services. // // When you create the SAML provider resource, you upload a SAML metadata document // that you get from your IdP. That document includes the issuer's name, expiration @@ -1798,7 +1802,7 @@ func (c *IAM) CreateSAMLProviderRequest(input *CreateSAMLProviderInput) (req *re // This operation requires Signature Version 4 (https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). // // For more information, see Enabling SAML 2.0 federated users to access the -// Management Console (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-saml.html) +// Amazon Web Services Management Console (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_enable-console-saml.html) // and About SAML 2.0-based federation (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_saml.html) // in the IAM User Guide. // @@ -2104,7 +2108,7 @@ func (c *IAM) CreateUserRequest(input *CreateUserInput) (req *request.Request, o // CreateUser API operation for AWS Identity and Access Management. // -// Creates a new IAM user for your account. +// Creates a new IAM user for your Amazon Web Services account. // // For information about quotas for the number of IAM users you can create, // see IAM and STS quotas (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_iam-quotas.html) @@ -2210,10 +2214,10 @@ func (c *IAM) CreateVirtualMFADeviceRequest(input *CreateVirtualMFADeviceInput) // CreateVirtualMFADevice API operation for AWS Identity and Access Management. // -// Creates a new virtual MFA device for the account. After creating the virtual -// MFA, use EnableMFADevice to attach the MFA device to an IAM user. For more -// information about creating and working with virtual MFA devices, see Using -// a virtual MFA device (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_VirtualMFA.html) +// Creates a new virtual MFA device for the Amazon Web Services account. After +// creating the virtual MFA, use EnableMFADevice to attach the MFA device to +// an IAM user. For more information about creating and working with virtual +// MFA devices, see Using a virtual MFA device (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_VirtualMFA.html) // in the IAM User Guide. // // For information about the maximum number of MFA devices you can create, see @@ -2428,9 +2432,9 @@ func (c *IAM) DeleteAccessKeyRequest(input *DeleteAccessKeyInput) (req *request. // // If you do not specify a user name, IAM determines the user name implicitly // based on the Amazon Web Services access key ID signing the request. This -// operation works for access keys under the account. Consequently, you can -// use this operation to manage account root user credentials even if the account -// has no associated users. +// operation works for access keys under the Amazon Web Services account. Consequently, +// you can use this operation to manage Amazon Web Services account root user +// credentials even if the Amazon Web Services account has no associated users. // // 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 @@ -2520,8 +2524,9 @@ func (c *IAM) DeleteAccountAliasRequest(input *DeleteAccountAliasInput) (req *re // DeleteAccountAlias API operation for AWS Identity and Access Management. // -// Deletes the specified account alias. For information about using an Amazon -// Web Services account alias, see Using an alias for your account ID (https://docs.aws.amazon.com/IAM/latest/UserGuide/AccountAlias.html) +// Deletes the specified Amazon Web Services account alias. For information +// about using an Amazon Web Services account alias, see Using an alias for +// your Amazon Web Services account ID (https://docs.aws.amazon.com/IAM/latest/UserGuide/AccountAlias.html) // in the IAM User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -2612,7 +2617,8 @@ func (c *IAM) DeleteAccountPasswordPolicyRequest(input *DeleteAccountPasswordPol // DeleteAccountPasswordPolicy API operation for AWS Identity and Access Management. // -// Deletes the password policy for the account. There are no parameters. +// Deletes the password policy for the Amazon Web Services account. There are +// no parameters. // // 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 @@ -2997,12 +3003,13 @@ func (c *IAM) DeleteLoginProfileRequest(input *DeleteLoginProfileInput) (req *re // DeleteLoginProfile API operation for AWS Identity and Access Management. // // Deletes the password for the specified IAM user, which terminates the user's -// ability to access Amazon Web Services services through the Management Console. +// ability to access Amazon Web Services services through the Amazon Web Services +// Management Console. // // You can use the CLI, the Amazon Web Services API, or the Users page in the // IAM console to delete a password for any IAM user. You can use ChangePassword // to update, but not delete, your own password in the My Security Credentials -// page in the Management Console. +// page in the Amazon Web Services Management Console. // // Deleting a user's password does not prevent a user from accessing Amazon // Web Services through the command line interface or the API. To prevent all @@ -4224,9 +4231,10 @@ func (c *IAM) DeleteSigningCertificateRequest(input *DeleteSigningCertificateInp // // If you do not specify a user name, IAM determines the user name implicitly // based on the Amazon Web Services access key ID signing the request. This -// operation works for access keys under the account. Consequently, you can -// use this operation to manage account root user credentials even if the account -// has no associated IAM users. +// operation works for access keys under the Amazon Web Services account. Consequently, +// you can use this operation to manage Amazon Web Services account root user +// credentials even if the Amazon Web Services account has no associated IAM +// users. // // 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 @@ -4316,9 +4324,10 @@ func (c *IAM) DeleteUserRequest(input *DeleteUserInput) (req *request.Request, o // DeleteUser API operation for AWS Identity and Access Management. // -// Deletes the specified IAM user. Unlike the Management Console, when you delete -// a user programmatically, you must delete the items attached to the user manually, -// or the deletion fails. For more information, see Deleting an IAM user (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_manage.html#id_users_deleting_cli). +// Deletes the specified IAM user. Unlike the Amazon Web Services Management +// Console, when you delete a user programmatically, you must delete the items +// attached to the user manually, or the deletion fails. For more information, +// see Deleting an IAM user (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_manage.html#id_users_deleting_cli). // Before attempting to delete a user, remove the following items: // // * Password (DeleteLoginProfile) @@ -5126,8 +5135,8 @@ func (c *IAM) GenerateCredentialReportRequest(input *GenerateCredentialReportInp // GenerateCredentialReport API operation for AWS Identity and Access Management. // -// Generates a credential report for the account. For more information about -// the credential report, see Getting credential reports (https://docs.aws.amazon.com/IAM/latest/UserGuide/credential-reports.html) +// Generates a credential report for the Amazon Web Services account. For more +// information about the credential report, see Getting credential reports (https://docs.aws.amazon.com/IAM/latest/UserGuide/credential-reports.html) // in the IAM User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -5241,13 +5250,14 @@ func (c *IAM) GenerateOrganizationsAccessReportRequest(input *GenerateOrganizati // in the IAM User Guide. // // The data includes all attempts to access Amazon Web Services, not just the -// successful ones. This includes all attempts that were made using the Management -// Console, the Amazon Web Services API through any of the SDKs, or any of the -// command line tools. An unexpected entry in the service last accessed data -// does not mean that an account has been compromised, because the request might -// have been denied. Refer to your CloudTrail logs as the authoritative source -// for information about all API calls and whether they were successful or denied -// access. For more information, see Logging IAM events with CloudTrail (https://docs.aws.amazon.com/IAM/latest/UserGuide/cloudtrail-integration.html) +// successful ones. This includes all attempts that were made using the Amazon +// Web Services Management Console, the Amazon Web Services API through any +// of the SDKs, or any of the command line tools. An unexpected entry in the +// service last accessed data does not mean that an account has been compromised, +// because the request might have been denied. Refer to your CloudTrail logs +// as the authoritative source for information about all API calls and whether +// they were successful or denied access. For more information, see Logging +// IAM events with CloudTrail (https://docs.aws.amazon.com/IAM/latest/UserGuide/cloudtrail-integration.html) // in the IAM User Guide. // // This operation returns a JobId. Use this parameter in the GetOrganizationsAccessReport @@ -5417,13 +5427,13 @@ func (c *IAM) GenerateServiceLastAccessedDetailsRequest(input *GenerateServiceLa // // The service last accessed data includes all attempts to access an Amazon // Web Services API, not just the successful ones. This includes all attempts -// that were made using the Management Console, the Amazon Web Services API -// through any of the SDKs, or any of the command line tools. An unexpected -// entry in the service last accessed data does not mean that your account has -// been compromised, because the request might have been denied. Refer to your -// CloudTrail logs as the authoritative source for information about all API -// calls and whether they were successful or denied access. For more information, -// see Logging IAM events with CloudTrail (https://docs.aws.amazon.com/IAM/latest/UserGuide/cloudtrail-integration.html) +// that were made using the Amazon Web Services Management Console, the Amazon +// Web Services API through any of the SDKs, or any of the command line tools. +// An unexpected entry in the service last accessed data does not mean that +// your account has been compromised, because the request might have been denied. +// Refer to your CloudTrail logs as the authoritative source for information +// about all API calls and whether they were successful or denied access. For +// more information, see Logging IAM events with CloudTrail (https://docs.aws.amazon.com/IAM/latest/UserGuide/cloudtrail-integration.html) // in the IAM User Guide. // // The GenerateServiceLastAccessedDetails operation returns a JobId. Use this @@ -5777,10 +5787,10 @@ func (c *IAM) GetAccountPasswordPolicyRequest(input *GetAccountPasswordPolicyInp // GetAccountPasswordPolicy API operation for AWS Identity and Access Management. // -// Retrieves the password policy for the account. This tells you the complexity -// requirements and mandatory rotation periods for the IAM user passwords in -// your account. For more information about using a password policy, see Managing -// an IAM password policy (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_ManagingPasswordPolicies.html). +// Retrieves the password policy for the Amazon Web Services account. This tells +// you the complexity requirements and mandatory rotation periods for the IAM +// user passwords in your account. For more information about using a password +// policy, see Managing an IAM password policy (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_ManagingPasswordPolicies.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 @@ -6138,8 +6148,8 @@ func (c *IAM) GetCredentialReportRequest(input *GetCredentialReportInput) (req * // GetCredentialReport API operation for AWS Identity and Access Management. // -// Retrieves a credential report for the account. For more information about -// the credential report, see Getting credential reports (https://docs.aws.amazon.com/IAM/latest/UserGuide/credential-reports.html) +// Retrieves a credential report for the Amazon Web Services account. For more +// information about the credential report, see Getting credential reports (https://docs.aws.amazon.com/IAM/latest/UserGuide/credential-reports.html) // in the IAM User Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -6565,18 +6575,18 @@ func (c *IAM) GetLoginProfileRequest(input *GetLoginProfileInput) (req *request. // GetLoginProfile API operation for AWS Identity and Access Management. // // Retrieves the user name for the specified IAM user. A login profile is created -// when you create a password for the user to access the Management Console. -// If the user does not exist or does not have a password, the operation returns -// a 404 (NoSuchEntity) error. +// when you create a password for the user to access the Amazon Web Services +// Management Console. If the user does not exist or does not have a password, +// the operation returns a 404 (NoSuchEntity) error. // // If you create an IAM user with access to the console, the CreateDate reflects // the date you created the initial password for the user. // // If you create an IAM user with programmatic access, and then later add a -// password for the user to access the Management Console, the CreateDate reflects -// the initial password creation date. A user with programmatic access does -// not have a login profile unless you create a password for the user to access -// the Management Console. +// password for the user to access the Amazon Web Services Management Console, +// the CreateDate reflects the initial password creation date. A user with programmatic +// access does not have a login profile unless you create a password for the +// user to access the Amazon Web Services Management Console. // // 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 @@ -8054,12 +8064,13 @@ func (c *IAM) ListAccessKeysRequest(input *ListAccessKeysInput) (req *request.Re // // If the UserName field is not specified, the user name is determined implicitly // based on the Amazon Web Services access key ID used to sign the request. -// This operation works for access keys under the account. Consequently, you -// can use this operation to manage account root user credentials even if the -// account has no associated users. +// This operation works for access keys under the Amazon Web Services account. +// Consequently, you can use this operation to manage Amazon Web Services account +// root user credentials even if the Amazon Web Services account has no associated +// users. // -// To ensure the security of your account, the secret access key is accessible -// only during key and user creation. +// To ensure the security of your Amazon Web Services account, the secret access +// key is accessible only during key and user creation. // // 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 @@ -8201,10 +8212,11 @@ func (c *IAM) ListAccountAliasesRequest(input *ListAccountAliasesInput) (req *re // ListAccountAliases API operation for AWS Identity and Access Management. // -// Lists the account alias associated with the account (Note: you can have only -// one). For information about using an account alias, see Using an alias for -// your account ID (https://docs.aws.amazon.com/IAM/latest/UserGuide/AccountAlias.html) -// in the IAM User Guide. +// Lists the account alias associated with the Amazon Web Services account (Note: +// you can have only one). For information about using an Amazon Web Services +// account alias, see Using an alias for your Amazon Web Services account ID +// (https://docs.aws.amazon.com/IAM/latest/UserGuide/AccountAlias.html) in the +// IAM User Guide. // // 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 @@ -10111,7 +10123,7 @@ func (c *IAM) ListOpenIDConnectProvidersRequest(input *ListOpenIDConnectProvider // ListOpenIDConnectProviders API operation for AWS Identity and Access Management. // // Lists information about the IAM OpenID Connect (OIDC) provider resource objects -// defined in the account. +// defined in the Amazon Web Services account. // // IAM resource-listing operations return a subset of the available attributes // for the resource. For example, this operation does not return tags, even @@ -10202,9 +10214,9 @@ func (c *IAM) ListPoliciesRequest(input *ListPoliciesInput) (req *request.Reques // ListPolicies API operation for AWS Identity and Access Management. // -// Lists all the managed policies that are available in your account, including -// your own customer-defined managed policies and all Amazon Web Services managed -// policies. +// Lists all the managed policies that are available in your Amazon Web Services +// account, including your own customer-defined managed policies and all Amazon +// Web Services managed policies. // // You can filter the list of policies that is returned using the optional OnlyAttached, // Scope, and PathPrefix parameters. For example, to list only the customer @@ -11771,9 +11783,10 @@ func (c *IAM) ListSigningCertificatesRequest(input *ListSigningCertificatesInput // // If the UserName field is not specified, the user name is determined implicitly // based on the Amazon Web Services access key ID used to sign the request for -// this operation. This operation works for access keys under the account. Consequently, -// you can use this operation to manage account root user credentials even if -// the account has no associated users. +// this operation. This operation works for access keys under the Amazon Web +// Services account. Consequently, you can use this operation to manage Amazon +// Web Services account root user credentials even if the Amazon Web Services +// account has no associated users. // // 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 @@ -12212,8 +12225,8 @@ func (c *IAM) ListUsersRequest(input *ListUsersInput) (req *request.Request, out // ListUsers API operation for AWS Identity and Access Management. // // Lists the IAM users that have the specified path prefix. If no path prefix -// is specified, the operation returns all users in the account. If there are -// none, the operation returns an empty list. +// is specified, the operation returns all users in the Amazon Web Services +// account. If there are none, the operation returns an empty list. // // IAM resource-listing operations return a subset of the available attributes // for the resource. For example, this operation does not return tags, even @@ -12358,10 +12371,10 @@ func (c *IAM) ListVirtualMFADevicesRequest(input *ListVirtualMFADevicesInput) (r // ListVirtualMFADevices API operation for AWS Identity and Access Management. // -// Lists the virtual MFA devices defined in the account by assignment status. -// If you do not specify an assignment status, the operation returns a list -// of all virtual MFA devices. Assignment status can be Assigned, Unassigned, -// or Any. +// Lists the virtual MFA devices defined in the Amazon Web Services account +// by assignment status. If you do not specify an assignment status, the operation +// returns a list of all virtual MFA devices. Assignment status can be Assigned, +// Unassigned, or Any. // // IAM resource-listing operations return a subset of the available attributes // for the resource. For example, this operation does not return tags, even @@ -13626,7 +13639,7 @@ func (c *IAM) SetSecurityTokenServicePreferencesRequest(input *SetSecurityTokenS // SetSecurityTokenServicePreferences API operation for AWS Identity and Access Management. // // Sets the specified version of the global endpoint token as the token version -// used for the account. +// used for the Amazon Web Services account. // // By default, Security Token Service (STS) is available as a global service, // and all STS requests go to a single endpoint at https://sts.amazonaws.com. @@ -13638,12 +13651,12 @@ func (c *IAM) SetSecurityTokenServicePreferencesRequest(input *SetSecurityTokenS // // If you make an STS call to the global endpoint, the resulting session tokens // might be valid in some Regions but not others. It depends on the version -// that is set in this operation. Version 1 tokens are valid only in Regions -// that are available by default. These tokens do not work in manually enabled -// Regions, such as Asia Pacific (Hong Kong). Version 2 tokens are valid in -// all Regions. However, version 2 tokens are longer and might affect systems -// where you temporarily store tokens. For information, see Activating and deactivating -// STS in an Region (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html) +// that is set in this operation. Version 1 tokens are valid only in Amazon +// Web Services Regions that are available by default. These tokens do not work +// in manually enabled Regions, such as Asia Pacific (Hong Kong). Version 2 +// tokens are valid in all Regions. However, version 2 tokens are longer and +// might affect systems where you temporarily store tokens. For information, +// see Activating and deactivating STS in an Amazon Web Services Region (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html) // in the IAM User Guide. // // To view the current session token version, see the GlobalEndpointTokenVersion @@ -15880,9 +15893,10 @@ func (c *IAM) UpdateAccessKeyRequest(input *UpdateAccessKeyInput) (req *request. // // If the UserName is not specified, the user name is determined implicitly // based on the Amazon Web Services access key ID used to sign the request. -// This operation works for access keys under the account. Consequently, you -// can use this operation to manage account root user credentials even if the -// account has no associated users. +// This operation works for access keys under the Amazon Web Services account. +// Consequently, you can use this operation to manage Amazon Web Services account +// root user credentials even if the Amazon Web Services account has no associated +// users. // // For information about rotating keys, see Managing keys and certificates (https://docs.aws.amazon.com/IAM/latest/UserGuide/ManagingCredentials.html) // in the IAM User Guide. @@ -15975,7 +15989,7 @@ func (c *IAM) UpdateAccountPasswordPolicyRequest(input *UpdateAccountPasswordPol // UpdateAccountPasswordPolicy API operation for AWS Identity and Access Management. // -// Updates the password policy settings for the account. +// Updates the password policy settings for the Amazon Web Services account. // // * This operation does not support partial updates. No parameters are required, // but if you do not specify a parameter, that parameter's value reverts @@ -16291,7 +16305,8 @@ func (c *IAM) UpdateLoginProfileRequest(input *UpdateLoginProfileInput) (req *re // Changes the password for the specified IAM user. You can use the CLI, the // Amazon Web Services API, or the Users page in the IAM console to change the // password for any IAM user. Use ChangePassword to change your own password -// in the My Security Credentials page in the Management Console. +// in the My Security Credentials page in the Amazon Web Services Management +// Console. // // For more information about modifying passwords, see Managing passwords (https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_ManagingLogins.html) // in the IAM User Guide. @@ -17076,9 +17091,10 @@ func (c *IAM) UpdateSigningCertificateRequest(input *UpdateSigningCertificateInp // // If the UserName field is not specified, the user name is determined implicitly // based on the Amazon Web Services access key ID used to sign the request. -// This operation works for access keys under the account. Consequently, you -// can use this operation to manage account root user credentials even if the -// account has no associated users. +// This operation works for access keys under the Amazon Web Services account. +// Consequently, you can use this operation to manage Amazon Web Services account +// root user credentials even if the Amazon Web Services account has no associated +// users. // // 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 @@ -17386,9 +17402,9 @@ func (c *IAM) UploadServerCertificateRequest(input *UploadServerCertificateInput // UploadServerCertificate API operation for AWS Identity and Access Management. // -// Uploads a server certificate entity for the account. The server certificate -// entity includes a public key certificate, a private key, and an optional -// certificate chain, which should all be PEM-encoded. +// Uploads a server certificate entity for the Amazon Web Services account. +// The server certificate entity includes a public key certificate, a private +// key, and an optional certificate chain, which should all be PEM-encoded. // // We recommend that you use Certificate Manager (https://docs.aws.amazon.com/acm/) // to provision, manage, and deploy your server certificates. With ACM you can @@ -17530,9 +17546,10 @@ func (c *IAM) UploadSigningCertificateRequest(input *UploadSigningCertificateInp // // If the UserName is not specified, the IAM user name is determined implicitly // based on the Amazon Web Services access key ID used to sign the request. -// This operation works for access keys under the account. Consequently, you -// can use this operation to manage account root user credentials even if the -// account has no associated users. +// This operation works for access keys under the Amazon Web Services account. +// Consequently, you can use this operation to manage Amazon Web Services account +// root user credentials even if the Amazon Web Services account has no associated +// users. // // Because the body of an X.509 certificate can be large, you should use POST // rather than GET when calling UploadSigningCertificate. For information about @@ -17821,8 +17838,8 @@ type AccessKeyLastUsed struct { // LastUsedDate is a required field LastUsedDate *time.Time `type:"timestamp" required:"true"` - // The Region where this access key was most recently used. The value for this - // field is "N/A" in the following situations: + // The Amazon Web Services Region where this access key was most recently used. + // The value for this field is "N/A" in the following situations: // // * The user does not have an access key. // @@ -17831,8 +17848,9 @@ type AccessKeyLastUsed struct { // // * There is no sign-in data associated with the user. // - // For more information about Regions, see Regions and endpoints (https://docs.aws.amazon.com/general/latest/gr/rande.html) - // in the Amazon Web Services General Reference. + // For more information about Amazon Web Services Regions, see Regions and endpoints + // (https://docs.aws.amazon.com/general/latest/gr/rande.html) in the Amazon + // Web Services General Reference. // // Region is a required field Region *string `type:"string" required:"true"` @@ -18626,17 +18644,17 @@ func (s *AttachedPolicy) SetPolicyName(v string) *AttachedPolicy { type ChangePasswordInput struct { _ struct{} `type:"structure"` - // The new password. The new password must conform to the account's password - // policy, if one exists. + // The new password. The new password must conform to the Amazon Web Services + // account's password policy, if one exists. // // The regex pattern (http://wikipedia.org/wiki/regex) that is used to validate // this parameter is a string of characters. That string can include almost // any printable ASCII character from the space (\u0020) through the end of // the ASCII character range (\u00FF). You can also include the tab (\u0009), // line feed (\u000A), and carriage return (\u000D) characters. Any of these - // characters are valid in a password. However, many tools, such as the Management - // Console, might restrict the ability to type certain characters because they - // have special meaning within that tool. + // characters are valid in a password. However, many tools, such as the Amazon + // Web Services Management Console, might restrict the ability to type certain + // characters because they have special meaning within that tool. // // NewPassword is a sensitive parameter and its value will be // replaced with "sensitive" in string returned by ChangePasswordInput's @@ -19217,9 +19235,9 @@ type CreateLoginProfileInput struct { // any printable ASCII character from the space (\u0020) through the end of // the ASCII character range (\u00FF). You can also include the tab (\u0009), // line feed (\u000A), and carriage return (\u000D) characters. Any of these - // characters are valid in a password. However, many tools, such as the Management - // Console, might restrict the ability to type certain characters because they - // have special meaning within that tool. + // characters are valid in a password. However, many tools, such as the Amazon + // Web Services Management Console, might restrict the ability to type certain + // characters because they have special meaning within that tool. // // Password is a sensitive parameter and its value will be // replaced with "sensitive" in string returned by CreateLoginProfileInput's @@ -19337,10 +19355,10 @@ func (s *CreateLoginProfileOutput) SetLoginProfile(v *LoginProfile) *CreateLogin type CreateOpenIDConnectProviderInput struct { _ struct{} `type:"structure"` - // A list of client IDs (also known as audiences). When a mobile or web app - // registers with an OpenID Connect provider, they establish a value that identifies - // the application. (This is the value that's sent as the client_id parameter - // on OAuth requests.) + // Provides a list of client IDs, also known as audiences. When a mobile or + // web app registers with an OpenID Connect provider, they establish a value + // that identifies the application. This is the value that's sent as the client_id + // parameter on OAuth requests. // // You can register multiple client IDs with the same provider. For example, // you might have multiple applications that use the same OIDC provider. You @@ -19375,8 +19393,8 @@ type CreateOpenIDConnectProviderInput struct { // In that case, the thumbprint string would be the hex-encoded SHA-1 hash value // of the certificate used by https://keys.server.example.com. // - // For more information about obtaining the OIDC provider's thumbprint, see - // Obtaining the thumbprint for an OpenID Connect provider (https://docs.aws.amazon.com/IAM/latest/UserGuide/identity-providers-oidc-obtain-thumbprint.html) + // For more information about obtaining the OIDC provider thumbprint, see Obtaining + // the thumbprint for an OpenID Connect provider (https://docs.aws.amazon.com/IAM/latest/UserGuide/identity-providers-oidc-obtain-thumbprint.html) // in the IAM User Guide. // // ThumbprintList is a required field @@ -19386,11 +19404,12 @@ type CreateOpenIDConnectProviderInput struct { // correspond to the iss claim in the provider's OpenID Connect ID tokens. Per // the OIDC standard, path components are allowed but query parameters are not. // Typically the URL consists of only a hostname, like https://server.example.org - // or https://example.com. + // or https://example.com. The URL should not contain a port number. // - // You cannot register the same provider multiple times in a single account. - // If you try to submit a URL that has already been used for an OpenID Connect - // provider in the account, you will get an error. + // You cannot register the same provider multiple times in a single Amazon Web + // Services account. If you try to submit a URL that has already been used for + // an OpenID Connect provider in the Amazon Web Services account, you will get + // an error. // // Url is a required field Url *string `min:"1" type:"string" required:"true"` @@ -19538,6 +19557,8 @@ type CreatePolicyInput struct { // can contain any ASCII character from the ! (\u0021) through the DEL character // (\u007F), including most punctuation characters, digits, and upper and lowercased // letters. + // + // You cannot use an asterisk (*) in the path name. Path *string `min:"1" type:"string"` // The JSON policy document that you want to use as the content for the new @@ -24891,7 +24912,7 @@ type GetOpenIDConnectProviderOutput struct { ClientIDList []*string `type:"list"` // The date and time when the IAM OIDC provider resource object was created - // in the account. + // in the Amazon Web Services account. CreateDate *time.Time `type:"timestamp"` // A list of tags that are attached to the specified IAM OIDC provider. The @@ -29283,7 +29304,8 @@ func (s ListOpenIDConnectProvidersInput) GoString() string { type ListOpenIDConnectProvidersOutput struct { _ struct{} `type:"structure"` - // The list of IAM OIDC provider resource objects defined in the account. + // The list of IAM OIDC provider resource objects defined in the Amazon Web + // Services account. OpenIDConnectProviderList []*OpenIDConnectProviderListEntry `type:"list"` } @@ -29562,7 +29584,8 @@ type ListPoliciesInput struct { // The scope to use for filtering the results. // // To list only Amazon Web Services managed policies, set Scope to AWS. To list - // only the customer managed policies in your account, set Scope to Local. + // only the customer managed policies in your Amazon Web Services account, set + // Scope to Local. // // This parameter is optional. If it is not included, or if it is set to All, // all policies are returned. @@ -31893,8 +31916,8 @@ type LoginProfile struct { // Specifies whether the user is required to set a new password on next sign-in. PasswordResetRequired *bool `type:"boolean"` - // The name of the user, which can be used for signing in to the Management - // Console. + // The name of the user, which can be used for signing in to the Amazon Web + // Services Management Console. // // UserName is a required field UserName *string `min:"1" type:"string" required:"true"` @@ -34504,7 +34527,7 @@ type RoleLastUsed struct { // in the IAM User Guide. LastUsedDate *time.Time `type:"timestamp"` - // The name of the Region in which the role was last used. + // The name of the Amazon Web Services Region in which the role was last used. Region *string `type:"string"` } @@ -35386,12 +35409,13 @@ type SetSecurityTokenServicePreferencesInput struct { _ struct{} `type:"structure"` // The version of the global endpoint token. Version 1 tokens are valid only - // in Regions that are available by default. These tokens do not work in manually - // enabled Regions, such as Asia Pacific (Hong Kong). Version 2 tokens are valid - // in all Regions. However, version 2 tokens are longer and might affect systems - // where you temporarily store tokens. + // in Amazon Web Services Regions that are available by default. These tokens + // do not work in manually enabled Regions, such as Asia Pacific (Hong Kong). + // Version 2 tokens are valid in all Regions. However, version 2 tokens are + // longer and might affect systems where you temporarily store tokens. // - // For information, see Activating and deactivating STS in an Region (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html) + // For information, see Activating and deactivating STS in an Amazon Web Services + // Region (https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_enable-regions.html) // in the IAM User Guide. // // GlobalEndpointTokenVersion is a required field @@ -35684,15 +35708,15 @@ type SimulateCustomPolicyInput struct { // subnet, volume ResourceHandlingOption *string `min:"1" type:"string"` - // An ARN representing the account ID that specifies the owner of any simulated - // resource that does not identify its owner in the resource ARN. Examples of - // resource ARNs include an S3 bucket or object. If ResourceOwner is specified, - // it is also used as the account owner of any ResourcePolicy included in the - // simulation. If the ResourceOwner parameter is not specified, then the owner - // of the resources and the resource policy defaults to the account of the identity - // provided in CallerArn. This parameter is required only if you specify a resource-based - // policy and account that owns the resource is different from the account that - // owns the simulated calling user CallerArn. + // An ARN representing the Amazon Web Services account ID that specifies the + // owner of any simulated resource that does not identify its owner in the resource + // ARN. Examples of resource ARNs include an S3 bucket or object. If ResourceOwner + // is specified, it is also used as the account owner of any ResourcePolicy + // included in the simulation. If the ResourceOwner parameter is not specified, + // then the owner of the resources and the resource policy defaults to the account + // of the identity provided in CallerArn. This parameter is required only if + // you specify a resource-based policy and account that owns the resource is + // different from the account that owns the simulated calling user CallerArn. // // The ARN for an account uses the following syntax: arn:aws:iam::AWS-account-ID:root. // For example, to represent the account with the 112233445566 ID, use the following @@ -36067,13 +36091,13 @@ type SimulatePrincipalPolicyInput struct { // subnet, volume ResourceHandlingOption *string `min:"1" type:"string"` - // An account ID that specifies the owner of any simulated resource that does - // not identify its owner in the resource ARN. Examples of resource ARNs include - // an S3 bucket or object. If ResourceOwner is specified, it is also used as - // the account owner of any ResourcePolicy included in the simulation. If the - // ResourceOwner parameter is not specified, then the owner of the resources - // and the resource policy defaults to the account of the identity provided - // in CallerArn. This parameter is required only if you specify a resource-based + // An Amazon Web Services account ID that specifies the owner of any simulated + // resource that does not identify its owner in the resource ARN. Examples of + // resource ARNs include an S3 bucket or object. If ResourceOwner is specified, + // it is also used as the account owner of any ResourcePolicy included in the + // simulation. If the ResourceOwner parameter is not specified, then the owner + // of the resources and the resource policy defaults to the account of the identity + // provided in CallerArn. This parameter is required only if you specify a resource-based // policy and account that owns the resource is different from the account that // owns the simulated calling user CallerArn. ResourceOwner *string `min:"1" type:"string"` @@ -38090,9 +38114,9 @@ func (s UpdateAccessKeyOutput) GoString() string { type UpdateAccountPasswordPolicyInput struct { _ struct{} `type:"structure"` - // Allows all IAM users in your account to use the Management Console to change - // their own passwords. For more information, see Letting IAM users change their - // own passwords (https://docs.aws.amazon.com/IAM/latest/UserGuide/HowToPwdIAMUser.html) + // Allows all IAM users in your account to use the Amazon Web Services Management + // Console to change their own passwords. For more information, see Letting + // IAM users change their own passwords (https://docs.aws.amazon.com/IAM/latest/UserGuide/HowToPwdIAMUser.html) // in the IAM User Guide. // // If you do not specify a value for this parameter, then the operation uses @@ -38514,7 +38538,8 @@ type UpdateLoginProfileInput struct { // return (\u000D) // // However, the format can be further restricted by the account administrator - // by setting a password policy on the account. For more information, see UpdateAccountPasswordPolicy. + // by setting a password policy on the Amazon Web Services account. For more + // information, see UpdateAccountPasswordPolicy. // // Password is a sensitive parameter and its value will be // replaced with "sensitive" in string returned by UpdateLoginProfileInput's diff --git a/service/imagebuilder/api.go b/service/imagebuilder/api.go index 84f8fc086d6..c0e36ba4cf7 100644 --- a/service/imagebuilder/api.go +++ b/service/imagebuilder/api.go @@ -1258,7 +1258,19 @@ func (c *Imagebuilder) DeleteImageRequest(input *DeleteImageInput) (req *request // DeleteImage API operation for EC2 Image Builder. // -// Deletes an image. +// Deletes an Image Builder image resource. This does not delete any EC2 AMIs +// or ECR container images that are created during the image build process. +// You must clean those up separately, using the appropriate Amazon EC2 or Amazon +// ECR console actions, or API or CLI commands. +// +// * To deregister an EC2 Linux AMI, see Deregister your Linux AMI (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/deregister-ami.html) +// in the Amazon EC2 User Guide . +// +// * To deregister an EC2 Windows AMI, see Deregister your Windows AMI (https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/deregister-ami.html) +// in the Amazon EC2 Windows Guide . +// +// * To delete a container image from Amazon ECR, see Deleting an image (https://docs.aws.amazon.com/https:/docs.aws.amazon.comAmazonECR/latest/userguide/delete_image.html) +// in the Amazon ECR User Guide. // // 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 @@ -2828,12 +2840,10 @@ func (c *Imagebuilder) ListComponentBuildVersionsRequest(input *ListComponentBui // The semantic version has four nodes: ../. You // can assign values for the first three, and can filter on all of them. // -// Filtering: When you retrieve or reference a resource with a semantic version, -// you can use wildcards (x) to filter your results. When you use a wildcard -// in any node, all nodes to the right of the first wildcard must also be wildcards. -// For example, specifying "1.2.x", or "1.x.x" works to filter list results, -// but neither "1.x.2", nor "x.2.x" will work. You do not have to specify the -// build - Image Builder automatically uses a wildcard for that, if applicable. +// Filtering: With semantic versioning, you have the flexibility to use wildcards +// (x) to specify the most recent versions or nodes when selecting the source +// image or components for your recipe. When you use a wildcard in any node, +// all nodes to the right of the first wildcard must also be wildcards. // // 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 @@ -2995,12 +3005,10 @@ func (c *Imagebuilder) ListComponentsRequest(input *ListComponentsInput) (req *r // The semantic version has four nodes: ../. You // can assign values for the first three, and can filter on all of them. // -// Filtering: When you retrieve or reference a resource with a semantic version, -// you can use wildcards (x) to filter your results. When you use a wildcard -// in any node, all nodes to the right of the first wildcard must also be wildcards. -// For example, specifying "1.2.x", or "1.x.x" works to filter list results, -// but neither "1.x.2", nor "x.2.x" will work. You do not have to specify the -// build - Image Builder automatically uses a wildcard for that, if applicable. +// Filtering: With semantic versioning, you have the flexibility to use wildcards +// (x) to specify the most recent versions or nodes when selecting the source +// image or components for your recipe. When you use a wildcard in any node, +// all nodes to the right of the first wildcard must also be wildcards. // // 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 @@ -3629,7 +3637,7 @@ func (c *Imagebuilder) ListImagePackagesRequest(input *ListImagePackagesInput) ( // ListImagePackages API operation for EC2 Image Builder. // // List the Packages that are associated with an Image Build Version, as determined -// by Amazon EC2 Systems Manager Inventory at build time. +// by Amazon Web Services Systems Manager Inventory at build time. // // 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 @@ -5647,22 +5655,22 @@ func (c *Imagebuilder) UpdateInfrastructureConfigurationWithContext(ctx aws.Cont // In addition to your infrastruction configuration, these settings provide // an extra layer of control over your build instances. For instances where -// Image Builder installs the SSM agent, you can choose whether to keep it for -// the AMI that you create. You can also specify commands to run on launch for -// all of your build instances. +// Image Builder installs the Systems Manager agent, you can choose whether +// to keep it for the AMI that you create. You can also specify commands to +// run on launch for all of your build instances. type AdditionalInstanceConfiguration struct { _ struct{} `type:"structure"` - // Contains settings for the SSM agent on your build instance. + // Contains settings for the Systems Manager agent on your build instance. SystemsManagerAgent *SystemsManagerAgent `locationName:"systemsManagerAgent" type:"structure"` // Use this property to provide commands or a command script to run when you // launch your build instance. // // The userDataOverride property replaces any commands that Image Builder might - // have added to ensure that SSM is installed on your Linux build instance. - // If you override the user data, make sure that you add commands to install - // SSM, if it is not pre-installed on your source image. + // have added to ensure that Systems Manager is installed on your Linux build + // instance. If you override the user data, make sure that you add commands + // to install Systems Manager, if it is not pre-installed on your source image. UserDataOverride *string `locationName:"userDataOverride" min:"1" type:"string"` } @@ -6171,6 +6179,10 @@ type Component struct { // The platform of the component. Platform *string `locationName:"platform" type:"string" enum:"Platform"` + // Describes the current status of the component. This is used for components + // that are no longer active. + State *ComponentState `locationName:"state" type:"structure"` + // The operating system (OS) version supported by the component. If the OS information // is available, a prefix match is performed against the parent image OS version // during image recipe creation. @@ -6271,6 +6283,12 @@ func (s *Component) SetPlatform(v string) *Component { return s } +// SetState sets the State field's value. +func (s *Component) SetState(v *ComponentState) *Component { + s.State = v + return s +} + // SetSupportedOsVersions sets the SupportedOsVersions field's value. func (s *Component) SetSupportedOsVersions(v []*string) *Component { s.SupportedOsVersions = v @@ -6494,6 +6512,48 @@ func (s *ComponentParameterDetail) SetType(v string) *ComponentParameterDetail { return s } +// A group of fields that describe the current status of components that are +// no longer active. +type ComponentState struct { + _ struct{} `type:"structure"` + + // Describes how or why the component changed state. + Reason *string `locationName:"reason" min:"1" type:"string"` + + // The current state of the component. + Status *string `locationName:"status" type:"string" enum:"ComponentStatus"` +} + +// 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 ComponentState) 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 ComponentState) GoString() string { + return s.String() +} + +// SetReason sets the Reason field's value. +func (s *ComponentState) SetReason(v string) *ComponentState { + s.Reason = &v + return s +} + +// SetStatus sets the Status field's value. +func (s *ComponentState) SetStatus(v string) *ComponentState { + s.Status = &v + return s +} + // A high-level summary of a component. type ComponentSummary struct { _ struct{} `type:"structure"` @@ -6519,6 +6579,9 @@ type ComponentSummary struct { // The platform of the component. Platform *string `locationName:"platform" type:"string" enum:"Platform"` + // Describes the current status of the component. + State *ComponentState `locationName:"state" type:"structure"` + // The operating system (OS) version supported by the component. If the OS information // is available, a prefix match is performed against the parent image OS version // during image recipe creation. @@ -6595,6 +6658,12 @@ func (s *ComponentSummary) SetPlatform(v string) *ComponentSummary { return s } +// SetState sets the State field's value. +func (s *ComponentSummary) SetState(v *ComponentState) *ComponentSummary { + s.State = v + return s +} + // SetSupportedOsVersions sets the SupportedOsVersions field's value. func (s *ComponentSummary) SetSupportedOsVersions(v []*string) *ComponentSummary { s.SupportedOsVersions = v @@ -6670,19 +6739,17 @@ type ComponentVersion struct { // // Assignment: For the first three nodes you can assign any positive integer // value, including zero, with an upper limit of 2^30-1, or 1073741823 for each - // node. Image Builder automatically assigns the build number, and that is not - // open for updates. + // node. Image Builder automatically assigns the build number to the fourth + // node. // // Patterns: You can use any numeric pattern that adheres to the assignment // requirements for the nodes that you can assign. For example, you might choose // a software version pattern, such as 1.0.0, or a date, such as 2021.01.01. // - // Filtering: When you retrieve or reference a resource with a semantic version, - // you can use wildcards (x) to filter your results. When you use a wildcard - // in any node, all nodes to the right of the first wildcard must also be wildcards. - // For example, specifying "1.2.x", or "1.x.x" works to filter list results, - // but neither "1.x.2", nor "x.2.x" will work. You do not have to specify the - // build - Image Builder automatically uses a wildcard for that, if applicable. + // Filtering: With semantic versioning, you have the flexibility to use wildcards + // (x) to specify the most recent versions or nodes when selecting the source + // image or components for your recipe. When you use a wildcard in any node, + // all nodes to the right of the first wildcard must also be wildcards. Version *string `locationName:"version" type:"string"` } @@ -6948,19 +7015,17 @@ type ContainerRecipe struct { // // Assignment: For the first three nodes you can assign any positive integer // value, including zero, with an upper limit of 2^30-1, or 1073741823 for each - // node. Image Builder automatically assigns the build number, and that is not - // open for updates. + // node. Image Builder automatically assigns the build number to the fourth + // node. // // Patterns: You can use any numeric pattern that adheres to the assignment // requirements for the nodes that you can assign. For example, you might choose // a software version pattern, such as 1.0.0, or a date, such as 2021.01.01. // - // Filtering: When you retrieve or reference a resource with a semantic version, - // you can use wildcards (x) to filter your results. When you use a wildcard - // in any node, all nodes to the right of the first wildcard must also be wildcards. - // For example, specifying "1.2.x", or "1.x.x" works to filter list results, - // but neither "1.x.2", nor "x.2.x" will work. You do not have to specify the - // build - Image Builder automatically uses a wildcard for that, if applicable. + // Filtering: With semantic versioning, you have the flexibility to use wildcards + // (x) to specify the most recent versions or nodes when selecting the source + // image or components for your recipe. When you use a wildcard in any node, + // all nodes to the right of the first wildcard must also be wildcards. Version *string `locationName:"version" type:"string"` // The working directory for use during build and test workflows. @@ -7221,8 +7286,8 @@ type CreateComponentInput struct { // // Assignment: For the first three nodes you can assign any positive integer // value, including zero, with an upper limit of 2^30-1, or 1073741823 for each - // node. Image Builder automatically assigns the build number, and that is not - // open for updates. + // node. Image Builder automatically assigns the build number to the fourth + // node. // // Patterns: You can use any numeric pattern that adheres to the assignment // requirements for the nodes that you can assign. For example, you might choose @@ -7477,8 +7542,8 @@ type CreateContainerRecipeInput struct { // // Assignment: For the first three nodes you can assign any positive integer // value, including zero, with an upper limit of 2^30-1, or 1073741823 for each - // node. Image Builder automatically assigns the build number, and that is not - // open for updates. + // node. Image Builder automatically assigns the build number to the fourth + // node. // // Patterns: You can use any numeric pattern that adheres to the assignment // requirements for the nodes that you can assign. For example, you might choose @@ -8340,8 +8405,8 @@ type CreateImageRecipeInput struct { // // Assignment: For the first three nodes you can assign any positive integer // value, including zero, with an upper limit of 2^30-1, or 1073741823 for each - // node. Image Builder automatically assigns the build number, and that is not - // open for updates. + // node. Image Builder automatically assigns the build number to the fourth + // node. // // Patterns: You can use any numeric pattern that adheres to the assignment // requirements for the nodes that you can assign. For example, you might choose @@ -8559,18 +8624,28 @@ type CreateInfrastructureConfigurationInput struct { // The description of the infrastructure configuration. Description *string `locationName:"description" min:"1" type:"string"` + // The instance metadata options that you can set for the HTTP requests that + // pipeline builds use to launch EC2 build and test instances. + InstanceMetadataOptions *InstanceMetadataOptions `locationName:"instanceMetadataOptions" type:"structure"` + // The instance profile to associate with the instance used to customize your // Amazon EC2 AMI. // // InstanceProfileName is a required field InstanceProfileName *string `locationName:"instanceProfileName" min:"1" type:"string" required:"true"` - // The instance types of the infrastructure configuration. You can specify one - // or more instance types to use for this build. The service will pick one of - // these instance types based on availability. + // The instance metadata options that you can set for the HTTP requests that + // pipeline builds use to launch EC2 build and test instances. For more information + // about instance metadata options, see one of the following links: + // + // * Configure the instance metadata options (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html) + // in the Amazon EC2 User Guide for Linux instances. + // + // * Configure the instance metadata options (https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/configuring-instance-metadata-options.html) + // in the Amazon EC2 Windows Guide for Windows instances. InstanceTypes []*string `locationName:"instanceTypes" type:"list"` - // The key pair of the infrastructure configuration. This can be used to log + // The key pair of the infrastructure configuration. You can use this to log // on to and debug the instance used to create your image. KeyPair *string `locationName:"keyPair" min:"1" type:"string"` @@ -8653,6 +8728,11 @@ func (s *CreateInfrastructureConfigurationInput) Validate() error { if s.Tags != nil && len(s.Tags) < 1 { invalidParams.Add(request.NewErrParamMinLen("Tags", 1)) } + if s.InstanceMetadataOptions != nil { + if err := s.InstanceMetadataOptions.Validate(); err != nil { + invalidParams.AddNested("InstanceMetadataOptions", err.(request.ErrInvalidParams)) + } + } if s.Logging != nil { if err := s.Logging.Validate(); err != nil { invalidParams.AddNested("Logging", err.(request.ErrInvalidParams)) @@ -8677,6 +8757,12 @@ func (s *CreateInfrastructureConfigurationInput) SetDescription(v string) *Creat return s } +// SetInstanceMetadataOptions sets the InstanceMetadataOptions field's value. +func (s *CreateInfrastructureConfigurationInput) SetInstanceMetadataOptions(v *InstanceMetadataOptions) *CreateInfrastructureConfigurationInput { + s.InstanceMetadataOptions = v + return s +} + // SetInstanceProfileName sets the InstanceProfileName field's value. func (s *CreateInfrastructureConfigurationInput) SetInstanceProfileName(v string) *CreateInfrastructureConfigurationInput { s.InstanceProfileName = &v @@ -9055,7 +9141,7 @@ func (s *DeleteDistributionConfigurationOutput) SetRequestId(v string) *DeleteDi type DeleteImageInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the image to delete. + // The Amazon Resource Name (ARN) of the Image Builder image resource to delete. // // ImageBuildVersionArn is a required field ImageBuildVersionArn *string `location:"querystring" locationName:"imageBuildVersionArn" type:"string" required:"true"` @@ -9101,7 +9187,8 @@ func (s *DeleteImageInput) SetImageBuildVersionArn(v string) *DeleteImageInput { type DeleteImageOutput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the image that was deleted. + // The Amazon Resource Name (ARN) of the Image Builder image resource that was + // deleted. ImageBuildVersionArn *string `locationName:"imageBuildVersionArn" type:"string"` // The request ID that uniquely identifies this request. @@ -9715,6 +9802,9 @@ type EbsInstanceBlockDeviceSpecification struct { // The snapshot that defines the device contents. SnapshotId *string `locationName:"snapshotId" min:"1" type:"string"` + // For GP3 volumes only – The throughput in MiB/s that the volume supports. + Throughput *int64 `locationName:"throughput" min:"125" type:"integer"` + // Use to override the device's volume size. VolumeSize *int64 `locationName:"volumeSize" min:"1" type:"integer"` @@ -9752,6 +9842,9 @@ func (s *EbsInstanceBlockDeviceSpecification) Validate() error { if s.SnapshotId != nil && len(*s.SnapshotId) < 1 { invalidParams.Add(request.NewErrParamMinLen("SnapshotId", 1)) } + if s.Throughput != nil && *s.Throughput < 125 { + invalidParams.Add(request.NewErrParamMinValue("Throughput", 125)) + } if s.VolumeSize != nil && *s.VolumeSize < 1 { invalidParams.Add(request.NewErrParamMinValue("VolumeSize", 1)) } @@ -9792,6 +9885,12 @@ func (s *EbsInstanceBlockDeviceSpecification) SetSnapshotId(v string) *EbsInstan return s } +// SetThroughput sets the Throughput field's value. +func (s *EbsInstanceBlockDeviceSpecification) SetThroughput(v int64) *EbsInstanceBlockDeviceSpecification { + s.Throughput = &v + return s +} + // SetVolumeSize sets the VolumeSize field's value. func (s *EbsInstanceBlockDeviceSpecification) SetVolumeSize(v int64) *EbsInstanceBlockDeviceSpecification { s.VolumeSize = &v @@ -11023,19 +11122,17 @@ type Image struct { // // Assignment: For the first three nodes you can assign any positive integer // value, including zero, with an upper limit of 2^30-1, or 1073741823 for each - // node. Image Builder automatically assigns the build number, and that is not - // open for updates. + // node. Image Builder automatically assigns the build number to the fourth + // node. // // Patterns: You can use any numeric pattern that adheres to the assignment // requirements for the nodes that you can assign. For example, you might choose // a software version pattern, such as 1.0.0, or a date, such as 2021.01.01. // - // Filtering: When you retrieve or reference a resource with a semantic version, - // you can use wildcards (x) to filter your results. When you use a wildcard - // in any node, all nodes to the right of the first wildcard must also be wildcards. - // For example, specifying "1.2.x", or "1.x.x" works to filter list results, - // but neither "1.x.2", nor "x.2.x" will work. You do not have to specify the - // build - Image Builder automatically uses a wildcard for that, if applicable. + // Filtering: With semantic versioning, you have the flexibility to use wildcards + // (x) to specify the most recent versions or nodes when selecting the source + // image or components for your recipe. When you use a wildcard in any node, + // all nodes to the right of the first wildcard must also be wildcards. Version *string `locationName:"version" type:"string"` } @@ -11893,19 +11990,17 @@ type ImageVersion struct { // // Assignment: For the first three nodes you can assign any positive integer // value, including zero, with an upper limit of 2^30-1, or 1073741823 for each - // node. Image Builder automatically assigns the build number, and that is not - // open for updates. + // node. Image Builder automatically assigns the build number to the fourth + // node. // // Patterns: You can use any numeric pattern that adheres to the assignment // requirements for the nodes that you can assign. For example, you might choose // a software version pattern, such as 1.0.0, or a date, such as 2021.01.01. // - // Filtering: When you retrieve or reference a resource with a semantic version, - // you can use wildcards (x) to filter your results. When you use a wildcard - // in any node, all nodes to the right of the first wildcard must also be wildcards. - // For example, specifying "1.2.x", or "1.x.x" works to filter list results, - // but neither "1.x.2", nor "x.2.x" will work. You do not have to specify the - // build - Image Builder automatically uses a wildcard for that, if applicable. + // Filtering: With semantic versioning, you have the flexibility to use wildcards + // (x) to specify the most recent versions or nodes when selecting the source + // image or components for your recipe. When you use a wildcard in any node, + // all nodes to the right of the first wildcard must also be wildcards. Version *string `locationName:"version" type:"string"` } @@ -12017,12 +12112,10 @@ type ImportComponentInput struct { // The semantic version has four nodes: ../. You // can assign values for the first three, and can filter on all of them. // - // Filtering: When you retrieve or reference a resource with a semantic version, - // you can use wildcards (x) to filter your results. When you use a wildcard - // in any node, all nodes to the right of the first wildcard must also be wildcards. - // For example, specifying "1.2.x", or "1.x.x" works to filter list results, - // but neither "1.x.2", nor "x.2.x" will work. You do not have to specify the - // build - Image Builder automatically uses a wildcard for that, if applicable. + // Filtering: With semantic versioning, you have the flexibility to use wildcards + // (x) to specify the most recent versions or nodes when selecting the source + // image or components for your recipe. When you use a wildcard in any node, + // all nodes to the right of the first wildcard must also be wildcards. // // SemanticVersion is a required field SemanticVersion *string `locationName:"semanticVersion" type:"string" required:"true"` @@ -12241,6 +12334,9 @@ type InfrastructureConfiguration struct { // The description of the infrastructure configuration. Description *string `locationName:"description" min:"1" type:"string"` + // The instance metadata option settings for the infrastructure configuration. + InstanceMetadataOptions *InstanceMetadataOptions `locationName:"instanceMetadataOptions" type:"structure"` + // The instance profile of the infrastructure configuration. InstanceProfileName *string `locationName:"instanceProfileName" min:"1" type:"string"` @@ -12317,6 +12413,12 @@ func (s *InfrastructureConfiguration) SetDescription(v string) *InfrastructureCo return s } +// SetInstanceMetadataOptions sets the InstanceMetadataOptions field's value. +func (s *InfrastructureConfiguration) SetInstanceMetadataOptions(v *InstanceMetadataOptions) *InfrastructureConfiguration { + s.InstanceMetadataOptions = v + return s +} + // SetInstanceProfileName sets the InstanceProfileName field's value. func (s *InfrastructureConfiguration) SetInstanceProfileName(v string) *InfrastructureConfiguration { s.InstanceProfileName = &v @@ -12635,6 +12737,77 @@ func (s *InstanceConfiguration) SetImage(v string) *InstanceConfiguration { return s } +// The instance metadata options that apply to the HTTP requests that pipeline +// builds use to launch EC2 build and test instances. For more information about +// instance metadata options, see Configure the instance metadata options (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html) +// in the Amazon EC2 User Guide for Linux instances, or Configure the instance +// metadata options (https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/configuring-instance-metadata-options.html) +// in the Amazon EC2 Windows Guide for Windows instances. +type InstanceMetadataOptions struct { + _ struct{} `type:"structure"` + + // Limit the number of hops that an instance metadata request can traverse to + // reach its destination. + HttpPutResponseHopLimit *int64 `locationName:"httpPutResponseHopLimit" min:"1" type:"integer"` + + // Indicates whether a signed token header is required for instance metadata + // retrieval requests. The values affect the response as follows: + // + // * required – When you retrieve the IAM role credentials, version 2.0 + // credentials are returned in all cases. + // + // * optional – You can include a signed token header in your request to + // retrieve instance metadata, or you can leave it out. If you include it, + // version 2.0 credentials are returned for the IAM role. Otherwise, version + // 1.0 credentials are returned. + // + // The default setting is optional. + HttpTokens *string `locationName:"httpTokens" type:"string"` +} + +// 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 InstanceMetadataOptions) 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 InstanceMetadataOptions) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *InstanceMetadataOptions) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "InstanceMetadataOptions"} + if s.HttpPutResponseHopLimit != nil && *s.HttpPutResponseHopLimit < 1 { + invalidParams.Add(request.NewErrParamMinValue("HttpPutResponseHopLimit", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetHttpPutResponseHopLimit sets the HttpPutResponseHopLimit field's value. +func (s *InstanceMetadataOptions) SetHttpPutResponseHopLimit(v int64) *InstanceMetadataOptions { + s.HttpPutResponseHopLimit = &v + return s +} + +// SetHttpTokens sets the HttpTokens field's value. +func (s *InstanceMetadataOptions) SetHttpTokens(v string) *InstanceMetadataOptions { + s.HttpTokens = &v + return s +} + // You have provided an invalid pagination token in your request. type InvalidPaginationTokenException struct { _ struct{} `type:"structure"` @@ -14558,12 +14731,10 @@ type ListImagesOutput struct { // The semantic version has four nodes: ../. You // can assign values for the first three, and can filter on all of them. // - // Filtering: When you retrieve or reference a resource with a semantic version, - // you can use wildcards (x) to filter your results. When you use a wildcard - // in any node, all nodes to the right of the first wildcard must also be wildcards. - // For example, specifying "1.2.x", or "1.x.x" works to filter list results, - // but neither "1.x.2", nor "x.2.x" will work. You do not have to specify the - // build - Image Builder automatically uses a wildcard for that, if applicable. + // Filtering: With semantic versioning, you have the flexibility to use wildcards + // (x) to specify the most recent versions or nodes when selecting the source + // image or components for your recipe. When you use a wildcard in any node, + // all nodes to the right of the first wildcard must also be wildcards. ImageVersionList []*ImageVersion `locationName:"imageVersionList" type:"list"` // The next token used for paginated responses. When this is not empty, there @@ -16027,14 +16198,14 @@ func (s *StartImagePipelineExecutionOutput) SetRequestId(v string) *StartImagePi return s } -// Contains settings for the SSM agent on your build instance. +// Contains settings for the Systems Manager agent on your build instance. type SystemsManagerAgent struct { _ struct{} `type:"structure"` - // Controls whether the SSM agent is removed from your final build image, prior - // to creating the new AMI. If this is set to true, then the agent is removed - // from the final image. If it's set to false, then the agent is left in, so - // that it is included in the new AMI. The default value is false. + // Controls whether the Systems Manager agent is removed from your final build + // image, prior to creating the new AMI. If this is set to true, then the agent + // is removed from the final image. If it's set to false, then the agent is + // left in, so that it is included in the new AMI. The default value is false. UninstallAfterBuild *bool `locationName:"uninstallAfterBuild" type:"boolean"` } @@ -16676,6 +16847,17 @@ type UpdateInfrastructureConfigurationInput struct { // InfrastructureConfigurationArn is a required field InfrastructureConfigurationArn *string `locationName:"infrastructureConfigurationArn" type:"string" required:"true"` + // The instance metadata options that you can set for the HTTP requests that + // pipeline builds use to launch EC2 build and test instances. For more information + // about instance metadata options, see one of the following links: + // + // * Configure the instance metadata options (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-options.html) + // in the Amazon EC2 User Guide for Linux instances. + // + // * Configure the instance metadata options (https://docs.aws.amazon.com/AWSEC2/latest/WindowsGuide/configuring-instance-metadata-options.html) + // in the Amazon EC2 Windows Guide for Windows instances. + InstanceMetadataOptions *InstanceMetadataOptions `locationName:"instanceMetadataOptions" type:"structure"` + // The instance profile to associate with the instance used to customize your // Amazon EC2 AMI. // @@ -16687,7 +16869,7 @@ type UpdateInfrastructureConfigurationInput struct { // these instance types based on availability. InstanceTypes []*string `locationName:"instanceTypes" type:"list"` - // The key pair of the infrastructure configuration. This can be used to log + // The key pair of the infrastructure configuration. You can use this to log // on to and debug the instance used to create your image. KeyPair *string `locationName:"keyPair" min:"1" type:"string"` @@ -16759,6 +16941,11 @@ func (s *UpdateInfrastructureConfigurationInput) Validate() error { if s.SubnetId != nil && len(*s.SubnetId) < 1 { invalidParams.Add(request.NewErrParamMinLen("SubnetId", 1)) } + if s.InstanceMetadataOptions != nil { + if err := s.InstanceMetadataOptions.Validate(); err != nil { + invalidParams.AddNested("InstanceMetadataOptions", err.(request.ErrInvalidParams)) + } + } if s.Logging != nil { if err := s.Logging.Validate(); err != nil { invalidParams.AddNested("Logging", err.(request.ErrInvalidParams)) @@ -16789,6 +16976,12 @@ func (s *UpdateInfrastructureConfigurationInput) SetInfrastructureConfigurationA return s } +// SetInstanceMetadataOptions sets the InstanceMetadataOptions field's value. +func (s *UpdateInfrastructureConfigurationInput) SetInstanceMetadataOptions(v *InstanceMetadataOptions) *UpdateInfrastructureConfigurationInput { + s.InstanceMetadataOptions = v + return s +} + // SetInstanceProfileName sets the InstanceProfileName field's value. func (s *UpdateInfrastructureConfigurationInput) SetInstanceProfileName(v string) *UpdateInfrastructureConfigurationInput { s.InstanceProfileName = &v @@ -16905,6 +17098,18 @@ func ComponentFormat_Values() []string { } } +const ( + // ComponentStatusDeprecated is a ComponentStatus enum value + ComponentStatusDeprecated = "DEPRECATED" +) + +// ComponentStatus_Values returns all elements of the ComponentStatus enum +func ComponentStatus_Values() []string { + return []string{ + ComponentStatusDeprecated, + } +} + const ( // ComponentTypeBuild is a ComponentType enum value ComponentTypeBuild = "BUILD" diff --git a/service/lexmodelsv2/api.go b/service/lexmodelsv2/api.go index e9a39701ec1..1f482810d65 100644 --- a/service/lexmodelsv2/api.go +++ b/service/lexmodelsv2/api.go @@ -70,16 +70,26 @@ func (c *LexModelsV2) BuildBotLocaleRequest(input *BuildBotLocaleInput) (req *re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/BuildBotLocale func (c *LexModelsV2) BuildBotLocale(input *BuildBotLocaleInput) (*BuildBotLocaleOutput, error) { @@ -158,16 +168,26 @@ func (c *LexModelsV2) CreateBotRequest(input *CreateBotInput) (req *request.Requ // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/CreateBot func (c *LexModelsV2) CreateBot(input *CreateBotInput) (*CreateBotOutput, error) { @@ -251,16 +271,26 @@ func (c *LexModelsV2) CreateBotAliasRequest(input *CreateBotAliasInput) (req *re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/CreateBotAlias func (c *LexModelsV2) CreateBotAlias(input *CreateBotAliasInput) (*CreateBotAliasOutput, error) { @@ -342,16 +372,26 @@ func (c *LexModelsV2) CreateBotLocaleRequest(input *CreateBotLocaleInput) (req * // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/CreateBotLocale func (c *LexModelsV2) CreateBotLocale(input *CreateBotLocaleInput) (*CreateBotLocaleOutput, error) { @@ -435,16 +475,26 @@ func (c *LexModelsV2) CreateBotVersionRequest(input *CreateBotVersionInput) (req // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/CreateBotVersion func (c *LexModelsV2) CreateBotVersion(input *CreateBotVersionInput) (*CreateBotVersionOutput, error) { @@ -532,16 +582,26 @@ func (c *LexModelsV2) CreateExportRequest(input *CreateExportInput) (req *reques // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/CreateExport func (c *LexModelsV2) CreateExport(input *CreateExportInput) (*CreateExportOutput, error) { @@ -648,16 +708,26 @@ func (c *LexModelsV2) CreateIntentRequest(input *CreateIntentInput) (req *reques // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/CreateIntent func (c *LexModelsV2) CreateIntent(input *CreateIntentInput) (*CreateIntentOutput, error) { @@ -736,16 +806,25 @@ func (c *LexModelsV2) CreateResourcePolicyRequest(input *CreateResourcePolicyInp // // Returned Error Types: // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/CreateResourcePolicy func (c *LexModelsV2) CreateResourcePolicy(input *CreateResourcePolicyInput) (*CreateResourcePolicyOutput, error) { @@ -828,18 +907,30 @@ func (c *LexModelsV2) CreateResourcePolicyStatementRequest(input *CreateResource // // Returned Error Types: // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/CreateResourcePolicyStatement func (c *LexModelsV2) CreateResourcePolicyStatement(input *CreateResourcePolicyStatementInput) (*CreateResourcePolicyStatementOutput, error) { @@ -921,16 +1012,26 @@ func (c *LexModelsV2) CreateSlotRequest(input *CreateSlotInput) (req *request.Re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/CreateSlot func (c *LexModelsV2) CreateSlot(input *CreateSlotInput) (*CreateSlotOutput, error) { @@ -1012,16 +1113,26 @@ func (c *LexModelsV2) CreateSlotTypeRequest(input *CreateSlotTypeInput) (req *re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/CreateSlotType func (c *LexModelsV2) CreateSlotType(input *CreateSlotTypeInput) (*CreateSlotTypeOutput, error) { @@ -1101,14 +1212,23 @@ func (c *LexModelsV2) CreateUploadUrlRequest(input *CreateUploadUrlInput) (req * // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/CreateUploadUrl func (c *LexModelsV2) CreateUploadUrl(input *CreateUploadUrlInput) (*CreateUploadUrlOutput, error) { @@ -1196,16 +1316,26 @@ func (c *LexModelsV2) DeleteBotRequest(input *DeleteBotInput) (req *request.Requ // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteBot func (c *LexModelsV2) DeleteBot(input *DeleteBotInput) (*DeleteBotOutput, error) { @@ -1284,16 +1414,26 @@ func (c *LexModelsV2) DeleteBotAliasRequest(input *DeleteBotAliasInput) (req *re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteBotAlias func (c *LexModelsV2) DeleteBotAlias(input *DeleteBotAliasInput) (*DeleteBotAliasOutput, error) { @@ -1375,16 +1515,26 @@ func (c *LexModelsV2) DeleteBotLocaleRequest(input *DeleteBotLocaleInput) (req * // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteBotLocale func (c *LexModelsV2) DeleteBotLocale(input *DeleteBotLocaleInput) (*DeleteBotLocaleOutput, error) { @@ -1464,16 +1614,26 @@ func (c *LexModelsV2) DeleteBotVersionRequest(input *DeleteBotVersionInput) (req // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteBotVersion func (c *LexModelsV2) DeleteBotVersion(input *DeleteBotVersionInput) (*DeleteBotVersionOutput, error) { @@ -1552,14 +1712,21 @@ func (c *LexModelsV2) DeleteExportRequest(input *DeleteExportInput) (req *reques // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteExport func (c *LexModelsV2) DeleteExport(input *DeleteExportInput) (*DeleteExportOutput, error) { @@ -1638,14 +1805,21 @@ func (c *LexModelsV2) DeleteImportRequest(input *DeleteImportInput) (req *reques // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteImport func (c *LexModelsV2) DeleteImport(input *DeleteImportInput) (*DeleteImportOutput, error) { @@ -1727,16 +1901,26 @@ func (c *LexModelsV2) DeleteIntentRequest(input *DeleteIntentInput) (req *reques // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteIntent func (c *LexModelsV2) DeleteIntent(input *DeleteIntentInput) (*DeleteIntentOutput, error) { @@ -1816,12 +2000,18 @@ func (c *LexModelsV2) DeleteResourcePolicyRequest(input *DeleteResourcePolicyInp // // Returned Error Types: // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteResourcePolicy func (c *LexModelsV2) DeleteResourcePolicy(input *DeleteResourcePolicyInput) (*DeleteResourcePolicyOutput, error) { @@ -1903,12 +2093,18 @@ func (c *LexModelsV2) DeleteResourcePolicyStatementRequest(input *DeleteResource // // Returned Error Types: // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteResourcePolicyStatement func (c *LexModelsV2) DeleteResourcePolicyStatement(input *DeleteResourcePolicyStatementInput) (*DeleteResourcePolicyStatementOutput, error) { @@ -1988,16 +2184,26 @@ func (c *LexModelsV2) DeleteSlotRequest(input *DeleteSlotInput) (req *request.Re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteSlot func (c *LexModelsV2) DeleteSlot(input *DeleteSlotInput) (*DeleteSlotOutput, error) { @@ -2081,16 +2287,26 @@ func (c *LexModelsV2) DeleteSlotTypeRequest(input *DeleteSlotTypeInput) (req *re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteSlotType func (c *LexModelsV2) DeleteSlotType(input *DeleteSlotTypeInput) (*DeleteSlotTypeOutput, error) { @@ -2114,6 +2330,103 @@ func (c *LexModelsV2) DeleteSlotTypeWithContext(ctx aws.Context, input *DeleteSl return out, req.Send() } +const opDeleteUtterances = "DeleteUtterances" + +// DeleteUtterancesRequest generates a "aws/request.Request" representing the +// client's request for the DeleteUtterances 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 DeleteUtterances for more information on using the DeleteUtterances +// 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 DeleteUtterancesRequest method. +// req, resp := client.DeleteUtterancesRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteUtterances +func (c *LexModelsV2) DeleteUtterancesRequest(input *DeleteUtterancesInput) (req *request.Request, output *DeleteUtterancesOutput) { + op := &request.Operation{ + Name: opDeleteUtterances, + HTTPMethod: "DELETE", + HTTPPath: "/bots/{botId}/utterances/", + } + + if input == nil { + input = &DeleteUtterancesInput{} + } + + output = &DeleteUtterancesOutput{} + req = c.newRequest(op, input, output) + req.Handlers.Unmarshal.Swap(restjson.UnmarshalHandler.Name, protocol.UnmarshalDiscardBodyHandler) + return +} + +// DeleteUtterances API operation for Amazon Lex Model Building V2. +// +// Deletes stored utterances. +// +// Amazon Lex stores the utterances that users send to your bot. Utterances +// are stored for 15 days for use with the operation, and then stored indefinitely +// for use in improving the ability of your bot to respond to user input.. +// +// Use the DeleteUtterances operation to manually delete utterances for a specific +// session. When you use the DeleteUtterances operation, utterances stored for +// improving your bot's ability to respond to user input are deleted immediately. +// Utterances stored for use with the ListAggregatedUtterances operation are +// deleted after 15 days. +// +// 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 Lex Model Building V2's +// API operation DeleteUtterances for usage and error information. +// +// Returned Error Types: +// * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. +// +// * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. +// +// * InternalServerException +// The service encountered an unexpected condition. Try your request again. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DeleteUtterances +func (c *LexModelsV2) DeleteUtterances(input *DeleteUtterancesInput) (*DeleteUtterancesOutput, error) { + req, out := c.DeleteUtterancesRequest(input) + return out, req.Send() +} + +// DeleteUtterancesWithContext is the same as DeleteUtterances with the addition of +// the ability to pass a context and additional request options. +// +// See DeleteUtterances 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 *LexModelsV2) DeleteUtterancesWithContext(ctx aws.Context, input *DeleteUtterancesInput, opts ...request.Option) (*DeleteUtterancesOutput, error) { + req, out := c.DeleteUtterancesRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opDescribeBot = "DescribeBot" // DescribeBotRequest generates a "aws/request.Request" representing the @@ -2169,14 +2482,21 @@ func (c *LexModelsV2) DescribeBotRequest(input *DescribeBotInput) (req *request. // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DescribeBot func (c *LexModelsV2) DescribeBot(input *DescribeBotInput) (*DescribeBotOutput, error) { @@ -2255,14 +2575,21 @@ func (c *LexModelsV2) DescribeBotAliasRequest(input *DescribeBotAliasInput) (req // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DescribeBotAlias func (c *LexModelsV2) DescribeBotAlias(input *DescribeBotAliasInput) (*DescribeBotAliasOutput, error) { @@ -2341,14 +2668,21 @@ func (c *LexModelsV2) DescribeBotLocaleRequest(input *DescribeBotLocaleInput) (r // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DescribeBotLocale func (c *LexModelsV2) DescribeBotLocale(input *DescribeBotLocaleInput) (*DescribeBotLocaleOutput, error) { @@ -2427,14 +2761,21 @@ func (c *LexModelsV2) DescribeBotVersionRequest(input *DescribeBotVersionInput) // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DescribeBotVersion func (c *LexModelsV2) DescribeBotVersion(input *DescribeBotVersionInput) (*DescribeBotVersionOutput, error) { @@ -2513,12 +2854,18 @@ func (c *LexModelsV2) DescribeExportRequest(input *DescribeExportInput) (req *re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DescribeExport func (c *LexModelsV2) DescribeExport(input *DescribeExportInput) (*DescribeExportOutput, error) { @@ -2597,12 +2944,18 @@ func (c *LexModelsV2) DescribeImportRequest(input *DescribeImportInput) (req *re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DescribeImport func (c *LexModelsV2) DescribeImport(input *DescribeImportInput) (*DescribeImportOutput, error) { @@ -2681,14 +3034,21 @@ func (c *LexModelsV2) DescribeIntentRequest(input *DescribeIntentInput) (req *re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DescribeIntent func (c *LexModelsV2) DescribeIntent(input *DescribeIntentInput) (*DescribeIntentOutput, error) { @@ -2767,10 +3127,14 @@ func (c *LexModelsV2) DescribeResourcePolicyRequest(input *DescribeResourcePolic // // Returned Error Types: // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DescribeResourcePolicy func (c *LexModelsV2) DescribeResourcePolicy(input *DescribeResourcePolicyInput) (*DescribeResourcePolicyOutput, error) { @@ -2849,14 +3213,21 @@ func (c *LexModelsV2) DescribeSlotRequest(input *DescribeSlotInput) (req *reques // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DescribeSlot func (c *LexModelsV2) DescribeSlot(input *DescribeSlotInput) (*DescribeSlotOutput, error) { @@ -2935,14 +3306,21 @@ func (c *LexModelsV2) DescribeSlotTypeRequest(input *DescribeSlotTypeInput) (req // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/DescribeSlotType func (c *LexModelsV2) DescribeSlotType(input *DescribeSlotTypeInput) (*DescribeSlotTypeOutput, error) { @@ -2966,6 +3344,174 @@ func (c *LexModelsV2) DescribeSlotTypeWithContext(ctx aws.Context, input *Descri return out, req.Send() } +const opListAggregatedUtterances = "ListAggregatedUtterances" + +// ListAggregatedUtterancesRequest generates a "aws/request.Request" representing the +// client's request for the ListAggregatedUtterances 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 ListAggregatedUtterances for more information on using the ListAggregatedUtterances +// 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 ListAggregatedUtterancesRequest method. +// req, resp := client.ListAggregatedUtterancesRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListAggregatedUtterances +func (c *LexModelsV2) ListAggregatedUtterancesRequest(input *ListAggregatedUtterancesInput) (req *request.Request, output *ListAggregatedUtterancesOutput) { + op := &request.Operation{ + Name: opListAggregatedUtterances, + HTTPMethod: "POST", + HTTPPath: "/bots/{botId}/aggregatedutterances/", + Paginator: &request.Paginator{ + InputTokens: []string{"nextToken"}, + OutputTokens: []string{"nextToken"}, + LimitToken: "maxResults", + TruncationToken: "", + }, + } + + if input == nil { + input = &ListAggregatedUtterancesInput{} + } + + output = &ListAggregatedUtterancesOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListAggregatedUtterances API operation for Amazon Lex Model Building V2. +// +// Provides a list of utterances that users have sent to the bot. +// +// Utterances are aggregated by the text of the utterance. For example, all +// instances where customers used the phrase "I want to order pizza" are aggregated +// into the same line in the response. +// +// You can see both detected utterances and missed utterances. A detected utterance +// is where the bot properly recognized the utterance and activated the associated +// intent. A missed utterance was not recognized by the bot and didn't activate +// an intent. +// +// Utterances can be aggregated for a bot alias or for a bot version, but not +// both at the same time. +// +// Utterances statistics are not generated under the following conditions: +// +// * The childDirected field was set to true when the bot was created. +// +// * You are using slot obfuscation with one or more slots. +// +// * You opted out of participating in improving Amazon Lex. +// +// 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 Lex Model Building V2's +// API operation ListAggregatedUtterances for usage and error information. +// +// Returned Error Types: +// * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. +// +// * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. +// +// * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. +// +// * InternalServerException +// The service encountered an unexpected condition. Try your request again. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListAggregatedUtterances +func (c *LexModelsV2) ListAggregatedUtterances(input *ListAggregatedUtterancesInput) (*ListAggregatedUtterancesOutput, error) { + req, out := c.ListAggregatedUtterancesRequest(input) + return out, req.Send() +} + +// ListAggregatedUtterancesWithContext is the same as ListAggregatedUtterances with the addition of +// the ability to pass a context and additional request options. +// +// See ListAggregatedUtterances 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 *LexModelsV2) ListAggregatedUtterancesWithContext(ctx aws.Context, input *ListAggregatedUtterancesInput, opts ...request.Option) (*ListAggregatedUtterancesOutput, error) { + req, out := c.ListAggregatedUtterancesRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// ListAggregatedUtterancesPages iterates over the pages of a ListAggregatedUtterances operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListAggregatedUtterances method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListAggregatedUtterances operation. +// pageNum := 0 +// err := client.ListAggregatedUtterancesPages(params, +// func(page *lexmodelsv2.ListAggregatedUtterancesOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *LexModelsV2) ListAggregatedUtterancesPages(input *ListAggregatedUtterancesInput, fn func(*ListAggregatedUtterancesOutput, bool) bool) error { + return c.ListAggregatedUtterancesPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListAggregatedUtterancesPagesWithContext same as ListAggregatedUtterancesPages except +// it takes a Context and allows setting request options on the pages. +// +// 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 *LexModelsV2) ListAggregatedUtterancesPagesWithContext(ctx aws.Context, input *ListAggregatedUtterancesInput, fn func(*ListAggregatedUtterancesOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListAggregatedUtterancesInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListAggregatedUtterancesRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + for p.Next() { + if !fn(p.Page().(*ListAggregatedUtterancesOutput), !p.HasNextPage()) { + break + } + } + + return p.Err() +} + const opListBotAliases = "ListBotAliases" // ListBotAliasesRequest generates a "aws/request.Request" representing the @@ -3027,12 +3573,17 @@ func (c *LexModelsV2) ListBotAliasesRequest(input *ListBotAliasesInput) (req *re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListBotAliases func (c *LexModelsV2) ListBotAliases(input *ListBotAliasesInput) (*ListBotAliasesOutput, error) { @@ -3169,12 +3720,17 @@ func (c *LexModelsV2) ListBotLocalesRequest(input *ListBotLocalesInput) (req *re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListBotLocales func (c *LexModelsV2) ListBotLocales(input *ListBotLocalesInput) (*ListBotLocalesOutput, error) { @@ -3319,12 +3875,17 @@ func (c *LexModelsV2) ListBotVersionsRequest(input *ListBotVersionsInput) (req * // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListBotVersions func (c *LexModelsV2) ListBotVersions(input *ListBotVersionsInput) (*ListBotVersionsOutput, error) { @@ -3461,12 +4022,17 @@ func (c *LexModelsV2) ListBotsRequest(input *ListBotsInput) (req *request.Reques // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListBots func (c *LexModelsV2) ListBots(input *ListBotsInput) (*ListBotsOutput, error) { @@ -3608,12 +4174,17 @@ func (c *LexModelsV2) ListBuiltInIntentsRequest(input *ListBuiltInIntentsInput) // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListBuiltInIntents func (c *LexModelsV2) ListBuiltInIntents(input *ListBuiltInIntentsInput) (*ListBuiltInIntentsOutput, error) { @@ -3750,12 +4321,17 @@ func (c *LexModelsV2) ListBuiltInSlotTypesRequest(input *ListBuiltInSlotTypesInp // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListBuiltInSlotTypes func (c *LexModelsV2) ListBuiltInSlotTypes(input *ListBuiltInSlotTypesInput) (*ListBuiltInSlotTypesOutput, error) { @@ -3893,10 +4469,14 @@ func (c *LexModelsV2) ListExportsRequest(input *ListExportsInput) (req *request. // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListExports func (c *LexModelsV2) ListExports(input *ListExportsInput) (*ListExportsOutput, error) { @@ -4034,10 +4614,14 @@ func (c *LexModelsV2) ListImportsRequest(input *ListImportsInput) (req *request. // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListImports func (c *LexModelsV2) ListImports(input *ListImportsInput) (*ListImportsOutput, error) { @@ -4174,12 +4758,17 @@ func (c *LexModelsV2) ListIntentsRequest(input *ListIntentsInput) (req *request. // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListIntents func (c *LexModelsV2) ListIntents(input *ListIntentsInput) (*ListIntentsOutput, error) { @@ -4316,12 +4905,17 @@ func (c *LexModelsV2) ListSlotTypesRequest(input *ListSlotTypesInput) (req *requ // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListSlotTypes func (c *LexModelsV2) ListSlotTypes(input *ListSlotTypesInput) (*ListSlotTypesOutput, error) { @@ -4458,12 +5052,17 @@ func (c *LexModelsV2) ListSlotsRequest(input *ListSlotsInput) (req *request.Requ // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListSlots func (c *LexModelsV2) ListSlots(input *ListSlotsInput) (*ListSlotsOutput, error) { @@ -4595,12 +5194,18 @@ func (c *LexModelsV2) ListTagsForResourceRequest(input *ListTagsForResourceInput // // Returned Error Types: // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/ListTagsForResource func (c *LexModelsV2) ListTagsForResource(input *ListTagsForResourceInput) (*ListTagsForResourceOutput, error) { @@ -4680,16 +5285,26 @@ func (c *LexModelsV2) StartImportRequest(input *StartImportInput) (req *request. // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/StartImport func (c *LexModelsV2) StartImport(input *StartImportInput) (*StartImportOutput, error) { @@ -4770,12 +5385,18 @@ func (c *LexModelsV2) TagResourceRequest(input *TagResourceInput) (req *request. // // Returned Error Types: // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/TagResource func (c *LexModelsV2) TagResource(input *TagResourceInput) (*TagResourceOutput, error) { @@ -4855,12 +5476,18 @@ func (c *LexModelsV2) UntagResourceRequest(input *UntagResourceInput) (req *requ // // Returned Error Types: // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/UntagResource func (c *LexModelsV2) UntagResource(input *UntagResourceInput) (*UntagResourceOutput, error) { @@ -4939,16 +5566,26 @@ func (c *LexModelsV2) UpdateBotRequest(input *UpdateBotInput) (req *request.Requ // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/UpdateBot func (c *LexModelsV2) UpdateBot(input *UpdateBotInput) (*UpdateBotOutput, error) { @@ -5027,16 +5664,26 @@ func (c *LexModelsV2) UpdateBotAliasRequest(input *UpdateBotAliasInput) (req *re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/UpdateBotAlias func (c *LexModelsV2) UpdateBotAlias(input *UpdateBotAliasInput) (*UpdateBotAliasOutput, error) { @@ -5115,16 +5762,26 @@ func (c *LexModelsV2) UpdateBotLocaleRequest(input *UpdateBotLocaleInput) (req * // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/UpdateBotLocale func (c *LexModelsV2) UpdateBotLocale(input *UpdateBotLocaleInput) (*UpdateBotLocaleOutput, error) { @@ -5207,16 +5864,26 @@ func (c *LexModelsV2) UpdateExportRequest(input *UpdateExportInput) (req *reques // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/UpdateExport func (c *LexModelsV2) UpdateExport(input *UpdateExportInput) (*UpdateExportOutput, error) { @@ -5295,16 +5962,26 @@ func (c *LexModelsV2) UpdateIntentRequest(input *UpdateIntentInput) (req *reques // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/UpdateIntent func (c *LexModelsV2) UpdateIntent(input *UpdateIntentInput) (*UpdateIntentOutput, error) { @@ -5384,16 +6061,25 @@ func (c *LexModelsV2) UpdateResourcePolicyRequest(input *UpdateResourcePolicyInp // // Returned Error Types: // * ResourceNotFoundException +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/UpdateResourcePolicy func (c *LexModelsV2) UpdateResourcePolicy(input *UpdateResourcePolicyInput) (*UpdateResourcePolicyOutput, error) { @@ -5472,16 +6158,26 @@ func (c *LexModelsV2) UpdateSlotRequest(input *UpdateSlotInput) (req *request.Re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/UpdateSlot func (c *LexModelsV2) UpdateSlot(input *UpdateSlotInput) (*UpdateSlotOutput, error) { @@ -5560,16 +6256,26 @@ func (c *LexModelsV2) UpdateSlotTypeRequest(input *UpdateSlotTypeInput) (req *re // // Returned Error Types: // * ThrottlingException +// Your request rate is too high. Reduce the frequency of requests. // // * ServiceQuotaExceededException +// You have reached a quota for your bot. // // * ValidationException +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. // // * PreconditionFailedException +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. // // * ConflictException +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. // // * InternalServerException +// The service encountered an unexpected condition. Try your request again. // // See also, https://docs.aws.amazon.com/goto/WebAPI/models.lex.v2-2020-08-07/UpdateSlotType func (c *LexModelsV2) UpdateSlotType(input *UpdateSlotTypeInput) (*UpdateSlotTypeOutput, error) { @@ -5593,17 +6299,27 @@ func (c *LexModelsV2) UpdateSlotTypeWithContext(ctx aws.Context, input *UpdateSl return out, req.Send() } -// The location of audio log files collected when conversation logging is enabled -// for a bot. -type AudioLogDestination struct { +// Filters responses returned by the ListAggregatedUtterances operation. +type AggregatedUtterancesFilter struct { _ struct{} `type:"structure"` - // The Amazon S3 bucket where the audio log files are stored. The IAM role specified - // in the roleArn parameter of the CreateBot operation must have permission - // to write to this bucket. + // The name of the field to filter the utterance list. // - // S3Bucket is a required field - S3Bucket *S3BucketLogDestination `locationName:"s3Bucket" type:"structure" required:"true"` + // Name is a required field + Name *string `locationName:"name" type:"string" required:"true" enum:"AggregatedUtterancesFilterName"` + + // The operator to use for the filter. Specify EQ when the ListAggregatedUtterances + // operation should return only utterances that equal the specified value. Specify + // CO when the ListAggregatedUtterances operation should return utterances that + // contain the specified value. + // + // Operator is a required field + Operator *string `locationName:"operator" type:"string" required:"true" enum:"AggregatedUtterancesFilterOperator"` + + // The value to use for filtering the list of bots. + // + // Values is a required field + Values []*string `locationName:"values" min:"1" type:"list" required:"true"` } // String returns the string representation. @@ -5611,7 +6327,7 @@ type AudioLogDestination struct { // 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 AudioLogDestination) String() string { +func (s AggregatedUtterancesFilter) String() string { return awsutil.Prettify(s) } @@ -5620,20 +6336,24 @@ func (s AudioLogDestination) String() string { // 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 AudioLogDestination) GoString() string { +func (s AggregatedUtterancesFilter) GoString() string { return s.String() } // Validate inspects the fields of the type to determine if they are valid. -func (s *AudioLogDestination) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "AudioLogDestination"} - if s.S3Bucket == nil { - invalidParams.Add(request.NewErrParamRequired("S3Bucket")) +func (s *AggregatedUtterancesFilter) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "AggregatedUtterancesFilter"} + if s.Name == nil { + invalidParams.Add(request.NewErrParamRequired("Name")) } - if s.S3Bucket != nil { - if err := s.S3Bucket.Validate(); err != nil { - invalidParams.AddNested("S3Bucket", err.(request.ErrInvalidParams)) - } + if s.Operator == nil { + invalidParams.Add(request.NewErrParamRequired("Operator")) + } + if s.Values == nil { + invalidParams.Add(request.NewErrParamRequired("Values")) + } + if s.Values != nil && len(s.Values) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Values", 1)) } if invalidParams.Len() > 0 { @@ -5642,28 +6362,38 @@ func (s *AudioLogDestination) Validate() error { return nil } -// SetS3Bucket sets the S3Bucket field's value. -func (s *AudioLogDestination) SetS3Bucket(v *S3BucketLogDestination) *AudioLogDestination { - s.S3Bucket = v +// SetName sets the Name field's value. +func (s *AggregatedUtterancesFilter) SetName(v string) *AggregatedUtterancesFilter { + s.Name = &v return s } -// Settings for logging audio of conversations between Amazon Lex and a user. -// You specify whether to log audio and the Amazon S3 bucket where the audio -// file is stored. -type AudioLogSetting struct { +// SetOperator sets the Operator field's value. +func (s *AggregatedUtterancesFilter) SetOperator(v string) *AggregatedUtterancesFilter { + s.Operator = &v + return s +} + +// SetValues sets the Values field's value. +func (s *AggregatedUtterancesFilter) SetValues(v []*string) *AggregatedUtterancesFilter { + s.Values = v + return s +} + +// Specifies attributes for sorting a list of utterances. +type AggregatedUtterancesSortBy struct { _ struct{} `type:"structure"` - // The location of audio log files collected when conversation logging is enabled - // for a bot. + // The utterance attribute to sort by. // - // Destination is a required field - Destination *AudioLogDestination `locationName:"destination" type:"structure" required:"true"` + // Attribute is a required field + Attribute *string `locationName:"attribute" type:"string" required:"true" enum:"AggregatedUtterancesSortAttribute"` - // Determines whether audio logging in enabled for the bot. + // Specifies whether to sort the aggregated utterances in ascending or descending + // order. // - // Enabled is a required field - Enabled *bool `locationName:"enabled" type:"boolean" required:"true"` + // Order is a required field + Order *string `locationName:"order" type:"string" required:"true" enum:"SortOrder"` } // String returns the string representation. @@ -5671,7 +6401,7 @@ type AudioLogSetting struct { // 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 AudioLogSetting) String() string { +func (s AggregatedUtterancesSortBy) String() string { return awsutil.Prettify(s) } @@ -5680,18 +6410,226 @@ func (s AudioLogSetting) String() string { // 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 AudioLogSetting) GoString() string { +func (s AggregatedUtterancesSortBy) GoString() string { return s.String() } // Validate inspects the fields of the type to determine if they are valid. -func (s *AudioLogSetting) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "AudioLogSetting"} - if s.Destination == nil { - invalidParams.Add(request.NewErrParamRequired("Destination")) +func (s *AggregatedUtterancesSortBy) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "AggregatedUtterancesSortBy"} + if s.Attribute == nil { + invalidParams.Add(request.NewErrParamRequired("Attribute")) } - if s.Enabled == nil { - invalidParams.Add(request.NewErrParamRequired("Enabled")) + if s.Order == nil { + invalidParams.Add(request.NewErrParamRequired("Order")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAttribute sets the Attribute field's value. +func (s *AggregatedUtterancesSortBy) SetAttribute(v string) *AggregatedUtterancesSortBy { + s.Attribute = &v + return s +} + +// SetOrder sets the Order field's value. +func (s *AggregatedUtterancesSortBy) SetOrder(v string) *AggregatedUtterancesSortBy { + s.Order = &v + return s +} + +// Provides summary information for aggregated utterances. The ListAggregatedUtterances +// operations combines all instances of the same utterance into a single aggregated +// summary. +type AggregatedUtterancesSummary struct { + _ struct{} `type:"structure"` + + // Aggregated utterance data may contain utterances from versions of your bot + // that have since been deleted. When the aggregated contains this kind of data, + // this field is set to true. + ContainsDataFromDeletedResources *bool `locationName:"containsDataFromDeletedResources" type:"boolean"` + + // The number of times that the utterance was detected by Amazon Lex during + // the time period. When an utterance is detected, it activates an intent or + // a slot. + HitCount *int64 `locationName:"hitCount" type:"integer"` + + // The number of times that the utterance was missed by Amazon Lex An utterance + // is missed when it doesn't activate an intent or slot. + MissedCount *int64 `locationName:"missedCount" type:"integer"` + + // The text of the utterance. If the utterance was used with the RecognizeUtterance + // operation, the text is the transcription of the audio utterance. + Utterance *string `locationName:"utterance" type:"string"` + + // The date and time that the utterance was first recorded in the time window + // for aggregation. An utterance may have been sent to Amazon Lex before that + // time, but only utterances within the time window are counted. + UtteranceFirstRecordedInAggregationDuration *time.Time `locationName:"utteranceFirstRecordedInAggregationDuration" type:"timestamp"` + + // The last date and time that an utterance was recorded in the time window + // for aggregation. An utterance may be sent to Amazon Lex after that time, + // but only utterances within the time window are counted. + UtteranceLastRecordedInAggregationDuration *time.Time `locationName:"utteranceLastRecordedInAggregationDuration" type:"timestamp"` +} + +// 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 AggregatedUtterancesSummary) 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 AggregatedUtterancesSummary) GoString() string { + return s.String() +} + +// SetContainsDataFromDeletedResources sets the ContainsDataFromDeletedResources field's value. +func (s *AggregatedUtterancesSummary) SetContainsDataFromDeletedResources(v bool) *AggregatedUtterancesSummary { + s.ContainsDataFromDeletedResources = &v + return s +} + +// SetHitCount sets the HitCount field's value. +func (s *AggregatedUtterancesSummary) SetHitCount(v int64) *AggregatedUtterancesSummary { + s.HitCount = &v + return s +} + +// SetMissedCount sets the MissedCount field's value. +func (s *AggregatedUtterancesSummary) SetMissedCount(v int64) *AggregatedUtterancesSummary { + s.MissedCount = &v + return s +} + +// SetUtterance sets the Utterance field's value. +func (s *AggregatedUtterancesSummary) SetUtterance(v string) *AggregatedUtterancesSummary { + s.Utterance = &v + return s +} + +// SetUtteranceFirstRecordedInAggregationDuration sets the UtteranceFirstRecordedInAggregationDuration field's value. +func (s *AggregatedUtterancesSummary) SetUtteranceFirstRecordedInAggregationDuration(v time.Time) *AggregatedUtterancesSummary { + s.UtteranceFirstRecordedInAggregationDuration = &v + return s +} + +// SetUtteranceLastRecordedInAggregationDuration sets the UtteranceLastRecordedInAggregationDuration field's value. +func (s *AggregatedUtterancesSummary) SetUtteranceLastRecordedInAggregationDuration(v time.Time) *AggregatedUtterancesSummary { + s.UtteranceLastRecordedInAggregationDuration = &v + return s +} + +// The location of audio log files collected when conversation logging is enabled +// for a bot. +type AudioLogDestination struct { + _ struct{} `type:"structure"` + + // The Amazon S3 bucket where the audio log files are stored. The IAM role specified + // in the roleArn parameter of the CreateBot operation must have permission + // to write to this bucket. + // + // S3Bucket is a required field + S3Bucket *S3BucketLogDestination `locationName:"s3Bucket" 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 AudioLogDestination) 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 AudioLogDestination) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *AudioLogDestination) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "AudioLogDestination"} + if s.S3Bucket == nil { + invalidParams.Add(request.NewErrParamRequired("S3Bucket")) + } + if s.S3Bucket != nil { + if err := s.S3Bucket.Validate(); err != nil { + invalidParams.AddNested("S3Bucket", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetS3Bucket sets the S3Bucket field's value. +func (s *AudioLogDestination) SetS3Bucket(v *S3BucketLogDestination) *AudioLogDestination { + s.S3Bucket = v + return s +} + +// Settings for logging audio of conversations between Amazon Lex and a user. +// You specify whether to log audio and the Amazon S3 bucket where the audio +// file is stored. +type AudioLogSetting struct { + _ struct{} `type:"structure"` + + // The location of audio log files collected when conversation logging is enabled + // for a bot. + // + // Destination is a required field + Destination *AudioLogDestination `locationName:"destination" type:"structure" required:"true"` + + // Determines whether audio logging in enabled for the bot. + // + // Enabled is a required field + Enabled *bool `locationName:"enabled" type:"boolean" 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 AudioLogSetting) 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 AudioLogSetting) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *AudioLogSetting) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "AudioLogSetting"} + if s.Destination == nil { + invalidParams.Add(request.NewErrParamRequired("Destination")) + } + if s.Enabled == nil { + invalidParams.Add(request.NewErrParamRequired("Enabled")) } if s.Destination != nil { if err := s.Destination.Validate(); err != nil { @@ -7546,6 +8484,9 @@ func (s *CodeHookSpecification) SetLambdaCodeHook(v *LambdaCodeHook) *CodeHookSp return s } +// The action that you tried to perform couldn't be completed because the resource +// is in a conflicting state. For example, deleting a bot that is in the CREATING +// state. Try your request again. type ConflictException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -11706,6 +12647,101 @@ func (s DeleteSlotTypeOutput) GoString() string { return s.String() } +type DeleteUtterancesInput struct { + _ struct{} `type:"structure"` + + // The unique identifier of the bot that contains the utterances. + // + // BotId is a required field + BotId *string `location:"uri" locationName:"botId" min:"10" type:"string" required:"true"` + + // The identifier of the language and locale where the utterances were collected. + // The string must match one of the supported locales. For more information, + // see Supported languages (https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html). + LocaleId *string `location:"querystring" locationName:"localeId" type:"string"` + + // The unique identifier of the session with the user. The ID is returned in + // the response from the and operations. + SessionId *string `location:"querystring" locationName:"sessionId" min:"2" type:"string"` +} + +// 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 DeleteUtterancesInput) 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 DeleteUtterancesInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *DeleteUtterancesInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "DeleteUtterancesInput"} + if s.BotId == nil { + invalidParams.Add(request.NewErrParamRequired("BotId")) + } + if s.BotId != nil && len(*s.BotId) < 10 { + invalidParams.Add(request.NewErrParamMinLen("BotId", 10)) + } + if s.SessionId != nil && len(*s.SessionId) < 2 { + invalidParams.Add(request.NewErrParamMinLen("SessionId", 2)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetBotId sets the BotId field's value. +func (s *DeleteUtterancesInput) SetBotId(v string) *DeleteUtterancesInput { + s.BotId = &v + return s +} + +// SetLocaleId sets the LocaleId field's value. +func (s *DeleteUtterancesInput) SetLocaleId(v string) *DeleteUtterancesInput { + s.LocaleId = &v + return s +} + +// SetSessionId sets the SessionId field's value. +func (s *DeleteUtterancesInput) SetSessionId(v string) *DeleteUtterancesInput { + s.SessionId = &v + return s +} + +type DeleteUtterancesOutput struct { + _ struct{} `type:"structure"` +} + +// 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 DeleteUtterancesOutput) 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 DeleteUtterancesOutput) GoString() string { + return s.String() +} + type DescribeBotAliasInput struct { _ struct{} `type:"structure"` @@ -14887,6 +15923,7 @@ func (s *IntentSummary) SetParentIntentSignature(v string) *IntentSummary { return s } +// The service encountered an unexpected condition. Try your request again. type InternalServerException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -14940,37 +15977,389 @@ func (s *InternalServerException) Error() string { return fmt.Sprintf("%s: %s", s.Code(), s.Message()) } -// Status code returns the HTTP status code for the request's response error. -func (s *InternalServerException) StatusCode() int { - return s.RespMetadata.StatusCode +// Status code returns the HTTP status code for the request's response error. +func (s *InternalServerException) StatusCode() int { + return s.RespMetadata.StatusCode +} + +// RequestID returns the service's response RequestID for request. +func (s *InternalServerException) RequestID() string { + return s.RespMetadata.RequestID +} + +// Provides configuration information for the AMAZON.KendraSearchIntent intent. +// When you use this intent, Amazon Lex searches the specified Amazon Kendra +// index and returns documents from the index that match the user's utterance. +type KendraConfiguration struct { + _ struct{} `type:"structure"` + + // The Amazon Resource Name (ARN) of the Amazon Kendra index that you want the + // AMAZON.KendraSearchIntent intent to search. The index must be in the same + // account and Region as the Amazon Lex bot. + // + // KendraIndex is a required field + KendraIndex *string `locationName:"kendraIndex" min:"32" type:"string" required:"true"` + + // A query filter that Amazon Lex sends to Amazon Kendra to filter the response + // from a query. The filter is in the format defined by Amazon Kendra. For more + // information, see Filtering queries (https://docs.aws.amazon.com/kendra/latest/dg/filtering.html). + QueryFilterString *string `locationName:"queryFilterString" min:"1" type:"string"` + + // Determines whether the AMAZON.KendraSearchIntent intent uses a custom query + // string to query the Amazon Kendra index. + QueryFilterStringEnabled *bool `locationName:"queryFilterStringEnabled" type:"boolean"` +} + +// 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 KendraConfiguration) 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 KendraConfiguration) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *KendraConfiguration) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "KendraConfiguration"} + if s.KendraIndex == nil { + invalidParams.Add(request.NewErrParamRequired("KendraIndex")) + } + if s.KendraIndex != nil && len(*s.KendraIndex) < 32 { + invalidParams.Add(request.NewErrParamMinLen("KendraIndex", 32)) + } + if s.QueryFilterString != nil && len(*s.QueryFilterString) < 1 { + invalidParams.Add(request.NewErrParamMinLen("QueryFilterString", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetKendraIndex sets the KendraIndex field's value. +func (s *KendraConfiguration) SetKendraIndex(v string) *KendraConfiguration { + s.KendraIndex = &v + return s +} + +// SetQueryFilterString sets the QueryFilterString field's value. +func (s *KendraConfiguration) SetQueryFilterString(v string) *KendraConfiguration { + s.QueryFilterString = &v + return s +} + +// SetQueryFilterStringEnabled sets the QueryFilterStringEnabled field's value. +func (s *KendraConfiguration) SetQueryFilterStringEnabled(v bool) *KendraConfiguration { + s.QueryFilterStringEnabled = &v + return s +} + +// Specifies a Lambda function that verifies requests to a bot or fulfilles +// the user's request to a bot. +type LambdaCodeHook struct { + _ struct{} `type:"structure"` + + // The version of the request-response that you want Amazon Lex to use to invoke + // your Lambda function. + // + // CodeHookInterfaceVersion is a required field + CodeHookInterfaceVersion *string `locationName:"codeHookInterfaceVersion" min:"1" type:"string" required:"true"` + + // The Amazon Resource Name (ARN) of the Lambda function. + // + // LambdaARN is a required field + LambdaARN *string `locationName:"lambdaARN" min:"20" 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 LambdaCodeHook) 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 LambdaCodeHook) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *LambdaCodeHook) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "LambdaCodeHook"} + if s.CodeHookInterfaceVersion == nil { + invalidParams.Add(request.NewErrParamRequired("CodeHookInterfaceVersion")) + } + if s.CodeHookInterfaceVersion != nil && len(*s.CodeHookInterfaceVersion) < 1 { + invalidParams.Add(request.NewErrParamMinLen("CodeHookInterfaceVersion", 1)) + } + if s.LambdaARN == nil { + invalidParams.Add(request.NewErrParamRequired("LambdaARN")) + } + if s.LambdaARN != nil && len(*s.LambdaARN) < 20 { + invalidParams.Add(request.NewErrParamMinLen("LambdaARN", 20)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetCodeHookInterfaceVersion sets the CodeHookInterfaceVersion field's value. +func (s *LambdaCodeHook) SetCodeHookInterfaceVersion(v string) *LambdaCodeHook { + s.CodeHookInterfaceVersion = &v + return s +} + +// SetLambdaARN sets the LambdaARN field's value. +func (s *LambdaCodeHook) SetLambdaARN(v string) *LambdaCodeHook { + s.LambdaARN = &v + return s +} + +type ListAggregatedUtterancesInput struct { + _ struct{} `type:"structure"` + + // The time window for aggregating the utterance information. You can specify + // a time between one hour and two weeks. + // + // AggregationDuration is a required field + AggregationDuration *UtteranceAggregationDuration `locationName:"aggregationDuration" type:"structure" required:"true"` + + // The identifier of the bot alias associated with this request. If you specify + // the bot alias, you can't specify the bot version. + BotAliasId *string `locationName:"botAliasId" min:"10" type:"string"` + + // The unique identifier of the bot associated with this request. + // + // BotId is a required field + BotId *string `location:"uri" locationName:"botId" min:"10" type:"string" required:"true"` + + // The identifier of the bot version associated with this request. If you specify + // the bot version, you can't specify the bot alias. + BotVersion *string `locationName:"botVersion" min:"1" type:"string"` + + // Provides the specification of a filter used to limit the utterances in the + // response to only those that match the filter specification. You can only + // specify one filter and one string to filter on. + Filters []*AggregatedUtterancesFilter `locationName:"filters" min:"1" type:"list"` + + // The identifier of the language and locale where the utterances were collected. + // For more information, see Supported languages (https://docs.aws.amazon.com/lexv2/latest/dg/how-languages.html). + // + // LocaleId is a required field + LocaleId *string `locationName:"localeId" type:"string" required:"true"` + + // The maximum number of utterances to return in each page of results. If there + // are fewer results than the maximum page size, only the actual number of results + // are returned. If you don't specify the maxResults parameter, 1,000 results + // are returned. + MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` + + // If the response from the ListAggregatedUtterances operation contains more + // results that specified in the maxResults parameter, a token is returned in + // the response. Use that token in the nextToken parameter to return the next + // page of results. + NextToken *string `locationName:"nextToken" type:"string"` + + // Specifies sorting parameters for the list of utterances. You can sort by + // the hit count, the missed count, or the number of distinct sessions the utterance + // appeared in. + SortBy *AggregatedUtterancesSortBy `locationName:"sortBy" type:"structure"` +} + +// 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 ListAggregatedUtterancesInput) 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 ListAggregatedUtterancesInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ListAggregatedUtterancesInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ListAggregatedUtterancesInput"} + if s.AggregationDuration == nil { + invalidParams.Add(request.NewErrParamRequired("AggregationDuration")) + } + if s.BotAliasId != nil && len(*s.BotAliasId) < 10 { + invalidParams.Add(request.NewErrParamMinLen("BotAliasId", 10)) + } + if s.BotId == nil { + invalidParams.Add(request.NewErrParamRequired("BotId")) + } + if s.BotId != nil && len(*s.BotId) < 10 { + invalidParams.Add(request.NewErrParamMinLen("BotId", 10)) + } + if s.BotVersion != nil && len(*s.BotVersion) < 1 { + invalidParams.Add(request.NewErrParamMinLen("BotVersion", 1)) + } + if s.Filters != nil && len(s.Filters) < 1 { + invalidParams.Add(request.NewErrParamMinLen("Filters", 1)) + } + if s.LocaleId == nil { + invalidParams.Add(request.NewErrParamRequired("LocaleId")) + } + if s.MaxResults != nil && *s.MaxResults < 1 { + invalidParams.Add(request.NewErrParamMinValue("MaxResults", 1)) + } + if s.AggregationDuration != nil { + if err := s.AggregationDuration.Validate(); err != nil { + invalidParams.AddNested("AggregationDuration", err.(request.ErrInvalidParams)) + } + } + if s.Filters != nil { + for i, v := range s.Filters { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Filters", i), err.(request.ErrInvalidParams)) + } + } + } + if s.SortBy != nil { + if err := s.SortBy.Validate(); err != nil { + invalidParams.AddNested("SortBy", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetAggregationDuration sets the AggregationDuration field's value. +func (s *ListAggregatedUtterancesInput) SetAggregationDuration(v *UtteranceAggregationDuration) *ListAggregatedUtterancesInput { + s.AggregationDuration = v + return s +} + +// SetBotAliasId sets the BotAliasId field's value. +func (s *ListAggregatedUtterancesInput) SetBotAliasId(v string) *ListAggregatedUtterancesInput { + s.BotAliasId = &v + return s +} + +// SetBotId sets the BotId field's value. +func (s *ListAggregatedUtterancesInput) SetBotId(v string) *ListAggregatedUtterancesInput { + s.BotId = &v + return s +} + +// SetBotVersion sets the BotVersion field's value. +func (s *ListAggregatedUtterancesInput) SetBotVersion(v string) *ListAggregatedUtterancesInput { + s.BotVersion = &v + return s +} + +// SetFilters sets the Filters field's value. +func (s *ListAggregatedUtterancesInput) SetFilters(v []*AggregatedUtterancesFilter) *ListAggregatedUtterancesInput { + s.Filters = v + return s +} + +// SetLocaleId sets the LocaleId field's value. +func (s *ListAggregatedUtterancesInput) SetLocaleId(v string) *ListAggregatedUtterancesInput { + s.LocaleId = &v + return s +} + +// SetMaxResults sets the MaxResults field's value. +func (s *ListAggregatedUtterancesInput) SetMaxResults(v int64) *ListAggregatedUtterancesInput { + s.MaxResults = &v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListAggregatedUtterancesInput) SetNextToken(v string) *ListAggregatedUtterancesInput { + s.NextToken = &v + return s } -// RequestID returns the service's response RequestID for request. -func (s *InternalServerException) RequestID() string { - return s.RespMetadata.RequestID +// SetSortBy sets the SortBy field's value. +func (s *ListAggregatedUtterancesInput) SetSortBy(v *AggregatedUtterancesSortBy) *ListAggregatedUtterancesInput { + s.SortBy = v + return s } -// Provides configuration information for the AMAZON.KendraSearchIntent intent. -// When you use this intent, Amazon Lex searches the specified Amazon Kendra -// index and returns documents from the index that match the user's utterance. -type KendraConfiguration struct { +type ListAggregatedUtterancesOutput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the Amazon Kendra index that you want the - // AMAZON.KendraSearchIntent intent to search. The index must be in the same - // account and Region as the Amazon Lex bot. + // Summaries of the aggregated utterance data. Each response contains information + // about the number of times that the utterance was seen during the time period, + // whether it was detected or missed, and when it was seen during the time period. + AggregatedUtterancesSummaries []*AggregatedUtterancesSummary `locationName:"aggregatedUtterancesSummaries" type:"list"` + + // The time period used to aggregate the utterance data. + AggregationDuration *UtteranceAggregationDuration `locationName:"aggregationDuration" type:"structure"` + + // The last date and time that the aggregated data was collected. The time period + // depends on the length of the aggregation window. // - // KendraIndex is a required field - KendraIndex *string `locationName:"kendraIndex" min:"32" type:"string" required:"true"` + // * Hours - for 1 hour time window, every half hour; otherwise every hour. + // + // * Days - every 6 hours + // + // * Weeks - for a one week time window, every 12 hours; otherwise, every + // day + AggregationLastRefreshedDateTime *time.Time `locationName:"aggregationLastRefreshedDateTime" type:"timestamp"` - // A query filter that Amazon Lex sends to Amazon Kendra to filter the response - // from a query. The filter is in the format defined by Amazon Kendra. For more - // information, see Filtering queries (https://docs.aws.amazon.com/kendra/latest/dg/filtering.html). - QueryFilterString *string `locationName:"queryFilterString" min:"1" type:"string"` + // The date and time that the aggregation window ends. Only data collected between + // the start time and the end time are returned in the results. + AggregationWindowEndTime *time.Time `locationName:"aggregationWindowEndTime" type:"timestamp"` - // Determines whether the AMAZON.KendraSearchIntent intent uses a custom query - // string to query the Amazon Kendra index. - QueryFilterStringEnabled *bool `locationName:"queryFilterStringEnabled" type:"boolean"` + // The date and time that the aggregation window begins. Only data collected + // after this time is returned in the results. + AggregationWindowStartTime *time.Time `locationName:"aggregationWindowStartTime" type:"timestamp"` + + // The identifier of the bot alias that contains the utterances. If you specified + // the bot version, the bot alias ID isn't returned. + BotAliasId *string `locationName:"botAliasId" min:"10" type:"string"` + + // The identifier of the bot that contains the utterances. + BotId *string `locationName:"botId" min:"10" type:"string"` + + // The identifier of the bot version that contains the utterances. If you specified + // the bot alias, the bot version isn't returned. + BotVersion *string `locationName:"botVersion" min:"1" type:"string"` + + // The identifier of the language and locale that the utterances are in. + LocaleId *string `locationName:"localeId" type:"string"` + + // A token that indicates whether there are more results to return in a response + // to the ListAggregatedUtterances operation. If the nextToken field is present, + // you send the contents as the nextToken parameter of a ListAggregatedUtterances + // operation request to get the next page of results. + NextToken *string `locationName:"nextToken" type:"string"` } // String returns the string representation. @@ -14978,7 +16367,7 @@ type KendraConfiguration struct { // 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 KendraConfiguration) String() string { +func (s ListAggregatedUtterancesOutput) String() string { return awsutil.Prettify(s) } @@ -14987,113 +16376,67 @@ func (s KendraConfiguration) String() string { // 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 KendraConfiguration) GoString() string { +func (s ListAggregatedUtterancesOutput) GoString() string { return s.String() } -// Validate inspects the fields of the type to determine if they are valid. -func (s *KendraConfiguration) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "KendraConfiguration"} - if s.KendraIndex == nil { - invalidParams.Add(request.NewErrParamRequired("KendraIndex")) - } - if s.KendraIndex != nil && len(*s.KendraIndex) < 32 { - invalidParams.Add(request.NewErrParamMinLen("KendraIndex", 32)) - } - if s.QueryFilterString != nil && len(*s.QueryFilterString) < 1 { - invalidParams.Add(request.NewErrParamMinLen("QueryFilterString", 1)) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil +// SetAggregatedUtterancesSummaries sets the AggregatedUtterancesSummaries field's value. +func (s *ListAggregatedUtterancesOutput) SetAggregatedUtterancesSummaries(v []*AggregatedUtterancesSummary) *ListAggregatedUtterancesOutput { + s.AggregatedUtterancesSummaries = v + return s } -// SetKendraIndex sets the KendraIndex field's value. -func (s *KendraConfiguration) SetKendraIndex(v string) *KendraConfiguration { - s.KendraIndex = &v +// SetAggregationDuration sets the AggregationDuration field's value. +func (s *ListAggregatedUtterancesOutput) SetAggregationDuration(v *UtteranceAggregationDuration) *ListAggregatedUtterancesOutput { + s.AggregationDuration = v return s } -// SetQueryFilterString sets the QueryFilterString field's value. -func (s *KendraConfiguration) SetQueryFilterString(v string) *KendraConfiguration { - s.QueryFilterString = &v +// SetAggregationLastRefreshedDateTime sets the AggregationLastRefreshedDateTime field's value. +func (s *ListAggregatedUtterancesOutput) SetAggregationLastRefreshedDateTime(v time.Time) *ListAggregatedUtterancesOutput { + s.AggregationLastRefreshedDateTime = &v return s } -// SetQueryFilterStringEnabled sets the QueryFilterStringEnabled field's value. -func (s *KendraConfiguration) SetQueryFilterStringEnabled(v bool) *KendraConfiguration { - s.QueryFilterStringEnabled = &v +// SetAggregationWindowEndTime sets the AggregationWindowEndTime field's value. +func (s *ListAggregatedUtterancesOutput) SetAggregationWindowEndTime(v time.Time) *ListAggregatedUtterancesOutput { + s.AggregationWindowEndTime = &v return s } -// Specifies a Lambda function that verifies requests to a bot or fulfilles -// the user's request to a bot. -type LambdaCodeHook struct { - _ struct{} `type:"structure"` - - // The version of the request-response that you want Amazon Lex to use to invoke - // your Lambda function. - // - // CodeHookInterfaceVersion is a required field - CodeHookInterfaceVersion *string `locationName:"codeHookInterfaceVersion" min:"1" type:"string" required:"true"` - - // The Amazon Resource Name (ARN) of the Lambda function. - // - // LambdaARN is a required field - LambdaARN *string `locationName:"lambdaARN" min:"20" type:"string" required:"true"` +// SetAggregationWindowStartTime sets the AggregationWindowStartTime field's value. +func (s *ListAggregatedUtterancesOutput) SetAggregationWindowStartTime(v time.Time) *ListAggregatedUtterancesOutput { + s.AggregationWindowStartTime = &v + return s } -// 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 LambdaCodeHook) String() string { - return awsutil.Prettify(s) +// SetBotAliasId sets the BotAliasId field's value. +func (s *ListAggregatedUtterancesOutput) SetBotAliasId(v string) *ListAggregatedUtterancesOutput { + s.BotAliasId = &v + return 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 LambdaCodeHook) GoString() string { - return s.String() +// SetBotId sets the BotId field's value. +func (s *ListAggregatedUtterancesOutput) SetBotId(v string) *ListAggregatedUtterancesOutput { + s.BotId = &v + return s } -// Validate inspects the fields of the type to determine if they are valid. -func (s *LambdaCodeHook) Validate() error { - invalidParams := request.ErrInvalidParams{Context: "LambdaCodeHook"} - if s.CodeHookInterfaceVersion == nil { - invalidParams.Add(request.NewErrParamRequired("CodeHookInterfaceVersion")) - } - if s.CodeHookInterfaceVersion != nil && len(*s.CodeHookInterfaceVersion) < 1 { - invalidParams.Add(request.NewErrParamMinLen("CodeHookInterfaceVersion", 1)) - } - if s.LambdaARN == nil { - invalidParams.Add(request.NewErrParamRequired("LambdaARN")) - } - if s.LambdaARN != nil && len(*s.LambdaARN) < 20 { - invalidParams.Add(request.NewErrParamMinLen("LambdaARN", 20)) - } - - if invalidParams.Len() > 0 { - return invalidParams - } - return nil +// SetBotVersion sets the BotVersion field's value. +func (s *ListAggregatedUtterancesOutput) SetBotVersion(v string) *ListAggregatedUtterancesOutput { + s.BotVersion = &v + return s } -// SetCodeHookInterfaceVersion sets the CodeHookInterfaceVersion field's value. -func (s *LambdaCodeHook) SetCodeHookInterfaceVersion(v string) *LambdaCodeHook { - s.CodeHookInterfaceVersion = &v +// SetLocaleId sets the LocaleId field's value. +func (s *ListAggregatedUtterancesOutput) SetLocaleId(v string) *ListAggregatedUtterancesOutput { + s.LocaleId = &v return s } -// SetLambdaARN sets the LambdaARN field's value. -func (s *LambdaCodeHook) SetLambdaARN(v string) *LambdaCodeHook { - s.LambdaARN = &v +// SetNextToken sets the NextToken field's value. +func (s *ListAggregatedUtterancesOutput) SetNextToken(v string) *ListAggregatedUtterancesOutput { + s.NextToken = &v return s } @@ -17529,6 +18872,8 @@ func (s *PlainTextMessage) SetValue(v string) *PlainTextMessage { return s } +// Your request couldn't be completed because one or more request fields aren't +// valid. Check the fields in your request and try again. type PreconditionFailedException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -17738,6 +19083,96 @@ func (s *PromptSpecification) SetMessageGroups(v []*MessageGroup) *PromptSpecifi return s } +// Specifies the time window that utterance statistics are returned for. The +// time window is always relative to the last time that the that utterances +// were aggregated. For example, if the ListAggregatedUtterances operation is +// called at 1600, the time window is set to 1 hour, and the last refresh time +// was 1530, only utterances made between 1430 and 1530 are returned. +// +// You can choose the time window that statistics should be returned for. +// +// * Hours - You can request utterance statistics for 1, 3, 6, 12, or 24 +// hour time windows. Statistics are refreshed every half hour for 1 hour +// time windows, and hourly for the other time windows. +// +// * Days - You can request utterance statistics for 3 days. Statistics are +// refreshed every 6 hours. +// +// * Weeks - You can see statistics for one or two weeks. Statistics are +// refreshed every 12 hours for one week time windows, and once per day for +// two week time windows. +type RelativeAggregationDuration struct { + _ struct{} `type:"structure"` + + // The type of time period that the timeValue field represents. + // + // TimeDimension is a required field + TimeDimension *string `locationName:"timeDimension" type:"string" required:"true" enum:"TimeDimension"` + + // The period of the time window to gather statistics for. The valid value depends + // on the setting of the timeDimension field. + // + // * Hours - 1/3/6/12/24 + // + // * Days - 3 + // + // * Weeks - 1/2 + // + // TimeValue is a required field + TimeValue *int64 `locationName:"timeValue" min:"1" type:"integer" 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 RelativeAggregationDuration) 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 RelativeAggregationDuration) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *RelativeAggregationDuration) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "RelativeAggregationDuration"} + if s.TimeDimension == nil { + invalidParams.Add(request.NewErrParamRequired("TimeDimension")) + } + if s.TimeValue == nil { + invalidParams.Add(request.NewErrParamRequired("TimeValue")) + } + if s.TimeValue != nil && *s.TimeValue < 1 { + invalidParams.Add(request.NewErrParamMinValue("TimeValue", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetTimeDimension sets the TimeDimension field's value. +func (s *RelativeAggregationDuration) SetTimeDimension(v string) *RelativeAggregationDuration { + s.TimeDimension = &v + return s +} + +// SetTimeValue sets the TimeValue field's value. +func (s *RelativeAggregationDuration) SetTimeValue(v int64) *RelativeAggregationDuration { + s.TimeValue = &v + return s +} + +// You asked to describe a resource that doesn't exist. Check the resource that +// you are requesting and try again. type ResourceNotFoundException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -18148,6 +19583,7 @@ func (s *SentimentAnalysisSettings) SetDetectSentiment(v bool) *SentimentAnalysi return s } +// You have reached a quota for your bot. type ServiceQuotaExceededException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -19636,6 +21072,7 @@ func (s *TextLogSetting) SetEnabled(v bool) *TextLogSetting { return s } +// Your request rate is too high. Reduce the frequency of requests. type ThrottlingException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -21971,6 +23408,61 @@ func (s *UpdateSlotTypeOutput) SetValueSelectionSetting(v *SlotValueSelectionSet return s } +// Provides parameters for setting the time window and duration for aggregating +// utterance data. +type UtteranceAggregationDuration struct { + _ struct{} `type:"structure"` + + // The desired time window for aggregating utterances. + // + // RelativeAggregationDuration is a required field + RelativeAggregationDuration *RelativeAggregationDuration `locationName:"relativeAggregationDuration" 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 UtteranceAggregationDuration) 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 UtteranceAggregationDuration) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *UtteranceAggregationDuration) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "UtteranceAggregationDuration"} + if s.RelativeAggregationDuration == nil { + invalidParams.Add(request.NewErrParamRequired("RelativeAggregationDuration")) + } + if s.RelativeAggregationDuration != nil { + if err := s.RelativeAggregationDuration.Validate(); err != nil { + invalidParams.AddNested("RelativeAggregationDuration", err.(request.ErrInvalidParams)) + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetRelativeAggregationDuration sets the RelativeAggregationDuration field's value. +func (s *UtteranceAggregationDuration) SetRelativeAggregationDuration(v *RelativeAggregationDuration) *UtteranceAggregationDuration { + s.RelativeAggregationDuration = v + return s +} + +// One of the input parameters in your request isn't valid. Check the parameters +// and try your request again. type ValidationException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -22182,6 +23674,50 @@ func (s *WaitAndContinueSpecification) SetWaitingResponse(v *ResponseSpecificati return s } +const ( + // AggregatedUtterancesFilterNameUtterance is a AggregatedUtterancesFilterName enum value + AggregatedUtterancesFilterNameUtterance = "Utterance" +) + +// AggregatedUtterancesFilterName_Values returns all elements of the AggregatedUtterancesFilterName enum +func AggregatedUtterancesFilterName_Values() []string { + return []string{ + AggregatedUtterancesFilterNameUtterance, + } +} + +const ( + // AggregatedUtterancesFilterOperatorCo is a AggregatedUtterancesFilterOperator enum value + AggregatedUtterancesFilterOperatorCo = "CO" + + // AggregatedUtterancesFilterOperatorEq is a AggregatedUtterancesFilterOperator enum value + AggregatedUtterancesFilterOperatorEq = "EQ" +) + +// AggregatedUtterancesFilterOperator_Values returns all elements of the AggregatedUtterancesFilterOperator enum +func AggregatedUtterancesFilterOperator_Values() []string { + return []string{ + AggregatedUtterancesFilterOperatorCo, + AggregatedUtterancesFilterOperatorEq, + } +} + +const ( + // AggregatedUtterancesSortAttributeHitCount is a AggregatedUtterancesSortAttribute enum value + AggregatedUtterancesSortAttributeHitCount = "HitCount" + + // AggregatedUtterancesSortAttributeMissedCount is a AggregatedUtterancesSortAttribute enum value + AggregatedUtterancesSortAttributeMissedCount = "MissedCount" +) + +// AggregatedUtterancesSortAttribute_Values returns all elements of the AggregatedUtterancesSortAttribute enum +func AggregatedUtterancesSortAttribute_Values() []string { + return []string{ + AggregatedUtterancesSortAttributeHitCount, + AggregatedUtterancesSortAttributeMissedCount, + } +} + const ( // BotAliasStatusCreating is a BotAliasStatus enum value BotAliasStatusCreating = "Creating" @@ -22765,3 +24301,23 @@ func SortOrder_Values() []string { SortOrderDescending, } } + +const ( + // TimeDimensionHours is a TimeDimension enum value + TimeDimensionHours = "Hours" + + // TimeDimensionDays is a TimeDimension enum value + TimeDimensionDays = "Days" + + // TimeDimensionWeeks is a TimeDimension enum value + TimeDimensionWeeks = "Weeks" +) + +// TimeDimension_Values returns all elements of the TimeDimension enum +func TimeDimension_Values() []string { + return []string{ + TimeDimensionHours, + TimeDimensionDays, + TimeDimensionWeeks, + } +} diff --git a/service/lexmodelsv2/errors.go b/service/lexmodelsv2/errors.go index 9c49413b1fe..8e0072addf4 100644 --- a/service/lexmodelsv2/errors.go +++ b/service/lexmodelsv2/errors.go @@ -10,30 +10,49 @@ const ( // ErrCodeConflictException for service response error code // "ConflictException". + // + // The action that you tried to perform couldn't be completed because the resource + // is in a conflicting state. For example, deleting a bot that is in the CREATING + // state. Try your request again. ErrCodeConflictException = "ConflictException" // ErrCodeInternalServerException for service response error code // "InternalServerException". + // + // The service encountered an unexpected condition. Try your request again. ErrCodeInternalServerException = "InternalServerException" // ErrCodePreconditionFailedException for service response error code // "PreconditionFailedException". + // + // Your request couldn't be completed because one or more request fields aren't + // valid. Check the fields in your request and try again. ErrCodePreconditionFailedException = "PreconditionFailedException" // ErrCodeResourceNotFoundException for service response error code // "ResourceNotFoundException". + // + // You asked to describe a resource that doesn't exist. Check the resource that + // you are requesting and try again. ErrCodeResourceNotFoundException = "ResourceNotFoundException" // ErrCodeServiceQuotaExceededException for service response error code // "ServiceQuotaExceededException". + // + // You have reached a quota for your bot. ErrCodeServiceQuotaExceededException = "ServiceQuotaExceededException" // ErrCodeThrottlingException for service response error code // "ThrottlingException". + // + // Your request rate is too high. Reduce the frequency of requests. ErrCodeThrottlingException = "ThrottlingException" // ErrCodeValidationException for service response error code // "ValidationException". + // + // One of the input parameters in your request isn't valid. Check the parameters + // and try your request again. ErrCodeValidationException = "ValidationException" ) diff --git a/service/lexmodelsv2/lexmodelsv2iface/interface.go b/service/lexmodelsv2/lexmodelsv2iface/interface.go index 5a4224cbb71..bd816a842ca 100644 --- a/service/lexmodelsv2/lexmodelsv2iface/interface.go +++ b/service/lexmodelsv2/lexmodelsv2iface/interface.go @@ -152,6 +152,10 @@ type LexModelsV2API interface { DeleteSlotTypeWithContext(aws.Context, *lexmodelsv2.DeleteSlotTypeInput, ...request.Option) (*lexmodelsv2.DeleteSlotTypeOutput, error) DeleteSlotTypeRequest(*lexmodelsv2.DeleteSlotTypeInput) (*request.Request, *lexmodelsv2.DeleteSlotTypeOutput) + DeleteUtterances(*lexmodelsv2.DeleteUtterancesInput) (*lexmodelsv2.DeleteUtterancesOutput, error) + DeleteUtterancesWithContext(aws.Context, *lexmodelsv2.DeleteUtterancesInput, ...request.Option) (*lexmodelsv2.DeleteUtterancesOutput, error) + DeleteUtterancesRequest(*lexmodelsv2.DeleteUtterancesInput) (*request.Request, *lexmodelsv2.DeleteUtterancesOutput) + DescribeBot(*lexmodelsv2.DescribeBotInput) (*lexmodelsv2.DescribeBotOutput, error) DescribeBotWithContext(aws.Context, *lexmodelsv2.DescribeBotInput, ...request.Option) (*lexmodelsv2.DescribeBotOutput, error) DescribeBotRequest(*lexmodelsv2.DescribeBotInput) (*request.Request, *lexmodelsv2.DescribeBotOutput) @@ -192,6 +196,13 @@ type LexModelsV2API interface { DescribeSlotTypeWithContext(aws.Context, *lexmodelsv2.DescribeSlotTypeInput, ...request.Option) (*lexmodelsv2.DescribeSlotTypeOutput, error) DescribeSlotTypeRequest(*lexmodelsv2.DescribeSlotTypeInput) (*request.Request, *lexmodelsv2.DescribeSlotTypeOutput) + ListAggregatedUtterances(*lexmodelsv2.ListAggregatedUtterancesInput) (*lexmodelsv2.ListAggregatedUtterancesOutput, error) + ListAggregatedUtterancesWithContext(aws.Context, *lexmodelsv2.ListAggregatedUtterancesInput, ...request.Option) (*lexmodelsv2.ListAggregatedUtterancesOutput, error) + ListAggregatedUtterancesRequest(*lexmodelsv2.ListAggregatedUtterancesInput) (*request.Request, *lexmodelsv2.ListAggregatedUtterancesOutput) + + ListAggregatedUtterancesPages(*lexmodelsv2.ListAggregatedUtterancesInput, func(*lexmodelsv2.ListAggregatedUtterancesOutput, bool) bool) error + ListAggregatedUtterancesPagesWithContext(aws.Context, *lexmodelsv2.ListAggregatedUtterancesInput, func(*lexmodelsv2.ListAggregatedUtterancesOutput, bool) bool, ...request.Option) error + ListBotAliases(*lexmodelsv2.ListBotAliasesInput) (*lexmodelsv2.ListBotAliasesOutput, error) ListBotAliasesWithContext(aws.Context, *lexmodelsv2.ListBotAliasesInput, ...request.Option) (*lexmodelsv2.ListBotAliasesOutput, error) ListBotAliasesRequest(*lexmodelsv2.ListBotAliasesInput) (*request.Request, *lexmodelsv2.ListBotAliasesOutput) diff --git a/service/licensemanager/api.go b/service/licensemanager/api.go index d530b31d725..9ce74f0abf5 100644 --- a/service/licensemanager/api.go +++ b/service/licensemanager/api.go @@ -74,8 +74,8 @@ func (c *LicenseManager) AcceptGrantRequest(input *AcceptGrantInput) (req *reque // One or more parameter values are not valid. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -180,8 +180,8 @@ func (c *LicenseManager) CheckInLicenseRequest(input *CheckInLicenseInput) (req // There was a conflict processing the request. Try your request again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -291,8 +291,8 @@ func (c *LicenseManager) CheckoutBorrowLicenseRequest(input *CheckoutBorrowLicen // This is not the correct Region for the resource. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -399,8 +399,8 @@ func (c *LicenseManager) CheckoutLicenseRequest(input *CheckoutLicenseInput) (re // This is not the correct Region for the resource. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -478,7 +478,7 @@ func (c *LicenseManager) CreateGrantRequest(input *CreateGrantInput) (req *reque // CreateGrant API operation for AWS License Manager. // // Creates a grant for the specified license. A grant shares the use of license -// entitlements with specific AWS accounts. +// entitlements with specific Amazon Web Services accounts. // // 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 @@ -501,8 +501,8 @@ func (c *LicenseManager) CreateGrantRequest(input *CreateGrantInput) (req *reque // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * RateLimitExceededException // Too many requests have been submitted. Try again after a brief wait. @@ -599,8 +599,8 @@ func (c *LicenseManager) CreateGrantVersionRequest(input *CreateGrantVersionInpu // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -694,8 +694,8 @@ func (c *LicenseManager) CreateLicenseRequest(input *CreateLicenseInput) (req *r // This is not the correct Region for the resource. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -799,8 +799,8 @@ func (c *LicenseManager) CreateLicenseConfigurationRequest(input *CreateLicenseC // Your resource limits have been exceeded. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -830,6 +830,101 @@ func (c *LicenseManager) CreateLicenseConfigurationWithContext(ctx aws.Context, return out, req.Send() } +const opCreateLicenseConversionTaskForResource = "CreateLicenseConversionTaskForResource" + +// CreateLicenseConversionTaskForResourceRequest generates a "aws/request.Request" representing the +// client's request for the CreateLicenseConversionTaskForResource 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 CreateLicenseConversionTaskForResource for more information on using the CreateLicenseConversionTaskForResource +// 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 CreateLicenseConversionTaskForResourceRequest method. +// req, resp := client.CreateLicenseConversionTaskForResourceRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/license-manager-2018-08-01/CreateLicenseConversionTaskForResource +func (c *LicenseManager) CreateLicenseConversionTaskForResourceRequest(input *CreateLicenseConversionTaskForResourceInput) (req *request.Request, output *CreateLicenseConversionTaskForResourceOutput) { + op := &request.Operation{ + Name: opCreateLicenseConversionTaskForResource, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &CreateLicenseConversionTaskForResourceInput{} + } + + output = &CreateLicenseConversionTaskForResourceOutput{} + req = c.newRequest(op, input, output) + return +} + +// CreateLicenseConversionTaskForResource API operation for AWS License Manager. +// +// Creates a new license conversion task. +// +// 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 AWS License Manager's +// API operation CreateLicenseConversionTaskForResource for usage and error information. +// +// Returned Error Types: +// * InvalidParameterValueException +// One or more parameter values are not valid. +// +// * ValidationException +// The provided input is not valid. Try your request again. +// +// * ServerInternalException +// The server experienced an internal error. Try again. +// +// * AuthorizationException +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. +// +// * AccessDeniedException +// Access to resource denied. +// +// * RateLimitExceededException +// Too many requests have been submitted. Try again after a brief wait. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/license-manager-2018-08-01/CreateLicenseConversionTaskForResource +func (c *LicenseManager) CreateLicenseConversionTaskForResource(input *CreateLicenseConversionTaskForResourceInput) (*CreateLicenseConversionTaskForResourceOutput, error) { + req, out := c.CreateLicenseConversionTaskForResourceRequest(input) + return out, req.Send() +} + +// CreateLicenseConversionTaskForResourceWithContext is the same as CreateLicenseConversionTaskForResource with the addition of +// the ability to pass a context and additional request options. +// +// See CreateLicenseConversionTaskForResource 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 *LicenseManager) CreateLicenseConversionTaskForResourceWithContext(ctx aws.Context, input *CreateLicenseConversionTaskForResourceInput, opts ...request.Option) (*CreateLicenseConversionTaskForResourceOutput, error) { + req, out := c.CreateLicenseConversionTaskForResourceRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opCreateLicenseManagerReportGenerator = "CreateLicenseManagerReportGenerator" // CreateLicenseManagerReportGeneratorRequest generates a "aws/request.Request" representing the @@ -874,7 +969,7 @@ func (c *LicenseManager) CreateLicenseManagerReportGeneratorRequest(input *Creat // CreateLicenseManagerReportGenerator API operation for AWS License Manager. // -// Creates a new report generator. +// Creates a report generator. // // 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 @@ -897,8 +992,8 @@ func (c *LicenseManager) CreateLicenseManagerReportGeneratorRequest(input *Creat // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * RateLimitExceededException // Too many requests have been submitted. Try again after a brief wait. @@ -1004,8 +1099,8 @@ func (c *LicenseManager) CreateLicenseVersionRequest(input *CreateLicenseVersion // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * RateLimitExceededException // Too many requests have been submitted. Try again after a brief wait. @@ -1094,8 +1189,8 @@ func (c *LicenseManager) CreateTokenRequest(input *CreateTokenInput) (req *reque // The provided input is not valid. Try your request again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -1198,8 +1293,8 @@ func (c *LicenseManager) DeleteGrantRequest(input *DeleteGrantInput) (req *reque // One or more parameter values are not valid. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -1305,8 +1400,8 @@ func (c *LicenseManager) DeleteLicenseRequest(input *DeleteLicenseInput) (req *r // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -1400,8 +1495,8 @@ func (c *LicenseManager) DeleteLicenseConfigurationRequest(input *DeleteLicenseC // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -1476,11 +1571,11 @@ func (c *LicenseManager) DeleteLicenseManagerReportGeneratorRequest(input *Delet // DeleteLicenseManagerReportGenerator API operation for AWS License Manager. // -// Delete an existing report generator. +// Deletes the specified report generator. // // This action deletes the report generator, which stops it from generating -// future reports and cannot be reversed. However, the previous reports from -// this generator will remain in your S3 bucket. +// future reports. The action cannot be reversed. It has no effect on the previous +// reports from this generator. // // 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 @@ -1503,8 +1598,8 @@ func (c *LicenseManager) DeleteLicenseManagerReportGeneratorRequest(input *Delet // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * RateLimitExceededException // Too many requests have been submitted. Try again after a brief wait. @@ -1596,8 +1691,8 @@ func (c *LicenseManager) DeleteTokenRequest(input *DeleteTokenInput) (req *reque // The provided input is not valid. Try your request again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -1697,8 +1792,8 @@ func (c *LicenseManager) ExtendLicenseConsumptionRequest(input *ExtendLicenseCon // One or more parameter values are not valid. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -1793,8 +1888,8 @@ func (c *LicenseManager) GetAccessTokenRequest(input *GetAccessTokenInput) (req // The provided input is not valid. Try your request again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -1894,8 +1989,8 @@ func (c *LicenseManager) GetGrantRequest(input *GetGrantInput) (req *request.Req // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -1986,8 +2081,8 @@ func (c *LicenseManager) GetLicenseRequest(input *GetLicenseInput) (req *request // One or more parameter values are not valid. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -2081,8 +2176,8 @@ func (c *LicenseManager) GetLicenseConfigurationRequest(input *GetLicenseConfigu // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -2112,6 +2207,98 @@ func (c *LicenseManager) GetLicenseConfigurationWithContext(ctx aws.Context, inp return out, req.Send() } +const opGetLicenseConversionTask = "GetLicenseConversionTask" + +// GetLicenseConversionTaskRequest generates a "aws/request.Request" representing the +// client's request for the GetLicenseConversionTask 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 GetLicenseConversionTask for more information on using the GetLicenseConversionTask +// 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 GetLicenseConversionTaskRequest method. +// req, resp := client.GetLicenseConversionTaskRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/license-manager-2018-08-01/GetLicenseConversionTask +func (c *LicenseManager) GetLicenseConversionTaskRequest(input *GetLicenseConversionTaskInput) (req *request.Request, output *GetLicenseConversionTaskOutput) { + op := &request.Operation{ + Name: opGetLicenseConversionTask, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &GetLicenseConversionTaskInput{} + } + + output = &GetLicenseConversionTaskOutput{} + req = c.newRequest(op, input, output) + return +} + +// GetLicenseConversionTask API operation for AWS License Manager. +// +// Gets information about the specified license type conversion task. +// +// 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 AWS License Manager's +// API operation GetLicenseConversionTask for usage and error information. +// +// Returned Error Types: +// * InvalidParameterValueException +// One or more parameter values are not valid. +// +// * ServerInternalException +// The server experienced an internal error. Try again. +// +// * AuthorizationException +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. +// +// * AccessDeniedException +// Access to resource denied. +// +// * RateLimitExceededException +// Too many requests have been submitted. Try again after a brief wait. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/license-manager-2018-08-01/GetLicenseConversionTask +func (c *LicenseManager) GetLicenseConversionTask(input *GetLicenseConversionTaskInput) (*GetLicenseConversionTaskOutput, error) { + req, out := c.GetLicenseConversionTaskRequest(input) + return out, req.Send() +} + +// GetLicenseConversionTaskWithContext is the same as GetLicenseConversionTask with the addition of +// the ability to pass a context and additional request options. +// +// See GetLicenseConversionTask 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 *LicenseManager) GetLicenseConversionTaskWithContext(ctx aws.Context, input *GetLicenseConversionTaskInput, opts ...request.Option) (*GetLicenseConversionTaskOutput, error) { + req, out := c.GetLicenseConversionTaskRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opGetLicenseManagerReportGenerator = "GetLicenseManagerReportGenerator" // GetLicenseManagerReportGeneratorRequest generates a "aws/request.Request" representing the @@ -2156,7 +2343,7 @@ func (c *LicenseManager) GetLicenseManagerReportGeneratorRequest(input *GetLicen // GetLicenseManagerReportGenerator API operation for AWS License Manager. // -// Gets information on the specified report generator. +// Gets information about the specified report generator. // // 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 @@ -2179,8 +2366,8 @@ func (c *LicenseManager) GetLicenseManagerReportGeneratorRequest(input *GetLicen // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * RateLimitExceededException // Too many requests have been submitted. Try again after a brief wait. @@ -2274,8 +2461,8 @@ func (c *LicenseManager) GetLicenseUsageRequest(input *GetLicenseUsageInput) (re // One or more parameter values are not valid. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -2366,8 +2553,8 @@ func (c *LicenseManager) GetServiceSettingsRequest(input *GetServiceSettingsInpu // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -2465,8 +2652,8 @@ func (c *LicenseManager) ListAssociationsForLicenseConfigurationRequest(input *L // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -2563,8 +2750,8 @@ func (c *LicenseManager) ListDistributedGrantsRequest(input *ListDistributedGran // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -2655,8 +2842,8 @@ func (c *LicenseManager) ListFailuresForLicenseConfigurationOperationsRequest(in // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -2750,8 +2937,8 @@ func (c *LicenseManager) ListLicenseConfigurationsRequest(input *ListLicenseConf // The request uses too many filters or too many filter values. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -2781,6 +2968,98 @@ func (c *LicenseManager) ListLicenseConfigurationsWithContext(ctx aws.Context, i return out, req.Send() } +const opListLicenseConversionTasks = "ListLicenseConversionTasks" + +// ListLicenseConversionTasksRequest generates a "aws/request.Request" representing the +// client's request for the ListLicenseConversionTasks 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 ListLicenseConversionTasks for more information on using the ListLicenseConversionTasks +// 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 ListLicenseConversionTasksRequest method. +// req, resp := client.ListLicenseConversionTasksRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/license-manager-2018-08-01/ListLicenseConversionTasks +func (c *LicenseManager) ListLicenseConversionTasksRequest(input *ListLicenseConversionTasksInput) (req *request.Request, output *ListLicenseConversionTasksOutput) { + op := &request.Operation{ + Name: opListLicenseConversionTasks, + HTTPMethod: "POST", + HTTPPath: "/", + } + + if input == nil { + input = &ListLicenseConversionTasksInput{} + } + + output = &ListLicenseConversionTasksOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListLicenseConversionTasks API operation for AWS License Manager. +// +// Lists the license type conversion tasks for your account. +// +// 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 AWS License Manager's +// API operation ListLicenseConversionTasks for usage and error information. +// +// Returned Error Types: +// * InvalidParameterValueException +// One or more parameter values are not valid. +// +// * ServerInternalException +// The server experienced an internal error. Try again. +// +// * AuthorizationException +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. +// +// * AccessDeniedException +// Access to resource denied. +// +// * RateLimitExceededException +// Too many requests have been submitted. Try again after a brief wait. +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/license-manager-2018-08-01/ListLicenseConversionTasks +func (c *LicenseManager) ListLicenseConversionTasks(input *ListLicenseConversionTasksInput) (*ListLicenseConversionTasksOutput, error) { + req, out := c.ListLicenseConversionTasksRequest(input) + return out, req.Send() +} + +// ListLicenseConversionTasksWithContext is the same as ListLicenseConversionTasks with the addition of +// the ability to pass a context and additional request options. +// +// See ListLicenseConversionTasks 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 *LicenseManager) ListLicenseConversionTasksWithContext(ctx aws.Context, input *ListLicenseConversionTasksInput, opts ...request.Option) (*ListLicenseConversionTasksOutput, error) { + req, out := c.ListLicenseConversionTasksRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opListLicenseManagerReportGenerators = "ListLicenseManagerReportGenerators" // ListLicenseManagerReportGeneratorsRequest generates a "aws/request.Request" representing the @@ -2848,8 +3127,8 @@ func (c *LicenseManager) ListLicenseManagerReportGeneratorsRequest(input *ListLi // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * RateLimitExceededException // Too many requests have been submitted. Try again after a brief wait. @@ -2943,8 +3222,8 @@ func (c *LicenseManager) ListLicenseSpecificationsForResourceRequest(input *List // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -3032,8 +3311,8 @@ func (c *LicenseManager) ListLicenseVersionsRequest(input *ListLicenseVersionsIn // One or more parameter values are not valid. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -3127,8 +3406,8 @@ func (c *LicenseManager) ListLicensesRequest(input *ListLicensesInput) (req *req // One or more parameter values are not valid. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -3228,8 +3507,8 @@ func (c *LicenseManager) ListReceivedGrantsRequest(input *ListReceivedGrantsInpu // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -3326,8 +3605,8 @@ func (c *LicenseManager) ListReceivedLicensesRequest(input *ListReceivedLicenses // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -3424,8 +3703,8 @@ func (c *LicenseManager) ListResourceInventoryRequest(input *ListResourceInvento // A dependency required to run the API is missing. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -3516,8 +3795,8 @@ func (c *LicenseManager) ListTagsForResourceRequest(input *ListTagsForResourceIn // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -3605,8 +3884,8 @@ func (c *LicenseManager) ListTokensRequest(input *ListTokensInput) (req *request // The provided input is not valid. Try your request again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -3705,8 +3984,8 @@ func (c *LicenseManager) ListUsageForLicenseConfigurationRequest(input *ListUsag // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -3797,8 +4076,8 @@ func (c *LicenseManager) RejectGrantRequest(input *RejectGrantInput) (req *reque // One or more parameter values are not valid. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -3896,8 +4175,8 @@ func (c *LicenseManager) TagResourceRequest(input *TagResourceInput) (req *reque // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -3989,8 +4268,8 @@ func (c *LicenseManager) UntagResourceRequest(input *UntagResourceInput) (req *r // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -4082,8 +4361,8 @@ func (c *LicenseManager) UpdateLicenseConfigurationRequest(input *UpdateLicenseC // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -4163,8 +4442,8 @@ func (c *LicenseManager) UpdateLicenseManagerReportGeneratorRequest(input *Updat // // Updates a report generator. // -// After you make changes to a report generator, it will start generating new -// reports within 60 minutes of being updated. +// After you make changes to a report generator, it starts generating new reports +// within 60 minutes of being updated. // // 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 @@ -4187,8 +4466,8 @@ func (c *LicenseManager) UpdateLicenseManagerReportGeneratorRequest(input *Updat // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -4266,13 +4545,13 @@ func (c *LicenseManager) UpdateLicenseSpecificationsForResourceRequest(input *Up // UpdateLicenseSpecificationsForResource API operation for AWS License Manager. // -// Adds or removes the specified license configurations for the specified AWS -// resource. +// Adds or removes the specified license configurations for the specified Amazon +// Web Services resource. // // You can update the license specifications of AMIs, instances, and hosts. -// You cannot update the license specifications for launch templates and AWS -// CloudFormation templates, as they send license configurations to the operation -// that creates the resource. +// You cannot update the license specifications for launch templates and CloudFormation +// templates, as they send license configurations to the operation that creates +// the 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 @@ -4298,8 +4577,8 @@ func (c *LicenseManager) UpdateLicenseSpecificationsForResourceRequest(input *Up // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -4391,8 +4670,8 @@ func (c *LicenseManager) UpdateServiceSettingsRequest(input *UpdateServiceSettin // The server experienced an internal error. Try again. // // * AuthorizationException -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. // // * AccessDeniedException // Access to resource denied. @@ -4581,8 +4860,8 @@ func (s *AccessDeniedException) RequestID() string { return s.RespMetadata.RequestID } -// The AWS user account does not have permission to perform the action. Check -// the IAM policy associated with this account. +// The Amazon Web Services user account does not have permission to perform +// the action. Check the IAM policy associated with this account. type AuthorizationException struct { _ struct{} `type:"structure"` RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` @@ -5619,6 +5898,7 @@ type CreateGrantVersionInput struct { // Grant status. Status *string `type:"string" enum:"GrantStatus"` + // Grant status reason. StatusReason *string `type:"string"` } @@ -5933,6 +6213,118 @@ func (s *CreateLicenseConfigurationOutput) SetLicenseConfigurationArn(v string) return s } +type CreateLicenseConversionTaskForResourceInput struct { + _ struct{} `type:"structure"` + + // Information that identifies the license type you are converting to. For the + // structure of the destination license, see Convert a license type using the + // AWS CLI (https://docs.aws.amazon.com/license-manager/latest/userguide/conversion-procedures.html#conversion-cli) + // in the License Manager User Guide. + // + // DestinationLicenseContext is a required field + DestinationLicenseContext *LicenseConversionContext `type:"structure" required:"true"` + + // Amazon Resource Name (ARN) of the resource you are converting the license + // type for. + // + // ResourceArn is a required field + ResourceArn *string `type:"string" required:"true"` + + // Information that identifies the license type you are converting from. For + // the structure of the source license, see Convert a license type using the + // AWS CLI (https://docs.aws.amazon.com/license-manager/latest/userguide/conversion-procedures.html#conversion-cli) + // in the License Manager User Guide. + // + // SourceLicenseContext is a required field + SourceLicenseContext *LicenseConversionContext `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 CreateLicenseConversionTaskForResourceInput) 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 CreateLicenseConversionTaskForResourceInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *CreateLicenseConversionTaskForResourceInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "CreateLicenseConversionTaskForResourceInput"} + if s.DestinationLicenseContext == nil { + invalidParams.Add(request.NewErrParamRequired("DestinationLicenseContext")) + } + if s.ResourceArn == nil { + invalidParams.Add(request.NewErrParamRequired("ResourceArn")) + } + if s.SourceLicenseContext == nil { + invalidParams.Add(request.NewErrParamRequired("SourceLicenseContext")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetDestinationLicenseContext sets the DestinationLicenseContext field's value. +func (s *CreateLicenseConversionTaskForResourceInput) SetDestinationLicenseContext(v *LicenseConversionContext) *CreateLicenseConversionTaskForResourceInput { + s.DestinationLicenseContext = v + return s +} + +// SetResourceArn sets the ResourceArn field's value. +func (s *CreateLicenseConversionTaskForResourceInput) SetResourceArn(v string) *CreateLicenseConversionTaskForResourceInput { + s.ResourceArn = &v + return s +} + +// SetSourceLicenseContext sets the SourceLicenseContext field's value. +func (s *CreateLicenseConversionTaskForResourceInput) SetSourceLicenseContext(v *LicenseConversionContext) *CreateLicenseConversionTaskForResourceInput { + s.SourceLicenseContext = v + return s +} + +type CreateLicenseConversionTaskForResourceOutput struct { + _ struct{} `type:"structure"` + + // The ID of the created license type conversion task. + LicenseConversionTaskId *string `type:"string"` +} + +// 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 CreateLicenseConversionTaskForResourceOutput) 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 CreateLicenseConversionTaskForResourceOutput) GoString() string { + return s.String() +} + +// SetLicenseConversionTaskId sets the LicenseConversionTaskId field's value. +func (s *CreateLicenseConversionTaskForResourceOutput) SetLicenseConversionTaskId(v string) *CreateLicenseConversionTaskForResourceOutput { + s.LicenseConversionTaskId = &v + return s +} + type CreateLicenseInput struct { _ struct{} `type:"structure"` @@ -6175,10 +6567,10 @@ type CreateLicenseManagerReportGeneratorInput struct { // Type of reports to generate. The following report types an be generated: // - // * License configuration report - Reports on the number and details of - // consumed licenses for a license configuration. + // * License configuration report - Reports the number and details of consumed + // licenses for a license configuration. // - // * Resource report - Reports on the tracked licenses and resource consumption + // * Resource report - Reports the tracked licenses and resource consumption // for a license configuration. // // Type is a required field @@ -6284,7 +6676,7 @@ func (s *CreateLicenseManagerReportGeneratorInput) SetType(v []*string) *CreateL type CreateLicenseManagerReportGeneratorOutput struct { _ struct{} `type:"structure"` - // The Amazon Resource Number (ARN) of the new report generator. + // The Amazon Resource Name (ARN) of the new report generator. LicenseManagerReportGeneratorArn *string `type:"string"` } @@ -6832,6 +7224,7 @@ type DeleteGrantInput struct { // GrantArn is a required field GrantArn *string `type:"string" required:"true"` + // The Status reason for the delete request. StatusReason *string `type:"string"` // Current version of the grant. @@ -7072,7 +7465,7 @@ func (s *DeleteLicenseInput) SetSourceVersion(v string) *DeleteLicenseInput { type DeleteLicenseManagerReportGeneratorInput struct { _ struct{} `type:"structure"` - // Amazon Resource Number (ARN) of the report generator that will be deleted. + // Amazon Resource Name (ARN) of the report generator to be deleted. // // LicenseManagerReportGeneratorArn is a required field LicenseManagerReportGeneratorArn *string `type:"string" required:"true"` @@ -7140,7 +7533,7 @@ func (s DeleteLicenseManagerReportGeneratorOutput) GoString() string { type DeleteLicenseOutput struct { _ struct{} `type:"structure"` - // Date on which the license is deleted. + // Date when the license is deleted. DeletionDate *string `type:"string"` // License status. @@ -8059,7 +8452,7 @@ type GetLicenseConfigurationOutput struct { // Sets the number of available licenses as a hard limit. LicenseCountHardLimit *bool `type:"boolean"` - // Dimension on which the licenses are counted. + // Dimension for which the licenses are counted. LicenseCountingType *string `type:"string" enum:"LicenseCountingType"` // License rules. @@ -8068,20 +8461,218 @@ type GetLicenseConfigurationOutput struct { // Summaries of the managed resources. ManagedResourceSummaryList []*ManagedResourceSummary `type:"list"` - // Name of the license configuration. - Name *string `type:"string"` + // Name of the license configuration. + Name *string `type:"string"` + + // Account ID of the owner of the license configuration. + OwnerAccountId *string `type:"string"` + + // Product information. + ProductInformationList []*ProductInformation `type:"list"` + + // License configuration status. + Status *string `type:"string"` + + // Tags for the license configuration. + Tags []*Tag `type:"list"` +} + +// 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 GetLicenseConfigurationOutput) 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 GetLicenseConfigurationOutput) GoString() string { + return s.String() +} + +// SetAutomatedDiscoveryInformation sets the AutomatedDiscoveryInformation field's value. +func (s *GetLicenseConfigurationOutput) SetAutomatedDiscoveryInformation(v *AutomatedDiscoveryInformation) *GetLicenseConfigurationOutput { + s.AutomatedDiscoveryInformation = v + return s +} + +// SetConsumedLicenseSummaryList sets the ConsumedLicenseSummaryList field's value. +func (s *GetLicenseConfigurationOutput) SetConsumedLicenseSummaryList(v []*ConsumedLicenseSummary) *GetLicenseConfigurationOutput { + s.ConsumedLicenseSummaryList = v + return s +} + +// SetConsumedLicenses sets the ConsumedLicenses field's value. +func (s *GetLicenseConfigurationOutput) SetConsumedLicenses(v int64) *GetLicenseConfigurationOutput { + s.ConsumedLicenses = &v + return s +} + +// SetDescription sets the Description field's value. +func (s *GetLicenseConfigurationOutput) SetDescription(v string) *GetLicenseConfigurationOutput { + s.Description = &v + return s +} + +// SetDisassociateWhenNotFound sets the DisassociateWhenNotFound field's value. +func (s *GetLicenseConfigurationOutput) SetDisassociateWhenNotFound(v bool) *GetLicenseConfigurationOutput { + s.DisassociateWhenNotFound = &v + return s +} + +// SetLicenseConfigurationArn sets the LicenseConfigurationArn field's value. +func (s *GetLicenseConfigurationOutput) SetLicenseConfigurationArn(v string) *GetLicenseConfigurationOutput { + s.LicenseConfigurationArn = &v + return s +} + +// SetLicenseConfigurationId sets the LicenseConfigurationId field's value. +func (s *GetLicenseConfigurationOutput) SetLicenseConfigurationId(v string) *GetLicenseConfigurationOutput { + s.LicenseConfigurationId = &v + return s +} + +// SetLicenseCount sets the LicenseCount field's value. +func (s *GetLicenseConfigurationOutput) SetLicenseCount(v int64) *GetLicenseConfigurationOutput { + s.LicenseCount = &v + return s +} + +// SetLicenseCountHardLimit sets the LicenseCountHardLimit field's value. +func (s *GetLicenseConfigurationOutput) SetLicenseCountHardLimit(v bool) *GetLicenseConfigurationOutput { + s.LicenseCountHardLimit = &v + return s +} + +// SetLicenseCountingType sets the LicenseCountingType field's value. +func (s *GetLicenseConfigurationOutput) SetLicenseCountingType(v string) *GetLicenseConfigurationOutput { + s.LicenseCountingType = &v + return s +} + +// SetLicenseRules sets the LicenseRules field's value. +func (s *GetLicenseConfigurationOutput) SetLicenseRules(v []*string) *GetLicenseConfigurationOutput { + s.LicenseRules = v + return s +} + +// SetManagedResourceSummaryList sets the ManagedResourceSummaryList field's value. +func (s *GetLicenseConfigurationOutput) SetManagedResourceSummaryList(v []*ManagedResourceSummary) *GetLicenseConfigurationOutput { + s.ManagedResourceSummaryList = v + return s +} + +// SetName sets the Name field's value. +func (s *GetLicenseConfigurationOutput) SetName(v string) *GetLicenseConfigurationOutput { + s.Name = &v + return s +} + +// SetOwnerAccountId sets the OwnerAccountId field's value. +func (s *GetLicenseConfigurationOutput) SetOwnerAccountId(v string) *GetLicenseConfigurationOutput { + s.OwnerAccountId = &v + return s +} + +// SetProductInformationList sets the ProductInformationList field's value. +func (s *GetLicenseConfigurationOutput) SetProductInformationList(v []*ProductInformation) *GetLicenseConfigurationOutput { + s.ProductInformationList = v + return s +} + +// SetStatus sets the Status field's value. +func (s *GetLicenseConfigurationOutput) SetStatus(v string) *GetLicenseConfigurationOutput { + s.Status = &v + return s +} + +// SetTags sets the Tags field's value. +func (s *GetLicenseConfigurationOutput) SetTags(v []*Tag) *GetLicenseConfigurationOutput { + s.Tags = v + return s +} + +type GetLicenseConversionTaskInput struct { + _ struct{} `type:"structure"` + + // ID of the license type conversion task to retrieve information on. + // + // LicenseConversionTaskId is a required field + LicenseConversionTaskId *string `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 GetLicenseConversionTaskInput) 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 GetLicenseConversionTaskInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *GetLicenseConversionTaskInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "GetLicenseConversionTaskInput"} + if s.LicenseConversionTaskId == nil { + invalidParams.Add(request.NewErrParamRequired("LicenseConversionTaskId")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetLicenseConversionTaskId sets the LicenseConversionTaskId field's value. +func (s *GetLicenseConversionTaskInput) SetLicenseConversionTaskId(v string) *GetLicenseConversionTaskInput { + s.LicenseConversionTaskId = &v + return s +} + +type GetLicenseConversionTaskOutput struct { + _ struct{} `type:"structure"` + + // Information about the license type converted to. + DestinationLicenseContext *LicenseConversionContext `type:"structure"` + + // Time at which the license type conversion task was completed. + EndTime *time.Time `type:"timestamp"` + + // ID of the license type conversion task. + LicenseConversionTaskId *string `type:"string"` + + // Amount of time to complete the license type conversion. + LicenseConversionTime *time.Time `type:"timestamp"` + + // Amazon Resource Names (ARN) of the resources the license conversion task + // is associated with. + ResourceArn *string `type:"string"` - // Account ID of the owner of the license configuration. - OwnerAccountId *string `type:"string"` + // Information about the license type converted from. + SourceLicenseContext *LicenseConversionContext `type:"structure"` - // Product information. - ProductInformationList []*ProductInformation `type:"list"` + // Time at which the license type conversion task was started . + StartTime *time.Time `type:"timestamp"` - // License configuration status. - Status *string `type:"string"` + // Status of the license type conversion task. + Status *string `type:"string" enum:"LicenseConversionTaskStatus"` - // Tags for the license configuration. - Tags []*Tag `type:"list"` + // The status message for the conversion task. + StatusMessage *string `type:"string"` } // String returns the string representation. @@ -8089,7 +8680,7 @@ type GetLicenseConfigurationOutput struct { // 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 GetLicenseConfigurationOutput) String() string { +func (s GetLicenseConversionTaskOutput) String() string { return awsutil.Prettify(s) } @@ -8098,109 +8689,61 @@ func (s GetLicenseConfigurationOutput) String() string { // 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 GetLicenseConfigurationOutput) GoString() string { +func (s GetLicenseConversionTaskOutput) GoString() string { return s.String() } -// SetAutomatedDiscoveryInformation sets the AutomatedDiscoveryInformation field's value. -func (s *GetLicenseConfigurationOutput) SetAutomatedDiscoveryInformation(v *AutomatedDiscoveryInformation) *GetLicenseConfigurationOutput { - s.AutomatedDiscoveryInformation = v - return s -} - -// SetConsumedLicenseSummaryList sets the ConsumedLicenseSummaryList field's value. -func (s *GetLicenseConfigurationOutput) SetConsumedLicenseSummaryList(v []*ConsumedLicenseSummary) *GetLicenseConfigurationOutput { - s.ConsumedLicenseSummaryList = v - return s -} - -// SetConsumedLicenses sets the ConsumedLicenses field's value. -func (s *GetLicenseConfigurationOutput) SetConsumedLicenses(v int64) *GetLicenseConfigurationOutput { - s.ConsumedLicenses = &v - return s -} - -// SetDescription sets the Description field's value. -func (s *GetLicenseConfigurationOutput) SetDescription(v string) *GetLicenseConfigurationOutput { - s.Description = &v - return s -} - -// SetDisassociateWhenNotFound sets the DisassociateWhenNotFound field's value. -func (s *GetLicenseConfigurationOutput) SetDisassociateWhenNotFound(v bool) *GetLicenseConfigurationOutput { - s.DisassociateWhenNotFound = &v - return s -} - -// SetLicenseConfigurationArn sets the LicenseConfigurationArn field's value. -func (s *GetLicenseConfigurationOutput) SetLicenseConfigurationArn(v string) *GetLicenseConfigurationOutput { - s.LicenseConfigurationArn = &v - return s -} - -// SetLicenseConfigurationId sets the LicenseConfigurationId field's value. -func (s *GetLicenseConfigurationOutput) SetLicenseConfigurationId(v string) *GetLicenseConfigurationOutput { - s.LicenseConfigurationId = &v - return s -} - -// SetLicenseCount sets the LicenseCount field's value. -func (s *GetLicenseConfigurationOutput) SetLicenseCount(v int64) *GetLicenseConfigurationOutput { - s.LicenseCount = &v - return s -} - -// SetLicenseCountHardLimit sets the LicenseCountHardLimit field's value. -func (s *GetLicenseConfigurationOutput) SetLicenseCountHardLimit(v bool) *GetLicenseConfigurationOutput { - s.LicenseCountHardLimit = &v +// SetDestinationLicenseContext sets the DestinationLicenseContext field's value. +func (s *GetLicenseConversionTaskOutput) SetDestinationLicenseContext(v *LicenseConversionContext) *GetLicenseConversionTaskOutput { + s.DestinationLicenseContext = v return s } -// SetLicenseCountingType sets the LicenseCountingType field's value. -func (s *GetLicenseConfigurationOutput) SetLicenseCountingType(v string) *GetLicenseConfigurationOutput { - s.LicenseCountingType = &v +// SetEndTime sets the EndTime field's value. +func (s *GetLicenseConversionTaskOutput) SetEndTime(v time.Time) *GetLicenseConversionTaskOutput { + s.EndTime = &v return s } -// SetLicenseRules sets the LicenseRules field's value. -func (s *GetLicenseConfigurationOutput) SetLicenseRules(v []*string) *GetLicenseConfigurationOutput { - s.LicenseRules = v +// SetLicenseConversionTaskId sets the LicenseConversionTaskId field's value. +func (s *GetLicenseConversionTaskOutput) SetLicenseConversionTaskId(v string) *GetLicenseConversionTaskOutput { + s.LicenseConversionTaskId = &v return s } -// SetManagedResourceSummaryList sets the ManagedResourceSummaryList field's value. -func (s *GetLicenseConfigurationOutput) SetManagedResourceSummaryList(v []*ManagedResourceSummary) *GetLicenseConfigurationOutput { - s.ManagedResourceSummaryList = v +// SetLicenseConversionTime sets the LicenseConversionTime field's value. +func (s *GetLicenseConversionTaskOutput) SetLicenseConversionTime(v time.Time) *GetLicenseConversionTaskOutput { + s.LicenseConversionTime = &v return s } -// SetName sets the Name field's value. -func (s *GetLicenseConfigurationOutput) SetName(v string) *GetLicenseConfigurationOutput { - s.Name = &v +// SetResourceArn sets the ResourceArn field's value. +func (s *GetLicenseConversionTaskOutput) SetResourceArn(v string) *GetLicenseConversionTaskOutput { + s.ResourceArn = &v return s } -// SetOwnerAccountId sets the OwnerAccountId field's value. -func (s *GetLicenseConfigurationOutput) SetOwnerAccountId(v string) *GetLicenseConfigurationOutput { - s.OwnerAccountId = &v +// SetSourceLicenseContext sets the SourceLicenseContext field's value. +func (s *GetLicenseConversionTaskOutput) SetSourceLicenseContext(v *LicenseConversionContext) *GetLicenseConversionTaskOutput { + s.SourceLicenseContext = v return s } -// SetProductInformationList sets the ProductInformationList field's value. -func (s *GetLicenseConfigurationOutput) SetProductInformationList(v []*ProductInformation) *GetLicenseConfigurationOutput { - s.ProductInformationList = v +// SetStartTime sets the StartTime field's value. +func (s *GetLicenseConversionTaskOutput) SetStartTime(v time.Time) *GetLicenseConversionTaskOutput { + s.StartTime = &v return s } // SetStatus sets the Status field's value. -func (s *GetLicenseConfigurationOutput) SetStatus(v string) *GetLicenseConfigurationOutput { +func (s *GetLicenseConversionTaskOutput) SetStatus(v string) *GetLicenseConversionTaskOutput { s.Status = &v return s } -// SetTags sets the Tags field's value. -func (s *GetLicenseConfigurationOutput) SetTags(v []*Tag) *GetLicenseConfigurationOutput { - s.Tags = v +// SetStatusMessage sets the StatusMessage field's value. +func (s *GetLicenseConversionTaskOutput) SetStatusMessage(v string) *GetLicenseConversionTaskOutput { + s.StatusMessage = &v return s } @@ -8262,8 +8805,7 @@ func (s *GetLicenseInput) SetVersion(v string) *GetLicenseInput { type GetLicenseManagerReportGeneratorInput struct { _ struct{} `type:"structure"` - // mazon Resource Number (ARN) of the report generator to retrieve information - // on. + // Amazon Resource Name (ARN) of the report generator. // // LicenseManagerReportGeneratorArn is a required field LicenseManagerReportGeneratorArn *string `type:"string" required:"true"` @@ -8309,7 +8851,7 @@ func (s *GetLicenseManagerReportGeneratorInput) SetLicenseManagerReportGenerator type GetLicenseManagerReportGeneratorOutput struct { _ struct{} `type:"structure"` - // A report generator that creates periodic reports on your license configurations. + // A report generator that creates periodic reports about your license configurations. ReportGenerator *ReportGenerator `type:"structure"` } @@ -8473,12 +9015,12 @@ type GetServiceSettingsOutput struct { // Indicates whether cross-account discovery is enabled. EnableCrossAccountsDiscovery *bool `type:"boolean"` - // Amazon Resource Name (ARN) of the AWS resource share. The License Manager - // management account provides member accounts with access to this share. + // Amazon Resource Name (ARN) of the resource share. The License Manager management + // account provides member accounts with access to this share. LicenseManagerResourceShareArn *string `type:"string"` - // Indicates whether AWS Organizations is integrated with License Manager for - // cross-account discovery. + // Indicates whether Organizations is integrated with License Manager for cross-account + // discovery. OrganizationConfiguration *OrganizationConfiguration `type:"structure"` // Regional S3 bucket path for storing reports, license trail event data, discovery @@ -9037,8 +9579,8 @@ type Issuer struct { // Name is a required field Name *string `type:"string" required:"true"` - // Asymmetric CMK from AWS Key Management Service. The CMK must have a key usage - // of sign and verify, and support the RSASSA-PSS SHA-256 signing algorithm. + // Asymmetric KMS key from Key Management Service. The KMS key must have a key + // usage of sign and verify, and support the RSASSA-PSS SHA-256 signing algorithm. SignKey *string `type:"string"` } @@ -9095,8 +9637,8 @@ type IssuerDetails struct { // Issuer name. Name *string `type:"string"` - // Asymmetric CMK from AWS Key Management Service. The CMK must have a key usage - // of sign and verify, and support the RSASSA-PSS SHA-256 signing algorithm. + // Asymmetric KMS key from Key Management Service. The KMS key must have a key + // usage of sign and verify, and support the RSASSA-PSS SHA-256 signing algorithm. SignKey *string `type:"string"` } @@ -9136,7 +9678,7 @@ func (s *IssuerDetails) SetSignKey(v string) *IssuerDetails { return s } -// Software license that is managed in AWS License Manager. +// Software license that is managed in License Manager. type License struct { _ struct{} `type:"structure"` @@ -9470,7 +10012,7 @@ type LicenseConfigurationAssociation struct { // Amazon Resource Name (ARN) of the resource. ResourceArn *string `type:"string"` - // ID of the AWS account that owns the resource consuming licenses. + // ID of the Amazon Web Services account that owns the resource consuming licenses. ResourceOwnerId *string `type:"string"` // Type of server resource. @@ -9602,6 +10144,146 @@ func (s *LicenseConfigurationUsage) SetResourceType(v string) *LicenseConfigurat return s } +// Information about a license type conversion task. +type LicenseConversionContext struct { + _ struct{} `type:"structure"` + + // The Usage operation value that corresponds to the license type you are converting + // your resource from. For more information about which platforms correspond + // to which usage operation values see Sample data: usage operation by platform + // (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/billing-info-fields.html#billing-info) + UsageOperation *string `type:"string"` +} + +// 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 LicenseConversionContext) 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 LicenseConversionContext) GoString() string { + return s.String() +} + +// SetUsageOperation sets the UsageOperation field's value. +func (s *LicenseConversionContext) SetUsageOperation(v string) *LicenseConversionContext { + s.UsageOperation = &v + return s +} + +// Information about a license type conversion task. +type LicenseConversionTask struct { + _ struct{} `type:"structure"` + + // Information about the license type this conversion task converted to. + DestinationLicenseContext *LicenseConversionContext `type:"structure"` + + // The time the conversion task was completed. + EndTime *time.Time `type:"timestamp"` + + // The ID of the license type conversion task. + LicenseConversionTaskId *string `type:"string"` + + // The time the usage operation value of the resource was changed. + LicenseConversionTime *time.Time `type:"timestamp"` + + // The Amazon Resource Name (ARN) of the resource associated with the license + // type conversion task. + ResourceArn *string `type:"string"` + + // Information about the license type this conversion task converted from. + SourceLicenseContext *LicenseConversionContext `type:"structure"` + + // The time the conversion task was started at. + StartTime *time.Time `type:"timestamp"` + + // The status of the conversion task. + Status *string `type:"string" enum:"LicenseConversionTaskStatus"` + + // The status message for the conversion task. + StatusMessage *string `type:"string"` +} + +// 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 LicenseConversionTask) 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 LicenseConversionTask) GoString() string { + return s.String() +} + +// SetDestinationLicenseContext sets the DestinationLicenseContext field's value. +func (s *LicenseConversionTask) SetDestinationLicenseContext(v *LicenseConversionContext) *LicenseConversionTask { + s.DestinationLicenseContext = v + return s +} + +// SetEndTime sets the EndTime field's value. +func (s *LicenseConversionTask) SetEndTime(v time.Time) *LicenseConversionTask { + s.EndTime = &v + return s +} + +// SetLicenseConversionTaskId sets the LicenseConversionTaskId field's value. +func (s *LicenseConversionTask) SetLicenseConversionTaskId(v string) *LicenseConversionTask { + s.LicenseConversionTaskId = &v + return s +} + +// SetLicenseConversionTime sets the LicenseConversionTime field's value. +func (s *LicenseConversionTask) SetLicenseConversionTime(v time.Time) *LicenseConversionTask { + s.LicenseConversionTime = &v + return s +} + +// SetResourceArn sets the ResourceArn field's value. +func (s *LicenseConversionTask) SetResourceArn(v string) *LicenseConversionTask { + s.ResourceArn = &v + return s +} + +// SetSourceLicenseContext sets the SourceLicenseContext field's value. +func (s *LicenseConversionTask) SetSourceLicenseContext(v *LicenseConversionContext) *LicenseConversionTask { + s.SourceLicenseContext = v + return s +} + +// SetStartTime sets the StartTime field's value. +func (s *LicenseConversionTask) SetStartTime(v time.Time) *LicenseConversionTask { + s.StartTime = &v + return s +} + +// SetStatus sets the Status field's value. +func (s *LicenseConversionTask) SetStatus(v string) *LicenseConversionTask { + s.Status = &v + return s +} + +// SetStatusMessage sets the StatusMessage field's value. +func (s *LicenseConversionTask) SetStatusMessage(v string) *LicenseConversionTask { + s.StatusMessage = &v + return s +} + // Describes the failure of a license operation. type LicenseOperationFailure struct { _ struct{} `type:"structure"` @@ -9624,7 +10306,7 @@ type LicenseOperationFailure struct { // Amazon Resource Name (ARN) of the resource. ResourceArn *string `type:"string"` - // ID of the AWS account that owns the resource. + // ID of the Amazon Web Services account that owns the resource. ResourceOwnerId *string `type:"string"` // Resource type. @@ -10184,9 +10866,9 @@ type ListLicenseConfigurationsInput struct { // Filters to scope the results. The following filters and logical operators // are supported: // - // * licenseCountingType - The dimension on which licenses are counted. Possible - // values are vCPU | Instance | Core | Socket. Logical operators are EQUALS - // | NOT_EQUALS. + // * licenseCountingType - The dimension for which licenses are counted. + // Possible values are vCPU | Instance | Core | Socket. Logical operators + // are EQUALS | NOT_EQUALS. // // * enforceLicenseCount - A Boolean value that indicates whether hard license // enforcement is used. Logical operators are EQUALS | NOT_EQUALS. @@ -10287,6 +10969,95 @@ func (s *ListLicenseConfigurationsOutput) SetNextToken(v string) *ListLicenseCon return s } +type ListLicenseConversionTasksInput struct { + _ struct{} `type:"structure"` + + // Filters to scope the results. Valid filters are ResourceArns and Status. + Filters []*Filter `type:"list"` + + // Maximum number of results to return in a single call. + MaxResults *int64 `type:"integer"` + + // Token for the next set of results. + NextToken *string `type:"string"` +} + +// 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 ListLicenseConversionTasksInput) 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 ListLicenseConversionTasksInput) GoString() string { + return s.String() +} + +// SetFilters sets the Filters field's value. +func (s *ListLicenseConversionTasksInput) SetFilters(v []*Filter) *ListLicenseConversionTasksInput { + s.Filters = v + return s +} + +// SetMaxResults sets the MaxResults field's value. +func (s *ListLicenseConversionTasksInput) SetMaxResults(v int64) *ListLicenseConversionTasksInput { + s.MaxResults = &v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListLicenseConversionTasksInput) SetNextToken(v string) *ListLicenseConversionTasksInput { + s.NextToken = &v + return s +} + +type ListLicenseConversionTasksOutput struct { + _ struct{} `type:"structure"` + + // Information about the license configuration tasks for your account. + LicenseConversionTasks []*LicenseConversionTask `type:"list"` + + // Token for the next set of results. + NextToken *string `type:"string"` +} + +// 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 ListLicenseConversionTasksOutput) 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 ListLicenseConversionTasksOutput) GoString() string { + return s.String() +} + +// SetLicenseConversionTasks sets the LicenseConversionTasks field's value. +func (s *ListLicenseConversionTasksOutput) SetLicenseConversionTasks(v []*LicenseConversionTask) *ListLicenseConversionTasksOutput { + s.LicenseConversionTasks = v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListLicenseConversionTasksOutput) SetNextToken(v string) *ListLicenseConversionTasksOutput { + s.NextToken = &v + return s +} + type ListLicenseManagerReportGeneratorsInput struct { _ struct{} `type:"structure"` @@ -10357,7 +11128,7 @@ type ListLicenseManagerReportGeneratorsOutput struct { // Token for the next set of results. NextToken *string `type:"string"` - // A report generator that creates periodic reports on your license configurations. + // A report generator that creates periodic reports about your license configurations. ReportGenerators []*ReportGenerator `type:"list"` } @@ -10969,8 +11740,8 @@ type ListResourceInventoryInput struct { // Filters to scope the results. The following filters and logical operators // are supported: // - // * account_id - The ID of the AWS account that owns the resource. Logical - // operators are EQUALS | NOT_EQUALS. + // * account_id - The ID of the Amazon Web Services account that owns the + // resource. Logical operators are EQUALS | NOT_EQUALS. // // * application_name - The name of the application. Logical operators are // EQUALS | BEGINS_WITH. @@ -11553,11 +12324,11 @@ func (s *NoEntitlementsAllowedException) RequestID() string { return s.RespMetadata.RequestID } -// Configuration information for AWS Organizations. +// Configuration information for Organizations. type OrganizationConfiguration struct { _ struct{} `type:"structure"` - // Enables AWS Organization integration. + // Enables Organizations integration. // // EnableIntegration is a required field EnableIntegration *bool `type:"boolean" required:"true"` @@ -11627,14 +12398,14 @@ type ProductInformation struct { // // * Platform Type - The platform type. Logical operator is EQUALS. // - // * Tag:key - The key of a tag attached to an AWS resource you wish to exclude - // from automated discovery. Logical operator is NOT_EQUALS. The key for - // your tag must be appended to Tag: following the example: Tag:name-of-your-key. + // * Tag:key - The key of a tag attached to an Amazon Web Services resource + // you wish to exclude from automated discovery. Logical operator is NOT_EQUALS. + // The key for your tag must be appended to Tag: following the example: Tag:name-of-your-key. // ProductInformationFilterValue is optional if you are not using values // for the key. // - // * AccountId - The 12-digit ID of an AWS account you wish to exclude from - // automated discovery. Logical operator is NOT_EQUALS. + // * AccountId - The 12-digit ID of an Amazon Web Services account you wish + // to exclude from automated discovery. Logical operator is NOT_EQUALS. // // * License Included - The type of license included. Logical operators are // EQUALS and NOT_EQUALS. Possible values are: sql-server-enterprise | sql-server-standard @@ -11906,6 +12677,7 @@ type ReceivedMetadata struct { // Received status. ReceivedStatus *string `type:"string" enum:"ReceivedStatus"` + // Received status reason. ReceivedStatusReason *string `type:"string"` } @@ -12110,7 +12882,7 @@ func (s *RejectGrantOutput) SetVersion(v string) *RejectGrantOutput { type ReportContext struct { _ struct{} `type:"structure"` - // Amazon Resource Number (ARN) of the license configuration that this generator + // Amazon Resource Name (ARN) of the license configuration that this generator // reports on. // // LicenseConfigurationArns is a required field @@ -12154,15 +12926,15 @@ func (s *ReportContext) SetLicenseConfigurationArns(v []*string) *ReportContext return s } -// Details on how frequently reports are generated. +// Details about how frequently reports are generated. type ReportFrequency struct { _ struct{} `type:"structure"` // Time period between each report. The period can be daily, weekly, or monthly. Period *string `locationName:"period" type:"string" enum:"ReportFrequencyType"` - // Number of times within the frequency period that a report will be generated. - // Currently only 1 is supported. + // Number of times within the frequency period that a report is generated. The + // only supported value is 1. Value *int64 `locationName:"value" type:"integer"` } @@ -12215,16 +12987,16 @@ type ReportGenerator struct { // Status of the last report generation attempt. LastRunStatus *string `type:"string"` - // Amazon Resource Number (ARN) of the report generator. + // Amazon Resource Name (ARN) of the report generator. LicenseManagerReportGeneratorArn *string `type:"string"` - // License configuration type this generator reports on. + // License configuration type for this generator. ReportContext *ReportContext `type:"structure"` - // The AWS account ID used to create the report generator. + // The Amazon Web Services account ID used to create the report generator. ReportCreatorAccount *string `type:"string"` - // Details on how frequently reports are generated. + // Details about how frequently reports are generated. ReportFrequency *ReportFrequency `type:"structure"` // Name of the report generator. @@ -13164,19 +13936,17 @@ type UpdateLicenseManagerReportGeneratorInput struct { // Description of the report generator. Description *string `type:"string"` - // Amazon Resource Number (ARN) of the report generator to update. + // Amazon Resource Name (ARN) of the report generator to update. // // LicenseManagerReportGeneratorArn is a required field LicenseManagerReportGeneratorArn *string `type:"string" required:"true"` - // ? + // The report context. // // ReportContext is a required field ReportContext *ReportContext `type:"structure" required:"true"` - // Frequency by which reports are generated. The following options are avaiable: - // - // ??? What are the APi value options? + // Frequency by which reports are generated. // // ReportFrequency is a required field ReportFrequency *ReportFrequency `type:"structure" required:"true"` @@ -13186,12 +13956,12 @@ type UpdateLicenseManagerReportGeneratorInput struct { // ReportGeneratorName is a required field ReportGeneratorName *string `min:"1" type:"string" required:"true"` - // Type of reports to generate. The following report types an be generated: + // Type of reports to generate. The following report types are supported: // - // * License configuration report - Reports on the number and details of - // consumed licenses for a license configuration. + // * License configuration report - Reports the number and details of consumed + // licenses for a license configuration. // - // * Resource report - Reports on the tracked licenses and resource consumption + // * Resource report - Reports the tracked licenses and resource consumption // for a license configuration. // // Type is a required field @@ -13328,7 +14098,7 @@ type UpdateLicenseSpecificationsForResourceInput struct { // ARNs of the license configurations to remove. RemoveLicenseSpecifications []*LicenseSpecification `type:"list"` - // Amazon Resource Name (ARN) of the AWS resource. + // Amazon Resource Name (ARN) of the Amazon Web Services resource. // // ResourceArn is a required field ResourceArn *string `type:"string" required:"true"` @@ -13431,7 +14201,7 @@ type UpdateServiceSettingsInput struct { // Activates cross-account discovery. EnableCrossAccountsDiscovery *bool `type:"boolean"` - // Enables integration with AWS Organizations for cross-account discovery. + // Enables integration with Organizations for cross-account discovery. OrganizationConfiguration *OrganizationConfiguration `type:"structure"` // Amazon Resource Name (ARN) of the Amazon S3 bucket where the License Manager @@ -13966,6 +14736,26 @@ func LicenseConfigurationStatus_Values() []string { } } +const ( + // LicenseConversionTaskStatusInProgress is a LicenseConversionTaskStatus enum value + LicenseConversionTaskStatusInProgress = "IN_PROGRESS" + + // LicenseConversionTaskStatusSucceeded is a LicenseConversionTaskStatus enum value + LicenseConversionTaskStatusSucceeded = "SUCCEEDED" + + // LicenseConversionTaskStatusFailed is a LicenseConversionTaskStatus enum value + LicenseConversionTaskStatusFailed = "FAILED" +) + +// LicenseConversionTaskStatus_Values returns all elements of the LicenseConversionTaskStatus enum +func LicenseConversionTaskStatus_Values() []string { + return []string{ + LicenseConversionTaskStatusInProgress, + LicenseConversionTaskStatusSucceeded, + LicenseConversionTaskStatusFailed, + } +} + const ( // LicenseCountingTypeVCpu is a LicenseCountingType enum value LicenseCountingTypeVCpu = "vCPU" diff --git a/service/licensemanager/doc.go b/service/licensemanager/doc.go index f03d93418b6..3ac3230c6bd 100644 --- a/service/licensemanager/doc.go +++ b/service/licensemanager/doc.go @@ -3,8 +3,8 @@ // Package licensemanager provides the client and types for making API // requests to AWS License Manager. // -// AWS License Manager makes it easier to manage licenses from software vendors -// across multiple AWS accounts and on-premises servers. +// License Manager makes it easier to manage licenses from software vendors +// across multiple Amazon Web Services accounts and on-premises servers. // // See https://docs.aws.amazon.com/goto/WebAPI/license-manager-2018-08-01 for more information on this service. // diff --git a/service/licensemanager/errors.go b/service/licensemanager/errors.go index 26500cac063..3c82be9a616 100644 --- a/service/licensemanager/errors.go +++ b/service/licensemanager/errors.go @@ -17,8 +17,8 @@ const ( // ErrCodeAuthorizationException for service response error code // "AuthorizationException". // - // The AWS user account does not have permission to perform the action. Check - // the IAM policy associated with this account. + // The Amazon Web Services user account does not have permission to perform + // the action. Check the IAM policy associated with this account. ErrCodeAuthorizationException = "AuthorizationException" // ErrCodeConflictException for service response error code diff --git a/service/licensemanager/licensemanageriface/interface.go b/service/licensemanager/licensemanageriface/interface.go index 54d40cfa78f..dd453b52fae 100644 --- a/service/licensemanager/licensemanageriface/interface.go +++ b/service/licensemanager/licensemanageriface/interface.go @@ -92,6 +92,10 @@ type LicenseManagerAPI interface { CreateLicenseConfigurationWithContext(aws.Context, *licensemanager.CreateLicenseConfigurationInput, ...request.Option) (*licensemanager.CreateLicenseConfigurationOutput, error) CreateLicenseConfigurationRequest(*licensemanager.CreateLicenseConfigurationInput) (*request.Request, *licensemanager.CreateLicenseConfigurationOutput) + CreateLicenseConversionTaskForResource(*licensemanager.CreateLicenseConversionTaskForResourceInput) (*licensemanager.CreateLicenseConversionTaskForResourceOutput, error) + CreateLicenseConversionTaskForResourceWithContext(aws.Context, *licensemanager.CreateLicenseConversionTaskForResourceInput, ...request.Option) (*licensemanager.CreateLicenseConversionTaskForResourceOutput, error) + CreateLicenseConversionTaskForResourceRequest(*licensemanager.CreateLicenseConversionTaskForResourceInput) (*request.Request, *licensemanager.CreateLicenseConversionTaskForResourceOutput) + CreateLicenseManagerReportGenerator(*licensemanager.CreateLicenseManagerReportGeneratorInput) (*licensemanager.CreateLicenseManagerReportGeneratorOutput, error) CreateLicenseManagerReportGeneratorWithContext(aws.Context, *licensemanager.CreateLicenseManagerReportGeneratorInput, ...request.Option) (*licensemanager.CreateLicenseManagerReportGeneratorOutput, error) CreateLicenseManagerReportGeneratorRequest(*licensemanager.CreateLicenseManagerReportGeneratorInput) (*request.Request, *licensemanager.CreateLicenseManagerReportGeneratorOutput) @@ -144,6 +148,10 @@ type LicenseManagerAPI interface { GetLicenseConfigurationWithContext(aws.Context, *licensemanager.GetLicenseConfigurationInput, ...request.Option) (*licensemanager.GetLicenseConfigurationOutput, error) GetLicenseConfigurationRequest(*licensemanager.GetLicenseConfigurationInput) (*request.Request, *licensemanager.GetLicenseConfigurationOutput) + GetLicenseConversionTask(*licensemanager.GetLicenseConversionTaskInput) (*licensemanager.GetLicenseConversionTaskOutput, error) + GetLicenseConversionTaskWithContext(aws.Context, *licensemanager.GetLicenseConversionTaskInput, ...request.Option) (*licensemanager.GetLicenseConversionTaskOutput, error) + GetLicenseConversionTaskRequest(*licensemanager.GetLicenseConversionTaskInput) (*request.Request, *licensemanager.GetLicenseConversionTaskOutput) + GetLicenseManagerReportGenerator(*licensemanager.GetLicenseManagerReportGeneratorInput) (*licensemanager.GetLicenseManagerReportGeneratorOutput, error) GetLicenseManagerReportGeneratorWithContext(aws.Context, *licensemanager.GetLicenseManagerReportGeneratorInput, ...request.Option) (*licensemanager.GetLicenseManagerReportGeneratorOutput, error) GetLicenseManagerReportGeneratorRequest(*licensemanager.GetLicenseManagerReportGeneratorInput) (*request.Request, *licensemanager.GetLicenseManagerReportGeneratorOutput) @@ -172,6 +180,10 @@ type LicenseManagerAPI interface { ListLicenseConfigurationsWithContext(aws.Context, *licensemanager.ListLicenseConfigurationsInput, ...request.Option) (*licensemanager.ListLicenseConfigurationsOutput, error) ListLicenseConfigurationsRequest(*licensemanager.ListLicenseConfigurationsInput) (*request.Request, *licensemanager.ListLicenseConfigurationsOutput) + ListLicenseConversionTasks(*licensemanager.ListLicenseConversionTasksInput) (*licensemanager.ListLicenseConversionTasksOutput, error) + ListLicenseConversionTasksWithContext(aws.Context, *licensemanager.ListLicenseConversionTasksInput, ...request.Option) (*licensemanager.ListLicenseConversionTasksOutput, error) + ListLicenseConversionTasksRequest(*licensemanager.ListLicenseConversionTasksInput) (*request.Request, *licensemanager.ListLicenseConversionTasksOutput) + ListLicenseManagerReportGenerators(*licensemanager.ListLicenseManagerReportGeneratorsInput) (*licensemanager.ListLicenseManagerReportGeneratorsOutput, error) ListLicenseManagerReportGeneratorsWithContext(aws.Context, *licensemanager.ListLicenseManagerReportGeneratorsInput, ...request.Option) (*licensemanager.ListLicenseManagerReportGeneratorsOutput, error) ListLicenseManagerReportGeneratorsRequest(*licensemanager.ListLicenseManagerReportGeneratorsInput) (*request.Request, *licensemanager.ListLicenseManagerReportGeneratorsOutput) diff --git a/service/mediapackagevod/api.go b/service/mediapackagevod/api.go index a7b9c39f1be..2f919bd5ebe 100644 --- a/service/mediapackagevod/api.go +++ b/service/mediapackagevod/api.go @@ -3519,6 +3519,11 @@ type EgressEndpoint struct { // The ID of the PackagingConfiguration being applied to the Asset. PackagingConfigurationId *string `locationName:"packagingConfigurationId" type:"string"` + // The current processing status of the asset used for the packaging configuration. + // The status can be either QUEUED, PROCESSING, PLAYABLE, or FAILED. Status + // information won't be available for most assets ingested before 2021-09-30. + Status *string `locationName:"status" type:"string"` + // The URL of the parent manifest for the repackaged Asset. Url *string `locationName:"url" type:"string"` } @@ -3547,6 +3552,12 @@ func (s *EgressEndpoint) SetPackagingConfigurationId(v string) *EgressEndpoint { return s } +// SetStatus sets the Status field's value. +func (s *EgressEndpoint) SetStatus(v string) *EgressEndpoint { + s.Status = &v + return s +} + // SetUrl sets the Url field's value. func (s *EgressEndpoint) SetUrl(v string) *EgressEndpoint { s.Url = &v diff --git a/service/mediatailor/api.go b/service/mediatailor/api.go index 5da26d4004a..75862ad2810 100644 --- a/service/mediatailor/api.go +++ b/service/mediatailor/api.go @@ -13,6 +13,80 @@ import ( "github.com/aws/aws-sdk-go/private/protocol/restjson" ) +const opConfigureLogsForPlaybackConfiguration = "ConfigureLogsForPlaybackConfiguration" + +// ConfigureLogsForPlaybackConfigurationRequest generates a "aws/request.Request" representing the +// client's request for the ConfigureLogsForPlaybackConfiguration 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 ConfigureLogsForPlaybackConfiguration for more information on using the ConfigureLogsForPlaybackConfiguration +// 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 ConfigureLogsForPlaybackConfigurationRequest method. +// req, resp := client.ConfigureLogsForPlaybackConfigurationRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +// +// See also, https://docs.aws.amazon.com/goto/WebAPI/mediatailor-2018-04-23/ConfigureLogsForPlaybackConfiguration +func (c *MediaTailor) ConfigureLogsForPlaybackConfigurationRequest(input *ConfigureLogsForPlaybackConfigurationInput) (req *request.Request, output *ConfigureLogsForPlaybackConfigurationOutput) { + op := &request.Operation{ + Name: opConfigureLogsForPlaybackConfiguration, + HTTPMethod: "PUT", + HTTPPath: "/configureLogs/playbackConfiguration", + } + + if input == nil { + input = &ConfigureLogsForPlaybackConfigurationInput{} + } + + output = &ConfigureLogsForPlaybackConfigurationOutput{} + req = c.newRequest(op, input, output) + return +} + +// ConfigureLogsForPlaybackConfiguration API operation for AWS MediaTailor. +// +// Configures Amazon CloudWatch log settings for a playback configuration. +// +// 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 AWS MediaTailor's +// API operation ConfigureLogsForPlaybackConfiguration for usage and error information. +// See also, https://docs.aws.amazon.com/goto/WebAPI/mediatailor-2018-04-23/ConfigureLogsForPlaybackConfiguration +func (c *MediaTailor) ConfigureLogsForPlaybackConfiguration(input *ConfigureLogsForPlaybackConfigurationInput) (*ConfigureLogsForPlaybackConfigurationOutput, error) { + req, out := c.ConfigureLogsForPlaybackConfigurationRequest(input) + return out, req.Send() +} + +// ConfigureLogsForPlaybackConfigurationWithContext is the same as ConfigureLogsForPlaybackConfiguration with the addition of +// the ability to pass a context and additional request options. +// +// See ConfigureLogsForPlaybackConfiguration 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 *MediaTailor) ConfigureLogsForPlaybackConfigurationWithContext(ctx aws.Context, input *ConfigureLogsForPlaybackConfigurationInput, opts ...request.Option) (*ConfigureLogsForPlaybackConfigurationOutput, error) { + req, out := c.ConfigureLogsForPlaybackConfigurationRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + const opCreateChannel = "CreateChannel" // CreateChannelRequest generates a "aws/request.Request" representing the @@ -3336,6 +3410,117 @@ func (s *Channel) SetTags(v map[string]*string) *Channel { return s } +// Configures Amazon CloudWatch log settings for an existing MediaTailor playback +// configuration. +type ConfigureLogsForPlaybackConfigurationInput struct { + _ struct{} `type:"structure"` + + // The percentage of session logs that MediaTailor sends to your Cloudwatch + // Logs account. For example, if your playback configuration has 1000 sessions + // and percentEnabled is set to 60, MediaTailor sends logs for 600 of the sessions + // to CloudWatch Logs. MediaTailor decides at random which of the playback configuration + // sessions to send logs for. If you want to view logs for a specific session, + // you can use the debug log mode (https://docs.aws.amazon.com/mediatailor/latest/ug/debug-log-mode.html). + // + // Valid values: 0 - 100 + // + // PercentEnabled is a required field + PercentEnabled *int64 `type:"integer" required:"true"` + + // The name of the playback configuration. + // + // PlaybackConfigurationName is a required field + PlaybackConfigurationName *string `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 ConfigureLogsForPlaybackConfigurationInput) 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 ConfigureLogsForPlaybackConfigurationInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ConfigureLogsForPlaybackConfigurationInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ConfigureLogsForPlaybackConfigurationInput"} + if s.PercentEnabled == nil { + invalidParams.Add(request.NewErrParamRequired("PercentEnabled")) + } + if s.PlaybackConfigurationName == nil { + invalidParams.Add(request.NewErrParamRequired("PlaybackConfigurationName")) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetPercentEnabled sets the PercentEnabled field's value. +func (s *ConfigureLogsForPlaybackConfigurationInput) SetPercentEnabled(v int64) *ConfigureLogsForPlaybackConfigurationInput { + s.PercentEnabled = &v + return s +} + +// SetPlaybackConfigurationName sets the PlaybackConfigurationName field's value. +func (s *ConfigureLogsForPlaybackConfigurationInput) SetPlaybackConfigurationName(v string) *ConfigureLogsForPlaybackConfigurationInput { + s.PlaybackConfigurationName = &v + return s +} + +// Amazon CloudWatch log settings for a playback configuration. +type ConfigureLogsForPlaybackConfigurationOutput struct { + _ struct{} `type:"structure"` + + // The percentage of session logs that MediaTailor sends to your Cloudwatch + // Logs account. + PercentEnabled *int64 `type:"integer"` + + // The name of the playback configuration. + PlaybackConfigurationName *string `type:"string"` +} + +// 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 ConfigureLogsForPlaybackConfigurationOutput) 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 ConfigureLogsForPlaybackConfigurationOutput) GoString() string { + return s.String() +} + +// SetPercentEnabled sets the PercentEnabled field's value. +func (s *ConfigureLogsForPlaybackConfigurationOutput) SetPercentEnabled(v int64) *ConfigureLogsForPlaybackConfigurationOutput { + s.PercentEnabled = &v + return s +} + +// SetPlaybackConfigurationName sets the PlaybackConfigurationName field's value. +func (s *ConfigureLogsForPlaybackConfigurationOutput) SetPlaybackConfigurationName(v string) *ConfigureLogsForPlaybackConfigurationOutput { + s.PlaybackConfigurationName = &v + return s +} + // The configuration for this channel. type CreateChannelInput struct { _ struct{} `type:"structure"` @@ -3344,7 +3529,7 @@ type CreateChannelInput struct { ChannelName *string `location:"uri" locationName:"channelName" type:"string" required:"true"` // The slate used to fill gaps between programs in the schedule. You must configure - // filler slate if your channel uses an LINEAR PlaybackMode. + // filler slate if your channel uses a LINEAR PlaybackMode. FillerSlate *SlateSource `type:"structure"` // The channel's output properties. @@ -5656,6 +5841,9 @@ type GetPlaybackConfigurationOutput struct { // The configuration for pre-roll ad insertion. LivePreRollConfiguration *LivePreRollConfiguration `type:"structure"` + // The Amazon CloudWatch log settings for a playback configuration. + LogConfiguration *LogConfiguration `type:"structure"` + // The configuration for manifest processing rules. Manifest processing rules // enable customization of the personalized manifests created by MediaTailor. ManifestProcessingRules *ManifestProcessingRules `type:"structure"` @@ -5771,6 +5959,12 @@ func (s *GetPlaybackConfigurationOutput) SetLivePreRollConfiguration(v *LivePreR return s } +// SetLogConfiguration sets the LogConfiguration field's value. +func (s *GetPlaybackConfigurationOutput) SetLogConfiguration(v *LogConfiguration) *GetPlaybackConfigurationOutput { + s.LogConfiguration = v + return s +} + // SetManifestProcessingRules sets the ManifestProcessingRules field's value. func (s *GetPlaybackConfigurationOutput) SetManifestProcessingRules(v *ManifestProcessingRules) *GetPlaybackConfigurationOutput { s.ManifestProcessingRules = v @@ -6640,6 +6834,47 @@ func (s *LivePreRollConfiguration) SetMaxDurationSeconds(v int64) *LivePreRollCo return s } +// Returns Amazon CloudWatch log settings for a playback configuration. +type LogConfiguration struct { + _ struct{} `type:"structure"` + + // The percentage of session logs that MediaTailor sends to your Cloudwatch + // Logs account. For example, if your playback configuration has 1000 sessions + // and percentEnabled is set to 60, MediaTailor sends logs for 600 of the sessions + // to CloudWatch Logs. MediaTailor decides at random which of the playback configuration + // sessions to send logs for. If you want to view logs for a specific session, + // you can use the debug log mode (https://docs.aws.amazon.com/mediatailor/latest/ug/debug-log-mode.html). + // + // Valid values: 0 - 100 + // + // PercentEnabled is a required field + PercentEnabled *int64 `type:"integer" 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 LogConfiguration) 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 LogConfiguration) GoString() string { + return s.String() +} + +// SetPercentEnabled sets the PercentEnabled field's value. +func (s *LogConfiguration) SetPercentEnabled(v int64) *LogConfiguration { + s.PercentEnabled = &v + return s +} + // The configuration for manifest processing rules. Manifest processing rules // enable customization of the personalized manifests created by MediaTailor. type ManifestProcessingRules struct { @@ -6717,6 +6952,9 @@ type PlaybackConfiguration struct { // The configuration for pre-roll ad insertion. LivePreRollConfiguration *LivePreRollConfiguration `type:"structure"` + // The Amazon CloudWatch log settings for a playback configuration. + LogConfiguration *LogConfiguration `type:"structure"` + // The configuration for manifest processing rules. Manifest processing rules // enable customization of the personalized manifests created by MediaTailor. ManifestProcessingRules *ManifestProcessingRules `type:"structure"` @@ -6831,6 +7069,12 @@ func (s *PlaybackConfiguration) SetLivePreRollConfiguration(v *LivePreRollConfig return s } +// SetLogConfiguration sets the LogConfiguration field's value. +func (s *PlaybackConfiguration) SetLogConfiguration(v *LogConfiguration) *PlaybackConfiguration { + s.LogConfiguration = v + return s +} + // SetManifestProcessingRules sets the ManifestProcessingRules field's value. func (s *PlaybackConfiguration) SetManifestProcessingRules(v *ManifestProcessingRules) *PlaybackConfiguration { s.ManifestProcessingRules = v @@ -7193,6 +7437,9 @@ type PutPlaybackConfigurationOutput struct { // The configuration for pre-roll ad insertion. LivePreRollConfiguration *LivePreRollConfiguration `type:"structure"` + // Returns Amazon CloudWatch log settings for a playback configuration. + LogConfiguration *LogConfiguration `type:"structure"` + // The configuration for manifest processing rules. Manifest processing rules // enable customization of the personalized manifests created by MediaTailor. ManifestProcessingRules *ManifestProcessingRules `type:"structure"` @@ -7282,6 +7529,12 @@ func (s *PutPlaybackConfigurationOutput) SetLivePreRollConfiguration(v *LivePreR return s } +// SetLogConfiguration sets the LogConfiguration field's value. +func (s *PutPlaybackConfigurationOutput) SetLogConfiguration(v *LogConfiguration) *PutPlaybackConfigurationOutput { + s.LogConfiguration = v + return s +} + // SetManifestProcessingRules sets the ManifestProcessingRules field's value. func (s *PutPlaybackConfigurationOutput) SetManifestProcessingRules(v *ManifestProcessingRules) *PutPlaybackConfigurationOutput { s.ManifestProcessingRules = v @@ -7342,7 +7595,7 @@ func (s *PutPlaybackConfigurationOutput) SetVideoContentSourceUrl(v string) *Put return s } -// The ouput configuration for this channel. +// The output configuration for this channel. type RequestOutputItem struct { _ struct{} `type:"structure"` diff --git a/service/mediatailor/mediatailoriface/interface.go b/service/mediatailor/mediatailoriface/interface.go index 529cfe237b3..3462e428756 100644 --- a/service/mediatailor/mediatailoriface/interface.go +++ b/service/mediatailor/mediatailoriface/interface.go @@ -26,7 +26,7 @@ import ( // // myFunc uses an SDK service client to make a request to // // AWS MediaTailor. // func myFunc(svc mediatailoriface.MediaTailorAPI) bool { -// // Make svc.CreateChannel request +// // Make svc.ConfigureLogsForPlaybackConfiguration request // } // // func main() { @@ -42,7 +42,7 @@ import ( // type mockMediaTailorClient struct { // mediatailoriface.MediaTailorAPI // } -// func (m *mockMediaTailorClient) CreateChannel(input *mediatailor.CreateChannelInput) (*mediatailor.CreateChannelOutput, error) { +// func (m *mockMediaTailorClient) ConfigureLogsForPlaybackConfiguration(input *mediatailor.ConfigureLogsForPlaybackConfigurationInput) (*mediatailor.ConfigureLogsForPlaybackConfigurationOutput, error) { // // mock response/functionality // } // @@ -60,6 +60,10 @@ import ( // and waiters. Its suggested to use the pattern above for testing, or using // tooling to generate mocks to satisfy the interfaces. type MediaTailorAPI interface { + ConfigureLogsForPlaybackConfiguration(*mediatailor.ConfigureLogsForPlaybackConfigurationInput) (*mediatailor.ConfigureLogsForPlaybackConfigurationOutput, error) + ConfigureLogsForPlaybackConfigurationWithContext(aws.Context, *mediatailor.ConfigureLogsForPlaybackConfigurationInput, ...request.Option) (*mediatailor.ConfigureLogsForPlaybackConfigurationOutput, error) + ConfigureLogsForPlaybackConfigurationRequest(*mediatailor.ConfigureLogsForPlaybackConfigurationInput) (*request.Request, *mediatailor.ConfigureLogsForPlaybackConfigurationOutput) + CreateChannel(*mediatailor.CreateChannelInput) (*mediatailor.CreateChannelOutput, error) CreateChannelWithContext(aws.Context, *mediatailor.CreateChannelInput, ...request.Option) (*mediatailor.CreateChannelOutput, error) CreateChannelRequest(*mediatailor.CreateChannelInput) (*request.Request, *mediatailor.CreateChannelOutput) diff --git a/service/wafv2/api.go b/service/wafv2/api.go index a8162cd3ad5..9a9f72f2183 100644 --- a/service/wafv2/api.go +++ b/service/wafv2/api.go @@ -14030,6 +14030,108 @@ func (s *Regex) SetRegexString(v string) *Regex { return s } +// A rule statement used to search web request components for a match against +// a single regular expression. +type RegexMatchStatement struct { + _ struct{} `type:"structure"` + + // The part of a web request that you want WAF to inspect. For more information, + // see FieldToMatch. + // + // FieldToMatch is a required field + FieldToMatch *FieldToMatch `type:"structure" required:"true"` + + // The string representing the regular expression. + // + // RegexString is a required field + RegexString *string `min:"1" type:"string" required:"true"` + + // Text transformations eliminate some of the unusual formatting that attackers + // use in web requests in an effort to bypass detection. If you specify one + // or more transformations in a rule statement, WAF performs all transformations + // on the content of the request component identified by FieldToMatch, starting + // from the lowest priority setting, before inspecting the content for a match. + // + // TextTransformations is a required field + TextTransformations []*TextTransformation `min:"1" type:"list" 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 RegexMatchStatement) 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 RegexMatchStatement) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *RegexMatchStatement) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "RegexMatchStatement"} + if s.FieldToMatch == nil { + invalidParams.Add(request.NewErrParamRequired("FieldToMatch")) + } + if s.RegexString == nil { + invalidParams.Add(request.NewErrParamRequired("RegexString")) + } + if s.RegexString != nil && len(*s.RegexString) < 1 { + invalidParams.Add(request.NewErrParamMinLen("RegexString", 1)) + } + if s.TextTransformations == nil { + invalidParams.Add(request.NewErrParamRequired("TextTransformations")) + } + if s.TextTransformations != nil && len(s.TextTransformations) < 1 { + invalidParams.Add(request.NewErrParamMinLen("TextTransformations", 1)) + } + if s.FieldToMatch != nil { + if err := s.FieldToMatch.Validate(); err != nil { + invalidParams.AddNested("FieldToMatch", err.(request.ErrInvalidParams)) + } + } + if s.TextTransformations != nil { + for i, v := range s.TextTransformations { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "TextTransformations", i), err.(request.ErrInvalidParams)) + } + } + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetFieldToMatch sets the FieldToMatch field's value. +func (s *RegexMatchStatement) SetFieldToMatch(v *FieldToMatch) *RegexMatchStatement { + s.FieldToMatch = v + return s +} + +// SetRegexString sets the RegexString field's value. +func (s *RegexMatchStatement) SetRegexString(v string) *RegexMatchStatement { + s.RegexString = &v + return s +} + +// SetTextTransformations sets the TextTransformations field's value. +func (s *RegexMatchStatement) SetTextTransformations(v []*TextTransformation) *RegexMatchStatement { + s.TextTransformations = v + return s +} + // Contains one or more regular expressions. // // WAF assigns an ARN to each RegexPatternSet that you create. To use a set @@ -15495,6 +15597,10 @@ type Statement struct { // inside a web ACL and inside a rule group. RateBasedStatement *RateBasedStatement `type:"structure"` + // A rule statement used to search web request components for a match against + // a single regular expression. + RegexMatchStatement *RegexMatchStatement `type:"structure"` + // A rule statement used to search web request components for matches with regular // expressions. To use this, create a RegexPatternSet that specifies the expressions // that you want to detect, then use the ARN of that set in this statement. @@ -15617,6 +15723,11 @@ func (s *Statement) Validate() error { invalidParams.AddNested("RateBasedStatement", err.(request.ErrInvalidParams)) } } + if s.RegexMatchStatement != nil { + if err := s.RegexMatchStatement.Validate(); err != nil { + invalidParams.AddNested("RegexMatchStatement", err.(request.ErrInvalidParams)) + } + } if s.RegexPatternSetReferenceStatement != nil { if err := s.RegexPatternSetReferenceStatement.Validate(); err != nil { invalidParams.AddNested("RegexPatternSetReferenceStatement", err.(request.ErrInvalidParams)) @@ -15703,6 +15814,12 @@ func (s *Statement) SetRateBasedStatement(v *RateBasedStatement) *Statement { return s } +// SetRegexMatchStatement sets the RegexMatchStatement field's value. +func (s *Statement) SetRegexMatchStatement(v *RegexMatchStatement) *Statement { + s.RegexMatchStatement = v + return s +} + // SetRegexPatternSetReferenceStatement sets the RegexPatternSetReferenceStatement field's value. func (s *Statement) SetRegexPatternSetReferenceStatement(v *RegexPatternSetReferenceStatement) *Statement { s.RegexPatternSetReferenceStatement = v