Merge pull request #2192 from hashicorp/f-2025-02-06-schema-updates

2025/02/06: Schema Updates

CHANGELOG.md

@@ -1,4 +1,10 @@
 ## 1.28.0 (Unreleased)
+
+* **New Data Source:** `awscc_deadline_limit`
+* **New Data Source:** `awscc_deadline_queue_limit_association`
+* **New Resource:** `awscc_deadline_limit`
+* **New Resource:** `awscc_deadline_queue_limit_association`
+
 ## 1.27.0 (January 30, 2025)
 
 * **New Data Source:** `awscc_cloudfront_vpc_origin`

docs/data-sources/deadline_limit.md

@@ -0,0 +1,30 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "awscc_deadline_limit Data Source - terraform-provider-awscc"
+subcategory: ""
+description: |-
+  Data Source schema for AWS::Deadline::Limit
+---
+
+# awscc_deadline_limit (Data Source)
+
+Data Source schema for AWS::Deadline::Limit
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `id` (String) Uniquely identifies the resource.
+
+### Read-Only
+
+- `amount_requirement_name` (String)
+- `current_count` (Number)
+- `description` (String)
+- `display_name` (String)
+- `farm_id` (String)
+- `limit_id` (String)
+- `max_count` (Number)

docs/data-sources/deadline_queue_limit_association.md

@@ -0,0 +1,26 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "awscc_deadline_queue_limit_association Data Source - terraform-provider-awscc"
+subcategory: ""
+description: |-
+  Data Source schema for AWS::Deadline::QueueLimitAssociation
+---
+
+# awscc_deadline_queue_limit_association (Data Source)
+
+Data Source schema for AWS::Deadline::QueueLimitAssociation
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `id` (String) Uniquely identifies the resource.
+
+### Read-Only
+
+- `farm_id` (String)
+- `limit_id` (String)
+- `queue_id` (String)

docs/data-sources/ecs_service.md

@@ -25,7 +25,8 @@ Data Source schema for AWS::ECS::Service
  For more information, see [Balancing an Amazon ECS service across Availability Zones](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-rebalancing.html) in the *Amazon Elastic Container Service Developer Guide*.
 - `capacity_provider_strategy` (Attributes List) The capacity provider strategy to use for the service.
  If a ``capacityProviderStrategy`` is specified, the ``launchType`` parameter must be omitted. If no ``capacityProviderStrategy`` or ``launchType`` is specified, the ``defaultCapacityProviderStrategy`` for the cluster is used.
