diff --git a/CHANGELOG.md b/CHANGELOG.md index 3bfccc0a903..0c959ee3c68 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,15 @@ +Release v1.43.32 (2022-04-04) +=== + +### Service Client Updates +* `service/iot`: Updates service API, documentation, and paginators + * AWS IoT - AWS IoT Device Defender adds support to list metric datapoints collected for IoT devices through the ListMetricValues API +* `service/proton`: Updates service API and documentation +* `service/servicecatalog`: Updates service API and documentation + * This release adds ProvisioningArtifictOutputKeys to DescribeProvisioningParameters to reference the outputs of a Provisioned Product and deprecates ProvisioningArtifactOutputs. +* `service/sms`: Updates service documentation + * Revised product update notice for SMS console deprecation. + Release v1.43.31 (2022-04-01) === diff --git a/aws/version.go b/aws/version.go index c771b8c7cd9..2b141994c9c 100644 --- a/aws/version.go +++ b/aws/version.go @@ -5,4 +5,4 @@ package aws const SDKName = "aws-sdk-go" // SDKVersion is the version of this SDK -const SDKVersion = "1.43.31" +const SDKVersion = "1.43.32" diff --git a/models/apis/iot/2015-05-28/api-2.json b/models/apis/iot/2015-05-28/api-2.json index 08914e15fa0..170549db5e4 100644 --- a/models/apis/iot/2015-05-28/api-2.json +++ b/models/apis/iot/2015-05-28/api-2.json @@ -2503,6 +2503,21 @@ {"shape":"InternalServerException"} ] }, + "ListMetricValues":{ + "name":"ListMetricValues", + "http":{ + "method":"GET", + "requestUri":"/metric-values" + }, + "input":{"shape":"ListMetricValuesRequest"}, + "output":{"shape":"ListMetricValuesResponse"}, + "errors":[ + {"shape":"InvalidRequestException"}, + {"shape":"ThrottlingException"}, + {"shape":"InternalFailureException"}, + {"shape":"ResourceNotFoundException"} + ] + }, "ListMitigationActions":{ "name":"ListMitigationActions", "http":{ @@ -3953,7 +3968,7 @@ "required":["thingGroupNames"], "members":{ "thingGroupNames":{"shape":"ThingGroupNames"}, - "overrideDynamicGroups":{"shape":"OverrideDynamicGroups"} + "overrideDynamicGroups":{"shape":"NullableBoolean"} } }, "AdditionalMetricsToRetainList":{ @@ -9514,6 +9529,64 @@ "nextToken":{"shape":"NextToken"} } }, + "ListMetricValuesRequest":{ + "type":"structure", + "required":[ + "thingName", + "metricName", + "startTime", + "endTime" + ], + "members":{ + "thingName":{ + "shape":"DeviceDefenderThingName", + "location":"querystring", + "locationName":"thingName" + }, + "metricName":{ + "shape":"BehaviorMetric", + "location":"querystring", + "locationName":"metricName" + }, + "dimensionName":{ + "shape":"DimensionName", + "location":"querystring", + "locationName":"dimensionName" + }, + "dimensionValueOperator":{ + "shape":"DimensionValueOperator", + "location":"querystring", + "locationName":"dimensionValueOperator" + }, + "startTime":{ + "shape":"Timestamp", + "location":"querystring", + "locationName":"startTime" + }, + "endTime":{ + "shape":"Timestamp", + "location":"querystring", + "locationName":"endTime" + }, + "maxResults":{ + "shape":"MaxResults", + "location":"querystring", + "locationName":"maxResults" + }, + "nextToken":{ + "shape":"NextToken", + "location":"querystring", + "locationName":"nextToken" + } + } + }, + "ListMetricValuesResponse":{ + "type":"structure", + "members":{ + "metricDatumList":{"shape":"MetricDatumList"}, + "nextToken":{"shape":"NextToken"} + } + }, "ListMitigationActionsRequest":{ "type":"structure", "members":{ @@ -10562,6 +10635,17 @@ "type":"string", "max":128 }, + "MetricDatum":{ + "type":"structure", + "members":{ + "timestamp":{"shape":"Timestamp"}, + "value":{"shape":"MetricValue"} + } + }, + "MetricDatumList":{ + "type":"list", + "member":{"shape":"MetricDatum"} + }, "MetricDimension":{ "type":"structure", "required":["dimensionName"], @@ -13400,7 +13484,7 @@ "VerificationStateDescription":{ "type":"string", "max":1000, - "pattern":"[\\p{Graph}\\x20]*" + "pattern":"[^\\p{Cntrl}]*" }, "Version":{"type":"long"}, "VersionConflictException":{ diff --git a/models/apis/iot/2015-05-28/docs-2.json b/models/apis/iot/2015-05-28/docs-2.json index 71937210fac..ed77e5753d6 100644 --- a/models/apis/iot/2015-05-28/docs-2.json +++ b/models/apis/iot/2015-05-28/docs-2.json @@ -157,6 +157,7 @@ "ListJobTemplates": "
Returns a list of job templates.
Requires permission to access the ListJobTemplates action.
", "ListJobs": "Lists jobs.
Requires permission to access the ListJobs action.
", "ListManagedJobTemplates": "Returns a list of managed job templates.
", + "ListMetricValues": "Lists the values reported for an IoT Device Defender metric (device-side metric, cloud-side metric, or custom metric) by the given thing during the specified time period.
", "ListMitigationActions": "Gets a list of all mitigation actions that match the specified filter criteria.
Requires permission to access the ListMitigationActions action.
", "ListOTAUpdates": "Lists OTA updates.
Requires permission to access the ListOTAUpdates action.
", "ListOutgoingCertificates": "Lists certificates that are being transferred but not yet accepted.
Requires permission to access the ListOutgoingCertificates action.
", @@ -1203,6 +1204,7 @@ "refs": { "AdditionalMetricsToRetainList$member": null, "Behavior$metric": "What is measured by the behavior.
", + "ListMetricValuesRequest$metricName": "The name of the security profile metric for which values are returned.
", "MetricToRetain$metric": "What is measured by the behavior.
" } }, @@ -3000,6 +3002,7 @@ "DetectMitigationActionExecution$thingName": "The name of the thing.
", "ListActiveViolationsRequest$thingName": "The name of the thing whose active violations are listed.
", "ListDetectMitigationActionsExecutionsRequest$thingName": "The name of the thing whose mitigation actions are listed.
", + "ListMetricValuesRequest$thingName": "The name of the thing for which security profile metric values are returned.
", "ListViolationEventsRequest$thingName": "A filter to limit results to those alerts caused by the specified thing.
", "ViolationEvent$thingName": "The name of the thing responsible for the violation event.
" } @@ -3021,6 +3024,7 @@ "DescribeDimensionRequest$name": "The unique identifier for the dimension.
", "DescribeDimensionResponse$name": "The unique identifier for the dimension.
", "DimensionNames$member": null, + "ListMetricValuesRequest$dimensionName": "The dimension name.
", "ListSecurityProfilesRequest$dimensionName": "A filter to limit results to the security profiles that use the defined dimension. Cannot be used with metricName
A unique identifier for the dimension.
", "UpdateDimensionRequest$name": "A unique identifier for the dimension. Choose something that describes the type and value to make it easy to remember what it does.
", @@ -3059,6 +3063,7 @@ "DimensionValueOperator": { "base": null, "refs": { + "ListMetricValuesRequest$dimensionValueOperator": "The dimension value operator.
", "MetricDimension$operator": "Defines how the dimensionValues
of a dimension are interpreted. For example, for dimension type TOPIC_FILTER, the IN
operator, a message will be counted only if its topic matches one of the topic filters. With NOT_IN
operator, a message will be counted only if it doesn't match any of the topic filters. The operator is optional: if it's not provided (is null
), it will be interpreted as IN
.
The hash algorithm used to code sign the file. You can use a string as the algorithm name if the target over-the-air (OTA) update devices are able to verify the signature that was generated using the same signature algorithm. For example, FreeRTOS uses SHA256
or SHA1
, so you can pass either of them based on which was used for generating the signature.
The hash algorithm used to code sign the file.
" } }, "HashKeyField": { @@ -4573,6 +4578,16 @@ "refs": { } }, + "ListMetricValuesRequest": { + "base": null, + "refs": { + } + }, + "ListMetricValuesResponse": { + "base": null, + "refs": { + } + }, "ListMitigationActionsRequest": { "base": null, "refs": { @@ -5049,6 +5064,7 @@ "ListDetectMitigationActionsTasksRequest$maxResults": "The maximum number of results to return at one time. The default is 25.
", "ListDimensionsRequest$maxResults": "The maximum number of results to retrieve at one time.
", "ListFleetMetricsRequest$maxResults": "The maximum number of results to return in this operation.
", + "ListMetricValuesRequest$maxResults": "The maximum number of results to return at one time.
", "ListMitigationActionsRequest$maxResults": "The maximum number of results to return at one time. The default is 25.
", "ListOTAUpdatesRequest$maxResults": "The maximum number of results to return at one time.
", "ListProvisioningTemplateVersionsRequest$maxResults": "The maximum number of results to return at one time.
", @@ -5095,6 +5111,18 @@ "IotEventsAction$messageId": "The ID of the message. The default messageId
is a new UUID value.
When batchMode
is true
, you can't specify a messageId
--a new UUID value will be assigned.
Assign a value to this property to ensure that only one input (message) with a given messageId
will be processed by an IoT Events detector.
A metric.
", + "refs": { + "MetricDatumList$member": null + } + }, + "MetricDatumList": { + "base": null, + "refs": { + "ListMetricValuesResponse$metricDatumList": "The data the thing reports for the metric during the specified time period.
" + } + }, "MetricDimension": { "base": "The dimension of a metric.
", "refs": { @@ -5133,6 +5161,7 @@ "refs": { "ActiveViolation$lastViolationValue": "The value of the metric (the measurement) that caused the most recent violation.
", "BehaviorCriteria$value": "The value to be compared with the metric
.
The value reported for the metric.
", "ViolationEvent$metricValue": "The value of the metric (the measurement).
" } }, @@ -5351,6 +5380,8 @@ "ListJobsResponse$nextToken": "The token for the next set of results, or null if there are no additional results.
", "ListManagedJobTemplatesRequest$nextToken": "The token to retrieve the next set of results.
", "ListManagedJobTemplatesResponse$nextToken": "The token to retrieve the next set of results.
", + "ListMetricValuesRequest$nextToken": "The token for the next set of results.
", + "ListMetricValuesResponse$nextToken": "A token that can be used to retrieve the next set of results, or null
if there are no additional results.
The token for the next set of results.
", "ListMitigationActionsResponse$nextToken": "The token for the next set of results.
", "ListOTAUpdatesRequest$nextToken": "A token used to retrieve the next set of results.
", @@ -5429,6 +5460,7 @@ "NullableBoolean": { "base": null, "refs": { + "AddThingsToThingGroupParams$overrideDynamicGroups": "Specifies if this mitigation action can move the things that triggered the mitigation action even if they are part of one or more dynamic thing groups.
", "StartDetectMitigationActionsTaskRequest$includeOnlyActiveViolations": "Specifies to list only active violations.
", "StartDetectMitigationActionsTaskRequest$includeSuppressedAlerts": "Specifies to include suppressed alerts.
" } @@ -5581,7 +5613,6 @@ "base": null, "refs": { "AddThingToThingGroupRequest$overrideDynamicGroups": "Override dynamic thing groups with static thing groups when 10-group limit is reached. If a thing belongs to 10 thing groups, and one or more of those groups are dynamic thing groups, adding a thing to a static group removes the thing from the last dynamic group.
", - "AddThingsToThingGroupParams$overrideDynamicGroups": "Specifies if this mitigation action can move the things that triggered the mitigation action even if they are part of one or more dynamic thing groups.
", "UpdateThingGroupsForThingRequest$overrideDynamicGroups": "Override dynamic thing groups with static thing groups when 10-group limit is reached. If a thing belongs to 10 thing groups, and one or more of those groups are dynamic thing groups, adding a thing to a static group removes the thing from the last dynamic group.
" } }, @@ -6864,7 +6895,7 @@ "SignatureAlgorithm": { "base": null, "refs": { - "CustomCodeSigning$signatureAlgorithm": "The signature algorithm used to code sign the file. You can use a string as the algorithm name if the target over-the-air (OTA) update devices are able to verify the signature that was generated using the same signature algorithm. For example, FreeRTOS uses ECDSA
or RSA
, so you can pass either of them based on which was used for generating the signature.
The signature algorithm used to code sign the file.
" } }, "SigningJobId": { @@ -7809,8 +7840,11 @@ "ListDetectMitigationActionsExecutionsRequest$endTime": "The end of the time period for which ML Detect mitigation actions executions are returned.
", "ListDetectMitigationActionsTasksRequest$startTime": "A filter to limit results to those found after the specified time. You must specify either the startTime and endTime or the taskId, but not both.
", "ListDetectMitigationActionsTasksRequest$endTime": "The end of the time period for which ML Detect mitigation actions tasks are returned.
", + "ListMetricValuesRequest$startTime": "The start of the time period for which metric values are returned.
", + "ListMetricValuesRequest$endTime": "The end of the time period for which metric values are returned.
", "ListViolationEventsRequest$startTime": "The start time for the alerts to be listed.
", "ListViolationEventsRequest$endTime": "The end time for the alerts to be listed.
", + "MetricDatum$timestamp": "The time the metric value was reported.
", "MitigationActionIdentifier$creationDate": "The date when this mitigation action was created.
", "UpdateAuditSuppressionRequest$expirationDate": "The expiration date (epoch timestamp in seconds) that you want the suppression to adhere to.
", "UpdateCustomMetricResponse$creationDate": "The creation date of the custom metric in milliseconds since epoch.
", diff --git a/models/apis/iot/2015-05-28/paginators-1.json b/models/apis/iot/2015-05-28/paginators-1.json index ee534f696c7..61293e3d27a 100644 --- a/models/apis/iot/2015-05-28/paginators-1.json +++ b/models/apis/iot/2015-05-28/paginators-1.json @@ -144,6 +144,12 @@ "output_token": "nextToken", "result_key": "jobs" }, + "ListMetricValues": { + "input_token": "nextToken", + "limit_key": "maxResults", + "output_token": "nextToken", + "result_key": "metricDatumList" + }, "ListMitigationActions": { "input_token": "nextToken", "limit_key": "maxResults", diff --git a/models/apis/proton/2020-07-20/api-2.json b/models/apis/proton/2020-07-20/api-2.json index 09d8f67643e..62659abe27e 100644 --- a/models/apis/proton/2020-07-20/api-2.json +++ b/models/apis/proton/2020-07-20/api-2.json @@ -1385,7 +1385,8 @@ "connectionArn":{"shape":"Arn"}, "encryptionKey":{"shape":"Arn"}, "name":{"shape":"RepositoryName"}, - "provider":{"shape":"RepositoryProvider"} + "provider":{"shape":"RepositoryProvider"}, + "tags":{"shape":"TagList"} } }, "CreateRepositoryOutput":{ diff --git a/models/apis/proton/2020-07-20/docs-2.json b/models/apis/proton/2020-07-20/docs-2.json index 2b20ab79205..4a56e7f5940 100644 --- a/models/apis/proton/2020-07-20/docs-2.json +++ b/models/apis/proton/2020-07-20/docs-2.json @@ -6,15 +6,15 @@ "CancelEnvironmentDeployment": "Attempts to cancel an environment deployment on an UpdateEnvironment action, if the deployment is IN_PROGRESS
. For more information, see Update an environment in the Proton Administrator guide.
The following list includes potential cancellation scenarios.
If the cancellation attempt succeeds, the resulting deployment state is CANCELLED
.
If the cancellation attempt fails, the resulting deployment state is FAILED
.
If the current UpdateEnvironment action succeeds before the cancellation attempt starts, the resulting deployment state is SUCCEEDED
and the cancellation attempt has no effect.
Attempts to cancel a service instance deployment on an UpdateServiceInstance action, if the deployment is IN_PROGRESS
. For more information, see Update a service instance in the Proton Administrator guide or the Proton User guide.
The following list includes potential cancellation scenarios.
If the cancellation attempt succeeds, the resulting deployment state is CANCELLED
.
If the cancellation attempt fails, the resulting deployment state is FAILED
.
If the current UpdateServiceInstance action succeeds before the cancellation attempt starts, the resulting deployment state is SUCCEEDED
and the cancellation attempt has no effect.
Attempts to cancel a service pipeline deployment on an UpdateServicePipeline action, if the deployment is IN_PROGRESS
. For more information, see Update a service pipeline in the Proton Administrator guide or the Proton User guide.
The following list includes potential cancellation scenarios.
If the cancellation attempt succeeds, the resulting deployment state is CANCELLED
.
If the cancellation attempt fails, the resulting deployment state is FAILED
.
If the current UpdateServicePipeline action succeeds before the cancellation attempt starts, the resulting deployment state is SUCCEEDED
and the cancellation attempt has no effect.
Deploy a new environment. An Proton environment is created from an environment template that defines infrastructure and resources that can be shared across services.
You can provision environments using the following methods:
Standard provisioning: Proton makes direct calls to provision your resources.
Pull request provisioning: Proton makes pull requests on your repository to provide compiled infrastructure as code (IaC) files that your IaC engine uses to provision resources.
For more information, see the Environments in the Proton Administrator Guide.
", + "CreateEnvironment": "Deploy a new environment. An Proton environment is created from an environment template that defines infrastructure and resources that can be shared across services.
You can provision environments using the following methods:
Amazon Web Services-managed provisioning: Proton makes direct calls to provision your resources.
Self-managed provisioning: Proton makes pull requests on your repository to provide compiled infrastructure as code (IaC) files that your IaC engine uses to provision resources.
For more information, see Environments and Provisioning methods in the Proton Administrator Guide.
", "CreateEnvironmentAccountConnection": "Create an environment account connection in an environment account so that environment infrastructure resources can be provisioned in the environment account from a management account.
An environment account connection is a secure bi-directional connection between a management account and an environment account that maintains authorization and permissions. For more information, see Environment account connections in the Proton Administrator guide.
", "CreateEnvironmentTemplate": "Create an environment template for Proton. For more information, see Environment Templates in the Proton Administrator Guide.
You can create an environment template in one of the two following ways:
Register and publish a standard environment template that instructs Proton to deploy and manage environment infrastructure.
Register and publish a customer managed environment template that connects Proton to your existing provisioned infrastructure that you manage. Proton doesn't manage your existing provisioned infrastructure. To create an environment template for customer provisioned and managed infrastructure, include the provisioning
parameter and set the value to CUSTOMER_MANAGED
. For more information, see Register and publish an environment template in the Proton Administrator Guide.
Create a new major or minor version of an environment template. A major version of an environment template is a version that isn't backwards compatible. A minor version of an environment template is a version that's backwards compatible within its major version.
", - "CreateRepository": "Create and register a link to a repository that can be used with pull request provisioning or template sync configurations. For more information, see Template bundles and Template sync configurations in the Proton Administrator Guide.
", + "CreateRepository": "Create and register a link to a repository that can be used with self-managed provisioning (infrastructure or pipelines) or for template sync configurations. When you create a repository link, Proton creates a service-linked role for you.
For more information, see Self-managed provisioning, Template bundles, and Template sync configurations in the Proton Administrator Guide.
", "CreateService": "Create an Proton service. An Proton service is an instantiation of a service template and often includes several service instances and pipeline. For more information, see Services in the Proton Administrator Guide and Services in the Proton User Guide.
", - "CreateServiceTemplate": "Create a service template. The administrator creates a service template to define standardized infrastructure and an optional CICD service pipeline. Developers, in turn, select the service template from Proton. If the selected service template includes a service pipeline definition, they provide a link to their source code repository. Proton then deploys and manages the infrastructure defined by the selected service template. For more information, see Service Templates in the Proton Administrator Guide.
", + "CreateServiceTemplate": "Create a service template. The administrator creates a service template to define standardized infrastructure and an optional CI/CD service pipeline. Developers, in turn, select the service template from Proton. If the selected service template includes a service pipeline definition, they provide a link to their source code repository. Proton then deploys and manages the infrastructure defined by the selected service template. For more information, see Service Templates in the Proton Administrator Guide.
", "CreateServiceTemplateVersion": "Create a new major or minor version of a service template. A major version of a service template is a version that isn't backward compatible. A minor version of a service template is a version that's backward compatible within its major version.
", - "CreateTemplateSyncConfig": "Set up a template for automated template version creation. When a commit is pushed to your registered repository, Proton checks for changes to your repository template bundles. If it detects a template bundle change, a new minor or major version of its template is created, if the version doesn’t already exist. For more information, see Template sync configurations in the Proton Administrator Guide.
", + "CreateTemplateSyncConfig": "Set up a template to create new template versions automatically. When a commit is pushed to your registered repository, Proton checks for changes to your repository template bundles. If it detects a template bundle change, a new major or minor version of its template is created, if the version doesn’t already exist. For more information, see Template sync configurations in the Proton Administrator Guide.
", "DeleteEnvironment": "Delete an environment.
", "DeleteEnvironmentAccountConnection": "In an environment account, delete an environment account connection.
After you delete an environment account connection that’s in use by an Proton environment, Proton can’t manage the environment infrastructure resources until a new environment account connection is accepted for the environment account and associated environment. You're responsible for cleaning up provisioned resources that remain without an environment connection.
For more information, see Environment account connections in the Proton Administrator guide.
", "DeleteEnvironmentTemplate": "If no other major or minor versions of an environment template exist, delete the environment template.
", @@ -30,9 +30,9 @@ "GetEnvironmentTemplate": "Get detail data for an environment template.
", "GetEnvironmentTemplateVersion": "View detail data for a major or minor version of an environment template.
", "GetRepository": "Get detail data for a repository.
", - "GetRepositorySyncStatus": "Get the repository sync status.
", + "GetRepositorySyncStatus": "Get the sync status of a repository used for Proton template sync. For more information about template sync, see .
A repository sync status isn't tied to the Proton Repository resource (or any other Proton resource). Therefore, tags on an Proton Repository resource have no effect on this action. Specifically, you can't use these tags to control access to this action using Attribute-based access control (ABAC).
For more information about ABAC, see ABAC in the Proton Administrator Guide.
Get detail data for a service.
", - "GetServiceInstance": "Get detail data for a service instance. A service instance is an instantiation of service template, which is running in a specific environment.
", + "GetServiceInstance": "Get detail data for a service instance. A service instance is an instantiation of service template and it runs in a specific environment.
", "GetServiceTemplate": "Get detail data for a service template.
", "GetServiceTemplateVersion": "View detail data for a major or minor version of a service template.
", "GetTemplateSyncConfig": "Get detail data for a template sync configuration.
", @@ -54,18 +54,18 @@ "ListServiceTemplates": "List service templates with detail data.
", "ListServices": "List services with summaries of detail data.
", "ListTagsForResource": "List tags for a resource. For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", - "NotifyResourceDeploymentStatusChange": "Notify Proton of status changes to a provisioned resource when you use pull request provisioning. For more information, see Template bundles.
Provisioning by pull request is currently in feature preview and is only usable with Terraform based Proton Templates. To learn more about Amazon Web Services Feature Preview terms, see section 2 on Beta and Previews.
In a management account, reject an environment account connection from another environment account.
After you reject an environment account connection request, you won’t be able to accept or use the rejected environment account connection.
You can’t reject an environment account connection that is connected to an environment.
For more information, see Environment account connections in the Proton Administrator guide.
", - "TagResource": "Tag a resource. For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", - "UntagResource": "Remove a tag from a resource. For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", + "NotifyResourceDeploymentStatusChange": "Notify Proton of status changes to a provisioned resource when you use self-managed provisioning.
For more information, see Self-managed provisioning in the Proton Administrator Guide.
", + "RejectEnvironmentAccountConnection": "In a management account, reject an environment account connection from another environment account.
After you reject an environment account connection request, you can't accept or use the rejected environment account connection.
You can’t reject an environment account connection that's connected to an environment.
For more information, see Environment account connections in the Proton Administrator guide.
", + "TagResource": "Tag a resource. A tag is a key-value pair of metadata that you associate with an Proton resource.
For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", + "UntagResource": "Remove a customer tag from a resource. A tag is a key-value pair of metadata associated with an Proton resource.
For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", "UpdateAccountSettings": "Update the Proton service pipeline role or repository settings.
", - "UpdateEnvironment": "Update an environment.
If the environment is associated with an environment account connection, don't update or include the protonServiceRoleArn
and provisioningRepository
parameter to update or connect to an environment account connection.
You can only update to a new environment account connection if it was created in the same environment account that the current environment account connection was created in and is associated with the current environment.
If the environment isn't associated with an environment account connection, don't update or include the environmentAccountConnectionId
parameter to update or connect to an environment account connection.
You can update either the environmentAccountConnectionId
or protonServiceRoleArn
parameter and value. You can’t update both.
If the environment was provisioned with pull request provisioning, include the provisioningRepository
parameter and omit the protonServiceRoleArn
and environmentAccountConnectionId
parameters.
If the environment wasn't provisioned with pull request provisioning, omit the provisioningRepository
parameter.
There are four modes for updating an environment as described in the following. The deploymentType
field defines the mode.
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
CURRENT_VERSION
In this mode, the environment is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include minor or major version parameters when you use this deployment-type
.
MINOR_VERSION
In this mode, the environment is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use.
MAJOR_VERSION
In this mode, the environment is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can also specify a different major version that's higher than the major version in use and a minor version (optional).
Update an environment.
If the environment is associated with an environment account connection, don't update or include the protonServiceRoleArn
and provisioningRepository
parameter to update or connect to an environment account connection.
You can only update to a new environment account connection if that connection was created in the same environment account that the current environment account connection was created in. The account connection must also be associated with the current environment.
If the environment isn't associated with an environment account connection, don't update or include the environmentAccountConnectionId
parameter. You can't update or connect the environment to an environment account connection if it isn't already associated with an environment connection.
You can update either the environmentAccountConnectionId
or protonServiceRoleArn
parameter and value. You can’t update both.
If the environment was configured for Amazon Web Services-managed provisioning, omit the provisioningRepository
parameter.
If the environment was configured for self-managed provisioning, specify the provisioningRepository
parameter and omit the protonServiceRoleArn
and environmentAccountConnectionId
parameters.
For more information, see Environments and Provisioning methods in the Proton Administrator Guide.
There are four modes for updating an environment. The deploymentType
field defines the mode.
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
CURRENT_VERSION
In this mode, the environment is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include minor or major version parameters when you use this deployment-type
.
MINOR_VERSION
In this mode, the environment is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use.
MAJOR_VERSION
In this mode, the environment is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can also specify a different major version that's higher than the major version in use and a minor version.
In an environment account, update an environment account connection to use a new IAM role.
For more information, see Environment account connections in the Proton Administrator guide.
", "UpdateEnvironmentTemplate": "Update an environment template.
", "UpdateEnvironmentTemplateVersion": "Update a major or minor version of an environment template.
", "UpdateService": "Edit a service description or use a spec to add and delete service instances.
Existing service instances and the service pipeline can't be edited using this API. They can only be deleted.
Use the description
parameter to modify the description.
Edit the spec
parameter to add or delete instances.
Update a service instance.
There are four modes for updating a service instance as described in the following. The deploymentType
field defines the mode.
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
CURRENT_VERSION
In this mode, the service instance is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include minor or major version parameters when you use this deployment-type
.
MINOR_VERSION
In this mode, the service instance is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use.
MAJOR_VERSION
In this mode, the service instance is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can also specify a different major version that is higher than the major version in use and a minor version (optional).
Update the service pipeline.
There are four modes for updating a service pipeline as described in the following. The deploymentType
field defines the mode.
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
CURRENT_VERSION
In this mode, the service pipeline is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include minor or major version parameters when you use this deployment-type
.
MINOR_VERSION
In this mode, the service pipeline is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use.
MAJOR_VERSION
In this mode, the service pipeline is deployed and updated with the published, recommended (latest) major and minor version of the current template by default. You can also specify a different major version that is higher than the major version in use and a minor version (optional).
Update a service instance.
There are four modes for updating a service instance. The deploymentType
field defines the mode.
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
CURRENT_VERSION
In this mode, the service instance is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include minor or major version parameters when you use this deployment-type
.
MINOR_VERSION
In this mode, the service instance is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use.
MAJOR_VERSION
In this mode, the service instance is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can also specify a different major version that's higher than the major version in use and a minor version.
Update the service pipeline.
There are four modes for updating a service pipeline. The deploymentType
field defines the mode.
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
CURRENT_VERSION
In this mode, the service pipeline is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include major or minor version parameters when you use this deployment-type
.
MINOR_VERSION
In this mode, the service pipeline is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can specify a different minor version of the current major version in use.
MAJOR_VERSION
In this mode, the service pipeline is deployed and updated with the published, recommended (latest) major and minor version of the current template by default. You can specify a different major version that's higher than the major version in use and a minor version.
Update a service template.
", "UpdateServiceTemplateVersion": "Update a major or minor version of a service template.
", "UpdateTemplateSyncConfig": "Update template sync configuration parameters, except for the templateName
and templateType
.
The Proton pipeline service role and repository data.
", + "base": "The Proton pipeline service role and repository data shared across the Amazon Web Services account.
", "refs": { "GetAccountSettingsOutput$accountSettings": "The Proton pipeline service role detail data that's returned by Proton.
", - "UpdateAccountSettingsOutput$accountSettings": "The Proton pipeline service role repository detail data that's returned by Proton.
" + "UpdateAccountSettingsOutput$accountSettings": "The Proton pipeline service role and repository data shared across the Amazon Web Services account.
" } }, "Arn": { "base": null, "refs": { "CreateEnvironmentAccountConnectionInput$roleArn": "The Amazon Resource Name (ARN) of the IAM service role that's created in the environment account. Proton uses this role to provision infrastructure resources in the associated environment account.
", - "CreateEnvironmentInput$protonServiceRoleArn": "The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make calls to other services on your behalf. You must include either the environmentAccountConnectionId
or protonServiceRoleArn
parameter and value and omit the provisioningRepository
parameter when you use standard provisioning.
The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make calls to other services on your behalf.
To use Amazon Web Services-managed provisioning for the environment, specify either the environmentAccountConnectionId
or protonServiceRoleArn
parameter and omit the provisioningRepository
parameter.
A customer provided encryption key that Proton uses to encrypt data.
", - "CreateRepositoryInput$connectionArn": "The Amazon Resource Name (ARN) of your Amazon Web Services CodeStar connection. For more information, see Setting up for Proton in the Proton Administrator Guide.
", + "CreateRepositoryInput$connectionArn": "The Amazon Resource Name (ARN) of your Amazon Web Services CodeStar connection. For more information, see Setting up for Proton in the Proton Administrator Guide.
", "CreateRepositoryInput$encryptionKey": "The ARN of your customer Amazon Web Services Key Management Service (Amazon Web Services KMS) key.
", "CreateServiceInput$repositoryConnectionArn": "The Amazon Resource Name (ARN) of the repository connection. For more information, see Set up repository connection in the Proton Administrator Guide and Setting up with Proton in the Proton User Guide. Don't include this parameter if your service template doesn't include a service pipeline.
", "CreateServiceTemplateInput$encryptionKey": "A customer provided encryption key that's used to encrypt data.
", @@ -115,16 +115,16 @@ "Service$repositoryConnectionArn": "The Amazon Resource Name (ARN) of the repository connection. For more information, see Set up a repository connection in the Proton Administrator Guide and Setting up with Proton in the Proton User Guide.
", "ServicePipeline$arn": "The Amazon Resource Name (ARN) of the service pipeline.
", "ServiceTemplate$encryptionKey": "The customer provided service template encryption key that's used to encrypt data.
", - "TagResourceInput$resourceArn": "The Amazon Resource Name (ARN) of the resource that the resource tag is applied to.
", - "UntagResourceInput$resourceArn": "The Amazon Resource Name (ARN) of the resource that the tag is to be removed from.
", - "UpdateEnvironmentAccountConnectionInput$roleArn": "The Amazon Resource Name (ARN) of the IAM service role that is associated with the environment account connection to update.
", + "TagResourceInput$resourceArn": "The Amazon Resource Name (ARN) of the Proton resource to apply customer tags to.
", + "UntagResourceInput$resourceArn": "The Amazon Resource Name (ARN) of the resource to remove customer tags from.
", + "UpdateEnvironmentAccountConnectionInput$roleArn": "The Amazon Resource Name (ARN) of the IAM service role that's associated with the environment account connection to update.
", "UpdateEnvironmentInput$protonServiceRoleArn": "The Amazon Resource Name (ARN) of the Proton service role that allows Proton to make API calls to other services your behalf.
" } }, "AwsAccountId": { "base": null, "refs": { - "CreateEnvironmentAccountConnectionInput$managementAccountId": "The ID of the management account that accepts or rejects the environment account connection. You create an manage the Proton environment in this account. If the management account accepts the environment account connection, Proton can use the associated IAM role to provision environment infrastructure resources in the associated environment account.
", + "CreateEnvironmentAccountConnectionInput$managementAccountId": "The ID of the management account that accepts or rejects the environment account connection. You create and manage the Proton environment in this account. If the management account accepts the environment account connection, Proton can use the associated IAM role to provision environment infrastructure resources in the associated environment account.
", "Environment$environmentAccountId": "The ID of the environment account that the environment infrastructure resources are provisioned in.
", "EnvironmentAccountConnection$environmentAccountId": "The environment account that's connected to the environment account connection.
", "EnvironmentAccountConnection$managementAccountId": "The ID of the management account that's connected to the environment account connection.
", @@ -400,9 +400,9 @@ "DeploymentUpdateType": { "base": null, "refs": { - "UpdateEnvironmentInput$deploymentType": "There are four modes for updating an environment as described in the following. The deploymentType
field defines the mode.
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
CURRENT_VERSION
In this mode, the environment is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include minor or major version parameters when you use this deployment-type
.
MINOR_VERSION
In this mode, the environment is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use.
MAJOR_VERSION
In this mode, the environment is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can also specify a different major version that is higher than the major version in use and a minor version (optional).
The deployment type.
There are four modes for updating a service instance as described in the following. The deploymentType
field defines the mode.
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
CURRENT_VERSION
In this mode, the service instance is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include minor or major version parameters when you use this deployment-type
.
MINOR_VERSION
In this mode, the service instance is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use.
MAJOR_VERSION
In this mode, the service instance is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can also specify a different major version that is higher than the major version in use and a minor version (optional).
The deployment type.
There are four modes for updating a service pipeline as described in the following. The deploymentType
field defines the mode.
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
CURRENT_VERSION
In this mode, the service pipeline is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include minor or major version parameters when you use this deployment-type
.
MINOR_VERSION
In this mode, the service pipeline is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use.
MAJOR_VERSION
In this mode, the service pipeline is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can also specify a different major version that is higher than the major version in use and a minor version (optional).
There are four modes for updating an environment. The deploymentType
field defines the mode.
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
CURRENT_VERSION
In this mode, the environment is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include major or minor version parameters when you use this deployment-type
.
MINOR_VERSION
In this mode, the environment is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use.
MAJOR_VERSION
In this mode, the environment is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can also specify a different major version that is higher than the major version in use and a minor version (optional).
The deployment type.
There are four modes for updating a service instance. The deploymentType
field defines the mode.
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
CURRENT_VERSION
In this mode, the service instance is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include major or minor version parameters when you use this deployment-type
.
MINOR_VERSION
In this mode, the service instance is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can also specify a different minor version of the current major version in use.
MAJOR_VERSION
In this mode, the service instance is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can specify a different major version that's higher than the major version in use and a minor version.
The deployment type.
There are four modes for updating a service pipeline. The deploymentType
field defines the mode.
NONE
In this mode, a deployment doesn't occur. Only the requested metadata parameters are updated.
CURRENT_VERSION
In this mode, the service pipeline is deployed and updated with the new spec that you provide. Only requested parameters are updated. Don’t include major or minor version parameters when you use this deployment-type
.
MINOR_VERSION
In this mode, the service pipeline is deployed and updated with the published, recommended (latest) minor version of the current major version in use, by default. You can specify a different minor version of the current major version in use.
MAJOR_VERSION
In this mode, the service pipeline is deployed and updated with the published, recommended (latest) major and minor version of the current template, by default. You can specify a different major version that's higher than the major version in use and a minor version.
The service template name as displayed in the developer interface.
", "ServiceTemplateSummary$displayName": "The service template name as displayed in the developer interface.
", "UpdateEnvironmentTemplateInput$displayName": "The name of the environment template to update as displayed in the developer interface.
", - "UpdateServiceTemplateInput$displayName": "The name of the service template to update as displayed in the developer interface.
" + "UpdateServiceTemplateInput$displayName": "The name of the service template to update that's displayed in the developer interface.
" } }, "EmptyNextToken": { "base": null, "refs": { - "ListEnvironmentOutputsInput$nextToken": "A token to indicate the location of the next environment output in the array of environment outputs, after the list of environment outputs that was previously requested.
", - "ListEnvironmentOutputsOutput$nextToken": "A token to indicate the location of the next environment output in the array of environment outputs, after the current requested list of environment outputs.
", - "ListEnvironmentProvisionedResourcesInput$nextToken": "A token to indicate the location of the next environment provisioned resource in the array of environment provisioned resources, after the list of environment provisioned resources that was previously requested.
", - "ListEnvironmentProvisionedResourcesOutput$nextToken": "A token to indicate the location of the next environment provisioned resource in the array of provisioned resources, after the current requested list of environment provisioned resources.
", - "ListRepositorySyncDefinitionsInput$nextToken": "A token to indicate the location of the next repository sync definition in the array of repository sync definitions, after the list of repository sync definitions previously requested.
", - "ListRepositorySyncDefinitionsOutput$nextToken": "A token to indicate the location of the next repository sync definition in the array of repository sync definitions, after the current requested list of repository sync definitions.
", - "ListServiceInstanceOutputsInput$nextToken": "A token to indicate the location of the next output in the array of outputs, after the list of outputs that was previously requested.
", - "ListServiceInstanceOutputsOutput$nextToken": "A token to indicate the location of the next output in the array of outputs, after the current requested list of outputs.
", - "ListServiceInstanceProvisionedResourcesInput$nextToken": "A token to indicate the location of the next provisioned resource in the array of provisioned resources, after the list of provisioned resources that was previously requested.
", - "ListServiceInstanceProvisionedResourcesOutput$nextToken": "A token to indicate the location of the next provisioned resource in the array of provisioned resources, after the current requested list of provisioned resources.
", - "ListServicePipelineOutputsInput$nextToken": "A token to indicate the location of the next output in the array of outputs, after the list of outputs that was previously requested.
", - "ListServicePipelineOutputsOutput$nextToken": "A token to indicate the location of the next output in the array of outputs, after the current requested list of outputs.
", - "ListServicePipelineProvisionedResourcesInput$nextToken": "A token to indicate the location of the next provisioned resource in the array of provisioned resources, after the list of provisioned resources that was previously requested.
", - "ListServicePipelineProvisionedResourcesOutput$nextToken": "A token to indicate the location of the next provisioned resource in the array of provisioned resources, after the current requested list of provisioned resources.
" + "ListEnvironmentOutputsInput$nextToken": "A token that indicates the location of the next environment output in the array of environment outputs, after the list of environment outputs that was previously requested.
", + "ListEnvironmentOutputsOutput$nextToken": "A token that indicates the location of the next environment output in the array of environment outputs, after the current requested list of environment outputs.
", + "ListEnvironmentProvisionedResourcesInput$nextToken": "A token that indicates the location of the next environment provisioned resource in the array of environment provisioned resources, after the list of environment provisioned resources that was previously requested.
", + "ListEnvironmentProvisionedResourcesOutput$nextToken": "A token that indicates the location of the next environment provisioned resource in the array of provisioned resources, after the current requested list of environment provisioned resources.
", + "ListRepositorySyncDefinitionsInput$nextToken": "A token that indicates the location of the next repository sync definition in the array of repository sync definitions, after the list of repository sync definitions previously requested.
", + "ListRepositorySyncDefinitionsOutput$nextToken": "A token that indicates the location of the next repository sync definition in the array of repository sync definitions, after the current requested list of repository sync definitions.
", + "ListServiceInstanceOutputsInput$nextToken": "A token that indicates the location of the next output in the array of outputs, after the list of outputs that was previously requested.
", + "ListServiceInstanceOutputsOutput$nextToken": "A token that indicates the location of the next output in the array of outputs, after the current requested list of outputs.
", + "ListServiceInstanceProvisionedResourcesInput$nextToken": "A token that indicates the location of the next provisioned resource in the array of provisioned resources, after the list of provisioned resources that was previously requested.
", + "ListServiceInstanceProvisionedResourcesOutput$nextToken": "A token that indicates the location of the next provisioned resource in the array of provisioned resources, after the current requested list of provisioned resources.
", + "ListServicePipelineOutputsInput$nextToken": "A token that indicates the location of the next output in the array of outputs, after the list of outputs that was previously requested.
", + "ListServicePipelineOutputsOutput$nextToken": "A token that indicates the location of the next output in the array of outputs, after the current requested list of outputs.
", + "ListServicePipelineProvisionedResourcesInput$nextToken": "A token that indicates the location of the next provisioned resource in the array of provisioned resources, after the list of provisioned resources that was previously requested.
", + "ListServicePipelineProvisionedResourcesOutput$nextToken": "A token that indicates the location of the next provisioned resource in the array of provisioned resources, after the current requested list of provisioned resources.
" } }, "Environment": { @@ -498,7 +498,7 @@ "base": null, "refs": { "AcceptEnvironmentAccountConnectionInput$id": "The ID of the environment account connection.
", - "CreateEnvironmentInput$environmentAccountConnectionId": "The ID of the environment account connection that you provide if you're provisioning your environment infrastructure resources to an environment account. You must include either the environmentAccountConnectionId
or protonServiceRoleArn
parameter and value and omit the provisioningRepository
parameter and values. For more information, see Environment account connections in the Proton Administrator guide.
The ID of the environment account connection that you provide if you're provisioning your environment infrastructure resources to an environment account. For more information, see Environment account connections in the Proton Administrator guide.
To use Amazon Web Services-managed provisioning for the environment, specify either the environmentAccountConnectionId
or protonServiceRoleArn
parameter and omit the provisioningRepository
parameter.
The ID of the environment account connection to delete.
", "Environment$environmentAccountConnectionId": "The ID of the environment account connection that's used to provision infrastructure resources in an environment account.
", "EnvironmentAccountConnection$id": "The ID of the environment account connection.
", @@ -988,24 +988,24 @@ "NextToken": { "base": null, "refs": { - "ListEnvironmentAccountConnectionsInput$nextToken": "A token to indicate the location of the next environment account connection in the array of environment account connections, after the list of environment account connections that was previously requested.
", - "ListEnvironmentAccountConnectionsOutput$nextToken": "A token to indicate the location of the next environment account connection in the array of environment account connections, after the current requested list of environment account connections.
", - "ListEnvironmentTemplateVersionsInput$nextToken": "A token to indicate the location of the next major or minor version in the array of major or minor versions of an environment template, after the list of major or minor versions that was previously requested.
", - "ListEnvironmentTemplateVersionsOutput$nextToken": "A token to indicate the location of the next major or minor version in the array of major or minor versions of an environment template, after the list of major or minor versions that was previously requested.
", - "ListEnvironmentTemplatesInput$nextToken": "A token to indicate the location of the next environment template in the array of environment templates, after the list of environment templates that was previously requested.
", - "ListEnvironmentTemplatesOutput$nextToken": "A token to indicate the location of the next environment template in the array of environment templates, after the current requested list of environment templates.
", - "ListEnvironmentsInput$nextToken": "A token to indicate the location of the next environment in the array of environments, after the list of environments that was previously requested.
", - "ListEnvironmentsOutput$nextToken": "A token to indicate the location of the next environment in the array of environments, after the current requested list of environments.
", - "ListRepositoriesInput$nextToken": "A token to indicate the location of the next repository in the array of repositories, after the list of repositories previously requested.
", - "ListRepositoriesOutput$nextToken": "A token to indicate the location of the next repository in the array of repositories, after the current requested list of repositories.
", - "ListServiceInstancesInput$nextToken": "A token to indicate the location of the next service in the array of service instances, after the list of service instances that was previously requested.
", - "ListServiceInstancesOutput$nextToken": "A token to indicate the location of the next service instance in the array of service instances, after the current requested list of service instances.
", - "ListServiceTemplateVersionsInput$nextToken": "A token to indicate the location of the next major or minor version in the array of major or minor versions of a service template, after the list of major or minor versions that was previously requested.
", - "ListServiceTemplateVersionsOutput$nextToken": "A token to indicate the location of the next major or minor version in the array of major or minor versions of a service template, after the current requested list of service major or minor versions.
", - "ListServiceTemplatesInput$nextToken": "A token to indicate the location of the next service template in the array of service templates, after the list of service templates previously requested.
", - "ListServiceTemplatesOutput$nextToken": "A token to indicate the location of the next service template in the array of service templates, after the current requested list of service templates.
", - "ListServicesInput$nextToken": "A token to indicate the location of the next service in the array of services, after the list of services that was previously requested.
", - "ListServicesOutput$nextToken": "A token to indicate the location of the next service in the array of services, after the current requested list of services.
" + "ListEnvironmentAccountConnectionsInput$nextToken": "A token that indicates the location of the next environment account connection in the array of environment account connections, after the list of environment account connections that was previously requested.
", + "ListEnvironmentAccountConnectionsOutput$nextToken": "A token that indicates the location of the next environment account connection in the array of environment account connections, after the current requested list of environment account connections.
", + "ListEnvironmentTemplateVersionsInput$nextToken": "A token that indicates the location of the next major or minor version in the array of major or minor versions of an environment template, after the list of major or minor versions that was previously requested.
", + "ListEnvironmentTemplateVersionsOutput$nextToken": "A token that indicates the location of the next major or minor version in the array of major or minor versions of an environment template, after the list of major or minor versions that was previously requested.
", + "ListEnvironmentTemplatesInput$nextToken": "A token that indicates the location of the next environment template in the array of environment templates, after the list of environment templates that was previously requested.
", + "ListEnvironmentTemplatesOutput$nextToken": "A token that indicates the location of the next environment template in the array of environment templates, after the current requested list of environment templates.
", + "ListEnvironmentsInput$nextToken": "A token that indicates the location of the next environment in the array of environments, after the list of environments that was previously requested.
", + "ListEnvironmentsOutput$nextToken": "A token that indicates the location of the next environment in the array of environments, after the current requested list of environments.
", + "ListRepositoriesInput$nextToken": "A token that indicates the location of the next repository in the array of repositories, after the list of repositories previously requested.
", + "ListRepositoriesOutput$nextToken": "A token that indicates the location of the next repository in the array of repositories, after the current requested list of repositories.
", + "ListServiceInstancesInput$nextToken": "A token that indicates the location of the next service in the array of service instances, after the list of service instances that was previously requested.
", + "ListServiceInstancesOutput$nextToken": "A token that indicates the location of the next service instance in the array of service instances, after the current requested list of service instances.
", + "ListServiceTemplateVersionsInput$nextToken": "A token that indicates the location of the next major or minor version in the array of major or minor versions of a service template, after the list of major or minor versions that was previously requested.
", + "ListServiceTemplateVersionsOutput$nextToken": "A token that indicates the location of the next major or minor version in the array of major or minor versions of a service template, after the current requested list of service major or minor versions.
", + "ListServiceTemplatesInput$nextToken": "A token that indicates the location of the next service template in the array of service templates, after the list of service templates previously requested.
", + "ListServiceTemplatesOutput$nextToken": "A token that indicates the location of the next service template in the array of service templates, after the current requested list of service templates.
", + "ListServicesInput$nextToken": "A token that indicates the location of the next service in the array of services, after the list of services that was previously requested.
", + "ListServicesOutput$nextToken": "A token that indicates the location of the next service in the array of services, after the current requested list of services.
" } }, "NotifyResourceDeploymentStatusChangeInput": { @@ -1054,8 +1054,8 @@ "PipelineRoleArn": { "base": null, "refs": { - "AccountSettings$pipelineServiceRoleArn": "The Amazon Resource Name (ARN) of the Proton pipeline service role.
", - "UpdateAccountSettingsInput$pipelineServiceRoleArn": "The Amazon Resource Name (ARN) of the Proton pipeline service role.
Provisioning by pull request is currently in feature preview and is only usable with Terraform based Proton Templates. To learn more about Amazon Web Services Feature Preview terms, see section 2 on Beta and Previews.
The Amazon Resource Name (ARN) of the service role you want to use for provisioning pipelines. Assumed by Proton for Amazon Web Services-managed provisioning, and by customer-owned automation for self-managed provisioning.
", + "UpdateAccountSettingsInput$pipelineServiceRoleArn": "The Amazon Resource Name (ARN) of the service role you want to use for provisioning pipelines. Assumed by Proton for Amazon Web Services-managed provisioning, and by customer-owned automation for self-managed provisioning.
" } }, "ProvisionedResource": { @@ -1067,7 +1067,7 @@ "ProvisionedResourceEngine": { "base": "List of provisioning engines
", "refs": { - "ProvisionedResource$provisioningEngine": "The resource provisioning engine.
Provisioning by pull request is currently in feature preview and is only usable with Terraform based Proton Templates. To learn more about Amazon Web Services Feature Preview terms, see section 2 on Beta and Previews.
The resource provisioning engine. At this time, CLOUDFORMATION
can be used for Amazon Web Services-managed provisioning, and TERRAFORM
can be used for self-managed provisioning.
For more information, see Self-managed provisioning in the Proton Administrator Guide.
" } }, "ProvisionedResourceIdentifier": { @@ -1094,7 +1094,7 @@ "base": null, "refs": { "CreateEnvironmentTemplateInput$provisioning": "When included, indicates that the environment template is for customer provisioned and managed infrastructure.
", - "CreateServiceTemplateInput$pipelineProvisioning": "Proton includes a service pipeline for your service by default. When included, this parameter indicates that an Proton service pipeline won't be included for your service. Once specified, this parameter can't be changed. For more information, see Service template bundles in the Proton Administrator Guide.
", + "CreateServiceTemplateInput$pipelineProvisioning": "By default, Proton provides a service pipeline for your service. When this parameter is included, it indicates that an Proton service pipeline isn't provided for your service. After it's included, it can't be changed. For more information, see Service template bundles in the Proton Administrator Guide.
", "Environment$provisioning": "When included, indicates that the environment template is for customer provisioned and managed infrastructure.
", "EnvironmentSummary$provisioning": "When included, indicates that the environment template is for customer provisioned and managed infrastructure.
", "EnvironmentTemplate$provisioning": "When included, indicates that the environment template is for customer provisioned and managed infrastructure.
", @@ -1130,18 +1130,18 @@ } }, "RepositoryBranch": { - "base": "Detail data for a repository branch.
Provisioning by pull request is currently in feature preview and is only usable with Terraform based Proton Templates. To learn more about Amazon Web Services Feature Preview terms, see section 2 on Beta and Previews.
Detail data for a repository branch.
", "refs": { - "AccountSettings$pipelineProvisioningRepository": "The repository that you provide with pull request provisioning.
Provisioning by pull request is currently in feature preview and is only usable with Terraform based Proton Templates. To learn more about Amazon Web Services Feature Preview terms, see section 2 on Beta and Previews.
The repository that you provide with pull request provisioning.
Provisioning by pull request is currently in feature preview and is only usable with Terraform based Proton Templates. To learn more about Amazon Web Services Feature Preview terms, see section 2 on Beta and Previews.
The repository configured in the Amazon Web Services account for pipeline provisioning. Required it if you have environments configured for self-managed provisioning with services that include pipelines.
", + "Environment$provisioningRepository": "The infrastructure repository that you use to host your rendered infrastructure templates for self-managed provisioning.
" } }, "RepositoryBranchInput": { - "base": "Detail input data for a repository branch.
Provisioning by pull request is currently in feature preview and is only usable with Terraform based Proton Templates. To learn more about Amazon Web Services Feature Preview terms, see section 2 on Beta and Previews.
Detail input data for a repository branch.
", "refs": { - "CreateEnvironmentInput$provisioningRepository": "The repository that you provide with pull request provisioning. If you provide this parameter, you must omit the environmentAccountConnectionId
and protonServiceRoleArn
parameters.
Provisioning by pull request is currently in feature preview and is only usable with Terraform based Proton Templates. To learn more about Amazon Web Services Feature Preview terms, see section 2 on Beta and Previews.
The repository that you provide with pull request provisioning.
Provisioning by pull request is currently in feature preview and is only usable with Terraform based Proton Templates. To learn more about Amazon Web Services Feature Preview terms, see section 2 on Beta and Previews.
The repository that you provide with pull request provisioning.
Provisioning by pull request is currently in feature preview and is only usable with Terraform based Proton Templates. To learn more about Amazon Web Services Feature Preview terms, see section 2 on Beta and Previews.
The infrastructure repository that you use to host your rendered infrastructure templates for self-managed provisioning.
To use self-managed provisioning for the environment, specify this parameter and omit the environmentAccountConnectionId
and protonServiceRoleArn
parameters.
A repository for pipeline provisioning. Specify it if you have environments configured for self-managed provisioning with services that include pipelines.
", + "UpdateEnvironmentInput$provisioningRepository": "The infrastructure repository that you use to host your rendered infrastructure templates for self-managed provisioning.
" } }, "RepositoryId": { @@ -1154,8 +1154,8 @@ "RepositoryName": { "base": null, "refs": { - "CreateRepositoryInput$name": "The repository name, for example myrepos/myrepo
.
The name of your repository, for example myrepos/myrepo
.
The repository name (for example, myrepos/myrepo
).
The name of your repository (for example, myrepos/myrepo
).
The name of the repository.
", "GetRepositoryInput$name": "The repository name, for example myrepos/myrepo
.
The repository name.
", @@ -1166,7 +1166,7 @@ "RepositorySummary$name": "The repository name.
", "Revision$repositoryName": "The repository name.
", "TemplateSyncConfig$repositoryName": "The name of the repository, for example myrepos/myrepo
.
The name of the repository, for example myrepos/myrepo
.
The name of the repository (for example, myrepos/myrepo
).
Include templateName
to filter search for a template name.
The name of the environment template.
", "EnvironmentTemplateVersion$templateName": "The name of the version of an environment template.
", - "EnvironmentTemplateVersionSummary$templateName": "The name of the version of an environment template.
", + "EnvironmentTemplateVersionSummary$templateName": "The name of the environment template.
", "GetEnvironmentInput$name": "The name of the environment that you want to get the detail data for.
", "GetEnvironmentTemplateInput$name": "The name of the environment template that you want to get the detail data for.
", "GetEnvironmentTemplateVersionInput$templateName": "The name of the environment template.
", @@ -1413,7 +1413,7 @@ "refs": { "CancelServiceInstanceDeploymentOutput$serviceInstance": "The service instance summary data that's returned by Proton.
", "GetServiceInstanceOutput$serviceInstance": "The service instance detail data that's returned by Proton.
", - "UpdateServiceInstanceOutput$serviceInstance": "The service instance summary data returned by Proton.
" + "UpdateServiceInstanceOutput$serviceInstance": "The service instance summary data that's returned by Proton.
" } }, "ServiceInstanceArn": { @@ -1440,7 +1440,7 @@ "refs": { "CancelServicePipelineDeploymentOutput$pipeline": "The service pipeline detail data that's returned by Proton.
", "Service$pipeline": "The service pipeline detail data.
", - "UpdateServicePipelineOutput$pipeline": "The pipeline details returned by Proton.
" + "UpdateServicePipelineOutput$pipeline": "The pipeline details that are returned by Proton.
" } }, "ServiceQuotaExceededException": { @@ -1526,8 +1526,8 @@ "SpecContents": { "base": null, "refs": { - "CreateEnvironmentInput$spec": "A link to a YAML formatted spec file that provides inputs as defined in the environment template bundle schema file. For more information, see Environments in the Proton Administrator Guide.
", - "CreateServiceInput$spec": "A link to a spec file that provides inputs as defined in the service template bundle schema file. The spec file is in YAML format. Don’t include pipeline inputs in the spec if your service template doesn’t include a service pipeline. For more information, see Create a service in the Proton Administrator Guide and Create a service in the Proton User Guide.
", + "CreateEnvironmentInput$spec": "A YAML formatted string that provides inputs as defined in the environment template bundle schema file. For more information, see Environments in the Proton Administrator Guide.
", + "CreateServiceInput$spec": "A link to a spec file that provides inputs as defined in the service template bundle schema file. The spec file is in YAML format. Don’t include pipeline inputs in the spec if your service template doesn’t include a service pipeline. For more information, see Create a service in the Proton Administrator Guide and Create a service in the Proton User Guide.
", "Environment$spec": "The environment spec.
", "Service$spec": "The formatted specification that defines the service.
", "ServiceInstance$spec": "The service spec that was used to create the service instance.
", @@ -1557,8 +1557,8 @@ "String": { "base": null, "refs": { - "ListTagsForResourceInput$nextToken": "A token to indicate the location of the next resource tag in the array of resource tags, after the list of resource tags that was previously requested.
", - "ListTagsForResourceOutput$nextToken": "A token to indicate the location of the next resource tag in the array of resource tags, after the current requested list of resource tags.
", + "ListTagsForResourceInput$nextToken": "A token that indicates the location of the next resource tag in the array of resource tags, after the list of resource tags that was previously requested.
", + "ListTagsForResourceOutput$nextToken": "A token that indicates the location of the next resource tag in the array of resource tags, after the current requested list of resource tags.
", "RepositorySyncDefinition$directory": "The directory in the repository.
", "RepositorySyncDefinition$parent": "The resource that is synced from.
", "RepositorySyncDefinition$target": "The resource that is synced to.
", @@ -1609,21 +1609,22 @@ "TagKeyList": { "base": null, "refs": { - "UntagResourceInput$tagKeys": "An array of tag keys indicating the resource tags to be removed from the resource.
" + "UntagResourceInput$tagKeys": "A list of customer tag keys that indicate the customer tags to be removed from the resource.
" } }, "TagList": { "base": null, "refs": { - "CreateEnvironmentAccountConnectionInput$tags": "Tags for your environment account connection. For more information, see Proton resources and tagging in the Proton Administrator Guide.
", - "CreateEnvironmentInput$tags": "Create tags for your environment. For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", - "CreateEnvironmentTemplateInput$tags": "Create tags for your environment template. For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", - "CreateEnvironmentTemplateVersionInput$tags": "Create tags for a new version of an environment template.
", - "CreateServiceInput$tags": "Create tags for your service. For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", - "CreateServiceTemplateInput$tags": "Create tags for your service template. For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", - "CreateServiceTemplateVersionInput$tags": "Create tags for a new version of a service template.
", - "ListTagsForResourceOutput$tags": "An array of resource tags with detail data.
", - "TagResourceInput$tags": "An array of resource tags to apply to a resource.
" + "CreateEnvironmentAccountConnectionInput$tags": "An optional list of metadata items that you can associate with the Proton environment account connection. A tag is a key-value pair.
For more information, see Proton resources and tagging in the Proton Administrator Guide.
", + "CreateEnvironmentInput$tags": "An optional list of metadata items that you can associate with the Proton environment. A tag is a key-value pair.
For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", + "CreateEnvironmentTemplateInput$tags": "An optional list of metadata items that you can associate with the Proton environment template. A tag is a key-value pair.
For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", + "CreateEnvironmentTemplateVersionInput$tags": "An optional list of metadata items that you can associate with the Proton environment template version. A tag is a key-value pair.
For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", + "CreateRepositoryInput$tags": "An optional list of metadata items that you can associate with the Proton repository. A tag is a key-value pair.
For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", + "CreateServiceInput$tags": "An optional list of metadata items that you can associate with the Proton service. A tag is a key-value pair.
For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", + "CreateServiceTemplateInput$tags": "An optional list of metadata items that you can associate with the Proton service template. A tag is a key-value pair.
For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", + "CreateServiceTemplateVersionInput$tags": "An optional list of metadata items that you can associate with the Proton service template version. A tag is a key-value pair.
For more information, see Proton resources and tagging in the Proton Administrator Guide or Proton User Guide.
", + "ListTagsForResourceOutput$tags": "A list of resource tags with detail data.
", + "TagResourceInput$tags": "A list of customer tags to apply to the Proton resource.
" } }, "TagResourceInput": { @@ -1676,7 +1677,7 @@ "CompatibleEnvironmentTemplateInput$majorVersion": "The major version of the compatible environment template.
", "CreateEnvironmentInput$templateMajorVersion": "The major version of the environment template.
", "CreateEnvironmentInput$templateMinorVersion": "The minor version of the environment template.
", - "CreateEnvironmentTemplateVersionInput$majorVersion": "To create a new minor version of the environment template, include a major Version
.
To create a new major and minor version of the environment template, exclude major Version
.
To create a new minor version of the environment template, include major Version
.
To create a new major and minor version of the environment template, exclude major Version
.
The major version of the service template that was used to create the service.
", "CreateServiceInput$templateMinorVersion": "The minor version of the service template that was used to create the service.
", "CreateServiceTemplateVersionInput$majorVersion": "To create a new minor version of the service template, include a major Version
.
To create a new major and minor version of the service template, exclude major Version
.
The environment template minor version to delete.
", "DeleteServiceTemplateVersionInput$majorVersion": "The service template major version to delete.
", "DeleteServiceTemplateVersionInput$minorVersion": "The service template minor version to delete.
", - "Environment$templateMajorVersion": "The ID of the major version of the environment template.
", - "Environment$templateMinorVersion": "The ID of the minor version of the environment template.
", + "Environment$templateMajorVersion": "The major version of the environment template.
", + "Environment$templateMinorVersion": "The minor version of the environment template.
", "EnvironmentSummary$templateMajorVersion": "The major version of the environment template.
", "EnvironmentSummary$templateMinorVersion": "The minor version of the environment template.
", "EnvironmentTemplateFilter$majorVersion": "Include majorVersion
to filter search for a major version.
To view environment template minor version detail data, include minorVersion
.
To view service template major version detail data, include major Version
.
To view service template minor version detail data, include minorVersion
.
The template version.
", + "GetTemplateSyncStatusInput$templateVersion": "The template major version.
", "ListEnvironmentTemplateVersionsInput$majorVersion": "To view a list of minor of versions under a major version of an environment template, include major Version
.
To view a list of major versions of an environment template, exclude major Version
.
To view a list of minor of versions under a major version of a service template, include major Version
.
To view a list of major versions of a service template, exclude major Version
.
The major version of the service template that was used to create the service instance.
", diff --git a/models/apis/servicecatalog/2015-12-10/api-2.json b/models/apis/servicecatalog/2015-12-10/api-2.json index 14bb3eadb8e..6c1c0e975d7 100644 --- a/models/apis/servicecatalog/2015-12-10/api-2.json +++ b/models/apis/servicecatalog/2015-12-10/api-2.json @@ -2010,7 +2010,12 @@ "UsageInstructions":{"shape":"UsageInstructions"}, "TagOptions":{"shape":"TagOptionSummaries"}, "ProvisioningArtifactPreferences":{"shape":"ProvisioningArtifactPreferences"}, - "ProvisioningArtifactOutputs":{"shape":"ProvisioningArtifactOutputs"} + "ProvisioningArtifactOutputs":{ + "shape":"ProvisioningArtifactOutputs", + "deprecated":true, + "deprecatedMessage":"This property is deprecated and returns the Id and Description of the Provisioning Artifact. Use ProvisioningArtifactOutputKeys instead to get the Keys and Descriptions of the outputs." + }, + "ProvisioningArtifactOutputKeys":{"shape":"ProvisioningArtifactOutputs"} } }, "DescribeRecordInput":{ diff --git a/models/apis/servicecatalog/2015-12-10/docs-2.json b/models/apis/servicecatalog/2015-12-10/docs-2.json index 4981a0d6d0f..a5c1fba8030 100644 --- a/models/apis/servicecatalog/2015-12-10/docs-2.json +++ b/models/apis/servicecatalog/2015-12-10/docs-2.json @@ -2242,7 +2242,8 @@ "ProvisioningArtifactOutputs": { "base": null, "refs": { - "DescribeProvisioningParametersOutput$ProvisioningArtifactOutputs": "The output of the provisioning artifact.
" + "DescribeProvisioningParametersOutput$ProvisioningArtifactOutputs": "The output of the provisioning artifact.
", + "DescribeProvisioningParametersOutput$ProvisioningArtifactOutputKeys": "A list of the keys and descriptions of the outputs. These outputs can be referenced from a provisioned product launched from this provisioning artifact.
" } }, "ProvisioningArtifactParameter": { diff --git a/models/apis/sms/2016-10-24/docs-2.json b/models/apis/sms/2016-10-24/docs-2.json index a059f1ca9d1..7c45a5041da 100644 --- a/models/apis/sms/2016-10-24/docs-2.json +++ b/models/apis/sms/2016-10-24/docs-2.json @@ -1,6 +1,6 @@ { "version": "2.0", - "service": "Product update
As of March 31, 2022, Amazon Web Services will discontinue Server Migration Service (Amazon Web Services SMS). Going forward, we recommend Amazon Web Services Application Migration Service (Amazon Web Services MGN) as the primary migration service for lift-and-shift migrations.
You can initiate new migration jobs in Server Migration Service until January 1, 2022. Complete these active migration projects by March 31, 2022. For more information, see When to Choose AWS Application Migration Service.
Server Migration Service (Server Migration Service) makes it easier and faster for you to migrate your on-premises workloads to Amazon Web Services. To learn more about Server Migration Service, see the following resources:
", + "service": "Product update
We recommend Amazon Web Services Application Migration Service (Amazon Web Services MGN) as the primary migration service for lift-and-shift migrations. If Amazon Web Services MGN is unavailable in a specific Amazon Web Services Region, you can use the Server Migration Service APIs through March 2023.
Server Migration Service (Server Migration Service) makes it easier and faster for you to migrate your on-premises workloads to Amazon Web Services. To learn more about Server Migration Service, see the following resources:
", "operations": { "CreateApp": "Creates an application. An application consists of one or more server groups. Each server group contain one or more servers.
", "CreateReplicationJob": "Creates a replication job. The replication job schedules periodic replication runs to replicate your server to Amazon Web Services. Each replication run creates an Amazon Machine Image (AMI).
", diff --git a/service/iot/api.go b/service/iot/api.go index 7336f4a9119..91ee128e42d 100644 --- a/service/iot/api.go +++ b/service/iot/api.go @@ -15884,6 +15884,151 @@ func (c *IoT) ListManagedJobTemplatesWithContext(ctx aws.Context, input *ListMan return out, req.Send() } +const opListMetricValues = "ListMetricValues" + +// ListMetricValuesRequest generates a "aws/request.Request" representing the +// client's request for the ListMetricValues operation. The "output" return +// value will be populated with the request's response once the request completes +// successfully. +// +// Use "Send" method on the returned Request to send the API call to the service. +// the "output" return value is not valid until after Send returns without error. +// +// See ListMetricValues for more information on using the ListMetricValues +// API call, and error handling. +// +// This method is useful when you want to inject custom logic or configuration +// into the SDK's request lifecycle. Such as custom headers, or retry logic. +// +// +// // Example sending a request using the ListMetricValuesRequest method. +// req, resp := client.ListMetricValuesRequest(params) +// +// err := req.Send() +// if err == nil { // resp is now filled +// fmt.Println(resp) +// } +func (c *IoT) ListMetricValuesRequest(input *ListMetricValuesInput) (req *request.Request, output *ListMetricValuesOutput) { + op := &request.Operation{ + Name: opListMetricValues, + HTTPMethod: "GET", + HTTPPath: "/metric-values", + Paginator: &request.Paginator{ + InputTokens: []string{"nextToken"}, + OutputTokens: []string{"nextToken"}, + LimitToken: "maxResults", + TruncationToken: "", + }, + } + + if input == nil { + input = &ListMetricValuesInput{} + } + + output = &ListMetricValuesOutput{} + req = c.newRequest(op, input, output) + return +} + +// ListMetricValues API operation for AWS IoT. +// +// Lists the values reported for an IoT Device Defender metric (device-side +// metric, cloud-side metric, or custom metric) by the given thing during the +// specified time period. +// +// Returns awserr.Error for service API and SDK errors. Use runtime type assertions +// with awserr.Error's Code and Message methods to get detailed information about +// the error. +// +// See the AWS API reference guide for AWS IoT's +// API operation ListMetricValues for usage and error information. +// +// Returned Error Types: +// * InvalidRequestException +// The request is not valid. +// +// * ThrottlingException +// The rate exceeds the limit. +// +// * InternalFailureException +// An unexpected error has occurred. +// +// * ResourceNotFoundException +// The specified resource does not exist. +// +func (c *IoT) ListMetricValues(input *ListMetricValuesInput) (*ListMetricValuesOutput, error) { + req, out := c.ListMetricValuesRequest(input) + return out, req.Send() +} + +// ListMetricValuesWithContext is the same as ListMetricValues with the addition of +// the ability to pass a context and additional request options. +// +// See ListMetricValues for details on how to use this API operation. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *IoT) ListMetricValuesWithContext(ctx aws.Context, input *ListMetricValuesInput, opts ...request.Option) (*ListMetricValuesOutput, error) { + req, out := c.ListMetricValuesRequest(input) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return out, req.Send() +} + +// ListMetricValuesPages iterates over the pages of a ListMetricValues operation, +// calling the "fn" function with the response data for each page. To stop +// iterating, return false from the fn function. +// +// See ListMetricValues method for more information on how to use this operation. +// +// Note: This operation can generate multiple requests to a service. +// +// // Example iterating over at most 3 pages of a ListMetricValues operation. +// pageNum := 0 +// err := client.ListMetricValuesPages(params, +// func(page *iot.ListMetricValuesOutput, lastPage bool) bool { +// pageNum++ +// fmt.Println(page) +// return pageNum <= 3 +// }) +// +func (c *IoT) ListMetricValuesPages(input *ListMetricValuesInput, fn func(*ListMetricValuesOutput, bool) bool) error { + return c.ListMetricValuesPagesWithContext(aws.BackgroundContext(), input, fn) +} + +// ListMetricValuesPagesWithContext same as ListMetricValuesPages except +// it takes a Context and allows setting request options on the pages. +// +// The context must be non-nil and will be used for request cancellation. If +// the context is nil a panic will occur. In the future the SDK may create +// sub-contexts for http.Requests. See https://golang.org/pkg/context/ +// for more information on using Contexts. +func (c *IoT) ListMetricValuesPagesWithContext(ctx aws.Context, input *ListMetricValuesInput, fn func(*ListMetricValuesOutput, bool) bool, opts ...request.Option) error { + p := request.Pagination{ + NewRequest: func() (*request.Request, error) { + var inCpy *ListMetricValuesInput + if input != nil { + tmp := *input + inCpy = &tmp + } + req, _ := c.ListMetricValuesRequest(inCpy) + req.SetContext(ctx) + req.ApplyOptions(opts...) + return req, nil + }, + } + + for p.Next() { + if !fn(p.Page().(*ListMetricValuesOutput), !p.HasNextPage()) { + break + } + } + + return p.Err() +} + const opListMitigationActions = "ListMitigationActions" // ListMitigationActionsRequest generates a "aws/request.Request" representing the @@ -35320,21 +35465,13 @@ type CustomCodeSigning struct { // The certificate chain. CertificateChain *CodeSigningCertificateChain `locationName:"certificateChain" type:"structure"` - // The hash algorithm used to code sign the file. You can use a string as the - // algorithm name if the target over-the-air (OTA) update devices are able to - // verify the signature that was generated using the same signature algorithm. - // For example, FreeRTOS uses SHA256 or SHA1, so you can pass either of them - // based on which was used for generating the signature. + // The hash algorithm used to code sign the file. HashAlgorithm *string `locationName:"hashAlgorithm" type:"string"` // The signature for the file. Signature *CodeSigningSignature `locationName:"signature" type:"structure"` - // The signature algorithm used to code sign the file. You can use a string - // as the algorithm name if the target over-the-air (OTA) update devices are - // able to verify the signature that was generated using the same signature - // algorithm. For example, FreeRTOS uses ECDSA or RSA, so you can pass either - // of them based on which was used for generating the signature. + // The signature algorithm used to code sign the file. SignatureAlgorithm *string `locationName:"signatureAlgorithm" type:"string"` } @@ -50894,6 +51031,180 @@ func (s *ListManagedJobTemplatesOutput) SetNextToken(v string) *ListManagedJobTe return s } +type ListMetricValuesInput struct { + _ struct{} `type:"structure" nopayload:"true"` + + // The dimension name. + DimensionName *string `location:"querystring" locationName:"dimensionName" min:"1" type:"string"` + + // The dimension value operator. + DimensionValueOperator *string `location:"querystring" locationName:"dimensionValueOperator" type:"string" enum:"DimensionValueOperator"` + + // The end of the time period for which metric values are returned. + // + // EndTime is a required field + EndTime *time.Time `location:"querystring" locationName:"endTime" type:"timestamp" required:"true"` + + // The maximum number of results to return at one time. + MaxResults *int64 `location:"querystring" locationName:"maxResults" min:"1" type:"integer"` + + // The name of the security profile metric for which values are returned. + // + // MetricName is a required field + MetricName *string `location:"querystring" locationName:"metricName" type:"string" required:"true"` + + // The token for the next set of results. + NextToken *string `location:"querystring" locationName:"nextToken" type:"string"` + + // The start of the time period for which metric values are returned. + // + // StartTime is a required field + StartTime *time.Time `location:"querystring" locationName:"startTime" type:"timestamp" required:"true"` + + // The name of the thing for which security profile metric values are returned. + // + // ThingName is a required field + ThingName *string `location:"querystring" locationName:"thingName" min:"1" type:"string" required:"true"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListMetricValuesInput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListMetricValuesInput) GoString() string { + return s.String() +} + +// Validate inspects the fields of the type to determine if they are valid. +func (s *ListMetricValuesInput) Validate() error { + invalidParams := request.ErrInvalidParams{Context: "ListMetricValuesInput"} + if s.DimensionName != nil && len(*s.DimensionName) < 1 { + invalidParams.Add(request.NewErrParamMinLen("DimensionName", 1)) + } + if s.EndTime == nil { + invalidParams.Add(request.NewErrParamRequired("EndTime")) + } + if s.MaxResults != nil && *s.MaxResults < 1 { + invalidParams.Add(request.NewErrParamMinValue("MaxResults", 1)) + } + if s.MetricName == nil { + invalidParams.Add(request.NewErrParamRequired("MetricName")) + } + if s.StartTime == nil { + invalidParams.Add(request.NewErrParamRequired("StartTime")) + } + if s.ThingName == nil { + invalidParams.Add(request.NewErrParamRequired("ThingName")) + } + if s.ThingName != nil && len(*s.ThingName) < 1 { + invalidParams.Add(request.NewErrParamMinLen("ThingName", 1)) + } + + if invalidParams.Len() > 0 { + return invalidParams + } + return nil +} + +// SetDimensionName sets the DimensionName field's value. +func (s *ListMetricValuesInput) SetDimensionName(v string) *ListMetricValuesInput { + s.DimensionName = &v + return s +} + +// SetDimensionValueOperator sets the DimensionValueOperator field's value. +func (s *ListMetricValuesInput) SetDimensionValueOperator(v string) *ListMetricValuesInput { + s.DimensionValueOperator = &v + return s +} + +// SetEndTime sets the EndTime field's value. +func (s *ListMetricValuesInput) SetEndTime(v time.Time) *ListMetricValuesInput { + s.EndTime = &v + return s +} + +// SetMaxResults sets the MaxResults field's value. +func (s *ListMetricValuesInput) SetMaxResults(v int64) *ListMetricValuesInput { + s.MaxResults = &v + return s +} + +// SetMetricName sets the MetricName field's value. +func (s *ListMetricValuesInput) SetMetricName(v string) *ListMetricValuesInput { + s.MetricName = &v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListMetricValuesInput) SetNextToken(v string) *ListMetricValuesInput { + s.NextToken = &v + return s +} + +// SetStartTime sets the StartTime field's value. +func (s *ListMetricValuesInput) SetStartTime(v time.Time) *ListMetricValuesInput { + s.StartTime = &v + return s +} + +// SetThingName sets the ThingName field's value. +func (s *ListMetricValuesInput) SetThingName(v string) *ListMetricValuesInput { + s.ThingName = &v + return s +} + +type ListMetricValuesOutput struct { + _ struct{} `type:"structure"` + + // The data the thing reports for the metric during the specified time period. + MetricDatumList []*MetricDatum `locationName:"metricDatumList" type:"list"` + + // A token that can be used to retrieve the next set of results, or null if + // there are no additional results. + NextToken *string `locationName:"nextToken" type:"string"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListMetricValuesOutput) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s ListMetricValuesOutput) GoString() string { + return s.String() +} + +// SetMetricDatumList sets the MetricDatumList field's value. +func (s *ListMetricValuesOutput) SetMetricDatumList(v []*MetricDatum) *ListMetricValuesOutput { + s.MetricDatumList = v + return s +} + +// SetNextToken sets the NextToken field's value. +func (s *ListMetricValuesOutput) SetNextToken(v string) *ListMetricValuesOutput { + s.NextToken = &v + return s +} + type ListMitigationActionsInput struct { _ struct{} `type:"structure" nopayload:"true"` @@ -54703,6 +55014,47 @@ func (s *ManagedJobTemplateSummary) SetTemplateVersion(v string) *ManagedJobTemp return s } +// A metric. +type MetricDatum struct { + _ struct{} `type:"structure"` + + // The time the metric value was reported. + Timestamp *time.Time `locationName:"timestamp" type:"timestamp"` + + // The value reported for the metric. + Value *MetricValue `locationName:"value" type:"structure"` +} + +// String returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s MetricDatum) String() string { + return awsutil.Prettify(s) +} + +// GoString returns the string representation. +// +// API parameter values that are decorated as "sensitive" in the API will not +// be included in the string output. The member name will be present, but the +// value will be replaced with "sensitive". +func (s MetricDatum) GoString() string { + return s.String() +} + +// SetTimestamp sets the Timestamp field's value. +func (s *MetricDatum) SetTimestamp(v time.Time) *MetricDatum { + s.Timestamp = &v + return s +} + +// SetValue sets the Value field's value. +func (s *MetricDatum) SetValue(v *MetricValue) *MetricDatum { + s.Value = v + return s +} + // The dimension of a metric. type MetricDimension struct { _ struct{} `type:"structure"` diff --git a/service/iot/iotiface/interface.go b/service/iot/iotiface/interface.go index 2b5b8a04087..845408099e4 100644 --- a/service/iot/iotiface/interface.go +++ b/service/iot/iotiface/interface.go @@ -752,6 +752,13 @@ type IoTAPI interface { ListManagedJobTemplatesWithContext(aws.Context, *iot.ListManagedJobTemplatesInput, ...request.Option) (*iot.ListManagedJobTemplatesOutput, error) ListManagedJobTemplatesRequest(*iot.ListManagedJobTemplatesInput) (*request.Request, *iot.ListManagedJobTemplatesOutput) + ListMetricValues(*iot.ListMetricValuesInput) (*iot.ListMetricValuesOutput, error) + ListMetricValuesWithContext(aws.Context, *iot.ListMetricValuesInput, ...request.Option) (*iot.ListMetricValuesOutput, error) + ListMetricValuesRequest(*iot.ListMetricValuesInput) (*request.Request, *iot.ListMetricValuesOutput) + + ListMetricValuesPages(*iot.ListMetricValuesInput, func(*iot.ListMetricValuesOutput, bool) bool) error + ListMetricValuesPagesWithContext(aws.Context, *iot.ListMetricValuesInput, func(*iot.ListMetricValuesOutput, bool) bool, ...request.Option) error + ListMitigationActions(*iot.ListMitigationActionsInput) (*iot.ListMitigationActionsOutput, error) ListMitigationActionsWithContext(aws.Context, *iot.ListMitigationActionsInput, ...request.Option) (*iot.ListMitigationActionsOutput, error) ListMitigationActionsRequest(*iot.ListMitigationActionsInput) (*request.Request, *iot.ListMitigationActionsOutput) diff --git a/service/proton/api.go b/service/proton/api.go index 32f07d19883..841222cabbe 100644 --- a/service/proton/api.go +++ b/service/proton/api.go @@ -494,13 +494,15 @@ func (c *Proton) CreateEnvironmentRequest(input *CreateEnvironmentInput) (req *r // // You can provision environments using the following methods: // -// * Standard provisioning: Proton makes direct calls to provision your resources. +// * Amazon Web Services-managed provisioning: Proton makes direct calls +// to provision your resources. // -// * Pull request provisioning: Proton makes pull requests on your repository +// * Self-managed provisioning: Proton makes pull requests on your repository // to provide compiled infrastructure as code (IaC) files that your IaC engine // uses to provision resources. // -// For more information, see the Environments (https://docs.aws.amazon.com/proton/latest/adminguide/ag-environments.html) +// For more information, see Environments (https://docs.aws.amazon.com/proton/latest/adminguide/ag-environments.html) +// and Provisioning methods (https://docs.aws.amazon.com/proton/latest/adminguide/ag-works-prov-methods.html) // in the Proton Administrator Guide. // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -918,9 +920,13 @@ func (c *Proton) CreateRepositoryRequest(input *CreateRepositoryInput) (req *req // CreateRepository API operation for AWS Proton. // -// Create and register a link to a repository that can be used with pull request -// provisioning or template sync configurations. For more information, see Template -// bundles (https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-bundles.html) +// Create and register a link to a repository that can be used with self-managed +// provisioning (infrastructure or pipelines) or for template sync configurations. +// When you create a repository link, Proton creates a service-linked role (https://docs.aws.amazon.com/proton/latest/adminguide/using-service-linked-roles.html) +// for you. +// +// For more information, see Self-managed provisioning (https://docs.aws.amazon.com/proton/latest/adminguide/ag-works-prov-methods.html#ag-works-prov-methods-self), +// Template bundles (https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-bundles.html), // and Template sync configurations (https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-sync-configs.html) // in the Proton Administrator Guide. // @@ -1122,7 +1128,7 @@ func (c *Proton) CreateServiceTemplateRequest(input *CreateServiceTemplateInput) // CreateServiceTemplate API operation for AWS Proton. // // Create a service template. The administrator creates a service template to -// define standardized infrastructure and an optional CICD service pipeline. +// define standardized infrastructure and an optional CI/CD service pipeline. // Developers, in turn, select the service template from Proton. If the selected // service template includes a service pipeline definition, they provide a link // to their source code repository. Proton then deploys and manages the infrastructure @@ -1326,10 +1332,10 @@ func (c *Proton) CreateTemplateSyncConfigRequest(input *CreateTemplateSyncConfig // CreateTemplateSyncConfig API operation for AWS Proton. // -// Set up a template for automated template version creation. When a commit +// Set up a template to create new template versions automatically. When a commit // is pushed to your registered repository (https://docs.aws.amazon.com/proton/latest/APIReference/API_Repository.html), // Proton checks for changes to your repository template bundles. If it detects -// a template bundle change, a new minor or major version of its template is +// a template bundle change, a new major or minor version of its template is // created, if the version doesn’t already exist. For more information, see // Template sync configurations (https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-sync-configs.html) // in the Proton Administrator Guide. @@ -2868,7 +2874,16 @@ func (c *Proton) GetRepositorySyncStatusRequest(input *GetRepositorySyncStatusIn // GetRepositorySyncStatus API operation for AWS Proton. // -// Get the repository sync status. +// Get the sync status of a repository used for Proton template sync. For more +// information about template sync, see . +// +// A repository sync status isn't tied to the Proton Repository resource (or +// any other Proton resource). Therefore, tags on an Proton Repository resource +// have no effect on this action. Specifically, you can't use these tags to +// control access to this action using Attribute-based access control (ABAC). +// +// For more information about ABAC, see ABAC (https://docs.aws.amazon.com/proton/latest/adminguide/security_iam_service-with-iam.html#security_iam_service-with-iam-tags) +// in the Proton Administrator 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 @@ -3053,7 +3068,7 @@ func (c *Proton) GetServiceInstanceRequest(input *GetServiceInstanceInput) (req // GetServiceInstance API operation for AWS Proton. // // Get detail data for a service instance. A service instance is an instantiation -// of service template, which is running in a specific environment. +// of service template and it runs in a specific environment. // // 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 @@ -6054,13 +6069,11 @@ func (c *Proton) NotifyResourceDeploymentStatusChangeRequest(input *NotifyResour // NotifyResourceDeploymentStatusChange API operation for AWS Proton. // -// Notify Proton of status changes to a provisioned resource when you use pull -// request provisioning. For more information, see Template bundles (https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-bundles.html). +// Notify Proton of status changes to a provisioned resource when you use self-managed +// provisioning. // -// Provisioning by pull request is currently in feature preview and is only -// usable with Terraform based Proton Templates. To learn more about Amazon -// Web Services Feature Preview terms (https://aws.amazon.com/service-terms), -// see section 2 on Beta and Previews. +// For more information, see Self-managed provisioning (https://docs.aws.amazon.com/proton/latest/adminguide/ag-works-prov-methods.html#ag-works-prov-methods-self) +// in the Proton Administrator 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 @@ -6162,10 +6175,10 @@ func (c *Proton) RejectEnvironmentAccountConnectionRequest(input *RejectEnvironm // In a management account, reject an environment account connection from another // environment account. // -// After you reject an environment account connection request, you won’t be -// able to accept or use the rejected environment account connection. +// After you reject an environment account connection request, you can't accept +// or use the rejected environment account connection. // -// You can’t reject an environment account connection that is connected to +// You can’t reject an environment account connection that's connected to // an environment. // // For more information, see Environment account connections (https://docs.aws.amazon.com/proton/latest/adminguide/ag-env-account-connections.html) @@ -6265,8 +6278,11 @@ func (c *Proton) TagResourceRequest(input *TagResourceInput) (req *request.Reque // TagResource API operation for AWS Proton. // -// Tag a resource. For more information, see Proton resources and tagging in -// the Proton Administrator Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) +// Tag a resource. A tag is a key-value pair of metadata that you associate +// with an Proton resource. +// +// For more information, see Proton resources and tagging in the Proton Administrator +// Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) // or Proton User Guide (https://docs.aws.amazon.com/proton/latest/userguide/resources.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -6363,8 +6379,11 @@ func (c *Proton) UntagResourceRequest(input *UntagResourceInput) (req *request.R // UntagResource API operation for AWS Proton. // -// Remove a tag from a resource. For more information, see Proton resources -// and tagging in the Proton Administrator Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) +// Remove a customer tag from a resource. A tag is a key-value pair of metadata +// associated with an Proton resource. +// +// For more information, see Proton resources and tagging in the Proton Administrator +// Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) // or Proton User Guide (https://docs.aws.amazon.com/proton/latest/userguide/resources.html). // // Returns awserr.Error for service API and SDK errors. Use runtime type assertions @@ -6558,26 +6577,32 @@ func (c *Proton) UpdateEnvironmentRequest(input *UpdateEnvironmentInput) (req *r // don't update or include the protonServiceRoleArn and provisioningRepository // parameter to update or connect to an environment account connection. // -// You can only update to a new environment account connection if it was created -// in the same environment account that the current environment account connection -// was created in and is associated with the current environment. +// You can only update to a new environment account connection if that connection +// was created in the same environment account that the current environment +// account connection was created in. The account connection must also be associated +// with the current environment. // // If the environment isn't associated with an environment account connection, -// don't update or include the environmentAccountConnectionId parameter to update -// or connect to an environment account connection. +// don't update or include the environmentAccountConnectionId parameter. You +// can't update or connect the environment to an environment account connection +// if it isn't already associated with an environment connection. // // You can update either the environmentAccountConnectionId or protonServiceRoleArn // parameter and value. You can’t update both. // -// If the environment was provisioned with pull request provisioning, include +// If the environment was configured for Amazon Web Services-managed provisioning, +// omit the provisioningRepository parameter. +// +// If the environment was configured for self-managed provisioning, specify // the provisioningRepository parameter and omit the protonServiceRoleArn and // environmentAccountConnectionId parameters. // -// If the environment wasn't provisioned with pull request provisioning, omit -// the provisioningRepository parameter. +// For more information, see Environments (https://docs.aws.amazon.com/proton/latest/adminguide/ag-environments.html) +// and Provisioning methods (https://docs.aws.amazon.com/proton/latest/adminguide/ag-works-prov-methods.html) +// in the Proton Administrator Guide. // -// There are four modes for updating an environment as described in the following. -// The deploymentType field defines the mode. +// There are four modes for updating an environment. The deploymentType field +// defines the mode. // // NONE // @@ -6602,7 +6627,7 @@ func (c *Proton) UpdateEnvironmentRequest(input *UpdateEnvironmentInput) (req *r // In this mode, the environment is deployed and updated with the published, // recommended (latest) major and minor version of the current template, by // default. You can also specify a different major version that's higher than -// the major version in use and a minor version (optional). +// the major version in use and a minor version. // // 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 @@ -7094,8 +7119,8 @@ func (c *Proton) UpdateServiceInstanceRequest(input *UpdateServiceInstanceInput) // // Update a service instance. // -// There are four modes for updating a service instance as described in the -// following. The deploymentType field defines the mode. +// There are four modes for updating a service instance. The deploymentType +// field defines the mode. // // NONE // @@ -7119,8 +7144,8 @@ func (c *Proton) UpdateServiceInstanceRequest(input *UpdateServiceInstanceInput) // // In this mode, the service instance is deployed and updated with the published, // recommended (latest) major and minor version of the current template, by -// default. You can also specify a different major version that is higher than -// the major version in use and a minor version (optional). +// default. You can also specify a different major version that's higher than +// the major version in use and a minor version. // // 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 @@ -7217,8 +7242,8 @@ func (c *Proton) UpdateServicePipelineRequest(input *UpdateServicePipelineInput) // // Update the service pipeline. // -// There are four modes for updating a service pipeline as described in the -// following. The deploymentType field defines the mode. +// There are four modes for updating a service pipeline. The deploymentType +// field defines the mode. // // NONE // @@ -7229,21 +7254,21 @@ func (c *Proton) UpdateServicePipelineRequest(input *UpdateServicePipelineInput) // // In this mode, the service pipeline is deployed and updated with the new spec // that you provide. Only requested parameters are updated. Don’t include -// minor or major version parameters when you use this deployment-type. +// major or minor version parameters when you use this deployment-type. // // MINOR_VERSION // // In this mode, the service pipeline is deployed and updated with the published, // recommended (latest) minor version of the current major version in use, by -// default. You can also specify a different minor version of the current major -// version in use. +// default. You can specify a different minor version of the current major version +// in use. // // MAJOR_VERSION // // In this mode, the service pipeline is deployed and updated with the published, // recommended (latest) major and minor version of the current template by default. -// You can also specify a different major version that is higher than the major -// version in use and a minor version (optional). +// You can specify a different major version that's higher than the major version +// in use and a minor version. // // 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 @@ -7726,19 +7751,19 @@ func (s *AccessDeniedException) RequestID() string { return s.RespMetadata.RequestID } -// The Proton pipeline service role and repository data. +// The Proton pipeline service role and repository data shared across the Amazon +// Web Services account. type AccountSettings struct { _ struct{} `type:"structure"` - // The repository that you provide with pull request provisioning. - // - // Provisioning by pull request is currently in feature preview and is only - // usable with Terraform based Proton Templates. To learn more about Amazon - // Web Services Feature Preview terms (https://aws.amazon.com/service-terms), - // see section 2 on Beta and Previews. + // The repository configured in the Amazon Web Services account for pipeline + // provisioning. Required it if you have environments configured for self-managed + // provisioning with services that include pipelines. PipelineProvisioningRepository *RepositoryBranch `locationName:"pipelineProvisioningRepository" type:"structure"` - // The Amazon Resource Name (ARN) of the Proton pipeline service role. + // The Amazon Resource Name (ARN) of the service role you want to use for provisioning + // pipelines. Assumed by Proton for Amazon Web Services-managed provisioning, + // and by customer-owned automation for self-managed provisioning. PipelineServiceRoleArn *string `locationName:"pipelineServiceRoleArn" type:"string"` } @@ -8229,10 +8254,10 @@ type CreateEnvironmentAccountConnectionInput struct { EnvironmentName *string `locationName:"environmentName" min:"1" type:"string" required:"true"` // The ID of the management account that accepts or rejects the environment - // account connection. You create an manage the Proton environment in this account. - // If the management account accepts the environment account connection, Proton - // can use the associated IAM role to provision environment infrastructure resources - // in the associated environment account. + // account connection. You create and manage the Proton environment in this + // account. If the management account accepts the environment account connection, + // Proton can use the associated IAM role to provision environment infrastructure + // resources in the associated environment account. // // ManagementAccountId is a required field ManagementAccountId *string `locationName:"managementAccountId" type:"string" required:"true"` @@ -8244,8 +8269,10 @@ type CreateEnvironmentAccountConnectionInput struct { // RoleArn is a required field RoleArn *string `locationName:"roleArn" min:"1" type:"string" required:"true"` - // Tags for your environment account connection. For more information, see Proton - // resources and tagging (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) + // An optional list of metadata items that you can associate with the Proton + // environment account connection. A tag is a key-value pair. + // + // For more information, see Proton resources and tagging (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) // in the Proton Administrator Guide. Tags []*Tag `locationName:"tags" type:"list"` } @@ -8377,11 +8404,13 @@ type CreateEnvironmentInput struct { Description *string `locationName:"description" type:"string" sensitive:"true"` // The ID of the environment account connection that you provide if you're provisioning - // your environment infrastructure resources to an environment account. You - // must include either the environmentAccountConnectionId or protonServiceRoleArn - // parameter and value and omit the provisioningRepository parameter and values. - // For more information, see Environment account connections (https://docs.aws.amazon.com/proton/latest/adminguide/ag-env-account-connections.html) + // your environment infrastructure resources to an environment account. For + // more information, see Environment account connections (https://docs.aws.amazon.com/proton/latest/adminguide/ag-env-account-connections.html) // in the Proton Administrator guide. + // + // To use Amazon Web Services-managed provisioning for the environment, specify + // either the environmentAccountConnectionId or protonServiceRoleArn parameter + // and omit the provisioningRepository parameter. EnvironmentAccountConnectionId *string `locationName:"environmentAccountConnectionId" type:"string"` // The name of the environment. @@ -8390,24 +8419,22 @@ type CreateEnvironmentInput struct { Name *string `locationName:"name" min:"1" type:"string" required:"true"` // The Amazon Resource Name (ARN) of the Proton service role that allows Proton - // to make calls to other services on your behalf. You must include either the - // environmentAccountConnectionId or protonServiceRoleArn parameter and value - // and omit the provisioningRepository parameter when you use standard provisioning. + // to make calls to other services on your behalf. + // + // To use Amazon Web Services-managed provisioning for the environment, specify + // either the environmentAccountConnectionId or protonServiceRoleArn parameter + // and omit the provisioningRepository parameter. ProtonServiceRoleArn *string `locationName:"protonServiceRoleArn" min:"1" type:"string"` - // The repository that you provide with pull request provisioning. If you provide - // this parameter, you must omit the environmentAccountConnectionId and protonServiceRoleArn - // parameters. + // The infrastructure repository that you use to host your rendered infrastructure + // templates for self-managed provisioning. // - // Provisioning by pull request is currently in feature preview and is only - // usable with Terraform based Proton Templates. To learn more about Amazon - // Web Services Feature Preview terms (https://aws.amazon.com/service-terms), - // see section 2 on Beta and Previews. + // To use self-managed provisioning for the environment, specify this parameter + // and omit the environmentAccountConnectionId and protonServiceRoleArn parameters. ProvisioningRepository *RepositoryBranchInput_ `locationName:"provisioningRepository" type:"structure"` - // A link to a YAML formatted spec file that provides inputs as defined in the - // environment template bundle schema file. For more information, see Environments - // (https://docs.aws.amazon.com/proton/latest/adminguide/ag-environments.html) + // A YAML formatted string that provides inputs as defined in the environment + // template bundle schema file. For more information, see Environments (https://docs.aws.amazon.com/proton/latest/adminguide/ag-environments.html) // in the Proton Administrator Guide. // // Spec is a sensitive parameter and its value will be @@ -8417,8 +8444,11 @@ type CreateEnvironmentInput struct { // Spec is a required field Spec *string `locationName:"spec" min:"1" type:"string" required:"true" sensitive:"true"` - // Create tags for your environment. For more information, see Proton resources - // and tagging in the Proton Administrator Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) + // An optional list of metadata items that you can associate with the Proton + // environment. A tag is a key-value pair. + // + // For more information, see Proton resources and tagging in the Proton Administrator + // Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) // or Proton User Guide (https://docs.aws.amazon.com/proton/latest/userguide/resources.html). Tags []*Tag `locationName:"tags" type:"list"` @@ -8633,8 +8663,11 @@ type CreateEnvironmentTemplateInput struct { // and managed infrastructure. Provisioning *string `locationName:"provisioning" type:"string" enum:"Provisioning"` - // Create tags for your environment template. For more information, see Proton - // resources and tagging in the Proton Administrator Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) + // An optional list of metadata items that you can associate with the Proton + // environment template. A tag is a key-value pair. + // + // For more information, see Proton resources and tagging in the Proton Administrator + // Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) // or Proton User Guide (https://docs.aws.amazon.com/proton/latest/userguide/resources.html). Tags []*Tag `locationName:"tags" type:"list"` } @@ -8772,7 +8805,7 @@ type CreateEnvironmentTemplateVersionInput struct { // String and GoString methods. Description *string `locationName:"description" type:"string" sensitive:"true"` - // To create a new minor version of the environment template, include a major + // To create a new minor version of the environment template, include major // Version. // // To create a new major and minor version of the environment template, exclude @@ -8785,7 +8818,12 @@ type CreateEnvironmentTemplateVersionInput struct { // Source is a required field Source *TemplateVersionSourceInput `locationName:"source" type:"structure" required:"true"` - // Create tags for a new version of an environment template. + // An optional list of metadata items that you can associate with the Proton + // environment template version. A tag is a key-value pair. + // + // For more information, see Proton resources and tagging in the Proton Administrator + // Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) + // or Proton User Guide (https://docs.aws.amazon.com/proton/latest/userguide/resources.html). Tags []*Tag `locationName:"tags" type:"list"` // The name of the environment template. @@ -8922,7 +8960,7 @@ type CreateRepositoryInput struct { _ struct{} `type:"structure"` // The Amazon Resource Name (ARN) of your Amazon Web Services CodeStar connection. - // For more information, see Setting up for Proton (https://docs.aws.amazon.com/setting-up-for-service) + // For more information, see Setting up for Proton (https://docs.aws.amazon.com/proton/latest/adminguide/setting-up-for-service.html) // in the Proton Administrator Guide. // // ConnectionArn is a required field @@ -8932,7 +8970,7 @@ type CreateRepositoryInput struct { // Web Services KMS) key. EncryptionKey *string `locationName:"encryptionKey" min:"1" type:"string"` - // The repository name, for example myrepos/myrepo. + // The repository name (for example, myrepos/myrepo). // // Name is a required field Name *string `locationName:"name" min:"1" type:"string" required:"true"` @@ -8941,6 +8979,14 @@ type CreateRepositoryInput struct { // // Provider is a required field Provider *string `locationName:"provider" type:"string" required:"true" enum:"RepositoryProvider"` + + // An optional list of metadata items that you can associate with the Proton + // repository. A tag is a key-value pair. + // + // For more information, see Proton resources and tagging in the Proton Administrator + // Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) + // or Proton User Guide (https://docs.aws.amazon.com/proton/latest/userguide/resources.html). + Tags []*Tag `locationName:"tags" type:"list"` } // String returns the string representation. @@ -8982,6 +9028,16 @@ func (s *CreateRepositoryInput) Validate() error { if s.Provider == nil { invalidParams.Add(request.NewErrParamRequired("Provider")) } + if s.Tags != nil { + for i, v := range s.Tags { + if v == nil { + continue + } + if err := v.Validate(); err != nil { + invalidParams.AddNested(fmt.Sprintf("%s[%v]", "Tags", i), err.(request.ErrInvalidParams)) + } + } + } if invalidParams.Len() > 0 { return invalidParams @@ -9013,6 +9069,12 @@ func (s *CreateRepositoryInput) SetProvider(v string) *CreateRepositoryInput { return s } +// SetTags sets the Tags field's value. +func (s *CreateRepositoryInput) SetTags(v []*Tag) *CreateRepositoryInput { + s.Tags = v + return s +} + type CreateRepositoryOutput struct { _ struct{} `type:"structure"` @@ -9091,8 +9153,11 @@ type CreateServiceInput struct { // Spec is a required field Spec *string `locationName:"spec" min:"1" type:"string" required:"true" sensitive:"true"` - // Create tags for your service. For more information, see Proton resources - // and tagging in the Proton Administrator Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) + // An optional list of metadata items that you can associate with the Proton + // service. A tag is a key-value pair. + // + // For more information, see Proton resources and tagging in the Proton Administrator + // Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) // or Proton User Guide (https://docs.aws.amazon.com/proton/latest/userguide/resources.html). Tags []*Tag `locationName:"tags" type:"list"` @@ -9302,15 +9367,18 @@ type CreateServiceTemplateInput struct { // Name is a required field Name *string `locationName:"name" min:"1" type:"string" required:"true"` - // Proton includes a service pipeline for your service by default. When included, - // this parameter indicates that an Proton service pipeline won't be included - // for your service. Once specified, this parameter can't be changed. For more - // information, see Service template bundles (https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-bundles.html) + // By default, Proton provides a service pipeline for your service. When this + // parameter is included, it indicates that an Proton service pipeline isn't + // provided for your service. After it's included, it can't be changed. For + // more information, see Service template bundles (https://docs.aws.amazon.com/proton/latest/adminguide/ag-template-bundles.html) // in the Proton Administrator Guide. PipelineProvisioning *string `locationName:"pipelineProvisioning" type:"string" enum:"Provisioning"` - // Create tags for your service template. For more information, see Proton resources - // and tagging in the Proton Administrator Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) + // An optional list of metadata items that you can associate with the Proton + // service template. A tag is a key-value pair. + // + // For more information, see Proton resources and tagging in the Proton Administrator + // Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) // or Proton User Guide (https://docs.aws.amazon.com/proton/latest/userguide/resources.html). Tags []*Tag `locationName:"tags" type:"list"` } @@ -9466,7 +9534,12 @@ type CreateServiceTemplateVersionInput struct { // Source is a required field Source *TemplateVersionSourceInput `locationName:"source" type:"structure" required:"true"` - // Create tags for a new version of a service template. + // An optional list of metadata items that you can associate with the Proton + // service template version. A tag is a key-value pair. + // + // For more information, see Proton resources and tagging in the Proton Administrator + // Guide (https://docs.aws.amazon.com/proton/latest/adminguide/resources.html) + // or Proton User Guide (https://docs.aws.amazon.com/proton/latest/userguide/resources.html). Tags []*Tag `locationName:"tags" type:"list"` // The name of the service template. @@ -9629,7 +9702,7 @@ type CreateTemplateSyncConfigInput struct { // Branch is a required field Branch *string `locationName:"branch" min:"1" type:"string" required:"true"` - // The name of your repository, for example myrepos/myrepo. + // The name of your repository (for example, myrepos/myrepo). // // RepositoryName is a required field RepositoryName *string `locationName:"repositoryName" min:"1" type:"string" required:"true"` @@ -10654,12 +10727,8 @@ type Environment struct { // and managed infrastructure. Provisioning *string `locationName:"provisioning" type:"string" enum:"Provisioning"` - // The repository that you provide with pull request provisioning. - // - // Provisioning by pull request is currently in feature preview and is only - // usable with Terraform based Proton Templates. To learn more about Amazon - // Web Services Feature Preview terms (https://aws.amazon.com/service-terms), - // see section 2 on Beta and Previews. + // The infrastructure repository that you use to host your rendered infrastructure + // templates for self-managed provisioning. ProvisioningRepository *RepositoryBranch `locationName:"provisioningRepository" type:"structure"` // The environment spec. @@ -10669,12 +10738,12 @@ type Environment struct { // String and GoString methods. Spec *string `locationName:"spec" min:"1" type:"string" sensitive:"true"` - // The ID of the major version of the environment template. + // The major version of the environment template. // // TemplateMajorVersion is a required field TemplateMajorVersion *string `locationName:"templateMajorVersion" min:"1" type:"string" required:"true"` - // The ID of the minor version of the environment template. + // The minor version of the environment template. // // TemplateMinorVersion is a required field TemplateMinorVersion *string `locationName:"templateMinorVersion" min:"1" type:"string" required:"true"` @@ -11743,7 +11812,7 @@ type EnvironmentTemplateVersionSummary struct { // String and GoString methods. StatusMessage *string `locationName:"statusMessage" type:"string" sensitive:"true"` - // The name of the version of an environment template. + // The name of the environment template. // // TemplateName is a required field TemplateName *string `locationName:"templateName" min:"1" type:"string" required:"true"` @@ -12945,7 +13014,7 @@ type GetTemplateSyncStatusInput struct { // TemplateType is a required field TemplateType *string `locationName:"templateType" type:"string" required:"true" enum:"TemplateType"` - // The template version. + // The template major version. // // TemplateVersion is a required field TemplateVersion *string `locationName:"templateVersion" min:"1" type:"string" required:"true"` @@ -13138,7 +13207,7 @@ type ListEnvironmentAccountConnectionsInput struct { // The maximum number of environment account connections to list. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` - // A token to indicate the location of the next environment account connection + // A token that indicates the location of the next environment account connection // in the array of environment account connections, after the list of environment // account connections that was previously requested. NextToken *string `locationName:"nextToken" type:"string"` @@ -13228,7 +13297,7 @@ type ListEnvironmentAccountConnectionsOutput struct { // EnvironmentAccountConnections is a required field EnvironmentAccountConnections []*EnvironmentAccountConnectionSummary `locationName:"environmentAccountConnections" type:"list" required:"true"` - // A token to indicate the location of the next environment account connection + // A token that indicates the location of the next environment account connection // in the array of environment account connections, after the current requested // list of environment account connections. NextToken *string `locationName:"nextToken" type:"string"` @@ -13272,9 +13341,9 @@ type ListEnvironmentOutputsInput struct { // EnvironmentName is a required field EnvironmentName *string `locationName:"environmentName" min:"1" type:"string" required:"true"` - // A token to indicate the location of the next environment output in the array - // of environment outputs, after the list of environment outputs that was previously - // requested. + // A token that indicates the location of the next environment output in the + // array of environment outputs, after the list of environment outputs that + // was previously requested. NextToken *string `locationName:"nextToken" type:"string"` } @@ -13327,8 +13396,9 @@ func (s *ListEnvironmentOutputsInput) SetNextToken(v string) *ListEnvironmentOut type ListEnvironmentOutputsOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next environment output in the array - // of environment outputs, after the current requested list of environment outputs. + // A token that indicates the location of the next environment output in the + // array of environment outputs, after the current requested list of environment + // outputs. NextToken *string `locationName:"nextToken" type:"string"` // An array of environment outputs with detail data. @@ -13375,7 +13445,7 @@ type ListEnvironmentProvisionedResourcesInput struct { // EnvironmentName is a required field EnvironmentName *string `locationName:"environmentName" min:"1" type:"string" required:"true"` - // A token to indicate the location of the next environment provisioned resource + // A token that indicates the location of the next environment provisioned resource // in the array of environment provisioned resources, after the list of environment // provisioned resources that was previously requested. NextToken *string `locationName:"nextToken" type:"string"` @@ -13430,7 +13500,7 @@ func (s *ListEnvironmentProvisionedResourcesInput) SetNextToken(v string) *ListE type ListEnvironmentProvisionedResourcesOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next environment provisioned resource + // A token that indicates the location of the next environment provisioned resource // in the array of provisioned resources, after the current requested list of // environment provisioned resources. NextToken *string `locationName:"nextToken" type:"string"` @@ -13485,9 +13555,9 @@ type ListEnvironmentTemplateVersionsInput struct { // to list. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` - // A token to indicate the location of the next major or minor version in the - // array of major or minor versions of an environment template, after the list - // of major or minor versions that was previously requested. + // A token that indicates the location of the next major or minor version in + // the array of major or minor versions of an environment template, after the + // list of major or minor versions that was previously requested. NextToken *string `locationName:"nextToken" type:"string"` // The name of the environment template. @@ -13563,9 +13633,9 @@ func (s *ListEnvironmentTemplateVersionsInput) SetTemplateName(v string) *ListEn type ListEnvironmentTemplateVersionsOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next major or minor version in the - // array of major or minor versions of an environment template, after the list - // of major or minor versions that was previously requested. + // A token that indicates the location of the next major or minor version in + // the array of major or minor versions of an environment template, after the + // list of major or minor versions that was previously requested. NextToken *string `locationName:"nextToken" type:"string"` // An array of major or minor versions of an environment template detail data. @@ -13610,7 +13680,7 @@ type ListEnvironmentTemplatesInput struct { // The maximum number of environment templates to list. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` - // A token to indicate the location of the next environment template in the + // A token that indicates the location of the next environment template in the // array of environment templates, after the list of environment templates that // was previously requested. NextToken *string `locationName:"nextToken" type:"string"` @@ -13662,7 +13732,7 @@ func (s *ListEnvironmentTemplatesInput) SetNextToken(v string) *ListEnvironmentT type ListEnvironmentTemplatesOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next environment template in the + // A token that indicates the location of the next environment template in the // array of environment templates, after the current requested list of environment // templates. NextToken *string `locationName:"nextToken" type:"string"` @@ -13712,8 +13782,8 @@ type ListEnvironmentsInput struct { // The maximum number of environments to list. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` - // A token to indicate the location of the next environment in the array of - // environments, after the list of environments that was previously requested. + // A token that indicates the location of the next environment in the array + // of environments, after the list of environments that was previously requested. NextToken *string `locationName:"nextToken" type:"string"` } @@ -13784,8 +13854,8 @@ type ListEnvironmentsOutput struct { // Environments is a required field Environments []*EnvironmentSummary `locationName:"environments" type:"list" required:"true"` - // A token to indicate the location of the next environment in the array of - // environments, after the current requested list of environments. + // A token that indicates the location of the next environment in the array + // of environments, after the current requested list of environments. NextToken *string `locationName:"nextToken" type:"string"` } @@ -13825,8 +13895,8 @@ type ListRepositoriesInput struct { // The maximum number of repositories to list. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` - // A token to indicate the location of the next repository in the array of repositories, - // after the list of repositories previously requested. + // A token that indicates the location of the next repository in the array of + // repositories, after the list of repositories previously requested. NextToken *string `locationName:"nextToken" type:"string"` } @@ -13876,8 +13946,8 @@ func (s *ListRepositoriesInput) SetNextToken(v string) *ListRepositoriesInput { type ListRepositoriesOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next repository in the array of repositories, - // after the current requested list of repositories. + // A token that indicates the location of the next repository in the array of + // repositories, after the current requested list of repositories. NextToken *string `locationName:"nextToken" type:"string"` // An array of repositories. @@ -13919,9 +13989,9 @@ func (s *ListRepositoriesOutput) SetRepositories(v []*RepositorySummary) *ListRe type ListRepositorySyncDefinitionsInput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next repository sync definition in - // the array of repository sync definitions, after the list of repository sync - // definitions previously requested. + // A token that indicates the location of the next repository sync definition + // in the array of repository sync definitions, after the list of repository + // sync definitions previously requested. NextToken *string `locationName:"nextToken" type:"string"` // The repository name. @@ -14007,9 +14077,9 @@ func (s *ListRepositorySyncDefinitionsInput) SetSyncType(v string) *ListReposito type ListRepositorySyncDefinitionsOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next repository sync definition in - // the array of repository sync definitions, after the current requested list - // of repository sync definitions. + // A token that indicates the location of the next repository sync definition + // in the array of repository sync definitions, after the current requested + // list of repository sync definitions. NextToken *string `locationName:"nextToken" type:"string"` // An array of repository sync definitions. @@ -14051,7 +14121,7 @@ func (s *ListRepositorySyncDefinitionsOutput) SetSyncDefinitions(v []*Repository type ListServiceInstanceOutputsInput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next output in the array of outputs, + // A token that indicates the location of the next output in the array of outputs, // after the list of outputs that was previously requested. NextToken *string `locationName:"nextToken" type:"string"` @@ -14127,7 +14197,7 @@ func (s *ListServiceInstanceOutputsInput) SetServiceName(v string) *ListServiceI type ListServiceInstanceOutputsOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next output in the array of outputs, + // A token that indicates the location of the next output in the array of outputs, // after the current requested list of outputs. NextToken *string `locationName:"nextToken" type:"string"` @@ -14170,7 +14240,7 @@ func (s *ListServiceInstanceOutputsOutput) SetOutputs(v []*Output_) *ListService type ListServiceInstanceProvisionedResourcesInput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next provisioned resource in the + // A token that indicates the location of the next provisioned resource in the // array of provisioned resources, after the list of provisioned resources that // was previously requested. NextToken *string `locationName:"nextToken" type:"string"` @@ -14247,7 +14317,7 @@ func (s *ListServiceInstanceProvisionedResourcesInput) SetServiceName(v string) type ListServiceInstanceProvisionedResourcesOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next provisioned resource in the + // A token that indicates the location of the next provisioned resource in the // array of provisioned resources, after the current requested list of provisioned // resources. NextToken *string `locationName:"nextToken" type:"string"` @@ -14294,7 +14364,7 @@ type ListServiceInstancesInput struct { // The maximum number of service instances to list. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` - // A token to indicate the location of the next service in the array of service + // A token that indicates the location of the next service in the array of service // instances, after the list of service instances that was previously requested. NextToken *string `locationName:"nextToken" type:"string"` @@ -14357,7 +14427,7 @@ func (s *ListServiceInstancesInput) SetServiceName(v string) *ListServiceInstanc type ListServiceInstancesOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next service instance in the array + // A token that indicates the location of the next service instance in the array // of service instances, after the current requested list of service instances. NextToken *string `locationName:"nextToken" type:"string"` @@ -14400,7 +14470,7 @@ func (s *ListServiceInstancesOutput) SetServiceInstances(v []*ServiceInstanceSum type ListServicePipelineOutputsInput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next output in the array of outputs, + // A token that indicates the location of the next output in the array of outputs, // after the list of outputs that was previously requested. NextToken *string `locationName:"nextToken" type:"string"` @@ -14459,7 +14529,7 @@ func (s *ListServicePipelineOutputsInput) SetServiceName(v string) *ListServiceP type ListServicePipelineOutputsOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next output in the array of outputs, + // A token that indicates the location of the next output in the array of outputs, // after the current requested list of outputs. NextToken *string `locationName:"nextToken" type:"string"` @@ -14502,7 +14572,7 @@ func (s *ListServicePipelineOutputsOutput) SetOutputs(v []*Output_) *ListService type ListServicePipelineProvisionedResourcesInput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next provisioned resource in the + // A token that indicates the location of the next provisioned resource in the // array of provisioned resources, after the list of provisioned resources that // was previously requested. NextToken *string `locationName:"nextToken" type:"string"` @@ -14562,7 +14632,7 @@ func (s *ListServicePipelineProvisionedResourcesInput) SetServiceName(v string) type ListServicePipelineProvisionedResourcesOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next provisioned resource in the + // A token that indicates the location of the next provisioned resource in the // array of provisioned resources, after the current requested list of provisioned // resources. NextToken *string `locationName:"nextToken" type:"string"` @@ -14615,9 +14685,9 @@ type ListServiceTemplateVersionsInput struct { // The maximum number of major or minor versions of a service template to list. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` - // A token to indicate the location of the next major or minor version in the - // array of major or minor versions of a service template, after the list of - // major or minor versions that was previously requested. + // A token that indicates the location of the next major or minor version in + // the array of major or minor versions of a service template, after the list + // of major or minor versions that was previously requested. NextToken *string `locationName:"nextToken" type:"string"` // The name of the service template. @@ -14693,8 +14763,8 @@ func (s *ListServiceTemplateVersionsInput) SetTemplateName(v string) *ListServic type ListServiceTemplateVersionsOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next major or minor version in the - // array of major or minor versions of a service template, after the current + // A token that indicates the location of the next major or minor version in + // the array of major or minor versions of a service template, after the current // requested list of service major or minor versions. NextToken *string `locationName:"nextToken" type:"string"` @@ -14740,7 +14810,7 @@ type ListServiceTemplatesInput struct { // The maximum number of service templates to list. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` - // A token to indicate the location of the next service template in the array + // A token that indicates the location of the next service template in the array // of service templates, after the list of service templates previously requested. NextToken *string `locationName:"nextToken" type:"string"` } @@ -14791,7 +14861,7 @@ func (s *ListServiceTemplatesInput) SetNextToken(v string) *ListServiceTemplates type ListServiceTemplatesOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next service template in the array + // A token that indicates the location of the next service template in the array // of service templates, after the current requested list of service templates. NextToken *string `locationName:"nextToken" type:"string"` @@ -14837,7 +14907,7 @@ type ListServicesInput struct { // The maximum number of services to list. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` - // A token to indicate the location of the next service in the array of services, + // A token that indicates the location of the next service in the array of services, // after the list of services that was previously requested. NextToken *string `locationName:"nextToken" type:"string"` } @@ -14888,7 +14958,7 @@ func (s *ListServicesInput) SetNextToken(v string) *ListServicesInput { type ListServicesOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next service in the array of services, + // A token that indicates the location of the next service in the array of services, // after the current requested list of services. NextToken *string `locationName:"nextToken" type:"string"` @@ -14934,8 +15004,8 @@ type ListTagsForResourceInput struct { // The maximum number of tags to list. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` - // A token to indicate the location of the next resource tag in the array of - // resource tags, after the list of resource tags that was previously requested. + // A token that indicates the location of the next resource tag in the array + // of resource tags, after the list of resource tags that was previously requested. NextToken *string `locationName:"nextToken" type:"string"` // The Amazon Resource Name (ARN) of the resource for the listed tags. @@ -15002,11 +15072,11 @@ func (s *ListTagsForResourceInput) SetResourceArn(v string) *ListTagsForResource type ListTagsForResourceOutput struct { _ struct{} `type:"structure"` - // A token to indicate the location of the next resource tag in the array of - // resource tags, after the current requested list of resource tags. + // A token that indicates the location of the next resource tag in the array + // of resource tags, after the current requested list of resource tags. NextToken *string `locationName:"nextToken" type:"string"` - // An array of resource tags with detail data. + // A list of resource tags with detail data. // // Tags is a required field Tags []*Tag `locationName:"tags" type:"list" required:"true"` @@ -15235,12 +15305,12 @@ type ProvisionedResource struct { // The provisioned resource name. Name *string `locationName:"name" min:"1" type:"string"` - // The resource provisioning engine. + // The resource provisioning engine. At this time, CLOUDFORMATION can be used + // for Amazon Web Services-managed provisioning, and TERRAFORM can be used for + // self-managed provisioning. // - // Provisioning by pull request is currently in feature preview and is only - // usable with Terraform based Proton Templates. To learn more about Amazon - // Web Services Feature Preview terms (https://aws.amazon.com/service-terms), - // see section 2 on Beta and Previews. + // For more information, see Self-managed provisioning (https://docs.aws.amazon.com/proton/latest/adminguide/ag-works-prov-methods.html#ag-works-prov-methods-self) + // in the Proton Administrator Guide. ProvisioningEngine *string `locationName:"provisioningEngine" type:"string" enum:"ProvisionedResourceEngine"` } @@ -15437,11 +15507,6 @@ func (s *Repository) SetProvider(v string) *Repository { } // Detail data for a repository branch. -// -// Provisioning by pull request is currently in feature preview and is only -// usable with Terraform based Proton Templates. To learn more about Amazon -// Web Services Feature Preview terms (https://aws.amazon.com/service-terms), -// see section 2 on Beta and Previews. type RepositoryBranch struct { _ struct{} `type:"structure"` @@ -15509,11 +15574,6 @@ func (s *RepositoryBranch) SetProvider(v string) *RepositoryBranch { } // Detail input data for a repository branch. -// -// Provisioning by pull request is currently in feature preview and is only -// usable with Terraform based Proton Templates. To learn more about Amazon -// Web Services Feature Preview terms (https://aws.amazon.com/service-terms), -// see section 2 on Beta and Previews. type RepositoryBranchInput_ struct { _ struct{} `type:"structure"` @@ -17624,13 +17684,13 @@ func (s *Tag) SetValue(v string) *Tag { type TagResourceInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the resource that the resource tag is applied + // The Amazon Resource Name (ARN) of the Proton resource to apply customer tags // to. // // ResourceArn is a required field ResourceArn *string `locationName:"resourceArn" min:"1" type:"string" required:"true"` - // An array of resource tags to apply to a resource. + // A list of customer tags to apply to the Proton resource. // // Tags is a required field Tags []*Tag `locationName:"tags" type:"list" required:"true"` @@ -17922,14 +17982,13 @@ func (s *ThrottlingException) RequestID() string { type UntagResourceInput struct { _ struct{} `type:"structure"` - // The Amazon Resource Name (ARN) of the resource that the tag is to be removed - // from. + // The Amazon Resource Name (ARN) of the resource to remove customer tags from. // // ResourceArn is a required field ResourceArn *string `locationName:"resourceArn" min:"1" type:"string" required:"true"` - // An array of tag keys indicating the resource tags to be removed from the - // resource. + // A list of customer tag keys that indicate the customer tags to be removed + // from the resource. // // TagKeys is a required field TagKeys []*string `locationName:"tagKeys" type:"list" required:"true"` @@ -18009,20 +18068,13 @@ func (s UntagResourceOutput) GoString() string { type UpdateAccountSettingsInput struct { _ struct{} `type:"structure"` - // The repository that you provide with pull request provisioning. - // - // Provisioning by pull request is currently in feature preview and is only - // usable with Terraform based Proton Templates. To learn more about Amazon - // Web Services Feature Preview terms (https://aws.amazon.com/service-terms), - // see section 2 on Beta and Previews. + // A repository for pipeline provisioning. Specify it if you have environments + // configured for self-managed provisioning with services that include pipelines. PipelineProvisioningRepository *RepositoryBranchInput_ `locationName:"pipelineProvisioningRepository" type:"structure"` - // The Amazon Resource Name (ARN) of the Proton pipeline service role. - // - // Provisioning by pull request is currently in feature preview and is only - // usable with Terraform based Proton Templates. To learn more about Amazon - // Web Services Feature Preview terms (https://aws.amazon.com/service-terms), - // see section 2 on Beta and Previews. + // The Amazon Resource Name (ARN) of the service role you want to use for provisioning + // pipelines. Assumed by Proton for Amazon Web Services-managed provisioning, + // and by customer-owned automation for self-managed provisioning. PipelineServiceRoleArn *string `locationName:"pipelineServiceRoleArn" type:"string"` } @@ -18074,8 +18126,8 @@ func (s *UpdateAccountSettingsInput) SetPipelineServiceRoleArn(v string) *Update type UpdateAccountSettingsOutput struct { _ struct{} `type:"structure"` - // The Proton pipeline service role repository detail data that's returned by - // Proton. + // The Proton pipeline service role and repository data shared across the Amazon + // Web Services account. // // AccountSettings is a required field AccountSettings *AccountSettings `locationName:"accountSettings" type:"structure" required:"true"` @@ -18113,7 +18165,7 @@ type UpdateEnvironmentAccountConnectionInput struct { // Id is a required field Id *string `locationName:"id" type:"string" required:"true"` - // The Amazon Resource Name (ARN) of the IAM service role that is associated + // The Amazon Resource Name (ARN) of the IAM service role that's associated // with the environment account connection to update. // // RoleArn is a required field @@ -18205,8 +18257,8 @@ func (s *UpdateEnvironmentAccountConnectionOutput) SetEnvironmentAccountConnecti type UpdateEnvironmentInput struct { _ struct{} `type:"structure"` - // There are four modes for updating an environment as described in the following. - // The deploymentType field defines the mode. + // There are four modes for updating an environment. The deploymentType field + // defines the mode. // // NONE // @@ -18216,8 +18268,8 @@ type UpdateEnvironmentInput struct { // CURRENT_VERSION // // In this mode, the environment is deployed and updated with the new spec that - // you provide. Only requested parameters are updated. Don’t include minor - // or major version parameters when you use this deployment-type. + // you provide. Only requested parameters are updated. Don’t include major + // or minor version parameters when you use this deployment-type. // // MINOR_VERSION // @@ -18259,12 +18311,8 @@ type UpdateEnvironmentInput struct { // to make API calls to other services your behalf. ProtonServiceRoleArn *string `locationName:"protonServiceRoleArn" min:"1" type:"string"` - // The repository that you provide with pull request provisioning. - // - // Provisioning by pull request is currently in feature preview and is only - // usable with Terraform based Proton Templates. To learn more about Amazon - // Web Services Feature Preview terms (https://aws.amazon.com/service-terms), - // see section 2 on Beta and Previews. + // The infrastructure repository that you use to host your rendered infrastructure + // templates for self-managed provisioning. ProvisioningRepository *RepositoryBranchInput_ `locationName:"provisioningRepository" type:"structure"` // The formatted specification that defines the update. @@ -18759,8 +18807,8 @@ type UpdateServiceInstanceInput struct { // The deployment type. // - // There are four modes for updating a service instance as described in the - // following. The deploymentType field defines the mode. + // There are four modes for updating a service instance. The deploymentType + // field defines the mode. // // NONE // @@ -18771,7 +18819,7 @@ type UpdateServiceInstanceInput struct { // // In this mode, the service instance is deployed and updated with the new spec // that you provide. Only requested parameters are updated. Don’t include - // minor or major version parameters when you use this deployment-type. + // major or minor version parameters when you use this deployment-type. // // MINOR_VERSION // @@ -18784,8 +18832,8 @@ type UpdateServiceInstanceInput struct { // // In this mode, the service instance is deployed and updated with the published, // recommended (latest) major and minor version of the current template, by - // default. You can also specify a different major version that is higher than - // the major version in use and a minor version (optional). + // default. You can specify a different major version that's higher than the + // major version in use and a minor version. // // DeploymentType is a required field DeploymentType *string `locationName:"deploymentType" type:"string" required:"true" enum:"DeploymentUpdateType"` @@ -18905,7 +18953,7 @@ func (s *UpdateServiceInstanceInput) SetTemplateMinorVersion(v string) *UpdateSe type UpdateServiceInstanceOutput struct { _ struct{} `type:"structure"` - // The service instance summary data returned by Proton. + // The service instance summary data that's returned by Proton. // // ServiceInstance is a required field ServiceInstance *ServiceInstance `locationName:"serviceInstance" type:"structure" required:"true"` @@ -18973,8 +19021,8 @@ type UpdateServicePipelineInput struct { // The deployment type. // - // There are four modes for updating a service pipeline as described in the - // following. The deploymentType field defines the mode. + // There are four modes for updating a service pipeline. The deploymentType + // field defines the mode. // // NONE // @@ -18985,21 +19033,21 @@ type UpdateServicePipelineInput struct { // // In this mode, the service pipeline is deployed and updated with the new spec // that you provide. Only requested parameters are updated. Don’t include - // minor or major version parameters when you use this deployment-type. + // major or minor version parameters when you use this deployment-type. // // MINOR_VERSION // // In this mode, the service pipeline is deployed and updated with the published, // recommended (latest) minor version of the current major version in use, by - // default. You can also specify a different minor version of the current major - // version in use. + // default. You can specify a different minor version of the current major version + // in use. // // MAJOR_VERSION // // In this mode, the service pipeline is deployed and updated with the published, // recommended (latest) major and minor version of the current template, by - // default. You can also specify a different major version that is higher than - // the major version in use and a minor version (optional). + // default. You can specify a different major version that's higher than the + // major version in use and a minor version. // // DeploymentType is a required field DeploymentType *string `locationName:"deploymentType" type:"string" required:"true" enum:"DeploymentUpdateType"` @@ -19109,7 +19157,7 @@ func (s *UpdateServicePipelineInput) SetTemplateMinorVersion(v string) *UpdateSe type UpdateServicePipelineOutput struct { _ struct{} `type:"structure"` - // The pipeline details returned by Proton. + // The pipeline details that are returned by Proton. // // Pipeline is a required field Pipeline *ServicePipeline `locationName:"pipeline" type:"structure" required:"true"` @@ -19149,7 +19197,7 @@ type UpdateServiceTemplateInput struct { // String and GoString methods. Description *string `locationName:"description" type:"string" sensitive:"true"` - // The name of the service template to update as displayed in the developer + // The name of the service template to update that's displayed in the developer // interface. // // DisplayName is a sensitive parameter and its value will be @@ -19420,7 +19468,7 @@ type UpdateTemplateSyncConfigInput struct { // Branch is a required field Branch *string `locationName:"branch" min:"1" type:"string" required:"true"` - // The name of the repository, for example myrepos/myrepo. + // The name of the repository (for example, myrepos/myrepo). // // RepositoryName is a required field RepositoryName *string `locationName:"repositoryName" min:"1" type:"string" required:"true"` diff --git a/service/servicecatalog/api.go b/service/servicecatalog/api.go index 6aa4861ce2e..99cac19b3f4 100644 --- a/service/servicecatalog/api.go +++ b/service/servicecatalog/api.go @@ -13624,8 +13624,14 @@ type DescribeProvisioningParametersOutput struct { // Information about the constraints used to provision the product. ConstraintSummaries []*ConstraintSummary `type:"list"` + // A list of the keys and descriptions of the outputs. These outputs can be + // referenced from a provisioned product launched from this provisioning artifact. + ProvisioningArtifactOutputKeys []*ProvisioningArtifactOutput `type:"list"` + // The output of the provisioning artifact. - ProvisioningArtifactOutputs []*ProvisioningArtifactOutput `type:"list"` + // + // Deprecated: This property is deprecated and returns the Id and Description of the Provisioning Artifact. Use ProvisioningArtifactOutputKeys instead to get the Keys and Descriptions of the outputs. + ProvisioningArtifactOutputs []*ProvisioningArtifactOutput `deprecated:"true" type:"list"` // Information about the parameters used to provision the product. ProvisioningArtifactParameters []*ProvisioningArtifactParameter `type:"list"` @@ -13666,6 +13672,12 @@ func (s *DescribeProvisioningParametersOutput) SetConstraintSummaries(v []*Const return s } +// SetProvisioningArtifactOutputKeys sets the ProvisioningArtifactOutputKeys field's value. +func (s *DescribeProvisioningParametersOutput) SetProvisioningArtifactOutputKeys(v []*ProvisioningArtifactOutput) *DescribeProvisioningParametersOutput { + s.ProvisioningArtifactOutputKeys = v + return s +} + // SetProvisioningArtifactOutputs sets the ProvisioningArtifactOutputs field's value. func (s *DescribeProvisioningParametersOutput) SetProvisioningArtifactOutputs(v []*ProvisioningArtifactOutput) *DescribeProvisioningParametersOutput { s.ProvisioningArtifactOutputs = v diff --git a/service/sms/doc.go b/service/sms/doc.go index ab0b6ef8dd8..ef239d8b3f8 100644 --- a/service/sms/doc.go +++ b/service/sms/doc.go @@ -6,15 +6,11 @@ // // Product update // -// As of March 31, 2022, Amazon Web Services will discontinue Server Migration -// Service (Amazon Web Services SMS). Going forward, we recommend Amazon Web -// Services Application Migration Service (http://aws.amazon.com/application-migration-service) +// We recommend Amazon Web Services Application Migration Service (http://aws.amazon.com/application-migration-service) // (Amazon Web Services MGN) as the primary migration service for lift-and-shift -// migrations. -// -// You can initiate new migration jobs in Server Migration Service until January -// 1, 2022. Complete these active migration projects by March 31, 2022. For -// more information, see When to Choose AWS Application Migration Service (http://aws.amazon.com/application-migration-service/when-to-choose-aws-mgn/). +// migrations. If Amazon Web Services MGN is unavailable in a specific Amazon +// Web Services Region, you can use the Server Migration Service APIs through +// March 2023. // // Server Migration Service (Server Migration Service) makes it easier and faster // for you to migrate your on-premises workloads to Amazon Web Services. To