This section provides documentation for the Amazon CodeGuru Reviewer API operations. Amazon CodeGuru Reviewer is a service that uses program analysis and machine learning to detect potential defects that are difficult for developers to find and recommends fixes in your Java code.
By proactively detecting and providing recommendations for addressing code defects and implementing best practices, CodeGuru Reviewer improves the overall quality and maintainability of your code base during the code review stage. For more information about CodeGuru Reviewer, see the Amazon CodeGuru Reviewer User Guide.
", + "service": "This section provides documentation for the Amazon CodeGuru Reviewer API operations. CodeGuru Reviewer is a service that uses program analysis and machine learning to detect potential defects that are difficult for developers to find and recommends fixes in your Java code.
By proactively detecting and providing recommendations for addressing code defects and implementing best practices, CodeGuru Reviewer improves the overall quality and maintainability of your code base during the code review stage. For more information about CodeGuru Reviewer, see the Amazon CodeGuru Reviewer User Guide.
", "operations": { - "AssociateRepository": "Associates an AWS CodeCommit repository with Amazon CodeGuru Reviewer. When you associate an AWS CodeCommit repository with Amazon CodeGuru Reviewer, Amazon CodeGuru Reviewer will provide recommendations for each pull request raised within the repository. You can view recommendations in the AWS CodeCommit repository.
You can associate a GitHub repository using the Amazon CodeGuru Reviewer console.
", - "DescribeCodeReview": "Returns the metadaata associated with the code review along with its status.
", + "AssociateRepository": "Use to associate an AWS CodeCommit repository or a repostory managed by AWS CodeStar Connections with Amazon CodeGuru Reviewer. When you associate a repository, CodeGuru Reviewer reviews source code changes in the repository's pull requests and provides automatic recommendations. You can view recommendations using the CodeGuru Reviewer console. For more information, see Recommendations in Amazon CodeGuru Reviewer in the Amazon CodeGuru Reviewer User Guide.
If you associate a CodeCommit repository, it must be in the same AWS Region and AWS account where its CodeGuru Reviewer code reviews are configured.
Bitbucket and GitHub Enterprise Server repositories are managed by AWS CodeStar Connections to connect to CodeGuru Reviewer. For more information, see Connect to a repository source provider in the Amazon CodeGuru Reviewer User Guide.
You cannot use the CodeGuru Reviewer SDK or the AWS CLI to associate a GitHub repository with Amazon CodeGuru Reviewer. To associate a GitHub repository, use the console. For more information, see Getting started with CodeGuru Reviewer in the CodeGuru Reviewer User Guide.
Returns the metadata associated with the code review along with its status.
", "DescribeRecommendationFeedback": "Describes the customer feedback for a CodeGuru Reviewer recommendation.
", - "DescribeRepositoryAssociation": "Describes a repository association.
", + "DescribeRepositoryAssociation": " Returns a RepositoryAssociation object that contains information about the requested repository association.
Removes the association between Amazon CodeGuru Reviewer and a repository.
", "ListCodeReviews": "Lists all the code reviews that the customer has created in the past 90 days.
", - "ListRecommendationFeedback": "Lists the customer feedback for a CodeGuru Reviewer recommendation for all users. This API will be used from the console to extract the previously given feedback by the user to pre-populate the feedback emojis for all recommendations.
", + "ListRecommendationFeedback": " Returns a list of RecommendationFeedbackSummary objects that contain customer recommendation feedback for all CodeGuru Reviewer users.
Returns the list of all recommendations for a completed code review.
", - "ListRepositoryAssociations": "Lists repository associations. You can optionally filter on one or more of the following recommendation properties: provider types, states, names, and owners.
", - "PutRecommendationFeedback": "Stores customer feedback for a CodeGuru-Reviewer recommendation. When this API is called again with different reactions the previous feedback is overwritten.
" + "ListRepositoryAssociations": " Returns a list of RepositoryAssociationSummary objects that contain summary information about a repository association. You can filter the returned list by ProviderType , Name , State , and Owner .
Stores customer feedback for a CodeGuru Reviewer recommendation. When this API is called again with different reactions the previous feedback is overwritten.
" }, "shapes": { "AccessDeniedException": { @@ -22,18 +22,18 @@ "Arn": { "base": null, "refs": { - "CodeReview$CodeReviewArn": "The Amazon Resource Name (ARN) of the code review to describe.
", - "CodeReviewSummary$CodeReviewArn": "The Amazon Resource Name (ARN) of the code review to describe.
", - "DescribeCodeReviewRequest$CodeReviewArn": "The Amazon Resource Name (ARN) of the code review to describe.
", - "DescribeRecommendationFeedbackRequest$CodeReviewArn": "The Amazon Resource Name (ARN) that identifies the code review.
", - "DescribeRepositoryAssociationRequest$AssociationArn": "The Amazon Resource Name (ARN) identifying the association. You can retrieve this ARN by calling ListRepositories.
The Amazon Resource Name (ARN) identifying the association.
", - "ListRecommendationFeedbackRequest$CodeReviewArn": "The Amazon Resource Name (ARN) that identifies the code review.
", - "ListRecommendationsRequest$CodeReviewArn": "The Amazon Resource Name (ARN) of the code review to describe.
", - "PutRecommendationFeedbackRequest$CodeReviewArn": "The Amazon Resource Name (ARN) that identifies the code review.
", - "RecommendationFeedback$CodeReviewArn": "The Amazon Resource Name (ARN) that identifies the code review.
", + "CodeReview$CodeReviewArn": "The Amazon Resource Name (ARN) of the CodeReview object.
The Amazon Resource Name (ARN) of the CodeReview object.
The Amazon Resource Name (ARN) of the CodeReview object.
The Amazon Resource Name (ARN) of the CodeReview object.
The Amazon Resource Name (ARN) of the RepositoryAssociation object. You can retrieve this ARN by calling ListRepositories.
The Amazon Resource Name (ARN) of the RepositoryAssociation object.
The Amazon Resource Name (ARN) of the CodeReview object.
The Amazon Resource Name (ARN) of the CodeReview object.
The Amazon Resource Name (ARN) of the CodeReview object.
The Amazon Resource Name (ARN) of the CodeReview object.
The Amazon Resource Name (ARN) identifying the repository association.
", - "RepositoryAssociationSummary$AssociationArn": "The Amazon Resource Name (ARN) identifying the repository association.
" + "RepositoryAssociationSummary$AssociationArn": "The Amazon Resource Name (ARN) of the RepositoryAssociation object.
The ID of the repository association.
", - "RepositoryAssociationSummary$AssociationId": "The repository association ID.
" + "RepositoryAssociationSummary$AssociationId": "The repository association ID.
" } }, "ClientRequestToken": { @@ -60,7 +60,7 @@ } }, "CodeCommitRepository": { - "base": "Information about an AWS CodeCommit repository.
", + "base": "Information about an AWS CodeCommit repository. The CodeCommit repository must be in the same AWS Region and AWS account where its CodeGuru Reviewer code reviews are configured.
", "refs": { "Repository$CodeCommit": "Information about an AWS CodeCommit repository.
" } @@ -92,8 +92,8 @@ "CommitId": { "base": null, "refs": { - "CommitDiffSourceCodeType$SourceCommit": "Source Commit SHA.
", - "CommitDiffSourceCodeType$DestinationCommit": "Destination Commit SHA
" + "CommitDiffSourceCodeType$SourceCommit": "The SHA of the source commit.
", + "CommitDiffSourceCodeType$DestinationCommit": "The SHA of the destination commit.
" } }, "ConflictException": { @@ -104,9 +104,9 @@ "ConnectionArn": { "base": null, "refs": { - "RepositoryAssociation$ConnectionArn": "The Amazon Resource Name (ARN) identifying the repository connection.
", - "RepositoryAssociationSummary$ConnectionArn": "The Amazon Resource Name (ARN) identifying the repository connection.
", - "ThirdPartySourceRepository$ConnectionArn": "The Amazon Resource Name (ARN) identifying the repository connection.
" + "RepositoryAssociation$ConnectionArn": " The Amazon Resource Name (ARN) of an AWS CodeStar Connections connection. Its format is arn:aws:codestar-connections:region-id:aws-account_id:connection/connection-id. For more information, see Connection in the AWS CodeStar Connections API Reference.
The Amazon Resource Name (ARN) of an AWS CodeStar Connections connection. Its format is arn:aws:codestar-connections:region-id:aws-account_id:connection/connection-id. For more information, see Connection in the AWS CodeStar Connections API Reference.
The Amazon Resource Name (ARN) of an AWS CodeStar Connections connection. Its format is arn:aws:codestar-connections:region-id:aws-account_id:connection/connection-id. For more information, see Connection in the AWS CodeStar Connections API Reference.
The state of the code review.
", - "CodeReviewSummary$State": "The state of the code review.
", + "CodeReview$State": "The valid code review states are:
Completed: The code review is complete.
Pending: The code review started and has not completed or failed.
Failed: The code review failed.
Deleting: The code review is being deleted.
The state of the code review.
The valid code review states are:
Completed: The code review is complete.
Pending: The code review started and has not completed or failed.
Failed: The code review failed.
Deleting: The code review is being deleted.
List of states for filtering that needs to be applied before displaying the result. For example, \"states=[Pending]\" will list code reviews in the Pending state.
" + "ListCodeReviewsRequest$States": " List of states for filtering that needs to be applied before displaying the result. For example, states=[Pending] lists code reviews in the Pending state.
The valid code review states are:
Completed: The code review is complete.
Pending: The code review started and has not completed or failed.
Failed: The code review failed.
Deleting: The code review is being deleted.
Start line from where the recommendation is applicable in the source commit or source branch.
", - "RecommendationSummary$EndLine": "Last line where the recommendation is applicable in the source commit or source branch. For a single line comment the start line and end line values will be the same.
" + "RecommendationSummary$EndLine": "Last line where the recommendation is applicable in the source commit or source branch. For a single line comment the start line and end line values are the same.
" } }, "ListCodeReviewsMaxResults": { @@ -251,14 +251,14 @@ "refs": { "ListRecommendationFeedbackRequest$MaxResults": "The maximum number of results that are returned per call. The default is 100.
", "ListRecommendationsRequest$MaxResults": "The maximum number of results that are returned per call. The default is 100.
", - "ListRepositoryAssociationsRequest$MaxResults": "The maximum number of repository association results returned by ListRepositoryAssociations in paginated output. When this parameter is used, ListRepositoryAssociations only returns maxResults results in a single page with a nextToken response element. The remaining results of the initial request can be seen by sending another ListRepositoryAssociations request with the returned nextToken value. This value can be between 1 and 25. If this parameter is not used, ListRepositoryAssociations returns up to 25 results and a nextToken value if applicable.
The maximum number of repository association results returned by ListRepositoryAssociations in paginated output. When this parameter is used, ListRepositoryAssociations only returns maxResults results in a single page with a nextToken response element. The remaining results of the initial request can be seen by sending another ListRepositoryAssociations request with the returned nextToken value. This value can be between 1 and 100. If this parameter is not used, ListRepositoryAssociations returns up to 100 results and a nextToken value if applicable.
Lines of code metered in the code review.
", - "MetricsSummary$MeteredLinesOfCodeCount": "Lines of code metered in the code review.
" + "Metrics$MeteredLinesOfCodeCount": " Lines of code metered in the code review. For the initial code review pull request and all subsequent revisions, this includes all lines of code in the files added to the pull request. In subsequent revisions, for files that already existed in the pull request, this includes only the changed lines of code. In both cases, this does not include non-code lines such as comments and import statements. For example, if you submit a pull request containing 5 files, each with 500 lines of code, and in a subsequent revision you added a new file with 200 lines of code, and also modified a total of 25 lines across the initial 5 files, MeteredLinesOfCodeCount includes the first 5 files (5 * 500 = 2,500 lines), the new file (200 lines) and the 25 changed lines of code for a total of 2,725 lines of code.
Lines of code metered in the code review. For the initial code review pull request and all subsequent revisions, this includes all lines of code in the files added to the pull request. In subsequent revisions, for files that already existed in the pull request, this includes only the changed lines of code. In both cases, this does not include non-code lines such as comments and import statements. For example, if you submit a pull request containing 5 files, each with 500 lines of code, and in a subsequent revision you added a new file with 200 lines of code, and also modified a total of 25 lines across the initial 5 files, MeteredLinesOfCodeCount includes the first 5 files (5 * 500 = 2,500 lines), the new file (200 lines) and the 25 changed lines of code for a total of 2,725 lines of code.
The name of the AWS CodeCommit repository.
", + "CodeCommitRepository$Name": "The name of the AWS CodeCommit repository. For more information, see repositoryName in the AWS CodeCommit API Reference.
", "CodeReview$Name": "The name of the code review.
", "CodeReview$RepositoryName": "The name of the repository.
", "CodeReviewSummary$Name": "The name of the code review.
", @@ -299,7 +299,7 @@ "refs": { "ListCodeReviewsRequest$NextToken": "If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
", "ListCodeReviewsResponse$NextToken": "Pagination token.
", - "ListRecommendationFeedbackRequest$NextToken": "If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
", + "ListRecommendationFeedbackRequest$NextToken": " If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
If nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page. Keep all other arguments unchanged.
", "ListRecommendationsRequest$NextToken": "Pagination token.
", "ListRecommendationsResponse$NextToken": "Pagination token.
", @@ -315,24 +315,24 @@ "Owner": { "base": null, "refs": { - "CodeReview$Owner": "The owner of the repository.
", - "CodeReviewSummary$Owner": "The owner of the repository.
", + "CodeReview$Owner": "The owner of the repository. For an AWS CodeCommit repository, this is the AWS account ID of the account that owns the repository. For a GitHub or Bitbucket repository, this is the username for the account that owns the repository.
", + "CodeReviewSummary$Owner": "The owner of the repository. For an AWS CodeCommit repository, this is the AWS account ID of the account that owns the repository. For a GitHub or Bitbucket repository, this is the username for the account that owns the repository.
", "Owners$member": null, - "RepositoryAssociation$Owner": "The owner of the repository.
", - "RepositoryAssociationSummary$Owner": "The owner of the repository association.
", - "ThirdPartySourceRepository$Owner": "The username of the owner of the repository.
" + "RepositoryAssociation$Owner": "The owner of the repository. For an AWS CodeCommit repository, this is the AWS account ID of the account that owns the repository. For a GitHub or Bitbucket repository, this is the username for the account that owns the repository.
", + "RepositoryAssociationSummary$Owner": "The owner of the repository. For an AWS CodeCommit repository, this is the AWS account ID of the account that owns the repository. For a GitHub or Bitbucket repository, this is the username for the account that owns the repository.
", + "ThirdPartySourceRepository$Owner": "The owner of the repository. For a GitHub, GitHub Enterprise, or Bitbucket repository, this is the username for the account that owns the repository.
" } }, "Owners": { "base": null, "refs": { - "ListRepositoryAssociationsRequest$Owners": "List of owners to use as a filter. For GitHub, this is name of the GitHub account that was used to associate the repository. For AWS CodeCommit, it is the name of the CodeCommit account that was used to associate the repository.
" + "ListRepositoryAssociationsRequest$Owners": "List of owners to use as a filter. For AWS CodeCommit, it is the name of the CodeCommit account that was used to associate the repository. For other repository source providers, such as Bitbucket, this is name of the account that was used to associate the repository.
" } }, "ProviderType": { "base": null, "refs": { - "CodeReview$ProviderType": "The provider type of the repository association.
", + "CodeReview$ProviderType": "The type of repository that contains the reviewed code (for example, GitHub or Bitbucket).
", "CodeReviewSummary$ProviderType": "The provider type of the repository association.
", "ProviderTypes$member": null, "RepositoryAssociation$ProviderType": "The provider type of the repository association.
", @@ -342,7 +342,7 @@ "ProviderTypes": { "base": null, "refs": { - "ListCodeReviewsRequest$ProviderTypes": "List of provider types for filtering that needs to be applied before displaying the result. For example, \"providerTypes=[GitHub]\" will list code reviews from GitHub.
", + "ListCodeReviewsRequest$ProviderTypes": " List of provider types for filtering that needs to be applied before displaying the result. For example, providerTypes=[GitHub] lists code reviews from GitHub.
List of provider types to use as a filter.
" } }, @@ -386,7 +386,7 @@ "RecommendationFeedbackSummaries": { "base": null, "refs": { - "ListRecommendationFeedbackResponse$RecommendationFeedbackSummaries": "Recommendation feedback summaries corresponding to the code reivew ARN.
" + "ListRecommendationFeedbackResponse$RecommendationFeedbackSummaries": "Recommendation feedback summaries corresponding to the code review ARN.
" } }, "RecommendationFeedbackSummary": { @@ -409,7 +409,7 @@ "RecommendationIds": { "base": null, "refs": { - "ListRecommendationFeedbackRequest$RecommendationIds": "Filter on recommendationIds that need to be applied before displaying the result. This can be used to query all the recommendation feedback for a given recommendation.
" + "ListRecommendationFeedbackRequest$RecommendationIds": "Used to query the recommendation feedback for a given recommendation.
" } }, "RecommendationSummaries": { @@ -425,13 +425,13 @@ } }, "Repository": { - "base": "Information about a repository.
", + "base": " Information about an associated AWS CodeCommit repository or an associated repository that is managed by AWS CodeStar Connections (for example, Bitbucket). This Repository object is not used if your source code is in an associated GitHub repository.
The repository to associate.
" } }, "RepositoryAssociation": { - "base": "Information about a repository association.
", + "base": "Information about a repository association. The DescribeRepositoryAssociation operation returns a RepositoryAssociation object.
Information about the repository association.
", "DescribeRepositoryAssociationResponse$RepositoryAssociation": "Information about the repository association.
", @@ -441,15 +441,15 @@ "RepositoryAssociationState": { "base": null, "refs": { - "RepositoryAssociation$State": "The state of the repository association.
", + "RepositoryAssociation$State": "The state of the repository association.
The valid repository association states are:
Associated: The repository association is complete.
Associating: CodeGuru Reviewer is:
Setting up pull request notifications. This is required for pull requests to trigger a CodeGuru Reviewer review.
If your repository ProviderType is GitHub or Bitbucket, CodeGuru Reviewer creates webhooks in your repository to trigger CodeGuru Reviewer reviews. If you delete these webhooks, reviews of code in your repository cannot be triggered.
Setting up source code access. This is required for CodeGuru Reviewer to securely clone code in your repository.
Failed: The repository failed to associate or disassociate.
Disassociating: CodeGuru Reviewer is removing the repository's pull request notifications and source code access.
The state of the repository association.
Amazon CodeGuru Reviewer is associated with the repository.
The association is in progress.
The association failed.
Amazon CodeGuru Reviewer is in the process of disassociating with the repository.
The state of the repository association.
The valid repository association states are:
Associated: The repository association is complete.
Associating: CodeGuru Reviewer is:
Setting up pull request notifications. This is required for pull requests to trigger a CodeGuru Reviewer review.
If your repository ProviderType is GitHub or Bitbucket, CodeGuru Reviewer creates webhooks in your repository to trigger CodeGuru Reviewer reviews. If you delete these webhooks, reviews of code in your repository cannot be triggered.
Setting up source code access. This is required for CodeGuru Reviewer to securely clone code in your repository.
Failed: The repository failed to associate or disassociate.
Disassociating: CodeGuru Reviewer is removing the repository's pull request notifications and source code access.
List of states to use as a filter.
" + "ListRepositoryAssociationsRequest$States": "List of repository association states to use as a filter.
The valid repository association states are:
Associated: The repository association is complete.
Associating: CodeGuru Reviewer is:
Setting up pull request notifications. This is required for pull requests to trigger a CodeGuru Reviewer review.
If your repository ProviderType is GitHub or Bitbucket, CodeGuru Reviewer creates webhooks in your repository to trigger CodeGuru Reviewer reviews. If you delete these webhooks, reviews of code in your repository cannot be triggered.
Setting up source code access. This is required for CodeGuru Reviewer to securely clone code in your repository.
Failed: The repository failed to associate or disassociate.
Disassociating: CodeGuru Reviewer is removing the repository's pull request notifications and source code access.
Information about a repository association.
", + "base": "Summary information about a repository association. The ListRepositoryAssociations operation returns a list of RepositoryAssociationSummary objects.
Information about a third party source repository connected through CodeStar Connections.
", + "base": "Information about a third-party source repository connected to CodeGuru Reviewer.
", "refs": { - "Repository$Bitbucket": "Information about a Bitbucket Cloud repository.
" + "Repository$Bitbucket": "Information about a Bitbucket repository.
", + "Repository$GitHubEnterpriseServer": "Information about a GitHub Enterprise Server repository.
" } }, "ThrottlingException": { @@ -530,16 +531,16 @@ "UserId": { "base": null, "refs": { - "DescribeRecommendationFeedbackRequest$UserId": "Optional parameter to describe the feedback for a given user. If this is not supplied, it defaults to the user making the request.
", - "RecommendationFeedback$UserId": "The user principal that made the API call.
", - "RecommendationFeedbackSummary$UserId": "The identifier for the user that gave the feedback.
", + "DescribeRecommendationFeedbackRequest$UserId": "Optional parameter to describe the feedback for a given user. If this is not supplied, it defaults to the user making the request.
The UserId is an IAM principal that can be specified as an AWS account ID or an Amazon Resource Name (ARN). For more information, see Specifying a Principal in the AWS Identity and Access Management User Guide.
The ID of the user that made the API call.
The UserId is an IAM principal that can be specified as an AWS account ID or an Amazon Resource Name (ARN). For more information, see Specifying a Principal in the AWS Identity and Access Management User Guide.
The ID of the user that gave the feedback.
The UserId is an IAM principal that can be specified as an AWS account ID or an Amazon Resource Name (ARN). For more information, see Specifying a Principal in the AWS Identity and Access Management User Guide.
Filter on userIds that need to be applied before displaying the result. This can be used to query all the recommendation feedback for a code review from a given user.
" + "ListRecommendationFeedbackRequest$UserIds": "An AWS user's account ID or Amazon Resource Name (ARN). Use this ID to query the recommendation feedback for a code review from that user.
The UserId is an IAM principal that can be specified as an AWS account ID or an Amazon Resource Name (ARN). For more information, see Specifying a Principal in the AWS Identity and Access Management User Guide.
Provides information to AWS about your VPN customer gateway device. The customer gateway is the appliance at your end of the VPN connection. (The device on the AWS side of the VPN connection is the virtual private gateway.) You must provide the Internet-routable IP address of the customer gateway's external interface. The IP address must be static and can be behind a device performing network address translation (NAT).
For devices that use Border Gateway Protocol (BGP), you can also provide the device's BGP Autonomous System Number (ASN). You can use an existing ASN assigned to your network. If you don't have an ASN already, you can use a private ASN (in the 64512 - 65534 range).
Amazon EC2 supports all 2-byte ASN numbers in the range of 1 - 65534, with the exception of 7224, which is reserved in the us-east-1 Region, and 9059, which is reserved in the eu-west-1 Region.
For more information, see AWS Site-to-Site VPN in the AWS Site-to-Site VPN User Guide.
To create more than one customer gateway with the same VPN type, IP address, and BGP ASN, specify a unique device name for each customer gateway. Identical requests return information about the existing customer gateway and do not create new customer gateways.
Creates a default subnet with a size /20 IPv4 CIDR block in the specified Availability Zone in your default VPC. You can have only one default subnet per Availability Zone. For more information, see Creating a Default Subnet in the Amazon Virtual Private Cloud User Guide.
Creates a default VPC with a size /16 IPv4 CIDR block and a default subnet in each Availability Zone. For more information about the components of a default VPC, see Default VPC and Default Subnets in the Amazon Virtual Private Cloud User Guide. You cannot specify the components of the default VPC yourself.
If you deleted your previous default VPC, you can create a default VPC. You cannot have more than one default VPC per Region.
If your account supports EC2-Classic, you cannot use this action to create a default VPC in a Region that supports EC2-Classic. If you want a default VPC in a Region that supports EC2-Classic, see \"I really want a default VPC for my existing EC2 account. Is that possible?\" in the Default VPCs FAQ.
", - "CreateDhcpOptions": "Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.
domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas. To have your instance receive a custom DNS hostname as specified in domain-name, you must set domain-name-servers to a custom DNS server.
domain-name - If you're using AmazonProvidedDNS in us-east-1, specify ec2.internal. If you're using AmazonProvidedDNS in another Region, specify region.compute.internal (for example, ap-northeast-1.compute.internal). Otherwise, specify a domain name (for example, MyCompany.com). This value is used to complete unqualified DNS hostnames. Important: Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.
ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.
netbios-name-servers - The IP addresses of up to four NetBIOS name servers.
netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.
Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.
Creates a set of DHCP options for your VPC. After creating the set, you must associate it with the VPC, causing all existing and new instances that you launch in the VPC to use this set of DHCP options. The following are the individual DHCP options you can specify. For more information about the options, see RFC 2132.
domain-name-servers - The IP addresses of up to four domain name servers, or AmazonProvidedDNS. The default DHCP option set specifies AmazonProvidedDNS. If specifying more than one domain name server, specify the IP addresses in a single parameter, separated by commas. To have your instance receive a custom DNS hostname as specified in domain-name, you must set domain-name-servers to a custom DNS server.
domain-name - If you're using AmazonProvidedDNS in us-east-1, specify ec2.internal. If you're using AmazonProvidedDNS in another Region, specify region.compute.internal (for example, ap-northeast-1.compute.internal). Otherwise, specify a domain name (for example, ExampleCompany.com). This value is used to complete unqualified DNS hostnames. Important: Some Linux operating systems accept multiple domain names separated by spaces. However, Windows and other Linux operating systems treat the value as a single domain, which results in unexpected behavior. If your DHCP options set is associated with a VPC that has instances with multiple operating systems, specify only one domain name.
ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) servers.
netbios-name-servers - The IP addresses of up to four NetBIOS name servers.
netbios-node-type - The NetBIOS node type (1, 2, 4, or 8). We recommend that you specify 2 (broadcast and multicast are not currently supported). For more information about these node types, see RFC 2132.
Your VPC automatically starts out with a set of DHCP options that includes only a DNS server that we provide (AmazonProvidedDNS). If you create a set of options, and if your VPC has an internet gateway, make sure to set the domain-name-servers option either to AmazonProvidedDNS or to a domain name server of your choice. For more information, see DHCP Options Sets in the Amazon Virtual Private Cloud User Guide.
[IPv6 only] Creates an egress-only internet gateway for your VPC. An egress-only internet gateway is used to enable outbound communication over IPv6 from instances in your VPC to the internet, and prevents hosts outside of your VPC from initiating an IPv6 connection with your instance.
", "CreateFleet": "Launches an EC2 Fleet.
You can create a single EC2 Fleet that includes multiple launch specifications that vary by instance type, AMI, Availability Zone, or subnet.
For more information, see Launching an EC2 Fleet in the Amazon Elastic Compute Cloud User Guide.
", "CreateFlowLogs": "Creates one or more flow logs to capture information about IP traffic for a specific network interface, subnet, or VPC.
Flow log data for a monitored network interface is recorded as flow log records, which are log events consisting of fields that describe the traffic flow. For more information, see Flow Log Records in the Amazon Virtual Private Cloud User Guide.
When publishing to CloudWatch Logs, flow log records are published to a log group, and each network interface has a unique log stream in the log group. When publishing to Amazon S3, flow log records for all of the monitored network interfaces are published to a single log file object that is stored in the specified bucket.
For more information, see VPC Flow Logs in the Amazon Virtual Private Cloud User Guide.
", @@ -11245,7 +11245,7 @@ "LaunchTemplateTagSpecificationRequest$ResourceType": "The type of resource to tag. Currently, the resource types that support tagging on creation are instance and volume. To tag a resource after it has been created, see CreateTags.
The type of resource. Currently, the only resource type that is supported is instance. To tag the Spot Fleet request on creation, use the TagSpecifications parameter in SpotFleetRequestConfigData .
The resource type.
", - "TagSpecification$ResourceType": "The type of resource to tag. Currently, the resource types that support tagging on creation are: capacity-reservation | client-vpn-endpoint | dedicated-host | fleet | fpga-image | host-reservation | instance | ipv4pool-ec2 | ipv6pool-ec2 | key-pair | launch-template | natgateway | spot-fleet-request | placement-group | prefix-list | snapshot | traffic-mirror-filter | traffic-mirror-session | traffic-mirror-target | transit-gateway | transit-gateway-attachment | transit-gateway-route-table | vpc-endpoint (for interface and gateway endpoints) | vpc-endpoint-service (for AWS PrivateLink) | volume | vpc-flow-log.
To tag a resource after it has been created, see CreateTags.
" + "TagSpecification$ResourceType": "The type of resource to tag. Currently, the resource types that support tagging on creation are: capacity-reservation | client-vpn-endpoint | dedicated-host | dhcp-options | export-image-task | export-instance-task | fleet | fpga-image | host-reservation | import-image-task | import-snapshot-task | instance | internet-gateway | ipv4pool-ec2 | ipv6pool-ec2 | key-pair | launch-template | placement-group | prefix-list | launch-template | natgateway | network-acl | security-group | spot-fleet-request | snapshot | subnet | traffic-mirror-filter | traffic-mirror-session | traffic-mirror-target | transit-gateway | transit-gateway-attachment | transit-gateway-route-table | volume |vpc | vpc-endpoint (for interface and gateway endpoints) | vpc-endpoint-service (for AWS PrivateLink) | vpc-flow-log.
To tag a resource after it has been created, see CreateTags.
" } }, "ResponseError": { @@ -13784,6 +13784,7 @@ "CoipPool$Tags": "The tags.
", "ConversionTask$Tags": "Any tags assigned to the task.
", "CopySnapshotResult$Tags": "Any tags applied to the new snapshot.
", + "CreateSecurityGroupResult$Tags": "The tags assigned to the security group.
", "CreateTagsRequest$Tags": "The tags. The value parameter is required, but if you don't want the tag to have a value, specify the parameter with no value, and we set the value to an empty string.
Any tags assigned to the customer gateway.
", "DeleteTagsRequest$Tags": "The tags to delete. Specify a tag key and an optional tag value to delete specific tags. If you specify a tag key without a tag value, we delete any tag with this key regardless of its value. If you specify a tag key with an empty string as the tag value, we delete the tag only if its value is an empty string.
If you omit this parameter, we delete all user-defined tags for the specified resources. We do not delete AWS-generated tags (tags that have the aws: prefix).
The tags to apply to the new snapshot.
", "CreateCapacityReservationRequest$TagSpecifications": "The tags to apply to the Capacity Reservation during launch.
", "CreateClientVpnEndpointRequest$TagSpecifications": "The tags to apply to the Client VPN endpoint during creation.
", + "CreateDhcpOptionsRequest$TagSpecifications": "The tags to assign to the DHCP option.
", + "CreateEgressOnlyInternetGatewayRequest$TagSpecifications": "The tags to assign to the egress-only internet gateway.
", "CreateFleetRequest$TagSpecifications": "The key-value pair for tagging the EC2 Fleet request on creation. The value for ResourceType must be fleet, otherwise the fleet request fails. To tag instances at launch, specify the tags in the launch template. For information about tagging after launch, see Tagging Your Resources.
The tags to apply to the flow logs.
", "CreateFpgaImageRequest$TagSpecifications": "The tags to apply to the FPGA image during creation.
", "CreateInstanceExportTaskRequest$TagSpecifications": "The tags to apply to the instance export task during creation.
", + "CreateInternetGatewayRequest$TagSpecifications": "The tags to assign to the internet gateway.
", "CreateKeyPairRequest$TagSpecifications": "The tags to apply to the new key pair.
", "CreateLaunchTemplateRequest$TagSpecifications": "The tags to apply to the launch template during creation.
", "CreateLocalGatewayRouteTableVpcAssociationRequest$TagSpecifications": "The tags to assign to the local gateway route table VPC association.
", "CreateManagedPrefixListRequest$TagSpecifications": "The tags to apply to the prefix list during creation.
", "CreateNatGatewayRequest$TagSpecifications": "The tags to assign to the NAT gateway.
", + "CreateNetworkAclRequest$TagSpecifications": "The tags to assign to the network ACL.
", + "CreateNetworkInterfaceRequest$TagSpecifications": "The tags to apply to the new network interface.
", "CreatePlacementGroupRequest$TagSpecifications": "The tags to apply to the new placement group.
", + "CreateSecurityGroupRequest$TagSpecifications": "The tags to assign to the security group.
", "CreateSnapshotRequest$TagSpecifications": "The tags to apply to the snapshot during creation.
", "CreateSnapshotsRequest$TagSpecifications": "Tags to apply to every snapshot specified by the instance.
", + "CreateSubnetRequest$TagSpecifications": "The tags to assign to the subnet.
", "CreateTrafficMirrorFilterRequest$TagSpecifications": "The tags to assign to a Traffic Mirror filter.
", "CreateTrafficMirrorSessionRequest$TagSpecifications": "The tags to assign to a Traffic Mirror session.
", "CreateTrafficMirrorTargetRequest$TagSpecifications": "The tags to assign to the Traffic Mirror target.
", @@ -13891,6 +13899,7 @@ "CreateVolumeRequest$TagSpecifications": "The tags to apply to the volume during creation.
", "CreateVpcEndpointRequest$TagSpecifications": "The tags to associate with the endpoint.
", "CreateVpcEndpointServiceConfigurationRequest$TagSpecifications": "The tags to associate with the service.
", + "CreateVpcRequest$TagSpecifications": "The tags to assign to the VPC.
", "ExportImageRequest$TagSpecifications": "The tags to apply to the image being exported.
", "ImportImageRequest$TagSpecifications": "The tags to apply to the image being imported.
", "ImportKeyPairRequest$TagSpecifications": "The tags to apply to the imported key pair.
", diff --git a/models/apis/ecr/2015-09-21/api-2.json b/models/apis/ecr/2015-09-21/api-2.json index 925f13ed6a5..e75541a2e85 100644 --- a/models/apis/ecr/2015-09-21/api-2.json +++ b/models/apis/ecr/2015-09-21/api-2.json @@ -314,7 +314,8 @@ {"shape":"LayersNotFoundException"}, {"shape":"ReferencedImagesNotFoundException"}, {"shape":"LimitExceededException"}, - {"shape":"ImageTagAlreadyExistsException"} + {"shape":"ImageTagAlreadyExistsException"}, + {"shape":"ImageDigestDoesNotMatchException"} ] }, "PutImageScanningConfiguration":{ @@ -887,6 +888,13 @@ "member":{"shape":"ImageDetail"} }, "ImageDigest":{"type":"string"}, + "ImageDigestDoesNotMatchException":{ + "type":"structure", + "members":{ + "message":{"shape":"ExceptionMessage"} + }, + "exception":true + }, "ImageFailure":{ "type":"structure", "members":{ @@ -1289,7 +1297,8 @@ "repositoryName":{"shape":"RepositoryName"}, "imageManifest":{"shape":"ImageManifest"}, "imageManifestMediaType":{"shape":"MediaType"}, - "imageTag":{"shape":"ImageTag"} + "imageTag":{"shape":"ImageTag"}, + "imageDigest":{"shape":"ImageDigest"} } }, "PutImageResponse":{ diff --git a/models/apis/ecr/2015-09-21/docs-2.json b/models/apis/ecr/2015-09-21/docs-2.json index b59bf3b3fc6..ecf17c76a4d 100644 --- a/models/apis/ecr/2015-09-21/docs-2.json +++ b/models/apis/ecr/2015-09-21/docs-2.json @@ -236,6 +236,7 @@ "refs": { "EmptyUploadException$message": "The error message associated with the exception.
", "ImageAlreadyExistsException$message": "The error message associated with the exception.
", + "ImageDigestDoesNotMatchException$message": null, "ImageNotFoundException$message": null, "ImageTagAlreadyExistsException$message": null, "InvalidLayerException$message": "The error message associated with the exception.
", @@ -398,7 +399,13 @@ "refs": { "ImageDetail$imageDigest": "The sha256 digest of the image manifest.
The sha256 digest of the image manifest.
The sha256 digest of the image manifest.
The sha256 digest of the image manifest.
The image digest of the image manifest corresponding to the image.
" + } + }, + "ImageDigestDoesNotMatchException": { + "base": "The specified image digest does not match the digest that Amazon ECR calculated for the image.
", + "refs": { } }, "ImageFailure": { diff --git a/models/apis/rds/2014-10-31/docs-2.json b/models/apis/rds/2014-10-31/docs-2.json index 4056c000d29..bdea77cb1b6 100644 --- a/models/apis/rds/2014-10-31/docs-2.json +++ b/models/apis/rds/2014-10-31/docs-2.json @@ -23,7 +23,7 @@ "CreateDBInstance": "Creates a new DB instance.
", "CreateDBInstanceReadReplica": "Creates a new DB instance that acts as a read replica for an existing source DB instance. You can create a read replica for a DB instance running MySQL, MariaDB, Oracle, PostgreSQL, or SQL Server. For more information, see Working with Read Replicas in the Amazon RDS User Guide.
Amazon Aurora doesn't support this action. Call the CreateDBInstance action to create a DB instance for an Aurora DB cluster.
All read replica DB instances are created with backups disabled. All other DB instance attributes (including DB security groups and DB parameter groups) are inherited from the source DB instance, except as specified.
Your source DB instance must have backup retention enabled.
Creates a new DB parameter group.
A DB parameter group is initially created with the default parameters for the database engine used by the DB instance. To provide custom values for any of the parameters, you must modify the group after creating it using ModifyDBParameterGroup. Once you've created a DB parameter group, you need to associate it with your DB instance using ModifyDBInstance. When you associate a new DB parameter group with a running DB instance, you need to reboot the DB instance without failover for the new DB parameter group and associated settings to take effect.
After you create a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the create action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.
This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Creates a new DB proxy.
", + "CreateDBProxy": "Creates a new DB proxy.
", "CreateDBSecurityGroup": "Creates a new DB security group. DB security groups control access to a DB instance.
A DB security group controls access to EC2-Classic DB instances that are not in a VPC.
Creates a DBSnapshot. The source DBInstance must be in \"available\" state.
", "CreateDBSubnetGroup": "Creates a new DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the AWS Region.
", @@ -38,7 +38,7 @@ "DeleteDBInstance": "The DeleteDBInstance action deletes a previously provisioned DB instance. When you delete a DB instance, all automated backups for that instance are deleted and can't be recovered. Manual DB snapshots of the DB instance to be deleted by DeleteDBInstance are not deleted.
If you request a final DB snapshot the status of the Amazon RDS DB instance is deleting until the DB snapshot is created. The API action DescribeDBInstance is used to monitor the status of this operation. The action can't be canceled or reverted once submitted.
When a DB instance is in a failure state and has a status of failed, incompatible-restore, or incompatible-network, you can only delete it when you skip creation of the final snapshot with the SkipFinalSnapshot parameter.
If the specified DB instance is part of an Amazon Aurora DB cluster, you can't delete the DB instance if both of the following conditions are true:
The DB cluster is a read replica of another Amazon Aurora DB cluster.
The DB instance is the only instance in the DB cluster.
To delete a DB instance in this case, first call the PromoteReadReplicaDBCluster API action to promote the DB cluster so it's no longer a read replica. After the promotion completes, then call the DeleteDBInstance API action to delete the final instance in the DB cluster.
Deletes automated backups based on the source instance's DbiResourceId value or the restorable instance's resource ID.
Deletes a specified DB parameter group. The DB parameter group to be deleted can't be associated with any DB instances.
", - "DeleteDBProxy": "This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Deletes an existing proxy.
", + "DeleteDBProxy": "Deletes an existing proxy.
", "DeleteDBSecurityGroup": "Deletes a DB security group.
The specified DB security group must not be associated with any DB instances.
Deletes a DB snapshot. If the snapshot is being copied, the copy operation is terminated.
The DB snapshot must be in the available state to be deleted.
Deletes a DB subnet group.
The specified database subnet group must not be associated with any DB instances.
Deletes a global database cluster. The primary and secondary clusters must already be detached or destroyed first.
This action only applies to Aurora DB clusters.
Deletes the installation medium for a DB engine that requires an on-premises customer provided license, such as Microsoft SQL Server.
", "DeleteOptionGroup": "Deletes an existing option group.
", - "DeregisterDBProxyTargets": "This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Remove the association between one or more DBProxyTarget data structures and a DBProxyTargetGroup.
Remove the association between one or more DBProxyTarget data structures and a DBProxyTargetGroup.
Lists all of the attributes for a customer account. The attributes include Amazon RDS quotas for the account, such as the number of DB instances allowed. The description for a quota includes the quota name, current usage toward that quota, and the quota's maximum value.
This command doesn't take any parameters.
", "DescribeCertificates": "Lists the set of CA certificates provided by Amazon RDS for this AWS account.
", "DescribeCustomAvailabilityZones": "Returns information about custom Availability Zones (AZs).
A custom AZ is an on-premises AZ that is integrated with a VMware vSphere cluster.
For more information about RDS on VMware, see the RDS on VMware User Guide.
", @@ -63,9 +63,9 @@ "DescribeDBLogFiles": "Returns a list of DB log files for the DB instance.
", "DescribeDBParameterGroups": " Returns a list of DBParameterGroup descriptions. If a DBParameterGroupName is specified, the list will contain only the description of the specified DB parameter group.
Returns the detailed parameter list for a particular DB parameter group.
", - "DescribeDBProxies": "This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Returns information about DB proxies.
", - "DescribeDBProxyTargetGroups": "This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Returns information about DB proxy target groups, represented by DBProxyTargetGroup data structures.
This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Returns information about DBProxyTarget objects. This API supports pagination.
Returns information about DB proxies.
", + "DescribeDBProxyTargetGroups": "Returns information about DB proxy target groups, represented by DBProxyTargetGroup data structures.
Returns information about DBProxyTarget objects. This API supports pagination.
Returns a list of DBSecurityGroup descriptions. If a DBSecurityGroupName is specified, the list will contain only the descriptions of the specified DB security group.
Returns a list of DB snapshot attribute names and values for a manual DB snapshot.
When sharing snapshots with other AWS accounts, DescribeDBSnapshotAttributes returns the restore attribute and a list of IDs for the AWS accounts that are authorized to copy or restore the manual DB snapshot. If all is included in the list of values for the restore attribute, then the manual DB snapshot is public and can be copied or restored by all AWS accounts.
To add or remove access for an AWS account to copy or restore a manual DB snapshot, or to make the manual DB snapshot public or private, use the ModifyDBSnapshotAttribute API action.
Returns information about DB snapshots. This API action supports pagination.
", @@ -98,8 +98,8 @@ "ModifyDBClusterSnapshotAttribute": "Adds an attribute and values to, or removes an attribute and values from, a manual DB cluster snapshot.
To share a manual DB cluster snapshot with other AWS accounts, specify restore as the AttributeName and use the ValuesToAdd parameter to add a list of IDs of the AWS accounts that are authorized to restore the manual DB cluster snapshot. Use the value all to make the manual DB cluster snapshot public, which means that it can be copied or restored by all AWS accounts.
Don't add the all value for any manual DB cluster snapshots that contain private information that you don't want available to all AWS accounts.
If a manual DB cluster snapshot is encrypted, it can be shared, but only by specifying a list of authorized AWS account IDs for the ValuesToAdd parameter. You can't use all as a value for that parameter in this case.
To view which AWS accounts have access to copy or restore a manual DB cluster snapshot, or whether a manual DB cluster snapshot is public or private, use the DescribeDBClusterSnapshotAttributes API action. The accounts are returned as values for the restore attribute.
This action only applies to Aurora DB clusters.
Modifies settings for a DB instance. You can change one or more database configuration parameters by specifying these parameters and the new values in the request. To learn what modifications you can make to your DB instance, call DescribeValidDBInstanceModifications before you call ModifyDBInstance.
Modifies the parameters of a DB parameter group. To modify more than one parameter, submit a list of the following: ParameterName, ParameterValue, and ApplyMethod. A maximum of 20 parameters can be modified in a single request.
Changes to dynamic parameters are applied immediately. Changes to static parameters require a reboot without failover to the DB instance associated with the parameter group before the change can take effect.
After you modify a DB parameter group, you should wait at least 5 minutes before creating your first DB instance that uses that DB parameter group as the default parameter group. This allows Amazon RDS to fully complete the modify action before the parameter group is used as the default for a new DB instance. This is especially important for parameters that are critical when creating the default database for a DB instance, such as the character set for the default database defined by the character_set_database parameter. You can use the Parameter Groups option of the Amazon RDS console or the DescribeDBParameters command to verify that your DB parameter group has been created or modified.
This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Changes the settings for an existing DB proxy.
", - "ModifyDBProxyTargetGroup": "This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Modifies the properties of a DBProxyTargetGroup.
Changes the settings for an existing DB proxy.
", + "ModifyDBProxyTargetGroup": "Modifies the properties of a DBProxyTargetGroup.
Updates a manual DB snapshot with a new engine version. The snapshot can be encrypted or unencrypted, but not shared or public.
Amazon RDS supports upgrading DB snapshots for MySQL, Oracle, and PostgreSQL.
", "ModifyDBSnapshotAttribute": "Adds an attribute and values to, or removes an attribute and values from, a manual DB snapshot.
To share a manual DB snapshot with other AWS accounts, specify restore as the AttributeName and use the ValuesToAdd parameter to add a list of IDs of the AWS accounts that are authorized to restore the manual DB snapshot. Uses the value all to make the manual DB snapshot public, which means it can be copied or restored by all AWS accounts.
Don't add the all value for any manual DB snapshots that contain private information that you don't want available to all AWS accounts.
If the manual DB snapshot is encrypted, it can be shared, but only by specifying a list of authorized AWS account IDs for the ValuesToAdd parameter. You can't use all as a value for that parameter in this case.
To view which AWS accounts have access to copy or restore a manual DB snapshot, or whether a manual DB snapshot public or private, use the DescribeDBSnapshotAttributes API action. The accounts are returned as values for the restore attribute.
Modifies an existing DB subnet group. DB subnet groups must contain at least one subnet in at least two AZs in the AWS Region.
", @@ -110,7 +110,7 @@ "PromoteReadReplicaDBCluster": "Promotes a read replica DB cluster to a standalone DB cluster.
This action only applies to Aurora DB clusters.
Purchases a reserved DB instance offering.
", "RebootDBInstance": "You might need to reboot your DB instance, usually for maintenance reasons. For example, if you make certain modifications, or if you change the DB parameter group associated with the DB instance, you must reboot the instance for the changes to take effect.
Rebooting a DB instance restarts the database engine service. Rebooting a DB instance results in a momentary outage, during which the DB instance status is set to rebooting.
For more information about rebooting, see Rebooting a DB Instance in the Amazon RDS User Guide.
", - "RegisterDBProxyTargets": "This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Associate one or more DBProxyTarget data structures with a DBProxyTargetGroup.
Associate one or more DBProxyTarget data structures with a DBProxyTargetGroup.
Detaches an Aurora secondary cluster from an Aurora global database cluster. The cluster becomes a standalone cluster with read-write capability instead of being read-only and receiving data from a primary cluster in a different region.
This action only applies to Aurora DB clusters.
Disassociates an AWS Identity and Access Management (IAM) role from an Amazon Aurora DB cluster. For more information, see Authorizing Amazon Aurora MySQL to Access Other AWS Services on Your Behalf in the Amazon Aurora User Guide.
This action only applies to Aurora DB clusters.
Disassociates an AWS Identity and Access Management (IAM) role from a DB instance.
", @@ -529,13 +529,13 @@ } }, "ConnectionPoolConfiguration": { - "base": "This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Specifies the settings that control the size and behavior of the connection pool associated with a DBProxyTargetGroup.
Specifies the settings that control the size and behavior of the connection pool associated with a DBProxyTargetGroup.
The settings that determine the size and behavior of the connection pool for the target group.
" } }, "ConnectionPoolConfigurationInfo": { - "base": "This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Displays the settings that control the size and behavior of the connection pool associated with a DBProxyTarget.
Displays the settings that control the size and behavior of the connection pool associated with a DBProxyTarget.
The settings that determine the size and behavior of the connection pool for the target group.
" } @@ -1188,7 +1188,7 @@ } }, "DBProxy": { - "base": "This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
The data structure representing a proxy managed by the RDS Proxy.
This data type is used as a response element in the DescribeDBProxies action.
The data structure representing a proxy managed by the RDS Proxy.
This data type is used as a response element in the DescribeDBProxies action.
The DBProxy structure corresponding to the new proxy.
This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Contains the details for an RDS Proxy target. It represents an RDS DB instance or Aurora DB cluster that the proxy can connect to. One or more targets are associated with an RDS Proxy target group.
This data type is used as a response element in the DescribeDBProxyTargets action.
Contains the details for an RDS Proxy target. It represents an RDS DB instance or Aurora DB cluster that the proxy can connect to. One or more targets are associated with an RDS Proxy target group.
This data type is used as a response element in the DescribeDBProxyTargets action.
This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Represents a set of RDS DB instances, Aurora DB clusters, or both that a proxy can connect to. Currently, each target group is associated with exactly one RDS DB instance or Aurora DB cluster.
This data type is used as a response element in the DescribeDBProxyTargetGroups action.
Represents a set of RDS DB instances, Aurora DB clusters, or both that a proxy can connect to. Currently, each target group is associated with exactly one RDS DB instance or Aurora DB cluster.
This data type is used as a response element in the DescribeDBProxyTargetGroups action.
The settings of the modified DBProxyTarget.
An optional pagination token provided by a previous DescribeCertificates request. If this parameter is specified, the response includes only records beyond the marker, up to the value specified by MaxRecords .
The name of the character set.
", "CharacterSet$CharacterSetDescription": "The description of the character set.
", - "ConnectionPoolConfiguration$InitQuery": " One or more SQL statements for the proxy to run when opening each new database connection. Typically used with SET statements to make sure that each connection has identical settings such as time zone and character set. For multiple statements, use semicolons as the separator. You can also include multiple variables in a single SET statement, such as SET x=1, y=2.
InitQuery is not currently supported for PostgreSQL.
Default: no initialization query
", - "ConnectionPoolConfigurationInfo$InitQuery": " One or more SQL statements for the proxy to run when opening each new database connection. Typically used with SET statements to make sure that each connection has identical settings such as time zone and character set. This setting is empty by default. For multiple statements, use semicolons as the separator. You can also include multiple variables in a single SET statement, such as SET x=1, y=2.
InitQuery is not currently supported for PostgreSQL.
One or more SQL statements for the proxy to run when opening each new database connection. Typically used with SET statements to make sure that each connection has identical settings such as time zone and character set. For multiple statements, use semicolons as the separator. You can also include multiple variables in a single SET statement, such as SET x=1, y=2.
Default: no initialization query
", + "ConnectionPoolConfigurationInfo$InitQuery": " One or more SQL statements for the proxy to run when opening each new database connection. Typically used with SET statements to make sure that each connection has identical settings such as time zone and character set. This setting is empty by default. For multiple statements, use semicolons as the separator. You can also include multiple variables in a single SET statement, such as SET x=1, y=2.
The identifier or Amazon Resource Name (ARN) for the source DB cluster parameter group. For information about creating an ARN, see Constructing an ARN for Amazon RDS in the Amazon Aurora User Guide.
Constraints:
Must specify a valid DB cluster parameter group.
If the source DB cluster parameter group is in the same AWS Region as the copy, specify a valid DB parameter group identifier, for example my-db-cluster-param-group, or a valid ARN.
If the source DB parameter group is in a different AWS Region than the copy, specify a valid DB cluster parameter group ARN, for example arn:aws:rds:us-east-1:123456789012:cluster-pg:custom-cluster-group1.
The identifier for the copied DB cluster parameter group.
Constraints:
Can't be null, empty, or blank
Must contain from 1 to 255 letters, numbers, or hyphens
First character must be a letter
Can't end with a hyphen or contain two consecutive hyphens
Example: my-cluster-param-group1
A description for the copied DB cluster parameter group.
", @@ -4411,7 +4411,7 @@ } }, "TargetHealth": { - "base": "This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Information about the connection health of an RDS Proxy target.
", + "base": "Information about the connection health of an RDS Proxy target.
", "refs": { "DBProxyTarget$TargetHealth": "Information about the connection health of the RDS Proxy target.
" } @@ -4454,13 +4454,13 @@ } }, "UserAuthConfig": { - "base": "This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Specifies the details of authentication used by a proxy to log in as a specific database user.
", + "base": "Specifies the details of authentication used by a proxy to log in as a specific database user.
", "refs": { "UserAuthConfigList$member": null } }, "UserAuthConfigInfo": { - "base": "This is prerelease documentation for the RDS Database Proxy feature in preview release. It is subject to change.
Returns the details of authentication used by a proxy to log in as a specific database user.
", + "base": "Returns the details of authentication used by a proxy to log in as a specific database user.
", "refs": { "UserAuthConfigInfoList$member": null } diff --git a/service/codegurureviewer/api.go b/service/codegurureviewer/api.go index d87304faacc..9dee4f07ec3 100644 --- a/service/codegurureviewer/api.go +++ b/service/codegurureviewer/api.go @@ -57,14 +57,27 @@ func (c *CodeGuruReviewer) AssociateRepositoryRequest(input *AssociateRepository // AssociateRepository API operation for Amazon CodeGuru Reviewer. // -// Associates an AWS CodeCommit repository with Amazon CodeGuru Reviewer. When -// you associate an AWS CodeCommit repository with Amazon CodeGuru Reviewer, -// Amazon CodeGuru Reviewer will provide recommendations for each pull request -// raised within the repository. You can view recommendations in the AWS CodeCommit -// repository. -// -// You can associate a GitHub repository using the Amazon CodeGuru Reviewer -// console. +// Use to associate an AWS CodeCommit repository or a repostory managed by AWS +// CodeStar Connections with Amazon CodeGuru Reviewer. When you associate a +// repository, CodeGuru Reviewer reviews source code changes in the repository's +// pull requests and provides automatic recommendations. You can view recommendations +// using the CodeGuru Reviewer console. For more information, see Recommendations +// in Amazon CodeGuru Reviewer (https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/recommendations.html) +// in the Amazon CodeGuru Reviewer User Guide. +// +// If you associate a CodeCommit repository, it must be in the same AWS Region +// and AWS account where its CodeGuru Reviewer code reviews are configured. +// +// Bitbucket and GitHub Enterprise Server repositories are managed by AWS CodeStar +// Connections to connect to CodeGuru Reviewer. For more information, see Connect +// to a repository source provider (https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/reviewer-ug/step-one.html#select-repository-source-provider) +// in the Amazon CodeGuru Reviewer User Guide. +// +// You cannot use the CodeGuru Reviewer SDK or the AWS CLI to associate a GitHub +// repository with Amazon CodeGuru Reviewer. To associate a GitHub repository, +// use the console. For more information, see Getting started with CodeGuru +// Reviewer (https://docs.aws.amazon.com/codeguru/latest/reviewer-ug/getting-started-with-guru.html) +// in the CodeGuru Reviewer 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 @@ -157,7 +170,7 @@ func (c *CodeGuruReviewer) DescribeCodeReviewRequest(input *DescribeCodeReviewIn // DescribeCodeReview API operation for Amazon CodeGuru Reviewer. // -// Returns the metadaata associated with the code review along with its status. +// Returns the metadata associated with the code review along with its status. // // 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 @@ -339,7 +352,8 @@ func (c *CodeGuruReviewer) DescribeRepositoryAssociationRequest(input *DescribeR // DescribeRepositoryAssociation API operation for Amazon CodeGuru Reviewer. // -// Describes a repository association. +// Returns a RepositoryAssociation (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html) +// object that contains information about the requested repository association. // // 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 @@ -678,9 +692,9 @@ func (c *CodeGuruReviewer) ListRecommendationFeedbackRequest(input *ListRecommen // ListRecommendationFeedback API operation for Amazon CodeGuru Reviewer. // -// Lists the customer feedback for a CodeGuru Reviewer recommendation for all -// users. This API will be used from the console to extract the previously given -// feedback by the user to pre-populate the feedback emojis for all recommendations. +// Returns a list of RecommendationFeedbackSummary (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RecommendationFeedbackSummary.html) +// objects that contain customer recommendation feedback for all CodeGuru Reviewer +// 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 @@ -978,9 +992,12 @@ func (c *CodeGuruReviewer) ListRepositoryAssociationsRequest(input *ListReposito // ListRepositoryAssociations API operation for Amazon CodeGuru Reviewer. // -// Lists repository associations. You can optionally filter on one or more of -// the following recommendation properties: provider types, states, names, and -// owners. +// Returns a list of RepositoryAssociationSummary (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html) +// objects that contain summary information about a repository association. +// You can filter the returned list by ProviderType (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html#reviewer-Type-RepositoryAssociationSummary-ProviderType), +// Name (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html#reviewer-Type-RepositoryAssociationSummary-Name), +// State (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html#reviewer-Type-RepositoryAssociationSummary-State), +// and Owner (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociationSummary.html#reviewer-Type-RepositoryAssociationSummary-Owner). // // 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 @@ -1118,7 +1135,7 @@ func (c *CodeGuruReviewer) PutRecommendationFeedbackRequest(input *PutRecommenda // PutRecommendationFeedback API operation for Amazon CodeGuru Reviewer. // -// Stores customer feedback for a CodeGuru-Reviewer recommendation. When this +// Stores customer feedback for a CodeGuru Reviewer recommendation. When this // API is called again with different reactions the previous feedback is overwritten. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -1319,11 +1336,15 @@ func (s *AssociateRepositoryOutput) SetRepositoryAssociation(v *RepositoryAssoci return s } -// Information about an AWS CodeCommit repository. +// Information about an AWS CodeCommit repository. The CodeCommit repository +// must be in the same AWS Region and AWS account where its CodeGuru Reviewer +// code reviews are configured. type CodeCommitRepository struct { _ struct{} `type:"structure"` - // The name of the AWS CodeCommit repository. + // The name of the AWS CodeCommit repository. For more information, see repositoryName + // (https://docs.aws.amazon.com/codecommit/latest/APIReference/API_GetRepository.html#CodeCommit-GetRepository-request-repositoryName) + // in the AWS CodeCommit API Reference. // // Name is a required field Name *string `min:"1" type:"string" required:"true"` @@ -1365,7 +1386,8 @@ func (s *CodeCommitRepository) SetName(v string) *CodeCommitRepository { type CodeReview struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the code review to describe. + // The Amazon Resource Name (ARN) of the CodeReview (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html) + // object. CodeReviewArn *string `min:"1" type:"string"` // The time, in milliseconds since the epoch, when the code review was created. @@ -1381,10 +1403,13 @@ type CodeReview struct { // The name of the code review. Name *string `min:"1" type:"string"` - // The owner of the repository. + // The owner of the repository. For an AWS CodeCommit repository, this is the + // AWS account ID of the account that owns the repository. For a GitHub or Bitbucket + // repository, this is the username for the account that owns the repository. Owner *string `min:"1" type:"string"` - // The provider type of the repository association. + // The type of repository that contains the reviewed code (for example, GitHub + // or Bitbucket). ProviderType *string `type:"string" enum:"ProviderType"` // The pull request ID for the code review. @@ -1396,7 +1421,15 @@ type CodeReview struct { // The type of the source code for the code review. SourceCodeType *SourceCodeType `type:"structure"` - // The state of the code review. + // The valid code review states are: + // + // * Completed: The code review is complete. + // + // * Pending: The code review started and has not completed or failed. + // + // * Failed: The code review failed. + // + // * Deleting: The code review is being deleted. State *string `type:"string" enum:"JobState"` // The reason for the state of the code review. @@ -1498,7 +1531,8 @@ func (s *CodeReview) SetType(v string) *CodeReview { type CodeReviewSummary struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the code review to describe. + // The Amazon Resource Name (ARN) of the CodeReview (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html) + // object. CodeReviewArn *string `min:"1" type:"string"` // The time, in milliseconds since the epoch, when the code review was created. @@ -1514,7 +1548,9 @@ type CodeReviewSummary struct { // The name of the code review. Name *string `min:"1" type:"string"` - // The owner of the repository. + // The owner of the repository. For an AWS CodeCommit repository, this is the + // AWS account ID of the account that owns the repository. For a GitHub or Bitbucket + // repository, this is the username for the account that owns the repository. Owner *string `min:"1" type:"string"` // The provider type of the repository association. @@ -1527,6 +1563,16 @@ type CodeReviewSummary struct { RepositoryName *string `min:"1" type:"string"` // The state of the code review. + // + // The valid code review states are: + // + // * Completed: The code review is complete. + // + // * Pending: The code review started and has not completed or failed. + // + // * Failed: The code review failed. + // + // * Deleting: The code review is being deleted. State *string `type:"string" enum:"JobState"` // The type of the code review. @@ -1613,10 +1659,10 @@ func (s *CodeReviewSummary) SetType(v string) *CodeReviewSummary { type CommitDiffSourceCodeType struct { _ struct{} `type:"structure"` - // Destination Commit SHA + // The SHA of the destination commit. DestinationCommit *string `min:"6" type:"string"` - // Source Commit SHA. + // The SHA of the source commit. SourceCommit *string `min:"6" type:"string"` } @@ -1703,7 +1749,8 @@ func (s *ConflictException) RequestID() string { type DescribeCodeReviewInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the code review to describe. + // The Amazon Resource Name (ARN) of the CodeReview (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html) + // object. // // CodeReviewArn is a required field CodeReviewArn *string `location:"uri" locationName:"CodeReviewArn" min:"1" type:"string" required:"true"` @@ -1767,7 +1814,8 @@ func (s *DescribeCodeReviewOutput) SetCodeReview(v *CodeReview) *DescribeCodeRev type DescribeRecommendationFeedbackInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) that identifies the code review. + // The Amazon Resource Name (ARN) of the CodeReview (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html) + // object. // // CodeReviewArn is a required field CodeReviewArn *string `location:"uri" locationName:"CodeReviewArn" min:"1" type:"string" required:"true"` @@ -1780,6 +1828,11 @@ type DescribeRecommendationFeedbackInput struct { // Optional parameter to describe the feedback for a given user. If this is // not supplied, it defaults to the user making the request. + // + // The UserId is an IAM principal that can be specified as an AWS account ID + // or an Amazon Resource Name (ARN). For more information, see Specifying a + // Principal (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying) + // in the AWS Identity and Access Management User Guide. UserId *string `location:"querystring" locationName:"UserId" min:"1" type:"string"` } @@ -1862,8 +1915,8 @@ func (s *DescribeRecommendationFeedbackOutput) SetRecommendationFeedback(v *Reco type DescribeRepositoryAssociationInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) identifying the association. You can retrieve - // this ARN by calling ListRepositories. + // The Amazon Resource Name (ARN) of the RepositoryAssociation (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html) + // object. You can retrieve this ARN by calling ListRepositories. // // AssociationArn is a required field AssociationArn *string `location:"uri" locationName:"AssociationArn" min:"1" type:"string" required:"true"` @@ -1927,7 +1980,8 @@ func (s *DescribeRepositoryAssociationOutput) SetRepositoryAssociation(v *Reposi type DisassociateRepositoryInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) identifying the association. + // The Amazon Resource Name (ARN) of the RepositoryAssociation (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html) + // object. // // AssociationArn is a required field AssociationArn *string `location:"uri" locationName:"AssociationArn" min:"1" type:"string" required:"true"` @@ -2058,8 +2112,7 @@ type ListCodeReviewsInput struct { NextToken *string `location:"querystring" locationName:"NextToken" min:"1" type:"string"` // List of provider types for filtering that needs to be applied before displaying - // the result. For example, "providerTypes=[GitHub]" will list code reviews - // from GitHub. + // the result. For example, providerTypes=[GitHub] lists code reviews from GitHub. ProviderTypes []*string `location:"querystring" locationName:"ProviderTypes" min:"1" type:"list"` // List of repository names for filtering that needs to be applied before displaying @@ -2067,8 +2120,17 @@ type ListCodeReviewsInput struct { RepositoryNames []*string `location:"querystring" locationName:"RepositoryNames" min:"1" type:"list"` // List of states for filtering that needs to be applied before displaying the - // result. For example, "states=[Pending]" will list code reviews in the Pending - // state. + // result. For example, states=[Pending] lists code reviews in the Pending state. + // + // The valid code review states are: + // + // * Completed: The code review is complete. + // + // * Pending: The code review started and has not completed or failed. + // + // * Failed: The code review failed. + // + // * Deleting: The code review is being deleted. States []*string `location:"querystring" locationName:"States" min:"1" type:"list"` // The type of code reviews to list in the response. @@ -2186,7 +2248,8 @@ func (s *ListCodeReviewsOutput) SetNextToken(v string) *ListCodeReviewsOutput { type ListRecommendationFeedbackInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) that identifies the code review. + // The Amazon Resource Name (ARN) of the CodeReview (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html) + // object. // // CodeReviewArn is a required field CodeReviewArn *string `location:"uri" locationName:"CodeReviewArn" min:"1" type:"string" required:"true"` @@ -2201,14 +2264,16 @@ type ListRecommendationFeedbackInput struct { // unchanged. NextToken *string `location:"querystring" locationName:"NextToken" min:"1" type:"string"` - // Filter on recommendationIds that need to be applied before displaying the - // result. This can be used to query all the recommendation feedback for a given - // recommendation. + // Used to query the recommendation feedback for a given recommendation. RecommendationIds []*string `location:"querystring" locationName:"RecommendationIds" min:"1" type:"list"` - // Filter on userIds that need to be applied before displaying the result. This - // can be used to query all the recommendation feedback for a code review from - // a given user. + // An AWS user's account ID or Amazon Resource Name (ARN). Use this ID to query + // the recommendation feedback for a code review from that user. + // + // The UserId is an IAM principal that can be specified as an AWS account ID + // or an Amazon Resource Name (ARN). For more information, see Specifying a + // Principal (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying) + // in the AWS Identity and Access Management User Guide. UserIds []*string `location:"querystring" locationName:"UserIds" min:"1" type:"list"` } @@ -2289,7 +2354,7 @@ type ListRecommendationFeedbackOutput struct { // unchanged. NextToken *string `min:"1" type:"string"` - // Recommendation feedback summaries corresponding to the code reivew ARN. + // Recommendation feedback summaries corresponding to the code review ARN. RecommendationFeedbackSummaries []*RecommendationFeedbackSummary `type:"list"` } @@ -2318,7 +2383,8 @@ func (s *ListRecommendationFeedbackOutput) SetRecommendationFeedbackSummaries(v type ListRecommendationsInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the code review to describe. + // The Amazon Resource Name (ARN) of the CodeReview (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html) + // object. // // CodeReviewArn is a required field CodeReviewArn *string `location:"uri" locationName:"CodeReviewArn" min:"1" type:"string" required:"true"` @@ -2421,8 +2487,8 @@ type ListRepositoryAssociationsInput struct { // only returns maxResults results in a single page with a nextToken response // element. The remaining results of the initial request can be seen by sending // another ListRepositoryAssociations request with the returned nextToken value. - // This value can be between 1 and 25. If this parameter is not used, ListRepositoryAssociations - // returns up to 25 results and a nextToken value if applicable. + // This value can be between 1 and 100. If this parameter is not used, ListRepositoryAssociations + // returns up to 100 results and a nextToken value if applicable. MaxResults *int64 `location:"querystring" locationName:"MaxResults" min:"1" type:"integer"` // List of repository names to use as a filter. @@ -2437,15 +2503,33 @@ type ListRepositoryAssociationsInput struct { // next items in a list and not for other programmatic purposes. NextToken *string `location:"querystring" locationName:"NextToken" min:"1" type:"string"` - // List of owners to use as a filter. For GitHub, this is name of the GitHub - // account that was used to associate the repository. For AWS CodeCommit, it - // is the name of the CodeCommit account that was used to associate the repository. + // List of owners to use as a filter. For AWS CodeCommit, it is the name of + // the CodeCommit account that was used to associate the repository. For other + // repository source providers, such as Bitbucket, this is name of the account + // that was used to associate the repository. Owners []*string `location:"querystring" locationName:"Owner" min:"1" type:"list"` // List of provider types to use as a filter. ProviderTypes []*string `location:"querystring" locationName:"ProviderType" min:"1" type:"list"` - // List of states to use as a filter. + // List of repository association states to use as a filter. + // + // The valid repository association states are: + // + // * Associated: The repository association is complete. + // + // * Associating: CodeGuru Reviewer is: Setting up pull request notifications. + // This is required for pull requests to trigger a CodeGuru Reviewer review. + // If your repository ProviderType is GitHub or Bitbucket, CodeGuru Reviewer + // creates webhooks in your repository to trigger CodeGuru Reviewer reviews. + // If you delete these webhooks, reviews of code in your repository cannot + // be triggered. Setting up source code access. This is required for CodeGuru + // Reviewer to securely clone code in your repository. + // + // * Failed: The repository failed to associate or disassociate. + // + // * Disassociating: CodeGuru Reviewer is removing the repository's pull + // request notifications and source code access. States []*string `location:"querystring" locationName:"State" min:"1" type:"list"` } @@ -2565,7 +2649,17 @@ type Metrics struct { // Total number of recommendations found in the code review. FindingsCount *int64 `type:"long"` - // Lines of code metered in the code review. + // Lines of code metered in the code review. For the initial code review pull + // request and all subsequent revisions, this includes all lines of code in + // the files added to the pull request. In subsequent revisions, for files that + // already existed in the pull request, this includes only the changed lines + // of code. In both cases, this does not include non-code lines such as comments + // and import statements. For example, if you submit a pull request containing + // 5 files, each with 500 lines of code, and in a subsequent revision you added + // a new file with 200 lines of code, and also modified a total of 25 lines + // across the initial 5 files, MeteredLinesOfCodeCount includes the first 5 + // files (5 * 500 = 2,500 lines), the new file (200 lines) and the 25 changed + // lines of code for a total of 2,725 lines of code. MeteredLinesOfCodeCount *int64 `type:"long"` } @@ -2598,7 +2692,17 @@ type MetricsSummary struct { // Total number of recommendations found in the code review. FindingsCount *int64 `type:"long"` - // Lines of code metered in the code review. + // Lines of code metered in the code review. For the initial code review pull + // request and all subsequent revisions, this includes all lines of code in + // the files added to the pull request. In subsequent revisions, for files that + // already existed in the pull request, this includes only the changed lines + // of code. In both cases, this does not include non-code lines such as comments + // and import statements. For example, if you submit a pull request containing + // 5 files, each with 500 lines of code, and in a subsequent revision you added + // a new file with 200 lines of code, and also modified a total of 25 lines + // across the initial 5 files, MeteredLinesOfCodeCount includes the first 5 + // files (5 * 500 = 2,500 lines), the new file (200 lines) and the 25 changed + // lines of code for a total of 2,725 lines of code. MeteredLinesOfCodeCount *int64 `type:"long"` } @@ -2683,7 +2787,8 @@ func (s *NotFoundException) RequestID() string { type PutRecommendationFeedbackInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) that identifies the code review. + // The Amazon Resource Name (ARN) of the CodeReview (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html) + // object. // // CodeReviewArn is a required field CodeReviewArn *string `min:"1" type:"string" required:"true"` @@ -2772,7 +2877,8 @@ func (s PutRecommendationFeedbackOutput) GoString() string { type RecommendationFeedback struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) that identifies the code review. + // The Amazon Resource Name (ARN) of the CodeReview (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_CodeReview.html) + // object. CodeReviewArn *string `min:"1" type:"string"` // The time at which the feedback was created. @@ -2789,7 +2895,12 @@ type RecommendationFeedback struct { // Later on it can be used to collect the feedback. RecommendationId *string `min:"1" type:"string"` - // The user principal that made the API call. + // The ID of the user that made the API call. + // + // The UserId is an IAM principal that can be specified as an AWS account ID + // or an Amazon Resource Name (ARN). For more information, see Specifying a + // Principal (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying) + // in the AWS Identity and Access Management User Guide. UserId *string `min:"1" type:"string"` } @@ -2850,7 +2961,12 @@ type RecommendationFeedbackSummary struct { // Later on it can be used to collect the feedback. RecommendationId *string `min:"1" type:"string"` - // The identifier for the user that gave the feedback. + // The ID of the user that gave the feedback. + // + // The UserId is an IAM principal that can be specified as an AWS account ID + // or an Amazon Resource Name (ARN). For more information, see Specifying a + // Principal (https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html#Principal_specifying) + // in the AWS Identity and Access Management User Guide. UserId *string `min:"1" type:"string"` } @@ -2892,7 +3008,7 @@ type RecommendationSummary struct { // Last line where the recommendation is applicable in the source commit or // source branch. For a single line comment the start line and end line values - // will be the same. + // are the same. EndLine *int64 `type:"integer"` // Name of the file on which a recommendation is provided. @@ -2947,15 +3063,21 @@ func (s *RecommendationSummary) SetStartLine(v int64) *RecommendationSummary { return s } -// Information about a repository. +// Information about an associated AWS CodeCommit repository or an associated +// repository that is managed by AWS CodeStar Connections (for example, Bitbucket). +// This Repository object is not used if your source code is in an associated +// GitHub repository. type Repository struct { _ struct{} `type:"structure"` - // Information about a Bitbucket Cloud repository. + // Information about a Bitbucket repository. Bitbucket *ThirdPartySourceRepository `type:"structure"` // Information about an AWS CodeCommit repository. CodeCommit *CodeCommitRepository `type:"structure"` + + // Information about a GitHub Enterprise Server repository. + GitHubEnterpriseServer *ThirdPartySourceRepository `type:"structure"` } // String returns the string representation @@ -2981,6 +3103,11 @@ func (s *Repository) Validate() error { invalidParams.AddNested("CodeCommit", err.(request.ErrInvalidParams)) } } + if s.GitHubEnterpriseServer != nil { + if err := s.GitHubEnterpriseServer.Validate(); err != nil { + invalidParams.AddNested("GitHubEnterpriseServer", err.(request.ErrInvalidParams)) + } + } if invalidParams.Len() > 0 { return invalidParams @@ -3000,7 +3127,15 @@ func (s *Repository) SetCodeCommit(v *CodeCommitRepository) *Repository { return s } -// Information about a repository association. +// SetGitHubEnterpriseServer sets the GitHubEnterpriseServer field's value. +func (s *Repository) SetGitHubEnterpriseServer(v *ThirdPartySourceRepository) *Repository { + s.GitHubEnterpriseServer = v + return s +} + +// Information about a repository association. The DescribeRepositoryAssociation +// (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_DescribeRepositoryAssociation.html) +// operation returns a RepositoryAssociation object. type RepositoryAssociation struct { _ struct{} `type:"structure"` @@ -3010,7 +3145,10 @@ type RepositoryAssociation struct { // The ID of the repository association. AssociationId *string `min:"1" type:"string"` - // The Amazon Resource Name (ARN) identifying the repository connection. + // The Amazon Resource Name (ARN) of an AWS CodeStar Connections connection. + // Its format is arn:aws:codestar-connections:region-id:aws-account_id:connection/connection-id. + // For more information, see Connection (https://docs.aws.amazon.com/codestar-connections/latest/APIReference/API_Connection.html) + // in the AWS CodeStar Connections API Reference. ConnectionArn *string `type:"string"` // The time, in milliseconds since the epoch, when the repository association @@ -3024,13 +3162,32 @@ type RepositoryAssociation struct { // The name of the repository. Name *string `min:"1" type:"string"` - // The owner of the repository. + // The owner of the repository. For an AWS CodeCommit repository, this is the + // AWS account ID of the account that owns the repository. For a GitHub or Bitbucket + // repository, this is the username for the account that owns the repository. Owner *string `min:"1" type:"string"` // The provider type of the repository association. ProviderType *string `type:"string" enum:"ProviderType"` // The state of the repository association. + // + // The valid repository association states are: + // + // * Associated: The repository association is complete. + // + // * Associating: CodeGuru Reviewer is: Setting up pull request notifications. + // This is required for pull requests to trigger a CodeGuru Reviewer review. + // If your repository ProviderType is GitHub or Bitbucket, CodeGuru Reviewer + // creates webhooks in your repository to trigger CodeGuru Reviewer reviews. + // If you delete these webhooks, reviews of code in your repository cannot + // be triggered. Setting up source code access. This is required for CodeGuru + // Reviewer to securely clone code in your repository. + // + // * Failed: The repository failed to associate or disassociate. + // + // * Disassociating: CodeGuru Reviewer is removing the repository's pull + // request notifications and source code access. State *string `type:"string" enum:"RepositoryAssociationState"` // A description of why the repository association is in the current state. @@ -3107,17 +3264,23 @@ func (s *RepositoryAssociation) SetStateReason(v string) *RepositoryAssociation return s } -// Information about a repository association. +// Summary information about a repository association. The ListRepositoryAssociations +// (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_ListRepositoryAssociations.html) +// operation returns a list of RepositoryAssociationSummary objects. type RepositoryAssociationSummary struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) identifying the repository association. + // The Amazon Resource Name (ARN) of the RepositoryAssociation (https://docs.aws.amazon.com/codeguru/latest/reviewer-api/API_RepositoryAssociation.html) + // object. AssociationArn *string `min:"1" type:"string"` // The repository association ID. AssociationId *string `min:"1" type:"string"` - // The Amazon Resource Name (ARN) identifying the repository connection. + // The Amazon Resource Name (ARN) of an AWS CodeStar Connections connection. + // Its format is arn:aws:codestar-connections:region-id:aws-account_id:connection/connection-id. + // For more information, see Connection (https://docs.aws.amazon.com/codestar-connections/latest/APIReference/API_Connection.html) + // in the AWS CodeStar Connections API Reference. ConnectionArn *string `type:"string"` // The time, in milliseconds since the epoch, since the repository association @@ -3127,7 +3290,9 @@ type RepositoryAssociationSummary struct { // The name of the repository association. Name *string `min:"1" type:"string"` - // The owner of the repository association. + // The owner of the repository. For an AWS CodeCommit repository, this is the + // AWS account ID of the account that owns the repository. For a GitHub or Bitbucket + // repository, this is the username for the account that owns the repository. Owner *string `min:"1" type:"string"` // The provider type of the repository association. @@ -3135,21 +3300,22 @@ type RepositoryAssociationSummary struct { // The state of the repository association. // - // Associated - // - // Amazon CodeGuru Reviewer is associated with the repository. - // - // Associating + // The valid repository association states are: // - // The association is in progress. + // * Associated: The repository association is complete. // - // Failed + // * Associating: CodeGuru Reviewer is: Setting up pull request notifications. + // This is required for pull requests to trigger a CodeGuru Reviewer review. + // If your repository ProviderType is GitHub or Bitbucket, CodeGuru Reviewer + // creates webhooks in your repository to trigger CodeGuru Reviewer reviews. + // If you delete these webhooks, reviews of code in your repository cannot + // be triggered. Setting up source code access. This is required for CodeGuru + // Reviewer to securely clone code in your repository. // - // The association failed. + // * Failed: The repository failed to associate or disassociate. // - // Disassociating - // - // Amazon CodeGuru Reviewer is in the process of disassociating with the repository. + // * Disassociating: CodeGuru Reviewer is removing the repository's pull + // request notifications and source code access. State *string `type:"string" enum:"RepositoryAssociationState"` } @@ -3291,12 +3457,14 @@ func (s *SourceCodeType) SetCommitDiff(v *CommitDiffSourceCodeType) *SourceCodeT return s } -// Information about a third party source repository connected through CodeStar -// Connections. +// Information about a third-party source repository connected to CodeGuru Reviewer. type ThirdPartySourceRepository struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) identifying the repository connection. + // The Amazon Resource Name (ARN) of an AWS CodeStar Connections connection. + // Its format is arn:aws:codestar-connections:region-id:aws-account_id:connection/connection-id. + // For more information, see Connection (https://docs.aws.amazon.com/codestar-connections/latest/APIReference/API_Connection.html) + // in the AWS CodeStar Connections API Reference. // // ConnectionArn is a required field ConnectionArn *string `type:"string" required:"true"` @@ -3306,7 +3474,8 @@ type ThirdPartySourceRepository struct { // Name is a required field Name *string `min:"1" type:"string" required:"true"` - // The username of the owner of the repository. + // The owner of the repository. For a GitHub, GitHub Enterprise, or Bitbucket + // repository, this is the username for the account that owns the repository. // // Owner is a required field Owner *string `min:"1" type:"string" required:"true"` @@ -3500,6 +3669,9 @@ const ( // ProviderTypeBitbucket is a ProviderType enum value ProviderTypeBitbucket = "Bitbucket" + + // ProviderTypeGitHubEnterpriseServer is a ProviderType enum value + ProviderTypeGitHubEnterpriseServer = "GitHubEnterpriseServer" ) const ( diff --git a/service/codegurureviewer/doc.go b/service/codegurureviewer/doc.go index 43ed758d4e9..730e073c564 100644 --- a/service/codegurureviewer/doc.go +++ b/service/codegurureviewer/doc.go @@ -4,8 +4,8 @@ // requests to Amazon CodeGuru Reviewer. // // This section provides documentation for the Amazon CodeGuru Reviewer API -// operations. Amazon CodeGuru Reviewer is a service that uses program analysis -// and machine learning to detect potential defects that are difficult for developers +// operations. CodeGuru Reviewer is a service that uses program analysis and +// machine learning to detect potential defects that are difficult for developers // to find and recommends fixes in your Java code. // // By proactively detecting and providing recommendations for addressing code diff --git a/service/comprehendmedical/api.go b/service/comprehendmedical/api.go index c02e73aecf9..fbcfbbe7787 100644 --- a/service/comprehendmedical/api.go +++ b/service/comprehendmedical/api.go @@ -5938,6 +5938,9 @@ const ( // RelationshipTypeDirection is a RelationshipType enum value RelationshipTypeDirection = "DIRECTION" + + // RelationshipTypeSystemOrganSite is a RelationshipType enum value + RelationshipTypeSystemOrganSite = "SYSTEM_ORGAN_SITE" ) const ( diff --git a/service/ec2/api.go b/service/ec2/api.go index 2e438ca2bad..bd4bb845dcb 100644 --- a/service/ec2/api.go +++ b/service/ec2/api.go @@ -3926,13 +3926,13 @@ func (c *EC2) CreateDhcpOptionsRequest(input *CreateDhcpOptionsInput) (req *requ // * domain-name - If you're using AmazonProvidedDNS in us-east-1, specify // ec2.internal. If you're using AmazonProvidedDNS in another Region, specify // region.compute.internal (for example, ap-northeast-1.compute.internal). -// Otherwise, specify a domain name (for example, MyCompany.com). This value -// is used to complete unqualified DNS hostnames. Important: Some Linux operating -// systems accept multiple domain names separated by spaces. However, Windows -// and other Linux operating systems treat the value as a single domain, -// which results in unexpected behavior. If your DHCP options set is associated -// with a VPC that has instances with multiple operating systems, specify -// only one domain name. +// Otherwise, specify a domain name (for example, ExampleCompany.com). This +// value is used to complete unqualified DNS hostnames. Important: Some Linux +// operating systems accept multiple domain names separated by spaces. However, +// Windows and other Linux operating systems treat the value as a single +// domain, which results in unexpected behavior. If your DHCP options set +// is associated with a VPC that has instances with multiple operating systems, +// specify only one domain name. // // * ntp-servers - The IP addresses of up to four Network Time Protocol (NTP) // servers. @@ -46010,6 +46010,9 @@ type CreateDhcpOptionsInput struct { // the required permissions, the error response is DryRunOperation. Otherwise, // it is UnauthorizedOperation. DryRun *bool `locationName:"dryRun" type:"boolean"` + + // The tags to assign to the DHCP option. + TagSpecifications []*TagSpecification `locationName:"TagSpecification" locationNameList:"item" type:"list"` } // String returns the string representation @@ -46047,6 +46050,12 @@ func (s *CreateDhcpOptionsInput) SetDryRun(v bool) *CreateDhcpOptionsInput { return s } +// SetTagSpecifications sets the TagSpecifications field's value. +func (s *CreateDhcpOptionsInput) SetTagSpecifications(v []*TagSpecification) *CreateDhcpOptionsInput { + s.TagSpecifications = v + return s +} + type CreateDhcpOptionsOutput struct { _ struct{} `type:"structure"` @@ -46083,6 +46092,9 @@ type CreateEgressOnlyInternetGatewayInput struct { // it is UnauthorizedOperation. DryRun *bool `type:"boolean"` + // The tags to assign to the egress-only internet gateway. + TagSpecifications []*TagSpecification `locationName:"TagSpecification" locationNameList:"item" type:"list"` + // The ID of the VPC for which to create the egress-only internet gateway. // // VpcId is a required field @@ -46124,6 +46136,12 @@ func (s *CreateEgressOnlyInternetGatewayInput) SetDryRun(v bool) *CreateEgressOn return s } +// SetTagSpecifications sets the TagSpecifications field's value. +func (s *CreateEgressOnlyInternetGatewayInput) SetTagSpecifications(v []*TagSpecification) *CreateEgressOnlyInternetGatewayInput { + s.TagSpecifications = v + return s +} + // SetVpcId sets the VpcId field's value. func (s *CreateEgressOnlyInternetGatewayInput) SetVpcId(v string) *CreateEgressOnlyInternetGatewayInput { s.VpcId = &v @@ -47112,6 +47130,9 @@ type CreateInternetGatewayInput struct { // the required permissions, the error response is DryRunOperation. Otherwise, // it is UnauthorizedOperation. DryRun *bool `locationName:"dryRun" type:"boolean"` + + // The tags to assign to the internet gateway. + TagSpecifications []*TagSpecification `locationName:"TagSpecification" locationNameList:"item" type:"list"` } // String returns the string representation @@ -47130,6 +47151,12 @@ func (s *CreateInternetGatewayInput) SetDryRun(v bool) *CreateInternetGatewayInp return s } +// SetTagSpecifications sets the TagSpecifications field's value. +func (s *CreateInternetGatewayInput) SetTagSpecifications(v []*TagSpecification) *CreateInternetGatewayInput { + s.TagSpecifications = v + return s +} + type CreateInternetGatewayOutput struct { _ struct{} `type:"structure"` @@ -48199,6 +48226,9 @@ type CreateNetworkAclInput struct { // it is UnauthorizedOperation. DryRun *bool `locationName:"dryRun" type:"boolean"` + // The tags to assign to the network ACL. + TagSpecifications []*TagSpecification `locationName:"TagSpecification" locationNameList:"item" type:"list"` + // The ID of the VPC. // // VpcId is a required field @@ -48234,6 +48264,12 @@ func (s *CreateNetworkAclInput) SetDryRun(v bool) *CreateNetworkAclInput { return s } +// SetTagSpecifications sets the TagSpecifications field's value. +func (s *CreateNetworkAclInput) SetTagSpecifications(v []*TagSpecification) *CreateNetworkAclInput { + s.TagSpecifications = v + return s +} + // SetVpcId sets the VpcId field's value. func (s *CreateNetworkAclInput) SetVpcId(v string) *CreateNetworkAclInput { s.VpcId = &v @@ -48320,6 +48356,9 @@ type CreateNetworkInterfaceInput struct { // // SubnetId is a required field SubnetId *string `locationName:"subnetId" type:"string" required:"true"` + + // The tags to apply to the new network interface. + TagSpecifications []*TagSpecification `locationName:"TagSpecification" locationNameList:"item" type:"list"` } // String returns the string representation @@ -48405,6 +48444,12 @@ func (s *CreateNetworkInterfaceInput) SetSubnetId(v string) *CreateNetworkInterf return s } +// SetTagSpecifications sets the TagSpecifications field's value. +func (s *CreateNetworkInterfaceInput) SetTagSpecifications(v []*TagSpecification) *CreateNetworkInterfaceInput { + s.TagSpecifications = v + return s +} + // Contains the output of CreateNetworkInterface. type CreateNetworkInterfaceOutput struct { _ struct{} `type:"structure"` @@ -49017,6 +49062,9 @@ type CreateSecurityGroupInput struct { // GroupName is a required field GroupName *string `type:"string" required:"true"` + // The tags to assign to the security group. + TagSpecifications []*TagSpecification `locationName:"TagSpecification" locationNameList:"item" type:"list"` + // [EC2-VPC] The ID of the VPC. Required for EC2-VPC. VpcId *string `type:"string"` } @@ -49065,6 +49113,12 @@ func (s *CreateSecurityGroupInput) SetGroupName(v string) *CreateSecurityGroupIn return s } +// SetTagSpecifications sets the TagSpecifications field's value. +func (s *CreateSecurityGroupInput) SetTagSpecifications(v []*TagSpecification) *CreateSecurityGroupInput { + s.TagSpecifications = v + return s +} + // SetVpcId sets the VpcId field's value. func (s *CreateSecurityGroupInput) SetVpcId(v string) *CreateSecurityGroupInput { s.VpcId = &v @@ -49076,6 +49130,9 @@ type CreateSecurityGroupOutput struct { // The ID of the security group. GroupId *string `locationName:"groupId" type:"string"` + + // The tags assigned to the security group. + Tags []*Tag `locationName:"tagSet" locationNameList:"item" type:"list"` } // String returns the string representation @@ -49094,6 +49151,12 @@ func (s *CreateSecurityGroupOutput) SetGroupId(v string) *CreateSecurityGroupOut return s } +// SetTags sets the Tags field's value. +func (s *CreateSecurityGroupOutput) SetTags(v []*Tag) *CreateSecurityGroupOutput { + s.Tags = v + return s +} + type CreateSnapshotInput struct { _ struct{} `type:"structure"` @@ -49387,6 +49450,9 @@ type CreateSubnetInput struct { // ARN, you must also specify the Availability Zone of the Outpost subnet. OutpostArn *string `type:"string"` + // The tags to assign to the subnet. + TagSpecifications []*TagSpecification `locationName:"TagSpecification" locationNameList:"item" type:"list"` + // The ID of the VPC. // // VpcId is a required field @@ -49455,6 +49521,12 @@ func (s *CreateSubnetInput) SetOutpostArn(v string) *CreateSubnetInput { return s } +// SetTagSpecifications sets the TagSpecifications field's value. +func (s *CreateSubnetInput) SetTagSpecifications(v []*TagSpecification) *CreateSubnetInput { + s.TagSpecifications = v + return s +} + // SetVpcId sets the VpcId field's value. func (s *CreateSubnetInput) SetVpcId(v string) *CreateSubnetInput { s.VpcId = &v @@ -51507,6 +51579,9 @@ type CreateVpcInput struct { // The ID of an IPv6 address pool from which to allocate the IPv6 CIDR block. Ipv6Pool *string `type:"string"` + + // The tags to assign to the VPC. + TagSpecifications []*TagSpecification `locationName:"TagSpecification" locationNameList:"item" type:"list"` } // String returns the string representation @@ -51574,6 +51649,12 @@ func (s *CreateVpcInput) SetIpv6Pool(v string) *CreateVpcInput { return s } +// SetTagSpecifications sets the TagSpecifications field's value. +func (s *CreateVpcInput) SetTagSpecifications(v []*TagSpecification) *CreateVpcInput { + s.TagSpecifications = v + return s +} + type CreateVpcOutput struct { _ struct{} `type:"structure"` @@ -105942,12 +106023,14 @@ type TagSpecification struct { // The type of resource to tag. Currently, the resource types that support tagging // on creation are: capacity-reservation | client-vpn-endpoint | dedicated-host - // | fleet | fpga-image | host-reservation | instance | ipv4pool-ec2 | ipv6pool-ec2 - // | key-pair | launch-template | natgateway | spot-fleet-request | placement-group - // | prefix-list | snapshot | traffic-mirror-filter | traffic-mirror-session - // | traffic-mirror-target | transit-gateway | transit-gateway-attachment | - // transit-gateway-route-table | vpc-endpoint (for interface and gateway endpoints) - // | vpc-endpoint-service (for AWS PrivateLink) | volume | vpc-flow-log. + // | dhcp-options | export-image-task | export-instance-task | fleet | fpga-image + // | host-reservation | import-image-task | import-snapshot-task | instance + // | internet-gateway | ipv4pool-ec2 | ipv6pool-ec2 | key-pair | launch-template + // | placement-group | prefix-list | launch-template | natgateway | network-acl + // | security-group | spot-fleet-request | snapshot | subnet | traffic-mirror-filter + // | traffic-mirror-session | traffic-mirror-target | transit-gateway | transit-gateway-attachment + // | transit-gateway-route-table | volume |vpc | vpc-endpoint (for interface + // and gateway endpoints) | vpc-endpoint-service (for AWS PrivateLink) | vpc-flow-log. // // To tag a resource after it has been created, see CreateTags (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html). ResourceType *string `locationName:"resourceType" type:"string" enum:"ResourceType"` diff --git a/service/ecr/api.go b/service/ecr/api.go index 12e2e1bd6a6..580ca1a51a8 100644 --- a/service/ecr/api.go +++ b/service/ecr/api.go @@ -2184,6 +2184,10 @@ func (c *ECR) PutImageRequest(input *PutImageInput) (req *request.Request, outpu // The specified image is tagged with a tag that already exists. The repository // is configured for tag immutability. // +// * ImageDigestDoesNotMatchException +// The specified image digest does not match the digest that Amazon ECR calculated +// for the image. +// // See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutImage func (c *ECR) PutImage(input *PutImageInput) (*PutImageOutput, error) { req, out := c.PutImageRequest(input) @@ -5280,6 +5284,63 @@ func (s *ImageDetail) SetRepositoryName(v string) *ImageDetail { return s } +// The specified image digest does not match the digest that Amazon ECR calculated +// for the image. +type ImageDigestDoesNotMatchException struct { + _ struct{} `type:"structure"` + RespMetadata protocol.ResponseMetadata `json:"-" xml:"-"` + + Message_ *string `locationName:"message" type:"string"` +} + +// String returns the string representation +func (s ImageDigestDoesNotMatchException) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation +func (s ImageDigestDoesNotMatchException) GoString() string { + return s.String() +} + +func newErrorImageDigestDoesNotMatchException(v protocol.ResponseMetadata) error { + return &ImageDigestDoesNotMatchException{ + RespMetadata: v, + } +} + +// Code returns the exception type name. +func (s *ImageDigestDoesNotMatchException) Code() string { + return "ImageDigestDoesNotMatchException" +} + +// Message returns the exception's message. +func (s *ImageDigestDoesNotMatchException) Message() string { + if s.Message_ != nil { + return *s.Message_ + } + return "" +} + +// OrigErr always returns nil, satisfies awserr.Error interface. +func (s *ImageDigestDoesNotMatchException) OrigErr() error { + return nil +} + +func (s *ImageDigestDoesNotMatchException) 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 *ImageDigestDoesNotMatchException) StatusCode() int { + return s.RespMetadata.StatusCode +} + +// RequestID returns the service's response RequestID for request. +func (s *ImageDigestDoesNotMatchException) RequestID() string { + return s.RespMetadata.RequestID +} + // An object representing an Amazon ECR image failure. type ImageFailure struct { _ struct{} `type:"structure"` @@ -6929,6 +6990,9 @@ func (s *ListTagsForResourceOutput) SetTags(v []*Tag) *ListTagsForResourceOutput type PutImageInput struct { _ struct{} `type:"structure"` + // The image digest of the image manifest corresponding to the image. + ImageDigest *string `locationName:"imageDigest" type:"string"` + // The image manifest corresponding to the image to be uploaded. // // ImageManifest is a required field @@ -6989,6 +7053,12 @@ func (s *PutImageInput) Validate() error { return nil } +// SetImageDigest sets the ImageDigest field's value. +func (s *PutImageInput) SetImageDigest(v string) *PutImageInput { + s.ImageDigest = &v + return s +} + // SetImageManifest sets the ImageManifest field's value. func (s *PutImageInput) SetImageManifest(v string) *PutImageInput { s.ImageManifest = &v diff --git a/service/ecr/errors.go b/service/ecr/errors.go index bf44256bd1c..590a1134fff 100644 --- a/service/ecr/errors.go +++ b/service/ecr/errors.go @@ -21,6 +21,13 @@ const ( // the manifest or image tag after the last push. ErrCodeImageAlreadyExistsException = "ImageAlreadyExistsException" + // ErrCodeImageDigestDoesNotMatchException for service response error code + // "ImageDigestDoesNotMatchException". + // + // The specified image digest does not match the digest that Amazon ECR calculated + // for the image. + ErrCodeImageDigestDoesNotMatchException = "ImageDigestDoesNotMatchException" + // ErrCodeImageNotFoundException for service response error code // "ImageNotFoundException". // @@ -186,6 +193,7 @@ const ( var exceptionFromCode = map[string]func(protocol.ResponseMetadata) error{ "EmptyUploadException": newErrorEmptyUploadException, "ImageAlreadyExistsException": newErrorImageAlreadyExistsException, + "ImageDigestDoesNotMatchException": newErrorImageDigestDoesNotMatchException, "ImageNotFoundException": newErrorImageNotFoundException, "ImageTagAlreadyExistsException": newErrorImageTagAlreadyExistsException, "InvalidLayerException": newErrorInvalidLayerException, diff --git a/service/rds/api.go b/service/rds/api.go index 980b7220c89..c3e53ef8d1e 100644 --- a/service/rds/api.go +++ b/service/rds/api.go @@ -2236,10 +2236,6 @@ func (c *RDS) CreateDBProxyRequest(input *CreateDBProxyInput) (req *request.Requ // CreateDBProxy API operation for Amazon Relational Database Service. // -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Creates a new DB proxy. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -3645,10 +3641,6 @@ func (c *RDS) DeleteDBProxyRequest(input *DeleteDBProxyInput) (req *request.Requ // DeleteDBProxy API operation for Amazon Relational Database Service. // -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Deletes an existing proxy. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -4320,10 +4312,6 @@ func (c *RDS) DeregisterDBProxyTargetsRequest(input *DeregisterDBProxyTargetsInp // DeregisterDBProxyTargets API operation for Amazon Relational Database Service. // -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Remove the association between one or more DBProxyTarget data structures // and a DBProxyTargetGroup. // @@ -6560,10 +6548,6 @@ func (c *RDS) DescribeDBProxiesRequest(input *DescribeDBProxiesInput) (req *requ // DescribeDBProxies API operation for Amazon Relational Database Service. // -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Returns information about DB proxies. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -6702,10 +6686,6 @@ func (c *RDS) DescribeDBProxyTargetGroupsRequest(input *DescribeDBProxyTargetGro // DescribeDBProxyTargetGroups API operation for Amazon Relational Database Service. // -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Returns information about DB proxy target groups, represented by DBProxyTargetGroup // data structures. // @@ -6852,10 +6832,6 @@ func (c *RDS) DescribeDBProxyTargetsRequest(input *DescribeDBProxyTargetsInput) // DescribeDBProxyTargets API operation for Amazon Relational Database Service. // -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Returns information about DBProxyTarget objects. This API supports pagination. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -10825,10 +10801,6 @@ func (c *RDS) ModifyDBProxyRequest(input *ModifyDBProxyInput) (req *request.Requ // ModifyDBProxy API operation for Amazon Relational Database Service. // -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Changes the settings for an existing DB proxy. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -10916,10 +10888,6 @@ func (c *RDS) ModifyDBProxyTargetGroupRequest(input *ModifyDBProxyTargetGroupInp // ModifyDBProxyTargetGroup API operation for Amazon Relational Database Service. // -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Modifies the properties of a DBProxyTargetGroup. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -11912,10 +11880,6 @@ func (c *RDS) RegisterDBProxyTargetsRequest(input *RegisterDBProxyTargetsInput) // RegisterDBProxyTargets API operation for Amazon Relational Database Service. // -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Associate one or more DBProxyTarget data structures with a DBProxyTargetGroup. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -15609,10 +15573,6 @@ func (s *CloudwatchLogsExportConfiguration) SetEnableLogTypes(v []*string) *Clou return s } -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Specifies the settings that control the size and behavior of the connection // pool associated with a DBProxyTargetGroup. type ConnectionPoolConfiguration struct { @@ -15633,8 +15593,6 @@ type ConnectionPoolConfiguration struct { // statements, use semicolons as the separator. You can also include multiple // variables in a single SET statement, such as SET x=1, y=2. // - // InitQuery is not currently supported for PostgreSQL. - // // Default: no initialization query InitQuery *string `type:"string"` @@ -15708,10 +15666,6 @@ func (s *ConnectionPoolConfiguration) SetSessionPinningFilters(v []*string) *Con return s } -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Displays the settings that control the size and behavior of the connection // pool associated with a DBProxyTarget. type ConnectionPoolConfigurationInfo struct { @@ -15728,8 +15682,6 @@ type ConnectionPoolConfigurationInfo struct { // is empty by default. For multiple statements, use semicolons as the separator. // You can also include multiple variables in a single SET statement, such as // SET x=1, y=2. - // - // InitQuery is not currently supported for PostgreSQL. InitQuery *string `type:"string"` // The maximum size of the connection pool for each target in a target group. @@ -22987,10 +22939,6 @@ func (s *DBParameterGroupStatus) SetParameterApplyStatus(v string) *DBParameterG return s } -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // The data structure representing a proxy managed by the RDS Proxy. // // This data type is used as a response element in the DescribeDBProxies action. @@ -23154,10 +23102,6 @@ func (s *DBProxy) SetVpcSubnetIds(v []*string) *DBProxy { return s } -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Contains the details for an RDS Proxy target. It represents an RDS DB instance // or Aurora DB cluster that the proxy can connect to. One or more targets are // associated with an RDS Proxy target group. @@ -23245,10 +23189,6 @@ func (s *DBProxyTarget) SetType(v string) *DBProxyTarget { return s } -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Represents a set of RDS DB instances, Aurora DB clusters, or both that a // proxy can connect to. Currently, each target group is associated with exactly // one RDS DB instance or Aurora DB cluster. @@ -41508,10 +41448,6 @@ func (s *Tag) SetValue(v string) *Tag { return s } -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Information about the connection health of an RDS Proxy target. type TargetHealth struct { _ struct{} `type:"structure"` @@ -41646,10 +41582,6 @@ func (s *UpgradeTarget) SetIsMajorVersionUpgrade(v bool) *UpgradeTarget { return s } -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Specifies the details of authentication used by a proxy to log in as a specific // database user. type UserAuthConfig struct { @@ -41716,10 +41648,6 @@ func (s *UserAuthConfig) SetUserName(v string) *UserAuthConfig { return s } -// -// This is prerelease documentation for the RDS Database Proxy feature in preview -// release. It is subject to change. -// // Returns the details of authentication used by a proxy to log in as a specific // database user. type UserAuthConfigInfo struct {