- A capacity provider strategy can contain a maximum of 20 capacity providers. (see [below for nested schema](#nestedatt--capacity_provider_strategy))
+ A capacity provider strategy may contain a maximum of 6 capacity providers.
+  To remove this property from your service resource, specify an empty ``CapacityProviderStrategyItem`` array. (see [below for nested schema](#nestedatt--capacity_provider_strategy))
 - `cluster` (String) The short name or full Amazon Resource Name (ARN) of the cluster that you run your service on. If you do not specify a cluster, the default cluster is assumed.
 - `deployment_configuration` (Attributes) Optional deployment parameters that control how many tasks run during the deployment and the ordering of stopping and starting tasks. (see [below for nested schema](#nestedatt--deployment_configuration))
 - `deployment_controller` (Attributes) The deployment controller to use for the service. If no deployment controller is specified, the default value of ``ECS`` is used. (see [below for nested schema](#nestedatt--deployment_controller))
@@ -38,11 +39,14 @@ Data Source schema for AWS::ECS::Service
 - `health_check_grace_period_seconds` (Number) The period of time, in seconds, that the Amazon ECS service scheduler ignores unhealthy Elastic Load Balancing, VPC Lattice, and container health checks after a task has first started. If you don't specify a health check grace period value, the default value of ``0`` is used. If you don't use any of the health checks, then ``healthCheckGracePeriodSeconds`` is unused.
  If your service's tasks take a while to start and respond to health checks, you can specify a health check grace period of up to 2,147,483,647 seconds (about 69 years). During that time, the Amazon ECS service scheduler ignores health check status. This grace period can prevent the service scheduler from marking tasks as unhealthy and stopping them before they have time to come up.
 - `launch_type` (String) The launch type on which to run your service. For more information, see [Amazon ECS Launch Types](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/launch_types.html) in the *Amazon Elastic Container Service Developer Guide*.
-- `load_balancers` (Attributes List) A list of load balancer objects to associate with the service. If you specify the ``Role`` property, ``LoadBalancers`` must be specified as well. For information about the number of load balancers that you can specify per service, see [Service Load Balancing](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html) in the *Amazon Elastic Container Service Developer Guide*. (see [below for nested schema](#nestedatt--load_balancers))
+- `load_balancers` (Attributes List) A list of load balancer objects to associate with the service. If you specify the ``Role`` property, ``LoadBalancers`` must be specified as well. For information about the number of load balancers that you can specify per service, see [Service Load Balancing](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-load-balancing.html) in the *Amazon Elastic Container Service Developer Guide*.
+  To remove this property from your service resource, specify an empty ``LoadBalancer`` array. (see [below for nested schema](#nestedatt--load_balancers))
 - `name` (String)
 - `network_configuration` (Attributes) The network configuration for the service. This parameter is required for task definitions that use the ``awsvpc`` network mode to receive their own elastic network interface, and it is not supported for other network modes. For more information, see [Task Networking](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/task-networking.html) in the *Amazon Elastic Container Service Developer Guide*. (see [below for nested schema](#nestedatt--network_configuration))
-- `placement_constraints` (Attributes List) An array of placement constraint objects to use for tasks in your service. You can specify a maximum of 10 constraints for each task. This limit includes constraints in the task definition and those specified at runtime. (see [below for nested schema](#nestedatt--placement_constraints))
-- `placement_strategies` (Attributes List) The placement strategy objects to use for tasks in your service. You can specify a maximum of 5 strategy rules for each service. (see [below for nested schema](#nestedatt--placement_strategies))
+- `placement_constraints` (Attributes List) An array of placement constraint objects to use for tasks in your service. You can specify a maximum of 10 constraints for each task. This limit includes constraints in the task definition and those specified at runtime.
+  To remove this property from your service resource, specify an empty ``PlacementConstraint`` array. (see [below for nested schema](#nestedatt--placement_constraints))
+- `placement_strategies` (Attributes List) The placement strategy objects to use for tasks in your service. You can specify a maximum of 5 strategy rules for each service.
+  To remove this property from your service resource, specify an empty ``PlacementStrategy`` array. (see [below for nested schema](#nestedatt--placement_strategies))
 - `platform_version` (String) The platform version that your tasks in the service are running on. A platform version is specified only for tasks using the Fargate launch type. If one isn't specified, the ``LATEST`` platform version is used. For more information, see [platform versions](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/platform_versions.html) in the *Amazon Elastic Container Service Developer Guide*.
 - `propagate_tags` (String) Specifies whether to propagate the tags from the task definition to the task. If no value is specified, the tags aren't propagated. Tags can only be propagated to the task during task creation. To add tags to a task after task creation, use the [TagResource](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TagResource.html) API action.
  You must set this to a value other than ``NONE`` when you use Cost Explorer. For more information, see [Amazon ECS usage reports](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/usage-reports.html) in the *Amazon Elastic Container Service Developer Guide*.
@@ -61,7 +65,8 @@ Data Source schema for AWS::ECS::Service
 - `service_name` (String) The name of your service. Up to 255 letters (uppercase and lowercase), numbers, underscores, and hyphens are allowed. Service names must be unique within a cluster, but you can have similarly named services in multiple clusters within a Region or across multiple Regions.
   The stack update fails if you change any properties that require replacement and the ``ServiceName`` is configured. This is because AWS CloudFormation creates the replacement service first, but each ``ServiceName`` must be unique in the cluster.
 - `service_registries` (Attributes List) The details of the service discovery registry to associate with this service. For more information, see [Service discovery](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-discovery.html).
-  Each service may be associated with one service registry. Multiple service registries for each service isn't supported. (see [below for nested schema](#nestedatt--service_registries))
+  Each service may be associated with one service registry. Multiple service registries for each service isn't supported.
+   To remove this property from your service resource, specify an empty ``ServiceRegistry`` array. (see [below for nested schema](#nestedatt--service_registries))
 - `tags` (Attributes List) The metadata that you apply to the service to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define. When a service is deleted, the tags are deleted as well.
  The following basic restrictions apply to tags:
   +  Maximum number of tags per resource - 50
@@ -74,7 +79,8 @@ Data Source schema for AWS::ECS::Service
 - `task_definition` (String) The ``family`` and ``revision`` (``family:revision``) or full ARN of the task definition to run in your service. If a ``revision`` isn't specified, the latest ``ACTIVE`` revision is used.
  A task definition must be specified if the service uses either the ``ECS`` or ``CODE_DEPLOY`` deployment controllers.
  For more information about deployment types, see [Amazon ECS deployment types](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html).
-- `volume_configurations` (Attributes List) The configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume. (see [below for nested schema](#nestedatt--volume_configurations))
+- `volume_configurations` (Attributes List) The configuration for a volume specified in the task definition as a volume that is configured at launch time. Currently, the only supported volume type is an Amazon EBS volume.
+  To remove this property from your service resource, specify an empty ``ServiceVolumeConfiguration`` array. (see [below for nested schema](#nestedatt--volume_configurations))
 - `vpc_lattice_configurations` (Attributes List) The VPC Lattice configuration for the service being created. (see [below for nested schema](#nestedatt--vpc_lattice_configurations))
 
 <a id="nestedatt--capacity_provider_strategy"></a>

docs/data-sources/ivs_channel.md

@@ -23,20 +23,32 @@ Data Source schema for AWS::IVS::Channel
 
 - `arn` (String) Channel ARN is automatically generated on creation and assigned as the unique identifier.
 - `authorized` (Boolean) Whether the channel is authorized.
+- `container_format` (String) Indicates which content-packaging format is used (MPEG-TS or fMP4). If multitrackInputConfiguration is specified and enabled is true, then containerFormat is required and must be set to FRAGMENTED_MP4. Otherwise, containerFormat may be set to TS or FRAGMENTED_MP4. Default: TS.
 - `ingest_endpoint` (String) Channel ingest endpoint, part of the definition of an ingest server, used when you set up streaming software.
 - `insecure_ingest` (Boolean) Whether the channel allows insecure ingest.
 - `latency_mode` (String) Channel latency mode.
+- `multitrack_input_configuration` (Attributes) (see [below for nested schema](#nestedatt--multitrack_input_configuration))
 - `name` (String) Channel
 - `playback_url` (String) Channel Playback URL.
 - `preset` (String) Optional transcode preset for the channel. This is selectable only for ADVANCED_HD and ADVANCED_SD channel types. For those channel types, the default preset is HIGHER_BANDWIDTH_DELIVERY. For other channel types (BASIC and STANDARD), preset is the empty string ("").
 - `recording_configuration_arn` (String) Recording Configuration ARN. A value other than an empty string indicates that recording is enabled. Default: "" (recording is disabled).
 - `tags` (Attributes Set) A list of key-value pairs that contain metadata for the asset model. (see [below for nested schema](#nestedatt--tags))
 - `type` (String) Channel type, which determines the allowable resolution and bitrate. If you exceed the allowable resolution or bitrate, the stream probably will disconnect immediately.
 
+<a id="nestedatt--multitrack_input_configuration"></a>
+### Nested Schema for `multitrack_input_configuration`
+
+Read-Only:
+
+- `enabled` (Boolean) Indicates whether multitrack input is enabled. Can be set to true only if channel type is STANDARD. Setting enabled to true with any other channel type will cause an exception. If true, then policy, maximumResolution, and containerFormat are required, and containerFormat must be set to FRAGMENTED_MP4. Default: false.
+- `maximum_resolution` (String) Maximum resolution for multitrack input. Required if enabled is true.
+- `policy` (String) Indicates whether multitrack input is allowed or required. Required if enabled is true.
+
+
 <a id="nestedatt--tags"></a>
 ### Nested Schema for `tags`
 
 Read-Only:
 
-- `key` (String)
-- `value` (String)
+- `key` (String) The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
+- `value` (String) The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.

docs/data-sources/ivs_ingest_configuration.md

@@ -37,5 +37,5 @@ Data Source schema for AWS::IVS::IngestConfiguration
 
 Read-Only:
 
-- `key` (String)
-- `value` (String)
+- `key` (String) The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
+- `value` (String) The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.

docs/data-sources/ivs_playback_key_pair.md

@@ -24,7 +24,7 @@ Data Source schema for AWS::IVS::PlaybackKeyPair
 - `arn` (String) Key-pair identifier.
 - `fingerprint` (String) Key-pair identifier.
 - `name` (String) An arbitrary string (a nickname) assigned to a playback key pair that helps the customer identify that resource. The value does not need to be unique.
-- `public_key_material` (String) The public portion of a customer-generated key pair.
+- `public_key_material` (String) The public portion of a customer-generated key pair. This field is required to create the AWS::IVS::PlaybackKeyPair resource.
 - `tags` (Attributes Set) A list of key-value pairs that contain metadata for the asset model. (see [below for nested schema](#nestedatt--tags))
 
 <a id="nestedatt--tags"></a>

docs/data-sources/ivs_public_key.md

@@ -24,7 +24,7 @@ Data Source schema for AWS::IVS::PublicKey
 - `arn` (String) Key-pair identifier.
 - `fingerprint` (String) Key-pair identifier.
 - `name` (String) Name of the public key to be imported. The value does not need to be unique.
-- `public_key_material` (String) The public portion of a customer-generated key pair.
+- `public_key_material` (String) The public portion of a customer-generated key pair. This field is required to create the AWS::IVS::PublicKey resource.
 - `tags` (Attributes Set) A list of key-value pairs that contain metadata for the asset model. (see [below for nested schema](#nestedatt--tags))
 
 <a id="nestedatt--tags"></a>

docs/data-sources/ivs_recording_configuration.md

@@ -60,8 +60,8 @@ Read-Only:
 
 Read-Only:
 
-- `key` (String)
-- `value` (String)
+- `key` (String) The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
+- `value` (String) The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
 
 
 <a id="nestedatt--thumbnail_configuration"></a>

docs/data-sources/ivs_stage.md

@@ -41,5 +41,5 @@ Read-Only:
 
 Read-Only:
 
-- `key` (String)
-- `value` (String)
+- `key` (String) The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
+- `value` (String) The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.

docs/data-sources/ivs_storage_configuration.md

@@ -39,5 +39,5 @@ Read-Only:
 
 Read-Only:
 
-- `key` (String)
-- `value` (String)
+- `key` (String) The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
+- `value` (String) The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.

docs/data-sources/ivs_stream_key.md

@@ -31,5 +31,5 @@ Data Source schema for AWS::IVS::StreamKey
 
 Read-Only:
 
-- `key` (String)
-- `value` (String)
+- `key` (String) The key name of the tag. You can specify a value that is 1 to 128 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.
+- `value` (String) The value for the tag. You can specify a value that is 0 to 256 Unicode characters in length and cannot be prefixed with aws:. You can use any of the following characters: the set of Unicode letters, digits, whitespace, _, ., /, =, +, and -.